docs-freshness: inventory sync — every public surface named, every count true - #175
Merged
Conversation
…unt true (#174) The gate grows the portal-proven second half (qorpe/api-portal scripts/docs-guard.sh): beyond broken links and retired names, it now fails when the docs stop NAMING reality: - every package on the capability ledger (short/capability spelling accepted; providers ride their base row), - any 'N packages' claim must equal the real count, - every CLI verb the dispatcher knows is in the CLI reference, - every nightly golden-manifest shape is in the golden-manifests doc, - every script is referenced somewhere a reader looks, - every template is in templates/README. Its first run caught TWELVE real staleness bugs, all fixed here: packages/README claimed 19 of 23 · 'export compose' and 'help' missing from the CLI reference · TEN nightly shapes undocumented (now a table the gate keeps honest) · bench-notification.sh and roll-shipped.sh referenced nowhere · goldpath-worker absent from templates/README · Approvals + FileExchange missing from the coverage matrix (added as Ring C rows with honest 🟡/🔷 states, foundational packages named as a section). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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.
Closes #174. The existing gate (links + retired names) gains the portal-proven inventory half: packages ⇄ capability ledger, numeric claims ⇄ reality, CLI verbs ⇄ reference, nightly GM shapes ⇄ golden-manifests doc, scripts ⇄ any reader-visible reference, templates ⇄ templates/README.
First run caught 12 real staleness bugs, all fixed in this PR — including
packages/READMEclaiming 19 of 23 packages and TEN undocumented nightly shapes (now a gate-kept table).🤖 Generated with Claude Code