paperlint 10.2.0 → 10.3.0

package/docs/rules/repro/study-registered.md

@@ -1,8 +1,8 @@
 # repro/study-registered
 
 **Level:** error · **Reads:** the listing of the paper's `repro/`, `repro/studies.json`,
-`repro/README.md`, and each `result_file` the registry names · **Reported on:** the first line of the
-paper's `PIPELINE-STATUS.md`, once per finding
+`repro/README.md`, and each `result_file` and `plan` the registry names · **Reported on:** the first
+line of the paper's `PIPELINE-STATUS.md`, once per finding
 
 ## What it catches
 
@@ -46,9 +46,129 @@ is named `<id>-<slug>` after its row — `P1-S03-baseline`. The design: [`study-
 | `superseded_by` | optional: the id of the study that replaced it; required when `superseded`       |
 | `in_paper`      | `yes`, `no`, or `registry` (listed in the registry, not in the paper's text)     |
 
-A row may carry more fields — a paper's own measurement metadata (`role`, `frame`, `method`,
-`outcome`, …) — and `paperlint studies new` keeps them when it rewrites the file. The top level holds
-only `prefix` and `studies`.
+| `measurement` | optional: the id of the measurement the study belongs to (below) |
+| `plan` | optional: the study's plan, a file inside its folder — `plan.json` (below) |
+
+A row may carry more fields — a paper's own metadata (`frame`, `method`, `outcome`, …) — and
+`paperlint studies new` keeps them when it rewrites the file. Beside `prefix` and `studies`, the top
+level holds only the optional `author`, `requirements` and `measurements`; any other key is an error.
+
+### Measurements, requirements, the author
+
+One measurement — a census, a benchmark — often spans several studies: a pilot, the main run, a
+replication. A measurement is declared once, at the top level, and each of its studies' rows names
+it in `measurement`. The author's requirements on the measurements are kept in their words, beside
+them:
+
+```json
+{
+  "prefix": "P1",
+  "author": "A. Author",
+  "requirements": [
+    {
+      "id": "R1",
+      "text": "Every sample is a random draw from all rules found, no filter by difficulty.",
+      "date": "2026-10-10",
+      "source": "chat"
+    }
+  ],
+  "measurements": [
+    {
+      "id": "M1",
+      "title": "Rule census",
+      "rq": "RQ1",
+      "role": "headline",
+      "approval": {
+        "by": "A. Author",
+        "date": "2026-10-12",
+        "quote": "This is the one."
+      },
+      "requirements": ["R1"]
+    }
+  ],
+  "studies": [
+    {
+      "id": "P1-S01",
+      "folder": "P1-S01-census-pilot",
+      "measurement": "M1",
+      "plan": "plan.json",
+      "…": "…"
+    },
+    {
+      "id": "P1-S02",
+      "folder": "P1-S02-census",
+      "measurement": "M1",
+      "plan": "plan.json",
+      "…": "…"
+    }
+  ]
+}
+```
+
+| field                         | what it holds                                                                    |
+| ----------------------------- | -------------------------------------------------------------------------------- |
+| `author`                      | optional: the paper's author, the one person who approves a headline measurement |
+| `requirements[].id`           | the requirement's id, named by the measurements that must meet it                |
+| `requirements[].text`         | the author's words, verbatim                                                     |
+| `requirements[].date`         | `YYYY-MM-DD`                                                                     |
+| `requirements[].source`       | where they said it: a chat, a message, a review comment                          |
+| `measurements[].id`           | the measurement's id, named by its studies' rows                                 |
+| `measurements[].title`        | a plain name                                                                     |
+| `measurements[].rq`           | optional: the research question it answers                                       |
+| `measurements[].role`         | `headline` (the paper's claim rests on it) or `baseline`                         |
+| `measurements[].approval`     | the author's approval: `by`, `date`, their words in `quote`, optional `source`   |
+| `measurements[].requirements` | optional: the ids of the requirements it must meet                               |
+
+A measurement may carry more fields, as a row does; a requirement and an approval are exactly
+their fields. **A registry without `measurements` is judged as before**: a row's `measurement` is
+then a field of the paper's own, and nothing checks it.
+
+### The study's plan, `plan.json`
+
+Each study's plan is a JSON file in its folder, fixed before the runs: what it measures, the
+population and how the sample is drawn from it, the arms compared, the primary outcome, and the
+author's check of the drawn units. `paperlint studies new` writes the template beside the study's
+`README.md` and names it in the row's `plan`:
+
+```json
+{
+  "question": "",
+  "population": {
+    "source": "",
+    "draw": { "kind": "all", "method": "" }
+  },
+  "arms": [],
+  "primary_outcome": "",
+  "author_check": null
+}
+```
+
+| field                    | what it holds                                                                    |
+| ------------------------ | -------------------------------------------------------------------------------- |
+| `question`               | what the study measures, one sentence                                            |
+| `population.source`      | where the units come from: the census, crawl or registry, with its date          |
+| `population.draw.kind`   | `all` (the whole population, a census: no seed) or `seeded` (a sample)           |
+| `population.draw.method` | how the sample is drawn: `census`, `random`, `stratified` …                      |
+| `population.draw.seed`   | `seeded` only, and required there: the draw's seed, a string or a number         |
+| `arms`                   | the conditions compared, each `{ "name": … }`, each name once; `[]` for a census |
+| `primary_outcome`        | the one number the study reports first                                           |
+| `author_check`           | `null` until the author has seen the drawn units; then `by`, `date`, `quote`     |
+| `extra`                  | optional: the paper's own keys (hypotheses, models, budget), kept unread         |
+
+The template's draw is of all the population; a sampled study changes it to
+`{ "kind": "seeded", "method": "random", "seed": 7 }`. The population's size is not stored: it is
+counted from the source, and a stored copy could only contradict it.
+
+The plan is closed at every level, and holds no contradiction. Each of these makes the file "not a
+study plan" (`bad-plan`, with the reason): a misspelt key; a key of the paper's own outside `extra`,
+or a key of `extra` that is a field of the plan; a missing key — `null` is the one way to say "not
+yet"; a `seeded` draw without its seed, or an `all` draw with one; two arms of one name; and an
+`author_check` on a plan whose required texts are still empty — the author approves a complete plan.
+
+A plan named `prereg.json`, its old name, is parsed by a loose schema — keys of its own accepted at
+every level, those at the top kept in `extra`; a seed makes the draw `seeded`, none (or `null`)
+makes it `all`; a size is not read; an absent check is `null` — and
+[`repro/study-plan-name`](study-plan-name.md) warns that it moves to `plan.json`.
 
 The rule reports:
 
@@ -69,7 +189,20 @@ The rule reports:
   ```
 
 - a `repro/` with study folders and no `repro/studies.json` (one finding naming the file), and a
-  `studies.json` that is not JSON or not of the shape above (one finding with the reasons).
+  `studies.json` that is not JSON or not of the shape above (one finding with the reasons);
+- when the registry has `measurements`: a row whose `measurement` is not one of them
+  (`unknown-measurement`), a measurement no row names (`empty-measurement`), and a measurement that
+  must meet a requirement the registry does not hold (`unknown-requirement`);
+- a `headline` measurement with no `approval`, or, when the registry names its `author`, one approved
+  by anyone else (`headline-approval`);
+- a row's `plan` that is outside its folder, not a file, or not of the plan's shape — and, once the
+  study has run (`running`, `done`, `stopped`, `superseded`), a plan that leaves `question`,
+  `population.source`, `population.draw.method` or `primary_outcome` empty (`bad-plan`);
+- a study of a `headline` measurement that has run with no `author_check` in its plan — or no plan —
+  or, when the registry names its `author`, a check by anyone else (`author-check`).
+
+A study that is still `designing` owes neither a filled plan nor the author's check: the template
+`studies new` writes is clean until the first run. A `dropped` study owes neither.
 
 ## Why
 
@@ -98,6 +231,20 @@ Rule repro/study-registered: https://github.com/zernie/paperlint/blob/main/docs/
 
 Failing: a row set to `done` by hand, with no result, and the index not regenerated — two findings.
 
+Failing: the census of the example above set to `running` while its plan is still the template —
+the plan is reported for its empty fields, and the study for the author's check it lacks:
+
+```text
+papers/example/PIPELINE-STATUS.md
+  1:1  error  The plan of `P1-S02`, `plan.json` in its folder, leaves `question`, `population.source`,
+              `population.draw.method` and `primary_outcome` empty, and the study is `running`: a
+              plan is written before the runs. What to do: fill them in, or set the study back to
+              `designing`.
+  1:1  error  `P1-S02` is `running` in the headline measurement `M1`, and its plan has no
+              `author_check`. What to do: show the author the drawn units, then record their answer
+              in the plan's `author_check` — `by`, `date`, and their words in `quote`.
+```
+
 Passing: a paper with no study folder; and a `repro/` made only by `paperlint studies new`, its rows
 edited as the studies end and its index regenerated:
 
@@ -107,6 +254,7 @@ repro/
 ├── studies.json
 ├── P1-S01-baseline-pass-rate/
 │   ├── README.md
+│   ├── plan.json
 │   └── results.tsv
 ├── tools/
 └── data/
@@ -130,6 +278,11 @@ No rule options.
 
 - Whether `question` is one sentence and `result` one line, beyond their being text.
 - What a study's `README.md` says, or whether its frontmatter matches the row.
+- Whether a plan's texts say anything true, beyond their being filled in; whether `arms` should be
+  empty; whether the person in `approval` or `author_check` really said it — the rule sees the
+  name, not who typed it.
+- A repeated measurement or requirement id, and a requirement no measurement names.
+- A `prereg.json` or `plan.json` that no row names.
 - Whether the paper cites a study: `in_paper` is declared, not detected.
 - What may stand at the top of `repro/` besides the study folders, and whether a study folder has a
   `README.md`: that is [`repro/allowed-files-only`](allowed-files-only.md).
@@ -143,6 +296,11 @@ Create every new study with the command, which takes the next id, makes the fold
 npx paperlint studies new papers/example "Baseline pass rate" --kind measurement
 ```
 
+`studies new` also writes the study's `plan.json`: fill it in before the first run, and, for a
+study of a headline measurement, show the author the drawn units and record their answer in its
+`author_check`. A measurement is added by hand to `measurements`, with the author's `approval` when
+it is the headline, and each of its studies' rows names it in `measurement`.
+
 When a study ends, edit its row in `repro/studies.json` — `status`, `result`, `result_file`,
 `in_paper`, and `superseded_by` when another study replaced it — then regenerate the index:
 

package/docs/rules.md

@@ -3,58 +3,59 @@
 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)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| [`study/declare-sample`](rules/study/declare-sample.md)               | experimental; off unless a paper turns it on (`"error"`) | each study's `repro/<study>/prereg.json`                                          | a study's pre-registration does not declare its `population` (what the claim is about, source, size), the `strata` and what each of its `screens` removed per stratum value, its `coverage` (share 0–1 or null with a reason, and the strata it cannot reach), or the `author_check` of the drawn units (a doubtful verdict needs a recorded `decision`); reported on `PIPELINE-STATUS.md`, once per problem — [page](rules/study/declare-sample.md)                                                                                                   |
-| [`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/allowed-files-only`](rules/paper/allowed-files-only.md)       | error                                                    | the paper folder's root listing → `paperlint.json`                                | a file or folder at the paper's root is not part of the layout (`PLAN.md`, `archive/`, a stray PDF); reported on `PIPELINE-STATUS.md`, once per entry, with where it goes; `extra/` takes anything — [page](rules/paper/allowed-files-only.md)                                                                                                                                                                                                                                                                                                         |
-| [`repro/allowed-files-only`](rules/repro/allowed-files-only.md)       | error                                                    | the listing of the paper's `repro/`                                               | an entry at the top of `repro/` is not `README.md`, `studies.json`, `.gitignore`, `tools/`, `data/` or a study folder named `<id>-<slug>` (or, in a paper without the registry, `<slug>-YYYY-MM-DD`), or a study folder has no `README.md`; reported on `PIPELINE-STATUS.md`, once per entry, with where it goes by kind (a script → `repro/tools/`, data → `repro/data/`, a note → its study or `research/`) — [page](rules/repro/allowed-files-only.md)                                                                                              |
-| [`repro/study-registered`](rules/repro/study-registered.md)           | error                                                    | the listing of the paper's `repro/`, `repro/studies.json`, `repro/README.md`      | a study folder with no row in `repro/studies.json`, a row whose folder is missing or not `<id>-<slug>`, a bad or repeated id, a title over 8 words, `done` without a result and an existing result file, `superseded` without an existing successor, or the index in `repro/README.md` out of sync with the registry; `paperlint studies new` and `paperlint studies index` write both — [page](rules/repro/study-registered.md)                                                                                                                       |
-| [`paper/sources-fresh`](rules/paper/sources-fresh.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`                                               | the paper has not been built (no record of the files TeX read), or a file changed since the last build (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                               |
-| `paper/author-list`                                                   | error                                                    | `paper.tex` → `_build/references.json`, `_build/sources.json`                     | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line (or at the top of `paper.tex`, naming the entry's file); silent without a current build record                                                                                                                                                                                                                                                    |
-| `paper/section-word`                                                  | warn                                                     | `paper.tex` and its body files                                                    | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| `paper/leading-zero`                                                  | warn                                                     | `paper.tex` and its body files                                                    | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable**                                                                                          |
-| `paper/figure-ref-style`                                              | warn                                                     | `paper.tex` and its body files                                                    | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                                                                                                               |
-| [`bib/reachable-entry`](rules/bib/reachable-entry.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`: the databases the last build's bibtex opened | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry in the `filecontents` block of `paper.tex` that wrote its `.bib`, or at the top of `paper.tex` with the entry's file and line first; silent until a build records the paper; no fix, the link has to be looked up — [page](rules/bib/reachable-entry.md)                                                                                                                                                                                                  |
-| `paper/cite-exists`                                                   | error                                                    | `paper.tex` → `_build/references.json`                                            | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/refs-fresh`                                                    | error                                                    | `paper.tex` → `_build/references.json`                                            | the databases bibtex opened changed since the build checked them (their SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `paper/refs-checked`                                                  | warn                                                     | `paper.tex` → `_build/references.json`                                            | a build recorded the paper's databases and none has checked their references, or the last build could not (no network), or its bibtex typeset a key paperlint's reader did not read (an entry behind `%`, inside `@comment{…}`), or bibtex found a database outside the paper directory (`BIBINPUTS`) — so the two rules above did not run on it. Silent without a record of the build (`paper/sources-fresh` speaks)                                                                                                                                  |
-| `tex/future-promise`                                                  | warn                                                     | `paper.tex` and its body files                                                    | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `tex/acm-frontmatter-override`                                        | error                                                    | `paper.tex`                                                                       | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`tex/template`](rules/tex/template.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                    | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| [`tex/required-section`](rules/tex/required-section.md)               | error                                                    | `paper.tex` → `paperlint.json`                                                    | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                                                                                                           |
-| [`tex/heading-case`](rules/tex/heading-case.md)                       | optional; the AgenticDev preset sets `error`             | `paper.tex` and the files it includes                                             | a word in the paper's `\title` or in a `\section`, `\subsection`, `\subsubsection`, `\paragraph` or `\subparagraph` title is not in the style its scope asks: `{ "title", "headings", "levels"? }`, each `chicago-headline` (Conference Publishing's quote of the Chicago Manual of Style), `sentence` (first word only) or `any`. Words that are a preposition in one title and a particle in another (`up`, `on`, `in`) are not read mid-title. **Fixable:** `--fix` — [page](rules/tex/heading-case.md)                                             |
-| [`format/layout-override`](rules/format/layout-override.md)           | error                                                    | `paper.tex` → `paperlint.json`                                                    | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                                                                                                                   |
-| [`anonymity/identity`](rules/anonymity/identity.md)                   | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                                                                                                                      |
-| [`tex/venue-leftover`](rules/tex/venue-leftover.md)                   | warn                                                     | `paper.tex` → `paperlint.json`                                                    | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                                                                                                                  |
-| [`tex/claim-provenance`](rules/tex/claim-provenance.md)               | warn                                                     | `paper.tex`                                                                       | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                                                                                                             |
-| [`tex/register`](rules/tex/register.md)                               | warn                                                     | `paper.tex` and the files it includes                                             | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                                                                                                                 |
-| [`tex/contrast-frames`](rules/tex/contrast-frames.md)                 | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | contrast frames (_X, not Y_, _not X but Y_, _rather than_, _instead of_, _as opposed to_) per 10,000 words fall outside the band the venue preset's anchors set (AIDC: 0–10.4, from five accepted ACSAC papers); above it, each frame is reported too — [page](rules/tex/contrast-frames.md)                                                                                                                                                                                                                                                           |
-| [`tex/claim-emphasis`](rules/tex/claim-emphasis.md)                   | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | claims set in bold inside a sentence (six words or more, or holding a number; not a term, not a label opening a paragraph) per 10,000 words fall outside the preset's band (AIDC: 0–17.8); above it, each is reported too — [page](rules/tex/claim-emphasis.md)                                                                                                                                                                                                                                                                                        |
-| [`tex/relation-markers`](rules/tex/relation-markers.md)               | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                          | words that name how a sentence relates to the one before (_because_, _therefore_, _however_, _for example_ …) per 10,000 words fall outside the preset's band (AIDC: 25.4–135.0) — the floor that catches relations left to infer — [page](rules/tex/relation-markers.md)                                                                                                                                                                                                                                                                              |
-| `review/frontmatter`                                                  | error                                                    | `reviews/*.md`                                                                    | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                                                                                                         |
-| `sibling/frontmatter`                                                 | warn                                                     | `siblings/*.md` (not `README.md`)                                                 | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `pdf/fresh`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                                                                                                             |
-| `pdf/profile`                                                         | error                                                    | `paper.tex` → `paperlint.json`                                                    | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                                                                                                                |
-| `pdf/fonts`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                                                                                                                     |
-| `pdf/geometry`                                                        | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| [`format/page-limit`](rules/format/page-limit.md)                     | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; with `appendix_in_body` too (MSR) the appendix is body wherever it sits and the reference pages are the ones holding only references; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md) |
-| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                                    | `paper.tex` → `_build/paper.facts.json`                                           | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                                                                     |
-| `pdf/measured`                                                        | warn                                                     | `paper.tex` → `_build/paper.facts.json`                                           | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                                                                         |
-| [`talk/profile`](rules/talk/profile.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                    | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                                                               |
-| [`talk/required-files`](rules/talk/required-files.md)                 | error                                                    | `paper.tex` → `paperlint.json`, the talk folder                                   | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                                                                     |
-| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                                     | `paper.tex` → the paper's `talk/` folder                                          | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| [`talk/duration`](rules/talk/duration.md)                             | error                                                    | `paper.tex` → the talk video                                                      | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                                                                        |
-| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                                     | `paper.tex` → the talk video                                                      | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| [`talk/video-format`](rules/talk/video-format.md)                     | error                                                    | `paper.tex` → the talk video                                                      | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                                                              |
-| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                                    | `paper.tex` → the one-slide PNG                                                   | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                                     | `paper.tex` → the captions and the video                                          | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| [`study/declare-sample`](rules/study/declare-sample.md)               | experimental; off unless a paper turns it on (`"error"`) | each study's `repro/<study>/prereg.json`                                                               | a study's pre-registration does not declare its `population` (what the claim is about, source, size), the `strata` and what each of its `screens` removed per stratum value, its `coverage` (share 0–1 or null with a reason, and the strata it cannot reach), or the `author_check` of the drawn units (a doubtful verdict needs a recorded `decision`); reported on `PIPELINE-STATUS.md`, once per problem — [page](rules/study/declare-sample.md)                                                                                                                                                                                                                                                                                              |
+| [`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/allowed-files-only`](rules/paper/allowed-files-only.md)       | error                                                    | the paper folder's root listing → `paperlint.json`                                                     | a file or folder at the paper's root is not part of the layout (`PLAN.md`, `archive/`, a stray PDF); reported on `PIPELINE-STATUS.md`, once per entry, with where it goes; `extra/` takes anything — [page](rules/paper/allowed-files-only.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| [`repro/allowed-files-only`](rules/repro/allowed-files-only.md)       | error                                                    | the listing of the paper's `repro/`                                                                    | an entry at the top of `repro/` is not `README.md`, `studies.json`, `.gitignore`, `tools/`, `data/` or a study folder named `<id>-<slug>` (or, in a paper without the registry, `<slug>-YYYY-MM-DD`), or a study folder has no `README.md`; reported on `PIPELINE-STATUS.md`, once per entry, with where it goes by kind (a script → `repro/tools/`, data → `repro/data/`, a note → its study or `research/`) — [page](rules/repro/allowed-files-only.md)                                                                                                                                                                                                                                                                                         |
+| [`repro/study-registered`](rules/repro/study-registered.md)           | error                                                    | the listing of the paper's `repro/`, `repro/studies.json`, `repro/README.md`, each study's `plan.json` | a study folder with no row in `repro/studies.json`, a row whose folder is missing or not `<id>-<slug>`, a bad or repeated id, a title over 8 words, `done` without a result and an existing result file, `superseded` without an existing successor, a row naming a measurement the registry does not declare, a measurement with no study or an unknown requirement, a headline measurement not approved by the author, a plan that is missing, malformed or — once the study runs — unfilled, a headline study that has run without the author's check in its plan, or the index in `repro/README.md` out of sync with the registry; `paperlint studies new` and `paperlint studies index` write both — [page](rules/repro/study-registered.md) |
+| [`repro/study-plan-name`](rules/repro/study-plan-name.md)             | warn                                                     | `repro/studies.json`                                                                                   | a study's plan still named `prereg.json`, its old name: read as the plan, and to be renamed `plan.json` — [page](rules/repro/study-plan-name.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| [`paper/sources-fresh`](rules/paper/sources-fresh.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`                                                                    | the paper has not been built (no record of the files TeX read), or a file changed since the last build (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `paper/author-list`                                                   | error                                                    | `paper.tex` → `_build/references.json`, `_build/sources.json`                                          | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line (or at the top of `paper.tex`, naming the entry's file); silent without a current build record                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `paper/section-word`                                                  | warn                                                     | `paper.tex` and its body files                                                                         | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `paper/leading-zero`                                                  | warn                                                     | `paper.tex` and its body files                                                                         | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable**                                                                                                                                                                                                                                                                                     |
+| `paper/figure-ref-style`                                              | warn                                                     | `paper.tex` and its body files                                                                         | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| [`bib/reachable-entry`](rules/bib/reachable-entry.md)                 | warn                                                     | `paper.tex` → `_build/sources.json`: the databases the last build's bibtex opened                      | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry in the `filecontents` block of `paper.tex` that wrote its `.bib`, or at the top of `paper.tex` with the entry's file and line first; silent until a build records the paper; no fix, the link has to be looked up — [page](rules/bib/reachable-entry.md)                                                                                                                                                                                                                                                                                                                                                                                             |
+| `paper/cite-exists`                                                   | error                                                    | `paper.tex` → `_build/references.json`                                                                 | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `paper/refs-fresh`                                                    | error                                                    | `paper.tex` → `_build/references.json`                                                                 | the databases bibtex opened changed since the build checked them (their SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `paper/refs-checked`                                                  | warn                                                     | `paper.tex` → `_build/references.json`                                                                 | a build recorded the paper's databases and none has checked their references, or the last build could not (no network), or its bibtex typeset a key paperlint's reader did not read (an entry behind `%`, inside `@comment{…}`), or bibtex found a database outside the paper directory (`BIBINPUTS`) — so the two rules above did not run on it. Silent without a record of the build (`paper/sources-fresh` speaks)                                                                                                                                                                                                                                                                                                                             |
+| `tex/future-promise`                                                  | warn                                                     | `paper.tex` and its body files                                                                         | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `tex/acm-frontmatter-override`                                        | error                                                    | `paper.tex`                                                                                            | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| [`tex/template`](rules/tex/template.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                                         | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| [`tex/required-section`](rules/tex/required-section.md)               | error                                                    | `paper.tex` → `paperlint.json`                                                                         | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| [`tex/heading-case`](rules/tex/heading-case.md)                       | optional; the AgenticDev preset sets `error`             | `paper.tex` and the files it includes                                                                  | a word in the paper's `\title` or in a `\section`, `\subsection`, `\subsubsection`, `\paragraph` or `\subparagraph` title is not in the style its scope asks: `{ "title", "headings", "levels"? }`, each `chicago-headline` (Conference Publishing's quote of the Chicago Manual of Style), `sentence` (first word only) or `any`. Words that are a preposition in one title and a particle in another (`up`, `on`, `in`) are not read mid-title. **Fixable:** `--fix` — [page](rules/tex/heading-case.md)                                                                                                                                                                                                                                        |
+| [`format/layout-override`](rules/format/layout-override.md)           | error                                                    | `paper.tex` → `paperlint.json`                                                                         | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [`anonymity/identity`](rules/anonymity/identity.md)                   | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| [`tex/venue-leftover`](rules/tex/venue-leftover.md)                   | warn                                                     | `paper.tex` → `paperlint.json`                                                                         | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| [`tex/claim-provenance`](rules/tex/claim-provenance.md)               | warn                                                     | `paper.tex`                                                                                            | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| [`tex/register`](rules/tex/register.md)                               | warn                                                     | `paper.tex` and the files it includes                                                                  | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| [`tex/contrast-frames`](rules/tex/contrast-frames.md)                 | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                                               | contrast frames (_X, not Y_, _not X but Y_, _rather than_, _instead of_, _as opposed to_) per 10,000 words fall outside the band the venue preset's anchors set (AIDC: 0–10.4, from five accepted ACSAC papers); above it, each frame is reported too — [page](rules/tex/contrast-frames.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| [`tex/claim-emphasis`](rules/tex/claim-emphasis.md)                   | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                                               | claims set in bold inside a sentence (six words or more, or holding a number; not a term, not a label opening a paragraph) per 10,000 words fall outside the preset's band (AIDC: 0–17.8); above it, each is reported too — [page](rules/tex/claim-emphasis.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| [`tex/relation-markers`](rules/tex/relation-markers.md)               | warn                                                     | `paper.tex` and the files it includes → `paperlint.json`                                               | words that name how a sentence relates to the one before (_because_, _therefore_, _however_, _for example_ …) per 10,000 words fall outside the preset's band (AIDC: 25.4–135.0) — the floor that catches relations left to infer — [page](rules/tex/relation-markers.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `review/frontmatter`                                                  | error                                                    | `reviews/*.md`                                                                                         | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `sibling/frontmatter`                                                 | warn                                                     | `siblings/*.md` (not `README.md`)                                                                      | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `pdf/fresh`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `pdf/profile`                                                         | error                                                    | `paper.tex` → `paperlint.json`                                                                         | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `pdf/fonts`                                                           | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `pdf/geometry`                                                        | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| [`format/page-limit`](rules/format/page-limit.md)                     | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; with `appendix_in_body` too (MSR) the appendix is body wherever it sits and the reference pages are the ones holding only references; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md)                                                                                                                                                                                            |
+| [`pdf/body-size`](rules/pdf/body-size.md)                             | error                                                    | `paper.tex` → `_build/paper.facts.json`                                                                | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                                                                                                                                                                                                                                                                                                                |
+| `pdf/measured`                                                        | warn                                                     | `paper.tex` → `_build/paper.facts.json`                                                                | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| [`talk/profile`](rules/talk/profile.md)                               | error                                                    | `paper.tex` → `paperlint.json`                                                                         | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| [`talk/required-files`](rules/talk/required-files.md)                 | error                                                    | `paper.tex` → `paperlint.json`, the talk folder                                                        | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| [`talk/undeclared`](rules/talk/undeclared.md)                         | warn                                                     | `paper.tex` → the paper's `talk/` folder                                                               | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| [`talk/duration`](rules/talk/duration.md)                             | error                                                    | `paper.tex` → the talk video                                                                           | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| [`talk/duration-floor`](rules/talk/duration-floor.md)                 | warn                                                     | `paper.tex` → the talk video                                                                           | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| [`talk/video-format`](rules/talk/video-format.md)                     | error                                                    | `paper.tex` → the talk video                                                                           | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| [`talk/one-slide-size`](rules/talk/one-slide-size.md)                 | error                                                    | `paper.tex` → the one-slide PNG                                                                        | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| [`talk/captions-cover`](rules/talk/captions-cover.md)                 | warn                                                     | `paper.tex` → the captions and the video                                                               | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 
 **Body files** are the files of the paper's directory that TeX read after `\begin{document}` in the
 last build, as `paperlint build` recorded them in `_build/sources.json` — not a preamble file, not a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperlint",
-  "version": "10.2.0",
+  "version": "10.3.0",
   "description": "A linter for scientific papers written in LaTeX: catches mistakes before you submit to a conference or journal.",
   "type": "module",
   "license": "MIT",