Skip to content

docs: bring the matrix counts and the cursor witness into the prose - #159

Merged
jothimani-rajendran merged 1 commit into
mainfrom
claude/docs-refresh-0.3.3
Sep 23, 2026
Merged

jothimani-rajendran merged 1 commit into
mainfrom
claude/docs-refresh-0.3.3

Conversation

@jothimani-rajendran

Copy link
Copy Markdown
Collaborator

What this changes

Documentation only. The 0.3.3 release regenerated the capability-matrix figures when cursor's stop cell moved from detect to best-effort, but four hand-written passages were never brought along, so the prose now contradicts the data it describes.

  • README.md: the figure's alt text and the caption under it both read 33 best-effort, 56 detect. The SVG they describe already reads 34 best-effort, 55 detect. Corrected to match.
  • README.md: the supported-agents table dated cursor's witness 2026-08-27. The verified record in data/matrix.json is now live-run-partial · 3.21.18 · 2026-09-23. The row's enforcement cell also now mentions that stop returns a follow-up message.
  • docs/coverage-gaps.md: said "Fifteen of the sixteen have never been witnessed" and "every other agent's are open". Both are false now that cursor is witnessed at pre_tool and stop. Narrowed to fourteen, with cursor's two witnessed gates and its still-open prompt_submit named.
  • docs/design/dialect-families.md: the "stays code" table counted "The five grammar renderers G1–G5", two sections after the grammar table documents G6 follow-up message. Now six, G1–G6.
  • README.md: a cross-reference promised coverage-gaps.md covers "the three gates nobody has witnessed yet", which no longer describes that file.

No capability claim is widened and no data file changes; this brings the prose up to what the matrix already says.

Claim check

  • No capability claim is widened without a mechanism behind it
  • Any new/changed MATRIX row carries a verified record (version, date, method) — no matrix row changed; the README table now quotes the existing record's date
  • Payload shapes come from a primary source — unchanged; the cursor stop behaviour cited is the existing live witness on 3.21.18 recorded in data/matrix.json

Checks

  • pytest -q passes (1850 passed, 4 skipped)
  • ruff check . and ruff format --check . pass
  • Runtime path is still stdlib-only (no runtime file touched)
  • Commits are signed off (git commit -s)

Figures were re-rendered to confirm no drift: git diff --exit-code -- docs/figures is clean, which is what shows the counts in the images were already correct and only the prose lagged.

Notes for the reviewer

The counts were verified by reading the generated SVG rather than by trusting the old prose. Worth considering separately: nothing in CI checks the README's counts against matrix.py, which is why these drifted while the figure check stayed green.

🤖 Generated with Claude Code

https://claude.ai/code/session_01CzNYfzP8ymU3r4JB9Sz8Ha


Generated by Claude Code

The 0.3.3 figures regenerated to 34 best-effort and 55 detect when cursor's
stop cell moved, but the README's alt text and caption still read 33 and 56,
so the prose contradicted the image it captioned. The supported-agents table
still dated cursor's witness 2026-08-27 rather than the 3.21.18 run.

coverage-gaps.md still said fifteen of the sixteen agents had never been
witnessed, which the cursor pre_tool and stop witnesses make false, and
dialect-families.md counted five grammar renderers two sections after
documenting G6.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Signed-off-by: Claude <noreply@anthropic.com>
@jothimani-rajendran
jothimani-rajendran marked this pull request as ready for review September 23, 2026 20:08
@jothimani-rajendran
jothimani-rajendran merged commit 3647ea8 into main Sep 23, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants