paperlint 2.0.0 → 2.1.0

package/fixtures/pdf-facts/README.md

@@ -14,7 +14,7 @@ poppler's numbers, so a pass means agreement with the tool pdf.js replaced.
 | `hidden-text.pdf`  | `hidden-text.tex`, pdflatex                                         | two-column body text beside near-white, rotated and render-mode-3 text; page 2 holds only hidden text, so banal calls it blank    |
 
 `test/e2e/banal.mjs` also reads these files, with the real banal: it pins what banal 1.2 printed for
-each one on poppler's `pdftohtml` 24.02.0 (2026-09-25), so a pass there means rpp's pdf.js-written
+each one on poppler's `pdftohtml` 24.02.0 (2026-09-25), so a pass there means paperlint's pdf.js-written
 XML measures the same as poppler's. `hidden-text.pdf` exists for that test: each kind of hidden text
 changes banal's answer if it is counted.
 

package/fixtures/real-markdown-paper/baseline.json

@@ -9,7 +9,7 @@
     "",
     "Recorded 2026-09-19. Three of the five are about the scorecard being deliberately thin",
     "(no pdf, no frozen source) rather than about the prose; paper/typography's single entry is",
-    "the 18 p-values of rpp#44. They are real findings against IEEE / ISO 80000-1 style, which",
+    "the 18 p-values of paperlint#44. They are real findings against IEEE / ISO 80000-1 style, which",
     "requires the leading zero, in a blog post written for a general audience rather than for an",
     "IEEE venue. All 18 sit in prose and table cells, so the count from the parsed tree keeps them.",
     "The count is expected to stay. A drop is never a failure here, only growth is."

package/fixtures/real-markdown-paper/baseline.mjs

@@ -1,6 +1,6 @@
 /**
  * ONE reader of `baseline.json`, shared by the two runs that compare against it: the harness
- * beside this file (the repository's own `bin/rpp.mjs`) and `test/e2e/install.mjs` (the binary
+ * beside this file (the repository's own `bin/paperlint.mjs`) and `test/e2e/install.mjs` (the binary
  * a consumer actually got). Two copies of "growth fails, a drop never does" would drift the first
  * time one of them is tightened, and the two runs would then disagree about the same article.
  */
@@ -34,7 +34,7 @@ export function countByRule(stdout) {
  *              otherwise. Always a failure.
  *   vanished — a recorded rule went fully quiet without the recording being updated: how a check
  *              dies unnoticed. Also a failure.
- * A partial drop is neither: it is what a fix looks like (rpp#44 is expected to take typography
+ * A partial drop is neither: it is what a fix looks like (paperlint#44 is expected to take typography
  * to zero, and then the recording is updated in the same change).
  */
 export function compareToBaseline(found, recorded = recordedFindings()) {

package/fixtures/toolchain-mirror/install-tl

@@ -1,7 +1,7 @@
 #!/bin/sh
-# STANDS IN FOR install-tl in src/toolchain.harness.mjs. It reads TEXDIR from the profile rpp
+# STANDS IN FOR install-tl in src/toolchain.harness.mjs. It reads TEXDIR from the profile paperlint
 # wrote and lays out a tree whose kpsewhich and tlmgr are the stubs shipped beside it, so the
-# harness drives rpp's real download, unpack, install and verify logic without the network.
+# harness drives paperlint's real download, unpack, install and verify logic without the network.
 set -eu
 here=$(cd "$(dirname "$0")" && pwd)
 profile=""

package/fixtures/toolchain-mirror/stub-pdflatex

@@ -1,3 +1,3 @@
 #!/bin/sh
-# Only its presence matters: rpp finds a tree by the pdflatex in its bin directory.
+# Only its presence matters: paperlint finds a tree by the pdflatex in its bin directory.
 exit 0

package/fixtures/toolchain-mirror/stub-tlmgr

@@ -1,7 +1,7 @@
 #!/bin/sh
 # Answers like tlmgr install: each package is looked up in the repository's catalog.txt
 # ("name file…", a "bin:NAME" item creates an executable). An unknown name gets tlmgr's own
-# wording, which is what rpp parses. Every call is appended to tlmgr.log at the tree root.
+# wording, which is what paperlint parses. Every call is appended to tlmgr.log at the tree root.
 bin=$(cd "$(dirname "$0")" && pwd)
 tree=$(cd "$bin/../.." && pwd)
 repo=""

package/hooks/hooks.harness.mjs

@@ -72,7 +72,7 @@ const check = (label, cond) => {
  * checkout, which is what `npm install` of a local package does anyway.
  */
 const consumer = (block, { papers = "docs/papers", paper = "alpha" } = {}) => {
-  const dir = realpathSync(mkdtempSync(join(tmpdir(), "rpp-hooks-")));
+  const dir = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-hooks-")));
   const nm = join(dir, "node_modules");
   mkdirSync(nm, { recursive: true });
   symlinkSync(join(ROOT, "node_modules", "vigiles"), join(nm, "vigiles"));

package/lib/paper-config.d.mts

@@ -32,3 +32,10 @@ export declare function renamedFieldMessage(
 
 /** Every key the settings object may hold, mapped to who reads it. */
 export declare const SETTINGS_KEYS: Readonly<Record<string, string>>;
+
+/** The per-paper settings file, `paperlint.json`, and its name before 2.1.0. */
+export declare const PAPER_SETTINGS_FILE: string;
+export declare const LEGACY_PAPER_SETTINGS_FILE: string;
+/** Every key `paperlint.json` may hold, mapped to who reads it. */
+export declare const PAPER_SETTINGS_KEYS: Readonly<Record<string, string>>;
+export declare const LEGACY_PAPER_SETTINGS_MESSAGE: string;

package/lib/paper-config.harness.mjs

@@ -219,7 +219,7 @@ 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 `[CONFIG_KEY]?.<key>` (or the literal package name in the brackets), plus every field of
-// `RppConfig`, the CLI's typed view of the same object.
+// `PaperlintConfig`, the CLI's typed view of the same object.
 {
   const { SETTINGS_KEYS } = await import(join(HERE, "paper-config.mjs"));
   const ts = (await import("typescript")).default;
@@ -239,7 +239,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 === "RppConfig")
+    if (ts.isInterfaceDeclaration(node) && node.name.text === "PaperlintConfig")
       for (const m of node.members)
         if (m.name && ts.isIdentifier(m.name)) readKeys.add(m.name.text);
     ts.forEachChild(node, visit);
@@ -274,7 +274,7 @@ const loaded = await Promise.all(
     unread.length === 0,
   );
   check(
-    "and the scan found the readers it must find — the skill scripts' keys and RppConfig's",
+    "and the scan found the readers it must find — the skill scripts' keys and PaperlintConfig's",
     ["ledger", "citeChecks", "triggerCases", "papersDir", "rules"].every((k) =>
       readKeys.has(k),
     ),

package/lib/paper-config.mjs

@@ -30,6 +30,37 @@ export const CONFIG_KEY = "paperlint";
  */
 export const LEGACY_CONFIG_KEY = "research-paper-pipeline";
 
+/**
+ * THE THREE LEVELS OF SETTINGS, each named after the tool:
+ *
+ *   package.json → "paperlint"     the project: where the papers are, what every paper gets
+ *   <paper>/paperlint.json         one paper: the venue preset it extends, its kind, its own rules
+ *   a venue preset                 one venue: its format, TeX packages and rules — shipped with
+ *                                  paperlint (`paperlint:<name>`) or the project's own (`./x.jsonc`)
+ *
+ * The per-paper file was `venue.json` before 2.1.0. It is NOT read any more — a fallback would keep
+ * it working forever — and `paperlint init` moves it.
+ */
+export const PAPER_SETTINGS_FILE = "paperlint.json";
+export const LEGACY_PAPER_SETTINGS_FILE = "venue.json";
+
+/**
+ * Every key `paperlint.json` may hold. Any other key is REFUSED with its name: a typo would
+ * otherwise read as "not set". `$comment` is JSON Schema's own keyword for a comment, the one way
+ * to leave a note in a JSON file; paperlint ignores its value.
+ */
+export const PAPER_SETTINGS_KEYS = Object.freeze({
+  extends:
+    "the venue preset: paperlint:<name> or ./path.jsonc — the pdf/ venue rules, paperlint build",
+  kind: "the kind of paper, whose page limit applies — pdf/limits",
+  pdf: "where the built PDF is, relative to the paper, when it is not paper.pdf — the facts",
+  rules: "rule overrides for this paper alone — paperlint lint",
+  $comment: "a note for humans; ignored",
+});
+
+/** What a leftover pre-2.1.0 file is told. */
+export const LEGACY_PAPER_SETTINGS_MESSAGE = `${LEGACY_PAPER_SETTINGS_FILE} is no longer read: it was renamed ${PAPER_SETTINGS_FILE} in paperlint 2.1.0. \`npx paperlint init\` moves it.`;
+
 /**
  * Where a parsed `package.json` keeps this package's settings — the new key, else the old one.
  *
@@ -96,7 +127,7 @@ export const OLD_PAPERS_DIR_FIELD = "papers";
 /**
  * The error text for a config that still uses the old field name, or `null` when it does not.
  *
- * @param settings  the object under CONFIG_KEY (or the whole `rpp.json`)
+ * @param settings  the object under CONFIG_KEY
  * @param where     where that object lives, as the reader should see it in the message
  */
 export function renamedFieldMessage(
@@ -117,7 +148,7 @@ export function renamedFieldMessage(
  * 🔴 ONE LIST, AND IT IS CHECKED AGAINST THE READERS, NOT TRUSTED. The settings object has readers
  * all over the package (the CLI, the skill scripts, the trigger-case loader), each reading its own
  * keys. `lib/paper-config.harness.mjs` walks the package's source, finds every
- * `[CONFIG_KEY]?.<key>` read and every field of `RppConfig`, and requires each to be here — so a
+ * `[CONFIG_KEY]?.<key>` read and every field of `PaperlintConfig`, and requires each to be here — so a
  * new reader that forgets this list turns the harness red before a consumer's config does.
  */
 export const SETTINGS_KEYS = Object.freeze({
@@ -130,7 +161,7 @@ export const SETTINGS_KEYS = Object.freeze({
   minFindings: "review/findings-cause — paperlint lint",
   causeMarker: "review/findings-cause — paperlint lint",
   rules:
-    "extra ESLint config blocks, appended after rpp's own — paperlint lint",
+    "extra ESLint config blocks, appended after paperlint's own — paperlint lint",
   buildScripts: "REMOVED; still named so paperlint build can say it is ignored",
   ledger: "the run ledger — skills/paper-pipeline/scripts/consumer.mjs",
   scripts: "how skill prose names the scripts — consumer.mjs",

package/lib/skill-trigger-cases.harness.mjs

@@ -54,7 +54,7 @@ function loadAt(root) {
 }
 
 function fixture(pkgJson, casesFile) {
-  const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-cases-")));
+  const root = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-cases-")));
   writeFileSync(join(root, "package.json"), JSON.stringify(pkgJson));
   if (casesFile) {
     mkdirSync(join(root, ".claude", "lib"), { recursive: true });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "paperlint",
-  "version": "2.0.0",
-  "description": "Machine-checkable gates for a research paper kept in git: ESLint rules over .tex/.md paper sources, plus the skills and hooks that drive each stage.",
+  "version": "2.1.0",
+  "description": "A linter for scientific papers written in LaTeX: catches mistakes before you submit to a conference or journal.",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -51,7 +51,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/zernie/research-paper-pipeline.git"
+    "url": "git+https://github.com/zernie/paperlint.git"
   },
   "keywords": [
     "eslint",
@@ -68,7 +68,7 @@
     "node": ">=22.13"
   },
   "bin": {
-    "paperlint": "bin/rpp.mjs"
+    "paperlint": "bin/paperlint.mjs"
   },
   "files": [
     ".github",

package/plugin/hooks/hooks.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/rpp.mjs\" hook paper-edit-guard"
+            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/paperlint.mjs\" hook paper-edit-guard"
           }
         ]
       }
@@ -17,11 +17,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/rpp.mjs\" hook paper-skills-nudge"
+            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/paperlint.mjs\" hook paper-skills-nudge"
           },
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/rpp.mjs\" hook paper-status-gates"
+            "command": "node \"${CLAUDE_PROJECT_DIR}/node_modules/paperlint/bin/paperlint.mjs\" hook paper-status-gates"
           }
         ]
       }

package/scripts/check.mjs

@@ -140,7 +140,7 @@ export const GATES = [
     run: locked("node", "test/e2e/banal.mjs"),
   },
   {
-    name: "toolchain e2e — real TeX Live into $RPP_TEXLIVE_DIR, then a build with only it on PATH",
+    name: "toolchain e2e — real TeX Live into $PAPERLINT_TEXLIVE_DIR, then a build with only it on PATH",
     job: "build-e2e",
     run: locked("node", "test/e2e/toolchain.mjs"),
   },

package/scripts/harness-api.frozen.json

@@ -1,5 +1,5 @@
 {
-  "issue": "https://github.com/zernie/research-paper-pipeline/issues/77",
+  "issue": "https://github.com/zernie/paperlint/issues/77",
   "why": "A *.harness.* file tests the agent surface and imports runHook, runHarnessTest or runEval from vigiles. Plain unit tests are *.test.ts, run by vitest. These are the harness files that existed on main on 2026-09-25 and import none of the three. The list only shrinks: rename a file to *.test.ts (issue #77), or make it a real harness, then delete its entry. Checked by scripts/harness-api.test.ts, part of npm test.",
   "harnesses": [
     "action.harness.mjs",

package/scripts/harness-api.test.ts

@@ -5,7 +5,7 @@
  *
  * The rule is read from the file's IMPORTS, parsed with the TypeScript compiler — not from its
  * folder and not from a text search: a comment or a string that mentions `runHook` is not an import,
- * and `src/cli.harness.mjs` calls a function of rpp's own that happens to be called `runHook`.
+ * and `src/cli.harness.mjs` calls a function of paperlint's own that happens to be called `runHook`.
  *
  * Harnesses that predate the rule and import none of the three are frozen in
  * `harness-api.frozen.json` (issue #77). That list only shrinks: an entry that now imports the API,
@@ -156,7 +156,7 @@ test("an import is what counts — not a mention, not a same-named local functio
   const mention =
     '// runHook\nconst s = "runHarnessTest";\nimport { x } from "vigiles";\n';
   assert.equal(importsAgentApi("a.harness.mjs", mention), false);
-  // Guards: rpp's own `runHook` (src/cli.ts) is not vigiles'.
+  // Guards: paperlint's own `runHook` (src/cli.ts) is not vigiles'.
   assert.equal(
     importsAgentApi(
       "b.harness.mjs",

package/scripts/layer-legacy.frozen.json

@@ -1,5 +1,5 @@
 {
-  "issue": "https://github.com/zernie/research-paper-pipeline/issues/76",
+  "issue": "https://github.com/zernie/paperlint/issues/76",
   "why": "Legacy src/*.ts files that still do I/O or import an adapter or a tool package directly. May only shrink: fix a site, delete its directive, lower the count here (delete the file entry at zero). A new file may not appear. Counted from ESLint suppressedMessages by scripts/layer-legacy-frozen.mjs, part of npm run check.",
   "files": {
     "src/build-engine.ts": {

package/scripts/mutation-batteries-frozen.harness.mjs

@@ -60,7 +60,7 @@ const driverBattery = (k) =>
   `import { runMutations } from "./lib/mutation-driver.mjs";\n` +
   `process.exit(runMutations({ root: ".", cases: [${Array.from({ length: k }, (_, i) => `{ name: "c${String(i)}" }`).join(", ")}] }));\n`;
 
-const TMP = realpathSync(mkdtempSync(join(tmpdir(), "rpp-frozen-h-")));
+const TMP = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-frozen-h-")));
 process.on("exit", () => rmSync(TMP, { recursive: true, force: true }));
 mkdirSync(join(TMP, "scripts"), { recursive: true });
 mkdirSync(join(TMP, "src"), { recursive: true });

package/scripts/mutation-batteries.frozen.json

@@ -1,5 +1,5 @@
 {
-  "issue": "https://github.com/zernie/research-paper-pipeline/issues/52",
+  "issue": "https://github.com/zernie/paperlint/issues/52",
   "why": "Hand-written *.mutations.mjs batteries are being removed (#52). This list may only shrink: no new batteries, no new cases in existing ones. Delete a battery or a case, then delete its entry or lower its count here. Checked by scripts/mutation-batteries-frozen.mjs, part of npm run check.",
   "batteries": {
     "action.mutations.mjs": {
@@ -96,7 +96,7 @@
       "cases": 11
     },
     "src/cli.mutations.mjs": {
-      "cases": 28
+      "cases": 26
     },
     "src/doctor.mutations.mjs": {
       "cases": 10

package/scripts/release-config.test.ts

@@ -53,7 +53,7 @@ const fix = {
 const context = {
   cwd: process.cwd(),
   options: {
-    repositoryUrl: "https://github.com/zernie/research-paper-pipeline",
+    repositoryUrl: "https://github.com/zernie/paperlint",
   },
   lastRelease: { gitTag: "v1.0.0", version: "1.0.0" },
   nextRelease: { gitTag: "v2.0.0", version: "2.0.0", type: "major" },

package/skills/find-venue/SKILL.md

@@ -4,7 +4,7 @@ description: "Discover and rank real venues for a given paper, scored by authors
 allowed-tools: [Read, Write, Grep, Glob, WebSearch, WebFetch, Agent, Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*), Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
 ---
 
-<!-- vigiles:sha256:d1efcdc10319e6a3 compiled from skills/find-venue/SKILL.md.spec.ts -->
+<!-- vigiles:sha256:5efdcc0e1b178c1a compiled from skills/find-venue/SKILL.md.spec.ts -->
 
 # find-venue — rank real venues by what earns the credit, then keep or switch
 
@@ -113,6 +113,10 @@ dropped and why, and a verdict with no table behind it cannot be re-checked when
 ## Compose with
 - `research-ideate` (upstream) — consumes its candidate venue *types* and sharpest framing.
 - `plan-paper-timeline` — feed it the chosen deadline to back-plan the work.
+- once a venue is chosen, the paper declares it in `<paper>/paperlint.json`:
+  `{ "extends": "paperlint:<venue>", "kind": "<kind>" }` — a shipped preset, else a family
+  (`paperlint:acm-sigconf`) or the project's own `./venues/<name>.jsonc`; the `pdf/*` rules then
+  check the built PDF against its page limit and format.
 - `submit-paper` venue data cards (`submit-paper/references/venues/<venue>.md`, e.g. `agenticdev.md`,
   `aisec.md`) — the winner gets a venue-specific data card with its HotCRP quirks; save a new one per
   venue as plain data, not a new skill.

package/skills/find-venue/SKILL.md.spec.ts

@@ -129,6 +129,10 @@ dropped and why, and a verdict with no table behind it cannot be re-checked when
 ## Compose with
 - \`research-ideate\` (upstream) — consumes its candidate venue *types* and sharpest framing.
 - \`plan-paper-timeline\` — feed it the chosen deadline to back-plan the work.
+- once a venue is chosen, the paper declares it in \`<paper>/paperlint.json\`:
+  \`{ "extends": "paperlint:<venue>", "kind": "<kind>" }\` — a shipped preset, else a family
+  (\`paperlint:acm-sigconf\`) or the project's own \`./venues/<name>.jsonc\`; the \`pdf/*\` rules then
+  check the built PDF against its page limit and format.
 - \`submit-paper\` venue data cards (\`submit-paper/references/venues/<venue>.md\`, e.g. \`agenticdev.md\`,
   \`aisec.md\`) — the winner gets a venue-specific data card with its HotCRP quirks; save a new one per
   venue as plain data, not a new skill.

package/skills/paper-pipeline/PIPELINE-MAP.md

@@ -199,6 +199,14 @@ format.
 
 ## 3. Venue constants belong in a card, not in code
 
+> **Done (#79, 2.1.0), in a different shape than planned below.** The constants live in **venue
+> presets**, JSONC files in `submit-paper/references/venues/`: `acm-sigconf.jsonc` is the ACM
+> family (the `format` block — page size, columns, fonts, font sizes — plus the `tex` packages),
+> `agenticdev.jsonc` and `aisec.jsonc` extend it and add their `kinds` (page limits) and `rules`,
+> `realm.jsonc` stands alone. A paper picks one in `<paper>/paperlint.json`
+> (`{ "extends": "paperlint:<venue>", "kind": "…" }`); the `pdf/*` lint rules judge the built PDF
+> against it. The `.md` cards stay as prose. What follows is the plan as it was written.
+
 Right now `LinLibertine`, `LinBiolinum`, `acmart` are hardcoded into `check-render.sh`. This is
 **venue data**, and it belongs in
 `.claude/skills/submit-paper/references/venues/<venue>.md`:
@@ -292,7 +300,7 @@ imports, paths inside regexes).
 ## 2. One build entry point for all papers, not one per paper
 
 > **Done (#59, 2026-09-24).** `paperlint build <paper>` is the entry point, and `paperlint toolchain` installs
-> TeX Live with the packages the venue profiles declare; `ensure-toolchain.sh` and
+> TeX Live with the packages the venue presets declare; `ensure-toolchain.sh` and
 > `ci-install-texlive.sh` are deleted. What follows is the plan as it was written.
 
 **The hole:** `compile-rules` has `repro/build-submission.sh`, which calls `ensure-toolchain.sh`.
@@ -324,9 +332,11 @@ point. Nothing to check.
 | page limit           | **4**           | `venues/realm.md` 8 · `build-submission.sh` 8 · `PIPELINE-STATUS` "8/8" · the build prints **9**                                      |
 | the TeX package list | **5**           | `ensure-toolchain.sh` (executable) · `SKILL.md` · `render-paper.harness.mjs` (pins it ✅) · `build-submission.sh` · `PIPELINE-STATUS` |
 
-The canonical source is the venue card (`venues/<venue>.md`, the `<!-- venue-profile -->` block) for
-format, and — since 2026-09-24 — the `tex` block of `venues/<venue>.jsonc` (plus `tex-base.jsonc`)
-for packages; `ensure-toolchain.sh` held them until then. Everything else is a pointer.
+The canonical source is the venue preset (`venues/<name>.jsonc`, resolved through its `extends`
+chain): its `format` block for the numbers (page size, columns, fonts, font sizes, and `kinds` for
+page limits), its `tex` block (plus `tex-base.jsonc`) for packages — since 2026-09-24;
+`ensure-toolchain.sh` held them until then — and its `rules` block for the checks the venue
+implies. The `.md` card is prose about the venue. Everything else is a pointer.
 
 ## 3-ter. Drop the font gate from `check-render.sh` once the rules run in CI
 

package/skills/paper-pipeline/SKILL.md

@@ -4,7 +4,7 @@ description: The orchestrator for writing a research paper end-to-end, from idea
 allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch, Agent, Skill]
 ---
 
-<!-- vigiles:sha256:6ec7cc1d25db0a0f compiled from skills/paper-pipeline/SKILL.md.spec.ts -->
+<!-- vigiles:sha256:291d2266e29874be compiled from skills/paper-pipeline/SKILL.md.spec.ts -->
 
 # paper-pipeline — the conductor for the whole organism
 
@@ -28,8 +28,9 @@ of that — who is filing what, and when — stays in the author's own private n
 - `references/acl-venue-rules.md` — what holds at **every** ACL-family venue and workshop: the
   page-limit map, the appendix rule and the trap inside it, Limitations/Ethics as free-but-restricted
   space, anonymity, OpenReview mechanics. Fetch once, not per paper. Venue-specific facts stay in
-  `submit-paper/references/venues/<venue>.md`. (No equivalent yet for ACM or IEEE — write one when
-  the next paper goes there.)
+  `submit-paper/references/venues/<venue>.md`. (No prose equivalent yet for ACM or IEEE — write one
+  when the next paper goes there. ACM's machine-checked format already exists: the
+  `paperlint:acm-sigconf` preset, `submit-paper/references/venues/acm-sigconf.jsonc`.)
 
 ## The readiness scorecard (which boxes are checked)
 Stages run in subagents and report into chat, which evaporates — so "did everything run?" becomes

package/skills/paper-pipeline/SKILL.md.spec.ts

@@ -45,8 +45,9 @@ of that — who is filing what, and when — stays in the author's own private n
 - \`references/acl-venue-rules.md\` — what holds at **every** ACL-family venue and workshop: the
   page-limit map, the appendix rule and the trap inside it, Limitations/Ethics as free-but-restricted
   space, anonymity, OpenReview mechanics. Fetch once, not per paper. Venue-specific facts stay in
-  \`submit-paper/references/venues/<venue>.md\`. (No equivalent yet for ACM or IEEE — write one when
-  the next paper goes there.)
+  \`submit-paper/references/venues/<venue>.md\`. (No prose equivalent yet for ACM or IEEE — write one
+  when the next paper goes there. ACM's machine-checked format already exists: the
+  \`paperlint:acm-sigconf\` preset, \`submit-paper/references/venues/acm-sigconf.jsonc\`.)
 
 ## The readiness scorecard (which boxes are checked)
 Stages run in subagents and report into chat, which evaporates — so "did everything run?" becomes

package/skills/paper-pipeline/description-language.eval.mjs

@@ -236,7 +236,7 @@ const CASES = [
 
 // Preflight: a misspelled skill or a changed namespace makes every `fired` predicate permanently
 // false, and the run then reports a wall of confident 0.00s as though the descriptions were dead.
-// Through `installedSkills`, which follows the links `paperlint init` makes (rpp#62).
+// Through `installedSkills`, which follows the links `paperlint init` makes (paperlint#62).
 const installed = new Set(installedSkills(SKILLS_DIR));
 for (const c of CASES) {
   if (!installed.has(c.skill))

package/skills/paper-pipeline/framing-vs-vocabulary.eval.mjs

@@ -433,7 +433,7 @@ const CELL_LABEL = {
 // as though the descriptions were dead. That is the failure mode this block exists to prevent.
 
 // 1. the skills exist and declare the names we test against
-// Through `installedSkills`, which follows the links `paperlint init` makes (rpp#62).
+// Through `installedSkills`, which follows the links `paperlint init` makes (paperlint#62).
 const installed = installedSkills(SKILLS_DIR);
 const installedSet = new Set(installed);
 for (const c of CASES) {

package/skills/paper-pipeline/grade-paper-writing-ablation.eval.mjs

@@ -586,7 +586,7 @@ if (ONLY.length && RUN_ARMS.length !== ONLY.length)
 // a wall of confident 0.00s that read like a finding.
 
 // 1. the roster is what the parent measured
-// Through `installedSkills`, which follows the links `paperlint init` makes (rpp#62).
+// Through `installedSkills`, which follows the links `paperlint init` makes (paperlint#62).
 const installed = installedSkills(SKILLS_DIR);
 const installedSet = new Set(installed);
 if (installedSet.has(ARMS[5].rename))
@@ -737,7 +737,7 @@ function buildArm(a) {
   rmSync(dir, { recursive: true, force: true });
   mkdirSync(dir, { recursive: true });
   // 🔴 ONE SKILL AT A TIME, FROM ITS REALPATH — not `cpSync(SKILLS_DIR, dir, { recursive })`.
-  // In a consumer every entry of SKILLS_DIR is a link `paperlint init` made (rpp#62), and `cpSync` copies
+  // In a consumer every entry of SKILLS_DIR is a link `paperlint init` made (paperlint#62), and `cpSync` copies
   // a link as a link, rewritten to an ABSOLUTE path into the original; `dereference: true` does not
   // change that for nested entries (measured, Node 22.22). The arm's `writeFileSync` below would
   // then land in the real SKILL.md — "the real one is never written" would be false in exactly the

package/skills/paper-pipeline/pipeline-firing.eval.mjs

@@ -397,7 +397,7 @@ const irrelevantFor = (c) => {
 function assertSkillIdsExist() {
   if (!existsSync(SKILLS_DIR))
     throw new Error(`no skills dir at ${SKILLS_DIR}`);
-  // Through `installedSkills`, which follows the links `paperlint init` makes (rpp#62).
+  // Through `installedSkills`, which follows the links `paperlint init` makes (paperlint#62).
   const installed = new Set(installedSkills(SKILLS_DIR));
   const missing = CASES.map((c) => c.skill).filter((s) => !installed.has(s));
   if (missing.length)

package/skills/paper-pipeline/pipeline-language.eval.mjs

@@ -449,7 +449,7 @@ const CASES = [
 function assertSkillIdsExist() {
   if (!existsSync(SKILLS_DIR))
     throw new Error(`no skills dir at ${SKILLS_DIR}`);
-  // Through `installedSkills`, which follows the links `paperlint init` makes (rpp#62).
+  // Through `installedSkills`, which follows the links `paperlint init` makes (paperlint#62).
   const installed = new Set(installedSkills(SKILLS_DIR));
   const missing = CASES.map((c) => c.skill).filter((s) => !installed.has(s));
   if (missing.length)

package/skills/paper-pipeline/scripts/consumer.d.mts

@@ -30,3 +30,4 @@ export declare function packageVenuesDir(): string;
 export declare const SHIPPED_SKILLS_DIR: string;
 export declare const PACKAGE_NAME: "paperlint";
 export declare const LEGACY_PACKAGE_NAME: "research-paper-pipeline";
+export declare const BIN_FILE: "bin/paperlint.mjs";

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

@@ -43,6 +43,7 @@ import {
   pipelineScripts,
   scriptsRoot,
   PACKAGE_NAME,
+  BIN_FILE,
 } from "./consumer.mjs";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -63,6 +64,11 @@ const HERE = dirname(fileURLToPath(import.meta.url));
     [PACKAGE_NAME],
     "the package exposes exactly one command, named like the package",
   );
+  assert.equal(
+    manifest.bin?.[PACKAGE_NAME],
+    BIN_FILE,
+    "package.json `bin` points at BIN_FILE from consumer.mjs — the file every hook command runs",
+  );
   const wiring = JSON.parse(
     readFileSync(join(root, "plugin", "hooks", "hooks.json"), "utf8"),
   );
@@ -73,9 +79,9 @@ const HERE = dirname(fileURLToPath(import.meta.url));
   assert.ok(
     commands.length > 0 &&
       commands.every((c) =>
-        c.includes(`/node_modules/${PACKAGE_NAME}/bin/rpp.mjs`),
+        c.includes(`/node_modules/${PACKAGE_NAME}/${BIN_FILE}`),
       ),
-    `every command in plugin/hooks/hooks.json runs node_modules/${PACKAGE_NAME}/bin/rpp.mjs`,
+    `every command in plugin/hooks/hooks.json runs node_modules/${PACKAGE_NAME}/${BIN_FILE}`,
   );
 }
 const TMP = realpathSync(mkdtempSync(join(tmpdir(), "consumer-harness-")));
@@ -472,7 +478,7 @@ assert.equal(
   );
 }
 
-// ── XI. WHICH SKILLS ARE INSTALLED — a link counts, a dangling link is REFUSED (rpp#62) ────────
+// ── XI. WHICH SKILLS ARE INSTALLED — a link counts, a dangling link is REFUSED (paperlint#62) ────────
 // `paperlint init` installs every skill as a SYMLINK `.claude/skills/<name> -> …/skills/<name>`. A
 // `Dirent` from `readdirSync(…, { withFileTypes: true })` describes the entry ITSELF and does not
 // follow links, so `e.isDirectory()` is false for every one of them: the eval preflights that
@@ -506,7 +512,7 @@ assert.equal(
   const names = installedSkills(home);
   assert.ok(
     names.includes("linked"),
-    "a SYMLINKED skill was not counted as installed. This is rpp#62: `paperlint init` installs every " +
+    "a SYMLINKED skill was not counted as installed. This is paperlint#62: `paperlint init` installs every " +
       "skill as a link, so a reader that does not follow links sees none of them in any consumer.",
   );
   assert.deepEqual(

package/skills/paper-pipeline/scripts/consumer.mjs

@@ -151,6 +151,13 @@ export const PACKAGE_NAME = "paperlint";
  */
 export const LEGACY_PACKAGE_NAME = "research-paper-pipeline";
 
+/**
+ * The package's one executable, relative to the package root — what `bin` in package.json names
+ * and what every hook command runs. Named like the package; `consumer.harness.mjs` checks it
+ * against the manifest, so the file and the hook commands cannot drift apart.
+ */
+export const BIN_FILE = `bin/${PACKAGE_NAME}.mjs`;
+
 /**
  * Where the package keeps the skills it ships, relative to the package root. One constant, read by
  * the linker (`src/link-skills.ts`) and the install e2e, so the two cannot disagree; `files` in
@@ -168,7 +175,7 @@ export function consumerSkillsDir(opts) {
  * sorted by name. The one answer to "which skills are here" — for the consumer's
  * `.claude/skills/`, for this package's own declared skills directory, and for a copy of either.
  *
- * 🔴 IT FOLLOWS SYMLINKS, AND THAT IS THE WHOLE POINT (rpp#62). `paperlint init` (`src/link-skills.ts`)
+ * 🔴 IT FOLLOWS SYMLINKS, AND THAT IS THE WHOLE POINT (paperlint#62). `paperlint init` (`src/link-skills.ts`)
  * installs every skill as a link `.claude/skills/<name> -> …/skills/<name>`. A `Dirent` from
  * `readdirSync(dir, { withFileTypes: true })` describes the entry itself, so `isDirectory()` is
  * false for every link: five eval preflights asked the question that way, saw zero skills in

package/skills/paper-pipeline/scripts/consumer.mutations.mjs

@@ -117,7 +117,7 @@ const MUTATIONS = [
     "the boundary between the pipeline's scripts and a directory merely named like them",
   ],
 
-  // ── `installedSkills` (rpp#62). Its defects fail toward a WRONG ROSTER, not an error: a reader
+  // ── `installedSkills` (paperlint#62). Its defects fail toward a WRONG ROSTER, not an error: a reader
   // that does not follow links sees zero skills in every consumer; one that skips a dangling link
   // reports a broken install as "not installed"; one that counts it hands out an unreadable skill.
   [

package/skills/render-paper/SKILL.md

@@ -4,7 +4,7 @@ description: Compile a LaTeX paper (ACM/IEEE/arXiv) to PDF and render its pages
 allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, SendUserFile]
 ---
 
-<!-- vigiles:sha256:e8f75efdcbdd7890 compiled from skills/render-paper/SKILL.md.spec.ts -->
+<!-- vigiles:sha256:0943963cae95f8f1 compiled from skills/render-paper/SKILL.md.spec.ts -->
 
 # render-paper — .tex → PDF → readable page PNGs
 
@@ -38,7 +38,7 @@ That list was replaced on 2026-08-03; nothing about the toolchain below changed.
 ## Toolchain (one command, not a checklist)
 - **Compiler:** TeX Live, installed by paperlint with exactly the packages the venue profiles declare:
   ```
-  npx paperlint toolchain            # into ~/.cache/rpp/texlive (RPP_TEXLIVE_DIR overrides); idempotent
+  npx paperlint toolchain            # into ~/.cache/paperlint/texlive (PAPERLINT_TEXLIVE_DIR overrides); idempotent
   npx paperlint toolchain --check    # report what is missing, change nothing
   ```
   Measured 2026-09-24: 3 min from an empty directory, 269 MB, TeX Live 2026, 47 packages verified
@@ -50,7 +50,7 @@ That list was replaced on 2026-08-03; nothing about the toolchain below changed.
   package gets it there — never in a script, never here. A TeX Live without `libertine` builds an
   acmart paper GREEN in Computer Modern; that is why the files are checked, not the exit code.
 - **Reading the PDF** needs nothing installed: `paperlint build` and `extract-pdf-facts.mjs` use pdf.js,
-  which comes with rpp. Page size, columns and font sizes come from banal (HotCRP's page-geometry
+  which comes with paperlint. Page size, columns and font sizes come from banal (HotCRP's page-geometry
   script), which `npx paperlint toolchain` installs and which runs on pdf.js output — it needs `perl`,
   and no poppler. Without banal those facts are `null` and the build says so.
 - **Renderer:** `pip install --quiet pymupdf` (system rasterizers and ghostscript are often missing or