paperlint 3.1.0 → 3.1.2

package/skills/tighten-paper/structure.test.mjs

@@ -0,0 +1,116 @@
+/**
+ * structure.mjs — the section inventory the tighten-paper skill prints for a human to read. No
+ * threshold, no finding: the table IS the product, so the whole printed table is compared.
+ */
+import assert from "node:assert/strict";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { expect, test } from "vitest";
+import { runNode, useTempDir, writeTree } from "../../test/support.mjs";
+
+const SCRIPT = join(dirname(fileURLToPath(import.meta.url)), "structure.mjs");
+const root = useTempDir("structure-");
+const words = (n) => Array.from({ length: n }, (_, i) => `w${i}`).join(" ");
+
+writeTree(root, {
+  // Every row shape: a sub-section before any section, carries notes with a score and a verdict,
+  // with only one of them, with neither, a numbered section with no note, and a free half — after
+  // Limitations, between References and the Appendix — larger than the body.
+  "full.md": `---
+title: x
+---
+Preamble before any heading.
+
+### Orphan sub
+${words(3)}
+
+<!-- carries: the claim · score: 7/10 · verdict: keep -->
+## 1 Introduction
+${words(10)}
+
+<!-- carries: a sub-point -->
+### 1.1 Detail
+${words(4)}
+
+### 1.2 Bare sub
+${words(2)}
+
+## 2 Method
+${words(6)}
+
+<!-- carries: only a verdict · verdict: CUT -->
+## 3 Results
+${words(5)}
+
+<!-- carries: score only · score: 4 -->
+## Discussion
+${words(3)}
+
+## Limitations
+${words(40)}
+
+<!-- carries: why the scope note -->
+### Scope
+${words(5)}
+
+## References
+[1] Not counted.
+
+<!-- carries: the raw tables -->
+## Appendix A
+${words(30)}
+`,
+  // References come first, so the free half runs from it to the end; no appendix.
+  "refs-first.md": `## 1 Intro\n${words(8)}\n\n## References\n[1] x\n\n## Ethical note\n${words(2)}\n`,
+  // Limitations then References and no appendix: the free half stops at References.
+  "no-appendix.md": `## 1 Intro\n${words(8)}\n\n## Limitations\n${words(3)}\n\n## References\n[1] x\n`,
+  // No free half at all.
+  // ...and a section with no words at all.
+  "body-only.md": `## 1 Intro\n${words(8)}\n\n## 2 Rest\n${words(4)}\n\n## 3 Empty\n`,
+});
+
+const run = (...args) => {
+  const r = runNode(
+    SCRIPT,
+    args.map((a) => (a.startsWith("--") ? a : join(root, a))),
+  );
+  return { ...r, stdout: r.stdout.replaceAll(root, "<root>") };
+};
+
+test("no file: the usage line, exit 0", () => {
+  assert.deepEqual(run(), {
+    status: 0,
+    stdout: "",
+    stderr:
+      "usage: node structure.mjs <paper.md> [--section=N]   (--flags-only is accepted and stays silent)\n",
+  });
+});
+
+test("--flags-only stays silent and exits 0 — every check moved to ESLint", () => {
+  assert.deepEqual(run("--flags-only", "full.md"), {
+    status: 0,
+    stdout: "",
+    stderr: "",
+  });
+});
+
+test.each(["full.md", "refs-first.md", "no-appendix.md", "body-only.md"])(
+  "the inventory of %s",
+  (file) => {
+    const r = run(file);
+    assert.deepEqual(
+      { status: r.status, stderr: r.stderr },
+      { status: 0, stderr: "" },
+    );
+    expect(r.stdout).toMatchSnapshot();
+  },
+);
+
+test("--section=1 keeps section 1 and its sub-sections, and nothing before it", () => {
+  const r = run("full.md", "--section=1");
+  assert.deepEqual(
+    { status: r.status, stderr: r.stderr },
+    { status: 0, stderr: "" },
+  );
+  expect(r.stdout).toMatchSnapshot();
+});

package/skills/verify-citations/SKILL.md

@@ -4,7 +4,7 @@ description: Verify every citation is a real work with correct metadata, and tha
 allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch, Agent]
 ---
 
-<!-- vigiles:sha256:2bb9f6f1233094cf compiled from skills/verify-citations/SKILL.md.spec.ts -->
+<!-- vigiles:sha256:3a7e10662d0084c4 compiled from skills/verify-citations/SKILL.md.spec.ts -->
 
 # verify-citations — every cite real, the delta explicit
 
@@ -133,17 +133,26 @@ node scripts/verify-cites.mjs cites.json --offline   # no network (everything de
 ```
 It prints per-cite `{id, verdict, reason, matched_db, matched_title?, flags?}` + a summary, and **exits 1 iff
 any `false` (fabrication)** — `unresolvable` alone is advisory and does NOT fail the gate, matching the
-narrowed-false philosophy. API responses are cached to `scripts/.cite-cache.json` (gitignored) so re-runs are
-cheap and deterministic.
+narrowed-false philosophy. API responses are cached to `~/.cache/paperlint/cite-cache.json`
+(`VERIFY_CITES_CACHE` overrides) so re-runs are cheap and deterministic — outside the installed package,
+which `npm ci` wipes.
 
-## 5a. Both checks run on every `paperlint build`
+## 5a. Both checks run on every `paperlint build` — from a committed cache
 
 `npx paperlint build` runs `verify-cites` and `bib-authors` over the paper's bibliography after the PDF is
 built and records the verdicts, with the SHA-256 of the bibliography it checked, in
 `<paper>/_build/references.json`. `paperlint lint` reads that record offline: `paper/cite-exists` and
 `paper/author-list` report a failing entry on its own line, `paper/refs-fresh` says when the bibliography
 changed since, and `paper/refs-checked` warns when nothing was recorded or the build had no network. The
-step never fails the build. Run the scripts by hand (below) to read a single verdict in full.
+step never fails the build.
+
+What the services ANSWERED is kept in `<paper>/repro/references-cache.json` — **commit it**. A build asks
+only the questions that file cannot answer (a new or edited entry, or an answer older than 30 days), so an
+unchanged bibliography builds with no network at all, in CI too, until its answers age out. It holds responses, never verdicts: the verdicts are derived again on
+every build. A service that refuses (429, HTML instead of JSON, a timeout) is not asked again for the rest of the
+build (the requests already in flight still land); the entries it would have answered say `not asked: <service>: <reason>`, and DBLP's become
+`authors: unchecked`. Answers are asked again after 30 days; to refresh one sooner, delete its entry, or delete the file. Details:
+`docs/references.md` in the package. Run the scripts by hand (below) to read a single verdict in full.
 
 ## 5b. The author-list gate — `scripts/bib-authors.mjs`
 
@@ -179,11 +188,18 @@ difference is real and not a metadata glitch. Entries that themselves declare a
 scope (a preprint entry is allowed to carry preprint metadata).
 
 ⚠️ **Discovery credit, and why it is NOT a dependency.** The class was found by running **rebiber**
-(`yuchenlin/rebiber`), which rewrites bib entries into their DBLP records. We deliberately do not depend on
-it: its install fights modern setuptools (the `bibtexparser` wheel dies with `AttributeError:
-install_layout`), and its *output* replaces our entries with DBLP's very long official booktitles — wrong for
-a page-limited paper. We needed the **comparison**, not the rewrite, and that is one fetch with zero deps.
-Note also that live DBLP beat rebiber's bundled dump: `raji2021benchmark` was found only by the live query.
+(`yuchenlin/rebiber`), which rewrites bib entries into their DBLP records. Re-measured 2026-09-27 on rebiber
+1.4.0 (GitHub commit `b917e36`, the pin in `render-paper/checkers-requirements.txt`; the PyPI package is
+a 2021 release upstream disowns):
+- **Install: no longer broken, but heavy.** It installs in 36 s in a clean venv (bibtexparser 2.0.1 wheel,
+  rebiber built from source) — and carries **409 MB** of bundled venue data.
+- **Rewrites: now optional.** `--dry-run --report` previews and leaves the file untouched; `-s True` shortens
+  venues (NAACL 2019 becomes `Proc. of NAACL-HLT` instead of a 160-character booktitle).
+- **Bundled data still misses what live DBLP finds.** `raji2021benchmark` stayed an arXiv entry, local
+  index and `--live-lookup` alike, as it did in August.
+
+So the reason not to depend on it is now scope, not breakage: we need the **comparison** of an author list
+against the published record, not a rewrite of the entry, and that is one DBLP query with zero dependencies.
 
 🔴 **Two design decisions that are load-bearing, both learned by measurement the same day:**
 1. **Compare surname SEQUENCES, nothing else.** A first cut reported 13 differences of which **11 were
@@ -259,7 +275,7 @@ the same one MedSci Skills (arXiv:2606.09500) closes with `verify_refs.py`.
 | year | ±1 on a title search | exact, and only against the record that dates the cited version |
 | preprint→published | not asked | arXiv `journal_ref`/`doi` present and no venue named → say so |
 | what it could not check | folded into `unresolvable` | **enumerated, one rule per reason, never counted as verified** |
-| tests | `verify-cites.test.mjs` — not a `*.harness.mjs`, so `npx vigiles test` never runs it | `eslint-rules/ref-facts.harness.mjs` + `.claude/skills/paper-pipeline/scripts/extract-ref-facts.harness.mjs`, plus `eslint-rules/ref-facts.mutations.mjs` |
+| tests | `verify-cites.test.mjs` — not a `*.harness.mjs`, so `npx vigiles test` never runs it | `src/references.test.ts` (the `refs/*` rules in `src/reference-rules.ts`) + `skills/paper-pipeline/scripts/extract-ref-facts.test.mjs` and `.harness.mjs`, under the package's 100% line and branch coverage gate |
 
 **The uncovered set is the point.** A reference with no resolvable identifier is a FINDING here
 (`refs/no-identifier`), and every partial comparison is another (`refs/partial-check`, one messageId per
@@ -274,9 +290,9 @@ and its `.bib` regex required a closing `}` on its own line, which neither real
 references`). The `.bib` half now goes through `@retorquere/bibtex-parser`. Two of the three papers are
 therefore being checked for the first time.
 
-**Every check is watched failing.** `node eslint-rules/ref-facts.mutations.mjs` neuters each rule in turn
-and requires the harness to go red at the named case — 21 mutations, all killed, and three of them were
-findings about the TEST rather than the rule. Run it after any edit to the rules.
+**Every check is exercised.** `src/references.test.ts` drives the `refs/*` rules, and `npm run coverage`
+fails CI if any line or branch of them goes unexercised. Run `npx vitest run src/references.test.ts`
+after any edit to the rules.
 
 ## 6. Record the verdict
 

package/skills/verify-citations/SKILL.md.spec.ts

@@ -149,17 +149,26 @@ node scripts/verify-cites.mjs cites.json --offline   # no network (everything de
 \`\`\`
 It prints per-cite \`{id, verdict, reason, matched_db, matched_title?, flags?}\` + a summary, and **exits 1 iff
 any \`false\` (fabrication)** — \`unresolvable\` alone is advisory and does NOT fail the gate, matching the
-narrowed-false philosophy. API responses are cached to \`scripts/.cite-cache.json\` (gitignored) so re-runs are
-cheap and deterministic.
+narrowed-false philosophy. API responses are cached to \`~/.cache/paperlint/cite-cache.json\`
+(\`VERIFY_CITES_CACHE\` overrides) so re-runs are cheap and deterministic — outside the installed package,
+which \`npm ci\` wipes.
 
-## 5a. Both checks run on every \`paperlint build\`
+## 5a. Both checks run on every \`paperlint build\` — from a committed cache
 
 \`npx paperlint build\` runs \`verify-cites\` and \`bib-authors\` over the paper's bibliography after the PDF is
 built and records the verdicts, with the SHA-256 of the bibliography it checked, in
 \`<paper>/_build/references.json\`. \`paperlint lint\` reads that record offline: \`paper/cite-exists\` and
 \`paper/author-list\` report a failing entry on its own line, \`paper/refs-fresh\` says when the bibliography
 changed since, and \`paper/refs-checked\` warns when nothing was recorded or the build had no network. The
-step never fails the build. Run the scripts by hand (below) to read a single verdict in full.
+step never fails the build.
+
+What the services ANSWERED is kept in \`<paper>/repro/references-cache.json\` — **commit it**. A build asks
+only the questions that file cannot answer (a new or edited entry, or an answer older than 30 days), so an
+unchanged bibliography builds with no network at all, in CI too, until its answers age out. It holds responses, never verdicts: the verdicts are derived again on
+every build. A service that refuses (429, HTML instead of JSON, a timeout) is not asked again for the rest of the
+build (the requests already in flight still land); the entries it would have answered say \`not asked: <service>: <reason>\`, and DBLP's become
+\`authors: unchecked\`. Answers are asked again after 30 days; to refresh one sooner, delete its entry, or delete the file. Details:
+\`docs/references.md\` in the package. Run the scripts by hand (below) to read a single verdict in full.
 
 ## 5b. The author-list gate — \`scripts/bib-authors.mjs\`
 
@@ -195,11 +204,18 @@ difference is real and not a metadata glitch. Entries that themselves declare a
 scope (a preprint entry is allowed to carry preprint metadata).
 
 ⚠️ **Discovery credit, and why it is NOT a dependency.** The class was found by running **rebiber**
-(\`yuchenlin/rebiber\`), which rewrites bib entries into their DBLP records. We deliberately do not depend on
-it: its install fights modern setuptools (the \`bibtexparser\` wheel dies with \`AttributeError:
-install_layout\`), and its *output* replaces our entries with DBLP's very long official booktitles — wrong for
-a page-limited paper. We needed the **comparison**, not the rewrite, and that is one fetch with zero deps.
-Note also that live DBLP beat rebiber's bundled dump: \`raji2021benchmark\` was found only by the live query.
+(\`yuchenlin/rebiber\`), which rewrites bib entries into their DBLP records. Re-measured 2026-09-27 on rebiber
+1.4.0 (GitHub commit \`b917e36\`, the pin in \`render-paper/checkers-requirements.txt\`; the PyPI package is
+a 2021 release upstream disowns):
+- **Install: no longer broken, but heavy.** It installs in 36 s in a clean venv (bibtexparser 2.0.1 wheel,
+  rebiber built from source) — and carries **409 MB** of bundled venue data.
+- **Rewrites: now optional.** \`--dry-run --report\` previews and leaves the file untouched; \`-s True\` shortens
+  venues (NAACL 2019 becomes \`Proc. of NAACL-HLT\` instead of a 160-character booktitle).
+- **Bundled data still misses what live DBLP finds.** \`raji2021benchmark\` stayed an arXiv entry, local
+  index and \`--live-lookup\` alike, as it did in August.
+
+So the reason not to depend on it is now scope, not breakage: we need the **comparison** of an author list
+against the published record, not a rewrite of the entry, and that is one DBLP query with zero dependencies.
 
 🔴 **Two design decisions that are load-bearing, both learned by measurement the same day:**
 1. **Compare surname SEQUENCES, nothing else.** A first cut reported 13 differences of which **11 were
@@ -275,7 +291,7 @@ the same one MedSci Skills (arXiv:2606.09500) closes with \`verify_refs.py\`.
 | year | ±1 on a title search | exact, and only against the record that dates the cited version |
 | preprint→published | not asked | arXiv \`journal_ref\`/\`doi\` present and no venue named → say so |
 | what it could not check | folded into \`unresolvable\` | **enumerated, one rule per reason, never counted as verified** |
-| tests | \`verify-cites.test.mjs\` — not a \`*.harness.mjs\`, so \`npx vigiles test\` never runs it | \`eslint-rules/ref-facts.harness.mjs\` + \`.claude/skills/paper-pipeline/scripts/extract-ref-facts.harness.mjs\`, plus \`eslint-rules/ref-facts.mutations.mjs\` |
+| tests | \`verify-cites.test.mjs\` — not a \`*.harness.mjs\`, so \`npx vigiles test\` never runs it | \`src/references.test.ts\` (the \`refs/*\` rules in \`src/reference-rules.ts\`) + \`skills/paper-pipeline/scripts/extract-ref-facts.test.mjs\` and \`.harness.mjs\`, under the package's 100% line and branch coverage gate |
 
 **The uncovered set is the point.** A reference with no resolvable identifier is a FINDING here
 (\`refs/no-identifier\`), and every partial comparison is another (\`refs/partial-check\`, one messageId per
@@ -290,9 +306,9 @@ and its \`.bib\` regex required a closing \`}\` on its own line, which neither r
 references\`). The \`.bib\` half now goes through \`@retorquere/bibtex-parser\`. Two of the three papers are
 therefore being checked for the first time.
 
-**Every check is watched failing.** \`node eslint-rules/ref-facts.mutations.mjs\` neuters each rule in turn
-and requires the harness to go red at the named case — 21 mutations, all killed, and three of them were
-findings about the TEST rather than the rule. Run it after any edit to the rules.
+**Every check is exercised.** \`src/references.test.ts\` drives the \`refs/*\` rules, and \`npm run coverage\`
+fails CI if any line or branch of them goes unexercised. Run \`npx vitest run src/references.test.ts\`
+after any edit to the rules.
 
 ## 6. Record the verdict
 

package/skills/verify-citations/scripts/__snapshots__/verify-cites.net.test.mjs.snap

@@ -0,0 +1,253 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`CVEs: found by count, found by list, not found, NVD down, and a malformed id 1`] = `
+{
+  "calls": [
+    "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2024-0001",
+    "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2024-0002",
+    "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2024-0003",
+    "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2024-0004",
+    "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2024-0005",
+  ],
+  "results": [
+    {
+      "id": "cve-2024-0001",
+      "matched_db": "nvd",
+      "matched_title": "cve-2024-0001",
+      "reason": "confirmed by nvd — "cve-2024-0001"",
+      "verdict": "true",
+    },
+    {
+      "id": "CVE-2024-0002",
+      "matched_db": "nvd",
+      "matched_title": "CVE-2024-0002",
+      "reason": "confirmed by nvd — "CVE-2024-0002"",
+      "verdict": "true",
+    },
+    {
+      "id": "CVE-2024-0003",
+      "matched_db": null,
+      "reason": "RESOLVED_TO_NOTHING: the provided CVE CVE-2024-0003 resolves to no record (checked nvd) — fabrication evidence",
+      "verdict": "false",
+    },
+    {
+      "id": "CVE-2024-0004",
+      "matched_db": null,
+      "reason": "all databases unreachable (network/rate-limit) — degraded to unresolvable, never to false",
+      "refused": [
+        "nvd: http 500",
+      ],
+      "verdict": "unresolvable",
+    },
+    {
+      "id": "CVE-2024-0005",
+      "matched_db": null,
+      "reason": "RESOLVED_TO_NOTHING: the provided CVE CVE-2024-0005 resolves to no record (checked nvd) — fabrication evidence",
+      "verdict": "false",
+    },
+    {
+      "id": "CVE-24-1",
+      "matched_db": null,
+      "reason": "RESOLVED_TO_NOTHING: the provided CVE CVE-24-1 resolves to no record (checked nvd) — fabrication evidence",
+      "verdict": "false",
+    },
+  ],
+}
+`;
+
+exports[`S2 and arXiv unreachable for an arXiv id 1`] = `
+{
+  "calls": [
+    "https://api.semanticscholar.org/graph/v1/paper/arXiv%3A1706.03762?fields=title,year",
+    "https://export.arxiv.org/api/query?id_list=1706.03762&max_results=1",
+  ],
+  "result": {
+    "id": "x",
+    "matched_db": null,
+    "reason": "all databases unreachable (network/rate-limit) — degraded to unresolvable, never to false",
+    "refused": [
+      "semantic_scholar: http 500",
+      "arxiv: http 500",
+    ],
+    "verdict": "unresolvable",
+  },
+}
+`;
+
+exports[`a DOI every registry resolves to the claimed paper, and the authority knows: true 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works/10.1%2Fx",
+  ],
+  "result": {
+    "id": "v",
+    "matched_db": "crossref",
+    "matched_title": "Attention Is All You Need",
+    "reason": "confirmed by crossref — "Attention Is All You Need"",
+    "verdict": "true",
+  },
+}
+`;
+
+exports[`a DOI nobody knows, and the authority says it does not exist: false 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works/10.1%2Fnope",
+    "https://api.openalex.org/works/doi:10.1%2Fnope",
+    "https://api.semanticscholar.org/graph/v1/paper/DOI%3A10.1%2Fnope?fields=title,year",
+    "https://doi.org/api/handles/10.1/nope",
+  ],
+  "result": {
+    "id": "f",
+    "matched_db": null,
+    "reason": "RESOLVED_TO_NOTHING: DOI 10.1/nope does not resolve at the DOI authority (doi.org handle responseCode 100 = not found) — fabrication evidence",
+    "verdict": "false",
+  },
+}
+`;
+
+exports[`a title only: every registry's search endpoint, hits and all 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works?query.bibliographic=Attention%20Is%20All%20You%20Need&rows=5",
+    "https://api.openalex.org/works?search=Attention%20Is%20All%20You%20Need&per-page=5",
+    "https://api.semanticscholar.org/graph/v1/paper/search?query=Attention%20Is%20All%20You%20Need&fields=title,year&limit=5",
+    "https://export.arxiv.org/api/query?search_query=ti:%22Attention%20Is%20All%20You%20Need%22&max_results=5",
+  ],
+  "result": {
+    "id": "t",
+    "matched_db": "arxiv",
+    "matched_title": "Attention Is All You Need",
+    "reason": "confirmed by arxiv — "Attention Is All You Need"",
+    "verdict": "true",
+  },
+}
+`;
+
+exports[`a title search that cannot reach any registry is unresolvable 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works?query.bibliographic=Attention%20Is%20All%20You%20Need&rows=5",
+    "https://api.openalex.org/works?search=Attention%20Is%20All%20You%20Need&per-page=5",
+    "https://api.semanticscholar.org/graph/v1/paper/search?query=Attention%20Is%20All%20You%20Need&fields=title,year&limit=5",
+    "https://export.arxiv.org/api/query?search_query=ti:%22Attention%20Is%20All%20You%20Need%22&max_results=5",
+  ],
+  "result": {
+    "id": "d",
+    "matched_db": null,
+    "reason": "all databases unreachable (network/rate-limit) — degraded to unresolvable, never to false",
+    "refused": [
+      "crossref: http 500",
+      "openalex: http 502",
+      "semantic_scholar: timeout",
+      "arxiv: http 503",
+    ],
+    "verdict": "unresolvable",
+  },
+}
+`;
+
+exports[`a title search whose answers are empty or shapeless is a miss, not a match 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works?query.bibliographic=Attention%20Is%20All%20You%20Need&rows=5",
+    "https://api.openalex.org/works?search=Attention%20Is%20All%20You%20Need&per-page=5",
+    "https://api.semanticscholar.org/graph/v1/paper/search?query=Attention%20Is%20All%20You%20Need&fields=title,year&limit=5",
+    "https://export.arxiv.org/api/query?search_query=ti:%22Attention%20Is%20All%20You%20Need%22&max_results=5",
+  ],
+  "result": {
+    "id": "e",
+    "matched_db": null,
+    "reason": "not found by title in any database (no resolvable id to disprove) — could be a legit unindexed/regional/pre-digital work, NOT fabrication",
+    "verdict": "unresolvable",
+  },
+}
+`;
+
+exports[`an arXiv id nobody has: the arXiv API's empty feed and S2's 404 1`] = `
+{
+  "calls": [
+    "https://api.semanticscholar.org/graph/v1/paper/arXiv%3A9999.99999?fields=title,year",
+    "https://export.arxiv.org/api/query?id_list=9999.99999&max_results=1",
+  ],
+  "result": {
+    "id": "n",
+    "matched_db": null,
+    "reason": "RESOLVED_TO_NOTHING: arXiv id 9999.99999 returns a definitive not-found from the reachable arXiv API — fabrication evidence",
+    "verdict": "false",
+  },
+}
+`;
+
+exports[`an arXiv id: Semantic Scholar by arXiv id, the arXiv API by id_list 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works?query.bibliographic=Attention%20Is%20All%20You%20Need&rows=5",
+    "https://api.openalex.org/works?search=Attention%20Is%20All%20You%20Need&per-page=5",
+    "https://api.semanticscholar.org/graph/v1/paper/arXiv%3A1706.03762?fields=title,year",
+  ],
+  "result": {
+    "id": "a",
+    "matched_db": "semantic_scholar",
+    "matched_title": "Attention Is All You Need",
+    "reason": "confirmed by semantic_scholar — "Attention Is All You Need"",
+    "refused": [
+      "crossref: Error: unrouted request: https://api.crossref.org/works?query.bibliographic=Attention%20Is%20All%20You%20Need&rows=5",
+      "openalex: Error: unrouted request: https://api.openalex.org/works?search=Attention%20Is%20All%20You%20Need&per-page=5",
+    ],
+    "verdict": "true",
+  },
+}
+`;
+
+exports[`every registry down (429, 503, 403, a thrown error): unresolvable, never false 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works/10.1%2Fx",
+    "https://api.openalex.org/works/doi:10.1%2Fx",
+    "https://api.semanticscholar.org/graph/v1/paper/DOI%3A10.1%2Fx?fields=title,year",
+    "https://doi.org/api/handles/10.1/x",
+  ],
+  "result": {
+    "id": "u",
+    "matched_db": null,
+    "reason": "all databases unreachable (network/rate-limit) — degraded to unresolvable, never to false",
+    "refused": [
+      "crossref: http 429",
+      "openalex: http 503",
+      "semantic_scholar: http 403",
+      "doi_authority: TypeError: fetch failed",
+    ],
+    "verdict": "unresolvable",
+  },
+}
+`;
+
+exports[`offline: no request at all, the verdict from the citation alone 1`] = `
+{
+  "calls": [],
+  "result": {
+    "id": "o",
+    "matched_db": null,
+    "reason": "all databases unreachable (network/rate-limit) — degraded to unresolvable, never to false",
+    "verdict": "unresolvable",
+  },
+}
+`;
+
+exports[`records with fields missing: no title, a subtitle, a year only in \`published\`, no id 1`] = `
+{
+  "calls": [
+    "https://api.crossref.org/works/10.1%2Fx",
+    "https://api.openalex.org/works/doi:10.1%2Fx",
+    "https://api.semanticscholar.org/graph/v1/paper/DOI%3A10.1%2Fx?fields=title,year",
+    "https://doi.org/api/handles/10.1/x",
+  ],
+  "result": {
+    "id": "m",
+    "matched_db": null,
+    "reason": "DOI_MISMATCH: identifier resolves via crossref to an UNRELATED paper "" (claimed "Attention Is All You Need") — DOI misdirection",
+    "verdict": "false",
+  },
+}
+`;