paperlint 8.0.0 → 9.0.1

package/eslint-rules/CLAUDE.md.spec.ts

@@ -0,0 +1,43 @@
+// Compiled to eslint-rules/CLAUDE.md by `npx vigiles compile`. Edit THIS file, never the markdown.
+//
+// The requirements below are held by tests and scripts, not by an ESLint rule `enforce()` could
+// name, so they are prose with verified file references rather than `enforce()` rules.
+import { file, guidance, instructionFile, prose } from "vigiles/spec";
+
+export default instructionFile({
+  sections: {
+    "`eslint-rules/`": prose`The rules this package ships. Loaded when working under \`eslint-rules/\`; the rules for every change
+are in the root \`CLAUDE.md\`. Each requirement below names what holds it; the reasoning lives in
+that file's header.`,
+
+    "What a new rule ships with, and what holds it": prose`| requirement | held by |
+| --- | --- |
+| **Both halves** (root \`CLAUDE.md\`), for every registered rule | ${file("src/rule-cases.test.ts")} fails on a registered rule with no cases |
+| **One rule, one requirement**: two checks with different reasons to switch them off are two rules | review |
+| **A venue requirement is validated on real accepted papers** of that venue, built to PDF, with the ground truth established independently | review; the papers are in ${file("fixtures/accepted-papers/README.md")} |
+| **Its page**, \`docs/rules/<group>/<rule>.md\`, and \`meta.docs.url\` pointing at it | ${file("src/rule-docs.test.ts")}; its \`AWAITING_PAGE\` list only shrinks |
+| **Loud on an empty input set**: a rule that matched no files must not report like one that passed | ${file("scripts/rules-see-files.mjs")}, per rule and not per glob, in \`npm run check\` |
+
+The page's sections: What it catches · Why · Examples (failing / passing) · Options / preset fields ·
+What it does not check · How to fix. Its row in ${file("docs/rules.md")} is one line linking there.`,
+
+    "A rule that judges prose": prose`A rule, or a skill criterion, that judges a paper's prose is held to five principles. Without them
+the checks push every paper toward a blog post.
+
+1. **Two-sided**: a floor as well as a ceiling, or the distance to accepted papers of the target
+   venue. A set of ceilings alone converges on clipped, unsignposted prose.
+2. **Rules count, skills judge.** Countable on the parse tree → a lint rule; needs reading (register,
+   genre, whether a claim changed strength) → a skill criterion.
+3. **The model reader is the venue's reviewer**, including one who skims the abstract, the
+   introduction and the conclusion.
+4. **Thresholds are calibrated, not borrowed**: set with the same counter on the accepted papers,
+   never taken from a figure measured by a different counter.
+5. **A rewrite is accepted on what reviewers see**: the combined count of every surface form of a
+   tic, plus a check that no claim was softened or strengthened.`,
+  },
+  rules: {
+    "lint-rule-over-script": guidance(
+      "A check over a syntax tree is a lint rule, not a script. It fires in the editor on save, gets the AST for free, and has a suppression syntax people already know. A script is for corpus-wide questions — index connectivity, ratios across many files. When the work has to run a program, a script may do the work and write facts to a JSON file, and a rule judges that file: the verdict still lands in the engine.",
+    ),
+  },
+});

package/eslint-rules/install-path-literals.harness.mjs

@@ -19,7 +19,7 @@ import markdown from "@eslint/markdown";
 import { recordCheck } from "vigiles";
 import port, { PORT } from "./install-path-literals.ts";
 
-// Resolved from THIS file, never from the caller's cwd — rule 6, and the mistake this very
+// Resolved from THIS file, never from the caller's cwd (root CLAUDE.md), and the mistake this very
 // class of bug is about.
 const HERE = dirname(fileURLToPath(import.meta.url));
 const ROOT = join(HERE, "..");

package/eslint-rules/install-path-literals.ts

@@ -1,5 +1,5 @@
 /**
- * Rule 10's mechanical half: nothing outside the port may name a file by WHERE IT IS
+ * The install-location rule's mechanical half (root CLAUDE.md): nothing outside the port may name a file by WHERE IT IS
  * INSTALLED.
  *
  * The class this exists for has broken this repository five times, silently every time, and
@@ -47,7 +47,7 @@ const PORT = "skills/paper-pipeline/scripts/consumer.mjs";
 const MESSAGES: Readonly<Record<string, string>> = {
   installPath:
     "This names a file by where it is INSTALLED ('{{prefix}}'), so it resolves in one " +
-    "delivery channel and does not exist in another. Rule 10: every answer to *where* comes " +
+    "delivery channel and does not exist in another. Every answer to *where* comes " +
     `from the port, ${PORT}. In a skill, use the substitution the harness performs ` +
     "(CLAUDE_SKILL_DIR / CLAUDE_PLUGIN_ROOT); in a module, ask the port.",
 };
@@ -58,7 +58,7 @@ const mdInstallPath = {
     type: "problem" as const,
     docs: {
       description:
-        "a skill must not name its scripts by an install-specific path — rule 10, the port owns where",
+        "a skill must not name its scripts by an install-specific path — the port owns where",
     },
     schema: [],
     messages: MESSAGES,
@@ -81,7 +81,7 @@ const jsInstallPath = {
     type: "problem" as const,
     docs: {
       description:
-        "a shipped module must not carry an install-specific path literal — rule 10, the port owns where",
+        "a shipped module must not carry an install-specific path literal — the port owns where",
     },
     schema: [],
     messages: MESSAGES,

package/eslint-rules/paper-context.ts

@@ -4,9 +4,10 @@
  * ESLint lints one file at a time. A paper whose body is in `sections/*.tex` is several files, and
  * two questions are about the paper, not the file: which reference form (`Fig.` or `Figure`) the
  * paper uses most, and whether the build `paper.tex` declares is a review build. The CLI knows the
- * files (it resolves the includes the way the build does, `bodyFiles` in src/tex-paper.ts) and puts
- * them under `settings.paperlint.paper`
- * for `paper.tex` and for every file it includes. A rule reads the other files from disk.
+ * files — the `.tex` files TeX read after `\begin{document}` in the last build, from the record the
+ * build wrote (`paperBodies` in src/paper-includes.ts) — and puts them under
+ * `settings.paperlint.paper` for `paper.tex` and for every one of them. A rule reads the other files
+ * from disk. A paper with no record, or a stale one, is `paper.tex` alone.
  *
  * No setting — a file linted outside `paperlint lint` — means a paper of one file: every rule
  * decides on the file it was handed, as it did before.

package/eslint-rules/paper-typography.test.mjs

@@ -1,9 +1,9 @@
 /**
- * paper/section-word · paper/leading-zero · paper/figure-ref-style · bib/reachable-entry — each
- * FIRES on a bad input, stays SILENT on a good one, reports every occurrence at its own place,
- * and (the first three) fixes to an exact output. Plus the escape hatch: a disable directive in a
- * `%` comment, including inside the `filecontents` bibliography, silences exactly one finding,
- * and a directive that silences nothing is itself reported.
+ * paper/section-word · paper/leading-zero · paper/figure-ref-style — each FIRES on a bad input,
+ * stays SILENT on a good one, reports every occurrence at its own place, and fixes to an exact
+ * output. Plus the escape hatch: a disable directive in a `%` comment silences exactly one finding,
+ * and a directive that silences nothing is itself reported. (`bib/reachable-entry`, the fourth check
+ * of the old `paper/typography`, is tested beside it in src/bib-rules.test.ts.)
  *
  * The leading-zero cases are the ones paperlint#44 measured: a regex over the raw source found 22
  * decimals on a real corpus and none was a defect, so the SILENT list is as load-bearing as the
@@ -19,7 +19,6 @@ import typography, {
   crefDefinitionRanges,
   texVisibleRuns,
 } from "./paper-typography.ts";
-import bib from "./bib-reachable-entry.ts";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
 const FIX = join(HERE, "..", "fixtures", "paper-typography");
@@ -28,7 +27,6 @@ const RULES = {
   "paper/section-word": "warn",
   "paper/leading-zero": "warn",
   "paper/figure-ref-style": "warn",
-  "bib/reachable-entry": "warn",
 };
 
 const eslint = (fix = false) =>
@@ -42,7 +40,6 @@ const eslint = (fix = false) =>
         plugins: {
           tex: { languages: { latex: texLanguage } },
           paper: typography,
-          bib,
         },
         language: "tex/latex",
         linterOptions: { reportUnusedDisableDirectives: "error" },
@@ -74,8 +71,6 @@ describe("the fixtures: messy fires on each rule, clean is silent", () => {
     expect(count("paper/section-word")).toBe(3);
     expect(count("paper/leading-zero")).toBe(2);
     expect(count("paper/figure-ref-style")).toBe(1);
-    expect(count("bib/reachable-entry")).toBe(2);
-    expect(ids(res, "bib/reachable-entry").map((m) => m.line)).toEqual([3, 8]);
   });
 
   it("clean-paper — nothing", async () => {
@@ -110,6 +105,13 @@ describe("paper/section-word", () => {
     expect(ids(await lint(src), "paper/section-word")).toEqual([]);
   });
 
+  it("🔴 silent on a bibliography whose file name stands on the line after \\begin{filecontents*}", async () => {
+    const src =
+      "\\documentclass{acmart}\n\\begin{filecontents*}\n{refs.bib}\n@misc{k, note = {see §5}, url = {https://x.org}}\n\\end{filecontents*}\n" +
+      "\\begin{document}\nSection~\\ref{a}.\n\\end{document}\n";
+    expect(ids(await lint(src), "paper/section-word")).toEqual([]);
+  });
+
   it("🔴 a cleveref name definition is not prose: silent, and --fix leaves it as written", async () => {
     const src =
       "\\documentclass{article}\n\\usepackage{cleveref}\n\\crefname{section}{§}{§§}\n\\Crefname{section}{§}{§§}\n" +
@@ -296,69 +298,7 @@ describe("paper/figure-ref-style", () => {
   });
 });
 
-describe("bib/reachable-entry", () => {
-  const bibDoc = (entries) =>
-    `\\documentclass{acmart}\n\\begin{filecontents*}{refs.bib}\n${entries}\n\\end{filecontents*}\n\\begin{document}\nx\n\\end{document}\n`;
-
-  it("a doi, a url or an arXiv id each make an entry reachable", async () => {
-    const res = await lint(
-      bibDoc(
-        "@article{a, doi = {10.1/x}}\n@misc{b, url = {https://x.org}}\n@misc{c, note = {arXiv:2310.05736}}\n@string{v = {x}}",
-      ),
-    );
-    expect(ids(res, "bib/reachable-entry")).toEqual([]);
-  });
-
-  it("reports on the entry itself, naming its key", async () => {
-    const res = await lint(
-      bibDoc("@misc{ok, url = {https://x.org}}\n@article{lost, title = {x}}"),
-    );
-    const [m] = ids(res, "bib/reachable-entry");
-    expect(m.line).toBe(4);
-    expect(m.column).toBe(1);
-    expect(m.message).toMatch(/`lost`/);
-  });
-
-  it("an entry with no key is reported as `?`, not skipped", async () => {
-    const [m] = ids(
-      await lint(bibDoc("@article{\n  title = {x}}")),
-      "bib/reachable-entry",
-    );
-    expect(m.message).toMatch(/`\?`/);
-  });
-
-  it("a source code with only `text`, or with neither text nor raw", () => {
-    const run = (sourceCode) => {
-      const out = [];
-      bib.rules["reachable-entry"]
-        .create({
-          sourceCode: {
-            getLocFromIndex: (i) => ({ line: 1, column: i }),
-            ...sourceCode,
-          },
-          report: (r) => out.push(r.data.key),
-        })
-        ["root:exit"]();
-      return out;
-    };
-    expect(run({ text: bibDoc("@article{t, title = {x}}") })).toEqual(["t"]);
-    expect(run({})).toEqual([]);
-  });
-});
-
 describe("the escape hatch — a disable directive in a `%` comment", () => {
-  it("🔴 inside the filecontents bibliography, it silences exactly the next entry", async () => {
-    const res = await lint(
-      `\\documentclass{acmart}\n\\begin{filecontents*}{refs.bib}\n` +
-        "% eslint-disable-next-line bib/reachable-entry -- an invited talk, no recording exists\n" +
-        "@misc{talk, title = {x}}\n@misc{lost, title = {y}}\n" +
-        "\\end{filecontents*}\n\\begin{document}\nx\n\\end{document}\n",
-    );
-    const found = ids(res, "bib/reachable-entry");
-    expect(found).toHaveLength(1);
-    expect(found[0].message).toMatch(/`lost`/);
-  });
-
   it("in the body: next-line, same-line, and a disable/enable region", async () => {
     const src = doc(
       [

package/eslint-rules/paper-typography.ts

@@ -7,8 +7,8 @@
  *   paper/figure-ref-style  `Fig.~\ref` beside `Figure~\ref` in one document → the majority form
  *
  * The fourth check of the old `paper/typography`, an unreachable bibliography entry, is
- * `bib/reachable-entry` (bib-reachable-entry.mjs): it is about the bibliography, not the prose,
- * and it has no fix.
+ * `bib/reachable-entry` (src/bib-rules.ts): it is about the bibliography, not the prose, and it has
+ * no fix.
  *
  * ── PROVENANCE: every one is a real review finding, not an invented style ───────────────
  * From HotCRP #20 (2026-08-23). Reviewer B listed two as literal to-dos:
@@ -75,7 +75,7 @@ import type {
 } from "./rule-context.ts";
 
 /** Where a `.bib` embedded in a `filecontents` environment sits in the file. */
-export interface BibRange {
+interface BibRange {
   readonly start: number;
   readonly end: number;
   readonly bodyStart: number;
@@ -91,10 +91,17 @@ interface Run {
   offs: (number | null)[];
 }
 
-/** The inline bibliography — a `filecontents` block writing a `.bib` — with its offsets. */
-export function bibRange(text: string): BibRange | null {
+/**
+ * The inline bibliography — a `filecontents` block writing a `.bib`, its name on the `\begin` line or
+ * after white space on a later one, as TeX takes it — with its offsets: the span the markup rules
+ * skip. Which bibliography TeX reads is the build's record (`_build/sources.json`,
+ * docs/design/paper-sources.md §1);
+ * this range only says which bytes are not prose, and moves onto the one projection of live text
+ * with the rest of `skippedRanges` (Q3, docs/design/paper-sources.md §10).
+ */
+function bibRange(text: string): BibRange | null {
   const m =
-    /\\begin\{filecontents\*?\}(?:\[[^\]]*\])?\{[^}]*\.bib\}\r?\n([\s\S]*?)\\end\{filecontents\*?\}/d.exec(
+    /\\begin\{filecontents\*?\}\s*(?:\[[^\]]*\]\s*)?\{[^}]*\.bib\}[^\n]*\n([\s\S]*?)\\end\{filecontents\*?\}/d.exec(
       text,
     );
   if (!m) return null;

package/eslint-rules/pdf-last-page-balance.ts

@@ -11,7 +11,7 @@
  *   { "rules": { "pdf/last-page-balance": ["error", { "tolerancePt": 120 }] } }
  *
  * (That is a line comment's worth of JSON in a block comment only because it has no asterisk
- * followed by a slash; see rule 8 of CLAUDE.md before editing it.)
+ * followed by a slash; see the block-comment rule in the root CLAUDE.md before editing it.)
  *
  * ── WHAT IT READS: THE FACTS THE BUILD WROTE, NOT THE PDF ───────────────────────
  * `paperlint build` measures the PDF with pdf.js and writes `<paper>/_build/paper.facts.json`. This rule

package/eslint.config.mjs

@@ -250,6 +250,9 @@ const ROOT = { file: { categories: "root" } };
  */
 export const layerBoundaries = (root) => ({
   files: ["src/**/*.ts"],
+  // The source of src/CLAUDE.md sits beside it because `vigiles compile` requires that; it is an
+  // instruction file, not a layer of the package.
+  ignores: ["src/CLAUDE.md.spec.ts"],
   plugins: { boundaries },
   settings: {
     "boundaries/root-path": root,
@@ -681,7 +684,7 @@ export default [
     languageOptions: { ecmaVersion: 2024, sourceType: "module" },
     plugins: { local: localRules, port: portRules },
     rules: {
-      // Rule 10's mechanical half, code side. `warn` and not `error`, unlike its neighbour
+      // The install-location rule's mechanical half (root CLAUDE.md), code side. `warn` and not `error`, unlike its neighbour
       // above: this one does NOT open on a clean corpus. Two shipped modules print a command
       // for a human that names an install-specific path, and neither is fixable by the
       // answer the skills get — a printed command has to be resolved through the port at
@@ -741,7 +744,7 @@ export default [
     rules: { "n/no-missing-import": "error" },
   },
   /**
-   * Rule 10's mechanical half, prose side — and this is where the debt actually is: 76
+   * The install-location rule's mechanical half (root CLAUDE.md), prose side — and this is where the debt actually is: 76
    * findings across 29 skills on a healthy checkout, every one of them a command that
    * resolves in one delivery channel and is absent in another.
    *
@@ -789,7 +792,7 @@ export default [
     // ⚠️ `npx eslint .` therefore reports six warnings on a healthy checkout: the four defect
     // fixtures are DEFECTIVE ON PURPOSE, and that is what makes the fire half of every harness
     // real. Do not silence them by adding an ignore — a rule that lints only clean inputs is
-    // one whose firing path nothing exercises, which is rule 4 wearing a different hat. The
+    // one whose firing path nothing exercises, which is the green zero of scripts/rules-see-files.mjs wearing a different hat. The
     // pass/fail signal lives in `npm test`, not in the warning count of `npm run lint`.
   },
   {
@@ -798,6 +801,28 @@ export default [
       "no-restricted-imports": ["error", { paths: ONE_COLLECTION_LIBRARY }],
     },
   },
+  // 🔴 ONE PLACE READS BIBLIOGRAPHIES. `@retorquere/bibtex-parser` is known to its adapter only;
+  // every other file — the app, the domain, another adapter, a skill's script — reads a `.bib` through
+  // the `BibReader` port, and a path a person gave through `bibliographyAt` (src/paper-sources.ts).
+  // Three readers of `.bib` text grew here before there was one. Its own rule id, so no other
+  // `no-restricted-imports` block can replace it (test/eslint-bib-parser.test.ts).
+  {
+    files: ["**/*.{ts,mts,mjs,js,cjs}"],
+    ignores: ["src/adapters/bibtex/**"],
+    plugins: { n },
+    rules: {
+      "n/no-restricted-import": [
+        "error",
+        [
+          {
+            name: ["@retorquere/bibtex-parser", "@retorquere/bibtex-parser/**"],
+            message:
+              "The bibtex parser is src/adapters/bibtex/'s: read a .bib through the BibReader port (src/ports/bib-reader.ts), or a path through bibliographyAt (src/paper-sources.ts).",
+          },
+        ],
+      ],
+    },
+  },
   // 🔴 THE LINTER DOES NOT READ A SKILL. Skills are consumers of the package, not its storage: the
   // venue presets once lived in a skill and were located through a skill's script, so renaming the
   // skill broke `paperlint lint` (#133). The package's own code — src/, eslint-rules/, lib/ — may

package/fixtures/build-e2e/aidc/paper.tex

@@ -3,7 +3,7 @@
 % rule is judged against what a real build of the class measures. It conforms: the LLM Usage
 % Statement closes it, and not one rule has anything to say.
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-ack/paper.tex

@@ -1,7 +1,7 @@
 % B: the name in an acknowledgments paragraph.
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-author/paper.tex

@@ -1,7 +1,7 @@
 % A: the name in the author block.
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-bib/paper.tex

@@ -1,7 +1,7 @@
 % C: a self-citation: the name only in a .bib author field, printed by IEEEtran.bst as "A. Example".
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-href/paper.tex

@@ -2,7 +2,7 @@
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
 \usepackage{hyperref}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-macro/paper.tex

@@ -2,7 +2,7 @@
 % The declared identity is invented: "Ada Example", handle "adaexample" (paperlint.json).
 \documentclass[conference,compsoc]{IEEEtran}
 \newcommand{\me}{Ada Example}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/build-e2e/anon-pdfauthor/paper.tex

@@ -3,7 +3,7 @@
 \documentclass[conference,compsoc]{IEEEtran}
 \usepackage{hyperref}
 \hypersetup{pdfauthor={Ada Example}}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @article{knuth84,
   title   = {Literate Programming},
   author  = {Knuth, Donald E.},

package/fixtures/paper-sources/p1/paper.tex

@@ -0,0 +1,30 @@
+\documentclass{article}
+\begin{filecontents*}{refs.bib}
+@misc{inline2024,
+  title = {The Inline Entry},
+  author = {Doe, Jane},
+  year = {2024},
+  url = {https://example.org/inline}
+}
+\end{filecontents*}
+\begin{document}
+\section{Introduction}
+We cite the inline entry~\cite{inline2024} and the stale one~\cite{stale2020}.
+% We cite~\cite{commented2020}. The harness will be released at camera-ready.
+\input{sections/intro}
+% \input{sections/dead}
+\iffalse
+\input{sections/parked}
+\begin{figure}[t]
+\caption{Parked caption this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real paper and then it keeps going a little longer still until the count is right this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real.}
+\end{figure}
+The harness will be released at camera-ready.
+\fi
+\begin{figure}[t]
+\centering
+\fbox{x}
+\caption[Short]{Optional-arg caption this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real paper and then it keeps going a little longer still until the count is right this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real.}
+\end{figure}
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}

package/fixtures/paper-sources/p1/refs.bib

@@ -0,0 +1,6 @@
+@misc{stale2020,
+  title = {The Stale Entry},
+  author = {Roe, Rich},
+  year = {2020},
+  url = {https://example.org/stale}
+}

package/fixtures/paper-sources/p1/sections/dead.tex

@@ -0,0 +1,6 @@
+\section{Dead section}
+\begin{figure}[t]
+\centering
+\fbox{z}
+\caption{Dead caption this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real paper and then it keeps going a little longer still until the count is right this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real.}
+\end{figure}

package/fixtures/paper-sources/p1/sections/intro.tex

@@ -0,0 +1,7 @@
+\section{Results}
+We release the harness with this paper. It cuts the cost by 42\% on the benchmark.
+\begin{figure}[t]
+\centering
+\fbox{y}
+\caption{Included caption this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real paper and then it keeps going a little longer still until the count is right this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real.}
+\end{figure}

package/fixtures/paper-sources/p1/sections/parked.tex

@@ -0,0 +1,6 @@
+\section{Parked section}
+\begin{figure}[t]
+\centering
+\fbox{z}
+\caption{Parked caption this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real paper and then it keeps going a little longer still until the count is right this sentence keeps going with ordinary words so that it reaches the length a long caption has in a real.}
+\end{figure}

package/fixtures/paper-sources/p1/tex-truth.json

@@ -0,0 +1,37 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    },
+    {
+      "path": "refs.bib",
+      "role": "preamble"
+    },
+    {
+      "path": "sections/intro.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "refs.bib"
+    ],
+    "keys": [
+      "stale2020"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "52ab53ff01ae6dee061f4f674764dc5f5e38f8f6710a3b1c418b1bf07cb46196",
+    "refs.bib": "7a720777755f3dd727c2428f66f06d5f818f367e41fe4c47543aa9f55adfebb4",
+    "sections/intro.tex": "bf7cdcd18d243940cc13a9a9281b7a61446a693f3a49fbd551a69f8a87a98f89"
+  }
+}

package/fixtures/paper-sources/p1/versions/2026-01-01-review.tex

@@ -0,0 +1,4 @@
+\documentclass{article}
+\begin{document}
+A frozen snapshot of the paper as it was sent for review.
+\end{document}

package/fixtures/paper-sources/v1-stale/paper.tex

@@ -0,0 +1,14 @@
+\documentclass{article}
+\begin{filecontents*}{refs.bib}
+@misc{inline2024,
+  title = {The Inline Entry},
+  author = {Doe, Jane},
+  year = {2024},
+  url = {https://example.org/inline}
+}
+\end{filecontents*}
+\begin{document}
+Text that cites~\cite{inline2024} and~\cite{stale2020}.
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}

package/fixtures/paper-sources/v1-stale/refs.bib

@@ -0,0 +1,6 @@
+@misc{stale2020,
+  title = {The Stale Entry},
+  author = {Roe, Rich},
+  year = {2020},
+  url = {https://example.org/stale}
+}

package/fixtures/paper-sources/v1-stale/tex-truth.json

@@ -0,0 +1,32 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    },
+    {
+      "path": "refs.bib",
+      "role": "preamble"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "refs.bib"
+    ],
+    "keys": [
+      "stale2020"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "54f0abc51bdc3df728907c7d4bcc90af43b0e3678d6e2ab1fa4c817a2c20f29d",
+    "refs.bib": "7a720777755f3dd727c2428f66f06d5f818f367e41fe4c47543aa9f55adfebb4"
+  }
+}

package/fixtures/paper-sources/v10-ifthenelse/anon.bib

@@ -0,0 +1 @@
+@misc{anonkey, title={Anon}, author={A, B}, year={2020}}

package/fixtures/paper-sources/v10-ifthenelse/paper.tex

@@ -0,0 +1,9 @@
+\documentclass{article}
+\usepackage{ifthen}
+\newboolean{anon}
+\setboolean{anon}{true}
+\begin{document}
+\nocite{*}
+\bibliographystyle{plain}
+\ifthenelse{\boolean{anon}}{\bibliography{anon}}{\bibliography{real}}
+\end{document}

package/fixtures/paper-sources/v10-ifthenelse/real.bib

@@ -0,0 +1 @@
+@misc{realkey, title={Real}, author={A, B}, year={2020}}

package/fixtures/paper-sources/v10-ifthenelse/tex-truth.json

@@ -0,0 +1,28 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "anon"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "anon.bib"
+    ],
+    "keys": [
+      "anonkey"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "33fd7452738f9968e48e6f454b21338a79c6d236597bf2be0e8e128db1452aad",
+    "anon.bib": "e56856cc2aa71a1277cdee0b941843de7e64216a47690d62850ca657835232d4"
+  }
+}

package/fixtures/paper-sources/v11-two-blocks/paper.tex

@@ -0,0 +1,12 @@
+\documentclass{article}
+\begin{filecontents*}{refs.bib}
+@misc{first, title={First}, author={A, B}, year={2020}}
+\end{filecontents*}
+\begin{filecontents*}[overwrite]{refs.bib}
+@misc{second, title={Second}, author={A, B}, year={2020}}
+\end{filecontents*}
+\begin{document}
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}