paperlint 3.1.3 → 3.2.0

package/dist/eslint-rules/paper-stages.js

@@ -0,0 +1,358 @@
+/**
+ * `paper/stages` — the stage a paper has reached is an author's CLAIM, so it is a FIELD, and
+ * the bytes on disk are the evidence that claim is checked against.
+ *
+ * ── WHAT THIS REPLACES, and why the replacement is not cosmetic ─────────────────────────
+ * The predecessor kept a vocabulary of stage names in a JS const and applied its regexes to
+ * the WHOLE of `PIPELINE-STATUS.md`:
+ *
+ *     { stage: "submitted", declaredBy: /(?<!\bas\s)(?<!\bbe\s)\bsubmitted\b/i }
+ *
+ * The lookbehinds are not decoration — they were added after the only match in one paper's
+ * file turned out to be a reviewer's idiom, "Weak Accept as submitted", which says nothing
+ * about submission. The check then demanded a frozen pdf and was RIGHT BY ACCIDENT.
+ *
+ * 🔴 And it stayed wrong in the other direction, measured 2026-09-16 on the live corpus:
+ * `versions/2026-08-29-camera-ready.pdf` had been on disk for 16 days at 616 175 bytes while
+ * the `camera-ready` pattern matched ZERO times anywhere in the file. The artefact preceded
+ * the declaration, so all three checks gated on that declaration were blind by construction.
+ *
+ * ── TWO DIRECTIONS, and neither alone is the check ──────────────────────────────────────
+ *   declared -> bytes   a record without its file, or with the wrong size, is a false claim
+ *   bytes -> declared   a frozen version nobody declared is the case above, and it is also
+ *                       what stops the whole rule being switched off by deleting a line
+ *
+ * Absence of the field is therefore LEGITIMATE — a paper that has shipped nothing owes
+ * nothing — without being an escape hatch: the second direction still speaks if bytes exist.
+ * That asymmetry is deliberate and is the reason this rule does not copy `doc/fields`, where
+ * a missing frontmatter IS the finding.
+ *
+ * ── WHY A FIELD CANNOT BECOME A TICKED BOX HERE ─────────────────────────────────────────
+ * The usual objection to turning a check into a field is that a field gets ticked instead of
+ * the work being done. It does not apply, and the reason is the direction of the incentive:
+ * a tick normally REMOVES an obligation, while `stages` CREATES them — declare a stage and
+ * you owe a pdf of the right size. Nobody writes a line in order to receive findings. The
+ * real-world pressure is to UNDER-declare, which is exactly what direction two catches.
+ *
+ * ── THE FIELD IS THE ONLY MACHINE-READABLE CARRIER ──────────────────────────────────────
+ * ⚠️ A paper's status file also carries a `State:` line in its header and one or two
+ * scorecard tables. Those are DISPLAY. No consistency check between them is written here on
+ * purpose: one paper in the source corpus carries two scorecards in two different column
+ * formats, and a rule reconciling them would drown in noise within a day.
+ *
+ * ── A LIST, NOT A MAP, and that is load-bearing ─────────────────────────────────────────
+ * A paper can reach the same stage twice: one in the source corpus was submitted to a venue
+ * in August, rejected in September, and is being resubmitted elsewhere in October. A map
+ * keyed by stage name holds one. The `versions/<date>-<stage>.pdf` convention already holds
+ * many, and the field must not be weaker than the filenames it describes.
+ */
+import { existsSync, statSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import assert from "node:assert/strict";
+import { load } from "js-yaml";
+import { z } from "zod";
+/** The frontmatter's `stages` field, whatever it holds; anything that is not a mapping has none. */
+const Frontmatter = z.looseObject({ stages: z.unknown().optional() }).catch({});
+const StageList = z.array(z.unknown());
+/** One `stages` entry. A field of the wrong shape is read as it is written, then judged below. */
+const StageRecord = z
+    .looseObject({
+    stage: z.unknown().optional(),
+    date: z.unknown().optional(),
+    pdf: z.unknown().optional(),
+    bytes: z.unknown().optional(),
+    source: z.unknown().optional(),
+    sourceBytes: z.unknown().optional(),
+    sourceLost: z.unknown().optional(),
+})
+    .catch({});
+const REQUIRED = ["date", "pdf", "bytes"];
+const STAGES = ["submitted", "camera-ready", "arxiv"];
+/**
+ * A YAML date without quotes parses to a `Date`, not a string — js-yaml honours YAML 1.1
+ * timestamps. Comparing `Date === "2026-08-29"` is silently false, so every date is
+ * normalised before it is compared with one taken from a filename.
+ */
+/**
+ * A YAML value as the text a message shows: a scalar as written, nothing as "", and a mapping or
+ * list as its JSON (as a number is) — `String()` would print `[object Object]` for a mapping.
+ */
+const scalarText = (v) => typeof v === "string" ? v : v === undefined ? "" : JSON.stringify(v);
+function isoDate(v) {
+    if (v instanceof Date)
+        return v.toISOString().slice(0, 10);
+    if (typeof v === "string")
+        return /^\d{4}-\d{2}-\d{2}/.exec(v)?.[0] ?? "";
+    return "";
+}
+/** Frozen versions on disk, as `{name, date, stage}`. */
+function frozenPdfs(versionsDir) {
+    let names;
+    try {
+        names = readdirSync(versionsDir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names) {
+        if (!name.endsWith(".pdf"))
+            continue;
+        // ⚠️ A name carrying `STALE` is a version WITHDRAWN on purpose — one such file records
+        // that the wrong pdf sat in the folder for a month. Demanding a declaration for it would
+        // turn a deliberate record of a mistake into a finding.
+        if (name.includes("STALE"))
+            continue;
+        const m = /^(\d{4}-\d{2}-\d{2})-(.+)\.pdf$/.exec(name);
+        if (!m)
+            continue;
+        const [, date = "", stage = ""] = m;
+        if (!STAGES.includes(stage))
+            continue;
+        out.push({ name, date, stage });
+    }
+    return out;
+}
+export default {
+    rules: {
+        stages: {
+            meta: {
+                type: "problem",
+                docs: {
+                    description: "a paper's stage is declared as a FIELD, and every declaration is checked against the bytes on disk in both directions",
+                },
+                schema: [],
+                messages: {
+                    badYaml: "the frontmatter does not parse as YAML: {{reason}}",
+                    notAList: "`stages` must be a LIST of entries, not {{got}} — a paper can reach the same stage twice",
+                    badStage: "unknown stage «{{stage}}» — the vocabulary is: {{known}}",
+                    missingKey: "the «{{stage}}» entry has no `{{key}}` field",
+                    badDate: "the date «{{date}}» in the «{{stage}}» entry is not YYYY-MM-DD",
+                    declaredNoFile: "stage «{{stage}}» ({{date}}) is declared, but `{{pdf}}` is not on disk",
+                    bytesDiffer: "«{{stage}}» ({{date}}): {{want}} bytes declared, {{got}} on disk — this is NOT that file",
+                    fileNotDeclared: "`versions/{{file}}` is frozen, but no «{{stage}}» stage on {{date}} is declared in `stages` — the artefact ran ahead of the declaration",
+                },
+            },
+            create(context) {
+                const dir = dirname(context.filename);
+                let declared = null; // null = there was no frontmatter at all
+                return {
+                    yaml(node) {
+                        let data;
+                        try {
+                            data = load(node.value ?? "");
+                        }
+                        catch (e) {
+                            // js-yaml throws its own `YAMLException`, an `Error`, and nothing else.
+                            assert.ok(e instanceof Error);
+                            context.report({
+                                node,
+                                messageId: "badYaml",
+                                data: { reason: e.message },
+                            });
+                            return;
+                        }
+                        const { stages: raw } = Frontmatter.parse(data);
+                        if (raw === undefined)
+                            return;
+                        const list = StageList.safeParse(raw);
+                        if (!list.success) {
+                            context.report({
+                                node,
+                                messageId: "notAList",
+                                data: { got: raw === null ? "empty" : typeof raw },
+                            });
+                            return;
+                        }
+                        declared = [];
+                        for (const entry of list.data) {
+                            const rec = StageRecord.parse(entry);
+                            const stage = scalarText(rec.stage);
+                            if (!STAGES.includes(stage)) {
+                                context.report({
+                                    node,
+                                    messageId: "badStage",
+                                    data: { stage, known: STAGES.join(" · ") },
+                                });
+                                continue;
+                            }
+                            let complete = true;
+                            for (const key of REQUIRED) {
+                                if (rec[key] === undefined) {
+                                    context.report({
+                                        node,
+                                        messageId: "missingKey",
+                                        data: { stage, key },
+                                    });
+                                    complete = false;
+                                }
+                            }
+                            if (!complete)
+                                continue;
+                            const date = isoDate(rec.date);
+                            if (date === "") {
+                                context.report({
+                                    node,
+                                    messageId: "badDate",
+                                    data: { stage, date: String(rec.date) },
+                                });
+                                continue;
+                            }
+                            declared.push({
+                                stage,
+                                date,
+                                pdf: String(rec.pdf),
+                                bytes: Number(rec.bytes),
+                            });
+                            // ── direction one: a claim owes its bytes ────────────────────────────────
+                            const abs = join(dir, String(rec.pdf));
+                            if (!existsSync(abs)) {
+                                context.report({
+                                    node,
+                                    messageId: "declaredNoFile",
+                                    data: { stage, date, pdf: String(rec.pdf) },
+                                });
+                                continue;
+                            }
+                            const got = statSync(abs).size;
+                            if (got !== Number(rec.bytes)) {
+                                context.report({
+                                    node,
+                                    messageId: "bytesDiffer",
+                                    data: {
+                                        stage,
+                                        date,
+                                        want: String(rec.bytes),
+                                        got: String(got),
+                                    },
+                                });
+                            }
+                        }
+                    },
+                    // ── direction two: bytes owe their declaration ────────────────────────────────
+                    // 🔴 On `root:exit` rather than inside `yaml`, because the case worth catching is
+                    // precisely the one with NO frontmatter at all — where the `yaml` visitor never runs.
+                    "root:exit"(node) {
+                        const records = declared ?? [];
+                        for (const f of frozenPdfs(join(dir, "versions"))) {
+                            if (records.some((r) => r.stage === f.stage && r.date === f.date))
+                                continue;
+                            context.report({
+                                node,
+                                messageId: "fileNotDeclared",
+                                data: { file: f.name, stage: f.stage, date: f.date },
+                            });
+                        }
+                    },
+                };
+            },
+        },
+        /**
+         * `paper/source` — a declared stage must have its SOURCE frozen on disk, beside the pdf,
+         * and the bytes must match. Not a commit reference. Not a hash of one.
+         *
+         * ── WHY NOT A COMMIT, measured 2026-09-16 and it is not a close call ──────────────────
+         * The predecessor recorded provenance as `commit <sha>` in prose and checked that the sha
+         * RESOLVED. Its stated premise was "git holds those bytes immutably, materialising a copy
+         * duplicates a guarantee we already have". That premise is false wherever branches are
+         * SQUASH-merged: the squash destroys the branch commits, and the next `git gc` removes
+         * the objects.
+         *
+         * 🔴 Measured on the live corpus, inside ninety minutes of ONE session: two recorded shas
+         * resolved, then stopped resolving after a routine `gc` following a branch reset. Of the
+         * four declared stages in that corpus, THREE had lost their source entirely — including
+         * papers already submitted to a venue, which is exactly the case the check existed for
+         * (a reviewer cites a line number and there is no layout left to resolve it against).
+         *
+         * So a sha is not a pointer to bytes; it is a pointer to a pointer, and the outer one
+         * evaporates. Checking it verifies that the REFERENCE is alive, which is a different
+         * claim from the one anybody wants.
+         *
+         * ── COST, because "duplicating" was the objection ─────────────────────────────────────
+         * A paper source is 57-68 KB of LaTeX beside a pdf of 305-382 KB that is already
+         * committed. Freezing it adds under a fifth to what the folder holds anyway, and turns a
+         * claim about the world into bytes this rule can actually compare.
+         *
+         * ── SEVERITY: nudge, and the reason CHANGED ──────────────────────────────────────────
+         * Still `warn` at the consumer, but no longer because "only the author knows". Now it is
+         * because a stage frozen BEFORE this convention existed cannot be fixed at all — those
+         * bytes are gone. Failing a build over unrecoverable history is a gate nobody can clear.
+         */
+        source: {
+            meta: {
+                type: "problem",
+                docs: {
+                    description: "a declared stage freezes its source beside the pdf and is checked by bytes — not by a commit reference",
+                },
+                schema: [],
+                messages: {
+                    noSource: "stage «{{stage}}» ({{date}}) carries no frozen source. A commit reference will not do: squash and gc destroy it — three of four sources were lost that way in this corpus",
+                    sourceMissing: "«{{stage}}» ({{date}}): source `{{src}}` is declared, but the file is not on disk",
+                    sourceBytes: "«{{stage}}» ({{date}}): the source is declared as {{want}} bytes, {{got}} on disk — this is NOT that file",
+                    lostAcknowledged: "stage «{{stage}}» ({{date}}): the source is declared LOST. There is nothing left to match a build against a reviewer's line — if a copy turns up, put it in versions/ and clear the flag",
+                },
+            },
+            create(context) {
+                const dir = dirname(context.filename);
+                return {
+                    yaml(node) {
+                        let data;
+                        try {
+                            data = load(node.value ?? "");
+                        }
+                        catch {
+                            return; // `paper/stages` has already reported the unreadable YAML
+                        }
+                        const list = StageList.safeParse(Frontmatter.parse(data).stages);
+                        if (!list.success)
+                            return;
+                        for (const entry of list.data) {
+                            const rec = StageRecord.parse(entry);
+                            const stage = scalarText(rec.stage);
+                            if (!STAGES.includes(stage))
+                                continue;
+                            const date = isoDate(rec.date);
+                            // Acknowledging the loss is a RECORD, not an exemption: the rule keeps speaking,
+                            // because the state stays defective, just unfixable today.
+                            if (rec.sourceLost === true) {
+                                context.report({
+                                    node,
+                                    messageId: "lostAcknowledged",
+                                    data: { stage, date },
+                                });
+                                continue;
+                            }
+                            const src = scalarText(rec.source);
+                            if (src === "") {
+                                context.report({
+                                    node,
+                                    messageId: "noSource",
+                                    data: { stage, date },
+                                });
+                                continue;
+                            }
+                            const abs = join(dir, src);
+                            if (!existsSync(abs)) {
+                                context.report({
+                                    node,
+                                    messageId: "sourceMissing",
+                                    data: { stage, date, src },
+                                });
+                                continue;
+                            }
+                            const got = statSync(abs).size;
+                            const want = Number(rec.sourceBytes);
+                            if (Number.isFinite(want) && got !== want)
+                                context.report({
+                                    node,
+                                    messageId: "sourceBytes",
+                                    data: { stage, date, want: String(want), got: String(got) },
+                                });
+                        }
+                    },
+                };
+            },
+        },
+    },
+};
+//# sourceMappingURL=paper-stages.js.map

package/dist/eslint-rules/paper-stages.js.map

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

package/dist/eslint-rules/paper-typography.d.ts

@@ -0,0 +1,74 @@
+import type { TexRoot } from "./latex-language.ts";
+import type { RuleContext } from "./rule-context.ts";
+/** Where a `.bib` embedded in a `filecontents` environment sits in the file. */
+export interface BibRange {
+    readonly start: number;
+    readonly end: number;
+    readonly bodyStart: number;
+    readonly body: string;
+}
+/** A run of visible text, and for each of its characters the offset it came from (or null). */
+interface Run {
+    text: string;
+    offs: (number | null)[];
+}
+/** The inline bibliography — a `filecontents` block writing a `.bib` — with its offsets. */
+export declare function bibRange(text: string): BibRange | null;
+/**
+ * The visible runs of a LaTeX source. `parse` is unified-latex's parser; a test hands in a tree
+ * with the fields the walk tolerates being absent.
+ */
+export declare function texVisibleRuns(raw: string, { parse, }?: {
+    parse?: (s: string) => TexRoot;
+}): Run[];
+declare const _default: {
+    rules: {
+        "section-word": {
+            meta: {
+                hasSuggestions?: boolean;
+                type: string;
+                fixable: string;
+                docs: {
+                    description: string;
+                };
+                schema: never[];
+                messages: Readonly<Record<string, string>>;
+            };
+            create: (context: RuleContext) => {
+                "root:exit": () => void;
+            };
+        };
+        "leading-zero": {
+            meta: {
+                hasSuggestions?: boolean;
+                type: string;
+                fixable: string;
+                docs: {
+                    description: string;
+                };
+                schema: never[];
+                messages: Readonly<Record<string, string>>;
+            };
+            create: (context: RuleContext) => {
+                "root:exit": () => void;
+            };
+        };
+        "figure-ref-style": {
+            meta: {
+                hasSuggestions?: boolean;
+                type: string;
+                fixable: string;
+                docs: {
+                    description: string;
+                };
+                schema: never[];
+                messages: Readonly<Record<string, string>>;
+            };
+            create: (context: RuleContext) => {
+                "root:exit": () => void;
+            };
+        };
+    };
+};
+export default _default;
+//# sourceMappingURL=paper-typography.d.ts.map

package/dist/eslint-rules/paper-typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper-typography.d.ts","sourceRoot":"","sources":["../../eslint-rules/paper-typography.ts"],"names":[],"mappings":"AAgEA,OAAO,KAAK,EAAmB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAKD,+FAA+F;AAC/F,UAAU,GAAG;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAWtD;AA4JD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,EACE,KAAoD,GACrD,GAAE;IAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAAO,GACzC,GAAG,EAAE,CAQP;;;;;iCAgMmC,OAAO;;;;;;;;;8BAUvB,WAAW;;;;;;iCAVK,OAAO;;;;;;;;;8BAUvB,WAAW;;;;;;iCAVK,OAAO;;;;;;;;;8BAUvB,WAAW;;;;;;AAO/B,wBA6BE"}