paperlint 12.0.0 → 13.0.0

package/dist/domain/versions.js

@@ -0,0 +1,457 @@
+/**
+ * THE FROZEN VERSIONS OF A PAPER, by convention: one folder per attempt at a venue, named by the
+ * attempt's id in `paperlint.json` `cycles`, holding a file per stage and nothing else.
+ *
+ *   versions/
+ *   ├── alpha-2026/            ← a cycle id
+ *   │   ├── submitted.pdf      ← what the venue's reviewers read
+ *   │   └── submitted.tex      ← the source it was built from (a multi-file paper: assembled)
+ *   ├── beta-2027/
+ *   │   ├── submitted.pdf
+ *   │   ├── submitted.tex
+ *   │   └── camera-ready.pdf   ← only after the attempt is accepted
+ *   └── lock.json              ← generated: bytes, sha256 and the time each file was frozen
+ *
+ * ── WHY NAMES, NOT A RECORD ─────────────────────────────────────────────────────────────
+ * The `stages:` list in a paper's scorecard said the same thing as the file names, a second time, by
+ * hand, and a rule kept the two in step. Here the names ARE the record: which attempt a file belongs
+ * to is its folder, which stage is its name, and what state it is in follows from the attempt's
+ * `outcome` — the one value an author changes when a decision arrives. Nothing is typed twice.
+ *
+ * ── WHY A LOCK ──────────────────────────────────────────────────────────────────────────
+ * What a name cannot carry — the bytes a file had when it was frozen, its digest, when it was frozen,
+ * and that a source was lost — goes into `lock.json`, which paperlint writes and nobody edits
+ * (`package-lock.json`, `schema.rb`). A frozen file is never supposed to change, so a file that does
+ * not match its lock entry is the finding.
+ *
+ * ── NO DATES IN NAMES ───────────────────────────────────────────────────────────────────
+ * A second upload to the same attempt replaces the first: the last upload is the one under review.
+ * When it was frozen is a fact paperlint records in the lock, not one a person types into a name.
+ *
+ * Pure: the disk is read by the caller and handed in.
+ */
+import { diffLines } from "diff";
+import * as R from "remeda";
+import { CYCLE_ID_PATTERN, } from "./cycle.js";
+import { isRecord } from "./record.js";
+import { err, ok } from "./result.js";
+export const VERSIONS_DIR = "versions";
+export const LOCK_FILE = "lock.json";
+/** The stages a version is frozen at, in the order an attempt reaches them. */
+export const VERSION_STAGES = ["submitted", "camera-ready", "arxiv"];
+const isStage = (s) => VERSION_STAGES.some((v) => v === s);
+/** `submitted.pdf` → its stage and extension; null for a name outside the convention. Pure. */
+export function frozenName(name) {
+    const m = /^([a-z-]+)\.(pdf|tex)$/.exec(name);
+    const stage = m?.[1];
+    const ext = m?.[2];
+    return isStage(stage) && (ext === "pdf" || ext === "tex")
+        ? { stage, ext }
+        : null;
+}
+/** `<cycle>/<stage>.<ext>`: a frozen file's path under `versions/`, and its key in the lock. */
+export const frozenKey = (cycle, stage, ext) => `${cycle}/${stage}.${ext}`;
+/**
+ * A frozen file in the layout before folders per attempt, `versions/<date>-<stage>.<ext>`: what
+ * `paperlint versions migrate` moves into its attempt's folder.
+ */
+export const DATED_NAME = /^(\d{4}-\d{2}-\d{2})-([a-z-]+)\.(pdf|tex)$/;
+export const LOCK_VERSION = 1;
+/** What the lock says about itself, so nobody takes it for a file to edit. */
+export const LOCK_NOTE = "generated by paperlint — do not edit: `paperlint submission update --save` and `paperlint versions lock` write it";
+const SHA256 = /^[0-9a-f]{64}$/;
+const WHEN = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?Z)?$/;
+/** `<cycle>/<stage>.<ext>`, the cycle part by the same rule `parseCycles` holds an id to. */
+const KEY = new RegExp(`^(${CYCLE_ID_PATTERN})/([a-z-]+\\.(?:pdf|tex))$`);
+const isWhen = (v) => typeof v === "string" && WHEN.test(v);
+/** The cycle and the file name of a lock key; null for a key that is not `<cycle>/<stage>.<ext>`. */
+export function keyParts(key) {
+    const m = KEY.exec(key);
+    const name = frozenName(m?.[2] ?? "");
+    return m?.[1] === undefined || name === null ? null : { cycle: m[1], name };
+}
+const FILE_KEYS = ["bytes", "sha256", "frozen"];
+const LOST_KEYS = ["sourceLost", "frozen"];
+const whenProblem = (at) => `${at}: "frozen" must be a date or an instant`;
+/** An entry recording a lost source: `{ "sourceLost": true, "frozen"? }`. */
+function parseLost(at, ext, frozen) {
+    if (ext !== "tex")
+        return err(`${at}: only a source (.tex) can be recorded as lost`);
+    return frozen === undefined || isWhen(frozen)
+        ? ok({ kind: "lost", frozen: frozen ?? null })
+        : err(whenProblem(at));
+}
+/** An entry recording a frozen file: `{ "bytes", "sha256", "frozen" }`. */
+function parseFile(at, v) {
+    const { bytes, sha256, frozen } = v;
+    if (typeof bytes !== "number" || !Number.isInteger(bytes) || bytes < 0)
+        return err(`${at}: "bytes" must be a whole number`);
+    if (typeof sha256 !== "string" || !SHA256.test(sha256))
+        return err(`${at}: "sha256" must be 64 lowercase hex digits`);
+    return isWhen(frozen)
+        ? ok({ kind: "file", bytes, sha256, frozen })
+        : err(whenProblem(at));
+}
+function parseEntry(key, v) {
+    const at = `"files"["${key}"]`;
+    const parts = keyParts(key);
+    if (parts === null)
+        return err(`${at}: a key is <cycle>/<stage>.pdf or .tex`);
+    if (!isRecord(v))
+        return err(`${at} must be an object`);
+    const lost = v["sourceLost"] === true;
+    const unknown = Object.keys(v).find((k) => !(lost ? LOST_KEYS : FILE_KEYS).includes(k));
+    if (unknown !== undefined)
+        return err(`${at}: unknown key "${unknown}"`);
+    return lost ? parseLost(at, parts.name.ext, v["frozen"]) : parseFile(at, v);
+}
+/** `lock.json`, parsed → the lock, or one line naming what is wrong. Pure. */
+export function parseLock(json) {
+    if (!isRecord(json) || json["lockfileVersion"] !== LOCK_VERSION)
+        return err(`not a lock this paperlint writes ("lockfileVersion": ${String(LOCK_VERSION)})`);
+    const files = json["files"];
+    if (!isRecord(files))
+        return err(`"files" must be an object`);
+    return Object.entries(files).reduce((acc, [key, v]) => {
+        if (!acc.ok)
+            return acc;
+        const e = parseEntry(key, v);
+        return e.ok ? ok({ ...acc.value, [key]: e.value }) : e;
+    }, ok({}));
+}
+const entryJson = (e) => e.kind === "lost"
+    ? { sourceLost: true, ...(e.frozen === null ? {} : { frozen: e.frozen }) }
+    : { bytes: e.bytes, sha256: e.sha256, frozen: e.frozen };
+/** The lock as paperlint writes it: keys sorted, two spaces, a newline at the end. Pure. */
+export const lockText = (lock) => `${JSON.stringify({
+    lockfileVersion: LOCK_VERSION,
+    note: LOCK_NOTE,
+    files: Object.fromEntries(R.sortBy(Object.entries(lock), ([k]) => k).map(([k, e]) => [
+        k,
+        entryJson(e),
+    ])),
+}, null, 2)}\n`;
+const STAGES_TEXT = VERSION_STAGES.join(", ");
+const stray = (path, hint) => ({
+    messageId: "stray",
+    data: { path, hint },
+});
+const MIGRATE_HINT = "a frozen version in the layout before folders per attempt: `npx paperlint versions migrate <paper>` moves it into versions/<cycle>/";
+const LAYOUT_HINT = `versions/ holds lock.json and one folder per cycle, each with <stage>.pdf and <stage>.tex (${STAGES_TEXT}) — anything else goes to extra/`;
+/** An entry directly in `versions/`: fine, a cycle's folder, or a finding. */
+function rootFinding(e, ids) {
+    if (e.name.startsWith("."))
+        return [];
+    if (e.kind === "dir")
+        return ids.includes(e.name)
+            ? []
+            : [
+                {
+                    messageId: "unknownCycle",
+                    data: { folder: e.name, known: ids.join(" · ") || "(none)" },
+                },
+            ];
+    if (e.name === LOCK_FILE)
+        return [];
+    return [stray(e.name, DATED_NAME.test(e.name) ? MIGRATE_HINT : LAYOUT_HINT)];
+}
+/** The frozen files of the cycles' folders, and every entry there outside the convention. */
+function folderContents(input) {
+    // Each cycle's folder by the cycle's own id, so every key below is built from a parsed one.
+    const folders = input.cycles
+        .map((c) => c.id)
+        .filter((id) => input.root.some((e) => e.kind === "dir" && e.name === id));
+    const listed = folders.flatMap((id) => input.inFolder(id).map((e) => ({ cycle: id, e })));
+    const named = listed.map(({ cycle, e }) => ({
+        cycle,
+        e,
+        name: e.kind === "file" ? frozenName(e.name) : null,
+    }));
+    return {
+        found: named.flatMap(({ cycle, name }) => name === null
+            ? []
+            : [{ ...name, cycle, key: frozenKey(cycle, name.stage, name.ext) }]),
+        strays: named
+            .filter(({ e, name }) => name === null && !e.name.startsWith("."))
+            .map(({ cycle, e }) => stray(`${cycle}/${e.name}`, LAYOUT_HINT)),
+    };
+}
+const isLost = (lock, key) => lock[key]?.kind === "lost";
+/** Each frozen PDF without its source beside it, unless the lock records the source as lost. */
+function missingSources(found, lock) {
+    const keys = found.map((f) => f.key);
+    return found
+        .filter((f) => f.ext === "pdf")
+        .map((f) => ({ f, tex: frozenKey(f.cycle, f.stage, "tex") }))
+        .filter(({ tex }) => !keys.includes(tex) && !isLost(lock, tex))
+        .map(({ f, tex }) => ({
+        messageId: "noSource",
+        data: { pdf: f.key, tex },
+    }));
+}
+/** A version sent from a cycle whose source is still declared to be in the previous venue's template. */
+const portingSends = (found, cycles) => found
+    .filter((f) => f.ext === "pdf" &&
+    (f.stage === "submitted" || f.stage === "camera-ready") &&
+    cycles.find((c) => c.id === f.cycle)?.phase === "porting")
+    .map((f) => ({ messageId: "porting", data: { file: f.key, id: f.cycle } }));
+/** Each frozen file against its lock entry, and each lock entry against the disk. */
+function lockFindings(found, lock, factsOf) {
+    const keys = found.map((f) => f.key);
+    const onDisk = found.flatMap((f) => {
+        const e = lock[f.key];
+        if (e === undefined || e.kind === "lost")
+            return [{ messageId: "notLocked", data: { file: f.key } }];
+        const got = factsOf(f.key);
+        return got.bytes === e.bytes && got.sha256 === e.sha256
+            ? []
+            : [
+                {
+                    messageId: "changed",
+                    data: {
+                        file: f.key,
+                        want: String(e.bytes),
+                        got: String(got.bytes),
+                        frozen: e.frozen,
+                    },
+                },
+            ];
+    });
+    const gone = Object.entries(lock)
+        .filter(([k, e]) => e.kind === "file" && !keys.includes(k))
+        .map(([k]) => ({ messageId: "lockedGone", data: { file: k } }));
+    return [...onDisk, ...gone];
+}
+/** The lock's findings: none needed, none there, unreadable, or each file against it. */
+function lockOf(input, found) {
+    if (input.lock === null)
+        return found.length === 0 ? [] : [{ messageId: "noLock", data: {} }];
+    if (!input.lock.ok)
+        return [{ messageId: "badLock", data: { why: input.lock.error } }];
+    return lockFindings(found, input.lock.value, input.factsOf);
+}
+/**
+ * `versions/layout`: every entry of `versions/` against the convention — a folder per cycle, a file
+ * per stage — the porting declaration, and every frozen file against the lock. Pure.
+ */
+export function judgeVersions(input) {
+    const ids = input.cycles.map((c) => c.id);
+    const { found, strays } = folderContents(input);
+    const lock = input.lock?.ok === true ? input.lock.value : {};
+    return [
+        ...input.root.flatMap((e) => rootFinding(e, ids)),
+        ...strays,
+        ...missingSources(found, lock),
+        ...portingSends(found, input.cycles),
+        ...lockOf(input, found),
+    ];
+}
+/**
+ * `cycle/submitted-frozen`: each cycle that has a submission on the portal and no
+ * `versions/<id>/submitted.pdf`. Pure over whether a file exists, by its key.
+ */
+export const unfrozenSubmissions = (cycles, has) => cycles
+    .filter((c) => c.submission !== null && !has(frozenKey(c.id, "submitted", "pdf")))
+    .map((c) => ({
+    messageId: "unfrozen",
+    data: {
+        id: c.id,
+        submission: String(c.submission?.id),
+        pdf: frozenKey(c.id, "submitted", "pdf"),
+    },
+}));
+/** The lines `draft` adds to `frozen` and removes from it (a line diff, as `git diff --numstat`). Pure. */
+export function lineDrift(frozen, draft) {
+    const parts = diffLines(frozen, draft);
+    return {
+        added: R.sumBy(parts, (p) => (p.added ? p.count : 0)),
+        removed: R.sumBy(parts, (p) => (p.removed ? p.count : 0)),
+    };
+}
+/** The lines of `accepted` that `later` keeps unchanged, counted with the same line diff as the drift. Pure. */
+export function lineage(accepted, later) {
+    const parts = diffLines(accepted, later);
+    const kept = R.sumBy(parts, (p) => (p.added || p.removed ? 0 : p.count));
+    const removed = R.sumBy(parts, (p) => (p.removed ? p.count : 0));
+    return { kept, total: kept + removed };
+}
+/**
+ * Whether a camera-ready started from the accepted source: it keeps at least half of its lines. A
+ * camera-ready is what was accepted plus the changes the reviewers asked for, so it differs — any
+ * difference cannot be the test. One that keeps less than half was built from something else.
+ */
+export const derivesFrom = (l) => l.kept * 2 >= l.total;
+export const driftText = (d) => `${String(d.added)} line${d.added === 1 ? "" : "s"} added, ${String(d.removed)} removed`;
+/** The venue of a cycle, as a person names it: the preset's spec, or the named venue. */
+/** A cycle's venue as a person names it: a named venue's name, a preset's name without its package or path. */
+export const venueName = (c) => c.venue.kind === "preset"
+    ? c.venue.extends
+        .replace(/^paperlint:/, "")
+        .replace(/^.*\//, "")
+        .replace(/\.jsonc?$/, "")
+    : c.venue.name;
+/**
+ * The frozen source the draft is measured against: the open cycle's `submitted.tex`, or — once the
+ * last cycle is accepted — its newest (`camera-ready.tex`, else `submitted.tex`); null between venues
+ * and before the first attempt. Pure over whether a file exists.
+ */
+export function driftBase(current, has) {
+    switch (current.kind) {
+        case "cycle":
+            return {
+                cycle: current.cycle,
+                key: frozenKey(current.cycle.id, "submitted", "tex"),
+            };
+        case "accepted": {
+            const camera = frozenKey(current.cycle.id, "camera-ready", "tex");
+            return {
+                cycle: current.cycle,
+                key: has(camera)
+                    ? camera
+                    : frozenKey(current.cycle.id, "submitted", "tex"),
+            };
+        }
+        case "parked":
+        case "none":
+            return null;
+    }
+}
+/** What a frozen stage of a cycle IS, from the cycle's outcome. Pure. */
+export function stateOf(c, stage) {
+    if (stage === "arxiv")
+        return "arXiv copy";
+    switch (c.outcome.kind) {
+        case "open":
+            return stage === "submitted"
+                ? `CURRENT (under review at ${venueName(c)})`
+                : "camera-ready, cycle still open";
+        case "accepted":
+            return stage === "submitted" ? "camera-ready base" : "final";
+        case "rejected":
+        case "withdrawn":
+            return `historical (${c.outcome.kind})`;
+    }
+}
+/** `2026-10-23T16:58:01.000Z` → `2026-10-23 16:58 UTC`; a day stays a day. */
+const whenText = (frozen) => frozen.length === 10
+    ? frozen
+    : `${frozen.slice(0, 10)} ${frozen.slice(11, 16)} UTC`;
+/** A PDF's lock entry as the table shows it (only a source can be recorded lost). */
+const entryDetail = (e) => e === undefined || e.kind === "lost"
+    ? "not locked"
+    : `${String(e.bytes)} B  frozen ${whenText(e.frozen)}`;
+/** The stages a cycle has frozen: a PDF, a source, or a source the lock records as lost. */
+const frozenStages = (c, has, lock) => VERSION_STAGES.filter((s) => has(frozenKey(c.id, s, "pdf")) ||
+    has(frozenKey(c.id, s, "tex")) ||
+    isLost(lock, frozenKey(c.id, s, "tex")));
+/** The row of a cycle that froze nothing: what it is, from its outcome. */
+const emptyRow = (c) => ({
+    version: c.id,
+    stage: "—",
+    state: c.outcome.kind === "open"
+        ? "open, nothing sent yet"
+        : `${c.outcome.kind}, nothing frozen`,
+    detail: "",
+});
+/** A cycle's rows: one per stage frozen in its folder, or one saying what is missing or that nothing is. */
+function cycleRows(c, has, lock) {
+    const stages = frozenStages(c, has, lock);
+    const unfrozen = c.submission !== null && !stages.includes("submitted")
+        ? [
+            {
+                version: c.id,
+                stage: "submitted",
+                state: `NOT FROZEN — submission ${String(c.submission.id)} is on the portal`,
+                detail: "",
+            },
+        ]
+        : [];
+    const frozen = stages.map((s) => ({
+        version: c.id,
+        stage: s,
+        state: stateOf(c, s),
+        detail: [
+            entryDetail(lock[frozenKey(c.id, s, "pdf")]),
+            ...(isLost(lock, frozenKey(c.id, s, "tex")) ? ["source lost"] : []),
+        ].join(", "),
+    }));
+    const rows = [...unfrozen, ...frozen];
+    return rows.length > 0 ? rows : [emptyRow(c)];
+}
+const draftDetail = (d) => {
+    switch (d.kind) {
+        case "none":
+            return "no attempt to compare with";
+        case "no-base":
+            return `nothing frozen at ${d.key} to compare with`;
+        case "same":
+            return `same as ${d.key}`;
+        case "drift":
+            return `differs from ${d.key}: ${driftText(d.drift)}`;
+    }
+};
+/** The table: each cycle, newest first, then the draft. Pure. */
+export function versionRows(input) {
+    return [
+        ...[...input.cycles]
+            .reverse()
+            .flatMap((c) => cycleRows(c, input.has, input.lock)),
+        {
+            version: "paper.tex",
+            stage: "draft",
+            state: "target not chosen",
+            detail: draftDetail(input.draft),
+        },
+    ];
+}
+/** The rows as aligned columns, two spaces in front. Pure. */
+export function versionTable(rows) {
+    const width = (pick) => Math.max(...rows.map((r) => pick(r).length));
+    const w = [
+        width((r) => r.version),
+        width((r) => r.stage),
+        width((r) => r.state),
+    ];
+    return rows.map((r) => `  ${r.version.padEnd(w[0])}  ${r.stage.padEnd(w[1])}  ${r.state.padEnd(w[2])}  ${r.detail}`.trimEnd());
+}
+/** What one found file does to the lock: kept as recorded, recorded anew, or recorded for the first time. */
+function relocked(f, old, now) {
+    const fresh = { kind: "file", ...f.facts, frozen: now };
+    if (old?.kind !== "file")
+        return {
+            entry: fresh,
+            line: `locked        versions/${f.key} (${String(f.facts.bytes)} bytes)`,
+        };
+    return old.sha256 === f.facts.sha256 && old.bytes === f.facts.bytes
+        ? { entry: old, line: null }
+        : {
+            entry: fresh,
+            line: `re-locked     versions/${f.key}: ${String(old.bytes)} → ${String(f.facts.bytes)} bytes — it changed after ${old.frozen}`,
+        };
+}
+/**
+ * `paperlint versions lock`: the lock for the files on disk — each kept as recorded, recorded when it
+ * is new or changed, an entry whose file is gone dropped, a lost source kept while no file replaces
+ * it — and a line per change. Pure.
+ */
+export function relock(found, old, now) {
+    const keys = found.map((f) => f.key);
+    const each = found.map((f) => ({
+        key: f.key,
+        ...relocked(f, old[f.key], now),
+    }));
+    const gone = Object.entries(old).filter(([k]) => !keys.includes(k));
+    return {
+        lock: {
+            ...Object.fromEntries(gone.filter(([, e]) => e.kind === "lost")),
+            ...Object.fromEntries(each.map((e) => [e.key, e.entry])),
+        },
+        lines: [
+            ...each.flatMap((e) => (e.line === null ? [] : [e.line])),
+            ...gone
+                .filter(([, e]) => e.kind === "file")
+                .map(([k]) => `dropped       versions/${k}: the file is gone`),
+        ],
+    };
+}
+//# sourceMappingURL=versions.js.map

package/dist/domain/versions.js.map

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

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

@@ -17,12 +17,17 @@ declare const _default: {
                     declaredNoFile: string;
                     bytesDiffer: string;
                     fileNotDeclared: string;
+                    retired: string;
                 };
             };
             create(context: RuleContext): {
                 yaml(node: {
                     readonly value?: string;
                 }): void;
+            } | {
+                yaml(node: {
+                    readonly value?: string;
+                }): void;
                 "root:exit"(node: object): void;
             };
         };
@@ -72,6 +77,8 @@ declare const _default: {
                 };
             };
             create(context: RuleContext): {
+                yaml?: never;
+            } | {
                 yaml(node: {
                     readonly value?: string;
                 }): void;

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

@@ -1 +1 @@
-{"version":3,"file":"paper-stages.d.ts","sourceRoot":"","sources":["../../eslint-rules/paper-stages.ts"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;4BAqG/B,WAAW;2BAKZ;oBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE;kCA8FpB,MAAM;;;QAgB9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BG;;;;;;;;;;;;;;;4BAoBe,WAAW;2BAGZ;oBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE;;;;;AAlMhD,wBA2PE"}
+{"version":3,"file":"paper-stages.d.ts","sourceRoot":"","sources":["../../eslint-rules/paper-stages.ts"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;;4BAiK/B,WAAW;2BAxHlB;oBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE;;2BA6HrB;oBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE;kCA8FpB,MAAM;;;QAa9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BG;;;;;;;;;;;;;;;4BAoBe,WAAW;;;2BAKZ;oBAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE;;;;;AAnMhD,wBA4PE"}

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

@@ -46,8 +46,8 @@
  * 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 { existsSync, readFileSync, statSync, readdirSync } from "node:fs";
+import { join, dirname, relative } from "node:path";
 import assert from "node:assert/strict";
 import { load } from "js-yaml";
 import { z } from "zod";
@@ -66,6 +66,56 @@ const StageRecord = z
     sourceLost: z.unknown().optional(),
 })
     .catch({});
+/** What these rules read of the paper's settings: whether it keeps `cycles` at all. */
+const Settings = z
+    .looseObject({ cycles: z.array(z.unknown()).optional() })
+    .catch({});
+/**
+ * Whether the paper keeps `cycles` in its paperlint.json. Its frozen versions are then
+ * `versions/<cycle>/<stage>.{pdf,tex}` recorded in `versions/lock.json`, judged by `versions/layout`,
+ * and the `stages:` list is retired: `paperlint versions migrate` turns it into folders.
+ */
+function keepsCycles(dir) {
+    try {
+        const raw = JSON.parse(readFileSync(join(dir, "paperlint.json"), "utf8"));
+        return Settings.parse(raw).cycles !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+/** Under `cycles`: a non-empty `stages:` list is one finding, naming the command that retires it. */
+function retired(context, dir) {
+    return {
+        yaml(node) {
+            const parsed = (() => {
+                try {
+                    return { ok: true, data: load(node.value ?? "") };
+                }
+                catch (e) {
+                    assert.ok(e instanceof Error);
+                    return { ok: false, reason: e.message };
+                }
+            })();
+            if (!parsed.ok) {
+                context.report({
+                    node,
+                    messageId: "badYaml",
+                    data: { reason: parsed.reason },
+                });
+                return;
+            }
+            const raw = Frontmatter.parse(parsed.data).stages;
+            if (raw === undefined || (Array.isArray(raw) && raw.length === 0))
+                return;
+            context.report({
+                node,
+                messageId: "retired",
+                data: { paper: relative(context.cwd, dir) || "." },
+            });
+        },
+    };
+}
 const REQUIRED = ["date", "pdf", "bytes"];
 const STAGES = ["submitted", "camera-ready", "arxiv"];
 /**
@@ -113,6 +163,8 @@ function frozenPdfs(versionsDir) {
     }
     return out;
 }
+/** The frozen PDFs in `versions/` that no declared stage of the same day names. */
+const undeclared = (dir, records) => frozenPdfs(join(dir, "versions")).filter((f) => !records.some((r) => r.stage === f.stage && r.date === f.date));
 export default {
     rules: {
         stages: {
@@ -131,10 +183,13 @@ export default {
                     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",
+                    retired: "`stages` is retired for a paper that keeps `cycles` in paperlint.json: its frozen versions are versions/<cycle>/<stage>.{pdf,tex}, recorded in versions/lock.json — `npx paperlint versions migrate {{paper}}` moves the files there and takes the list out",
                 },
             },
             create(context) {
                 const dir = dirname(context.filename);
+                if (keepsCycles(dir))
+                    return retired(context, dir);
                 let declared = null; // null = there was no frontmatter at all
                 return {
                     yaml(node) {
@@ -233,16 +288,13 @@ export default {
                     // 🔴 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;
+                        undeclared(dir, declared ?? []).forEach((f) => {
                             context.report({
                                 node,
                                 messageId: "fileNotDeclared",
                                 data: { file: f.name, stage: f.stage, date: f.date },
                             });
-                        }
+                        });
                     },
                 };
             },
@@ -294,6 +346,9 @@ export default {
             },
             create(context) {
                 const dir = dirname(context.filename);
+                // Under `cycles` the lock records each frozen source, and `versions/layout` checks it.
+                if (keepsCycles(dir))
+                    return {};
                 return {
                     yaml(node) {
                         let data;