Resolves the release recipe's carriers at read time - #219
Merged
Conversation
The "Where the fields live" section named the README pin by a literal version and a literal README line. Both had rotted: the version was several majors behind and the line had moved down as the README grew. The version file's line number was correct today and rots the same way, so it goes with it. Both carriers are now described by shape and resolved with a grep the reader runs, and a paragraph in "The README pin's exact form" says why this file carries no version string and no line number at all. Same rotting-reference class the sibling recipes fixed in sb-0id2 and sui-040. No mix.exs, README, or changelog change: the recipe document is the only file touched. Refs: px-jci
Codecov Report✅ All modified and coverable lines are covered by tests. 🚀 New features to boost your workflow:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
.claude/wurk/release.md's "Where the fields live" section named the READMEinstall pin by a literal version and a literal README line number. Both had
rotted: the version was several majors behind the published one, and the line
had moved down as the README grew. The version file's line number was still
correct today but rots by exactly the same mechanism, so it goes with it.
Both carriers are now described by shape and resolved with a grep the reader
runs at read time:
Each resolves to exactly one line on
maintoday. A paragraph in "The READMEpin's exact form" records why this file carries no version string and no line
number anywhere, and what to do if the two carriers ever disagree on major or
minor.
This is the same rotting-reference class the sibling recipes fixed in
sb-0id2(statifier_blocks) and
sui-040(statifier-ui), and their files are theprecedent this one follows.
What this does not touch
mix.exs,README.md,CHANGELOG.md,changelog.d/and the manifest are allunchanged. The recipe document is the only file in the diff. No changelog
fragment:
changelog.d/README.mdexcludes agent-tooling and documentationchanges.
Provenance
Beyond the README pin the bead names, the same edit removes the
mix.exs:5line reference in the adjacent bullet. The bead's second acceptance criterion
asks for every other version-specific claim in the file to be checked, and a
file that resolves one carrier by grep while pinning the other by line number
would have re-grown the defect at the next insert. Reported here rather than
made silently.
Verification
Docs-only under CLAUDE.md's authority table (a change touching no Elixir code
has no gate to run and commits on review of the diff); CI runs the gate on the
branch. Acceptance criteria machine-checked against the committed file:
grep -nE '[0-9]+\.[0-9]+') and nofile:linereference (
grep -nE '\.(exs|ex|md|json):[0-9]+') remain in the file - bothgreps return nothing; the only digits left are the two cited bead ids and an
ADR number;
release.readme_pinistrue, the pin drops its patch component,CHANGELOG.mdcarries no## [Unreleased]heading,changelog.d/holds onlyits
README.md, anddocs/adr/0006-*exists.Refs: px-jci