paperlint 8.0.0 → 9.0.0

package/docs/rules.md

@@ -3,62 +3,66 @@
 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/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                                      | `§` 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`                                                 | 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)                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [`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 `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/`). Only
-the `.tex` ones are linted on their own: an included `.bbl` or `.pgf` is a tool's output, read into
-the whole paper where TeX typesets it, but not judged or fixed as prose of its own. A
-finding in a body file 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.
+| 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)                                                                                                                                                                                                                                                                                                                                                                                                                                |
+
+**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
+file found only in paperlint's own inputs, not a file the text names but TeX never read (behind
+`\iffalse`), and not any other `.tex` beside the paper (`versions/`). Lint never looks for an include
+itself. Only the `.tex` ones are linted on their own: an included `.bbl` or `.pgf` is a tool's output,
+read into the whole paper where TeX typesets it, but not judged or fixed as prose of its own. A
+finding in a body file 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: the
+files the record lists, spliced where their includes stand, each ended as TeX ends a file's last
+line. A paper with no record, or one it has changed since, is `paper.tex` alone, and
+[`paper/sources-fresh`](rules/paper/sources-fresh.md) says the files it includes went unlinted.
 
 `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
@@ -88,7 +92,8 @@ Also here: .06 % eslint-disable-line paper/leading-zero -- quoted too
 % eslint-enable paper/section-word
 ```
 
-This works inside the `filecontents` bibliography of `paper.tex` too, above the entry:
+This works inside the `filecontents` bibliography of `paper.tex` too, above the entry — and, for
+`bib/reachable-entry`, on the line above an entry in a `.bib` file:
 
 ```latex
 % eslint-disable-next-line bib/reachable-entry -- an invited talk, no recording exists

package/eslint-rules/paper-context.ts

@@ -4,9 +4,10 @@
  * 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.
+ * files — the `.tex` files TeX read after `\begin{document}` in the last build, from the record the
+ * build wrote (`paperBodies` in src/paper-includes.ts) — and puts them under
+ * `settings.paperlint.paper` for `paper.tex` and for every one of them. A rule reads the other files
+ * from disk. A paper with no record, or a stale one, is `paper.tex` alone.
  *
  * No setting — a file linted outside `paperlint lint` — means a paper of one file: every rule
  * decides on the file it was handed, as it did before.

package/eslint-rules/paper-typography.test.mjs

@@ -1,9 +1,9 @@
 /**
- * paper/section-word · paper/leading-zero · paper/figure-ref-style · bib/reachable-entry — each
- * FIRES on a bad input, stays SILENT on a good one, reports every occurrence at its own place,
- * and (the first three) fixes to an exact output. Plus the escape hatch: a disable directive in a
- * `%` comment, including inside the `filecontents` bibliography, silences exactly one finding,
- * and a directive that silences nothing is itself reported.
+ * paper/section-word · paper/leading-zero · paper/figure-ref-style — each FIRES on a bad input,
+ * stays SILENT on a good one, reports every occurrence at its own place, and fixes to an exact
+ * output. Plus the escape hatch: a disable directive in a `%` comment silences exactly one finding,
+ * and a directive that silences nothing is itself reported. (`bib/reachable-entry`, the fourth check
+ * of the old `paper/typography`, is tested beside it in src/bib-rules.test.ts.)
  *
  * The leading-zero cases are the ones paperlint#44 measured: a regex over the raw source found 22
  * decimals on a real corpus and none was a defect, so the SILENT list is as load-bearing as the
@@ -19,7 +19,6 @@ import typography, {
   crefDefinitionRanges,
   texVisibleRuns,
 } from "./paper-typography.ts";
-import bib from "./bib-reachable-entry.ts";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
 const FIX = join(HERE, "..", "fixtures", "paper-typography");
@@ -28,7 +27,6 @@ const RULES = {
   "paper/section-word": "warn",
   "paper/leading-zero": "warn",
   "paper/figure-ref-style": "warn",
-  "bib/reachable-entry": "warn",
 };
 
 const eslint = (fix = false) =>
@@ -42,7 +40,6 @@ const eslint = (fix = false) =>
         plugins: {
           tex: { languages: { latex: texLanguage } },
           paper: typography,
-          bib,
         },
         language: "tex/latex",
         linterOptions: { reportUnusedDisableDirectives: "error" },
@@ -74,8 +71,6 @@ describe("the fixtures: messy fires on each rule, clean is silent", () => {
     expect(count("paper/section-word")).toBe(3);
     expect(count("paper/leading-zero")).toBe(2);
     expect(count("paper/figure-ref-style")).toBe(1);
-    expect(count("bib/reachable-entry")).toBe(2);
-    expect(ids(res, "bib/reachable-entry").map((m) => m.line)).toEqual([3, 8]);
   });
 
   it("clean-paper — nothing", async () => {
@@ -110,6 +105,13 @@ describe("paper/section-word", () => {
     expect(ids(await lint(src), "paper/section-word")).toEqual([]);
   });
 
+  it("🔴 silent on a bibliography whose file name stands on the line after \\begin{filecontents*}", async () => {
+    const src =
+      "\\documentclass{acmart}\n\\begin{filecontents*}\n{refs.bib}\n@misc{k, note = {see §5}, url = {https://x.org}}\n\\end{filecontents*}\n" +
+      "\\begin{document}\nSection~\\ref{a}.\n\\end{document}\n";
+    expect(ids(await lint(src), "paper/section-word")).toEqual([]);
+  });
+
   it("🔴 a cleveref name definition is not prose: silent, and --fix leaves it as written", async () => {
     const src =
       "\\documentclass{article}\n\\usepackage{cleveref}\n\\crefname{section}{§}{§§}\n\\Crefname{section}{§}{§§}\n" +
@@ -296,69 +298,7 @@ describe("paper/figure-ref-style", () => {
   });
 });
 
-describe("bib/reachable-entry", () => {
-  const bibDoc = (entries) =>
-    `\\documentclass{acmart}\n\\begin{filecontents*}{refs.bib}\n${entries}\n\\end{filecontents*}\n\\begin{document}\nx\n\\end{document}\n`;
-
-  it("a doi, a url or an arXiv id each make an entry reachable", async () => {
-    const res = await lint(
-      bibDoc(
-        "@article{a, doi = {10.1/x}}\n@misc{b, url = {https://x.org}}\n@misc{c, note = {arXiv:2310.05736}}\n@string{v = {x}}",
-      ),
-    );
-    expect(ids(res, "bib/reachable-entry")).toEqual([]);
-  });
-
-  it("reports on the entry itself, naming its key", async () => {
-    const res = await lint(
-      bibDoc("@misc{ok, url = {https://x.org}}\n@article{lost, title = {x}}"),
-    );
-    const [m] = ids(res, "bib/reachable-entry");
-    expect(m.line).toBe(4);
-    expect(m.column).toBe(1);
-    expect(m.message).toMatch(/`lost`/);
-  });
-
-  it("an entry with no key is reported as `?`, not skipped", async () => {
-    const [m] = ids(
-      await lint(bibDoc("@article{\n  title = {x}}")),
-      "bib/reachable-entry",
-    );
-    expect(m.message).toMatch(/`\?`/);
-  });
-
-  it("a source code with only `text`, or with neither text nor raw", () => {
-    const run = (sourceCode) => {
-      const out = [];
-      bib.rules["reachable-entry"]
-        .create({
-          sourceCode: {
-            getLocFromIndex: (i) => ({ line: 1, column: i }),
-            ...sourceCode,
-          },
-          report: (r) => out.push(r.data.key),
-        })
-        ["root:exit"]();
-      return out;
-    };
-    expect(run({ text: bibDoc("@article{t, title = {x}}") })).toEqual(["t"]);
-    expect(run({})).toEqual([]);
-  });
-});
-
 describe("the escape hatch — a disable directive in a `%` comment", () => {
-  it("🔴 inside the filecontents bibliography, it silences exactly the next entry", async () => {
-    const res = await lint(
-      `\\documentclass{acmart}\n\\begin{filecontents*}{refs.bib}\n` +
-        "% eslint-disable-next-line bib/reachable-entry -- an invited talk, no recording exists\n" +
-        "@misc{talk, title = {x}}\n@misc{lost, title = {y}}\n" +
-        "\\end{filecontents*}\n\\begin{document}\nx\n\\end{document}\n",
-    );
-    const found = ids(res, "bib/reachable-entry");
-    expect(found).toHaveLength(1);
-    expect(found[0].message).toMatch(/`lost`/);
-  });
-
   it("in the body: next-line, same-line, and a disable/enable region", async () => {
     const src = doc(
       [

package/eslint-rules/paper-typography.ts

@@ -7,8 +7,8 @@
  *   paper/figure-ref-style  `Fig.~\ref` beside `Figure~\ref` in one document → the majority form
  *
  * The fourth check of the old `paper/typography`, an unreachable bibliography entry, is
- * `bib/reachable-entry` (bib-reachable-entry.mjs): it is about the bibliography, not the prose,
- * and it has no fix.
+ * `bib/reachable-entry` (src/bib-rules.ts): it is about the bibliography, not the prose, and it has
+ * no fix.
  *
  * ── PROVENANCE: every one is a real review finding, not an invented style ───────────────
  * From HotCRP #20 (2026-08-23). Reviewer B listed two as literal to-dos:
@@ -75,7 +75,7 @@ import type {
 } from "./rule-context.ts";
 
 /** Where a `.bib` embedded in a `filecontents` environment sits in the file. */
-export interface BibRange {
+interface BibRange {
   readonly start: number;
   readonly end: number;
   readonly bodyStart: number;
@@ -91,10 +91,17 @@ interface Run {
   offs: (number | null)[];
 }
 
-/** The inline bibliography — a `filecontents` block writing a `.bib` — with its offsets. */
-export function bibRange(text: string): BibRange | null {
+/**
+ * The inline bibliography — a `filecontents` block writing a `.bib`, its name on the `\begin` line or
+ * after white space on a later one, as TeX takes it — with its offsets: the span the markup rules
+ * skip. Which bibliography TeX reads is the build's record (`_build/sources.json`,
+ * docs/design/paper-sources.md §1);
+ * this range only says which bytes are not prose, and moves onto the one projection of live text
+ * with the rest of `skippedRanges` (Q3, docs/design/paper-sources.md §10).
+ */
+function bibRange(text: string): BibRange | null {
   const m =
-    /\\begin\{filecontents\*?\}(?:\[[^\]]*\])?\{[^}]*\.bib\}\r?\n([\s\S]*?)\\end\{filecontents\*?\}/d.exec(
+    /\\begin\{filecontents\*?\}\s*(?:\[[^\]]*\]\s*)?\{[^}]*\.bib\}[^\n]*\n([\s\S]*?)\\end\{filecontents\*?\}/d.exec(
       text,
     );
   if (!m) return null;

package/eslint.config.mjs

@@ -798,6 +798,28 @@ export default [
       "no-restricted-imports": ["error", { paths: ONE_COLLECTION_LIBRARY }],
     },
   },
+  // 🔴 ONE PLACE READS BIBLIOGRAPHIES. `@retorquere/bibtex-parser` is known to its adapter only;
+  // every other file — the app, the domain, another adapter, a skill's script — reads a `.bib` through
+  // the `BibReader` port, and a path a person gave through `bibliographyAt` (src/paper-sources.ts).
+  // Three readers of `.bib` text grew here before there was one. Its own rule id, so no other
+  // `no-restricted-imports` block can replace it (test/eslint-bib-parser.test.ts).
+  {
+    files: ["**/*.{ts,mts,mjs,js,cjs}"],
+    ignores: ["src/adapters/bibtex/**"],
+    plugins: { n },
+    rules: {
+      "n/no-restricted-import": [
+        "error",
+        [
+          {
+            name: ["@retorquere/bibtex-parser", "@retorquere/bibtex-parser/**"],
+            message:
+              "The bibtex parser is src/adapters/bibtex/'s: read a .bib through the BibReader port (src/ports/bib-reader.ts), or a path through bibliographyAt (src/paper-sources.ts).",
+          },
+        ],
+      ],
+    },
+  },
   // 🔴 THE LINTER DOES NOT READ A SKILL. Skills are consumers of the package, not its storage: the
   // venue presets once lived in a skill and were located through a skill's script, so renaming the
   // skill broke `paperlint lint` (#133). The package's own code — src/, eslint-rules/, lib/ — may

package/fixtures/build-e2e/aidc/paper.tex

@@ -3,7 +3,7 @@
 % rule is judged against what a real build of the class measures. It conforms: the LLM Usage
 % Statement closes it, and not one rule has anything to say.
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

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

@@ -1,7 +1,7 @@
 % 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}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

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

@@ -1,7 +1,7 @@
 % A: the name in the author block.
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

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

@@ -1,7 +1,7 @@
 % C: a self-citation: the name only in a .bib author field, printed by IEEEtran.bst as "A. Example".
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

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

@@ -2,7 +2,7 @@
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
 \usepackage{hyperref}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

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

@@ -2,7 +2,7 @@
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
 \newcommand{\me}{Ada Example}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},