This is the record of an abcd-managed repository

abcdBetav0.16.2 · 2026-11-06

Development record

A code comment can claim a rule is applied everywhere while a sibling file in the same package breaks it, and nothing detects the gap. Found by a reviewer reading the comment against the code, in a managed repository, not by any scan. abcd already holds the idea this needs: the citation merge carries honesty rules, and the documentation gate refuses a change-narration claim in prose. Neither reaches a scope claim written in a Go comment, so the most load-bearing sentences in the codebase, the ones that tell the next reader an invariant holds across every call site, are exactly the ones nothing checks. The class is worth naming because this repository keeps meeting it from both ends. Its own bug-hunting playbook states the rule, that a fix is not done until every sibling site is swept and the pattern is grepped rather than the instance, and a defect on this very branch was precisely that shape: the anti-forgery work fenced a renderer's block content, left its block metadata raw, and the regression test covered only the path that was fixed, so a comment and a test together asserted a guarantee the code did not hold. A detector cannot judge whether an invariant is true, but it can find the claim: a comment asserting universality near a construct that has siblings is a place for a human to look, and listing those places is cheap where reading every comment is not.

issueopenminoriss-2609120441199164

A code comment can claim a rule is applied everywhere while a sibling file in the same package breaks it, and nothing detects the gap. Found by a reviewer reading the comment against the code, in a managed repository, not by any scan. abcd already holds the idea this needs: the citation merge carries honesty rules, and the documentation gate refuses a change-narration claim in prose. Neither reaches a scope claim written in a Go comment, so the most load-bearing sentences in the codebase, the ones that tell the next reader an invariant holds across every call site, are exactly the ones nothing checks. The class is worth naming because this repository keeps meeting it from both ends. Its own bug-hunting playbook states the rule, that a fix is not done until every sibling site is swept and the pattern is grepped rather than the instance, and a defect on this very branch was precisely that shape: the anti-forgery work fenced a renderer's block content, left its block metadata raw, and the regression test covered only the path that was fixed, so a comment and a test together asserted a guarantee the code did not hold. A detector cannot judge whether an invariant is true, but it can find the claim: a comment asserting universality near a construct that has siblings is a place for a human to look, and listing those places is cheap where reading every comment is not.

Remedy grounds (2026-09-29)

Why: a detector cannot judge whether an invariant holds but can cheaply find where one is claimed, which is the record's own framing, so the output is a listing, not a gate. Rejected: a warn rule under the BT3 baseline, whose new-warning-fails behaviour would turn a heuristic listing into a refusing gate.

Frontmatter

idiss-2609120441199164
typeissue
lifecycleopen
severityminor