C1 outcome — Executable and documented command sets are equal
State: resolved 2026-08-19. There are 21 commonplace-* console scripts and
21 unique command-reference sections.
Resolution
C1 closed independently of F1. commonplace-verify-quotes is now documented,
and a test enforces exact name equality between the published and documented
sets. The assertion compares sets rather than freezing a permanent command
count.
F1 was a separate operativity contradiction. Its resolution removed
commonplace-freshness-accept from the package and command reference together;
the C1 guard passed at 21 without modification.
Implemented
- Added
commonplace-verify-quotesbeside deterministic validation incommands.md, including: - one or more Markdown file/directory targets;
- recursive directory behavior and
--show-matches; - match, mismatch, and unresolved reporting;
- exit
1for mismatches and exit0when only unresolved results remain. - Added
tests/commonplace/docs/test_command_catalogue_integrity.py. It reads[project.scripts]withtomllib, parses exact### commonplace-*headings, rejects duplicates, and compares the name sets with no allowlist. - F1 later removed
commonplace-freshness-acceptfrom both sets. C1 stayed closed because the guard compares names rather than freezing a count.
Verification
- The focused catalogue test passes.
- The complete test suite passes after F1's removal: 489 tests.
- The new test passes focused Ruff validation. Repository-wide Ruff still has pre-existing failures outside this change.
commands.md, this outcome, the plan index, and workshop state pass deterministic Markdown validation.
C1 reopens if a published commonplace-* name lacks exactly one matching
reference heading or a reference heading lacks a published command.