paperlint 3.1.3 → 4.0.0

package/dist/lib/markdown.js

@@ -0,0 +1,302 @@
+let md = null;
+try {
+    const { default: MarkdownIt } = await import("markdown-it");
+    md = new MarkdownIt();
+}
+catch {
+    md = null;
+}
+/**
+ * Whether the parser resolved. A linter must check this ITSELF and say out loud that
+ * its heading checks are off: with no parser `headings()` returns an empty list, and
+ * silent emptiness reads as "the document has no headings", that is, as a clean
+ * document. The nudge lives in the linters, because by contract (see the header) this
+ * file has no right to produce a single finding.
+ */
+export const MD_AVAILABLE = () => md !== null;
+/** markdown-it's block tokens for `text`, or null when it did not resolve. A test passes its own. */
+const defaultParse = () => {
+    const parser = md;
+    return parser === null ? null : (text) => parser.parse(text, {});
+};
+/**
+ * The frontmatter is BLANKED with spaces, not cut out: the offsets must stay the
+ * same, because the checks cut the document by offset. Blanking is necessary — inside
+ * a YAML block scalar a line indented by two spaces (`  ## Foo`) is a real ATX
+ * heading to CommonMark, and without blanking the frontmatter starts supplying
+ * sections.
+ */
+const FRONTMATTER_RE = /^---[ \t]*\r?\n[\s\S]*?\r?\n---[ \t]*(?=\r?\n|$)/;
+export function blankFrontmatter(text) {
+    const m = FRONTMATTER_RE.exec(text);
+    return m ? m[0].replace(/[^\n]/g, " ") + text.slice(m[0].length) : text;
+}
+/**
+ * The frontmatter body (between the fences), or `null` — if the file opens without one.
+ *
+ * Added 2026-08-20, when eight places in `.claude/**` cut the frontmatter with eight
+ * slightly different regexes: some knew about `\r\n`, some did not; some required a
+ * newline after the closing fence, some did not. The difference between them is not
+ * style, it is a different answer on one and the same file.
+ *
+ * ⚠️ This is NOT a parser and does not claim to be: `---` frontmatter is not markdown,
+ * no markdown parser models it (the analysis is in the root `CLAUDE.md`, "Considered
+ * and rejected: gray-matter"). The value here is one fence instead of eight, and the
+ * parsing of VALUES is done by `js-yaml` at the caller.
+ */
+export function frontmatterBlock(text) {
+    const m = FRONTMATTER_RE.exec(text);
+    if (!m)
+        return null;
+    const inner = m[0]
+        .replace(/^---[ \t]*\r?\n/, "")
+        .replace(/\r?\n---[ \t]*$/, "");
+    return inner;
+}
+/**
+ * The document WITHOUT the frontmatter — the block is cut out together with the
+ * newline after it.
+ *
+ * Differs from {@link blankFrontmatter} in that the offsets SHIFT. Both forms are
+ * needed and both have been used already: blanking — where character positions are
+ * later shown to the user; cutting — where the text is merely counted. Choose by what
+ * the caller does, not by taste.
+ */
+export function stripFrontmatter(text) {
+    const m = FRONTMATTER_RE.exec(text);
+    return m ? text.slice(m[0].length).replace(/^\r?\n/, "") : text;
+}
+/** Line-start offsets — so that `token.map` becomes a position in the source string. */
+function lineStarts(text) {
+    const out = [0];
+    for (let i = 0; i < text.length; i++)
+        if (text[i] === "\n")
+            out.push(i + 1);
+    return out;
+}
+/**
+ * All the document's headings: `[{ depth, text, line, offset }]`, in order of occurrence.
+ *
+ * `offset` — the index of the start of the heading's line IN THE SAME text that was
+ * passed in, in `slice`/`indexOf` units (UTF-16), because those are exactly what the
+ * checks cut the document with. `line` — 0-based line number. `text` — without the
+ * hashes, trimmed at the edges.
+ *
+ * ⚠️ ATX ONLY (`## Heading`). Setext (`Heading\n---`) is deliberately NOT counted as a
+ * heading: in this knowledge base `---` is a prose separator, and a paragraph it stands
+ * under without a blank line would become a level-2 heading per CommonMark. The former
+ * regexps knew only ATX, so this preserves the contract rather than narrowing it.
+ */
+export function headings(text, { parse = defaultParse() } = {}) {
+    if (parse === null)
+        return [];
+    const toks = parse(blankFrontmatter(text));
+    const starts = lineStarts(text);
+    const out = [];
+    for (const [i, t] of toks.entries()) {
+        if (t.type !== "heading_open" || !t.map)
+            continue;
+        if (!t.markup || !t.markup.startsWith("#"))
+            continue; // setext — see the caveat above
+        // markdown-it follows `heading_open` with its `inline` token and maps blocks to lines of the
+        // parsed text; the fallbacks are for a token stream that does not (another parser version).
+        const inline = toks[i + 1];
+        out.push({
+            depth: Number(t.tag.slice(1)),
+            text: inline?.type === "inline" ? inline.content.trim() : "",
+            line: t.map[0],
+            offset: starts[t.map[0]] ?? 0,
+        });
+    }
+    return out;
+}
+/**
+ * Slicing the document into chunks "a heading + everything up to the next heading FROM
+ * THE SAME RANGE of levels". → `[{ heading, raw, body }]`.
+ *
+ * This is exactly what four scripts did as `split(/^(?=## )/m)` and
+ * `split(/^(?=#{2,3} )/m)`. The shape of the expression lied about the intent: "two or
+ * three hashes" is about CHARACTERS, while what is needed is the LEVEL, and `#{2,3}`
+ * also caught a hash inside a ```-block, that is, it cut a quotation from someone
+ * else's paper as a section of its own.
+ *
+ * `heading` — `null` on the zeroth element (the preamble before the first heading). It
+ * is ALWAYS there, including empty: the former `split` also always returned the chunk
+ * before the first separator as its zeroth element, and callers rely on that
+ * (`sub === chunk` in `artifact-coverage` meant "there are no subsections").
+ *
+ * `raw` — WITH the heading line (it is used to count `§` references and bold numbers,
+ * which occur in the heading itself too), `body` — without it (it is used to count words).
+ *
+ * 2026-08-11: moved here rather than copied into every script, because the chunk
+ * boundary is the one place where an off-by-one is easy, and such a mistake has already
+ * happened (`recordBlock` in `skill-corpus.mjs` returned a single "#" character for all
+ * 21 skills).
+ */
+export function splitSections(text, { min = 2, max = 6 } = {}) {
+    const hs = headings(text).filter((h) => h.depth >= min && h.depth <= max);
+    const out = [];
+    const [first] = hs;
+    const preEnd = first ? first.offset : text.length;
+    out.push({
+        heading: null,
+        raw: text.slice(0, preEnd),
+        body: text.slice(0, preEnd),
+    });
+    for (const [i, h] of hs.entries()) {
+        const next = hs[i + 1];
+        const end = next ? next.offset : text.length;
+        const nl = text.indexOf("\n", h.offset);
+        const bodyStart = nl === -1 || nl + 1 > end ? end : nl + 1;
+        out.push({
+            heading: h,
+            raw: text.slice(h.offset, end),
+            body: text.slice(bodyStart, end),
+        });
+    }
+    return out;
+}
+/**
+ * The text without the contents of ```-blocks (the fence lines themselves go too).
+ *
+ * Through the parser, not `/```[\s\S]*?```/g`: that pattern glues the end of one block
+ * to the start of the next when the number of fences is odd, knows nothing about `~~~`
+ * fences or indented fences, and silently eats the prose between blocks.
+ *
+ * `blank: true` — the block's lines are NOT deleted but REPLACED with empty ones. The
+ * difference is not cosmetic: deleting the lines GLUES the paragraph before the block to
+ * the paragraph after it, and a code block is a block boundary — on the other side a
+ * different paragraph starts. Measured 2026-08-11 on `<papers-root>/<paper>/README.md`:
+ * `prose-lint` counted 82 sentences there, and after the lines were deleted it counted
+ * 81 — the lead paragraph "**Reproduction commands:**" merged with the text AFTER the
+ * block into one sentence. That is exactly the failure against which `prose-lint` itself
+ * says "Paragraph and heading boundaries END a sentence", and it inflates the
+ * claims-per-sentence counter — the threshold at which the file emits findings. The
+ * former regex preserved the boundary (it left one newline on each side), so `blank` is
+ * also a preservation of the former behaviour where that behaviour was right.
+ */
+/**
+ * The CONTENTS of fenced blocks — the other side of `stripFences`.
+ *
+ * Added 2026-09-08 for the check "a path as a command argument inside a ```-block"
+ * (the sixth form of a reference). A private regex for the fence there would have been
+ * the seventh instance of the class this knowledge base has already paid for:
+ * `/^```[\s\S]*?^```/gm` knows nothing about nested fences or about `~~~`, and the
+ * parser does — the `fence` token has a `content`.
+ *
+ * No parser — returns an empty list, and the caller must survive that: for hooks
+ * degradation is acceptable (see the module comment), while a silent fallback to a
+ * regex would mean a working degraded version that nobody notices.
+ */
+export function fences(text) {
+    if (md === null)
+        return [];
+    const out = [];
+    for (const t of md.parse(blankFrontmatter(text), {}))
+        if (t.type === "fence" || t.type === "code_block")
+            out.push(t.content);
+    return out;
+}
+export function stripFences(text, { blank = false } = {}) {
+    if (md === null)
+        return text;
+    const lines = text.split("\n");
+    const drop = new Set();
+    for (const t of md.parse(blankFrontmatter(text), {}))
+        if ((t.type === "fence" || t.type === "code_block") && t.map)
+            for (let i = t.map[0]; i < t.map[1]; i++)
+                drop.add(i);
+    return blank
+        ? lines.map((l, i) => (drop.has(i) ? "" : l)).join("\n")
+        : lines.filter((_, i) => !drop.has(i)).join("\n");
+}
+/**
+ * For SCRIPTS, not for hooks: fails if there is no parser.
+ *
+ * For a linter degradation is acceptable — it is advisory and can say so out loud. A
+ * skill script hands numbers to a pipeline gate, and an empty list of headings there is
+ * indistinguishable from "the paper has no sections". A confident zero has already been
+ * read as a finding four times in this repo; here it is inexpressible.
+ */
+export function requireMarkdown({ from = import.meta.url, } = {}) {
+    if (MD_AVAILABLE())
+        return;
+    // 🔴 THE CURE DEPENDS ON WHERE THIS COPY RUNS FROM. Measured 2026-09-19: a Claude Code plugin
+    // copy is installed without dependencies (`npm pack` strips `package-lock.json`, and the plugin
+    // cache runs `npm ci` only with a lockfile). The plugin channel was removed in #82, but a copy
+    // installed before then still runs from there, and "npm i at the repo root" would point its user
+    // at a repository they do not have. The location is readable from this file's own URL (`from`,
+    // a parameter only so a test can name a plugin-cache location without copying the file there).
+    const fromPluginCache = from.includes("/.claude/plugins/");
+    console.error("markdown-it does not resolve — this script parses markup with a parser and without it " +
+        "would produce a confident zero instead of an error.\n" +
+        (fromPluginCache
+            ? "  Running from a PLUGIN copy, which is installed without dependencies. Install the npm\n" +
+                "  package in the project as well (`npm i paperlint`) and call it through\n" +
+                "  `npx paperlint`, which resolves from the project's own tree."
+            : "  Cured by `npm i` at the repo root."));
+    process.exit(2);
+}
+/**
+ * GFM tables — rows, cells and the line range, WITH THE PARSER.
+ *
+ * The only consumer as of 2026-08-20 is `crosspost-article`, which needs to re-lay a
+ * table into a monospace block for a platform without tables (Medium). It lives here
+ * and not in the skill, by the rule "markup is parsed with a parser, and in one place":
+ * with a regex a table is told apart from a line of text with pipes only by its
+ * neighbours, and that is exactly the class that has already cost this repo 27 places.
+ *
+ * Returns `{ line, endLine, rows }`, where `rows[0]` is the header; the alignment row
+ * (`| --- |`) is thrown away, because in monospace output it has nothing to express.
+ */
+/**
+ * The document's paragraphs — `paragraph_open` line ranges, WITH THE PARSER.
+ * `[{ line, endLine }]`.
+ *
+ * The only consumer as of 2026-08-21 is `crosspost-article`: the blog's sources are
+ * hard-wrapped at a column (an editorial habit, not markdown), and the platforms render
+ * a single `\n` inside a paragraph DIFFERENTLY — dev.to (Redcarpet) keeps it as a
+ * literal line break, and the paragraph arrives torn into short lines exactly at the
+ * source file's boundaries. Medium has no such defect not because the platform is more
+ * honest, but because the paste goes through "Import a story" — the importer takes the
+ * ALREADY RENDERED page of the site (where the breaks were collapsed by the browser long
+ * ago), not the raw markdown.
+ *
+ * The range is EXACTLY the one `t.map` gives on `paragraph_open` — that is, a code
+ * fence, a heading, a table, a list (in a TIGHT list the item is not wrapped in a
+ * `paragraph_open` at all, it has no paragraph of its own) fall outside this function
+ * automatically, by the construction of the parser, and not by a separate line-type
+ * check.
+ */
+export function paragraphs(text) {
+    if (md === null)
+        return [];
+    return md
+        .parse(blankFrontmatter(text), {})
+        .flatMap((t) => t.type === "paragraph_open" && t.map
+        ? [{ line: t.map[0], endLine: t.map[1] }]
+        : []);
+}
+export function tables(text) {
+    if (md === null)
+        return [];
+    const lines = blankFrontmatter(text).split("\n");
+    const out = [];
+    for (const t of md.parse(blankFrontmatter(text), {})) {
+        if (t.type !== "table_open" || !t.map)
+            continue;
+        const rows = [];
+        for (const raw of lines.slice(t.map[0], t.map[1])) {
+            if (/^\s*\|?[\s:|-]+\|?\s*$/.test(raw) && raw.includes("-"))
+                continue; // alignment
+            rows.push(raw
+                .replace(/^\s*\|/, "")
+                .replace(/\|\s*$/, "")
+                .split("|")
+                .map((c) => c.trim()));
+        }
+        out.push({ line: t.map[0], endLine: t.map[1], rows });
+    }
+    return out;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/lib/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../lib/markdown.ts"],"names":[],"mappings":"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"}

package/dist/lib/paper-config.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Where the consumer declares its settings — the ONE SOURCE for everything that is allowed to
+ * import it.
+ *
+ * 🔴 WHY THIS MODULE DOES NOT REMOVE THE DUPLICATION COMPLETELY, AND THAT IS NOT AN OVERSIGHT.
+ * The three hooks (`hooks/*.hook.mjs`) still have to keep their own copies of these values: a
+ * compiled hook is forbidden to import anything but `vigiles/hook`, and that ban is not
+ * arbitrary — a hook's capabilities equal its API surface, so allowing imports would mean
+ * allowing a reach into `child_process`. The restriction is wider than strictly necessary
+ * (importing plain constants adds no capability), and that is discussed in zernie/vigiles#245,
+ * but until it is relaxed the hooks duplicate, and drift is caught by the cross-check in
+ * `hooks/hooks.harness.ts`.
+ *
+ * 🔴 BUT THE REST WERE DUPLICATING FOR NO REASON AT ALL. `eslint-rules/papers.mjs` and
+ * `skills/paper-pipeline/scripts/consumer.mjs` are not hooks, carry no import restriction, and
+ * could always have taken the value from here. Worse, their copies were not covered by the
+ * cross-check at all — it compared the three hooks against each other, while these two lived
+ * next door and could drift apart silently. Found 2026-09-18 by grepping AFTER the cross-check
+ * itself had already been fixed — i.e. the check's wording was fixed, but nobody measured its
+ * COVERAGE.
+ */
+/**
+ * The tool's name. Its settings file is named after it (`CONFIG_FILE`), its messages start with it,
+ * and the hooks resolve their scripts through it. It equals the package name, and
+ * `lib/paper-config.harness.mjs` checks that.
+ */
+export declare const CONFIG_KEY: string;
+/**
+ * THE SETTINGS FILE, ONE NAME AT TWO LEVELS, ONE SCHEMA (`SETTINGS_KEYS`):
+ *
+ *   paperlint.json                 optional, at the project root: where the papers are, the
+ *                                  project's rules, and defaults for every paper
+ *   <papersDir>/<paper>/paperlint.json   one paper: its venue preset, its kind, its own rules
+ *
+ * A paper's file merges over the root's: its `extends`, `kind` and `pdf` win, and its `rules` are
+ * applied after the root's. A venue preset (`paperlint:<name>`, or the project's own `./x.jsonc`)
+ * is the third level, below both.
+ */
+export declare const CONFIG_FILE: string;
+/**
+ * The files that make a directory a PAPER. A `paperlint.json` beside one of them is that paper's,
+ * never the project's — so walking up from inside a paper does not stop at the paper's own file.
+ */
+export declare const PAPER_MARKERS: readonly string[];
+/**
+ * The project root: the nearest directory, walking up from `startDir`, that holds a root
+ * `paperlint.json` (one not beside a paper's files); else the nearest directory holding a
+ * `package.json`; else `startDir` itself. The same walk eslint, prettier and tsc use for theirs.
+ *
+ * @param isFile  whether a path exists — `existsSync` by default; `src/` passes its Files port.
+ */
+export declare function findProjectRoot(startDir: string, isFile?: (path: string) => boolean): string;
+/**
+ * The project's settings: the object in `<root>/paperlint.json`, or undefined when there is no
+ * such file, or it does not parse, or it is not an object. For readers that only need one key and
+ * fall back to its default; `paperlint lint` parses the file strictly and names what is wrong.
+ */
+export declare function settingsOf(root: string): Readonly<Record<string, unknown>> | undefined;
+/** The default papers directory, used when the root `paperlint.json` declares none (or there is none). */
+export declare const DEFAULT_PAPERS_ROOT: string;
+/**
+ * The field that names the papers directory: `{ "papersDir": "papers" }` in the root
+ * `paperlint.json`. Optional; absent means `DEFAULT_PAPERS_ROOT`.
+ *
+ * This is the one place the name is spelled. Code reads the field as
+ * `settings[PAPERS_DIR_FIELD]`, never by a literal, so renaming it again is a one-line change
+ * here. The three hooks cannot import this module, so they keep their own copy, and
+ * `lib/paper-config.harness.mjs` checks that every copy matches this one.
+ */
+export declare const PAPERS_DIR_FIELD: string;
+/**
+ * Every key a `paperlint.json` may hold — the root's and a paper's, ONE schema — with who reads it.
+ * A key not listed here is REFUSED with its name, because a typo in a key otherwise reads as "not
+ * set". The keys in `ROOT_ONLY_KEYS` describe the whole project and are refused in a paper's file.
+ *
+ * 🔴 ONE LIST, AND IT IS CHECKED AGAINST THE READERS, NOT TRUSTED. `lib/paper-config.harness.mjs`
+ * walks the package's source, finds every `settingsOf(…)?.<key>` read and every field of
+ * `PaperlintConfig`, and requires each to be here — so a new reader that forgets this list turns
+ * the harness red before a consumer's config does.
+ */
+export declare const SETTINGS_KEYS: Readonly<Record<string, string>>;
+/** The keys that only mean something for the whole project: refused in a paper's `paperlint.json`. */
+export declare const ROOT_ONLY_KEYS: readonly string[];
+//# sourceMappingURL=paper-config.d.ts.map

package/dist/lib/paper-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper-config.d.ts","sourceRoot":"","sources":["../../lib/paper-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAoB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAKzC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,MAAM,CAmBR;AAKD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAQ/C;AAED,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB,EAAE,MAAiB,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAoB,CAAC;AAEpD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAezD,CAAC;AAEH,sGAAsG;AACtG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAO1C,CAAC"}

package/dist/lib/paper-config.js

@@ -0,0 +1,138 @@
+/**
+ * Where the consumer declares its settings — the ONE SOURCE for everything that is allowed to
+ * import it.
+ *
+ * 🔴 WHY THIS MODULE DOES NOT REMOVE THE DUPLICATION COMPLETELY, AND THAT IS NOT AN OVERSIGHT.
+ * The three hooks (`hooks/*.hook.mjs`) still have to keep their own copies of these values: a
+ * compiled hook is forbidden to import anything but `vigiles/hook`, and that ban is not
+ * arbitrary — a hook's capabilities equal its API surface, so allowing imports would mean
+ * allowing a reach into `child_process`. The restriction is wider than strictly necessary
+ * (importing plain constants adds no capability), and that is discussed in zernie/vigiles#245,
+ * but until it is relaxed the hooks duplicate, and drift is caught by the cross-check in
+ * `hooks/hooks.harness.ts`.
+ *
+ * 🔴 BUT THE REST WERE DUPLICATING FOR NO REASON AT ALL. `eslint-rules/papers.mjs` and
+ * `skills/paper-pipeline/scripts/consumer.mjs` are not hooks, carry no import restriction, and
+ * could always have taken the value from here. Worse, their copies were not covered by the
+ * cross-check at all — it compared the three hooks against each other, while these two lived
+ * next door and could drift apart silently. Found 2026-09-18 by grepping AFTER the cross-check
+ * itself had already been fixed — i.e. the check's wording was fixed, but nobody measured its
+ * COVERAGE.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/**
+ * The tool's name. Its settings file is named after it (`CONFIG_FILE`), its messages start with it,
+ * and the hooks resolve their scripts through it. It equals the package name, and
+ * `lib/paper-config.harness.mjs` checks that.
+ */
+export const CONFIG_KEY = "paperlint";
+/**
+ * THE SETTINGS FILE, ONE NAME AT TWO LEVELS, ONE SCHEMA (`SETTINGS_KEYS`):
+ *
+ *   paperlint.json                 optional, at the project root: where the papers are, the
+ *                                  project's rules, and defaults for every paper
+ *   <papersDir>/<paper>/paperlint.json   one paper: its venue preset, its kind, its own rules
+ *
+ * A paper's file merges over the root's: its `extends`, `kind` and `pdf` win, and its `rules` are
+ * applied after the root's. A venue preset (`paperlint:<name>`, or the project's own `./x.jsonc`)
+ * is the third level, below both.
+ */
+export const CONFIG_FILE = "paperlint.json";
+/**
+ * The files that make a directory a PAPER. A `paperlint.json` beside one of them is that paper's,
+ * never the project's — so walking up from inside a paper does not stop at the paper's own file.
+ */
+export const PAPER_MARKERS = Object.freeze([
+    "paper.tex",
+    "paper.md",
+    "draft.md",
+    "PIPELINE-STATUS.md",
+]);
+/**
+ * The project root: the nearest directory, walking up from `startDir`, that holds a root
+ * `paperlint.json` (one not beside a paper's files); else the nearest directory holding a
+ * `package.json`; else `startDir` itself. The same walk eslint, prettier and tsc use for theirs.
+ *
+ * @param isFile  whether a path exists — `existsSync` by default; `src/` passes its Files port.
+ */
+export function findProjectRoot(startDir, isFile = existsSync) {
+    const start = resolve(startDir);
+    const isPaper = (d) => PAPER_MARKERS.some((m) => isFile(join(d, m)));
+    // Up from `start` to the first directory `found` accepts; null past the filesystem root. A
+    // loop with an exit condition rather than `for (;;)`: the code after an endless loop is a block
+    // that can never run, and coverage counts it as one that did not.
+    const walk = (found) => {
+        let d = start;
+        while (!found(d)) {
+            if (dirname(d) === d)
+                return null;
+            d = dirname(d);
+        }
+        return d;
+    };
+    return (walk((d) => isFile(join(d, CONFIG_FILE)) && !isPaper(d)) ??
+        walk((d) => isFile(join(d, "package.json"))) ??
+        start);
+}
+const isObject = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+/**
+ * The project's settings: the object in `<root>/paperlint.json`, or undefined when there is no
+ * such file, or it does not parse, or it is not an object. For readers that only need one key and
+ * fall back to its default; `paperlint lint` parses the file strictly and names what is wrong.
+ */
+export function settingsOf(root) {
+    let v;
+    try {
+        v = JSON.parse(readFileSync(join(root, CONFIG_FILE), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    return isObject(v) ? v : undefined;
+}
+/** The default papers directory, used when the root `paperlint.json` declares none (or there is none). */
+export const DEFAULT_PAPERS_ROOT = "papers";
+/**
+ * The field that names the papers directory: `{ "papersDir": "papers" }` in the root
+ * `paperlint.json`. Optional; absent means `DEFAULT_PAPERS_ROOT`.
+ *
+ * This is the one place the name is spelled. Code reads the field as
+ * `settings[PAPERS_DIR_FIELD]`, never by a literal, so renaming it again is a one-line change
+ * here. The three hooks cannot import this module, so they keep their own copy, and
+ * `lib/paper-config.harness.mjs` checks that every copy matches this one.
+ */
+export const PAPERS_DIR_FIELD = "papersDir";
+/**
+ * Every key a `paperlint.json` may hold — the root's and a paper's, ONE schema — with who reads it.
+ * A key not listed here is REFUSED with its name, because a typo in a key otherwise reads as "not
+ * set". The keys in `ROOT_ONLY_KEYS` describe the whole project and are refused in a paper's file.
+ *
+ * 🔴 ONE LIST, AND IT IS CHECKED AGAINST THE READERS, NOT TRUSTED. `lib/paper-config.harness.mjs`
+ * walks the package's source, finds every `settingsOf(…)?.<key>` read and every field of
+ * `PaperlintConfig`, and requires each to be here — so a new reader that forgets this list turns
+ * the harness red before a consumer's config does.
+ */
+export const SETTINGS_KEYS = Object.freeze({
+    papersDir: `the papers directory, default "papers" — every command, the hooks`,
+    structure: "which files a paper directory must hold — paperlint lint",
+    rules: "rule overrides: { id: severity } for every paper in scope, or ESLint blocks (files, ignores, rules) — paperlint lint",
+    extends: "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",
+    scripts: "how skill prose names the scripts — consumer.mjs",
+    timezone: "the zone deadline anchors are written in — consumer.mjs",
+    contactEmail: "the polite-pool address for citation lookups — consumer.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",
+});
+/** The keys that only mean something for the whole project: refused in a paper's `paperlint.json`. */
+export const ROOT_ONLY_KEYS = Object.freeze([
+    "papersDir",
+    "structure",
+    "scripts",
+    "timezone",
+    "contactEmail",
+    "triggerCases",
+]);
+//# sourceMappingURL=paper-config.js.map

package/dist/lib/paper-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper-config.js","sourceRoot":"","sources":["../../lib/paper-config.ts"],"names":[],"mappings":"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"}

package/dist/lib/skill-eval-fixture.d.ts

@@ -0,0 +1,29 @@
+/**
+ * skill-eval-fixture.mjs — the throwaway working directory every trigger run sees.
+ *
+ * 🔴 WHY A FIXTURE IS NOT OPTIONAL, learned by getting it wrong (2026-08-11).
+ * A trigger run executes in a FRESH EMPTY cwd. Ask "grade the writing on this
+ * paper" in a directory containing no paper and the model reasonably does not
+ * reach for a skill — there is nothing to grade. Measured: without this fixture,
+ * `grade-paper-writing`, `harden-paper`, `map-prior-work` and
+ * `paper-adversarial-review` all scored 0% on prompts that had previously fired,
+ * and the zero was an artifact of the empty directory, not a fact about the skill.
+ *
+ * Extracted from `paper-pipeline/pipeline-firing.eval.mjs`, which had it right
+ * from the start, so the two runners cannot drift apart on what the model sees.
+ *
+ * ⚠️ AND THE PRICE, so this file is not a one-sided story (measured 2026-08-12).
+ * With a fixture present the model OPENS THE PAPER and looks around, so the number
+ * stops being "did the DESCRIPTION fire" and becomes "did the model go investigate
+ * and then fire". A different quantity, and a costlier one: ~590k → ~780k tokens
+ * per skill (+190k) and 67s → 84s, while this whole fixture is 1,537 characters
+ * ≈ 384 tokens. The growth is reading, not input size (`cache` 470k → 652k).
+ * Cite the trigger numbers with that caveat attached — it is written out in
+ * `vigiles/repro/skill-trigger-2026-08-11/README.md` under "How to read".
+ */
+export declare const FIXTURE: {
+    "paper/paper.md": string;
+    "paper/repro/README.md": string;
+    "paper/PIPELINE-STATUS.md": string;
+};
+//# sourceMappingURL=skill-eval-fixture.d.ts.map

package/dist/lib/skill-eval-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-eval-fixture.d.ts","sourceRoot":"","sources":["../../lib/skill-eval-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,OAAO;;;;CAuCnB,CAAC"}

package/dist/lib/skill-eval-fixture.js

@@ -0,0 +1,62 @@
+/**
+ * skill-eval-fixture.mjs — the throwaway working directory every trigger run sees.
+ *
+ * 🔴 WHY A FIXTURE IS NOT OPTIONAL, learned by getting it wrong (2026-08-11).
+ * A trigger run executes in a FRESH EMPTY cwd. Ask "grade the writing on this
+ * paper" in a directory containing no paper and the model reasonably does not
+ * reach for a skill — there is nothing to grade. Measured: without this fixture,
+ * `grade-paper-writing`, `harden-paper`, `map-prior-work` and
+ * `paper-adversarial-review` all scored 0% on prompts that had previously fired,
+ * and the zero was an artifact of the empty directory, not a fact about the skill.
+ *
+ * Extracted from `paper-pipeline/pipeline-firing.eval.mjs`, which had it right
+ * from the start, so the two runners cannot drift apart on what the model sees.
+ *
+ * ⚠️ AND THE PRICE, so this file is not a one-sided story (measured 2026-08-12).
+ * With a fixture present the model OPENS THE PAPER and looks around, so the number
+ * stops being "did the DESCRIPTION fire" and becomes "did the model go investigate
+ * and then fire". A different quantity, and a costlier one: ~590k → ~780k tokens
+ * per skill (+190k) and 67s → 84s, while this whole fixture is 1,537 characters
+ * ≈ 384 tokens. The growth is reading, not input size (`cache` 470k → 652k).
+ * Cite the trigger numbers with that caveat attached — it is written out in
+ * `vigiles/repro/skill-trigger-2026-08-11/README.md` under "How to read".
+ */
+export const FIXTURE = {
+    "paper/paper.md": [
+        "# Prose Isn't Policy: Measuring Whether Agent-Config Rules Are Enforceable",
+        "",
+        "## Abstract",
+        "Agent configuration files state rules in prose and assume the model obeys them. We compile a",
+        "corpus of real rules and measure what fraction can be mechanically enforced. We find that 84%",
+        "of rules in our corpus are enforceable, and that LLM-authored checkers for the remainder leak",
+        "silently in 84-96% of adversarial cases \\cite{greshake2023}.",
+        "",
+        "## 1 Introduction",
+        "Every agent harness ships a natural-language rulebook. Nothing checks it. This is the same",
+        "mistake as a code comment that claims an invariant no test enforces \\cite{thompson1984}.",
+        "",
+        "## 2 Method",
+        "We gather rules from public repositories, classify each by enforceability, and build a",
+        "two-stage adversarial gate that validates a synthesized rule against a blind gold set.",
+        "",
+        "## 3 Results",
+        "See Table 1. The headline number is 84%.",
+        "",
+        "## 4 Discussion",
+        "The result generalizes beyond our corpus in the sense that the mechanism is not corpus-specific,",
+        "though of course the specific percentages are, and it is important to note in this context that",
+        "the framing itself may be what carries, rather than the measurement.",
+        "",
+        "## 5 Threats to Validity",
+        "Our corpus is drawn from public repositories and may not represent private configurations.",
+        "",
+        "## 6 Related Work",
+        "TODO",
+        "",
+        "## 7 Conclusion",
+        "Prose is not policy.",
+    ].join("\n"),
+    "paper/repro/README.md": "# Reproduction artifact\n\n`python3 paper_numbers.py` recomputes every bolded figure in paper.md.\n",
+    "paper/PIPELINE-STATUS.md": "# Pipeline status\n\n| gate | state |\n|---|---|\n| numbers | pass |\n| structure | not run |\n| citations | not run |\n",
+};
+//# sourceMappingURL=skill-eval-fixture.js.map

package/dist/lib/skill-eval-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-eval-fixture.js","sourceRoot":"","sources":["../../lib/skill-eval-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gBAAgB,EAAE;QAChB,4EAA4E;QAC5E,EAAE;QACF,aAAa;QACb,8FAA8F;QAC9F,+FAA+F;QAC/F,+FAA+F;QAC/F,+DAA+D;QAC/D,EAAE;QACF,mBAAmB;QACnB,4FAA4F;QAC5F,2FAA2F;QAC3F,EAAE;QACF,aAAa;QACb,wFAAwF;QACxF,wFAAwF;QACxF,EAAE;QACF,cAAc;QACd,0CAA0C;QAC1C,EAAE;QACF,iBAAiB;QACjB,kGAAkG;QAClG,iGAAiG;QACjG,sEAAsE;QACtE,EAAE;QACF,0BAA0B;QAC1B,4FAA4F;QAC5F,EAAE;QACF,mBAAmB;QACnB,MAAM;QACN,EAAE;QACF,iBAAiB;QACjB,sBAAsB;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,uBAAuB,EACrB,qGAAqG;IACvG,0BAA0B,EACxB,0HAA0H;CAC7H,CAAC"}