paperlint 3.2.0 → 4.0.0

package/eslint.config.mjs

@@ -414,6 +414,13 @@ export default [
       // `any` switches the checker off for everything it flows into. The preset has it too; named
       // here so that dropping the preset cannot drop it.
       "@typescript-eslint/no-explicit-any": "error",
+      // A type assertion (`x as T`, `<T>x`) is a claim the checker takes on trust (#126). A value
+      // from outside is parsed or guarded where it enters; a brand is minted by its own checked
+      // constructor. `as const` asserts nothing about the value and stays allowed.
+      "@typescript-eslint/consistent-type-assertions": [
+        "error",
+        { assertionStyle: "never" },
+      ],
       // The behaviour rules of the `.mjs` block, for the same reasons: each changes what the code
       // DOES, not how it looks, and a regex that escapes the wrong thing searches for the wrong thing.
       "no-empty": "error",

package/fixtures/install-path-literals/clean.fixture.mjs

@@ -1,3 +1,3 @@
 // Clean: every answer to *where* comes from the port.
 import { consumerRoot } from "../../skills/paper-pipeline/scripts/consumer.mjs";
-export const LEDGER = (env, cwd) => `${consumerRoot({ env, cwd })}/runs.jsonl`;
+export const CACHE = (env, cwd) => `${consumerRoot({ env, cwd })}/cache.json`;

package/fixtures/install-path-literals/clean.md

@@ -1,6 +1,6 @@
 ---
 name: planted-clean
-allowed-tools: [Bash(node ${CLAUDE_SKILL_DIR}/../paper-pipeline/scripts/ledger.mjs:*)]
+allowed-tools: [Bash(node ${CLAUDE_SKILL_DIR}/../paper-pipeline/scripts/extract-ref-facts.mjs:*)]
 ---
 
 # A skill that asks the port where it is
@@ -8,7 +8,7 @@ allowed-tools: [Bash(node ${CLAUDE_SKILL_DIR}/../paper-pipeline/scripts/ledger.m
 Record the verdict:
 
 ```
-node ${CLAUDE_SKILL_DIR}/../paper-pipeline/scripts/ledger.mjs record planted . FINDING 1 report.md
+node ${CLAUDE_SKILL_DIR}/../paper-pipeline/scripts/extract-ref-facts.mjs planted
 ```
 
 Paths inside the repository, such as `skills/paper-pipeline/scripts/consumer.mjs`, are not

package/fixtures/install-path-literals/defect.fixture.mjs

@@ -1,3 +1,3 @@
 // Planted: a shipped module betting on one channel, in both literal forms.
-export const LEDGER = "node_modules/research-paper-pipeline/runs.jsonl";
+export const CACHE = "node_modules/research-paper-pipeline/cache.json";
 export const skill = (n) => `.claude/skills/${n}/SKILL.md`;

package/fixtures/install-path-literals/defect.md

@@ -1,6 +1,6 @@
 ---
 name: planted-defect
-allowed-tools: [Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
+allowed-tools: [Bash(node .claude/skills/paper-pipeline/scripts/extract-ref-facts.mjs:*)]
 ---
 
 # A skill that bets on one delivery channel
@@ -8,7 +8,7 @@ allowed-tools: [Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
 Record the verdict:
 
 ```
-node .claude/skills/paper-pipeline/scripts/ledger.mjs record planted . FINDING 1 report.md
+node .claude/skills/paper-pipeline/scripts/extract-ref-facts.mjs planted
 ```
 
 The module lives at `node_modules/research-paper-pipeline/skills/paper-pipeline/scripts/consumer.mjs`.

package/hooks/paper-status-gates.sh

@@ -2,7 +2,7 @@
 # paper-status-gates.sh — NOT A HOOK. This is a TOOL invoked by `paper-status-gates.hook.mjs`,
 # which owns the event routing and decides WHICH paper (if any) an edit concerned.
 #
-#   --surface <paper-dir>   print the readiness verdict + run the pipeline checker
+#   --surface <paper-dir>   print the readiness verdict and the unrun gates
 #
 # 🔴 WHAT LEFT THIS FILE AND WHY IT MATTERS. It used to read its payload with
 # `INPUT="${CLAUDE_TOOL_INPUT:-}"` plus a `timeout 1 cat` fallback and then grep that blob for a
@@ -28,22 +28,21 @@ case "$pdir_name" in
 esac
 
 # ── WHERE THE CONSUMER'S THINGS ARE — READ, NOT ASSUMED ─────────────────────
-# Both paths come from the one declaration every other carrier of this package reads, the
-# project's root paperlint.json (optional — absent means every default):
+# The papers path comes from the one declaration every other carrier of this package reads, the
+# project's root paperlint.json (optional — absent means the default):
 #
-#   { "papersDir": "docs/papers", "scripts": "tools/pipeline" }
+#   { "papersDir": "docs/papers" }
 #
 # ⚠️ `node -p` RATHER THAN grep/sed ON THE FILE. A JSON value is not a line of text: it can
 # be quoted, escaped, or spread across lines, and a pattern that gets it right today gets it
 # wrong on the first reformat — silently, by producing a root that matches nothing. Node is
-# already a hard dependency of the checker this script runs, so there is no new requirement.
+# already a hard dependency of the hook that runs this script, so there is no new requirement.
 ROOT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 read_key() { # $1 = key, $2 = default
   node -p "((c) => c['$1'] ?? '$2')((() => { try { return require('$ROOT_DIR/paperlint.json') } catch { return {} } })())" \
     2>/dev/null || echo "$2"
 }
 papers_root="$(read_key papersDir papers)"
-scripts_root="$(read_key scripts .claude/skills/paper-pipeline/scripts)"
 
 # 🔴 AN UNUSABLE ROOT EXITS, IT DOES NOT BUILD A PATH FROM IT. `node -p` prints `undefined` for a
 # key whose value is literally `null` (`?? ` only catches null/undefined AFTER the object lookup,
@@ -69,18 +68,9 @@ else
   echo "   whether this paper is submittable, which is the one question it exists to answer." >&2
 fi
 
-CHECK="$ROOT_DIR/$scripts_root/pipeline-check.mjs"
-if [ -f "$CHECK" ]; then
-  # The real checker: stale continuous passes, gates missing their declared inputs, a study that
-  # ran before the claim was stated, submit-access inside the moderation window, a verdict that is
-  # only a percentage, unrun gates. Advisory, always exit 0.
-  node "$CHECK" "$ROOT_DIR/$pdir" >&2 || true
-else
-  # Fallback for a checkout without the skill tree — the old crude surface.
-  gates=$(grep -E '☐' "$STATUS" 2>/dev/null | grep -iE 'study-accepted|pc-panel|harden|verify.?citations' || true)
-  if [ -n "$gates" ]; then
-    echo "⚠️ UNRUN GATES in $pdir/PIPELINE-STATUS.md (☐ — run them, don't 'anti-churn'-skip):" >&2
-    echo "$gates" | sed -E 's/\|.*//; s/^\| */   /' >&2
-  fi
+gates=$(grep -E '☐' "$STATUS" 2>/dev/null | grep -iE 'study-accepted|pc-panel|harden|verify.?citations' || true)
+if [ -n "$gates" ]; then
+  echo "⚠️ UNRUN GATES in $pdir/PIPELINE-STATUS.md (☐ — run them, don't 'anti-churn'-skip):" >&2
+  echo "$gates" | sed -E 's/\|.*//; s/^\| */   /' >&2
 fi
 exit 0

package/lib/paper-config.harness.mjs

@@ -253,7 +253,7 @@ const loaded = await Promise.all(
   );
   check(
     "and the scan found the readers it must find — the skill scripts' keys and PaperlintConfig's",
-    ["ledger", "citeChecks", "triggerCases", "papersDir", "rules"].every((k) =>
+    ["scripts", "timezone", "triggerCases", "papersDir", "rules"].every((k) =>
       readKeys.has(k),
     ),
   );

package/lib/paper-config.ts

@@ -138,11 +138,9 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
     "the venue preset: paperlint:<name> or ./path.jsonc — the pdf/ venue rules, paperlint build",
   kind: "the kind of paper, whose page limit applies — pdf/limits",
   pdf: "where the built PDF is, relative to the paper, when it is not paper.pdf — the facts",
-  ledger: "the run ledger — skills/paper-pipeline/scripts/consumer.mjs",
   scripts: "how skill prose names the scripts — consumer.mjs",
-  timezone: "dates in the ledger — consumer.mjs",
+  timezone: "the zone deadline anchors are written in — consumer.mjs",
   contactEmail: "the polite-pool address for citation lookups — consumer.mjs",
-  citeChecks: "the consumer's citation checkers — run-mechanical.mjs",
   triggerCases:
     "the consumer's own skill trigger cases — lib/skill-trigger-cases.mjs",
   $comment: "a note for humans (JSON Schema's own comment keyword); ignored",
@@ -152,10 +150,8 @@ export const SETTINGS_KEYS: Readonly<Record<string, string>> = Object.freeze({
 export const ROOT_ONLY_KEYS: readonly string[] = Object.freeze([
   "papersDir",
   "structure",
-  "ledger",
   "scripts",
   "timezone",
   "contactEmail",
-  "citeChecks",
   "triggerCases",
 ]);