Skip to content

Record the M3.10c delivery, its margin, and a rule about guards - #179

Merged
kaikisegfault merged 2 commits into
mainfrom
docs/m3-10c-closeout
Aug 17, 2026
Merged

Record the M3.10c delivery, its margin, and a rule about guards#179
kaikisegfault merged 2 commits into
mainfrom
docs/m3-10c-closeout

Conversation

@kaikisegfault

Copy link
Copy Markdown
Owner

Closeout for #177 / PR #178, which merged by rebase across 0563dab through 5f6f70a. Documentation only — the lightweight metadata path is the risk-proportionate gate.

What it records

  • The merge facts. PR run 32038739390 on head ea7f916 passed the complete hosted matrix; the post-merge run on main is recorded once terminal.
  • The margin. About eleven minutes. The slowest job went from 9m21s to 8m48s while the slice removed six translation units and added ten plus five test units and a fuzz target — inside the run-to-run variance, so replacing a codec cost nothing measurable. clang-sanitizers is still the slowest and is the only preset that builds the fuzz targets, so it is where M3.10d's transitions will show first.
  • A Guards section in docs/engineering/verification.md. This slice found the same defect M3.7a found, one block later in the same file: a pattern anchored to a closing paren in column zero does not terminate at a block nested inside if(...), runs on, and finds the name it was asked to notice was missing. Twice is a rule.

Two rules, and both come from a defect rather than from principle:

  • A guard must be run against the omission it exists to catch, and be seen to fail. Adding it and observing that the repository passes establishes nothing — the repository passed before it was written. The first draft of M3.10c's fuzz-registration guard passed with the target removed from PROTOCOL_STACK_TARGETS entirely.
  • A guard that parses CMakeLists.txt must assert what its pattern reached, so a pattern that swallowed the file fails rather than passes.

Verification

python3 tools/verify_metadata.py — 5 skills and 212 internal Markdown links validated. python3 -m unittest discover -s tests/tools -p '*_test.py' — 19 tests, OK.

…ut guards

M3.10c merged by rebase across `0563dab` through `5f6f70a`. PR run 32038739390
on head `ea7f916` passed the complete hosted matrix. The margin is about eleven
minutes: the slowest job moved from 9m21s to 8m48s while the slice removed six
translation units and added ten plus a fuzz target, which is inside the run-to-run
variance and says the exchange was roughly even.

`docs/engineering/verification.md` gains a Guards section, because this slice
found the same defect M3.7a found and one block later in the same file. A guard's
subject is the gate rather than the protocol, so the failure it catches is silent
and nothing notices when the guard itself stops working. Two rules: run a guard
against the omission it exists to catch and see it fail, because the repository
passed before the guard was written; and assert what a CMake parse reached,
because both defects so far are a pattern that ran past a block nested inside
`if(...)` and found the name it was asked to notice was missing.

The next action is M3.10d, the fourteen transitions.
@kaikisegfault
kaikisegfault merged commit 53d8f20 into main Aug 17, 2026
3 checks passed
@kaikisegfault
kaikisegfault deleted the docs/m3-10c-closeout branch August 17, 2026 14:47
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.

1 participant