plan: a citation is a claim, and 4% of them are checked #1643

Merged
jaylouisw merged 3 commits from plan/1116-0910 into main 2026-11-16 09:26:50 +00:00
Owner

Forward plan only, no code. docs/plans/doc-citations.md.

Measured on b949ef3c today:

  • node scripts/check-doc-citations.js: 350 citations, 15 judged (4%), 266 lines skipped, 7 wrong by 56 to 513 lines (_help(), mkPath(), openFlow(), _deliver(), serialize(), setLinkLength()).
  • documentationFiles() reads docs/*.md only, so the 62 citations in docs/plans/ are never judged. Forced through run({files}): 1 judged, 53 skipped, and that one is already 148 lines wrong (docs/plans/capability-vocabulary.md:25 cites cli.js:288-292 for _capabilityRefusal(), defined at cli.js:436).
  • The check is wired to nothing: package.json:53 only, no CI step, not in premerge-check.js, and no test covers judgeLine().

The plan ranks six gaps and gives seven steps (S/M), each one PR: recursive walk (plans in, wiki out), sentence-scoped judging, a fixture test for the judge itself, repairing the 8 suspects, a baseline plus CI gate, the cite-by-symbol rule, and (fenced as a decision) a checker for prose counts. Closes nothing open; it addresses the family behind #1481 and the seven doc-drift issues closed today (#1571, #1578, #1582, #1587, #1621, #1628, #1637).

Forward plan only, no code. `docs/plans/doc-citations.md`. Measured on `b949ef3c` today: - `node scripts/check-doc-citations.js`: **350 citations, 15 judged (4%), 266 lines skipped, 7 wrong** by 56 to 513 lines (`_help()`, `mkPath()`, `openFlow()`, `_deliver()`, `serialize()`, `setLinkLength()`). - `documentationFiles()` reads `docs/*.md` only, so the **62 citations in `docs/plans/` are never judged**. Forced through `run({files})`: 1 judged, 53 skipped, and that one is already **148 lines wrong** (`docs/plans/capability-vocabulary.md:25` cites `cli.js:288-292` for `_capabilityRefusal()`, defined at `cli.js:436`). - The check is wired to nothing: `package.json:53` only, no CI step, not in `premerge-check.js`, and no test covers `judgeLine()`. The plan ranks six gaps and gives seven steps (S/M), each one PR: recursive walk (plans in, wiki out), sentence-scoped judging, a fixture test for the judge itself, repairing the 8 suspects, a baseline plus CI gate, the cite-by-symbol rule, and (fenced as a decision) a checker for prose counts. Closes nothing open; it addresses the family behind #1481 and the seven doc-drift issues closed today (#1571, #1578, #1582, #1587, #1621, #1628, #1637).
plan: a citation is a claim, and 4% of them are checked
All checks were successful
CI / Classify the change (pull_request) Successful in 13s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 15s
CI / Server smoke test (pull_request) Successful in 15s
CI / Docker build (pull_request) Successful in 25s
CI / Test (Node 20) (pull_request) Successful in 1m15s
CI / Test (Node 18) (pull_request) Successful in 1m27s
CI / Test (Node 22) (pull_request) Successful in 1m37s
65161ea562
docs/plans/doc-citations.md: the citation checker reads docs/*.md only, so the
62 citations in docs/plans are never judged; of the 350 it does read, 15 are
judged and 7 are wrong by 56-513 lines. Plan: walk recursively, judge the
sentence rather than the line, test the judge, baseline and gate it in CI.
jaylouisw changed title from CI: bound every network call the rebase maintenance jobs make to plan: a citation is a claim, and 4% of them are checked 2026-11-16 09:25:44 +00:00
jaylouisw scheduled this pull request to auto merge when all checks succeed 2026-11-16 09:26:42 +00:00
jaylouisw force-pushed plan/1116-0910 from 65161ea562
All checks were successful
CI / Classify the change (pull_request) Successful in 13s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 15s
CI / Server smoke test (pull_request) Successful in 15s
CI / Docker build (pull_request) Successful in 25s
CI / Test (Node 20) (pull_request) Successful in 1m15s
CI / Test (Node 18) (pull_request) Successful in 1m27s
CI / Test (Node 22) (pull_request) Successful in 1m37s
to d7ae063fe1
All checks were successful
CI / Classify the change (pull_request) Successful in 14s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 12s
CI / Test (Node 18) (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Has been skipped
CI / Test (Node 22) (pull_request) Has been skipped
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
2026-11-16 09:26:46 +00:00
Compare
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!1643
No description provided.