Skip to content

docs(scripts): the published-README baseline's $comment describes its contract instead of a seed count#9764

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-steve merged 1 commit into from
Aug 19, 2026
+24 −5
Merged

docs(scripts): the published-README baseline's $comment describes its contract instead of a seed count #9764

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 24 additions & 5 deletions scripts/published-readme-exports.baseline.json
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -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."
Expand Down
Loading