Freeze the v1 public API surface #89

Closed
opened 2026-07-01 00:53:36 +00:00 by manlycucumber · 0 comments
manlycucumber commented 2026-07-01 00:53:36 +00:00 (Migrated from github.com)

Problem

Downstream platform repos must build on a stable Core. The public API (day(), selectors, value objects) needs an explicit freeze and a documented semver policy.

Acceptance criteria

  • Public API surface is enumerated and marked stable
  • A semver/deprecation policy is documented
  • Internal-only classes are clearly marked non-public
  • An API snapshot test guards against accidental breaking changes

Notes

Breaking changes after this require a major bump.

## Problem Downstream platform repos must build on a stable Core. The public API (day(), selectors, value objects) needs an explicit freeze and a documented semver policy. ## Acceptance criteria - [ ] Public API surface is enumerated and marked stable - [ ] A semver/deprecation policy is documented - [ ] Internal-only classes are clearly marked non-public - [ ] An API snapshot test guards against accidental breaking changes ## Notes Breaking changes after this require a major bump.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Directorium/Core#89
No description provided.