Split out of #696, whose two substantive halves are now closed (the Idris2
duplication by #815, the Zig CI gate by the #812/#813/#696 PR). Its "For
contrast" section recorded two documentation defects that are not part of
either fix, and they should not be closed silently along with them.
1. AFFIRMATION.adoc overclaims
It states zero escape hatches. Measured across 22 .idr files: 0
assert_total, 0 postulate, 0 %hint, and 8 believe_me — 4 in comments
carrying an explicit -- hypatia: allow pragma, 4 in a deliberate scanner
fixture. None execute, so the spirit of the claim holds, but the literal claim
is false as written.
Acceptance criteria
2. docs/proof-debt.md cites things that do not exist
Evidence: docs/DEBT-REGISTER.md (P-1, P-2, P-3, C-4).
Note on framing: a document that instructs readers to run a nonexistent
verification script is worse than one that says nothing, because it reads as
evidence that checking happens. That is the reason to fix it rather than to
file it as cosmetic.
Split out of #696, whose two substantive halves are now closed (the Idris2
duplication by #815, the Zig CI gate by the #812/#813/#696 PR). Its "For
contrast" section recorded two documentation defects that are not part of
either fix, and they should not be closed silently along with them.
1.
AFFIRMATION.adocoverclaimsIt states zero escape hatches. Measured across 22
.idrfiles: 0assert_total, 0postulate, 0%hint, and 8believe_me— 4 in commentscarrying an explicit
-- hypatia: allowpragma, 4 in a deliberate scannerfixture. None execute, so the spirit of the claim holds, but the literal claim
is false as written.
Acceptance criteria
outside
test/soundness/fixtures/" — rather than deleted or leftabsolute.
believe_meadded outside it still contradicts the document.from this issue.
2.
docs/proof-debt.mdcites things that do not existscripts/check-trusted-base.sh. No suchscript exists. Either add it or remove the instruction.
check-trusted-baseCI job enforces annotation. No suchjob exists in any workflow. Either add it or remove the claim.
.claude/worktrees/", a directory that no longer exists. Re-derive thecount from the live tree, and state what it was derived from.
Evidence:
docs/DEBT-REGISTER.md(P-1, P-2, P-3, C-4).Note on framing: a document that instructs readers to run a nonexistent
verification script is worse than one that says nothing, because it reads as
evidence that checking happens. That is the reason to fix it rather than to
file it as cosmetic.