paperlint 7.0.0 → 7.2.0

package/docs/rules.md

@@ -3,54 +3,60 @@
 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/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, `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)                                                                                                                                                                                                                                                                                                                                                               |
-| [`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; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md)                                                                                           |
-| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                        | `paper.tex` → `_build/paper.facts.json`                  | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                         |
-| `pdf/measured`                                                        | warn                                         | `paper.tex` → `_build/paper.facts.json`                  | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                             |
-| [`talk/profile`](rules/talk/profile.md)                               | error                                        | `paper.tex` → `paperlint.json`                           | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                   |
-| [`talk/required-files`](rules/talk/required-files.md)                 | error                                        | `paper.tex` → `paperlint.json`, the talk folder          | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                         |
-| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                         | `paper.tex` → the paper's `talk/` folder                 | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`talk/duration`](rules/talk/duration.md)                             | error                                        | `paper.tex` → the talk video                             | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                            |
-| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                         | `paper.tex` → the talk video                             | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| [`talk/video-format`](rules/talk/video-format.md)                     | error                                        | `paper.tex` → the talk video                             | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                  |
-| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                        | `paper.tex` → the one-slide PNG                          | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                    |
-| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                         | `paper.tex` → the captions and the video                 | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                    |
+| Rule                                                                  | Level                                        | Reads                                                               | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `paper/stages`                                                        | error                                        | `PIPELINE-STATUS.md`                                                | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/source`                                                        | error                                        | `PIPELINE-STATUS.md`                                                | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| [`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, `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)                                                                                                                                                                                                                                                                                                                                                                                                           |
+| [`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/`). A
-finding in one is reported at that file and line, and `--fix` edits that file. Which reference form
+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.
 
@@ -112,14 +118,15 @@ 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`, `tex/heading-case` |
-| `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`)                                 |
+| 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`, `tex/heading-case` |
+| `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`)                                 |
+| `paperlint:msr`             | `paperlint:ieee-conference` | IEEE `IEEEtran` `[10pt,conference]`, no `compsoc` | `technical` (10 + 2 of only references)                  | yes, appendices included — 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
@@ -131,7 +138,12 @@ would fail a correct paper. AIDC's limit is checked by another count, for the sa
 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`
+turns on [`anonymity/identity`](rules/anonymity/identity.md). MSR's limit is checked by a third
+count: its ten pages of main text include the appendices, and only pages holding nothing but
+references are the two extra ones. banal types a page whose first heading reads «Appendix» as
+bibliography and an appendix after the references as references, so its preset adds
+`"appendix_in_body": true` ([page](rules/format/page-limit.md)); it also forbids the `compsoc` and
+`compsocconf` class options its call rules out (`template_forbids`). 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.
@@ -139,7 +151,7 @@ proceedings.
 **How presets are named.** A template family — the preset venues extend, owning the template,
 the format and the TeX packages — is `<publisher>-<template variant>`: `acm-sigconf`, `ieee-conference`. A venue
 is its own short name, lowercase, with no publisher and no parent-conference prefix: `aisec`,
-`agenticdev`, `realm`, `aidc`. Which template a venue uses is said by its `extends`, not by its
+`agenticdev`, `realm`, `aidc`, `msr`. Which template a venue uses is said by its `extends`, not by its
 name — a name repeating it would be wrong the day the venue changes template — and the parent
 conference (CCS, ASE, ACSAC) goes into the preset's comment and its `aliases`.
 
@@ -230,6 +242,7 @@ The numbers and packages above illustrate the shape; take yours from the venue's
 | `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` and `paper/folder-venue-leftover`                                                                                                                                                                                                                                               |
 | `portal`            | where the venue takes submissions, `{ "kind": "hotcrp", "url": "https://…" }` — read by [`paperlint submission`](submission.md); a child's value replaces its parent's                                                                                                                                                                                                                                                                                             |
+| `deadlines`         | the edition's deadlines as read: `[{ "what", "at", "source", "url", "read" }]`, `at` in UTC, one reading per kind and source. A paper whose current cycle names the preset derives them ([`docs/configuration.md`](configuration.md#deadlines)); shipped presets' portal readings are refreshed daily in paperlint's repository; a child's list replaces its parent's                                                                                              |
 | `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)                                                                                                                                                                                                                                                                                                                                                                                 |

package/docs/submission.md

@@ -19,7 +19,7 @@ Two keys, each in the file that owns the fact, and a token:
 | the paper's `paperlint.json` | `"submission": { "id": 7 }`                          | which submission on that portal is this paper's |
 | the environment              | `HOTCRP_TOKEN`                                       | an API token for your HotCRP account            |
 
-`paperlint:aidc` declares its portal. For another venue, add `portal` to your own preset (see
+`paperlint:aidc` and `paperlint:msr` declare their portals. For another venue, add `portal` to your own preset (see
 [`rules.md`](rules.md)) — or upload by hand: a kind paperlint has no adapter for is refused with
 `portal kind "<kind>" is not supported; upload by hand`.
 
@@ -44,6 +44,11 @@ whether that PDF is the local one: HotCRP stores a PDF's sha256 as `sha2-<hex>`,
 compares it with the sha256 of the paper's `paper.pdf` (or its `pdf` setting, or `--pdf <file>`).
 `match yes` means the portal holds exactly the file you built. Exit 0 whenever the portal answered.
 
+Then one `deadline` line per deadline in force for the current attempt — the venue preset's portal
+readings with the paper's own call readings and overrides over them ([Deadlines](configuration.md#deadlines)):
+the instant that binds, what set it (a reading and the day it was read, or an override with its
+reason and evidence), and the other readings of it. Instants only; how long is left is not printed.
+
 ## `update`
 
 Sends the PDF — the paper's own unless `--pdf <file>` names another — and, when asked, a new
@@ -54,6 +59,10 @@ abstract (`--abstract <file>`, plain text) and the status "submitted" (`--submit
 change touched (`change_list`), HotCRP's messages — and the local file's sha256. Exit 1 when the
 change is not valid or the HTTP status is not 2xx.
 
+Before it sends anything, dry run or not, it prints one line asking you to open that exact PDF and
+check it against the venue's call for papers — named by the preset's `url` when the preset is a
+venue: what paperlint checks is an aid, and the venue's reading of the PDF is what counts.
+
 The safe order: `show`, `update` (dry run), read what it says, `update --save`, then `show` again and
 check `match yes`.
 

package/eslint-rules/cycle-stage.test.mjs

@@ -0,0 +1,131 @@
+/**
+ * `cycle/stage` on a scorecard's frontmatter beside a settings file: a stage names its cycle, the
+ * cycle exists, and no PDF was sent from a cycle still porting. Silent on the flat form.
+ */
+import assert from "node:assert/strict";
+import { join } from "node:path";
+import markdown from "@eslint/markdown";
+import { Linter } from "eslint";
+import { test } from "vitest";
+import { useTempDir, writeTree } from "../test/support.ts";
+import cycleStage from "./cycle-stage.ts";
+
+const root = useTempDir("cycle-stage-");
+const linter = new Linter({ cwd: root });
+
+const SETTINGS = JSON.stringify({
+  cycles: [
+    {
+      id: "alpha-2026",
+      venue: { kind: "preset", extends: "paperlint:acm-sigconf" },
+      opened: "2026-07-01",
+      outcome: { kind: "rejected", date: "2026-09-08", evidence: "r.md" },
+    },
+    {
+      id: "beta-2027",
+      venue: { kind: "preset", extends: "paperlint:ieee-conference" },
+      opened: "2026-09-09",
+      phase: "porting",
+    },
+  ],
+});
+
+/** The messages of the rule on a PIPELINE-STATUS.md with `frontmatter`, beside `settings`. */
+function lint(name, frontmatter, settings = SETTINGS) {
+  const dir = writeTree(join(root, name), {
+    ...(settings === null ? {} : { "paperlint.json": settings }),
+  });
+  const msgs = linter.verify(
+    `---\n${frontmatter}\n---\n\n# Status\n`,
+    [
+      {
+        files: ["**/*.md"],
+        plugins: { markdown, cycle: cycleStage },
+        language: "markdown/gfm",
+        languageOptions: { frontmatter: "yaml" },
+        rules: { "cycle/stage": "error" },
+      },
+    ],
+    join(dir, "PIPELINE-STATUS.md"),
+  );
+  assert.deepEqual(
+    msgs.filter((m) => m.fatal),
+    [],
+    `${name}: the rule threw`,
+  );
+  return msgs.map((m) => m.message);
+}
+
+const SUBMITTED = (cycle) =>
+  `stages:\n  - stage: submitted\n    ${cycle}\n    date: 2026-08-06\n    pdf: versions/a.pdf\n    bytes: 1`;
+
+test("a stage naming a declared cycle: silent", () => {
+  assert.deepEqual(lint("ok", SUBMITTED("cycle: alpha-2026")), []);
+});
+
+test("the flat form (no `cycles`), no settings file, or no stages: silent", () => {
+  const flat = JSON.stringify({ extends: "paperlint:aidc" });
+  assert.deepEqual(lint("flat", SUBMITTED("venue: Somewhere"), flat), []);
+  assert.deepEqual(lint("none", SUBMITTED("venue: Somewhere"), null), []);
+  assert.deepEqual(lint("empty", "stages: []"), []);
+});
+
+test("a stage with no `cycle` names the declared ids; one naming an unknown id names it", () => {
+  assert.deepEqual(lint("no-cycle", SUBMITTED("venue: Somewhere")), [
+    "the «submitted» stage (2026-08-06) names no `cycle` — this paper declares `cycles` in paperlint.json, so each stage says which attempt it belongs to: `cycle: <id>`, one of alpha-2026 · beta-2027",
+  ]);
+  assert.deepEqual(lint("unknown", SUBMITTED("cycle: gamma-2028")), [
+    "the «submitted» stage (2026-08-06) names the cycle «gamma-2028», which paperlint.json does not declare — the declared ids: alpha-2026 · beta-2027",
+  ]);
+});
+
+test("a PDF sent from a cycle still porting is named; a stage that sends none is not", () => {
+  assert.deepEqual(lint("porting", SUBMITTED("cycle: beta-2027")), [
+    "the «submitted» stage (2026-08-06) belongs to the cycle «beta-2027», whose phase is still `porting`: a PDF was sent while the record says the source is in the previous venue's template. Finish the port and drop the phase, or the stage is wrong",
+  ]);
+  assert.deepEqual(
+    lint(
+      "arxiv-porting",
+      SUBMITTED("cycle: beta-2027").replace("submitted", "arxiv"),
+    ),
+    [],
+  );
+});
+
+test("a settings file that is not JSON, or frontmatter that is not YAML: silent — other rules report those", () => {
+  assert.deepEqual(lint("not-json", SUBMITTED("venue: X"), "{ not json"), []);
+  assert.deepEqual(lint("not-yaml", "stages: [unclosed"), []);
+});
+
+test("`cycles: []` declared: a stage without a cycle is told there are none to name", () => {
+  const [msg] = lint(
+    "no-cycles",
+    SUBMITTED("venue: X"),
+    JSON.stringify({ cycles: [] }),
+  );
+  assert.match(msg, /one of \(none\)$/);
+});
+
+test("a stage and a cycle that are not strings, and a quoted date, are shown as written", () => {
+  const [msg] = lint(
+    "numbers",
+    'stages:\n  - stage: 5\n    cycle: 7\n    date: "2026-08-06"\n    pdf: versions/a.pdf\n    bytes: 1',
+  );
+  assert.match(msg, /the «5» stage \(2026-08-06\) names the cycle «7»/);
+});
+
+test("a stage entry with no `stage` key is shown as an empty name", () => {
+  const [msg] = lint(
+    "no-stage",
+    "stages:\n  - cycle: gamma-2028\n    date: 2026-08-06\n    pdf: versions/a.pdf\n    bytes: 1",
+  );
+  assert.match(
+    msg,
+    /^the «» stage \(2026-08-06\) names the cycle «gamma-2028»/,
+  );
+});
+
+test("a YAML date without quotes is still a date in the message", () => {
+  const [msg] = lint("yaml-date", SUBMITTED("venue: X"));
+  assert.match(msg, /\(2026-08-06\)/);
+});