paperlint 4.2.0 → 6.0.0

package/docs/rules.md

@@ -3,36 +3,43 @@
 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)                                                                                                                                                                                                                                                                                                                                                |
-| `paper/author-list`                                     | error | `paper.tex` → `_build/references.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                                                                                                                                                                                                                                                          |
-| `paper/research-question`                               | warn  | `paper.tex`, `paper.md`, `PIPELINE-STATUS.md` | a stage is declared and either the scorecard has no `researchQuestion` field, or it has one the paper does not contain. The declared sentence is compared against the source with whitespace collapsed — your words, not a pattern. Advisory, because nothing here can judge whether what you declared _is_ a research question                                                                                                                               |
-| `paper/section-word`                                    | warn  | `paper.tex`, `paper.md`                       | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                      |
-| `paper/leading-zero`                                    | warn  | `paper.tex`, `paper.md`                       | 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`                                   | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                      |
-| `bib/reachable-entry`                                   | warn  | `paper.tex` (its `filecontents` bibliography) | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry; no fix, the link has to be looked up                                                                                                                                                                                                                                                                                                                            |
-| `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 bibliography changed since the build checked it (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/refs-checked`                                    | warn  | `paper.tex` → `_build/references.json`        | the paper has a bibliography and no build has checked it, or the last build could not (no network) — so the two rules above did not run                                                                                                                                                                                                                                                                                                                       |
-| `tex/future-promise`                                    | warn  | `paper.tex`                                   | 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/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/missing-input`](rules/tex/missing-input.md)       | warn  | `paper.tex` and the files it includes         | an `\input`, `\include` or `\subfile` names a file that is not there, so no rule read its text — [page](rules/tex/missing-input.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)                                                                                                                                                                                                                                                                        |
-| `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 2, 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                                                                                                                                                                                                                                                                                                                                                |
-| `pdf/limits`                                            | error | `paper.tex` → `_build/paper.facts.json`       | body or reference pages exceed the limit of the paper's kind, or the reference font size is outside the preset's range widened by `body_pt_tol`                                                                                                                                                                                                                                                                                                               |
-| `pdf/body-size`                                         | warn  | `paper.tex` → `_build/paper.facts.json`       | the body font size is more than `body_pt_tol` off the preset's. A warning: banal measures the mode of the rendered text, not the declared size (9.30 pt measured at a declared 9)                                                                                                                                                                                                                                                                             |
-| `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                                                                                                                                                                                                                                                |
+| 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)                                                                                                                                                                                                                                                                                                                                                |
+| `paper/author-list`                                         | error | `paper.tex` → `_build/references.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                                                                                                                                                                                                                                                          |
+| `paper/section-word`                                        | warn  | `paper.tex` and its body files, `paper.md`    | `§` 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, `paper.md`    | 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`                                       | warn  | `paper.tex` (its `filecontents` bibliography) | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry; no fix, the link has to be looked up                                                                                                                                                                                                                                                                                                                            |
+| `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 bibliography changed since the build checked it (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/refs-checked`                                        | warn  | `paper.tex` → `_build/references.json`        | the paper has a bibliography and no build has checked it, or the last build could not (no network) — so the two rules above did not run                                                                                                                                                                                                                                                                                                                       |
+| `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)                                                                                                                                                                                                                                                                                                                  |
+| [`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)                                                                                                                                                                                                                                                                        |
+| `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; 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                                                                                                                                                                                                                                                |
+
+**Body files** are the files `paper.tex` includes from its document body (`\input`, `\include`,
+`\subfile`, nested ones too), found in the paper's directory — not a preamble include, not a file
+found only in paperlint's own inputs, and not any other `.tex` beside the paper (`versions/`). A
+finding in one is reported at that file and line, and `--fix` edits that file. Which reference form
+is the majority and whether the build is a review build are decided over the whole paper. An include
+that names no file is printed as a note: lint did not read it, and the build will stop on it.
 
 `tex/required-section` requires AIDC's «LLM Usage Statement» **always**. ACSAC asks for it «if
 LLMs are used», which no rule can know; an author who used none says so in the section
@@ -89,14 +96,14 @@ for papers, each with the quote it came from, the TeX packages its template need
 the venue implies. A preset may itself extend another: the ACM venues extend the `acm-sigconf`
 family, which holds everything the ACM template decides.
 
-| preset                      | extends                     | template                              | kinds                                                    | page limit checked | rules it turns on       |
-| --------------------------- | --------------------------- | ------------------------------------- | -------------------------------------------------------- | ------------------ | ----------------------- |
-| `paperlint:acm-sigconf`     | —                           | ACM `acmart` sigconf                  | none                                                     | no (no kinds)      | —                       |
-| `paperlint:agenticdev`      | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `short` (5 + 2 refs), `full` (10 + 2), `demo` (5 + 2)    | yes                | `pdf/last-page-balance` |
-| `paperlint:aisec`           | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `research`, `benchmark`, `position`, `sok` (10 + 2 each) | yes                | —                       |
-| `paperlint:realm`           | —                           | ACL                                   | `long`, `short`                                          | no — see below     | —                       |
-| `paperlint:ieee-conference` | —                           | IEEE `IEEEtran` conference            | none                                                     | no (no kinds)      | —                       |
-| `paperlint:aidc`            | `paperlint:ieee-conference` | IEEE `IEEEtran` conference, `compsoc` | `regular` (12), `short` (6)                              | no — see below     | —                       |
+| preset                      | extends                     | template                              | kinds                                                    | page limit checked                     | rules it turns on       |
+| --------------------------- | --------------------------- | ------------------------------------- | -------------------------------------------------------- | -------------------------------------- | ----------------------- |
+| `paperlint:acm-sigconf`     | —                           | ACM `acmart` sigconf                  | none                                                     | no (no kinds)                          | —                       |
+| `paperlint:agenticdev`      | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `short` (5 + 2 refs), `full` (10 + 2), `demo` (5 + 2)    | yes                                    | `pdf/last-page-balance` |
+| `paperlint:aisec`           | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `research`, `benchmark`, `position`, `sok` (10 + 2 each) | yes                                    | —                       |
+| `paperlint:realm`           | —                           | ACL                                   | `long`, `short`                                          | no — see below                         | —                       |
+| `paperlint:ieee-conference` | —                           | IEEE `IEEEtran` conference            | none                                                     | no (no kinds)                          | —                       |
+| `paperlint:aidc`            | `paperlint:ieee-conference` | IEEE `IEEEtran` conference, `compsoc` | `regular` (12), `short` (6)                              | yes, before the references — see below | — (`blind`)             |
 
 That is all that ships today. There is no NeurIPS, USENIX or Springer preset. A paper for an ACM or
 IEEE conference venue nobody has profiled can extend `paperlint:acm-sigconf` or
@@ -104,9 +111,11 @@ IEEE conference venue nobody has profiled can extend `paperlint:acm-sigconf` or
 says the page limit is not. For anything else, write your own preset
 ([below](#writing-your-own-venue-preset)). REALM's preset sets no page limit on purpose: banal
 counts the Limitations and Ethics sections as body, ACL does not, and a limit on banal's number
-would fail a correct paper. AIDC's sets none for the same reason, measured: banal counts a page as
-body when an appendix or the LLM Usage Statement sits on it before the bibliography, and AIDC counts
-neither, so a correct 12-page paper measured 13. AgenticDev's turns on `pdf/last-page-balance`
+would fail a correct paper. AIDC's limit is checked by another count, for the same reason: banal counts
+a page as body when an appendix or the LLM Usage Statement sits on it, and AIDC counts neither, so a
+correct 12-page paper measured 13. Its preset sets `"body_ends_at": "references"`: the body is the
+pages before the one where the references heading first appears. It is also `"blind": true`, which
+turns on [`anonymity/identity`](rules/anonymity/identity.md). AgenticDev's turns on `pdf/last-page-balance`
 because its proceedings are produced by Conference Publishing Consulting, which sends back an
 unbalanced last page; AISec's does not, because nothing in hand says who produces the AISec
 proceedings.
@@ -199,6 +208,7 @@ The numbers and packages above illustrate the shape; take yours from the venue's
 | `name`              | how messages name the venue; the file name otherwise                                                                                                                                                                    |
 | `template`          | the `\documentclass` the venue's template uses — a whole line (`\documentclass[conference,compsoc]{IEEEtran}`) or a bare class name; `tex/template` requires the paper's class and every option named here              |
 | `aliases`           | other names the venue goes by in a paper's text — its acronym, its parent conference: `["AISec", "ACM CCS"]`. Collected along `extends`, with `name`. Read by `tex/venue-leftover`                                      |
+| `blind`             | the venue reviews double-blind — set only where its call says so, with the quote. Turns on `anonymity/identity`; a child's value replaces its parent's                                                                  |
 | `required_sections` | sections the venue requires, `[{ "title": "LLM Usage Statement", "position": "last" }]`: the exact title, and `last` when it must close the paper. Read by `tex/required-section`; a child's list replaces its parent's |
 | `format`            | page size, columns, fonts, font sizes, and `kinds` (page limits per kind of paper)                                                                                                                                      |
 | `tex`               | TeX Live packages, each with the files that prove it is installed. Required unless `extends` is set                                                                                                                     |
@@ -214,10 +224,10 @@ Presets from npm packages are not supported yet.
 
 ## The paper is LaTeX
 
-The paper body is `paper.tex`, and it gets four rules of its own: `paper/research-question`,
-`paper/typography`, `tex/future-promise` and `tex/acm-frontmatter-override` — plus the `pdf/`
-venue rules above, which run on it but judge the files beside it. The scorecard and
-the review notes are Markdown files, and the other five rules read those.
+The paper body is `paper.tex`, and it gets three rules of its own: `paper/typography`,
+`tex/future-promise` and `tex/acm-frontmatter-override` — plus the `pdf/` venue rules above, which
+run on it but judge the files beside it. The scorecard and the review notes are Markdown files, and
+the other five rules read those.
 
 A Markdown body (`paper.md`, or `draft.md`) is still read today and gets only the two `paper/`
 rules, which is why they list it above. Markdown papers are deprecated and being removed
@@ -241,7 +251,6 @@ stages:
     bytes: 305412
     source: versions/2026-07-22-submitted.tex
     sourceBytes: 57210
-researchQuestion: "Does pruning the state space reduce review cost?"
 ---
 ```
 

package/eslint-rules/latex-language.ts

@@ -51,9 +51,12 @@
  *     paper. The projection counts differently: the same place gave 1239 words before macro
  *     blanking and 1208 after — a 2.5% discrepancy. The discrepancy is ACCEPTED deliberately;
  *     the thresholds were not recalibrated.
- *  4. A MULTI-FILE PAPER IS INVISIBLE. `\input` / `\include` are in OPAQUE — their contents
- *     are not read. The first `\input{sections/method}` yields a silent zero over all the
- *     prose it pulls in.
+ *  4. ONE FILE AT A TIME. `\input` / `\include` are in OPAQUE: the projection of `paper.tex`
+ *     does not hold what they pull in. `paperlint lint` hands ESLint each file the paper includes
+ *     from its body as a file of its own (src/paper-includes.ts), and a file with no `document`
+ *     environment is projected as body throughout — so an included file is read where it is,
+ *     and its findings point into it. An ESLint run outside `paperlint lint` reads only the
+ *     files it was given.
  *  5. `\appendix` IS NOT IMPLEMENTED and is INEXPRESSIBLE in a length-preserving projection:
  *     `\appendix` is 9 characters, `## Appendix` is 11, the synthesis does not fit. On the
  *     first paper with a real `\appendix`, `appendix-ref` / `appendix-ratio` yield a silent
@@ -209,6 +212,9 @@ export type MdNode =
       readonly value: string;
     };
 
+/** The root of a projection: a node that has children. */
+export type MdRoot = Extract<MdNode, { readonly type: "root" | "strong" }>;
+
 /** An inline-config comment: an `html` node's text and where it sits. */
 interface ConfigNode {
   readonly value: string;
@@ -305,7 +311,7 @@ export function texToMdast(
   {
     parse = (s: string): TexRoot => getParser().parse(s),
   }: { parse?: (s: string) => TexRoot } = {},
-): { root: MdNode; text: string } {
+): { root: MdRoot; text: string } {
   const ast = parse(src);
   const chars = src.split("");
   const blank = (from: number, to: number) => {

package/eslint-rules/paper-context.test.ts

@@ -0,0 +1,47 @@
+/**
+ * The paper a linted file belongs to, as `paperlint lint` hands it in ESLint's settings, and the
+ * reading of the paper's other files.
+ */
+import { mkdtempSync, realpathSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import {
+  PAPERLINT_SETTINGS,
+  otherTexts,
+  paperOf,
+  textOnDisk,
+} from "./paper-context.ts";
+
+describe("paperOf", () => {
+  it("the paper under settings.paperlint.paper", () => {
+    const paper = { main: "/p/paper.tex", files: ["/p/paper.tex", "/p/a.tex"] };
+    expect(paperOf({ [PAPERLINT_SETTINGS]: { paper } })).toEqual(paper);
+  });
+
+  it("none when lint handed none, or handed something else", () => {
+    expect(paperOf({})).toBe(null);
+    expect(paperOf({ [PAPERLINT_SETTINGS]: { paper: { main: 1 } } })).toBe(
+      null,
+    );
+  });
+});
+
+describe("otherTexts", () => {
+  const dir = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-ctx-")));
+  writeFileSync(join(dir, "a.tex"), "A");
+  writeFileSync(join(dir, "b.tex"), "B");
+  const paper = {
+    main: join(dir, "a.tex"),
+    files: [join(dir, "a.tex"), join(dir, "b.tex"), join(dir, "gone.tex")],
+  };
+
+  it("every file of the paper but the linted one; a file that cannot be read holds no text", () => {
+    expect(otherTexts(paper, join(dir, "a.tex"))).toEqual(["B", ""]);
+    expect(textOnDisk(join(dir, "gone.tex"))).toBe("");
+  });
+
+  it("none without a paper", () => {
+    expect(otherTexts(null, join(dir, "a.tex"))).toEqual([]);
+  });
+});

package/eslint-rules/paper-context.ts

@@ -0,0 +1,57 @@
+/**
+ * THE PAPER A LINTED FILE BELONGS TO — handed to the rules by `paperlint lint` in ESLint's `settings`.
+ *
+ * ESLint lints one file at a time. A paper whose body is in `sections/*.tex` is several files, and
+ * two questions are about the paper, not the file: which reference form (`Fig.` or `Figure`) the
+ * paper uses most, and whether the build `paper.tex` declares is a review build. The CLI knows the
+ * files (it resolves the includes the way the build does, `bodyFiles` in src/tex-paper.ts) and puts
+ * them under `settings.paperlint.paper`
+ * for `paper.tex` and for every file it includes. A rule reads the other files from disk.
+ *
+ * No setting — a file linted outside `paperlint lint`, or a markdown paper — means a paper of one
+ * file: every rule decides on the file it was handed, as it did before.
+ */
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+
+/** The key under ESLint's `settings`; the paper is at `settings[PAPERLINT_SETTINGS].paper`. */
+export const PAPERLINT_SETTINGS = "paperlint";
+
+const PaperSetting = z.object({
+  /** The absolute path of the paper's `paper.tex`. */
+  main: z.string(),
+  /** Absolute paths: `paper.tex`, then every file of its body, each once. */
+  files: z.array(z.string()).readonly(),
+});
+
+/** The paper a file belongs to: its main file and all of its files. */
+export type PaperOfFile = Readonly<z.infer<typeof PaperSetting>>;
+
+const Settings = z.looseObject({ paper: PaperSetting });
+
+/** The paper the linted file belongs to, or null when lint handed none. */
+export function paperOf(
+  settings: Readonly<Record<string, unknown>>,
+): PaperOfFile | null {
+  const r = Settings.safeParse(settings[PAPERLINT_SETTINGS]);
+  return r.success ? r.data.paper : null;
+}
+
+/**
+ * The text of a file on disk; empty when it cannot be read — a file gone since `paperlint lint`
+ * named it holds no text for any rule.
+ */
+export function textOnDisk(path: string): string {
+  try {
+    return readFileSync(path, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+/** The texts of the paper's files other than `filename`, read from disk; none without a paper. */
+export const otherTexts = (
+  paper: PaperOfFile | null,
+  filename: string,
+): readonly string[] =>
+  (paper?.files ?? []).filter((f) => f !== filename).map(textOnDisk);

package/eslint-rules/paper-typography.ts

@@ -63,7 +63,13 @@ import assert from "node:assert/strict";
 import { getParser } from "@unified-latex/unified-latex-util-parse";
 import { takeWhile } from "remeda";
 import type { Nodes } from "mdast";
-import type { TexArg, TexNode, TexRoot } from "./latex-language.ts";
+import {
+  texToMdast,
+  type TexArg,
+  type TexNode,
+  type TexRoot,
+} from "./latex-language.ts";
+import { otherTexts, paperOf } from "./paper-context.ts";
 import type {
   RuleContext,
   RuleFixer,
@@ -102,16 +108,27 @@ export function bibRange(text: string): BibRange | null {
   return { start: m.index, end: m.index + whole.length, bodyStart, body };
 }
 
+/** A node of a file's projection, as far as its place goes: mdast's, or the `.tex` language's. */
+interface ProjectedNode {
+  readonly type: string;
+  readonly position?:
+    | {
+        readonly start: { readonly offset?: number | undefined };
+        readonly end: { readonly offset?: number | undefined };
+      }
+    | undefined;
+}
+
 /**
  * The ranges a markup rule must not read: LaTeX comments (the language gives them as `html`
  * nodes, with positions) and the inline bibliography.
  */
 function skippedRanges(
-  sourceCode: RuleSourceCode,
+  nodes: readonly ProjectedNode[],
   raw: string,
 ): [number, number][] {
   const out: [number, number][] = [];
-  for (const n of sourceCode.ast?.children ?? [])
+  for (const n of nodes)
     if (n.type === "html" && n.position) {
       // An offset-less point compares as NaN: inside no range, as `undefined` always did.
       const {
@@ -197,12 +214,22 @@ export function crefDefinitionRanges(
 const inside = (ranges: readonly [number, number][], i: number) =>
   ranges.some(([s, e]) => i >= s && i < e);
 
-/** Every match of `re` in `raw` outside the skipped ranges. */
-function markupMatches(sourceCode: TexSourceCode, re: RegExp) {
-  const raw = sourceCode.raw;
-  const skip = skippedRanges(sourceCode, raw);
+/** Every match of `re` in `raw` outside the ranges skipped in it (`nodes`: its projection's). */
+const markupMatchesIn = (
+  raw: string,
+  nodes: readonly ProjectedNode[],
+  re: RegExp,
+): readonly RegExpExecArray[] => {
+  const skip = skippedRanges(nodes, raw);
   return [...raw.matchAll(re)].filter((m) => !inside(skip, m.index));
-}
+};
+
+/** Every match of `re` in the linted file outside the skipped ranges. */
+const markupMatches = (
+  sourceCode: TexSourceCode,
+  re: RegExp,
+): readonly RegExpExecArray[] =>
+  markupMatchesIn(sourceCode.raw, sourceCode.ast?.children ?? [], re);
 
 const isTex = (sourceCode: RuleSourceCode): sourceCode is TexSourceCode =>
   typeof sourceCode.raw === "string";
@@ -510,25 +537,42 @@ function leadingZero(context: RuleContext) {
 
 const FIG_REF = /\b(Fig\.|Figure)(?=~?\\(?:ref|autoref)\b)/g;
 
+/** The reference forms another file of the paper writes, read the way the linted file is. */
+const figureFormsIn = (raw: string): readonly (string | undefined)[] =>
+  markupMatchesIn(raw, texToMdast(raw).root.children, FIG_REF).map(
+    ([, form]) => form,
+  );
+
+/**
+ * The minority form is rewritten to the majority one; on a tie, to the full word. The majority is
+ * the PAPER's: a body split into `sections/*.tex` is one document to its reader, so the other files
+ * `paperlint lint` names for this one (`paperOf`) are counted too, and only this file is reported.
+ */
 function figureRefStyle(context: RuleContext) {
   const sc = context.sourceCode;
   if (!isTex(sc)) return;
-  const all = markupMatches(sc, FIG_REF);
-  const short = all.filter((m) => m[1] === "Fig.");
-  const long = all.filter((m) => m[1] === "Figure");
-  if (!short.length || !long.length) return;
-  // The minority form is rewritten to the majority one; on a tie, to the full word.
-  const [minority, word] =
-    short.length > long.length ? [long, "Fig."] : [short, "Figure"];
-  for (const m of minority) {
-    const [, form = ""] = m;
-    const range: [number, number] = [m.index, m.index + form.length];
-    at(context, range[0], range[1], {
-      messageId: "mixed",
-      data: { form, word, n: String(all.length - minority.length) },
-      fix: (f) => f.replaceTextRange(range, word),
+  const own = markupMatches(sc, FIG_REF);
+  const forms: readonly (string | undefined)[] = [
+    ...own.map(([, form]) => form),
+    ...otherTexts(paperOf(context.settings), context.filename).flatMap(
+      figureFormsIn,
+    ),
+  ];
+  const short = forms.filter((f) => f === "Fig.").length;
+  const long = forms.filter((f) => f === "Figure").length;
+  if (short === 0 || long === 0) return;
+  const [minority, word, n] =
+    short > long ? ["Figure", "Fig.", short] : ["Fig.", "Figure", long];
+  own
+    .filter(([, form]) => form === minority)
+    .forEach((m) => {
+      const range = [m.index, m.index + minority.length] as const;
+      at(context, range[0], range[1], {
+        messageId: "mixed",
+        data: { form: minority, word, n: String(n) },
+        fix: (f) => f.replaceTextRange(range, word),
+      });
     });
-  }
 }
 
 const rule = (

package/eslint-rules/pdf-last-page-balance.harness.mjs

@@ -39,7 +39,12 @@ const TEX =
 const PDF = "%PDF-1.5 pretend";
 const sha = (s) => createHash("sha256").update(s).digest("hex");
 const facts = (lastPage, over = {}) => ({
-  schema: 2,
+  schema: 3,
+  pages_text: [],
+  metadata: {},
+  links: [],
+  bib_anchor_page: null,
+  appendix_anchor_page: null,
   pdf: "paper.pdf",
   pdf_sha256: sha(PDF),
   last_page: lastPage,

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

@@ -91,7 +91,7 @@ const RuleOptions = z
 /** The difference, in points, that two columns may end apart. See the harness for why 120. */
 export const DEFAULT_TOLERANCE_PT = 120;
 /** The schema of `paper.facts.json` this rule reads (`src/facts-file.ts`, FACTS_SCHEMA). */
-export const FACTS_SCHEMA = 2;
+export const FACTS_SCHEMA = 3;
 export const FACTS_REL = join("_build", "paper.facts.json");
 
 /** The `last_page` field, parsed. */
@@ -249,7 +249,7 @@ const rule = {
       factsBroken:
         "{{why}} in _build/paper.facts.json — rebuild the paper (`paperlint build`) to rewrite it",
       schema:
-        "_build/paper.facts.json has schema {{got}}; this rule reads schema 2 — rebuild the paper " +
+        "_build/paper.facts.json has schema {{got}}; this rule reads schema 3 — rebuild the paper " +
         "(`paperlint build`) to rewrite it",
       pdfMissing:
         "_build/paper.facts.json describes {{pdf}}, which is not on disk (a failed build removes " +

package/eslint-rules/tex-build.ts

@@ -51,6 +51,7 @@
  */
 import { readFileSync } from "node:fs";
 import type { RuleContext } from "./rule-context.ts";
+import { paperOf, textOnDisk } from "./paper-context.ts";
 
 /**
  * A copy rather than an import, for the same reason the prose lexicons are copies: a rule may
@@ -169,7 +170,13 @@ const futurePromise = {
         } catch {
           return;
         }
-        if (REVIEW_MODE_RE.test(text)) return;
+        // The build mode is the PAPER's: an included file declares none, `paper.tex` does.
+        const main = paperOf(context.settings)?.main;
+        const declares =
+          main === undefined || main === context.filename
+            ? text
+            : textOnDisk(main);
+        if (REVIEW_MODE_RE.test(declares)) return;
         // Comments are blanked by CUTTING THE TAIL of the line, exactly as the previous
         // implementation did. Columns do not shift: a match is only possible to the LEFT of
         // `%`, and the left part of the line stays in place character for character. An

package/fixtures/build-e2e/aidc/expect.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "A real IEEEtran [conference,compsoc] paper for AIDC, built on paperlint's TeX Live: IEEE's Times, and not one finding from any rule — which is what judges pdf/limits, pdf/body-size and the rest against a real PDF of the class.",
+  "$comment": "A real IEEEtran [conference,compsoc] paper for AIDC, built on paperlint's TeX Live: IEEE's Times, and not one finding from any rule — which is what judges format/page-limit, pdf/body-size and the rest against a real PDF of the class.",
   "build": {
     "outcome": "pdf"
   },

package/fixtures/build-e2e/aidc/paperlint.json

@@ -1 +1 @@
-{ "extends": "paperlint:aidc", "kind": "short" }
+{"extends": "paperlint:aidc", "kind": "short", "identity": ["Ada Example", "adaexample", "ada@example.org", "Example University", "exampletool"]}

package/fixtures/build-e2e/anon-ack/PIPELINE-STATUS.md

@@ -0,0 +1,3 @@
+# Fixture
+
+Stage: draft

package/fixtures/build-e2e/anon-ack/expect.json

@@ -0,0 +1,19 @@
+{
+  "$comment": "anonymity/identity on a real IEEEtran build: B: the name in an acknowledgments paragraph. Exactly one finding, naming where.",
+  "build": {
+    "outcome": "pdf"
+  },
+  "lint": {
+    "rules": {
+      "anonymity/identity": [
+        {
+          "severity": 2,
+          "says": [
+            "«Ada Example»",
+            "PDF, page"
+          ]
+        }
+      ]
+    }
+  }
+}

package/fixtures/build-e2e/anon-ack/paper.tex

@@ -0,0 +1,31 @@
+% B: the name in an acknowledgments paragraph.
+% The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
+\documentclass[conference,compsoc]{IEEEtran}
+\begin{filecontents*}{refs.bib}
+@article{knuth84,
+  title   = {Literate Programming},
+  author  = {Knuth, Donald E.},
+  journal = {The Computer Journal},
+  volume  = {27},
+  number  = {2},
+  pages   = {97--111},
+  year    = {1984},
+  doi     = {10.1093/comjnl/27.2.97}
+}
+\end{filecontents*}
+\begin{document}
+\title{A Fixture for Double-Blind Review}
+\author{\IEEEauthorblockN{Anonymous Authors}}
+\maketitle
+\section{Introduction}
+This paper builds on earlier work~\cite{knuth84}.
+
+\section{Conclusion}
+The conclusion restates that the fixture builds.
+\section*{Acknowledgments}
+We thank Ada Example for comments on a draft.
+\bibliographystyle{IEEEtran}
+\bibliography{refs}
+\section*{LLM Usage Statement}
+No LLMs were used in writing this fixture.
+\end{document}