om-correct

/om-correct

/om-correct "<the corrected fact, stated as it is now true>"

The acting half of Write-Correctness Law 2. Laws 1 and 2 already say a corrected fact must be swept out of every note restating it; this is the thing that does it.

Run it at the moment of correction, not on a schedule. /om-vault-audit is periodic, whole-vault and structural, and takes no argument. A sweep needs the corrected fact as input, because nothing in the vault can resolve two contradicting notes — nothing in it says which is true. Only the person making the correction knows, which is why the fact is an argument and not a discovery.

Hard rails

• A historical note is never edited. Not carefully, not with a callout. It is reported and preserved. See the asymmetry below.
• Never delete. Restatements are replaced with a link to the source, not removed.
• Never commit. Leave the working tree for review.
• No authoritative note, no edits. If the single source cannot be identified, the pass reports and stops rather than guessing.

1. Find

Both arms, always. Neither alone is sufficient.

• Semantic — qmd query "<the corrected fact>" (index name from vault-manifest.json). This is the arm that finds the paraphrase: the same claim in someone else's words, with none of the same strings. That half is invisible to grep and indistinguishable from correct prose to every structural check, and it is the half most likely to survive a manual sweep, because the sweeper stops when grep goes quiet.
• Literal — grep the distinctive strings from the fact: version numbers, tool names, counts, identifiers. This is the arm that finds a bare v8.3.2 that means nothing to an embedding.

2. Classify

This is the design. The search is the easy part.

class	what it is	what happens
AUTHORITATIVE	the single-source note Law 1 designates	the correction is applied here, and only here
RESTATEMENT	a living note asserting the fact, which per Law 1 should be linking to the source instead	the assertion is replaced with a link — fixes today's stain and prevents the next
HISTORICAL	a note that correctly records what was believed at the time	preserved, and reported so the omission is visible