paperlint 6.2.3 → 6.3.0

package/docs/rules/paper/folder-venue-leftover.md

@@ -0,0 +1,104 @@
+# paper/folder-venue-leftover
+
+**Level:** warn · **Reads:** the paper folder's name, its `paperlint.json`, and the shipped venue
+presets · **Reported on:** the first line of the paper's `PIPELINE-STATUS.md`
+
+## What it catches
+
+The paper's folder is named after a venue other than the one its `paperlint.json` extends. Usually
+the folder was named for the first venue the paper went to, and the paper has since been retargeted:
+`papers/aisec-2026/` holding a paper that now extends `paperlint:aidc`.
+
+The folder name is read as words: runs of letters and runs of digits, split on everything else, case
+ignored. `aisec-2026`, `aisec_2026` and `aisec2026` all name AISec; `overrealm` and `realms` do not
+name REALM. A venue name of several words (`ACM CCS`) counts only when its words stand in a row.
+
+The venue names come from the preset registry: every shipped preset's label (`aisec`) and its `name`
+and `aliases` (`AISec`, `ACM CCS`), collected along `extends` — the same names `tex/venue-leftover`
+looks for in the text. A venue with no shipped preset is not recognized.
+
+## Why
+
+Venues change on resubmission: a workshop paper that is rejected goes to the next workshop, and a
+venue can be cancelled. The folder name does not change with it, and a folder named after the old
+venue tells everyone who opens the repository — a co-author, a script, an agent — which venue the
+paper is for, wrongly. The venue is already declared once, in `paperlint.json`; a second, stale
+copy of it in the path is the one that misleads.
+
+A name that describes the work (`agent-rule-drift`, `harness-misconfig`) stays right whichever venue
+the paper goes to.
+
+## Examples
+
+Failing — a paper whose `paperlint.json` is `{ "extends": "paperlint:aidc", "kind": "regular" }`,
+in `papers/aisec-2026/`:
+
+```text
+papers/aisec-2026/PIPELINE-STATUS.md
+  1:1  warning  the folder name «aisec-2026» names the venue aisec, and this paper extends aidc — the
+                name went stale when the venue changed, and venues change on every resubmission. Name
+                the folder after the work (what the paper shows), not the venue
+                paper/folder-venue-leftover
+```
+
+Named by an alias, the message says which: `papers/acm-ccs-agents/` under `paperlint:aidc` names
+`aisec («ACM CCS»)`.
+
+Passing:
+
+- `papers/agent-rule-drift/` — names no venue;
+- `papers/aidc-2026/` or `papers/acsac-2026/` under `paperlint:aidc` — the paper's own venue, by its
+  label or its alias;
+- `papers/overrealm-study/` — `realm` inside another word is that other word;
+- any folder whose `paperlint.json` has no `extends` yet, or none at all;
+- `papers/secure-acsac24/` under `paperlint:ieee-conference` — a bare template family names no venue.
+
+## Options / preset fields
+
+No rule options. It reads each shipped preset's `name` and `aliases`, the fields
+`tex/venue-leftover` reads too:
+
+```jsonc
+"aliases": ["AISec", "ACM CCS"]
+```
+
+A name the paper's own chain also declares (two workshops of one parent conference) is never
+reported.
+
+## What it does not check
+
+- A venue no shipped preset describes — including one that was cancelled and has no preset.
+- A folder named after the paper's own venue. It is right today and goes stale on the next
+  resubmission, so `paperlint new` refuses to create such a folder at all (unless given
+  `--allow-venue-name`); this rule is the backstop for folders made by hand, with that flag, or
+  before the refusal, and reports only the name that is already wrong.
+- A paper whose `extends` is unset or does not resolve: with no venue there is nothing to compare,
+  and `pdf/measured` or `pdf/profile` already speaks.
+- A paper whose `extends` names only a template family (`paperlint:acm-sigconf`,
+  `paperlint:ieee-conference` — a preset with no kinds). It declares a format, not a venue, so a venue
+  in its folder name may well be its own: the accepted ACSAC papers this rule is checked on live in
+  `…-acsac24` folders and extend `ieee-conference`, while ACSAC is an alias of `aidc`.
+
+## How to fix
+
+Rename the folder after the work, and update whatever names the path (a CI matrix, a link in a
+README):
+
+```sh
+git mv papers/aisec-2026 papers/agent-rule-drift
+```
+
+A folder that should keep its name — a team convention, links you cannot change — turns the rule off
+in that paper's `paperlint.json`, beside the `extends` it compares with:
+
+```json
+{
+  "extends": "paperlint:aidc",
+  "kind": "regular",
+  "rules": { "paper/folder-venue-leftover": "off" }
+}
+```
+
+A disable comment in `PIPELINE-STATUS.md` does not work here: the finding is on the file's first
+line, the frontmatter's `---`, and a directive below the frontmatter comes after it, so ESLint
+reports the directive as unused and the finding stays.

package/docs/rules/talk/captions-cover.md

@@ -24,7 +24,7 @@ can see.
 
 Warning — the AgenticDev talk's last cue ends 4.2 s before the video:
 
-> papers/agenticdev-2026/talk/agenticdev-2026-talk.srt: the last caption ends at 5:16.6 (316.6 s),
+> papers/rule-drift/talk/rule-drift-talk.srt: the last caption ends at 5:16.6 (316.6 s),
 > and the video runs 5:20.8 (320.84 s) — more than 2 s uncaptioned at the end
 
 Passing: cues from 0 s to within 2 s of the end, no silence between cues over 5 s.

package/docs/rules/talk/duration-floor.md

@@ -18,7 +18,7 @@ an error, without touching the ceiling.
 
 Warning — the AgenticDev talk measured 320.84 s against the organizers' 6–7 minutes:
 
-> papers/agenticdev-2026/talk/agenticdev-2026-talk.mp4 runs 5:20.8 (320.84 s), under the 6:00.0
+> papers/rule-drift/talk/rule-drift-talk.mp4 runs 5:20.8 (320.84 s), under the 6:00.0
 > (360 s) talk agenticdev asks for a short paper — decide whether that is fine, or set this rule to
 > off for the paper
 

package/docs/rules.md

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

package/docs/skills.md

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

package/docs/submission.md

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

package/docs/talk.md

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

package/lib/paper-config.ts

@@ -141,6 +141,8 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
   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',
+  submission:
+    "which submission on the venue's portal is this paper's: { \"id\": <number> } — paperlint submission, with the preset's \"portal\". 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",
@@ -150,7 +152,10 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
 });
 
 /** 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"]);
+export const PAPER_ONLY_KEYS: readonly string[] = Object.freeze([
+  "talk",
+  "submission",
+]);
 
 /** 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([

package/lib/skill-checks.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Types for `skill-checks.mjs`, for the TypeScript tests that call it. Only what they call is
+ * declared; the module stays JavaScript.
+ */
+
+/** The shared per-skill checks for `skills/<name>/SKILL.md`; rejects naming every failure. */
+export function checkSkill(name: string): Promise<void>;

package/lib/skill-trigger-cases.mjs

@@ -304,6 +304,17 @@ const PACKAGE_CASES = [
     ],
     collides: ["submit-paper"],
   },
+  {
+    skill: "submission-portal",
+    why: "READ or CHANGE the submission on the HotCRP portal over its API, and prove the portal holds the latest build",
+    prompts: [
+      "replace the PDF on hotcrp with the new build",
+      "проверь, что статья на hotcrp правда в статусе Submitted",
+      "залей новый абстракт и пдф в hotcrp, дедлайн через час",
+      "какую версию pdf увидят рецензенты — ту, что я собрал сейчас?",
+    ],
+    collides: ["submit-paper", "osf-artifact-upload"],
+  },
   {
     skill: "paper-pipeline",
     why: "DRIVE the whole lifecycle — the conductor, when the ask is the whole arc not one step",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperlint",
-  "version": "6.2.3",
+  "version": "6.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",
@@ -33,7 +33,7 @@
     "ts-essentials": "^10.2.1",
     "typescript": "^6.0.3",
     "unpdf": "^1.8.1",
-    "vigiles": "^31.0.1",
+    "vigiles": "^32.1.0",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/presets/aidc.jsonc

@@ -26,6 +26,12 @@
   // `"blind":true` in the portal's data. anonymity/identity then requires the paper's `identity`.
   "blind": true,
 
+  // Where submissions go: the HotCRP site named in the deadline note above. `paperlint submission`
+  // reads and updates a paper's submission there through HotCRP's API (`/api/paper`). Recorded
+  // 2026-10-03: `/api/whoami` on this site answers 401 "Missing credentials" without a token —
+  // the HotCRP API, there.
+  "portal": { "kind": "hotcrp", "url": "https://aidc.submit.acsac.org" },
+
   // What the venue is called in a paper's text (tex/venue-leftover): the workshop, and the
   // conference it is held at.
   "aliases": ["AIDC", "ACSAC"],

package/presets/venue-profile.schema.json

@@ -29,7 +29,7 @@
       "type": "boolean"
     },
     "aliases": {
-      "description": "Other names the venue goes by in a paper's text — its acronym, its parent conference (`[\"AISec\", \"ACM CCS\"]`). Read by `tex/venue-leftover`: a paper that extends another venue and says one of these is flagged. Matched as whole words, case-sensitive. Collected along the `extends` chain, with `name`.",
+      "description": "Other names the venue goes by in a paper's text — its acronym, its parent conference (`[\"AISec\", \"ACM CCS\"]`). Read by `tex/venue-leftover`: a paper that extends another venue and says one of these is flagged. Matched as whole words, case-sensitive. Also read by `paper/folder-venue-leftover`, against the words of the paper's folder name, case ignored. Collected along the `extends` chain, with `name`.",
       "type": "array",
       "uniqueItems": true,
       "items": {
@@ -37,6 +37,22 @@
         "minLength": 1
       }
     },
+    "portal": {
+      "description": "Where the venue takes submissions, read by `paperlint submission`: the portal's kind (an adapter exists for `hotcrp`) and the site's base URL, the one its pages and `/api/` hang off. A paper says which submission is its own with `submission: { id }` in its paperlint.json. A child's value replaces its parent's.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "url"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "minLength": 1
+        },
+        "url": {
+          "type": "string",
+          "pattern": "^https?://[^\\s/]+[^\\s]*$"
+        }
+      }
+    },
     "required_sections": {
       "description": "Sections the venue requires, read by `tex/required-section`. Each is a `\\section` or `\\section*` whose title equals `title` once whitespace is collapsed. `position: \"last\"`: after every section of the body (the ones before the appendix and the bibliography); it may stand after the bibliography. A child preset's list replaces its parent's.",
       "type": "array",

package/skills/paper-pipeline/paper-pipeline.harness.mjs

@@ -94,6 +94,10 @@ const NOT_IN_MAP = new Map([
     "osf-artifact-upload",
     "a helper that uploads an artifact file, not a stage of writing a paper",
   ],
+  [
+    "submission-portal",
+    "a helper that reads and updates the submission on the portal, reached through `submit-paper`",
+  ],
 ]);
 
 for (const name of dirs) {