Commit Graph

1 Commits

Author SHA1 Message Date
Levi Neuwirth 1a7dd47cb7 docs: commit the test-suite audit that scopes the testing arc
Five parallel read-only audits --- dark tests, unit-coverage map, the
Lua layer, test quality, and the CI-versus-gates delta --- organized
into findings (§1-4), CI hardening and speedups (§5-6), ten prioritized
candidate lanes (§8), and a re-measurement appendix, because every
count in it drifts with each merge.

Committed now, ahead of the lanes it scopes, for a reason the ledger
already enforces: it was untracked and machine-local, so a lane entry
citing "TEST_IMPROVEMENT.md §8" was a dangling reference on any other
machine. Review of PR #192 caught exactly that, and that entry was
rewritten to be self-contained rather than left pointing at a file no
one else could read. Later lanes need to cite §1.2's silent-skip
inventory and §3's race shapes directly, so the document has to exist
in the repo first.

Two findings in it correct documents already on `main`, and both were
hand-verified rather than taken on the audit's word:

  * `docs/agent-handoff.md` claimed `scripts/bite` restores via
    `git checkout --`, destroying uncommitted work. False --- it has
    always restored from a mktemp copy under a trap. PR #192 carries
    the correction.
  * `scripts/bite` had no positive control, so a test that fails
    everywhere reported `bite: OK`. Also PR #192.

Kept at the repository root beside `CLAUDE.md` and `COHERENCE.md`,
where it was written, rather than moved under `docs/`. It is an audit
that scopes an arc rather than a framing for one lane, and moving it
would break every reference already made to it.

Docs only. No product code, no tests, no CI change.
2026-07-29 11:13:39 -04:00