paperlint 9.0.0 → 10.0.0

package/docs/rules.md

@@ -3,54 +3,57 @@
 The README lists what each check catches in one line. This page says exactly which file each one
 reads and when it fails. Errors fail `paperlint lint`; warnings print and do not.
 
-| Rule                                                                  | Level                                        | Reads                                                                             | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| --------------------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `paper/stages`                                                        | error                                        | `PIPELINE-STATUS.md`                                                              | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/source`                                                        | error                                        | `PIPELINE-STATUS.md`                                                              | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| [`cycle/record`](rules/cycle/record.md)                               | error                                        | `paperlint.json` (`cycles`)                                                       | the paper's attempts at venues (`cycles`, one entry per attempt) hold one source's deadlines out of order (registration ≤ submission ≤ resubmission < notification < camera-ready), or copy a portal reading the venue's preset carries; reported on `PIPELINE-STATUS.md`. A record that does not parse — a bare date, two open cycles, an unknown key — is refused by `paperlint lint` itself before any rule runs, exit 2 — [page](rules/cycle/record.md)                                                                                            |
-| [`cycle/evidence`](rules/cycle/evidence.md)                           | error                                        | `paperlint.json` (`cycles`) → the paper folder                                    | a closed cycle (`accepted`, `rejected`, `withdrawn`) or a deadline's `override` names an `evidence` file — the decision mail, the reviews, the withdrawal note, the chairs' mail — that is not in the paper folder; reported on `PIPELINE-STATUS.md` — [page](rules/cycle/evidence.md)                                                                                                                                                                                                                                                                 |
-| [`cycle/stage`](rules/cycle/stage.md)                                 | error                                        | `PIPELINE-STATUS.md` → `paperlint.json` (`cycles`)                                | with `cycles` declared, a stage names no `cycle: <id>`, names one no cycle has, or a `submitted`/`camera-ready` stage belongs to a cycle whose `phase` is still `porting` — [page](rules/cycle/stage.md)                                                                                                                                                                                                                                                                                                                                               |
-| [`cycle/port-done`](rules/cycle/port-done.md)                         | error                                        | `paper.tex` → `paperlint.json` (`cycles`) → the preset's `template`               | the current cycle still declares `"phase": "porting"` (which silences the venue's format rules) while the `\documentclass` is already the venue's template: the port is done, drop the phase — [page](rules/cycle/port-done.md)                                                                                                                                                                                                                                                                                                                        |
-| [`paper/folder-venue-leftover`](rules/paper/folder-venue-leftover.md) | warn                                         | the folder name → `paperlint.json`                                                | the paper's folder is named after another shipped venue than the one it extends (`papers/aisec-2026/` for a paper now set for AIDC); reported on `PIPELINE-STATUS.md` — [page](rules/paper/folder-venue-leftover.md)                                                                                                                                                                                                                                                                                                                                   |
-| [`paper/sources-fresh`](rules/paper/sources-fresh.md)                 | warn                                         | `paper.tex` → `_build/sources.json`                                               | the paper has not been built (no record of the files TeX read), or a file changed since the last build (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                               |
-| `paper/author-list`                                                   | error                                        | `paper.tex` → `_build/references.json`, `_build/sources.json`                     | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line (or at the top of `paper.tex`, naming the entry's file); silent without a current build record                                                                                                                                                                                                                                                    |
-| `paper/section-word`                                                  | warn                                         | `paper.tex` and its body files                                                    | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| `paper/leading-zero`                                                  | warn                                         | `paper.tex` and its body files                                                    | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable**                                                                                          |
-| `paper/figure-ref-style`                                              | warn                                         | `paper.tex` and its body files                                                    | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                                                                                                               |
-| [`bib/reachable-entry`](rules/bib/reachable-entry.md)                 | warn                                         | `paper.tex` → `_build/sources.json`: the databases the last build's bibtex opened | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry in the `filecontents` block of `paper.tex` that wrote its `.bib`, or at the top of `paper.tex` with the entry's file and line first; silent until a build records the paper; no fix, the link has to be looked up — [page](rules/bib/reachable-entry.md)                                                                                                                                                                                                  |
-| `paper/cite-exists`                                                   | error                                        | `paper.tex` → `_build/references.json`                                            | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/refs-fresh`                                                    | error                                        | `paper.tex` → `_build/references.json`                                            | the databases bibtex opened changed since the build checked them (their SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `paper/refs-checked`                                                  | warn                                         | `paper.tex` → `_build/references.json`                                            | a build recorded the paper's databases and none has checked their references, or the last build could not (no network), or its bibtex typeset a key paperlint's reader did not read (an entry behind `%`, inside `@comment{…}`), or bibtex found a database outside the paper directory (`BIBINPUTS`) — so the two rules above did not run on it. Silent without a record of the build (`paper/sources-fresh` speaks)                                                                                                                                  |
-| `tex/future-promise`                                                  | warn                                         | `paper.tex` and its body files                                                    | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `tex/acm-frontmatter-override`                                        | error                                        | `paper.tex`                                                                       | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`tex/template`](rules/tex/template.md)                               | error                                        | `paper.tex` → `paperlint.json`                                                    | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| [`tex/required-section`](rules/tex/required-section.md)               | error                                        | `paper.tex` → `paperlint.json`                                                    | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [`tex/heading-case`](rules/tex/heading-case.md)                       | optional; the AgenticDev preset sets `error` | `paper.tex` and the files it includes                                             | a word in the paper's `\title` or in a `\section`, `\subsection`, `\subsubsection`, `\paragraph` or `\subparagraph` title is not in the style its scope asks: `{ "title", "headings", "levels"? }`, each `chicago-headline` (Conference Publishing's quote of the Chicago Manual of Style), `sentence` (first word only) or `any`. Words that are a preposition in one title and a particle in another (`up`, `on`, `in`) are not read mid-title. **Fixable:** `--fix` — [page](rules/tex/heading-case.md)                                             |
-| [`format/layout-override`](rules/format/layout-override.md)           | error                                        | `paper.tex` → `paperlint.json`                                                    | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                                                                                                                   |
-| [`anonymity/identity`](rules/anonymity/identity.md)                   | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                                                                                                                      |
-| [`tex/venue-leftover`](rules/tex/venue-leftover.md)                   | warn                                         | `paper.tex` → `paperlint.json`                                                    | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                                                                                                                  |
-| [`tex/claim-provenance`](rules/tex/claim-provenance.md)               | warn                                         | `paper.tex`                                                                       | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                                                                                                             |
-| [`tex/register`](rules/tex/register.md)                               | warn                                         | `paper.tex` and the files it includes                                             | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                                                                                                                 |
-| [`tex/contrast-frames`](rules/tex/contrast-frames.md)                 | warn                                         | `paper.tex` and the files it includes → `paperlint.json`                          | contrast frames (_X, not Y_, _not X but Y_, _rather than_, _instead of_, _as opposed to_) per 10,000 words fall outside the band the venue preset's anchors set (AIDC: 0–10.4, from five accepted ACSAC papers); above it, each frame is reported too — [page](rules/tex/contrast-frames.md)                                                                                                                                                                                                                                                           |
-| [`tex/claim-emphasis`](rules/tex/claim-emphasis.md)                   | warn                                         | `paper.tex` and the files it includes → `paperlint.json`                          | claims set in bold inside a sentence (six words or more, or holding a number; not a term, not a label opening a paragraph) per 10,000 words fall outside the preset's band (AIDC: 0–17.8); above it, each is reported too — [page](rules/tex/claim-emphasis.md)                                                                                                                                                                                                                                                                                        |
-| [`tex/relation-markers`](rules/tex/relation-markers.md)               | warn                                         | `paper.tex` and the files it includes → `paperlint.json`                          | words that name how a sentence relates to the one before (_because_, _therefore_, _however_, _for example_ …) per 10,000 words fall outside the preset's band (AIDC: 25.4–135.0) — the floor that catches relations left to infer — [page](rules/tex/relation-markers.md)                                                                                                                                                                                                                                                                              |
-| `review/frontmatter`                                                  | error                                        | `reviews/*.md`                                                                    | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                                                                                                         |
-| `sibling/frontmatter`                                                 | warn                                         | `siblings/*.md` (not `README.md`)                                                 | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `pdf/fresh`                                                           | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                                                                                                             |
-| `pdf/profile`                                                         | error                                        | `paper.tex` → `paperlint.json`                                                    | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                                                                                                                |
-| `pdf/fonts`                                                           | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                                                                                                                     |
-| `pdf/geometry`                                                        | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| [`format/page-limit`](rules/format/page-limit.md)                     | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; with `appendix_in_body` too (MSR) the appendix is body wherever it sits and the reference pages are the ones holding only references; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md) |
-| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                        | `paper.tex` → `_build/paper.facts.json`                                           | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                                                                     |
-| `pdf/measured`                                                        | warn                                         | `paper.tex` → `_build/paper.facts.json`                                           | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                                                                         |
-| [`talk/profile`](rules/talk/profile.md)                               | error                                        | `paper.tex` → `paperlint.json`                                                    | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                                                               |
-| [`talk/required-files`](rules/talk/required-files.md)                 | error                                        | `paper.tex` → `paperlint.json`, the talk folder                                   | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                                                                     |
-| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                         | `paper.tex` → the paper's `talk/` folder                                          | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| [`talk/duration`](rules/talk/duration.md)                             | error                                        | `paper.tex` → the talk video                                                      | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                         | `paper.tex` → the talk video                                                      | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [`talk/video-format`](rules/talk/video-format.md)                     | error                                        | `paper.tex` → the talk video                                                      | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                                                              |
-| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                        | `paper.tex` → the one-slide PNG                                                   | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                         | `paper.tex` → the captions and the video                                          | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Rule                                                                  | Level                                                    | Reads                                                                             | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `paper/stages`                                                        | error                                                    | `PIPELINE-STATUS.md`                                                              | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/source`                                                        | error                                                    | `PIPELINE-STATUS.md`                                                              | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| [`study/declare-sample`](rules/study/declare-sample.md)               | experimental; off unless a paper turns it on (`"error"`) | each study's `repro/<study>/prereg.json`                                          | a study's pre-registration does not declare its `population` (what the claim is about, source, size), the `strata` and what each of its `screens` removed per stratum value, its `coverage` (share 0–1 or null with a reason, and the strata it cannot reach), or the `author_check` of the drawn units (a doubtful verdict needs a recorded `decision`); reported on `PIPELINE-STATUS.md`, once per problem — [page](rules/study/declare-sample.md)                                                                                                   |
+| [`cycle/record`](rules/cycle/record.md)                               | error                                                    | `paperlint.json` (`cycles`)                                                       | the paper's attempts at venues (`cycles`, one entry per attempt) hold one source's deadlines out of order (registration ≤ submission ≤ resubmission < notification < camera-ready), or copy a portal reading the venue's preset carries; reported on `PIPELINE-STATUS.md`. A record that does not parse — a bare date, two open cycles, an unknown key — is refused by `paperlint lint` itself before any rule runs, exit 2 — [page](rules/cycle/record.md)                                                                                            |
+| [`cycle/evidence`](rules/cycle/evidence.md)                           | error                                                    | `paperlint.json` (`cycles`) → the paper folder                                    | a closed cycle (`accepted`, `rejected`, `withdrawn`) or a deadline's `override` names an `evidence` file — the decision mail, the reviews, the withdrawal note, the chairs' mail — that is not in the paper folder; reported on `PIPELINE-STATUS.md` — [page](rules/cycle/evidence.md)                                                                                                                                                                                                                                                                 |
+| [`cycle/stage`](rules/cycle/stage.md)                                 | error                                                    | `PIPELINE-STATUS.md` → `paperlint.json` (`cycles`)                                | with `cycles` declared, a stage names no `cycle: <id>`, names one no cycle has, or a `submitted`/`camera-ready` stage belongs to a cycle whose `phase` is still `porting` — [page](rules/cycle/stage.md)                                                                                                                                                                                                                                                                                                                                               |
+| [`cycle/port-done`](rules/cycle/port-done.md)                         | error                                                    | `paper.tex` → `paperlint.json` (`cycles`) → the preset's `template`               | the current cycle still declares `"phase": "porting"` (which silences the venue's format rules) while the `\documentclass` is already the venue's template: the port is done, drop the phase — [page](rules/cycle/port-done.md)                                                                                                                                                                                                                                                                                                                        |
+| [`paper/folder-venue-leftover`](rules/paper/folder-venue-leftover.md) | warn                                                     | the folder name → `paperlint.json`                                                | the paper's folder is named after another shipped venue than the one it extends (`papers/aisec-2026/` for a paper now set for AIDC); reported on `PIPELINE-STATUS.md` — [page](rules/paper/folder-venue-leftover.md)                                                                                                                                                                                                                                                                                                                                   |
+| [`paper/allowed-files-only`](rules/paper/allowed-files-only.md)       | error                                                    | the paper folder's root listing → `paperlint.json`                                | a file or folder at the paper's root is not part of the layout (`PLAN.md`, `archive/`, a stray PDF); reported on `PIPELINE-STATUS.md`, once per entry, with where it goes; `extra/` takes anything — [page](rules/paper/allowed-files-only.md)                                                                                                                                                                                                                                                                                                         |
+| [`repro/allowed-files-only`](rules/repro/allowed-files-only.md)       | error                                                    | the listing of the paper's `repro/`                                               | an entry at the top of `repro/` is not `README.md`, `.gitignore`, `tools/`, `data/` or a study folder named `<slug>-YYYY-MM-DD` (or `<slug>-YYYY-MM`), or a study folder has no `README.md`; reported on `PIPELINE-STATUS.md`, once per entry, with where it goes by kind (a script → `repro/tools/`, data → `repro/data/`, a note → its study or `research/`) — [page](rules/repro/allowed-files-only.md)                                                                                                                                             |
+| [`paper/sources-fresh`](rules/paper/sources-fresh.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`                                               | the paper has not been built (no record of the files TeX read), or a file changed since the last build (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                               |
+| `paper/author-list`                                                   | error                                                    | `paper.tex` → `_build/references.json`, `_build/sources.json`                     | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line (or at the top of `paper.tex`, naming the entry's file); silent without a current build record                                                                                                                                                                                                                                                    |
+| `paper/section-word`                                                  | warn                                                     | `paper.tex` and its body files                                                    | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `paper/leading-zero`                                                  | warn                                                     | `paper.tex` and its body files                                                    | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable**                                                                                          |
+| `paper/figure-ref-style`                                              | warn                                                     | `paper.tex` and its body files                                                    | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                                                                                                               |
+| [`bib/reachable-entry`](rules/bib/reachable-entry.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`: the databases the last build's bibtex opened | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry in the `filecontents` block of `paper.tex` that wrote its `.bib`, or at the top of `paper.tex` with the entry's file and line first; silent until a build records the paper; no fix, the link has to be looked up — [page](rules/bib/reachable-entry.md)                                                                                                                                                                                                  |
+| `paper/cite-exists`                                                   | error                                                    | `paper.tex` → `_build/references.json`                                            | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/refs-fresh`                                                    | error                                                    | `paper.tex` → `_build/references.json`                                            | the databases bibtex opened changed since the build checked them (their SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `paper/refs-checked`                                                  | warn                                                     | `paper.tex` → `_build/references.json`                                            | a build recorded the paper's databases and none has checked their references, or the last build could not (no network), or its bibtex typeset a key paperlint's reader did not read (an entry behind `%`, inside `@comment{…}`), or bibtex found a database outside the paper directory (`BIBINPUTS`) — so the two rules above did not run on it. Silent without a record of the build (`paper/sources-fresh` speaks)                                                                                                                                  |
+| `tex/future-promise`                                                  | warn                                                     | `paper.tex` and its body files                                                    | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `tex/acm-frontmatter-override`                                        | error                                                    | `paper.tex`                                                                       | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| [`tex/template`](rules/tex/template.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                    | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| [`tex/required-section`](rules/tex/required-section.md)               | error                                                    | `paper.tex` → `paperlint.json`                                                    | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                                                                                                           |
+| [`tex/heading-case`](rules/tex/heading-case.md)                       | optional; the AgenticDev preset sets `error`             | `paper.tex` and the files it includes                                             | a word in the paper's `\title` or in a `\section`, `\subsection`, `\subsubsection`, `\paragraph` or `\subparagraph` title is not in the style its scope asks: `{ "title", "headings", "levels"? }`, each `chicago-headline` (Conference Publishing's quote of the Chicago Manual of Style), `sentence` (first word only) or `any`. Words that are a preposition in one title and a particle in another (`up`, `on`, `in`) are not read mid-title. **Fixable:** `--fix` — [page](rules/tex/heading-case.md)                                             |
+| [`format/layout-override`](rules/format/layout-override.md)           | error                                                    | `paper.tex` → `paperlint.json`                                                    | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                                                                                                                   |
+| [`anonymity/identity`](rules/anonymity/identity.md)                   | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                                                                                                                      |
+| [`tex/venue-leftover`](rules/tex/venue-leftover.md)                   | warn                                                     | `paper.tex` → `paperlint.json`                                                    | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                                                                                                                  |
+| [`tex/claim-provenance`](rules/tex/claim-provenance.md)               | warn                                                     | `paper.tex`                                                                       | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                                                                                                             |
+| [`tex/register`](rules/tex/register.md)                               | warn                                                     | `paper.tex` and the files it includes                                             | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                                                                                                                 |
+| [`tex/contrast-frames`](rules/tex/contrast-frames.md)                 | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | contrast frames (_X, not Y_, _not X but Y_, _rather than_, _instead of_, _as opposed to_) per 10,000 words fall outside the band the venue preset's anchors set (AIDC: 0–10.4, from five accepted ACSAC papers); above it, each frame is reported too — [page](rules/tex/contrast-frames.md)                                                                                                                                                                                                                                                           |
+| [`tex/claim-emphasis`](rules/tex/claim-emphasis.md)                   | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | claims set in bold inside a sentence (six words or more, or holding a number; not a term, not a label opening a paragraph) per 10,000 words fall outside the preset's band (AIDC: 0–17.8); above it, each is reported too — [page](rules/tex/claim-emphasis.md)                                                                                                                                                                                                                                                                                        |
+| [`tex/relation-markers`](rules/tex/relation-markers.md)               | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | words that name how a sentence relates to the one before (_because_, _therefore_, _however_, _for example_ …) per 10,000 words fall outside the preset's band (AIDC: 25.4–135.0) — the floor that catches relations left to infer — [page](rules/tex/relation-markers.md)                                                                                                                                                                                                                                                                              |
+| `review/frontmatter`                                                  | error                                                    | `reviews/*.md`                                                                    | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                                                                                                         |
+| `sibling/frontmatter`                                                 | warn                                                     | `siblings/*.md` (not `README.md`)                                                 | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `pdf/fresh`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                                                                                                             |
+| `pdf/profile`                                                         | error                                                    | `paper.tex` → `paperlint.json`                                                    | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                                                                                                                |
+| `pdf/fonts`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                                                                                                                     |
+| `pdf/geometry`                                                        | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| [`format/page-limit`](rules/format/page-limit.md)                     | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; with `appendix_in_body` too (MSR) the appendix is body wherever it sits and the reference pages are the ones holding only references; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md) |
+| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                                                                     |
+| `pdf/measured`                                                        | warn                                                     | `paper.tex` → `_build/paper.facts.json`                                           | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                                                                         |
+| [`talk/profile`](rules/talk/profile.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                    | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                                                               |
+| [`talk/required-files`](rules/talk/required-files.md)                 | error                                                    | `paper.tex` → `paperlint.json`, the talk folder                                   | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                                                                     |
+| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                                     | `paper.tex` → the paper's `talk/` folder                                          | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| [`talk/duration`](rules/talk/duration.md)                             | error                                                    | `paper.tex` → the talk video                                                      | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                                                                        |
+| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                                     | `paper.tex` → the talk video                                                      | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [`talk/video-format`](rules/talk/video-format.md)                     | error                                                    | `paper.tex` → the talk video                                                      | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                                                              |
+| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                                    | `paper.tex` → the one-slide PNG                                                   | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                                     | `paper.tex` → the captions and the video                                          | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
 
 **Body files** are the files of the paper's directory that TeX read after `\begin{document}` in the
 last build, as `paperlint build` recorded them in `_build/sources.json` — not a preamble file, not a
@@ -72,8 +75,8 @@ The `talk/*` rules judge a talk's finished files and are silent for a paper that
 `talk` (but `talk/undeclared`): [`talk.md`](talk.md).
 
 Optional rules — off unless you turn them on in the `rules` setting, because only some venues need
-them — are on their own page: [`optional-rules.md`](optional-rules.md). Today there are two,
-`pdf/last-page-balance` and `tex/heading-case`.
+them — are on their own page: [`optional-rules.md`](optional-rules.md). Today there are three,
+`pdf/last-page-balance`, `tex/heading-case` and the experimental `study/declare-sample`.
 
 ## A deliberate exception: a disable directive, with the reason
 

package/docs/skills.md

@@ -8,6 +8,8 @@ the skill whose description matches starts. `paperlint init` installs them into
 `.claude/skills/` ([`install.md`](install.md)). Each one's full instructions are its
 `skills/<name>/SKILL.md`.
 
+Where each stage writes, and the check that guards each place: [`layout.md`](layout.md).
+
 `test/skills-catalog.test.ts` fails when this list and the shipped `skills/` directory disagree.
 
 ## Across every stage
@@ -36,9 +38,10 @@ the skill whose description matches starts. `paperlint init` installs them into
 
 ## 3 · Study
 
-| you get                                                                                    | skill             |
-| ------------------------------------------------------------------------------------------ | ----------------- |
-| a study design with honest statistics, and a reproduction artifact that checks its numbers | `build-benchmark` |
+| you get                                                                                    | skill              |
+| ------------------------------------------------------------------------------------------ | ------------------ |
+| a study design with honest statistics, and a reproduction artifact that checks its numbers | `build-benchmark`  |
+| a page you label items on from a phone, and the answers exported into the study folder     | `build-label-page` |
 
 ## 4 · Draft
 

package/docs/venues.md

@@ -0,0 +1,94 @@
+# Venues: three places, three jobs
+
+paperlint keeps three kinds of venue knowledge, each in its own place:
+
+| place                                                                      | holds                                                                                                                                | written by                                                           | read by                                                                        |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| `presets/<venue>.jsonc` and `presets/<venue>.md`, in the paperlint package | a shipped **venue preset** (page limits, format, deadlines) and its **card** (the call's requirements in prose, the portal's quirks) | paperlint's maintainers; deadlines are re-read from the portal daily | `paperlint lint` (the preset), `submit-paper` (the card)                       |
+| `venues/<name>.jsonc` and `venues/<name>.md`, at your project's root       | your own preset and card, for a venue paperlint does not ship                                                                        | you, when `find-venue` picks such a venue (stage 2)                  | `paperlint lint`, through the paper's `"extends"`; `submit-paper`              |
+| `<papers-root>/venues/<venue>/`                                            | the venue's **corpus**: its accepted papers, measured and read                                                                       | `study-accepted-papers` (stage 2, and again at stage 5)              | `study-accepted-papers`, for this paper and every later one aimed at the venue |
+
+A preset and a card say what a venue **requires**: a paper that breaks them is sent back. A corpus
+says what a venue **rewards**: what its strongest accepted papers do that its ordinary ones do not.
+
+The two `venues/` folders are different places. With the default papers directory they are
+`venues/` (your presets) and `papers/venues/` (the corpora).
+
+## The corpus of accepted papers
+
+`<papers-root>` is the papers directory: `papersDir` in the project's `paperlint.json`, default
+`papers/`. The corpus lives there, beside the paper folders and not inside any of them, because it
+belongs to the venue: every paper aimed at that venue reads the same one.
+
+```text
+<papers-root>/
+├── venues/
+│   └── <venue>/            ← one venue's corpus, shared by every paper aimed at it
+└── <paper>/                ← a paper folder; it holds no corpus of its own
+```
+
+### When it is made
+
+The skill `study-accepted-papers` makes it, the first time it runs for that venue. It always asks
+which mode to run, and suggests one from what exists:
+
+| mode     | when                                           | stage    | what it adds to the corpus                                  |
+| -------- | ---------------------------------------------- | -------- | ----------------------------------------------------------- |
+| A idea   | a target venue and an idea; no `paper.tex` yet | 2 venue  | the winner and ordinary lists, their measurements (L0, L1)  |
+| B design | a planned claim and measurements; no text yet  | 2 venue  | the same, if not there yet                                  |
+| C draft  | the paper's text exists                        | 5 review | the deep reads (L2), one file per paper                     |
+| D final  | near-final text, the deadline close            | 5 review | nothing new; it compares wording against the closest papers |
+
+So the corpus usually appears at stage 2, right after `find-venue` and before the study is
+designed, when what the venue rewards can still shape the study. A paper that first runs the skill
+at stage 5 gets its corpus then. Each later run, by any paper, reuses what is there and adds only
+what is missing.
+
+### What is inside
+
+```text
+<papers-root>/venues/<venue>/
+├── MANIFEST.md        ← the sources, the years, what was capped, the stand-in for "strong accept" and how often it occurs
+├── the winner and ordinary lists
+├── measurements.json  ← the codes of L0 and L1, one row per paper
+├── text/              ← the text extracted from each paper
+├── deep-reads/        ← one file per paper read in full (L2), usable by any paper
+├── the scripts that fetched and measured
+└── a labelled subfolder for corpus 2: award papers on the topic at other venues
+```
+
+Only `MANIFEST.md`, `measurements.json`, `text/` and `deep-reads/` have fixed names; the lists, the
+scripts and the corpus-2 folder are named by whoever runs the skill. The PDFs are not committed: the
+manifest records each paper's identifier and the command that fetches it.
+
+A mechanism the venue adds to the generic ten (M1–M10, kept beside the skill), or one that does not
+hold there, is written in `MANIFEST.md`.
+
+### Who reads it
+
+- **The paper's strong-accept scorecard.** In mode C, `study-accepted-papers` scores the draft
+  against the corpus and writes the result in the section `## Strong-accept scorecard (M1–M10)` of the
+  paper's `PIPELINE-STATUS.md`, the only place the verdicts live. Its dated report goes in the
+  paper's `reviews/` and names the corpus in its frontmatter (`corpus:`).
+- **Every later paper aimed at the same venue**, and the same paper when it is resubmitted there:
+  the corpus is collected once and reused.
+
+### What checks it
+
+**No rule reads the corpus yet.** `paperlint lint` treats a folder in the papers directory as a paper
+only when it holds `PIPELINE-STATUS.md`, `paper.tex` or `paperlint.json`, and `venues/` holds none of
+them, so nothing in it is linted. The hook that refuses misplaced files does not act there either:
+it acts only inside a paper folder.
+
+What is checked is the other side: a corpus started **inside** a paper folder. A `venues/` or
+`venue-corpus/` folder at a paper's root is reported, with this place as where it goes
+([the paper folder's layout](rules/paper/allowed-files-only.md)), and the hook refuses to create one.
+
+## Where the venue's other facts go
+
+A format fact found while studying the corpus (a page limit, a template, a required section) is
+something the venue **requires**: it goes in the preset and the card, with the quote it comes from,
+not in the corpus. [`rules.md`](rules.md#writing-your-own-venue-preset) shows how to write a preset of
+your own.
+
+See also: [the map of every place, and what checks it](layout.md).

package/eslint-rules/CLAUDE.md

@@ -0,0 +1,44 @@
+<!-- vigiles:sha256:5231f736e3b1a263 compiled from eslint-rules/CLAUDE.md.spec.ts -->
+
+# CLAUDE.md
+
+## `eslint-rules/`
+
+The rules this package ships. Loaded when working under `eslint-rules/`; the rules for every change
+are in the root `CLAUDE.md`. Each requirement below names what holds it; the reasoning lives in
+that file's header.
+
+## What a new rule ships with, and what holds it
+
+| requirement | held by |
+| --- | --- |
+| **Both halves** (root `CLAUDE.md`), for every registered rule | `src/rule-cases.test.ts` fails on a registered rule with no cases |
+| **One rule, one requirement**: two checks with different reasons to switch them off are two rules | review |
+| **A venue requirement is validated on real accepted papers** of that venue, built to PDF, with the ground truth established independently | review; the papers are in `fixtures/accepted-papers/README.md` |
+| **Its page**, `docs/rules/<group>/<rule>.md`, and `meta.docs.url` pointing at it | `src/rule-docs.test.ts`; its `AWAITING_PAGE` list only shrinks |
+| **Loud on an empty input set**: a rule that matched no files must not report like one that passed | `scripts/rules-see-files.mjs`, per rule and not per glob, in `npm run check` |
+
+The page's sections: What it catches · Why · Examples (failing / passing) · Options / preset fields ·
+What it does not check · How to fix. Its row in `docs/rules.md` is one line linking there.
+
+## A rule that judges prose
+
+A rule, or a skill criterion, that judges a paper's prose is held to five principles. Without them
+the checks push every paper toward a blog post.
+
+1. **Two-sided**: a floor as well as a ceiling, or the distance to accepted papers of the target
+   venue. A set of ceilings alone converges on clipped, unsignposted prose.
+2. **Rules count, skills judge.** Countable on the parse tree → a lint rule; needs reading (register,
+   genre, whether a claim changed strength) → a skill criterion.
+3. **The model reader is the venue's reviewer**, including one who skims the abstract, the
+   introduction and the conclusion.
+4. **Thresholds are calibrated, not borrowed**: set with the same counter on the accepted papers,
+   never taken from a figure measured by a different counter.
+5. **A rewrite is accepted on what reviewers see**: the combined count of every surface form of a
+   tic, plus a check that no claim was softened or strengthened.
+
+## Rules
+
+### Lint Rule Over Script
+
+**Guidance only** — A check over a syntax tree is a lint rule, not a script. It fires in the editor on save, gets the AST for free, and has a suppression syntax people already know. A script is for corpus-wide questions — index connectivity, ratios across many files. When the work has to run a program, a script may do the work and write facts to a JSON file, and a rule judges that file: the verdict still lands in the engine.

package/eslint-rules/CLAUDE.md.spec.ts

@@ -0,0 +1,43 @@
+// Compiled to eslint-rules/CLAUDE.md by `npx vigiles compile`. Edit THIS file, never the markdown.
+//
+// The requirements below are held by tests and scripts, not by an ESLint rule `enforce()` could
+// name, so they are prose with verified file references rather than `enforce()` rules.
+import { file, guidance, instructionFile, prose } from "vigiles/spec";
+
+export default instructionFile({
+  sections: {
+    "`eslint-rules/`": prose`The rules this package ships. Loaded when working under \`eslint-rules/\`; the rules for every change
+are in the root \`CLAUDE.md\`. Each requirement below names what holds it; the reasoning lives in
+that file's header.`,
+
+    "What a new rule ships with, and what holds it": prose`| requirement | held by |
+| --- | --- |
+| **Both halves** (root \`CLAUDE.md\`), for every registered rule | ${file("src/rule-cases.test.ts")} fails on a registered rule with no cases |
+| **One rule, one requirement**: two checks with different reasons to switch them off are two rules | review |
+| **A venue requirement is validated on real accepted papers** of that venue, built to PDF, with the ground truth established independently | review; the papers are in ${file("fixtures/accepted-papers/README.md")} |
+| **Its page**, \`docs/rules/<group>/<rule>.md\`, and \`meta.docs.url\` pointing at it | ${file("src/rule-docs.test.ts")}; its \`AWAITING_PAGE\` list only shrinks |
+| **Loud on an empty input set**: a rule that matched no files must not report like one that passed | ${file("scripts/rules-see-files.mjs")}, per rule and not per glob, in \`npm run check\` |
+
+The page's sections: What it catches · Why · Examples (failing / passing) · Options / preset fields ·
+What it does not check · How to fix. Its row in ${file("docs/rules.md")} is one line linking there.`,
+
+    "A rule that judges prose": prose`A rule, or a skill criterion, that judges a paper's prose is held to five principles. Without them
+the checks push every paper toward a blog post.
+
+1. **Two-sided**: a floor as well as a ceiling, or the distance to accepted papers of the target
+   venue. A set of ceilings alone converges on clipped, unsignposted prose.
+2. **Rules count, skills judge.** Countable on the parse tree → a lint rule; needs reading (register,
+   genre, whether a claim changed strength) → a skill criterion.
+3. **The model reader is the venue's reviewer**, including one who skims the abstract, the
+   introduction and the conclusion.
+4. **Thresholds are calibrated, not borrowed**: set with the same counter on the accepted papers,
+   never taken from a figure measured by a different counter.
+5. **A rewrite is accepted on what reviewers see**: the combined count of every surface form of a
+   tic, plus a check that no claim was softened or strengthened.`,
+  },
+  rules: {
+    "lint-rule-over-script": guidance(
+      "A check over a syntax tree is a lint rule, not a script. It fires in the editor on save, gets the AST for free, and has a suppression syntax people already know. A script is for corpus-wide questions — index connectivity, ratios across many files. When the work has to run a program, a script may do the work and write facts to a JSON file, and a rule judges that file: the verdict still lands in the engine.",
+    ),
+  },
+});

package/eslint-rules/install-path-literals.harness.mjs

@@ -19,7 +19,7 @@ import markdown from "@eslint/markdown";
 import { recordCheck } from "vigiles";
 import port, { PORT } from "./install-path-literals.ts";
 
-// Resolved from THIS file, never from the caller's cwd — rule 6, and the mistake this very
+// Resolved from THIS file, never from the caller's cwd (root CLAUDE.md), and the mistake this very
 // class of bug is about.
 const HERE = dirname(fileURLToPath(import.meta.url));
 const ROOT = join(HERE, "..");

package/eslint-rules/install-path-literals.ts

@@ -1,5 +1,5 @@
 /**
- * Rule 10's mechanical half: nothing outside the port may name a file by WHERE IT IS
+ * The install-location rule's mechanical half (root CLAUDE.md): nothing outside the port may name a file by WHERE IT IS
  * INSTALLED.
  *
  * The class this exists for has broken this repository five times, silently every time, and
@@ -47,7 +47,7 @@ const PORT = "skills/paper-pipeline/scripts/consumer.mjs";
 const MESSAGES: Readonly<Record<string, string>> = {
   installPath:
     "This names a file by where it is INSTALLED ('{{prefix}}'), so it resolves in one " +
-    "delivery channel and does not exist in another. Rule 10: every answer to *where* comes " +
+    "delivery channel and does not exist in another. Every answer to *where* comes " +
     `from the port, ${PORT}. In a skill, use the substitution the harness performs ` +
     "(CLAUDE_SKILL_DIR / CLAUDE_PLUGIN_ROOT); in a module, ask the port.",
 };
@@ -58,7 +58,7 @@ const mdInstallPath = {
     type: "problem" as const,
     docs: {
       description:
-        "a skill must not name its scripts by an install-specific path — rule 10, the port owns where",
+        "a skill must not name its scripts by an install-specific path — the port owns where",
     },
     schema: [],
     messages: MESSAGES,
@@ -81,7 +81,7 @@ const jsInstallPath = {
     type: "problem" as const,
     docs: {
       description:
-        "a shipped module must not carry an install-specific path literal — rule 10, the port owns where",
+        "a shipped module must not carry an install-specific path literal — the port owns where",
     },
     schema: [],
     messages: MESSAGES,

package/eslint-rules/pdf-last-page-balance.ts

@@ -11,7 +11,7 @@
  *   { "rules": { "pdf/last-page-balance": ["error", { "tolerancePt": 120 }] } }
  *
  * (That is a line comment's worth of JSON in a block comment only because it has no asterisk
- * followed by a slash; see rule 8 of CLAUDE.md before editing it.)
+ * followed by a slash; see the block-comment rule in the root CLAUDE.md before editing it.)
  *
  * ── WHAT IT READS: THE FACTS THE BUILD WROTE, NOT THE PDF ───────────────────────
  * `paperlint build` measures the PDF with pdf.js and writes `<paper>/_build/paper.facts.json`. This rule