[Epic] Contract & API freeze #88

New issue

Closed

opened 2026-07-01 00:53:34 +00:00 by manlycucumber · 1 comment

manlycucumber commented

2026-07-01 00:53:34 +00:00

(Migrated from github.com)

Lock the public API and output contract at a stable 1.0 with an explicit deprecation policy. Done when the contract is versioned 1.0 and guarded against accidental change.

Epic — child issues are tracked as sub-issues.

Lock the public API and output contract at a stable 1.0 with an explicit deprecation policy. Done when the contract is versioned 1.0 and guarded against accidental change. _Epic — child issues are tracked as sub-issues._

manlycucumber commented

2026-07-10 22:46:53 +00:00

(Migrated from github.com)

Epic complete — #89 and #90 merged in PR #476. The public API surface (3 functions + 23 classes) is enumerated and pinned by a reflection snapshot (PublicApiSnapshotTest, cross-PHP-version-safe), and the 1.0 output-contract shape is pinned by ContractShapeTest; docs/api-stability.md documents the allowlist, semver, and deprecation policy. Adversarial review caught + fixed a cross-version self-rendering bug (verified green on check 7.4/8.1/8.2/8.3).

manlycucumber referenced this issue from a commit

2026-07-12 18:46:22 +00:00

chore: freeze the public API surface and the 1.0 output contract (#89, #90) (#476)

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#88

No description provided.

Rows
Columns