@@ -1113,8 +1113,10 @@ registry? Add it to `OPEN_CAPABILITY_REGISTRIES` in the same PR that fixes it.
11131113 surface** (Prime Directive #14 names them — more than ADRs): push it, open the PR,
11141114 and stop there, landing it is the maintainer's, by hand. For that class, a
11151115 finished task = a PR left visibly awaiting a human merge.
1116- 3 . ** Add a changeset for feature work.** When the change is a feature or functional improvement, run ` pnpm changeset `
1117- (or add a ` .changeset/*.md ` entry) describing it before committing. Pure bug fixes do ** not** require a changeset.
1116+ 3 . ** Add a changeset for anything that publishes.** Feature, functional improvement or fix — run ` pnpm changeset `
1117+ (or add a ` .changeset/*.md ` entry) describing it before committing. A bug fix in a released package takes a
1118+ ** ` patch ` ** changeset — never none, and ⛔ never ` skip-changeset ` : that label is for a diff that publishes
1119+ nothing from any released package.
11181120 ** Breaking changesets must carry their migration.** If the change removes or renames anything an author can write (a
11191121 spec key, an export, a config field), the changeset body must state the FROM → TO mapping and the one-line fix —
11201122 this text ships to consumers as ` CHANGELOG.md ` inside the npm package and is what an upgrading agent greps after the
@@ -1133,14 +1135,7 @@ registry? Add it to `OPEN_CAPABILITY_REGISTRIES` in the same PR that fixes it.
11331135 <!-- adr-0087: not-required (already-registered SOME-MIGRATION-ID) why -->
11341136 <!-- adr-0087: not-required (no-migration-prescription) why -->
11351137 ```
1136- Why it is asked of you at all: the ADR-0087 gates pin ledger ↔ ** artifact synchrony** , and the artifacts are a pure
1137- projection of the registry — a retirement whose entry was ** never written** leaves everything perfectly consistent
1138- and every gate green (a removal has shipped that way, caught only by a human comparing by eye). Ledger entries are
1139- the sole channel that reaches an upgrader (` objectstack migrate meta ` , ` spec-changes.json ` , the upgrade guide) —
1140- for a surface with no spec schema there is no tombstone or schema rejection either. Roughly 1 declared-breaking
1141- change in 7 needs an entry, so ` not-required ` is the ordinary answer and costs one line; the markers are re-verified
1142- mechanically, and ` no-migration-prescription ` is refused when the changeset's own body carries a FROM → TO
1143- prescription.
1138+ Why it is asked of you at all: the gate prints the argument when it fails — that output is the authority.
114411394 . ** A removal that breaks the pinned sibling checkout ships together with the sibling fix and the pin bump — or it
11451140 does not ship.** The ` Console Pin Gate ` job builds objectui at the pinned ` .objectui-sha ` against ** current** ` main ` ,
11461141 so a removal or rename the pinned sibling still imports turns ` main ` red for every PR in the repo the moment it
0 commit comments