docs freshness · agent-readiness

README CC-floor badge — fixed & guarded

The public README advertised an outdated Claude Code support floor. This playground documents the 2-line fix and the stamp-script guard that stops it drifting again.

The drift (found in the public-surface assessment)

- README.md:8 badge ≥2.1.148

+ README.md:8 badge ≥2.1.183

- README.md:188 prose Requires **≥2.1.148**

+ README.md:188 prose Requires **≥2.1.183**

Source of truth: shared/cc-support.json → supported_floor: "2.1.183" (manual override, 2026-06-20). Line 213 (a versioned "What's New" entry) is intentionally left at 2.1.148 — it's historical, not a live claim.

Why it drifted — and the fix

The floor bump (2.1.148 → 2.1.170 → 2.1.183) auto-stamped every derived file except README, which wasn't wired into the stamp script. Now it is:

now stampedREADME.md badge + prose (regex targets only the 2 live claims)

alreadyCLAUDE.md · cc-version-matrix.ts · doctor/version-compatibility.md

guardexpectedMatches: 1 fails loudly if the README line is renamed/duplicated

Verified: node scripts/stamp-cc-support.mjs applies 2 mutations, then re-runs clean (idempotent). Nothing is broken elsewhere — About/Packages/Releases all track HEAD; the "frozen" npm/pypi deployments are a decoupled side-package.