paperlint 8.0.0 → 9.0.0

package/fixtures/paper-sources/v25-string-differs/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": [
+      "k1"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "98021312aca10dcc347305e9de1abdd5549db5af26481af53fd5ca7c91c41635",
+    "refs.bib": "92432cd43420f561b25535a756ffe77a6c9270706e47ce1ea69950861878537f"
+  }
+}

package/fixtures/paper-sources/v26-comment-in-names/one.bib

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

package/fixtures/paper-sources/v26-comment-in-names/paper.tex

@@ -0,0 +1,7 @@
+\documentclass{article}
+\begin{document}
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{one,% the second database
+  two}
+\end{document}

package/fixtures/paper-sources/v26-comment-in-names/tex-truth.json

@@ -0,0 +1,32 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "one",
+    "two"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "one.bib",
+      "two.bib"
+    ],
+    "keys": [
+      "onekey",
+      "twokey"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "3b8fd4a4505559b5c59a59cdec628b49fb89a6eb597cca9c2a2fe72d5911e4c0",
+    "one.bib": "61cca311ca7d77570ed410fc536c655ba76d36168fc3e56068235a2c4b16f7bf",
+    "two.bib": "bcceb63d26bb7fce0425b896cbceb533060dd7dd5616e8e0ff00a2e8749f4335"
+  }
+}

package/fixtures/paper-sources/v26-comment-in-names/two.bib

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

package/fixtures/paper-sources/v27-shared-string/abbreviations.bib

@@ -0,0 +1,2 @@
+@string{venue = "Proceedings of the Shared Venue"}
+@string{who = "Lovelace, Ada"}

package/fixtures/paper-sources/v27-shared-string/paper.tex

@@ -0,0 +1,6 @@
+\documentclass{article}
+\begin{document}
+Text that cites~\cite{late}.
+\bibliographystyle{plain}
+\bibliography{abbreviations,references}
+\end{document}

package/fixtures/paper-sources/v27-shared-string/references.bib

@@ -0,0 +1,6 @@
+@inproceedings{late,
+  author = who,
+  title = {A Title},
+  booktitle = venue,
+  year = 2020,
+}

package/fixtures/paper-sources/v27-shared-string/tex-truth.json

@@ -0,0 +1,31 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "abbreviations",
+    "references"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "abbreviations.bib",
+      "references.bib"
+    ],
+    "keys": [
+      "late"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "f6ba2a563017e122deabc252bc7b36f4d2ffc79ffcf1b4fca349465987aabbeb",
+    "abbreviations.bib": "73084cf971a07ab999e668a8ad68734052fb0bb113226082a16b8badf0570f65",
+    "references.bib": "e37a1b173ecba38d5b748338276f48b4d014c9975e919bdfd1c8bfe755d76ca2"
+  }
+}

package/fixtures/paper-sources/v28-shared-string-block/abbreviations.bib

@@ -0,0 +1,2 @@
+@string{venue = "Proceedings of the Shared Venue"}
+@string{who = "Lovelace, Ada"}

package/fixtures/paper-sources/v28-shared-string-block/paper.tex

@@ -0,0 +1,14 @@
+\documentclass{article}
+\begin{filecontents*}[overwrite]{refs.bib}
+@inproceedings{late,
+  author = who,
+  title = {A Title},
+  booktitle = venue,
+  year = 2020,
+}
+\end{filecontents*}
+\begin{document}
+Text that cites~\cite{late}.
+\bibliographystyle{plain}
+\bibliography{abbreviations,refs}
+\end{document}

package/fixtures/paper-sources/v28-shared-string-block/tex-truth.json

@@ -0,0 +1,33 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [
+    "refs.bib"
+  ],
+  "bibdata": [
+    "abbreviations",
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "abbreviations.bib",
+      "refs.bib"
+    ],
+    "keys": [
+      "late"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "4a5f26663b1e9625a8e9b78dbcf5c5c2bc11aa019bbe63a7abbca25a8d97df9b",
+    "abbreviations.bib": "73084cf971a07ab999e668a8ad68734052fb0bb113226082a16b8badf0570f65",
+    "refs.bib": "e37a1b173ecba38d5b748338276f48b4d014c9975e919bdfd1c8bfe755d76ca2"
+  }
+}

package/fixtures/paper-sources/v29-generated-input/paper.tex

@@ -0,0 +1,9 @@
+\documentclass{article}
+\begin{filecontents*}{body.tex}
+This sentence is typeset from a file a block wrote.
+\end{filecontents*}
+\begin{document}
+Before the generated file.
+\input{body}
+After it.
+\end{document}

package/fixtures/paper-sources/v29-generated-input/tex-truth.json

@@ -0,0 +1,24 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    },
+    {
+      "path": "body.tex",
+      "role": "body"
+    }
+  ],
+  "written": [
+    "body.tex"
+  ],
+  "bibdata": [],
+  "bibtex": {
+    "ran": false
+  },
+  "sha256": {
+    "paper.tex": "4f7503a4dc744d30800a8dabe648769f174dcbdf5391e85e3cda1a02e742ea44",
+    "body.tex": "db9b3a64e25a0b579cb16e3b189d50d562fcdff6c38b33b0f76c6c0d567d965c"
+  }
+}

package/fixtures/paper-sources/v3-declared/paper.bib

@@ -0,0 +1,6 @@
+@misc{declared2023,
+  title = {The Declared Entry},
+  author = {Poe, Paula},
+  year = {2023},
+  url = {https://example.org/declared}
+}

package/fixtures/paper-sources/v3-declared/paper.tex

@@ -0,0 +1,6 @@
+\documentclass{article}
+\begin{document}
+Text that cites~\cite{declared2023}.
+\bibliographystyle{plain}
+\bibliography{paper}
+\end{document}

package/fixtures/paper-sources/v3-declared/tex-truth.json

@@ -0,0 +1,28 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "paper"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "paper.bib"
+    ],
+    "keys": [
+      "declared2023"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "365c348f503b060973c7b1d5db0348659dffa91d7b149d10181204ae27e31dfb",
+    "paper.bib": "efe5f0577c8173e99be73ed728679904dcac9c90b1ec56350cf64d0771f8305e"
+  }
+}

package/fixtures/paper-sources/v30-name-next-line/paper.tex

@@ -0,0 +1,14 @@
+\documentclass{article}
+\begin{filecontents*}
+{refs.bib}
+@misc{nl2024,
+  title = {The Name on the Next Line},
+  author = {Doe, Jane},
+  year = {2024}
+}
+\end{filecontents*}
+\begin{document}
+Text that cites~\cite{nl2024}.
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}

package/fixtures/paper-sources/v30-name-next-line/tex-truth.json

@@ -0,0 +1,30 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [
+    "refs.bib"
+  ],
+  "bibdata": [
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "refs.bib"
+    ],
+    "keys": [
+      "nl2024"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "143d03485e70ffefc525e6f783601c6f71e6650ccf779c77a4d7a8f12ba6075b",
+    "refs.bib": "b4c47cdd91aff598589dae3f0f068495af3680e5cdf0bce4747332750812ee1d"
+  }
+}

package/fixtures/paper-sources/v4-commented/paper.tex

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

package/fixtures/paper-sources/v4-commented/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/v4-commented/tex-truth.json

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

package/fixtures/paper-sources/v5-percent-entry/paper.tex

@@ -0,0 +1,20 @@
+\documentclass{article}
+\begin{filecontents*}[overwrite]{refs.bib}
+@misc{inline2024,
+  title = {The Inline Entry},
+  author = {Doe, Jane},
+  year = {2024},
+  url = {https://example.org/inline}
+}
+% @misc{dead2020,
+%   title = {The Entry Behind a Percent Sign},
+%   author = {Moe, Max},
+%   year = {2020},
+%   url = {https://example.org/dead}
+% }
+\end{filecontents*}
+\begin{document}
+Text that cites~\cite{inline2024} and~\cite{dead2020}.
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}

package/fixtures/paper-sources/v5-percent-entry/tex-truth.json

@@ -0,0 +1,37 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [
+    "refs.bib"
+  ],
+  "bibdata": [
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "refs.bib"
+    ],
+    "keys": [
+      "dead2020",
+      "inline2024"
+    ],
+    "exit": 2,
+    "errors": [
+      {
+        "message": "You're missing a field name",
+        "file": "refs.bib",
+        "line": 8
+      }
+    ]
+  },
+  "sha256": {
+    "paper.tex": "f520de6b9f34e249851913d2e9fc23532603378787b034e08e0b43e2bc111994",
+    "refs.bib": "247d564a35129b3fa087ae2541cd51130c1e6875fafe5dad36d694f6a4d1b7fc"
+  }
+}

package/fixtures/paper-sources/v6-unclosed/paper.tex

@@ -0,0 +1,6 @@
+\documentclass{article}
+\begin{document}
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{refs}
+\end{document}

package/fixtures/paper-sources/v6-unclosed/refs.bib

@@ -0,0 +1,5 @@
+@misc{a1, title={A}, author={A, B}, year={2020}, url={https://e.org/a1}}
+@misc{a2unclosed, title={Two}, author={A, B}, year={2020}, url={https://e.org/a2}
+
+@misc{a3, title={Three}, author={A, B}, year={2020}}
+% @misc{a4, title={Four}, author={A, B}, year={2020}}

package/fixtures/paper-sources/v6-unclosed/tex-truth.json

@@ -0,0 +1,37 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "refs"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "refs.bib"
+    ],
+    "keys": [
+      "a1",
+      "a4",
+      "a3",
+      "a2unclosed"
+    ],
+    "exit": 2,
+    "errors": [
+      {
+        "message": "I was expecting a `,' or a `}'",
+        "file": "refs.bib",
+        "line": 4
+      }
+    ]
+  },
+  "sha256": {
+    "paper.tex": "9ad22f9c50070c2620c5bf8885ed53cee4b0901e7bfdc83c61f70902686ac5e0",
+    "refs.bib": "1d33d35cf2e384fc54acf45654493881315c98a4b494b952464668d33924aeec"
+  }
+}

package/fixtures/paper-sources/v8-jobname/paper.tex

@@ -0,0 +1,9 @@
+\documentclass{article}
+\begin{filecontents*}[overwrite]{\jobname.bib}
+@misc{jkey, title={J}, author={Doe, J}, year={2024}}
+% @misc{jdead, title={D}, author={Doe, J}, year={2020}}
+\end{filecontents*}
+\begin{document}
+Text~\cite{jkey}.
+\bibliographystyle{plain}\bibliography{\jobname}
+\end{document}

package/fixtures/paper-sources/v8-jobname/tex-truth.json

@@ -0,0 +1,30 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [
+    "paper.bib"
+  ],
+  "bibdata": [
+    "paper"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "paper.bib"
+    ],
+    "keys": [
+      "jkey"
+    ],
+    "exit": 0,
+    "errors": []
+  },
+  "sha256": {
+    "paper.tex": "d68bcaabe9be4cbc07f5a1e672e8cd448e96bc9b5134be350d2906ee48834482",
+    "paper.bib": "bc5a9faf4bbdcdf22705c4c8b69d656382ab9d1d03f57388c00631c3aa6ebf70"
+  }
+}

package/fixtures/paper-sources/v9-two-bibliographies/one.bib

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

package/fixtures/paper-sources/v9-two-bibliographies/paper.tex

@@ -0,0 +1,7 @@
+\documentclass{article}
+\begin{document}
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{one}
+\bibliography{two}
+\end{document}

package/fixtures/paper-sources/v9-two-bibliographies/tex-truth.json

@@ -0,0 +1,35 @@
+{
+  "schema": 1,
+  "inputs": [
+    {
+      "path": "paper.tex",
+      "role": "body"
+    }
+  ],
+  "written": [],
+  "bibdata": [
+    "one",
+    "two"
+  ],
+  "bibtex": {
+    "ran": true,
+    "databases": [
+      "one.bib"
+    ],
+    "keys": [
+      "onekey"
+    ],
+    "exit": 2,
+    "errors": [
+      {
+        "message": "Illegal, another \\bibdata command",
+        "file": "paper.aux",
+        "line": 5
+      }
+    ]
+  },
+  "sha256": {
+    "paper.tex": "f45db61354f01066eb49ab48d240033bea99ed172f04a2c4558daca8640ce796",
+    "one.bib": "61cca311ca7d77570ed410fc536c655ba76d36168fc3e56068235a2c4b16f7bf"
+  }
+}

package/fixtures/paper-sources/v9-two-bibliographies/two.bib

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

package/fixtures/paper-typography/clean-paper/paper.tex

@@ -1,5 +1,5 @@
 \documentclass{acmart}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @inproceedings{reachable,
   title  = {A paper a reader can actually open},
   author = {Doe, Jane},

package/fixtures/paper-typography/messy-paper/paper.tex

@@ -1,5 +1,5 @@
 \documentclass{acmart}
-\begin{filecontents*}{refs.bib}
+\begin{filecontents*}[overwrite]{refs.bib}
 @inproceedings{unreachableone,
   title  = {No doi, no url, no arXiv id},
   author = {Doe, Jane},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperlint",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "description": "A linter for scientific papers written in LaTeX: catches mistakes before you submit to a conference or journal.",
   "type": "module",
   "license": "MIT",
@@ -20,6 +20,7 @@
   "dependencies": {
     "@eslint/markdown": "^8.0.3",
     "@eslint/plugin-kit": "^0.7.2",
+    "@retorquere/bibtex-parser": "^10.0.1",
     "@unified-latex/unified-latex-types": "^1.8.4",
     "@unified-latex/unified-latex-util-parse": "^1.8.4",
     "@unified-latex/unified-latex-util-visit": "^1.8.4",
@@ -37,7 +38,6 @@
     "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@retorquere/bibtex-parser": "^10.0.1",
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/release-notes-generator": "14.1.1",
     "@types/js-yaml": "^4.0.9",
@@ -56,14 +56,6 @@
     "typescript-eslint": "^8.70.1",
     "vitest": "^4.1.11"
   },
-  "peerDependencies": {
-    "@retorquere/bibtex-parser": "^10.0.1"
-  },
-  "peerDependenciesMeta": {
-    "@retorquere/bibtex-parser": {
-      "optional": true
-    }
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zernie/paperlint.git"

package/scripts/check.test.ts

@@ -6,7 +6,7 @@
 import assert from "node:assert/strict";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
-import { test } from "vitest";
+import { test, vi } from "vitest";
 import {
   GATES,
   NOT_COVERED,
@@ -122,6 +122,28 @@ test("🔴 runGates: a vitest gate that exits 0 but leaves no report is a FAILUR
   );
 });
 
+test("🔴 every gate runs with CI=true, as CI runs it — a local check is the CI check", () => {
+  // Libraries change behaviour under CI=true (typescript-eslint infers a single run and parses from
+  // disk): a gate run without it passed locally and failed in CI on 2026-10-07.
+  // Whatever the caller's shell says: on CI it is already "true", so the test sets it otherwise.
+  vi.stubEnv("CI", "false");
+  const seen: (string | undefined)[] = [];
+  runGates({
+    gates: [
+      { name: "a", job: "gates", run: ["true"] },
+      { name: "b", job: "gates", script: "build" },
+    ],
+    spawn: (_cmd, _args, options) => {
+      seen.push(options.env["CI"]);
+      return { status: 0 };
+    },
+    write: () => {},
+    ...capture().io,
+  });
+  vi.unstubAllEnvs();
+  assert.deepEqual(seen, ["true", "true"]);
+});
+
 test("run as a program with every gate passing: the plain verdict, exit 0", () => {
   // spawnSync is replaced before check.ts loads, so the real file runs end to end — every gate
   // "passes" in microseconds instead of the eleven real ones running.