Evidence (grounded)
src/content/docs/cli-reference.md was last modified 2026-03-24 — the only content page not refreshed in the 2026-05-26 sweep (the other 7 pages in src/content/docs/ were all updated that day).- It documents the Charter CLI command surface (
charter validate / drift / audit / classify / hook / bootstrap / setup / init / adf / doctor / why).
- Charter CLI has shipped releases since that date — v0.12.0 → v0.12.1 published to npm 2026-05-05. The documented command/flag surface has not been validated against the current shipped CLI since.
Why this is an audit, not an auto-fix
Validating "does the documented surface match the shipped CLI" is a semantic correctness judgment, not a mechanical string swap. Per CodeBeast ADR-002 (logic/behavioral changes → human merge gate), this is not an auto-fix candidate — it needs a human or agent to diff the doc against the real CLI. If the audit surfaces specific mechanical corrections (a renamed flag, a removed command, a wrong version string), those can be split out as narrowly-scoped auto-fix issues at that point.
Scope
Not in scope: the other 7 docs pages (verified fresh as of 2026-05-26). The repo's own .claude/commands/validate.md / drift.md + docuoctopus agent may already cover part of this — check before doing it by hand.
Filed by AEGIS as part of docs-repo currency review (2026-05-30). Premise check: most docs are NOT stale — 7/8 pages are current; this is the lone laggard.
Evidence (grounded)
src/content/docs/cli-reference.mdwas last modified 2026-03-24 — the only content page not refreshed in the 2026-05-26 sweep (the other 7 pages insrc/content/docs/were all updated that day).charter validate / drift / audit / classify / hook / bootstrap / setup / init / adf / doctor / why).Why this is an audit, not an auto-fix
Validating "does the documented surface match the shipped CLI" is a semantic correctness judgment, not a mechanical string swap. Per CodeBeast ADR-002 (logic/behavioral changes → human merge gate), this is not an
auto-fixcandidate — it needs a human or agent to diff the doc against the real CLI. If the audit surfaces specific mechanical corrections (a renamed flag, a removed command, a wrong version string), those can be split out as narrowly-scopedauto-fixissues at that point.Scope
src/content/docs/cli-reference.mdagainst the actual@stackbilt/cliv0.12.1 surfaceNot in scope: the other 7 docs pages (verified fresh as of 2026-05-26). The repo's own
.claude/commands/validate.md/drift.md+docuoctopusagent may already cover part of this — check before doing it by hand.Filed by AEGIS as part of docs-repo currency review (2026-05-30). Premise check: most docs are NOT stale — 7/8 pages are current; this is the lone laggard.