Repository navigation
v1.22.0
Measured proof. For a working doc that declares PROTOCOL: v0.2, review no longer takes "fails
without the change" on the author's word: a script runs the proving test twice and counts the result.
PROTOCOL:header field.check_linesreads- **PROTOCOL:** v0.2(or`PROTOCOL: v0.2`)
from the doc's header — before its first##section, so a quoted mention never declares — and names
it on thedocline. A doc without the field islegacy: its report is unchanged, andPROOFis
never required of it. An unknown version is NOT-CHECKABLE (exit 3).templates/ticket.mdnow declares
v0.2, so new tickets opt in.proof.pyand thePROOFline. Run 1: the base source with the test files the branch added or
changed (verification.proof.test_paths). Run 2: the head; a test that does not pass is re-run once
there. Each test is classified by the kind of failure, never by how many fail:proven,
regression-guard,green@base,env-fault@base(an import of something the diff does not add, a
connection error),not green@head(failed, errored, skipped),flaky,could-not-run. Both runs
happen in throwaway worktrees, removed on every path out.- Registered grammar and gates.
PROOF: <n> proving test(s) | <p> proven | <r> regression-guard | <z> green@base | <e> env-fault@base | <g> not green@head | <f> flaky | <c> could-not-run, identity
n = p+r+z+e+g+f+c. Required at review of a v0.2 doc. Blocks Gate 4 whenz > 0,g > 0or
n = 0.PROOF waived (verification.proof.enabled: false)waives the requirement and is disclosed. designdeclares regression guards on a**Regression guards:**line (tests green at base by
design: refactor, docs, config); Gate 2 approves it.reviewstep 6b runsproof.pyand pastes
its output; exit 2 is not clean, exit 3 is disclosed.- Presets.
unittestonly (FAIL and ERROR are red; results read from-voutput). pytest and every
other runner arecould-not-rununtil a recorded sample proves how to read their output: no pytest
was available to record one. - Config.
verification.proof.enabled(default true),timeout_s(default 300),test_paths. - Maturity. Measured proof is Experimental (
principles/maturity.md). - Words.
design,reviewandtemplates/ticket.mdstay within their ledger: the additions are
paid for by sentences that restated a reason.design3,100 → 3,090,ticket.md4,278 → 4,273,
principles/maturity.md929 → 923,reviewunchanged at 3,504.