paperlint 6.0.0 → 6.2.0

package/docs/rules/tex/relation-markers.md

@@ -0,0 +1,72 @@
+# tex/relation-markers
+
+**Level:** warn · **Reads:** `paper.tex` and the files it includes → `paperlint.json`
+
+## What it catches
+
+A body that names how its sentences relate less often — or far more often — than the accepted papers
+of its venue. A relation marker is one of: _therefore_, _thus_, _hence_, _consequently_, _as a
+result_, _because_, _since_, _this means_, _this implies_, _which explains_, _in turn_, _that is,_,
+_i.e._, _in contrast_, _by contrast_, _however_, _nevertheless_, _nonetheless_, _whereas_, _in other
+words_, _for this reason_, _it follows_, _accordingly_, _specifically,_, _in particular,_, _for
+example_, _for instance_, _e.g._ — as whole words, anywhere in a sentence. Counted per 10,000 words of
+the body.
+
+Outside the band it reports once, at the start of the body, with the count, the rate, the band and
+the anchors' range. A body under 2 000 words, or a paper whose preset records no anchors, is not
+judged.
+
+This is the FLOOR among the register checks: [`tex/contrast-frames`](contrast-frames.md) and
+[`tex/claim-emphasis`](claim-emphasis.md) catch a device used too often; this one catches the
+relation left for the reader to infer, which is what a rewrite that only deletes devices leaves
+behind.
+
+## Why
+
+A reviewer wrote: _"Readers are often required to infer the intended relationships between claims."_
+Measured on the LaTeX source, per 10,000 words:
+
+| paper                                                   | words | markers | per 10,000 |
+| ------------------------------------------------------- | ----: | ------: | ---------: |
+| `rr-dataset-quality-acsac24` (ACSAC 2024)               |  8130 |      32 |       39.4 |
+| `barovox-acsac24` (ACSAC 2024)                          |  7670 |      31 |       40.4 |
+| `secure-acsac24` (ACSAC 2024)                           |  7519 |      38 |       50.5 |
+| `llm-splained-acsac25` (ACSAC 2025)                     |  9529 |      84 |       88.2 |
+| `leaking-queries-acsac25` (ACSAC 2025)                  |  9133 |     103 |      112.8 |
+| the paper reviewers called a blog post, current version | 10476 |      20 |       19.1 |
+| the same paper, before its rewrite                      |  6128 |       9 |       14.7 |
+| `agenticdev-acm26` (ours, "too informal", ACM)          |  4374 |      13 |       29.7 |
+
+_However_ alone stands 6–11 times in every accepted paper and never in the current version of ours. The
+separation survives dropping any one marker from the list: with each of the 24 that occur removed in
+turn, the lowest accepted paper stays at least 1.38 times the highest version of ours (the worst case
+is dropping _however_). The list was fixed before this
+corpus was measured (it is the one a register diagnosis of the same papers used, on text extracted
+from PDFs, where the gap was narrow); on the parse tree the gap is twofold.
+
+## Examples
+
+```latex
+Most guards match words. 24 of 46 block a harmless echo.                  % the relation is left to infer
+Because most guards match words, 24 of 46 block a harmless echo.          % named
+Most guards match words; as a result, 24 of 46 block a harmless echo.     % named
+```
+
+## Options / preset fields
+
+No rule options. The band is the venue preset's `register.anchors`, exactly as for
+[`tex/contrast-frames`](contrast-frames.md), which explains how it is derived. For `paperlint:aidc` it
+is **25.4–135.0**.
+
+## What it does not check
+
+Whether a marker names the right relation, or a relation named another way (_this is why_, _so that_,
+a colon). The list counts only words whose meaning does not depend on context; _since_ is on it and
+is sometimes temporal.
+
+## How to fix
+
+Where two sentences stand side by side, say whether the second is the cause, the consequence, an
+example or a limit of the first — with the word, not with a dash, a colon or a short sentence left to
+land the point. The fix adds words; pay for them by moving detail to a table or the appendix, not by
+cutting the connectives from another paragraph.

package/docs/rules.md

@@ -3,36 +3,47 @@
 The README lists what each check catches in one line. This page says exactly which file each one
 reads and when it fails. Errors fail `paperlint lint`; warnings print and do not.
 
-| Rule                                                        | Level | Reads                                         | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| ----------------------------------------------------------- | ----- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `paper/stages`                                              | error | `PIPELINE-STATUS.md`                          | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                |
-| `paper/source`                                              | error | `PIPELINE-STATUS.md`                          | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                |
-| `paper/author-list`                                         | error | `paper.tex` → `_build/references.json`        | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line                                                                                                                                                                                                                                                          |
-| `paper/section-word`                                        | warn  | `paper.tex` and its body files, `paper.md`    | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                      |
-| `paper/leading-zero`                                        | warn  | `paper.tex` and its body files, `paper.md`    | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable** |
-| `paper/figure-ref-style`                                    | warn  | `paper.tex` and its body files                | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                      |
-| `bib/reachable-entry`                                       | warn  | `paper.tex` (its `filecontents` bibliography) | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry; no fix, the link has to be looked up                                                                                                                                                                                                                                                                                                                            |
-| `paper/cite-exists`                                         | error | `paper.tex` → `_build/references.json`        | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                |
-| `paper/refs-fresh`                                          | error | `paper.tex` → `_build/references.json`        | the bibliography changed since the build checked it (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                         |
-| `paper/refs-checked`                                        | warn  | `paper.tex` → `_build/references.json`        | the paper has a bibliography and no build has checked it, or the last build could not (no network) — so the two rules above did not run                                                                                                                                                                                                                                                                                                                       |
-| `tex/future-promise`                                        | warn  | `paper.tex` and its body files                | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                        |
-| `tex/acm-frontmatter-override`                              | error | `paper.tex`                                   | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                               |
-| [`tex/template`](rules/tex/template.md)                     | error | `paper.tex` → `paperlint.json`                | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                        |
-| [`tex/required-section`](rules/tex/required-section.md)     | error | `paper.tex` → `paperlint.json`                | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                  |
-| [`format/layout-override`](rules/format/layout-override.md) | error | `paper.tex` → `paperlint.json`                | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                          |
-| [`anonymity/identity`](rules/anonymity/identity.md)         | error | `paper.tex` → `_build/paper.facts.json`       | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                             |
-| [`tex/venue-leftover`](rules/tex/venue-leftover.md)         | warn  | `paper.tex` → `paperlint.json`                | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                         |
-| [`tex/claim-provenance`](rules/tex/claim-provenance.md)     | warn  | `paper.tex`                                   | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                    |
-| [`tex/register`](rules/tex/register.md)                     | warn  | `paper.tex` and the files it includes         | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                        |
-| `review/frontmatter`                                        | error | `reviews/*.md`                                | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                |
-| `sibling/frontmatter`                                       | warn  | `siblings/*.md` (not `README.md`)             | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                    |
-| `pdf/fresh`                                                 | error | `paper.tex` → `_build/paper.facts.json`       | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                    |
-| `pdf/profile`                                               | error | `paper.tex` → `paperlint.json`                | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                       |
-| `pdf/fonts`                                                 | error | `paper.tex` → `_build/paper.facts.json`       | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                            |
-| `pdf/geometry`                                              | error | `paper.tex` → `_build/paper.facts.json`       | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                |
-| [`format/page-limit`](rules/format/page-limit.md)           | error | `paper.tex` → `_build/paper.facts.json`       | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md)                                              |
-| [`pdf/body-size`](rules/pdf/body-size.md)                   | error | `paper.tex` → `_build/paper.facts.json`       | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                            |
-| `pdf/measured`                                              | warn  | `paper.tex` → `_build/paper.facts.json`       | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                |
+| Rule                                                        | Level | Reads                                                    | Fails when                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ----------------------------------------------------------- | ----- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `paper/stages`                                              | error | `PIPELINE-STATUS.md`                                     | a declared stage's PDF is missing, or the `bytes:` it names does not match the file's real size, or a frozen PDF exists that no stage declares                                                                                                                                                                                                                                                                                                                |
+| `paper/source`                                              | error | `PIPELINE-STATUS.md`                                     | a declared stage has no frozen `.tex` beside its PDF (a commit hash does not count — squash and gc destroy it)                                                                                                                                                                                                                                                                                                                                                |
+| `paper/author-list`                                         | error | `paper.tex` → `_build/references.json`                   | an entry's authors are not those of the version it cites — typically the arXiv preprint's list under a published venue. Checked online by `paperlint build` (DBLP), reported on the entry's own line                                                                                                                                                                                                                                                          |
+| `paper/section-word`                                        | warn  | `paper.tex` and its body files, `paper.md`               | `§` or `\S\ref` instead of the word Section. **Fixable:** `--fix` writes `Section~\ref{…}` / `Section 5`                                                                                                                                                                                                                                                                                                                                                      |
+| `paper/leading-zero`                                        | warn  | `paper.tex` and its body files, `paper.md`               | a decimal below 1 without its leading zero (`.05` instead of `0.05`, IEEE / ISO 80000-1 style), counted only where the reader sees it — prose, math and table cells, not macro options, column specs, comments, code or tikz. A number right after `¶` or `§` (`¶¶.42`) is a paragraph designator and is not reported; in a paragraph that cites numbers that way, another bare decimal is reported without a fix, with the zero as a suggestion. **Fixable** |
+| `paper/figure-ref-style`                                    | warn  | `paper.tex` and its body files                           | `Fig.~\ref` and `Figure~\ref` mixed in one document; each minority occurrence is reported. **Fixable:** `--fix` writes the majority form                                                                                                                                                                                                                                                                                                                      |
+| `bib/reachable-entry`                                       | warn  | `paper.tex` (its `filecontents` bibliography)            | an entry has no doi, url or arXiv id — a reader has nothing to follow. Reported on the entry; no fix, the link has to be looked up                                                                                                                                                                                                                                                                                                                            |
+| `paper/cite-exists`                                         | error | `paper.tex` → `_build/references.json`                   | an entry's doi or arXiv id resolves to nothing, or to a different work. Checked online by `paperlint build`; a work that was merely not found is not a finding                                                                                                                                                                                                                                                                                                |
+| `paper/refs-fresh`                                          | error | `paper.tex` → `_build/references.json`                   | the bibliography changed since the build checked it (its SHA-256 differs) — run `npx paperlint build`                                                                                                                                                                                                                                                                                                                                                         |
+| `paper/refs-checked`                                        | warn  | `paper.tex` → `_build/references.json`                   | the paper has a bibliography and no build has checked it, or the last build could not (no network) — so the two rules above did not run                                                                                                                                                                                                                                                                                                                       |
+| `tex/future-promise`                                        | warn  | `paper.tex` and its body files                           | a camera-ready build still says "will be released" about something already handed over                                                                                                                                                                                                                                                                                                                                                                        |
+| `tex/acm-frontmatter-override`                              | error | `paper.tex`                                              | an `acmart` build overrides ACM's front-matter commands and drops template elements from page 1                                                                                                                                                                                                                                                                                                                                                               |
+| [`tex/template`](rules/tex/template.md)                     | error | `paper.tex` → `paperlint.json`                           | the `\documentclass` is not the preset's `template` class, or lacks an option it names — [page](rules/tex/template.md)                                                                                                                                                                                                                                                                                                                                        |
+| [`tex/required-section`](rules/tex/required-section.md)     | error | `paper.tex` → `paperlint.json`                           | a section the preset requires (AIDC: «LLM Usage Statement», last) is missing or not where it must be — [page](rules/tex/required-section.md)                                                                                                                                                                                                                                                                                                                  |
+| [`format/layout-override`](rules/format/layout-override.md) | error | `paper.tex` → `paperlint.json`                           | the source changes the page layout the venue's template sets for the whole document — `geometry`, a layout `\setlength`, `\linespread`, `\baselinestretch` — [page](rules/format/layout-override.md)                                                                                                                                                                                                                                                          |
+| [`anonymity/identity`](rules/anonymity/identity.md)         | error | `paper.tex` → `_build/paper.facts.json`                  | a double-blind venue (`"blind": true`) and no `identity` declared, or a declared name, handle, email or project in the PDF's text, metadata or link targets — [page](rules/anonymity/identity.md)                                                                                                                                                                                                                                                             |
+| [`tex/venue-leftover`](rules/tex/venue-leftover.md)         | warn  | `paper.tex` → `paperlint.json`                           | the text names another shipped venue than the one the paper extends («Submission to VenueA 2026» in a paper now set for VenueB) — [page](rules/tex/venue-leftover.md)                                                                                                                                                                                                                                                                                         |
+| [`tex/claim-provenance`](rules/tex/claim-provenance.md)     | warn  | `paper.tex`                                              | a sentence of the body states a number and does not say whose it is — no citation or link, no _we_/_our_, no `\ref` or "Table 2", no sample ("n = 134", "48 runs") — [page](rules/tex/claim-provenance.md)                                                                                                                                                                                                                                                    |
+| [`tex/register`](rules/tex/register.md)                     | warn  | `paper.tex` and the files it includes                    | the body runs to a post's register: more than 0.8 sentences per 1000 words open with _And_, _So_, _But_, _Nor_, _Or_ or _Yet_ — the limit is an option — [page](rules/tex/register.md)                                                                                                                                                                                                                                                                        |
+| [`tex/contrast-frames`](rules/tex/contrast-frames.md)       | warn  | `paper.tex` and the files it includes → `paperlint.json` | contrast frames (_X, not Y_, _not X but Y_, _rather than_, _instead of_, _as opposed to_) per 10,000 words fall outside the band the venue preset's anchors set (AIDC: 0–10.4, from five accepted ACSAC papers); above it, each frame is reported too — [page](rules/tex/contrast-frames.md)                                                                                                                                                                  |
+| [`tex/claim-emphasis`](rules/tex/claim-emphasis.md)         | warn  | `paper.tex` and the files it includes → `paperlint.json` | claims set in bold inside a sentence (six words or more, or holding a number; not a term, not a label opening a paragraph) per 10,000 words fall outside the preset's band (AIDC: 0–17.8); above it, each is reported too — [page](rules/tex/claim-emphasis.md)                                                                                                                                                                                               |
+| [`tex/relation-markers`](rules/tex/relation-markers.md)     | warn  | `paper.tex` and the files it includes → `paperlint.json` | words that name how a sentence relates to the one before (_because_, _therefore_, _however_, _for example_ …) per 10,000 words fall outside the preset's band (AIDC: 25.4–135.0) — the floor that catches relations left to infer — [page](rules/tex/relation-markers.md)                                                                                                                                                                                     |
+| `review/frontmatter`                                        | error | `reviews/*.md`                                           | the review's frontmatter fails paperlint's JSON Schema — a `findings` record without `id`/`status`, an unknown field, or an **open** finding with no `cause` (`skill-defect` · `missing-skill` · `hook` · `rule`). A review with no `findings` key is not checked for findings                                                                                                                                                                                |
+| `sibling/frontmatter`                                       | warn  | `siblings/*.md` (not `README.md`)                        | a sibling card's frontmatter has no `read:` saying how much of the competing paper was read (`full` · `abstract` · `none`)                                                                                                                                                                                                                                                                                                                                    |
+| `pdf/fresh`                                                 | error | `paper.tex` → `_build/paper.facts.json`                  | the paper names a venue and the facts cannot be judged: not JSON, a schema other than 3, or they describe a PDF that is gone or differs from the one on disk (its SHA-256)                                                                                                                                                                                                                                                                                    |
+| `pdf/profile`                                               | error | `paper.tex` → `paperlint.json`                           | `paperlint.json` is not JSON or has an unknown key, its `extends` does not resolve (not found, a cycle, a chain longer than four, a preset that fails the schema, an npm name), it names no `kind` while the preset has kinds, or names a kind the preset does not have                                                                                                                                                                                       |
+| `pdf/fonts`                                                 | error | `paper.tex` → `_build/paper.facts.json`                  | a font the pages draw is Type 3 or not embedded, or no font starts with the family the venue preset names for body text (`fonts_text`) or headings (`fonts_title`)                                                                                                                                                                                                                                                                                            |
+| `pdf/geometry`                                              | error | `paper.tex` → `_build/paper.facts.json`                  | the page width or height is more than `dimTol` (default 0.05 in) off the preset's, or the column count differs                                                                                                                                                                                                                                                                                                                                                |
+| [`format/page-limit`](rules/format/page-limit.md)           | error | `paper.tex` → `_build/paper.facts.json`                  | body or reference pages exceed the limits of the paper's kind. With `body_ends_at: "references"` (AIDC) the body ends at the references or the appendix, whichever comes first — found by hyperref's anchors, then the heading line — and the page it ends on counts when body text stands above the heading; an end it cannot find, or signals that disagree, are reported — [page](rules/format/page-limit.md)                                              |
+| [`pdf/body-size`](rules/pdf/body-size.md)                   | error | `paper.tex` → `_build/paper.facts.json`                  | the body font size is more than `body_pt_tol` off the preset's, or the reference font size is outside the preset's range widened by `body_pt_tol`. banal reads 0.3 pt above the size the glyphs are set in; checked on five built accepted papers (none reported) and three variants one size off (each reported) — [page](rules/pdf/body-size.md)                                                                                                            |
+| `pdf/measured`                                              | warn  | `paper.tex` → `_build/paper.facts.json`                  | the paper's `paperlint.json` names no venue preset yet; or it names one and there are no facts (it was not built), or the facts carry no page geometry (banal was not found) — so the checks above did not run                                                                                                                                                                                                                                                |
+| [`talk/profile`](rules/talk/profile.md)                     | error | `paper.tex` → `paperlint.json`                           | the paper declares `talk` and names no preset, the preset has no `talk` block, the mode is not one the venue allows, or the venue sets no talk slot for the paper's kind — [page](rules/talk/profile.md)                                                                                                                                                                                                                                                      |
+| [`talk/required-files`](rules/talk/required-files.md)       | error | `paper.tex` → `paperlint.json`, the talk folder          | a file the venue requires for the paper's talk mode (video, one-slide, captions…) is not in the talk folder — [page](rules/talk/required-files.md)                                                                                                                                                                                                                                                                                                            |
+| [`talk/undeclared`](rules/talk/undeclared.md)               | warn  | `paper.tex` → the paper's `talk/` folder                 | an `.mp4` sits in `talk/` and the paper declares no `talk`, so nothing checks it — [page](rules/talk/undeclared.md)                                                                                                                                                                                                                                                                                                                                           |
+| [`talk/duration`](rules/talk/duration.md)                   | error | `paper.tex` → the talk video                             | the video runs longer than the slot's `talk_s_max`, or its audio track is more than 1 s off the video's length — [page](rules/talk/duration.md)                                                                                                                                                                                                                                                                                                               |
+| [`talk/duration-floor`](rules/talk/duration-floor.md)       | warn  | `paper.tex` → the talk video                             | the video runs shorter than the slot's `talk_s_min` — [page](rules/talk/duration-floor.md)                                                                                                                                                                                                                                                                                                                                                                    |
+| [`talk/video-format`](rules/talk/video-format.md)           | error | `paper.tex` → the talk video                             | the video is not ISO media, is QuickTime where the venue asks for MP4, is under `min_height_px`, or over `max_bytes` — [page](rules/talk/video-format.md)                                                                                                                                                                                                                                                                                                     |
+| [`talk/one-slide-size`](rules/talk/one-slide-size.md)       | error | `paper.tex` → the one-slide PNG                          | the one-slide image is not the size the paper or the preset states, or not a PNG — [page](rules/talk/one-slide-size.md)                                                                                                                                                                                                                                                                                                                                       |
+| [`talk/captions-cover`](rules/talk/captions-cover.md)       | warn  | `paper.tex` → the captions and the video                 | the captions start late, end early or leave a long gap (uncalibrated thresholds) — [page](rules/talk/captions-cover.md)                                                                                                                                                                                                                                                                                                                                       |
 
 **Body files** are the files `paper.tex` includes from its document body (`\input`, `\include`,
 `\subfile`, nested ones too), found in the paper's directory — not a preamble include, not a file
@@ -45,6 +56,9 @@ that names no file is printed as a note: lint did not read it, and the build wil
 LLMs are used», which no rule can know; an author who used none says so in the section
 ([page](rules/tex/required-section.md)).
 
+The `talk/*` rules judge a talk's finished files and are silent for a paper that declares no
+`talk` (but `talk/undeclared`): [`talk.md`](talk.md).
+
 Optional rules — off unless you turn them on in the `rules` setting, because only some venues need
 them — are on their own page: [`optional-rules.md`](optional-rules.md). Today there is one,
 `pdf/last-page-balance`.
@@ -202,21 +216,22 @@ papers/
 
 The numbers and packages above illustrate the shape; take yours from the venue's own call for papers and template.
 
-| key                 | what it is                                                                                                                                                                                                              |
-| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `extends`           | the preset this one builds on: `paperlint:<name>` or `./path` / `../path`, relative to this file                                                                                                                        |
-| `name`              | how messages name the venue; the file name otherwise                                                                                                                                                                    |
-| `template`          | the `\documentclass` the venue's template uses — a whole line (`\documentclass[conference,compsoc]{IEEEtran}`) or a bare class name; `tex/template` requires the paper's class and every option named here              |
-| `aliases`           | other names the venue goes by in a paper's text — its acronym, its parent conference: `["AISec", "ACM CCS"]`. Collected along `extends`, with `name`. Read by `tex/venue-leftover`                                      |
-| `blind`             | the venue reviews double-blind — set only where its call says so, with the quote. Turns on `anonymity/identity`; a child's value replaces its parent's                                                                  |
-| `required_sections` | sections the venue requires, `[{ "title": "LLM Usage Statement", "position": "last" }]`: the exact title, and `last` when it must close the paper. Read by `tex/required-section`; a child's list replaces its parent's |
-| `format`            | page size, columns, fonts, font sizes, and `kinds` (page limits per kind of paper)                                                                                                                                      |
-| `tex`               | TeX Live packages, each with the files that prove it is installed. Required unless `extends` is set                                                                                                                     |
-| `rules`             | rules the venue implies, rule id → severity or `[severity, options]`                                                                                                                                                    |
+| key                 | what it is                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `extends`           | the preset this one builds on: `paperlint:<name>` or `./path` / `../path`, relative to this file                                                                                                                                                                                                                                                                                                                                                                   |
+| `name`              | how messages name the venue; the file name otherwise                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `template`          | the `\documentclass` the venue's template uses — a whole line (`\documentclass[conference,compsoc]{IEEEtran}`) or a bare class name; `tex/template` requires the paper's class and every option named here                                                                                                                                                                                                                                                         |
+| `aliases`           | other names the venue goes by in a paper's text — its acronym, its parent conference: `["AISec", "ACM CCS"]`. Collected along `extends`, with `name`. Read by `tex/venue-leftover`                                                                                                                                                                                                                                                                                 |
+| `blind`             | the venue reviews double-blind — set only where its call says so, with the quote. Turns on `anonymity/identity`; a child's value replaces its parent's                                                                                                                                                                                                                                                                                                             |
+| `required_sections` | sections the venue requires, `[{ "title": "LLM Usage Statement", "position": "last" }]`: the exact title, and `last` when it must close the paper. Read by `tex/required-section`; a child's list replaces its parent's                                                                                                                                                                                                                                            |
+| `format`            | page size, columns, fonts, font sizes, and `kinds` (page limits per kind of paper)                                                                                                                                                                                                                                                                                                                                                                                 |
+| `tex`               | TeX Live packages, each with the files that prove it is installed. Required unless `extends` is set                                                                                                                                                                                                                                                                                                                                                                |
+| `rules`             | rules the venue implies, rule id → severity or `[severity, options]`                                                                                                                                                                                                                                                                                                                                                                                               |
+| `register`          | `{ "anchors": [{ "paper", "words", "contrast_frames", "claim_emphasis", "relation_markers" }] }`: accepted papers of the venue (or its parent conference) as the register rules count them. Each measure's band is the anchors' range widened by two Poisson standard deviations — [page](rules/tex/contrast-frames.md#options--preset-fields). Read by `tex/contrast-frames`, `tex/claim-emphasis`, `tex/relation-markers`; a child's block replaces its parent's |
 
 How a chain merges, from the root preset to the paper: `tex` is the union — a child never removes a
 package; `format` keys are replaced one by one, and a child's kind replaces that kind whole;
-`rules` are replaced rule by rule, and the paper's own `rules` come last. A chain is at most four
+`rules` are replaced rule by rule, and the paper's own `rules` come last; `register` is replaced whole. A chain is at most four
 presets long, and a cycle is refused by name. `paperlint toolchain` installs the packages of every
 shipped preset and of every preset your papers extend.
 

package/docs/talk.md

@@ -0,0 +1,94 @@
+# The talk
+
+A venue that accepts a paper usually asks for a talk too: a video for a remote presenter, a
+one-slide image, sometimes captions. paperlint does not make the talk. It **judges the finished
+files** against what the venue asks, so the same check works whether the video came from Keynote,
+OBS, Zoom, a script, or by hand.
+
+## Declaring a talk
+
+The paper's own `paperlint.json` says how it is presented:
+
+```json
+{
+  "extends": "paperlint:agenticdev",
+  "kind": "short",
+  "talk": { "mode": "remote-video" }
+}
+```
+
+| key         | meaning                                                                                      | default   |
+| ----------- | -------------------------------------------------------------------------------------------- | --------- |
+| `mode`      | `remote-video`, `remote-live` or `in-person` — must be one the venue allows                  | required  |
+| `dir`       | the talk folder, relative to the paper                                                       | `talk`    |
+| `files`     | the file name of each artifact in that folder, when it is not the default (no slashes)       | see below |
+| `one_slide` | `{ "width_px": 1920, "height_px": 1080 }` — the one-slide's size, when the venue states none | none      |
+
+`talk` is a paper's setting: the root `paperlint.json` refuses it.
+
+**File names.** Each artifact is looked for under one name in the talk folder:
+
+| artifact     | default name    |
+| ------------ | --------------- |
+| `video`      | `talk.mp4`      |
+| `one-slide`  | `one-slide.png` |
+| `captions`   | `talk.srt`      |
+| `slides-pdf` | `slides.pdf`    |
+| `poster`     | `poster.pdf`    |
+
+A video named after the paper is declared once:
+
+```json
+"talk": {
+  "mode": "remote-video",
+  "files": { "video": "agenticdev-2026-talk.mp4", "captions": "agenticdev-2026-talk.srt" }
+}
+```
+
+## What the venue says — the preset's `talk` block
+
+```jsonc
+"talk": {
+  "modes": ["remote-video"],
+  "artifacts": { "remote-video": { "required": ["video", "one-slide"], "optional": ["poster"] } },
+  "kinds": { "short": { "slot_s": 600, "talk_s_min": 360, "talk_s_max": 420, "qa_s": 210 } },
+  "video": { "container": "mp4", "min_height_px": 720, "max_bytes": 500000000, "captions": "optional" },
+  "one_slide": { "width_px": 1920, "height_px": 1080 }
+}
+```
+
+Every key is optional. Durations are seconds. `kinds` uses the names of `format.kinds`, and the
+paper's `kind` picks one. `video.captions: "required"` adds the captions to the files the video's
+mode owes. A child preset's `talk` block replaces its parent's whole. The shipped `agenticdev`
+preset carries the organizers' numbers, each quoted beside it; it states no one-slide size, because
+the venue did not.
+
+## What is checked
+
+All rules run on the paper's `paper.tex` and are silent for a paper that declares no `talk`, except
+`talk/undeclared`.
+
+| rule                                                  | level | fails when                                                                                      |
+| ----------------------------------------------------- | ----- | ----------------------------------------------------------------------------------------------- |
+| [`talk/profile`](rules/talk/profile.md)               | error | no preset, a preset with no `talk` block, a mode the venue does not allow, no slot for the kind |
+| [`talk/required-files`](rules/talk/required-files.md) | error | a file the venue requires for the mode is not in the talk folder                                |
+| [`talk/undeclared`](rules/talk/undeclared.md)         | warn  | an `.mp4` sits in `talk/` and the paper declares no `talk`                                      |
+| [`talk/duration`](rules/talk/duration.md)             | error | the video runs longer than `talk_s_max`, or its audio track is more than 1 s off its length     |
+| [`talk/duration-floor`](rules/talk/duration-floor.md) | warn  | the video runs shorter than `talk_s_min`                                                        |
+| [`talk/video-format`](rules/talk/video-format.md)     | error | not an MP4 (QuickTime inside, or not ISO media at all), under `min_height_px`, over `max_bytes` |
+| [`talk/one-slide-size`](rules/talk/one-slide-size.md) | error | the one-slide PNG is not the declared size                                                      |
+| [`talk/captions-cover`](rules/talk/captions-cover.md) | warn  | the captions start late, end early, or leave a long gap (thresholds uncalibrated)               |
+
+The video is read with [MP4Box.js](https://github.com/gpac/mp4box.js) — the container's own
+headers, in JavaScript, in milliseconds. There is no ffmpeg anywhere in paperlint and no build step
+for the talk.
+
+## What is not checked
+
+- **What the talk says.** Whether the video matches the paper, its tone, its claims, the QR code on
+  a slide — those need a reader, not a count.
+- **How it was made.** A script, slides, a voice recording, cut points: paperlint never sees them,
+  and nothing here requires them to exist.
+- **Deadlines and upload channels.** A deadline is a clock condition; it belongs in a calendar.
+- **Whether the file was sent.** Freezing what was sent is not part of the talk rules yet.
+- **Codecs, frame rate, bitrate, loudness.** Only the container, the height and the byte size.

package/fixtures/talk/talk.srt

@@ -0,0 +1,7 @@
+1
+00:00:00,000 --> 00:00:01,200
+A synthetic caption for a three-second tone.
+
+2
+00:00:01,400 --> 00:00:02,900
+It carries no voice.

package/lib/paper-config.harness.mjs

@@ -200,11 +200,14 @@ const loaded = await Promise.all(
 // refuses any key not in SETTINGS_KEYS. So the list must hold every key some reader reads — or a
 // consumer's valid key is refused — and nothing no one reads. The readers are FOUND, by the AST:
 // every `settingsOf(root)?.<key>` (and the older `[CONFIG_KEY]?.<key>` shape), plus every field of
-// `PaperlintConfig`, the CLI's typed view of the same object.
+// `PaperlintConfig` and `PaperSettings`, the typed views of the root's and a paper's object.
 {
   const { SETTINGS_KEYS } = await import(join(HERE, "paper-config.ts"));
   const ts = (await import("typescript")).default;
   const readKeys = new Set();
+  // The two typed views of the object: the root file's (`PaperlintConfig`, cli.ts) and a paper's
+  // (`PaperSettings`, src/paper-settings.ts). A key only a paper may hold (`talk`) is read there.
+  const TYPED_VIEWS = ["PaperlintConfig", "PaperSettings"];
   const isConfigKey = (e) =>
     (ts.isIdentifier(e) && e.text === "CONFIG_KEY") ||
     (ts.isStringLiteral(e) && e.text === "paperlint");
@@ -217,7 +220,7 @@ const loaded = await Promise.all(
   const visit = (node) => {
     if (ts.isPropertyAccessExpression(node) && isSettings(node.expression))
       readKeys.add(node.name.text);
-    if (ts.isInterfaceDeclaration(node) && node.name.text === "PaperlintConfig")
+    if (ts.isInterfaceDeclaration(node) && TYPED_VIEWS.includes(node.name.text))
       for (const m of node.members)
         if (m.name && ts.isIdentifier(m.name)) readKeys.add(m.name.text);
     ts.forEachChild(node, visit);

package/lib/paper-config.ts

@@ -140,6 +140,7 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
   pdf: "where the built PDF is, relative to the paper, when it is not paper.pdf — the facts",
   identity:
     "what identifies the authors — names, handles, emails, affiliations, own project names; a blind venue's PDF must not say any of them — anonymity/identity. The root's list and a paper's are joined",
+  talk: 'how this paper is presented: { "mode": "remote-video", "dir"?, "files"?, "one_slide"? } — the talk/ rules. A paper\'s own; refused in the root file',
   scripts: "how skill prose names the scripts — consumer.mjs",
   timezone: "the zone deadline anchors are written in — consumer.mjs",
   contactEmail: "the polite-pool address for citation lookups — consumer.mjs",
@@ -148,6 +149,9 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
   $comment: "a note for humans (JSON Schema's own comment keyword); ignored",
 });
 
+/** The keys that only mean something for one paper: refused in the root `paperlint.json`. */
+export const PAPER_ONLY_KEYS: readonly string[] = Object.freeze(["talk"]);
+
 /** The keys that only mean something for the whole project: refused in a paper's `paperlint.json`. */
 export const ROOT_ONLY_KEYS: readonly string[] = Object.freeze([
   "papersDir",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperlint",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "description": "A linter for scientific papers written in LaTeX: catches mistakes before you submit to a conference or journal.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,9 @@
     "eslint": "^10.9.1",
     "js-yaml": "^4.1.0",
     "markdown-it": "^14.3.0",
+    "mp4box": "^2.4.1",
     "remeda": "^2.50.0",
+    "srt-parser-2": "^1.2.3",
     "ts-essentials": "^10.2.1",
     "typescript": "^6.0.3",
     "unpdf": "^1.8.1",

package/presets/agenticdev.jsonc

@@ -31,6 +31,35 @@
     },
   },
 
+  // The talk (talk/* rules), for a paper whose paperlint.json declares `talk`. The numbers are the
+  // organizers', each with its source; one_slide is left out on purpose — the venue never stated a
+  // size, so a paper that wants its own checked declares it in its own `talk` key.
+  "talk": {
+    // AgenticDev adopted ASE's «not in person presentation» policy (co-chairs, 2026-08-27).
+    "modes": ["remote-video"],
+    "artifacts": {
+      // «a presentation video … a one-slide presentation … and optionally a poster»
+      "remote-video": {
+        "required": ["video", "one-slide"],
+        "optional": ["poster"],
+      },
+    },
+    "kinds": {
+      // «short paper = 10 min: 6–7 min talk + 3–4 min questions» (co-chairs, 2026-09-29).
+      // qa_s is the middle of 3–4 min; it is informational and not judged. The full-paper slot
+      // was not in the email, so `full` and `demo` have no entry and talk/profile says so.
+      "short": {
+        "slot_s": 600,
+        "talk_s_min": 360,
+        "talk_s_max": 420,
+        "qa_s": 210,
+      },
+    },
+    // ASE 2026's not-in-person page: «recommendation: 10 min duration, mp4 file format, HD
+    // resolution» — the parent conference's recommendation; the workshop's own slot is above.
+    "video": { "container": "mp4", "min_height_px": 720 },
+  },
+
   // The proceedings are produced by Conference Publishing Consulting — agenticdev.md takes its
   // numbers from their author instructions — which require "balanced columns on the last page, if
   // the page is not filled" and sent an accepted camera-ready back for it on 2026-08-29, the day

package/presets/aidc.jsonc

@@ -43,6 +43,56 @@
   // for) is not a section with this title and does not count.
   "required_sections": [{ "title": "LLM Usage Statement", "position": "last" }],
 
+  // THE REGISTER OF THE BODY IS JUDGED AGAINST ACSAC, AIDC'S PARENT CONFERENCE: AIDC 2026 is the
+  // workshop's first edition, so it has no accepted papers yet, and it uses ACSAC's template. The
+  // anchors are the five accepted ACSAC papers in fixtures/accepted-papers/, measured by paperlint's
+  // own counters on their LaTeX source (tex/contrast-frames, tex/claim-emphasis, tex/relation-markers).
+  // src/register-bands.test.ts re-measures every anchor that has a fixture and requires these exact
+  // numbers, so a change to a counter changes this list in the same commit. The bands they set, per
+  // 10,000 words (the anchors' range, widened by two Poisson standard deviations at each end):
+  //   contrast frames   anchors 1.3–5.5     band 0–10.4
+  //   claims in bold    anchors 0.0–10.4    band 0–17.8
+  //   relation markers  anchors 39.4–112.8  band 25.4–135.0
+  "register": {
+    "anchors": [
+      {
+        "paper": "barovox-acsac24",
+        "words": 7670,
+        "contrast_frames": 1,
+        "claim_emphasis": 8,
+        "relation_markers": 31,
+      },
+      {
+        "paper": "leaking-queries-acsac25",
+        "words": 9133,
+        "contrast_frames": 5,
+        "claim_emphasis": 0,
+        "relation_markers": 103,
+      },
+      {
+        "paper": "llm-splained-acsac25",
+        "words": 9529,
+        "contrast_frames": 4,
+        "claim_emphasis": 1,
+        "relation_markers": 84,
+      },
+      {
+        "paper": "rr-dataset-quality-acsac24",
+        "words": 8130,
+        "contrast_frames": 3,
+        "claim_emphasis": 0,
+        "relation_markers": 32,
+      },
+      {
+        "paper": "secure-acsac24",
+        "words": 7519,
+        "contrast_frames": 3,
+        "claim_emphasis": 0,
+        "relation_markers": 38,
+      },
+    ],
+  },
+
   "format": {
     // \textwidth and \textheight of [conference,compsoc], measured (ieee-conference.jsonc).
     "textblock_w_in": 7.0,