paperlint 7.1.0 → 7.2.0

package/docs/rules.md

@@ -3,49 +3,53 @@
 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; with `appendix_in_body` too (MSR) the appendix is body wherever it sits and the reference pages are the ones holding only references; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md) |
-| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                        | `paper.tex` → `_build/paper.facts.json`                  | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                                                                     |
-| `pdf/measured`                                                        | warn                                         | `paper.tex` → `_build/paper.facts.json`                  | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                                                                         |
-| [`talk/profile`](rules/talk/profile.md)                               | error                                        | `paper.tex` → `paperlint.json`                           | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                                                               |
-| [`talk/required-files`](rules/talk/required-files.md)                 | error                                        | `paper.tex` → `paperlint.json`, the talk folder          | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                                                                     |
-| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                         | `paper.tex` → the paper's `talk/` folder                 | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| [`talk/duration`](rules/talk/duration.md)                             | error                                        | `paper.tex` → the talk video                             | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                         | `paper.tex` → the talk video                             | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [`talk/video-format`](rules/talk/video-format.md)                     | error                                        | `paper.tex` → the talk video                             | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                                                              |
-| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                        | `paper.tex` → the one-slide PNG                          | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                         | `paper.tex` → the captions and the video                 | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Rule                                                                  | Level                                        | Reads                                                               | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `paper/stages`                                                        | error                                        | `PIPELINE-STATUS.md`                                                | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/source`                                                        | error                                        | `PIPELINE-STATUS.md`                                                | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| [`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
@@ -238,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

@@ -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

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\)/);
+});

package/eslint-rules/cycle-stage.ts

@@ -0,0 +1,141 @@
+/**
+ * `cycle/stage` — a declared stage names the ATTEMPT it belongs to, and that attempt exists.
+ *
+ * With `cycles` in the paper's `paperlint.json`, a `stages` entry in the scorecard's frontmatter
+ * says `cycle: <id>` instead of a free `venue:` string: the venue's name is then the cycle's
+ * preset's, spelled once, and a consumer can tell which rows of the scorecard belong to which
+ * attempt. Three things can be wrong, each an error:
+ *
+ *   noCycle        `cycles` is declared and a stage names no `cycle`
+ *   unknownCycle   the stage's `cycle` is no declared cycle's id
+ *   porting        a `submitted` or `camera-ready` stage in a cycle whose phase is still `porting` —
+ *                  a PDF was sent while the record says the source is in the previous venue's template
+ *
+ * Without `cycles` (the flat form) the rule is silent: `venue:` stays what it was. The settings file
+ * is read here only for the cycles' ids and phases; `cycle/record` (src/cycle-rules.ts) judges the
+ * whole record.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { load } from "js-yaml";
+import { z } from "zod";
+import type { RuleContext } from "./rule-context.ts";
+
+const SETTINGS_FILE = "paperlint.json";
+
+/** What this rule reads of a cycle: its id and phase. `cycle/record` parses the rest. */
+const CycleHead = z.looseObject({
+  id: z.string(),
+  phase: z.string().optional(),
+});
+const Settings = z.looseObject({
+  cycles: z.array(CycleHead.catch({ id: "" })).optional(),
+});
+const Frontmatter = z.looseObject({ stages: z.unknown().optional() }).catch({});
+const Stage = z
+  .looseObject({
+    stage: z.unknown().optional(),
+    cycle: z.unknown().optional(),
+    date: z.unknown().optional(),
+  })
+  .catch({});
+
+/** The stages that send a PDF to the venue: a cycle still porting cannot have one. */
+const SENT: readonly string[] = ["submitted", "camera-ready"];
+
+interface Head {
+  readonly id: string;
+  readonly phase: string;
+}
+
+/** The declared cycles' heads, or null when the paper has no `cycles` (or no readable settings). */
+function cyclesOf(dir: string): readonly Head[] | null {
+  const file = join(dir, SETTINGS_FILE);
+  if (!existsSync(file)) return null;
+  try {
+    const s = Settings.safeParse(JSON.parse(readFileSync(file, "utf8")));
+    return s.success && s.data.cycles !== undefined
+      ? s.data.cycles.map((c) => ({ id: c.id, phase: c.phase ?? "prepared" }))
+      : null;
+  } catch {
+    return null;
+  }
+}
+
+const text = (v: unknown): string =>
+  typeof v === "string" ? v : v === undefined ? "" : JSON.stringify(v);
+
+/** A YAML date without quotes is a `Date`; shown as the day it names, as `paper/stages` does. */
+const dateText = (v: unknown): string =>
+  v instanceof Date ? v.toISOString().slice(0, 10) : text(v);
+
+interface Finding {
+  readonly messageId: "noCycle" | "unknownCycle" | "porting";
+  readonly data: Readonly<Record<string, string>>;
+}
+
+/** Each stage against the declared cycles. Pure. */
+export function judgeStages(
+  stages: readonly unknown[],
+  cycles: readonly Head[],
+): readonly Finding[] {
+  const known = cycles.map((c) => c.id).join(" · ") || "(none)";
+  return stages.flatMap((entry): readonly Finding[] => {
+    const s = Stage.parse(entry);
+    const stage = text(s.stage);
+    const date = dateText(s.date);
+    if (s.cycle === undefined)
+      return [{ messageId: "noCycle", data: { stage, date, known } }];
+    const id = text(s.cycle);
+    const cycle = cycles.find((c) => c.id === id);
+    if (cycle === undefined)
+      return [{ messageId: "unknownCycle", data: { stage, date, id, known } }];
+    return SENT.includes(stage) && cycle.phase === "porting"
+      ? [{ messageId: "porting", data: { stage, date, id } }]
+      : [];
+  });
+}
+
+export default {
+  rules: {
+    stage: {
+      meta: {
+        type: "problem" as const,
+        docs: {
+          description:
+            "with `cycles` declared, every stage names the cycle it belongs to, and no PDF is sent from a cycle still porting",
+          url: "https://github.com/zernie/paperlint/blob/main/docs/rules/cycle/stage.md",
+        },
+        schema: [],
+        messages: {
+          noCycle:
+            "the «{{stage}}» stage ({{date}}) names no `cycle` — this paper declares `cycles` in paperlint.json, so each stage says which attempt it belongs to: `cycle: <id>`, one of {{known}}",
+          unknownCycle:
+            "the «{{stage}}» stage ({{date}}) names the cycle «{{id}}», which paperlint.json does not declare — the declared ids: {{known}}",
+          porting:
+            "the «{{stage}}» stage ({{date}}) belongs to the cycle «{{id}}», 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",
+        },
+      },
+      create(context: RuleContext) {
+        const cycles = cyclesOf(dirname(context.filename));
+        if (cycles === null) return {};
+        return {
+          yaml(node: { readonly value: string }) {
+            const data = ((): unknown => {
+              try {
+                return load(node.value);
+              } catch {
+                return undefined; // `paper/stages` reports the unreadable YAML
+              }
+            })();
+            const stages = Frontmatter.parse(data).stages;
+            if (!Array.isArray(stages)) return;
+            judgeStages(stages, cycles).forEach((f) => {
+              context.report({ node, messageId: f.messageId, data: f.data });
+            });
+          },
+        };
+      },
+    },
+  },
+};