Name the New Pieces in the Release History - #662
Merged
Conversation
The 2.0 entry enumerates what this repository became and stopped at the AUDIT.md convergence procedure. Three things shipped since that are peers of the items it lists and appear nowhere: RESYNC.md, which is now the third procedure an agent routes between rather than a detail of the second, the host tool contract with its version floors, and the derived detector for files the hub hosts rather than carries. Caught before cutting a release rather than after. A patch release against this entry would have published a changelog whose summary omits the session's main deliverable, and a reader looking for how a repository resyncs would find the enumeration naming only the procedure that measures. This is the same shape as the spec/ enumerations corrected in #653 and the Repository Layout bullet corrected downstream: a list that was accurate when written, going stale under a change that never mentioned it, with no gate that reads it. The README and HISTORY openings still mirror, checked rather than assumed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the HISTORY.md release-history summary for Version 2.0 so it remains accurate as the repository’s governance/audit catalog has gained additional peer-level components (procedures, host tooling contract, and hub-hosted-file detection) since the initial 2.0 entry was written.
Changes:
- Expand the Version 2.0 bullet to include
STANDUP.md,AUDIT.md, andRESYNC.mdas the three core routing procedures. - Include the host tool contract and version floors (
spec/host-tools.jsonplus per-repohost-tools.json). - Note the derived detection for hub-hosted (not carried) files so retirements are detected without a manual list.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Uh oh!
There was an error while loading. Please reload this page.
ptr727 added a commit
that referenced
this pull request
Aug 11, 2026
One squash: [#662](#662) at [`31880f0`](31880f0). **Merge with a merge commit, never a squash, and never with `--delete-branch`** — this PR's head *is* `develop`. ## Why it wants promoting before the release, not after `HISTORY.md`'s Version 2.0 entry enumerates what this repository contains and had stopped at the `AUDIT.md` convergence procedure, omitting three peers of the things it lists: `RESYNC.md`, the host tool contract and its version floors, and the derived detector for files the hub hosts rather than carries. A release cut against the previous text publishes a changelog whose summary omits the work. The release reads `main`, so this promotion is the last step before a dispatch is worth making. ## Verification `README.md` and `HISTORY.md` must open as twins per `spec/readme-structure.md`, checked with the audit's own extraction rather than by eye: titles match, taglines match. `cspell` clean on both gated files, `prose_lint`, `markdownlint-cli2` and `editorconfig-checker` clean, CRLF preserved byte-wise. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
8 tasks
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 freeto 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.
A pre-release check that found something, rather than a change anyone asked for.
Problem
HISTORY.md's Version 2.0 entry enumerates what this repository became: "the shared fleet rules, a machine-readablespec/, the fleetregistry/, per-repo auditreports/, branch rulesets, and theAUDIT.mdconvergence procedure."Three things shipped since are peers of the items in that list and appear nowhere in it:
RESYNC.md, now the third procedure an agent routes between, not a detail of the secondspec/host-tools.jsonplus a carriedhost-tools.jsonper repositoryWhy it was worth catching first
A patch release cut against this entry would have published a changelog whose summary omits the session's main deliverable. A reader asking how a repository resyncs would find an enumeration naming only the procedure that measures.
HISTORY.mdis per minor version rather than per patch, so nothing is owed for a routine2.0.x. What is owed is that the 2.0 summary stay true about what 2.0 contains, and it had stopped being true.The pattern, third time today
This is the same shape as the
spec/enumerations corrected in #653 and theRepository Layoutbullet corrected downstream in Blog: a list that was accurate when written, going stale under a change that never mentioned it, with no gate that reads it.The recurrence is worth noting on its own. Three instances in one session suggests enumerations are a standing hazard rather than three accidents, and the deletion sweep's new "read the files whose job is to say what the repo holds" (#660) covers deletions only. Additions have no equivalent instruction. Not fixing that here.
Verification
The
README.mdandHISTORY.mdopenings must mirror perspec/readme-structure.md, so that was checked rather than assumed: titles match, taglines match, using the audit's own extraction.cspellon both gated files clean,prose_lint --diff HEADclean,markdownlint-cli2clean,editorconfig-checkerclean, CRLF preserved byte-wise.🤖 Generated with Claude Code