paperlint 6.2.3 → 7.0.0

package/docs/rules.md

@@ -3,47 +3,49 @@
 The README lists what each check catches in one line. This page says exactly which file each one
 reads and when it fails. Errors fail `paperlint lint`; warnings print and do not.
 
-| Rule                                                        | Level | Reads                                                    | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| ----------------------------------------------------------- | ----- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `paper/stages`                                              | error | `PIPELINE-STATUS.md`                                     | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                |
-| `paper/source`                                              | error | `PIPELINE-STATUS.md`                                     | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                |
-| `paper/author-list`                                         | error | `paper.tex` → `_build/references.json`                   | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line                                                                                                                                                                                                                                                          |
-| `paper/section-word`                                        | warn  | `paper.tex` and its body files, `paper.md`               | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                      |
-| `paper/leading-zero`                                        | warn  | `paper.tex` and its body files, `paper.md`               | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable** |
-| `paper/figure-ref-style`                                    | warn  | `paper.tex` and its body files                           | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                      |
-| `bib/reachable-entry`                                       | warn  | `paper.tex` (its `filecontents` bibliography)            | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry; no fix, the link has to be looked up                                                                                                                                                                                                                                                                                                                            |
-| `paper/cite-exists`                                         | error | `paper.tex` → `_build/references.json`                   | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                |
-| `paper/refs-fresh`                                          | error | `paper.tex` → `_build/references.json`                   | the bibliography changed since the build checked it (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/refs-checked`                                        | warn  | `paper.tex` → `_build/references.json`                   | the paper has a bibliography and no build has checked it, or the last build could not (no network) — so the two rules above did not run                                                                                                                                                                                                                                                                                                                       |
-| `tex/future-promise`                                        | warn  | `paper.tex` and its body files                           | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                        |
-| `tex/acm-frontmatter-override`                              | error | `paper.tex`                                              | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                               |
-| [`tex/template`](rules/tex/template.md)                     | error | `paper.tex` → `paperlint.json`                           | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                        |
-| [`tex/required-section`](rules/tex/required-section.md)     | error | `paper.tex` → `paperlint.json`                           | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                  |
-| [`format/layout-override`](rules/format/layout-override.md) | error | `paper.tex` → `paperlint.json`                           | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                          |
-| [`anonymity/identity`](rules/anonymity/identity.md)         | error | `paper.tex` → `_build/paper.facts.json`                  | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                             |
-| [`tex/venue-leftover`](rules/tex/venue-leftover.md)         | warn  | `paper.tex` → `paperlint.json`                           | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                         |
-| [`tex/claim-provenance`](rules/tex/claim-provenance.md)     | warn  | `paper.tex`                                              | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                    |
-| [`tex/register`](rules/tex/register.md)                     | warn  | `paper.tex` and the files it includes                    | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                        |
-| [`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)                                                                                                                                                                                                                                                                                                                                                                                             |
+| [`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)                                                                                                                                                                                                                                                                                                                                                                                    |
 
 **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
@@ -60,8 +62,8 @@ The `talk/*` rules judge a talk's finished files and are silent for a paper that
 `talk` (but `talk/undeclared`): [`talk.md`](talk.md).
 
 Optional rules — off unless you turn them on in the `rules` setting, because only some venues need
-them — are on their own page: [`optional-rules.md`](optional-rules.md). Today there is one,
-`pdf/last-page-balance`.
+them — are on their own page: [`optional-rules.md`](optional-rules.md). Today there are two,
+`pdf/last-page-balance` and `tex/heading-case`.
 
 ## A deliberate exception: a disable directive, with the reason
 
@@ -110,14 +112,14 @@ for papers, each with the quote it came from, the TeX packages its template need
 the venue implies. A preset may itself extend another: the ACM venues extend the `acm-sigconf`
 family, which holds everything the ACM template decides.
 
-| preset                      | extends                     | template                              | kinds                                                    | page limit checked                     | rules it turns on       |
-| --------------------------- | --------------------------- | ------------------------------------- | -------------------------------------------------------- | -------------------------------------- | ----------------------- |
-| `paperlint:acm-sigconf`     | —                           | ACM `acmart` sigconf                  | none                                                     | no (no kinds)                          | —                       |
-| `paperlint:agenticdev`      | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `short` (5 + 2 refs), `full` (10 + 2), `demo` (5 + 2)    | yes                                    | `pdf/last-page-balance` |
-| `paperlint:aisec`           | `paperlint:acm-sigconf`     | ACM `acmart` sigconf                  | `research`, `benchmark`, `position`, `sok` (10 + 2 each) | yes                                    | —                       |
-| `paperlint:realm`           | —                           | ACL                                   | `long`, `short`                                          | no — see below                         | —                       |
-| `paperlint:ieee-conference` | —                           | IEEE `IEEEtran` conference            | none                                                     | no (no kinds)                          | —                       |
-| `paperlint:aidc`            | `paperlint:ieee-conference` | IEEE `IEEEtran` conference, `compsoc` | `regular` (12), `short` (6)                              | 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`)                                 |
 
 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
@@ -193,7 +195,10 @@ papers/
 ```jsonc
 // venues/usenix-sec.jsonc
 {
+  // a venue says so, names itself, and links the call for papers its numbers are quoted from
+  "type": "venue",
   "name": "USENIX Security",
+  "url": "https://www.usenix.org/conference/usenixsecurity27/call-for-papers",
   // a standalone preset needs its template's TeX packages; one that extends a family inherits them
   "template": "article",
   // TeX Live packages only, each with a file that proves it is installed. The USENIX style file
@@ -218,10 +223,13 @@ The numbers and packages above illustrate the shape; take yours from the venue's
 
 | key                 | what it is                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `type`              | what the file is, required: `venue` (one venue's call for papers), `family` (a publisher's template that venues extend; it names no venue, so it has no `name` and no `url`), or `base` (the TeX base set, `tex` only, extended by nothing). A family may extend only a family; a venue a family or another venue                                                                                                                                                  |
 | `extends`           | the preset this one builds on: `paperlint:<name>` or `./path` / `../path`, relative to this file                                                                                                                                                                                                                                                                                                                                                                   |
-| `name`              | how messages name the venue; the file name otherwise                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `name`              | a venue's name, required on a venue: how messages name it, and one of the names `tex/venue-leftover` looks for. A family's messages use its file name                                                                                                                                                                                                                                                                                                              |
+| `url`               | a venue's call for papers or author instructions (`https://`), required on a venue — the page its numbers are quoted from                                                                                                                                                                                                                                                                                                                                          |
 | `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`                                                                                                                                                                                                                                                                                 |
+| `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                                                                                                                                                                                                                                                                                             |
 | `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)                                                                                                                                                                                                                                                                                                                                                                                 |
@@ -235,6 +243,9 @@ package; `format` keys are replaced one by one, and a child's kind replaces that
 presets long, and a cycle is refused by name. `paperlint toolchain` installs the packages of every
 shipped preset and of every preset your papers extend.
 
+Keep a card beside your preset, `venues/usenix-sec.md`, for what the call says that no rule
+checks — as the shipped presets do (`presets/<name>.md`, [configuration](configuration.md)).
+
 Presets from npm packages are not supported yet.
 
 ## The paper is LaTeX

package/docs/skills.md

@@ -62,10 +62,11 @@ the skill whose description matches starts. `paperlint init` installs them into
 
 ## 6 · Submit
 
-| you get                                                             | skill                 |
-| ------------------------------------------------------------------- | --------------------- |
-| the submission, step by step: anonymization, the form, the artifact | `submit-paper`        |
-| the reproduction artifact uploaded to OSF for anonymous review      | `osf-artifact-upload` |
+| you get                                                                        | skill                 |
+| ------------------------------------------------------------------------------ | --------------------- |
+| the submission, step by step: anonymization, the form, the artifact            | `submit-paper`        |
+| the reproduction artifact uploaded to OSF for anonymous review                 | `osf-artifact-upload` |
+| the PDF and abstract replaced on HotCRP, and proof the portal holds your build | `submission-portal`   |
 
 ## 7 · Camera-ready
 

package/docs/submission.md

@@ -0,0 +1,64 @@
+# The submission on the venue's portal
+
+`paperlint submission` reads and updates a paper's submission on the venue's submission portal,
+through the portal's API. Only [HotCRP](https://github.com/kohler/hotcrp) is supported.
+
+```sh
+npx paperlint submission show papers/my-paper
+npx paperlint submission update papers/my-paper                 # a dry run: nothing is saved
+npx paperlint submission update papers/my-paper --save          # changes the real submission
+```
+
+## What it needs
+
+Two keys, each in the file that owns the fact, and a token:
+
+| where                        | key                                                  | what it says                                    |
+| ---------------------------- | ---------------------------------------------------- | ----------------------------------------------- |
+| the venue preset             | `"portal": { "kind": "hotcrp", "url": "https://…" }` | where the venue takes submissions               |
+| 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
+[`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`.
+
+```jsonc
+// papers/my-paper/paperlint.json
+{ "extends": "paperlint:aidc", "kind": "regular", "submission": { "id": 7 } }
+```
+
+**The token** is read only from `HOTCRP_TOKEN`. Create it on the HotCRP site under **Account
+settings → Developer**; `show` needs the scopes `submeta:read` and `document:read`, `update` also
+`submeta:write` and `document:write`. paperlint sends it as `Authorization: bearer <token>` and
+never prints it or writes it anywhere.
+
+A missing key or token stops the command with exit 2 and a line naming the file and key, or the
+variable, to set.
+
+## `show`
+
+Prints the submission's status (and when it was submitted), its id, title, paper type, topics, the
+abstract's length in words, and the PDF the portal holds — its hash, size and upload time — then
+whether that PDF is the local one: HotCRP stores a PDF's sha256 as `sha2-<hex>`, and paperlint
+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.
+
+## `update`
+
+Sends the PDF — the paper's own unless `--pdf <file>` names another — and, when asked, a new
+abstract (`--abstract <file>`, plain text) and the status "submitted" (`--submit`).
+
+**Without `--save` it is a dry run**: HotCRP's `dry_run=1` checks the change and keeps nothing. With
+`--save` the real submission changes. Either way it prints HotCRP's verdict — `valid`, the fields the
+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.
+
+The safe order: `show`, `update` (dry run), read what it says, `update --save`, then `show` again and
+check `match yes`.
+
+## What it does not do
+
+- It does not create a submission, edit authors, topics or other form fields, or upload
+  supplementary files.
+- It does not check the PDF against the venue; that is `paperlint lint`.

package/docs/talk.md

@@ -41,7 +41,7 @@ A video named after the paper is declared once:
 ```json
 "talk": {
   "mode": "remote-video",
-  "files": { "video": "agenticdev-2026-talk.mp4", "captions": "agenticdev-2026-talk.srt" }
+  "files": { "video": "rule-drift-talk.mp4", "captions": "rule-drift-talk.srt" }
 }
 ```
 

package/eslint-rules/latex-language.test.mjs

@@ -204,3 +204,15 @@ test("a source code made from a parse result without the raw text reads the proj
     [true, undefined, true],
   );
 });
+
+test("🔴 a heading written over several lines keeps every newline, so the projection's lines are the source's", () => {
+  const src = "\\section{Related\nwork in\nthe field}\nText.\n";
+  const { text } = texToMdast(src);
+  // Guards: a line number computed on the projection (ESLint's getLocFromIndex) is the source's.
+  assert.equal(text.length, src.length);
+  assert.deepEqual(
+    [...text].flatMap((c, i) => (c === "\n" ? [i] : [])),
+    [...src].flatMap((c, i) => (c === "\n" ? [i] : [])),
+  );
+  assert.equal(text.split("\n")[3], "Text.");
+});

package/eslint-rules/latex-language.ts

@@ -567,10 +567,23 @@ export function texToMdast(
         // project to ATX: `##` where `\se` was, the rest spaces; the closing `}` too
         blank(pos.start.offset, end.offset + 1);
         for (let i = 0; i < depth; i++) chars[pos.start.offset + i] = "#";
-        const tStart = end.offset - title.length;
-        title.split("").forEach((ch, i) => {
-          chars[tStart + i] = ch;
-        });
+        // 🔴 The title is written right-aligned against the closing `}`, into the cells that are
+        // not a newline: a heading written over several lines keeps every `\n` where it was. The
+        // projection's lines must be the source's — ESLint turns an offset into a line on this
+        // text (`getLocFromIndex`), and a rule that reports a raw offset after a two-line heading
+        // was reported one line up, outside the reach of a disable directive. Measured 2026-10-04.
+        const cells = [...Array(end.offset - pos.start.offset - depth).keys()]
+          .map((k) => end.offset - 1 - k)
+          .filter((o) => src[o] !== "\n")
+          .slice(0, title.length)
+          .reverse();
+        const tStart = cells[0] ?? end.offset;
+        title
+          .slice(title.length - cells.length)
+          .split("")
+          .forEach((ch, i) => {
+            chars[nth(cells, i)] = ch;
+          });
         const tPos = { start: loc(tStart), end: loc(end.offset) };
         children.push({
           type: "heading",

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

@@ -250,6 +250,18 @@ describe("paper/leading-zero", () => {
   });
 });
 
+describe("a finding after a heading written over several lines", () => {
+  it("🔴 is reported on its own line, with CRLF line ends too", async () => {
+    for (const nl of ["\n", "\r\n"]) {
+      const text = doc(
+        ["\\section{Related", "work}", "We use .05 here."].join(nl),
+      );
+      const [m] = ids(await lint(text), "paper/leading-zero");
+      expect([m?.line, m?.column]).toEqual([5, 8]);
+    }
+  });
+});
+
 describe("paper/leading-zero — a number after ¶ or § is not a decimal (#102)", () => {
   // From a consumer's bibliography: `--fix` rewrote the paragraph number `¶¶.42` to `¶¶0.42`.
   const CITE =

package/eslint.config.mjs

@@ -21,7 +21,13 @@ import tseslint from "typescript-eslint";
 import boundaries from "eslint-plugin-boundaries";
 import functional from "eslint-plugin-functional";
 import sonarjs from "eslint-plugin-sonarjs";
-import { dirname } from "node:path";
+import {
+  projectStructureParser,
+  projectStructurePlugin,
+} from "eslint-plugin-project-structure";
+import { presetCardRules } from "#src/preset-card-rule";
+import { nodeFiles } from "#src/adapters/node/index";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // The complexity set, shared by the TypeScript block and the ratchet below. Every function
@@ -407,6 +413,57 @@ export const IO_GLOBALS = {
   },
 };
 
+/**
+ * EVERY PRESET HAS A CARD, AND EVERY CARD'S RULES TABLE IS THE PRESET'S. Two checks, one block each:
+ *
+ * - `project-structure/folder-structure` (its `enforceExistence`): each `presets/<name>.jsonc` needs
+ *   `presets/<name>.md` beside it, and is named in kebab case. Its rule listens for a `Program` node,
+ *   so the presets are read with the plugin's own parser, which gives every file an empty one.
+ *   Measured 2026-10-04: under `@eslint/json`'s `json/jsonc` language (root node `Document`) the same
+ *   rule never ran — RC 0 with seven cards missing.
+ * - `preset/card-rules` (src/preset-card-rule.ts): the section between the card's markers is the
+ *   resolved preset — what it is, its call for papers, its rules and where each was set. `--fix`
+ *   writes it.
+ *
+ * `root` is a parameter only so a test can lint a copy of the presets: the plugin resolves
+ * `structureRoot` against `projectRoot`, and the card rule reads the presets and docs under it.
+ * On an error the plugin writes `projectStructure.cache.json` into `projectRoot` (gitignored).
+ */
+export const presetCards = (root) => [
+  {
+    files: ["presets/*.jsonc"],
+    plugins: { "project-structure": projectStructurePlugin },
+    languageOptions: { parser: projectStructureParser },
+    rules: {
+      "project-structure/folder-structure": [
+        "error",
+        {
+          projectRoot: root,
+          structureRoot: "presets",
+          structure: [
+            { name: "{kebab-case}.jsonc", enforceExistence: "{node-name}.md" },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ["presets/*.md"],
+    plugins: {
+      markdown,
+      preset: {
+        rules: presetCardRules({
+          files: nodeFiles,
+          venuesDir: join(root, "presets"),
+          docsRoot: root,
+        }),
+      },
+    },
+    language: "markdown/gfm",
+    rules: { "preset/card-rules": "error" },
+  },
+];
+
 const ceiling = (rule, n) =>
   rule === "max-lines-per-function"
     ? ["error", { ...MAX_LINES, max: n }]
@@ -667,6 +724,7 @@ export default [
     languageOptions: { frontmatter: "yaml" },
     rules: { "port/md-install-path": "warn" },
   },
+  ...presetCards(dirname(fileURLToPath(import.meta.url))),
   {
     files: ["**/*.tex"],
     plugins: {

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

@@ -3,7 +3,7 @@
 % without it the fixture would fail for a reason unrelated to the subject of the test.
 \documentclass[sigconf,nonacm]{acmart}
 \begin{document}
-\title{A fixture that must come out in the class's own fonts}
+\title{A Fixture That Must Come Out in the Class's Own Fonts}
 \author{A. Author}
 \affiliation{\institution{X University}\city{Almaty}\country{Kazakhstan}}
 \maketitle

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

@@ -32,19 +32,19 @@
         {
           "severity": 2,
           "says": [
-            "page width is 8.264 in, agenticdev requires 8.5 in"
+            "page width is 8.264 in, AgenticDev requires 8.5 in"
           ]
         },
         {
           "severity": 2,
           "says": [
-            "page height is 11.694 in, agenticdev requires 11 in"
+            "page height is 11.694 in, AgenticDev requires 11 in"
           ]
         },
         {
           "severity": 2,
           "says": [
-            "column(s), agenticdev requires 2"
+            "column(s), AgenticDev requires 2"
           ]
         }
       ]