Skip to content

chore: close spc-26 and record the ruling that adoption stays nameless - #642

Open
REPPL wants to merge 2 commits into
mainfrom
chore/close-spc26-and-record-ahoy-ruling
Open

REPPL wants to merge 2 commits into
mainfrom
chore/close-spc26-and-record-ahoy-ruling

Conversation

@REPPL

@REPPL REPPL commented Sep 17, 2026

Copy link
Copy Markdown
Collaborator

Two maintainer rulings from the v0.8.0 review, landed together because both came out of the same read of what the release had left standing.

spc-26 is closed and itd-121 ships: the record-id dispatch form (abcd itd-20, abcd iss-110 rendering a record's path, status, links and next moves) has been live for some time while its spec sat in open/ and its intent in planned/. It was deliberately not closed during the v0.8.0 cut, because closing it mid-cut would have written a 0.8.0 line for work that shipped earlier. Closing it now puts that line in the next cut instead, which is still not the release that carried the work; the intent's shipped_in is left for the cutting session to stamp.

The second ruling files iss-2609110944498549: ahoy install must not write abcd by name into a target repository — adoption stays nameless.

Brought up to today's main by merge; lint-decisions, record-lint, lint-issues and docs-lint are clean on the branch.

Refs: iss-2609110944498549, iss-110
Assisted-by: Claude:claude-fable-5-1

Two maintainer rulings from the v0.8.0 review, landed together because both came
out of the same read of what the release had left standing.

spc-26 is closed and itd-121 ships. The record-id dispatch form has been live for
some time — `abcd itd-20`, `spc-26`, `adr-23` and `iss-110` all render their path,
status, links and next moves — while its spec sat in `open/` and its intent in
`planned/`. That is the silent half of the definition of done: nothing runs the
close for you, and a planned intent is not refused by the release cut, merely
unseen.

It was deliberately not closed during the v0.8.0 cut. The changelog is composed
from the records that reach a terminal folder since the anchor tag, so closing it
mid-cut would have written a 0.8.0 line for work that shipped earlier, and broken
the completeness bijection the section had already proved. Closing it now moves
that line to the next cut instead, which is still not the release that carried
the work. `spec close` has no `--shipped-in` escape, unlike `capture resolve`,
so there is no way through this verb to close the record and keep it out of the
cut. Worth deciding at the next cut whether the line stands or the escape is
worth adding.

The ahoy ruling is recorded rather than implemented. `ahoy install` defaults
`--docs-target` to `both` and plants a block opening "Managed by abcd" into a
target repository's committed CLAUDE.md and AGENTS.md, while
`prepare-this-repo` promises in its acceptance criteria that no abcd-internal
content appears in any committed artefact. The v0.8.0 gate caught the
contradiction and the prose was corrected to match the code; the ruling is that
the promise was the right end and the behaviour is what should change, so
implementing it reverses that correction deliberately.

The record carries what the change has to settle rather than just the verdict:
the marker is what promotes a folder to managed-repo, so a nameless block must
still classify; the rule loader has to keep being discoverable; and the real
question is the `both` default rather than the wording of the block.

Refs: iss-2609110944498549, iss-110

Assisted-by: Claude:claude-opus-5[1m]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant