From 7ab69e6b4f6713ad320262899fd152533827d94b Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 18 Aug 2026 22:34:37 +0000 Subject: [PATCH] docs(scripts): published-README baseline's $comment describes its contract, not a seed count (#9649) The block claimed the file was "seeded from the five instances #9532 measured". It shipped with 16 entries (PR #9546) and has since shrunk to 0 through #9602, #9615 and #9581, so the sentence was wrong on day one and the gap kept changing meaning as the ledger shrank. Rewritten to state the contract rather than a number: what an entry is (one known instance still awaiting repair, debt not exemption), that the count is read from `entries` and never asserted in prose, that `entries: []` is the success state rather than a corrupt or deletable file, and that absence from the file means measured-and-clean rather than unscanned -- which is what the plugin-audit negative control now says for every package. No baseline entry is added, removed or edited. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01XqDQYVU5smx29ts9pAErja --- .../published-readme-exports.baseline.json | 29 +++++++++++++++---- 1 file changed, 24 insertions(+), 5 deletions(-) diff --git a/scripts/published-readme-exports.baseline.json b/scripts/published-readme-exports.baseline.json index e9dfb37ce0..c6f0831916 100644 --- a/scripts/published-readme-exports.baseline.json +++ b/scripts/published-readme-exports.baseline.json @@ -13,11 +13,30 @@ "fabricated symbol still goes red; a file-level mute would be the very button this gate", "was written to replace.", "", - "Seeded from the five instances #9532 measured. They are the worklist for the per-package", - "README rewrites (the other half of that card) — when a rewrite lands, its entry goes.", - "The sixth instance, @objectstack/plugin-audit, was fixed by PR #9531 before this gate", - "landed and is deliberately ABSENT: it is the negative control, and the PR that added", - "this gate reports it clean.", + "WHAT AN ENTRY IS. One known instance still awaiting repair: a symbol a published README", + "tells a reader to import that its package does not export. It is DEBT, never an", + "exemption — the remedy is the README (or the missing export), and the entry leaves in", + "the same PR. HOW MANY there are is deliberately not written here: the count changes with", + "every PR that repairs one, and prose asserting it goes stale unread — this block said", + "'seeded from the five instances #9532 measured' while the file held sixteen, and that", + "gap only widened as the ledger shrank (#9649). Read the count from `entries`.", + "PROVENANCE: seeded by PR #9546, the PR that added the gate, from what #9532 measured;", + "every repair since has deleted its own entry.", + "", + "EMPTY IS THE SUCCESS STATE, NOT A DEAD FILE. `entries: []` means every known instance", + "has been repaired. The loader requires only that `entries` be an array — there is no", + "non-empty assertion anywhere in the checker — so an empty ledger is a passing run, not a", + "corrupted or half-written one. ⛔ Do NOT delete the file when it empties: `loadBaseline`", + "refuses outright if it is missing ('cannot tell debt from a new defect'), so its absence", + "is a hard failure rather than a clean run. The empty file is what keeps the NEXT", + "fabrication reportable as NEW instead of arriving with no ledger for it to be absent", + "from.", + "", + "ABSENCE FROM THIS FILE NEVER MEANS UNSCANNED. @objectstack/plugin-audit was fixed by", + "PR #9531 before this gate landed and was deliberately never baselined: the PR that added", + "the gate reports it clean. It is the negative control — and with the ledger empty that", + "reading now covers every package: not listed here means measured and clean, never", + "skipped.", "", "Key format: `|||[|]`. Run the checker to see the", "exact key it computes for a finding."