docs(scripts): published-README baseline's $comment describes its contract, not a seed count (#9649) (#9764)

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.


Claude-Session: https://claude.ai/code/session_01XqDQYVU5smx29ts9pAErja

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

Author: os-steve

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: `<package>|<file>|<kind>|<specifier>[|<symbol>]`. Run the checker to see the",
     "exact key it computes for a finding."