Skip to content

Commit 59953d5

Browse files
claude[bot]claude
andauthored
chore(devx): state the react-page-adapter rot record as data and retire its held allowance row (#15765) (#15844)
The `scripts/**` symbol-anchor corpus (#15806) landed with two dated `HELD_FILE_ALLOWANCES` rows for files live PRs held. PR #15770 landed, so the row for `scripts/check-react-page-adapter-contract.mjs` is free — and an allowance nobody retires is an exemption wearing a date. The four dated readings in that gate's rot-record paragraph are now stated as DATA — a small table with the file and the line number in separate cells — never in `path:NNN` anchor form. The NUMBERS ARE NOT REPAIRED OR REPOINTED: they are readings taken on a date, the paragraph's argument is unchanged, and its ⛔ line still declares every number a record rather than a pointer. The one substantive addition is that the paragraph no longer claims nothing resolves citations in `scripts/**` — since #15806 something does, which is why the anchor spelling had to go. The self-test battery floor moves 34 → 30 because four of its cases are registered PER allowance row; the reason is recorded next to the number so a later reader cannot mistake the drop for cases that stopped running. Claude-Session: https://claude.ai/code/session_012zGPuVVX3deAx9LdjK8jCk Co-authored-by: Claude <noreply@anthropic.com>
1 parent 9e9f03a commit 59953d5

2 files changed

Lines changed: 28 additions & 21 deletions

File tree

scripts/check-react-page-adapter-contract.mjs

Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -130,16 +130,27 @@
130130
// fourth instance of a defect that is not there.
131131
//
132132
// ⚠️ Both citations above name a SYMBOL or a FILE, never a line, and that is
133-
// deliberate (#15599). The first one read `packages/client/src/index.ts:310`
134-
// when it was written; the #15094 census found that declaration at `:392` and
135-
// triage read `:390` the same day -- a cross-file line citation that rotted
136-
// twice inside one day, which is an argument against citing a line at all
137-
// rather than for repointing it. The second read `client-sdk.mdx:659`; that
138-
// sample had drifted off the cited line too. ⛔ Every number in this paragraph
139-
// is a DATED rot record, not a pointer -- do not repair one. `scripts/**` is
140-
// outside `check-adr-symbol-anchors`'s corpus (`docs/adr/**`, `.md` only), so
141-
// nothing resolves these two for you -- but the form is this repo's own
142-
// declared grammar, whose last line reads
133+
// deliberate (#15599). The rot record that MADE it deliberate is kept below as
134+
// DATA -- file and line stated as separate cells, never as a `path:NNN`
135+
// anchor, because each number is a reading taken on a date rather than a
136+
// pointer anything can resolve:
137+
//
138+
// the reading file line
139+
// ------------------------------- --------------------------------- ----
140+
// the citation as first written `packages/client/src/index.ts` 310
141+
// the #15094 census found it at `packages/client/src/index.ts` 392
142+
// triage read, the same day `packages/client/src/index.ts` 390
143+
// the second citation, as written `content/docs/api/client-sdk.mdx` 659
144+
//
145+
// One cross-file line citation rotted TWICE inside a single day -- an argument
146+
// against citing a line at all rather than for repointing it -- and the second
147+
// one had drifted off its cited line too. ⛔ Every number in this paragraph is
148+
// a DATED rot record, not a pointer: do not repair one, and do not write one
149+
// back into `path:NNN` form. Since #15806 this repo DOES resolve citations in
150+
// `scripts/**` comment prose (`scripts/check-scripts-symbol-anchors.mjs`, a
151+
// second corpus registration), so an anchor-shaped number here is judged and
152+
// reds -- which is the same conclusion the grammar already states, whose last
153+
// line reads
143154
// `⛔ <dir>/<file>.ts:4901 A LINE NUMBER IS NOT AN ANCHOR FORM.`
144155
// (`scripts/symbol-anchors.mjs#ANCHOR_GRAMMAR`), and a symbol name stays
145156
// checkable by grep where a number does not.

scripts/check-scripts-symbol-anchors.mjs

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -145,16 +145,6 @@ export const CENSUS_15765 = {
145145
* The only admissible reason is the hot-file serial queue.
146146
*/
147147
export const HELD_FILE_ALLOWANCES = Object.freeze([
148-
Object.freeze({
149-
file: 'scripts/check-react-page-adapter-contract.mjs',
150-
dated: '2026-09-05',
151-
heldBy: 'PR #15770 (#15599)',
152-
why: 'The citation is the WORKED EXAMPLE of the rot this whole gate exists for, and its own '
153-
+ 'paragraph declares every number in it a DATED ROT RECORD that must not be repaired. '
154-
+ 'The file is also held by a live PR of this lane, so it is not this card\'s to edit. '
155-
+ 'Both halves are resolved by the same follow-up: that paragraph names the file and the '
156-
+ 'numbers as data rather than in anchor form, on the PR that lands after #15770.',
157-
}),
158148
Object.freeze({
159149
file: 'scripts/check-adr-0087-registration.mjs',
160150
dated: '2026-09-05',
@@ -250,8 +240,14 @@ function assert(cond, msg) { if (!cond) { console.error(`❌ check-scripts-symbo
250240
// The count is a FLOOR, not an equality — adding cases is ordinary work and must
251241
// not red. A battery BELOW its floor means cases stopped running; the remedy is
252242
// to find what stopped registering.
243+
// ⛔ Four of these cases are registered PER `HELD_FILE_ALLOWANCES` row (the
244+
// exactness loop below runs four `check()`s over each row), so retiring a row
245+
// legitimately lowers this floor by 4 — and that is the ONLY reason it may be
246+
// lowered. 34 → 30 when the `scripts/check-react-page-adapter-contract.mjs`
247+
// row was retired (#15765). Any other drop is cases that STOPPED RUNNING; find what
248+
// stopped registering instead of moving the number.
253249
const SELF_TEST_BATTERIES = Object.freeze({
254-
'check-scripts-symbol-anchors self-test': 34,
250+
'check-scripts-symbol-anchors self-test': 30,
255251
});
256252

257253
// DELETING an entry silences that battery's floor exactly as effectively as

0 commit comments

Comments
 (0)