paperlint 2.0.0 → 2.1.0

package/skills/submit-paper/references/venues/venue-profile.schema.json

@@ -1,43 +1,121 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://github.com/zernie/research-paper-pipeline/venue-profile.schema.json",
-  "title": "Venue profile",
-  "description": "One venue's format profile (venues/<venue>.jsonc) and the TeX base set (venues/tex-base.jsonc). The format numbers are read by the consumer's pdf/profile rule; `tex` is read by `paperlint toolchain` and `paperlint build`.",
+  "$id": "https://github.com/zernie/paperlint/venue-profile.schema.json",
+  "title": "Venue preset",
+  "description": "One venue preset or template family (venues/<name>.jsonc), and the TeX base set (venues/tex-base.jsonc). A paper's paperlint.json names one with \"extends\"; a preset may extend another. `format` and `rules` are read by paperlint's pdf/* venue rules and its lint config (src/venue-rules.ts, src/presets.ts); `tex` by `paperlint toolchain` and `paperlint build`.",
   "type": "object",
-  "required": ["tex"],
   "additionalProperties": false,
   "properties": {
-    "tex": { "$ref": "#/definitions/tex" },
+    "extends": {
+      "description": "The preset this one builds on: `paperlint:<name>` (shipped) or a path starting with ./ or ../, relative to this file.",
+      "type": "string",
+      "minLength": 1
+    },
+    "name": {
+      "description": "A display name for messages; the file name otherwise.",
+      "type": "string",
+      "minLength": 1
+    },
+    "tex": {
+      "$ref": "#/definitions/tex"
+    },
     "template": {
       "description": "The \\documentclass the venue's template uses.",
       "type": "string",
       "minLength": 1
     },
-    "page_size": { "type": "string", "enum": ["letter", "a4"] },
-    "page_w_in": { "type": "number", "exclusiveMinimum": 0 },
-    "page_h_in": { "type": "number", "exclusiveMinimum": 0 },
-    "textblock_w_in": { "type": "number", "exclusiveMinimum": 0 },
-    "textblock_h_in": { "type": "number", "exclusiveMinimum": 0 },
-    "columns": { "type": "integer", "minimum": 1 },
-    "body_pt": { "type": "number", "exclusiveMinimum": 0 },
-    "body_pt_tol": { "type": "number", "minimum": 0 },
-    "ref_pt_min": { "type": "number", "exclusiveMinimum": 0 },
-    "ref_pt_max": { "type": "number", "exclusiveMinimum": 0 },
-    "fonts_text": { "type": "string", "minLength": 1 },
-    "fonts_title": { "type": "string", "minLength": 1 },
-    "page_limits_not_gated": { "type": "object" },
-    "kinds": {
+    "format": {
+      "description": "What the venue's call for papers sets. Every key is optional; a child preset's key replaces its parent's, and a child's kind replaces that kind.",
       "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "body_pages_max": { "type": "integer", "minimum": 1 },
-          "ref_pages_max": { "type": "integer", "minimum": 0 }
+      "additionalProperties": false,
+      "properties": {
+        "page_size": {
+          "type": "string",
+          "enum": ["letter", "a4"]
+        },
+        "page_w_in": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "page_h_in": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "textblock_w_in": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "textblock_h_in": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "columns": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "body_pt": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "body_pt_tol": {
+          "type": "number",
+          "minimum": 0
+        },
+        "ref_pt_min": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "ref_pt_max": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "fonts_text": {
+          "type": "string",
+          "minLength": 1
+        },
+        "fonts_title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "page_limits_not_gated": {
+          "type": "object"
+        },
+        "kinds": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "body_pages_max": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "ref_pages_max": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
         }
       }
+    },
+    "rules": {
+      "description": "Rules the venue implies, rule id \u2192 ESLint entry (a severity, or [severity, options]). Applied to every paper that extends this preset, before the paper's own rules.",
+      "type": "object"
     }
   },
+  "allOf": [
+    {
+      "if": {
+        "not": {
+          "required": ["extends"]
+        }
+      },
+      "then": {
+        "required": ["tex"]
+      }
+    }
+  ],
   "definitions": {
     "ctanName": {
       "description": "A package name as tlmgr knows it (CTAN / TeX Live), not a distribution package name.",
@@ -48,7 +126,11 @@
       "type": "array",
       "minItems": 1,
       "uniqueItems": true,
-      "items": { "type": "string", "minLength": 1, "pattern": "^[^/\\s]+$" }
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^[^/\\s]+$"
+      }
     },
     "tex": {
       "description": "The TeX Live packages this template needs. Each package maps to the files that PROVE it is present: `kpsewhich` must find every one after an install, or the install failed and says which package.",
@@ -59,14 +141,22 @@
         "packages": {
           "type": "object",
           "minProperties": 1,
-          "propertyNames": { "$ref": "#/definitions/ctanName" },
-          "additionalProperties": { "$ref": "#/definitions/proofs" }
+          "propertyNames": {
+            "$ref": "#/definitions/ctanName"
+          },
+          "additionalProperties": {
+            "$ref": "#/definitions/proofs"
+          }
         },
         "tools": {
           "description": "Packages that ship a PROGRAM rather than a file LaTeX loads. Proved by an executable of that name in TeX Live's bin directory, not by kpsewhich.",
           "type": "object",
-          "propertyNames": { "$ref": "#/definitions/ctanName" },
-          "additionalProperties": { "$ref": "#/definitions/proofs" }
+          "propertyNames": {
+            "$ref": "#/definitions/ctanName"
+          },
+          "additionalProperties": {
+            "$ref": "#/definitions/proofs"
+          }
         }
       }
     }

package/src/adapters/banal/index.test.ts

@@ -54,7 +54,7 @@ test("with $BANAL: banal gets the .xml and a quoted $PDFTOHTML, and the geometry
     [2, 1],
   );
   const c = run.calls[0];
-  // Guards: the poppler-free path — banal is handed rpp's XML, never the PDF.
+  // Guards: the poppler-free path — banal is handed paperlint's XML, never the PDF.
   assert.match(c?.args.at(-1) ?? "", /\.xml$/);
   assert.match(c?.env["PDFTOHTML"] ?? "", /^'.*pdftohtml'$/);
 });

package/src/adapters/banal/invocation.test.ts

@@ -22,7 +22,7 @@ import {
 import type { LocatedBanal } from "./locate.ts";
 import { XML_DIALECT } from "./xml.ts";
 
-test("the staging holds BOTH files: the XML and the -v stub answering the dialect rpp writes", () => {
+test("the staging holds BOTH files: the XML and the -v stub answering the dialect paperlint writes", () => {
   const [xml, stub] = stageBanalInput([]).files;
   assert.equal(xml.name, "paper.xml");
   assert.match(xml.content, /^<\?xml/);
@@ -50,14 +50,14 @@ test("shQuote survives a single quote", () => {
   assert.equal(shQuote("it's"), `'it'"'"'s'`);
 });
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-stage-test-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-stage-test-")));
 after(() => rmSync(root, { recursive: true, force: true }));
 
 test("🔴 stage: on a real scratch directory the stub answers `-v` through the shell, from a path with a space and a quote", () => {
   const awkward = join(root, "it's a dir");
   mkdirSync(awkward);
   const { workspace } = nodeAdapters({ tmpDir: awkward });
-  workspace.within("rpp-banal-", (s) => {
+  workspace.within("paperlint-banal-", (s) => {
     const staged = stage(s, stageBanalInput([]));
     assert.ok(existsSync(staged.xml));
     // Guards: banal runs `$PDFTOHTML -v 2>&1 |` through /bin/sh, unquoted.

package/src/adapters/banal/invocation.ts

@@ -30,13 +30,13 @@ export const shQuote = (s: string): ShQuoted =>
 /** The stub standing in for `pdftohtml`: it answers `-v` and refuses to convert anything. */
 export const PDFTOHTML_STUB = [
   "#!/bin/sh",
-  "# research-paper-pipeline: banal reads the banal input XML rpp writes, never a PDF. banal still",
-  "# asks `pdftohtml -v` which dialect to expect; this answers with the one rpp writes.",
+  "# paperlint: banal reads the banal input XML it writes, never a PDF. banal still",
+  "# asks `pdftohtml -v` which dialect to expect; this answers with the one paperlint writes.",
   'if [ "$1" = "-v" ]; then',
   `  echo "pdftohtml version ${XML_DIALECT.version}"`,
   "  exit 0",
   "fi",
-  'echo "rpp: this pdftohtml only answers -v; banal was given a PDF instead of the banal input XML" >&2',
+  'echo "paperlint: this pdftohtml only answers -v; banal was given a PDF instead of the banal input XML" >&2',
   "exit 1",
   "",
 ].join("\n");

package/src/adapters/banal/locate.test.ts

@@ -8,7 +8,7 @@ import { parseBanalSettings } from "./settings.ts";
 
 const dirs = { home: "/h", tmp: "/t", cwd: "/w" };
 const project = "/p" as AbsolutePath;
-const cache = `/h/.cache/rpp/banal/${BANAL_PIN.commit.slice(0, 12)}/banal`;
+const cache = `/h/.cache/paperlint/banal/${BANAL_PIN.commit.slice(0, 12)}/banal`;
 const on =
   (...files: string[]) =>
   (p: string) =>
@@ -22,11 +22,11 @@ test("installedBanal: one directory per HotCRP commit", () => {
   assert.equal(installedBanal(parseBanalSettings({}, dirs)), cache);
 });
 
-test("rpp's own copy when nothing else is named", () => {
+test("paperlint's own copy when nothing else is named", () => {
   assert.equal(kind(pick({}, on(cache))), "cache");
 });
 
-test("a project's vendor/banal before rpp's copy", () => {
+test("a project's vendor/banal before paperlint's copy", () => {
   // Guards: a project that vendors banal keeps using its own copy.
   assert.equal(kind(pick({}, on(cache, "/p/vendor/banal"))), "vendor");
 });
@@ -44,7 +44,7 @@ test("🔴 $BANAL naming a missing file finds NOTHING — no fallback to another
   );
 });
 
-test("nothing anywhere: not installed, naming where rpp's copy would be", () => {
+test("nothing anywhere: not installed, naming where paperlint's copy would be", () => {
   assert.deepEqual(
     pick({}, on()),
     err({ kind: "not-installed", installed: cache }),

package/src/adapters/banal/run.ts

@@ -8,7 +8,7 @@
  *
  * ── THE LICENCE BOUNDARY ────────────────────────────────────────────────────────
  * banal is GPL-2.0-or-later; paperlint is MIT. paperlint therefore never contains banal: `paperlint toolchain`
- * DOWNLOADS it from HotCRP at a pinned commit, checks its sha256, and stores it in rpp's cache, and
+ * DOWNLOADS it from HotCRP at a pinned commit, checks its sha256, and stores it in paperlint's cache, and
  * paperlint EXECUTES it as a separate program (`perl banal …`), reading its JSON output. Nothing of banal
  * is copied, vendored, linked or translated into this package.
  *
@@ -96,7 +96,7 @@ function runBanal(
   banal: LocatedBanal,
   pages: readonly PageLayout[],
 ): Result<BanalMeasurement, BanalFailure> {
-  return d.workspace.within("rpp-banal-", (scratch) =>
+  return d.workspace.within("paperlint-banal-", (scratch) =>
     parseBanalOutput(
       d.run.run(
         banalCommand(

package/src/adapters/banal/settings.test.ts

@@ -4,22 +4,28 @@ import { parseBanalSettings } from "./settings.ts";
 
 const dirs = { home: "/h", tmp: "/t", cwd: "/w" };
 
-test("cacheDir: $RPP_BANAL_DIR, else $XDG_CACHE_HOME/rpp/banal, else ~/.cache/rpp/banal", () => {
+test("cacheDir: $PAPERLINT_BANAL_DIR, else $XDG_CACHE_HOME/paperlint/banal, else ~/.cache/paperlint/banal", () => {
   assert.equal(
-    parseBanalSettings({ RPP_BANAL_DIR: "/x" }, dirs).cacheDir,
+    parseBanalSettings({ PAPERLINT_BANAL_DIR: "/x" }, dirs).cacheDir,
     "/x",
   );
   assert.equal(
     parseBanalSettings({ XDG_CACHE_HOME: "/c" }, dirs).cacheDir,
-    "/c/rpp/banal",
+    "/c/paperlint/banal",
+  );
+  assert.equal(
+    parseBanalSettings({}, dirs).cacheDir,
+    "/h/.cache/paperlint/banal",
   );
-  assert.equal(parseBanalSettings({}, dirs).cacheDir, "/h/.cache/rpp/banal");
 });
 
 test("an empty variable is unset, and a relative one is relative to the cwd the root read", () => {
-  const s = parseBanalSettings({ BANAL: "b/banal", RPP_BANAL_DIR: "" }, dirs);
+  const s = parseBanalSettings(
+    { BANAL: "b/banal", PAPERLINT_BANAL_DIR: "" },
+    dirs,
+  );
   assert.equal(s.explicit, "/w/b/banal");
-  assert.equal(s.cacheDir, "/h/.cache/rpp/banal");
+  assert.equal(s.cacheDir, "/h/.cache/paperlint/banal");
   assert.equal(parseBanalSettings({}, dirs).explicit, null);
 });
 

package/src/adapters/banal/settings.ts

@@ -11,15 +11,15 @@ import {
 } from "../../domain/host.ts";
 import type { AbsolutePath } from "../../domain/paths.ts";
 
-/** An explicit banal to use instead of rpp's (a path to the script). */
+/** An explicit banal to use instead of paperlint's (a path to the script). */
 export const BANAL_ENV = "BANAL";
-/** Where `paperlint toolchain` stores banal. Default: `$XDG_CACHE_HOME/rpp/banal`, else `~/.cache/rpp/banal`. */
-export const BANAL_DIR_ENV = "RPP_BANAL_DIR";
+/** Where `paperlint toolchain` stores banal. Default: `$XDG_CACHE_HOME/paperlint/banal`, else `~/.cache/paperlint/banal`. */
+export const BANAL_DIR_ENV = "PAPERLINT_BANAL_DIR";
 
 export interface BanalSettings {
   /** `$BANAL`: the user's explicit choice; null when unset. */
   readonly explicit: AbsolutePath | null;
-  /** `$RPP_BANAL_DIR` › `$XDG_CACHE_HOME/rpp/banal` › `<home>/.cache/rpp/banal`. */
+  /** `$PAPERLINT_BANAL_DIR` › `$XDG_CACHE_HOME/paperlint/banal` › `<home>/.cache/paperlint/banal`. */
   readonly cacheDir: AbsolutePath;
   /** Where scratch directories go. */
   readonly tmpDir: AbsolutePath;
@@ -37,7 +37,11 @@ const set = (v: string | undefined): string | null => (v ? v : null);
 function cacheDirOf(env: Environment, d: HostDirs): string {
   return (
     set(env[BANAL_DIR_ENV]) ??
-    join(set(env["XDG_CACHE_HOME"]) ?? join(d.home, ".cache"), "rpp", "banal")
+    join(
+      set(env["XDG_CACHE_HOME"]) ?? join(d.home, ".cache"),
+      "paperlint",
+      "banal",
+    )
   );
 }
 

package/src/adapters/banal/xml.test.ts

@@ -47,7 +47,7 @@ const page = (boxes: TextBox[], widthPt = 612, heightPt = 792): PageLayout => ({
   const expected = [
     '<?xml version="1.0" encoding="UTF-8"?>',
     '<!DOCTYPE pdf2xml SYSTEM "pdf2xml.dtd">',
-    '<pdf2xml producer="research-paper-pipeline (pdf.js)" version="24.02.0">',
+    '<pdf2xml producer="paperlint (pdf.js)" version="24.02.0">',
     '<page number="1" position="absolute" top="0" left="0" height="2376" width="1836">',
     '\t<fontspec id="0" size="30" family="LinLibertineT" color="#000000"/>',
     '<text top="30.000000" left="60.000000" width="90.000000" height="36.000000" font="0">Hello</text>',

package/src/adapters/banal/xml.ts

@@ -104,7 +104,7 @@ export function pdf2xml(pages: readonly PageLayout[]): string {
   const lines = [
     '<?xml version="1.0" encoding="UTF-8"?>',
     '<!DOCTYPE pdf2xml SYSTEM "pdf2xml.dtd">',
-    `<pdf2xml producer="research-paper-pipeline (pdf.js)" version="${XML_DIALECT.version}">`,
+    `<pdf2xml producer="paperlint (pdf.js)" version="${XML_DIALECT.version}">`,
     ...pages.flatMap((p, i) => pageXml(p, i + 1, fonts)),
     "</pdf2xml>",
   ];

package/src/adapters/curl/download.io.ts

@@ -1,6 +1,6 @@
 /**
  * `Download` through `curl -fsSL`. Not Node's `fetch`: undici's `fetch` ignores `HTTPS_PROXY` unless
- * a proxy agent is installed, and rpp's CI and the containers it runs in reach the network only
+ * a proxy agent is installed, and paperlint's CI and the containers it runs in reach the network only
  * through a proxy. curl reads the proxy variables itself. (A claim from documentation, not measured
  * here — the port is what makes trying the other adapter cheap.)
  */
@@ -41,7 +41,9 @@ export function curlDownload(o: {
 }): Download {
   return {
     fetch(url: string, timeoutMs: number) {
-      const dir = realpathSync(mkdtempSync(join(o.tmpDir, "rpp-download-")));
+      const dir = realpathSync(
+        mkdtempSync(join(o.tmpDir, "paperlint-download-")),
+      );
       const out = join(dir, "body");
       try {
         const seconds = String(Math.ceil(timeoutMs / 1000));

package/src/adapters/curl/download.test.ts

@@ -19,7 +19,9 @@ import type { AbsolutePath } from "../../domain/paths.ts";
 import { curlDownload } from "./download.io.ts";
 import { spawnProcess } from "../node/index.ts";
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-download-test-")));
+const root = realpathSync(
+  mkdtempSync(join(tmpdir(), "paperlint-download-test-")),
+);
 after(() => rmSync(root, { recursive: true, force: true }));
 const at = (...p: string[]) => join(root, ...p) as AbsolutePath;
 

package/src/adapters/node/files.test.ts

@@ -7,7 +7,7 @@ import { afterAll as after, test } from "vitest";
 import type { AbsolutePath } from "../../domain/paths.ts";
 import { nodeFiles } from "./files.io.ts";
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-files-test-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-files-test-")));
 after(() => rmSync(root, { recursive: true, force: true }));
 const at = (...p: string[]) => join(root, ...p) as AbsolutePath;
 

package/src/adapters/node/process.test.ts

@@ -19,8 +19,8 @@ const sh = (script: string, timeoutMs = 10_000): Command => ({
 test("a program that is not there is `not-found`, and names the program", () => {
   // Guards: ENOENT is the executable itself — "perl is missing" rather than "banal failed".
   assert.deepEqual(
-    run.run({ ...sh(""), file: "rpp-no-such-program-xyz", args: [] }),
-    { kind: "not-found", file: "rpp-no-such-program-xyz" },
+    run.run({ ...sh(""), file: "paperlint-no-such-program-xyz", args: [] }),
+    { kind: "not-found", file: "paperlint-no-such-program-xyz" },
   );
 });
 

package/src/adapters/node/workspace.test.ts

@@ -19,12 +19,12 @@ import { join } from "node:path";
 import { afterAll as after, test } from "vitest";
 import { tmpWorkspace } from "./workspace.io.ts";
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-ws-test-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-ws-test-")));
 after(() => rmSync(root, { recursive: true, force: true }));
 
 test("the directory exists inside the scope and is gone after it", () => {
   const ws = tmpWorkspace(root);
-  const dir = ws.within("rpp-banal-", (s) => {
+  const dir = ws.within("paperlint-banal-", (s) => {
     assert.ok(existsSync(s.dir));
     return s.dir;
   });
@@ -35,7 +35,7 @@ test("the directory exists inside the scope and is gone after it", () => {
 test("the directory is gone after a throw too", () => {
   let seen = "";
   assert.throws(() =>
-    tmpWorkspace(root).within("rpp-banal-", (s) => {
+    tmpWorkspace(root).within("paperlint-banal-", (s) => {
       seen = s.dir;
       throw new Error("boom");
     }),
@@ -46,7 +46,7 @@ test("the directory is gone after a throw too", () => {
 test("🔴 write: the file lands in the scope's directory, and `exec` makes it runnable — from a path with a space and a quote", () => {
   const awkward = join(root, "it's a dir");
   mkdirSync(awkward);
-  tmpWorkspace(awkward).within("rpp-ws-", (s) => {
+  tmpWorkspace(awkward).within("paperlint-ws-", (s) => {
     const plain = s.write("data.txt", "hello", "read");
     assert.equal(readFileSync(plain, "utf8"), "hello");
     const script = s.write("run", "#!/bin/sh\necho ran\n", "exec");

package/src/build-engine.harness.mjs

@@ -89,7 +89,7 @@ for (const [a, yes] of [
   check(`isYes(${JSON.stringify(a)}) is ${yes}`, E.isYes(a) === yes);
 
 // ── 2. prepareEngine ────────────────────────────────────────────────────────────────────
-const work = realpathSync(mkdtempSync(join(tmpdir(), "rpp-engine-h-")));
+const work = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-engine-h-")));
 const TEX = {
   packages: { acmart: ["acmart.cls"], libertine: ["libertine.sty"] },
   tools: {},
@@ -144,7 +144,7 @@ const go = async (o) => {
   };
 };
 const envWith = (cacheRoot, path) => ({
-  RPP_TEXLIVE_DIR: cacheRoot,
+  PAPERLINT_TEXLIVE_DIR: cacheRoot,
   PATH: path,
 });
 

package/src/build-engine.ts

@@ -29,7 +29,11 @@ import {
   usableTree,
   type InstallResult,
 } from "./toolchain.ts";
-import { declaredUnion, type TexRequirements } from "./tex-requirements.ts";
+import {
+  declaredUnion,
+  mergeRequirements,
+  type TexRequirements,
+} from "./tex-requirements.ts";
 
 export interface EngineOptions {
   /** What the targeted papers need: the base set plus each paper's venue. */
@@ -81,12 +85,16 @@ function withDefaults(o: EngineOptions): Resolved {
   };
   return {
     ...r,
-    install: o.install ?? (() => ensureTexLive(declaredUnion().tex, r)),
+    // The shipped union AND what the targeted papers need: a project's own preset lives outside
+    // the package, and its packages are only in `r.tex`.
+    install:
+      o.install ??
+      (() => ensureTexLive(mergeRequirements(declaredUnion().tex, r.tex), r)),
   };
 }
 
 /**
- * The facts `resolveEngine` decides on: rpp's cache and the PATH's TeX Live, each probed. The cache
+ * The facts `resolveEngine` decides on: paperlint's cache and the PATH's TeX Live, each probed. The cache
  * may hold one tree per TeX Live year; the one reported is the newest COMPLETE one, else the newest
  * (so a new year whose install was interrupted never wins over a complete older year).
  */

package/src/build.harness.mjs

@@ -50,10 +50,10 @@ const check = (label, cond) => {
   n++;
 };
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "rpp-build-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "paperlint-build-")));
 // 🔴 banal is looked for under the temp root, never in the developer's cache: with the real
-// `~/.cache/rpp/banal` present, the measure step would run the real banal on the fake reader's pages.
-const ENV = { RPP_BANAL_DIR: join(root, "no-banal") };
+// `~/.cache/paperlint/banal` present, the measure step would run the real banal on the fake reader's pages.
+const ENV = { PAPERLINT_BANAL_DIR: join(root, "no-banal") };
 const paper = (name, files) => {
   const dir = join(root, "papers", name);
   mkdirSync(dir, { recursive: true });
@@ -137,6 +137,24 @@ const fakeRead = async (pdf) => {
 const CLEAN_TEX = "\\documentclass{article}\\begin{document}x\\end{document}";
 
 try {
+  // ── inputs: paperlint's own venues directory, no configuration ───────────────────────────────
+  // First: the facts below resolve a paper's venue preset in this same directory, so a wrong one
+  // must be named HERE, not as a missing venue label two checks later.
+  const venues = packageVenuesDir();
+  check(
+    "the venues directory is paperlint's own and holds paper-guards.tex",
+    existsSync(join(venues, "paper-guards.tex")),
+  );
+  check(
+    "🔴 with no TEXINPUTS set, the value ENDS in the separator — otherwise the system tree stops resolving",
+    withTexInputs({}, [venues]).TEXINPUTS === `${venues}${delimiter}`,
+  );
+  check(
+    "an existing TEXINPUTS is kept, after ours",
+    withTexInputs({ TEXINPUTS: `/mine${delimiter}` }, [venues]).TEXINPUTS ===
+      `${venues}${delimiter}/mine${delimiter}`,
+  );
+
   // ── facts: parsed from the paper, not configured ──────────────────────────────────────
   check(
     "documentclass and options come from the parser",
@@ -157,33 +175,20 @@ try {
   );
   const venued = paper("venued", {
     "paper.tex": CLEAN_TEX,
-    "venue.json": JSON.stringify({ venue: "agenticdev", kind: "short" }),
+    "paperlint.json": JSON.stringify({
+      extends: "paperlint:agenticdev",
+      kind: "short",
+    }),
     "build.sh": "exit 0\n",
   });
   const facts = readFacts(venued);
-  check("the venue comes from venue.json", facts.venue === "agenticdev");
+  check("the venue comes from paperlint.json", facts.venue === "agenticdev");
   check(
     "a leftover build.sh is a FACT (reported), not a step",
     JSON.stringify(facts.ignoredScripts) === JSON.stringify(["build.sh"]) &&
       IGNORED_SCRIPTS.includes("repro/build-submission.sh"),
   );
 
-  // ── inputs: rpp's own venues directory, no configuration ───────────────────────────────
-  const venues = packageVenuesDir();
-  check(
-    "the venues directory is rpp's own and holds paper-guards.tex",
-    existsSync(join(venues, "paper-guards.tex")),
-  );
-  check(
-    "🔴 with no TEXINPUTS set, the value ENDS in the separator — otherwise the system tree stops resolving",
-    withTexInputs({}, [venues]).TEXINPUTS === `${venues}${delimiter}`,
-  );
-  check(
-    "an existing TEXINPUTS is kept, after ours",
-    withTexInputs({ TEXINPUTS: `/mine${delimiter}` }, [venues]).TEXINPUTS ===
-      `${venues}${delimiter}/mine${delimiter}`,
-  );
-
   // ── the plan ──────────────────────────────────────────────────────────────────────────
   const plan = planFor(facts);
   check(
@@ -261,7 +266,7 @@ try {
     tex.calls.every((c) => c.cwd === clean),
   );
   check(
-    "🔴 pdflatex got rpp's venues directory on TEXINPUTS, trailing separator kept",
+    "🔴 pdflatex got paperlint's venues directory on TEXINPUTS, trailing separator kept",
     tex.calls.every((c) => c.texinputs === `${venues}${delimiter}`),
   );
 

package/src/build.mutations.mjs

@@ -132,9 +132,10 @@ process.exit(
       {
         name: "the port resolves the venues directory one level off",
         harness: HARNESS,
-        expect: "the venues directory is rpp's own and holds paper-guards.tex",
+        expect:
+          "the venues directory is paperlint's own and holds paper-guards.tex",
         disables:
-          "the one answer to 'where are rpp's venue files'. A wrong directory does not fail " +
+          "the one answer to 'where are paperlint's venue files'. A wrong directory does not fail " +
           "pdflatex by itself — \\input{paper-guards} would fail later, in a paper, far from here",
         edits: [
           [