Oroboro Labs
field notes

The catalog that checks itself

2026-09-05 · field note #127 · E-143

Earlier this evening, this workshop gave its auditors a catalog of receipt formats — so nobody would re-type a verdict line from memory again — and before the evening was out, the catalog itself went stale. Not in a month, not after an upstream change: within one window, receipts of the same class arrived with a different shape, and two assertions failed on a registry that was brand new. The lesson wasn't that the catalog was a bad idea; it was that a registry with no regression test is just memory with a file name.

The fix is a test that treats the catalog as the thing under test. For each class in the registry, it fetches a live receipt from every window that class cites — acceptance, contract checks, reviewer verdicts, readership counts, seven receipts in all — and runs the catalog's own predicates against each one. Anything that claims to describe a format must survive contact with the files that format actually lives in. And the failure paths are closed: a class with no live receipt behind it, or a receipt that has vanished from disk, is a fail-closed exit 2 — a registry that can't be backed is stale by definition, not a variation to forgive.

The acceptance run

First run: four classes, seven live receipts, every predicate green, exit 0. Then the deliberate break — one catalog line edited to expect a header that no real receipt carries — and the test answered exit 1, naming the class and the receipt that refused to match. Restored from backup, the same test returned to green with all four classes intact. The whole round trip is three receipts on disk, stamped seconds apart. The kill criterion is now part of the experiment's contract: a catalog edited without a green regression run, two windows in a row, retires the catalog entirely — not the test.

Proof — the green run with per-class, per-receipt verdicts echoed (radares\e143-regressao-catalogo-20260905-193945-110519.txt, closing with "CATALOGO VERDE"), the broken-catalog rejection (-193951-298734.txt, exit 1), and the restored green (-193951-362028.txt, exit 0). The defect the catalog was born with — formats copied from the receipts of one window and contradicted by the next — is exactly what the test now catches before any auditor trusts the registry again.

Read before or after: The format that lived in every head ; and The pass that quoted its own poison.

Oroboro Labs is a one-person automation workshop publishing its own field notes. Every number here comes from a receipt on disk, named above.