paperlint 12.0.0 → 13.0.0

package/dist/version-rules.js

@@ -0,0 +1,201 @@
+/**
+ * THE RULES OVER A PAPER'S FROZEN VERSIONS — the convention `versions/<cycle>/<stage>.{pdf,tex}` and
+ * its lock (src/domain/versions.ts):
+ *
+ *   versions/layout              error  on PIPELINE-STATUS.md: every entry of versions/ is a cycle's
+ *                                       folder or the lock, every file in a folder a stage's .pdf or
+ *                                       .tex, every PDF with its source, nothing sent from a cycle still
+ *                                       porting, every file as the lock recorded it
+ *   cycle/submitted-frozen       error  on PIPELINE-STATUS.md: a cycle with a submission on the portal
+ *                                       has `versions/<id>/submitted.pdf` (#308)
+ *   cycle/draft-drift            warn   on paper.tex: the draft has moved on from the open cycle's
+ *                                       frozen source, by so many lines
+ *   cycle/camera-ready-source    error  on paper.tex: the last cycle is accepted and its camera-ready is
+ *                                       frozen, and that camera-ready keeps less than half of the
+ *                                       accepted source's lines — silent until the camera-ready is frozen
+ *
+ * ── WHY THE FOLDER IS LISTED AND NOT LINTED ─────────────────────────────────────────────────
+ * A frozen PDF is never handed to ESLint, and a frozen `.tex` is kept out of the linted set on purpose
+ * (src/paper-includes.ts): a rule fired per file could not see either. The folder is listed once per
+ * paper, from the scorecard every paper has, as `paper/allowed-files-only` lists the paper's root.
+ *
+ * ── WHO SPEAKS WHEN THERE IS NOTHING TO JUDGE ───────────────────────────────────────────────
+ * A paper that keeps no `cycles` (the flat form) has no attempt to name a folder after: all four are
+ * silent, and `paper/stages` with `paper/source` judge its `stages:` list as before. A `cycles` record
+ * that does not read is refused by `paperlint lint` before any rule runs.
+ *
+ * ── WHY THE DRIFT IS A WARNING, AND THE CAMERA-READY AN ERROR ───────────────────────────────
+ * Between venues the draft is SUPPOSED to move on from what is under review: the warning says how far,
+ * so an author answering a reviewer knows the line numbers point into the frozen file. Once the venue
+ * accepts, the camera-ready has to be what was accepted plus the changes asked for — building it from
+ * a draft that moved on sends the venue a paper its reviewers never read.
+ *
+ * ── WHY THE CAMERA-READY IS JUDGED ONLY ONCE IT IS FROZEN ───────────────────────────────────
+ * While the camera-ready is being edited, paper.tex differs from what was accepted BY DESIGN: the
+ * reviewers' changes go in. A check on the draft in those weeks fires on correct work, so the rule waits
+ * for `submission update --save` to freeze `camera-ready.{pdf,tex}`, then judges the frozen source:
+ * it must keep at least half of the accepted source's lines (`derivesFrom`, src/domain/versions.ts).
+ * After the freeze the draft is not judged at all — what the venue holds is fixed, and the draft is
+ * free to head for the next paper.
+ */
+import { basename, dirname } from "node:path";
+import { derivesFrom, driftText, frozenKey, judgeVersions, lineage, unfrozenSubmissions, venueName, } from "./domain/versions.js";
+import { readPaper } from "./tex-paper.js";
+import { rulePageUrl } from "./venue-rules.js";
+import { cyclesIn, draftDrift, entriesIn, factsOfFrozen, frozenText, hasFrozen, readLock, versionsDir, } from "./versions.js";
+const STATUS_FILE = "PIPELINE-STATUS.md";
+const LOCK_COMMAND = "`npx paperlint versions lock <paper>`";
+const LAYOUT_META = {
+    type: "suggestion",
+    docs: {
+        description: "versions/ holds a folder per cycle and a file per stage, every PDF with its source, each file as versions/lock.json recorded it",
+        url: rulePageUrl("versions/layout"),
+    },
+    schema: [],
+    messages: {
+        stray: "`versions/{{path}}` is not part of the layout — {{hint}}",
+        unknownCycle: "`versions/{{folder}}/` names no cycle in paperlint.json — a folder in versions/ is one attempt, named by its cycle's id ({{known}}): rename it to the attempt it holds, or move it to extra/",
+        noSource: `\`versions/{{pdf}}\` is frozen without its source: freeze the .tex it was built from as \`versions/{{tex}}\` and run ${LOCK_COMMAND} — a reviewer's line numbers point into that source, and squash merges and \`git gc\` destroy the commit that held it`,
+        porting: "`versions/{{file}}` was sent in the cycle «{{id}}», whose phase is still `porting`: a PDF went to the venue while the record says the source is in the previous venue's template — finish the port and drop the phase, or the file is in the wrong folder",
+        noLock: `versions/ holds frozen files and no lock.json — ${LOCK_COMMAND} records their bytes and digests; paperlint writes the lock, nobody edits it`,
+        badLock: `versions/lock.json: {{why}} — paperlint writes this file: restore it from git, or write it anew with ${LOCK_COMMAND}`,
+        notLocked: `\`versions/{{file}}\` is not in versions/lock.json — ${LOCK_COMMAND} records it (a file \`submission … --save\` froze is locked already)`,
+        changed: `\`versions/{{file}}\` is not the file the lock recorded on {{frozen}} ({{want}} bytes then, {{got}} now, and another digest) — a frozen file does not change: restore it from git; if it was replaced on purpose, ${LOCK_COMMAND} records it anew`,
+        lockedGone: `versions/lock.json records \`{{file}}\`, and the file is not there — a frozen version was deleted: restore it from git; if it went on purpose, ${LOCK_COMMAND} drops the entry`,
+    },
+};
+const FROZEN_META = {
+    type: "suggestion",
+    docs: {
+        description: "a cycle with a submission on the venue's portal has the PDF it sent frozen as versions/<cycle>/submitted.pdf",
+        url: rulePageUrl("cycle/submitted-frozen"),
+    },
+    schema: [],
+    messages: {
+        unfrozen: `cycle «{{id}}» has submission {{submission}} on the portal, and \`versions/{{pdf}}\` is not there: what the reviewers read is not frozen. \`npx paperlint submission update <paper> --save\` freezes what it sends; for an upload made before, put that PDF there (\`submission show\` gives its size and sha256) with the source it was built from beside it as submitted.tex, then run ${LOCK_COMMAND}`,
+    },
+};
+/** The findings of one scorecard rule for the paper folder `dir`; none for a paper without cycles. */
+function statusFindings(name, dir, deps) {
+    const cycles = cyclesIn(dir, deps.files);
+    if (cycles === null)
+        return [];
+    const root = versionsDir(dir);
+    return name === "layout"
+        ? judgeVersions({
+            cycles: cycles.list,
+            root: entriesIn(root, deps),
+            inFolder: (folder) => entriesIn(`${root}/${folder}`, deps),
+            lock: readLock(dir, deps.files),
+            factsOf: factsOfFrozen(dir, deps.files),
+        })
+        : unfrozenSubmissions(cycles.list, hasFrozen(dir, deps.files));
+}
+const statusRule = (meta, name, deps) => ({
+    meta,
+    create(context) {
+        if (basename(context.filename) !== STATUS_FILE)
+            return {};
+        return {
+            root() {
+                const at = context.sourceCode.getLocFromIndex(0);
+                statusFindings(name, dirname(context.filename), deps).forEach((f) => {
+                    context.report({ loc: { start: at, end: at }, ...f });
+                });
+            },
+        };
+    },
+});
+/** The `versions` plugin's rule, on every `PIPELINE-STATUS.md`. */
+export const versionLayoutRules = (deps) => ({
+    layout: statusRule(LAYOUT_META, "layout", deps),
+});
+/** The `cycle` plugin's rule over the frozen folder, on every `PIPELINE-STATUS.md`. */
+export const submittedFrozenRules = (deps) => ({
+    "submitted-frozen": statusRule(FROZEN_META, "submitted-frozen", deps),
+});
+// ── on paper.tex: the draft against the frozen source ────────────────────────────────────
+const DRIFT_META = {
+    type: "suggestion",
+    docs: {
+        description: "paper.tex has moved on from the source frozen when the open cycle's PDF was sent — said with how many lines",
+        url: rulePageUrl("cycle/draft-drift"),
+    },
+    schema: [],
+    messages: {
+        drift: "paper.tex has moved on from `versions/{{key}}`, the version under review at {{venue}}: {{drift}} — expected while the draft heads for its next venue; a reviewer's line numbers point into the frozen file, not this one",
+    },
+};
+const CAMERA_META = {
+    type: "problem",
+    docs: {
+        description: "once the last cycle is accepted and its camera-ready frozen, the camera-ready started from the source that was accepted",
+        url: rulePageUrl("cycle/camera-ready-source"),
+    },
+    schema: [],
+    messages: {
+        base: "cycle «{{id}}» is accepted, and its frozen camera-ready, `versions/{{id}}/camera-ready.tex`, keeps {{kept}} of the {{total}} lines of what was accepted, `versions/{{id}}/submitted.tex` — under half, so it was not built from the accepted source. The camera-ready is what was accepted plus the changes the reviewers asked for: copy submitted.tex over paper.tex, carry over those changes, build, and send it again with `npx paperlint submission update <paper> --save`, which replaces the frozen one",
+    },
+};
+/** The draft against the open cycle's frozen source, or none. */
+function driftFinding(dir, draft, deps) {
+    const cycles = cyclesIn(dir, deps.files);
+    if (cycles === null || cycles.current.kind !== "cycle")
+        return null;
+    const c = cycles.current.cycle;
+    const d = draftDrift(dir, cycles, draft, deps.files);
+    return d.kind === "drift"
+        ? {
+            messageId: "drift",
+            data: { key: d.key, venue: venueName(c), drift: driftText(d.drift) },
+        }
+        : null;
+}
+/**
+ * The accepted cycle's frozen camera-ready against its frozen `submitted.tex`, or none: nothing to judge
+ * before the camera-ready is frozen (or without either source), and nothing wrong when it derives.
+ */
+function cameraFinding(dir, files) {
+    const cycles = cyclesIn(dir, files);
+    if (cycles === null || cycles.current.kind !== "accepted")
+        return null;
+    const id = cycles.current.cycle.id;
+    const camera = frozenText(dir, frozenKey(id, "camera-ready", "tex"), files);
+    const accepted = frozenText(dir, frozenKey(id, "submitted", "tex"), files);
+    if (camera === null || accepted === null)
+        return null;
+    const l = lineage(accepted, camera);
+    return derivesFrom(l)
+        ? null
+        : {
+            messageId: "base",
+            data: { id, kept: String(l.kept), total: String(l.total) },
+        };
+}
+/** A rule on paper.tex: its one finding, reported on the first line. */
+const paperRule = (meta, finding, deps) => ({
+    meta,
+    create(context) {
+        if (basename(context.filename) !== "paper.tex")
+            return {};
+        return {
+            root() {
+                const sc = context.sourceCode;
+                const f = finding(dirname(context.filename), () => readPaper(context.filename, sc.raw ?? sc.text, deps).text);
+                if (f === null)
+                    return;
+                const at = sc.getLocFromIndex(0);
+                context.report({ loc: { start: at, end: at }, ...f });
+            },
+        };
+    },
+});
+/** The `cycle` plugin's rules over the draft, for every `paper.tex`. */
+export const draftRules = (deps) => ({
+    "draft-drift": paperRule(DRIFT_META, (dir, draft) => driftFinding(dir, draft(), deps), deps),
+    "camera-ready-source": paperRule(CAMERA_META, (dir) => cameraFinding(dir, deps.files), deps),
+});
+/** The levels they are on at in paperlint's own config. */
+export const VERSION_STATUS_RULE_LEVELS = { "versions/layout": "error", "cycle/submitted-frozen": "error" };
+export const DRAFT_RULE_LEVELS = { "cycle/draft-drift": "warn", "cycle/camera-ready-source": "error" };
+//# sourceMappingURL=version-rules.js.map

package/dist/version-rules.js.map

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

package/dist/versions-command.d.ts

@@ -0,0 +1,37 @@
+import { type MigrationPlan } from "./domain/versions-migration.ts";
+import type { CopyFile, MoveFile } from "./ports/move-file.ts";
+import type { ParseYaml } from "./ports/yaml.ts";
+import type { ProseDeps } from "./tex-paper.ts";
+import { type VersionsDeps } from "./versions.ts";
+declare const SUBS: readonly ["show", "lock", "migrate"];
+type Sub = (typeof SUBS)[number];
+export interface VersionsCommandDeps extends ProseDeps, VersionsDeps {
+    readonly move: MoveFile;
+    readonly copy: CopyFile;
+    readonly yaml: ParseYaml;
+    /** The instant a lock entry records, ISO 8601. */
+    readonly now: () => string;
+    readonly cwd: string;
+    readonly log: (line: string) => void;
+    readonly err: (line: string) => void;
+}
+/** The words after `versions` → the subcommand, the paper folder, and what is left over. Pure. */
+export declare function versionsArgs(words: readonly string[]): {
+    readonly sub: Sub;
+    readonly paper: string;
+    readonly extra: readonly string[];
+};
+/** What the scorecard holds for the migration: its `stages:` list, and its text without it (null: none to take out). */
+export interface Scorecard {
+    readonly stages: readonly unknown[];
+    readonly without: string | null;
+}
+/**
+ * A plan carried out only once its rehearsal on the paths it touches went through (src/domain/
+ * versions-migration.ts, `rehearse`): a plan that could stop half-way is a refusal, nothing written.
+ */
+export declare function carryOut(paperDir: string, plan: MigrationPlan, card: Scorecard, deps: VersionsCommandDeps): number;
+/** `paperlint versions …`: exit 0, or 2 for a command line or a paper it cannot run on. */
+export declare function runVersions(words: readonly string[], deps: VersionsCommandDeps): number;
+export {};
+//# sourceMappingURL=versions-command.d.ts.map

package/dist/versions-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions-command.d.ts","sourceRoot":"","sources":["../src/versions-command.ts"],"names":[],"mappings":"AAuBA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAUxC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,QAAA,MAAM,IAAI,sCAAuC,CAAC;AAClD,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAKjC,MAAM,WAAW,mBAAoB,SAAQ,SAAS,EAAE,YAAY;IAClE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;IACtD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CASA;AA4ED,wHAAwH;AACxH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA6FD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAOR;AA8DD,2FAA2F;AAC3F,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAqBR"}

package/dist/versions-command.js

@@ -0,0 +1,209 @@
+/**
+ * `paperlint versions [show|lock|migrate] [paper]` — a paper's frozen versions, one folder per
+ * attempt (src/domain/versions.ts):
+ *
+ *   show      (the default) each attempt's frozen versions and what they are, newest first, then the
+ *             draft and how far it has moved from the version it is measured against
+ *   lock      record the files of versions/ in versions/lock.json: what `submission --save` did not
+ *             freeze — a file put there by hand, an arXiv copy, a recovered upload
+ *   migrate   from the `stages:` list and dated files to folders per attempt, once
+ *
+ * ── WHY ONE NOUN, THREE VERBS ───────────────────────────────────────────────────────────────
+ * docs/prior-art/multi-mode-tools.md: tools that stay small add verbs to a noun the project already
+ * has, not nouns. The table is also printed by `paperlint submission show`, beside the portal's copy;
+ * `versions` prints it without a token or a network call. `lock` is the `npm install` slot — make the
+ * generated file match the disk — and `migrate` runs once per paper.
+ */
+import { join, relative, resolve } from "node:path";
+import * as R from "remeda";
+import { callerPath } from "./caller-path.js";
+import { fieldOf, isRecord } from "./domain/record.js";
+import { err, ok } from "./domain/result.js";
+import { sha256Hex } from "./domain/sha256.js";
+import { frontmatterOf, planMigration, rehearse, withoutStages, } from "./domain/versions-migration.js";
+import { frozenKey, frozenName, LOCK_FILE, lockText, relock, } from "./domain/versions.js";
+import { cyclesIn, entriesIn, factsOfFrozen, readLock, versionLines, versionsDir, } from "./versions.js";
+const SUBS = ["show", "lock", "migrate"];
+const isSub = (s) => SUBS.some((x) => x === s);
+const STATUS_FILE = "PIPELINE-STATUS.md";
+/** The words after `versions` → the subcommand, the paper folder, and what is left over. Pure. */
+export function versionsArgs(words) {
+    const [first, ...rest] = words;
+    const named = isSub(first);
+    const after = named ? rest : words;
+    return {
+        sub: named ? first : "show",
+        paper: after[0] ?? ".",
+        extra: after.slice(1),
+    };
+}
+/** The paper as a command line names it, from where the command runs. */
+const shown = (cwd, p) => relative(cwd, p) || ".";
+const logAll = (lines, deps) => {
+    lines.forEach((l) => {
+        deps.log(l);
+    });
+};
+// ── lock ────────────────────────────────────────────────────────────────────────────────
+/** Every frozen file in the cycles' folders, with what it holds. */
+function onDisk(paperDir, cycles, deps) {
+    const root = versionsDir(paperDir);
+    const facts = factsOfFrozen(paperDir, deps.files);
+    return cycles.list.flatMap((c) => entriesIn(join(root, c.id), deps).flatMap((e) => {
+        const n = e.kind === "file" ? frozenName(e.name) : null;
+        return n === null
+            ? []
+            : [
+                {
+                    key: frozenKey(c.id, n.stage, n.ext),
+                    facts: facts(frozenKey(c.id, n.stage, n.ext)),
+                },
+            ];
+    }));
+}
+const writeLock = (paperDir, lock, deps) => {
+    deps.files.writeAtomic(callerPath(join(versionsDir(paperDir), LOCK_FILE)), new TextEncoder().encode(lockText(lock)));
+};
+function runLock(paperDir, cycles, deps) {
+    const found = onDisk(paperDir, cycles, deps);
+    const old = readLock(paperDir, deps.files);
+    if (found.length === 0 && old === null)
+        return (deps.log("nothing frozen in versions/ — no lock to write"), 0);
+    const r = relock(found, old?.ok === true ? old.value : {}, deps.now());
+    writeLock(paperDir, r.lock, deps);
+    logAll([
+        ...(old?.ok === false
+            ? [
+                `versions/lock.json did not read (${old.error}): written anew from the files`,
+            ]
+            : []),
+        ...r.lines,
+    ], deps);
+    if (old?.ok !== false && r.lines.length === 0)
+        deps.log("versions/lock.json records every frozen file as it stands");
+    return 0;
+}
+/** The scorecard's text, "" when there is none. */
+const statusText = (paperDir, deps) => new TextDecoder().decode(deps.files.readBytes(callerPath(join(paperDir, STATUS_FILE))) ??
+    new Uint8Array());
+/** Whether the scorecard without its list says everything else it said: parsed, both, and compared. */
+function keepsTheRest(before, without, yaml) {
+    const after = yaml(frontmatterOf(without) ?? "");
+    return (after.ok && R.isDeepEqual(R.omit(before, ["stages"]), after.value ?? {}));
+}
+/** The scorecard read and its list taken out — checked by parsing both, so a cut that misreads is refused. */
+function scorecard(paperDir, deps) {
+    const text = statusText(paperDir, deps);
+    const before = deps.yaml(frontmatterOf(text) ?? "");
+    if (!before.ok)
+        return err(`${STATUS_FILE}: the frontmatter does not parse (${before.error}) — fix it, then migrate`);
+    // A frontmatter that is no mapping (none, or a bare value) has no `stages:` key to take out.
+    const fields = isRecord(before.value) ? before.value : {};
+    const list = fieldOf(fields, "stages");
+    const stages = Array.isArray(list) ? list : [];
+    const without = withoutStages(text);
+    return without === null || keepsTheRest(fields, without, deps.yaml)
+        ? ok({ stages, without })
+        : err(`${STATUS_FILE}: taking the stages: list out would change the rest of its frontmatter — take it out by hand, then migrate`);
+}
+/** A file of the paper, by its path relative to the paper: its size and digest, or null. */
+const paperFacts = (paperDir, deps) => (rel) => {
+    const b = deps.files.readBytes(callerPath(resolve(paperDir, rel)));
+    return b === null ? null : { bytes: b.length, sha256: sha256Hex(b) };
+};
+/** Each copy, then each move: a shared source is copied before the move takes it away. */
+function carry(paperDir, plan, deps) {
+    const at = (rel) => callerPath(resolve(paperDir, rel));
+    plan.copies.forEach((m) => {
+        deps.copy(at(m.from), at(m.to));
+        deps.log(`copied        ${m.from} → ${m.to}`);
+    });
+    plan.moves.forEach((m) => {
+        deps.move(at(m.from), at(m.to));
+        deps.log(`moved         ${m.from} → ${m.to}`);
+    });
+}
+/** The plan carried out: the files, the lock, the scorecard without its list. */
+function migrate(paperDir, plan, card, deps) {
+    carry(paperDir, plan, deps);
+    const entries = Object.keys(plan.lock).length;
+    if (entries > 0) {
+        writeLock(paperDir, plan.lock, deps);
+        deps.log(`recorded      versions/lock.json, ${String(entries)} entries`);
+    }
+    if (card.without !== null) {
+        deps.files.writeAtomic(callerPath(join(paperDir, STATUS_FILE)), new TextEncoder().encode(card.without));
+        deps.log(`removed       the stages: list from ${STATUS_FILE} — the folders and the lock are the record now`);
+    }
+    return 0;
+}
+/**
+ * A plan carried out only once its rehearsal on the paths it touches went through (src/domain/
+ * versions-migration.ts, `rehearse`): a plan that could stop half-way is a refusal, nothing written.
+ */
+export function carryOut(paperDir, plan, card, deps) {
+    const ran = rehearse(plan, (p) => deps.files.isFile(callerPath(resolve(paperDir, p))));
+    return ran.ok
+        ? migrate(paperDir, plan, card, deps)
+        : refused([...ran.error, "nothing was moved"], deps);
+}
+/** The lock already there, or the line saying it must be written first. */
+function lockBefore(paperDir, deps) {
+    const lock = readLock(paperDir, deps.files) ?? ok({});
+    return lock.ok
+        ? lock
+        : err(`versions/lock.json: ${lock.error} — \`npx paperlint versions lock ${shown(deps.cwd, paperDir)}\` writes it anew; then migrate`);
+}
+function runMigrate(paperDir, cycles, deps) {
+    const card = scorecard(paperDir, deps);
+    if (!card.ok)
+        return (deps.err(card.error), 2);
+    const lock = lockBefore(paperDir, deps);
+    if (!lock.ok)
+        return (deps.err(lock.error), 2);
+    const plan = planMigration({
+        cycleIds: cycles.list.map((c) => c.id),
+        stages: card.value.stages,
+        root: entriesIn(versionsDir(paperDir), deps),
+        factsOf: paperFacts(paperDir, deps),
+        lock: lock.value,
+        exists: (rel) => deps.files.isFile(callerPath(resolve(paperDir, rel))),
+    });
+    if (!plan.ok)
+        return refused([...plan.error, "nothing was moved"], deps);
+    // A copy always has its move: the last destination of a shared source is moved, not copied.
+    if (plan.value.moves.length === 0 && card.value.without === null)
+        return (deps.log(`nothing to migrate: ${STATUS_FILE} has no stages: list, and no file of the old layout is left in versions/`),
+            0);
+    return carryOut(paperDir, plan.value, card.value, deps);
+}
+const refused = (lines, deps) => {
+    lines.forEach((l) => {
+        deps.err(l);
+    });
+    return 2;
+};
+// ── the command ─────────────────────────────────────────────────────────────────────────
+const NO_CYCLES_LOCK = 'the paper keeps no "cycles" in paperlint.json: there is no versions/<cycle>/ to lock (docs/configuration.md, "The paper\'s cycles")';
+const NO_CYCLES_MIGRATE = 'the paper keeps no "cycles" in paperlint.json: its stages: list stays its record — folders per attempt are named by cycle ids (docs/configuration.md, "The paper\'s cycles")';
+/** `paperlint versions …`: exit 0, or 2 for a command line or a paper it cannot run on. */
+export function runVersions(words, deps) {
+    const a = versionsArgs(words);
+    if (a.extra.length > 0)
+        return (deps.err(`\`versions ${a.sub}\` takes one paper folder — got also \`${a.extra.join(" ")}\``),
+            2);
+    const paperDir = resolve(deps.cwd, a.paper);
+    if (a.sub === "show") {
+        const lines = versionLines(paperDir, deps);
+        if (!lines.ok)
+            return (deps.err(lines.error), 2);
+        return (logAll(lines.value, deps), 0);
+    }
+    const cycles = cyclesIn(paperDir, deps.files);
+    if (cycles === null)
+        return (deps.err(a.sub === "lock" ? NO_CYCLES_LOCK : NO_CYCLES_MIGRATE), 2);
+    return a.sub === "lock"
+        ? runLock(paperDir, cycles, deps)
+        : runMigrate(paperDir, cycles, deps);
+}
+//# sourceMappingURL=versions-command.js.map

package/dist/versions-command.js.map

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

package/dist/versions.d.ts

@@ -0,0 +1,76 @@
+import { type CycleId, type Cycles } from "./domain/cycle.ts";
+import { type Result } from "./domain/result.ts";
+import { type DraftDrift, type Entry, type FileFacts, type Lock } from "./domain/versions.ts";
+import type { Files } from "./ports/files.ts";
+import type { ListDir } from "./ports/talk-media.ts";
+import { type ProseDeps } from "./tex-paper.ts";
+/** The paper's `versions/` folder. */
+export declare const versionsDir: (paperDir: string) => string;
+/** A frozen file's path, by its key. */
+export declare const frozenPath: (paperDir: string, key: string) => string;
+/** Whether a frozen file is on disk, by its key. */
+export declare const hasFrozen: (paperDir: string, files: Files) => (key: string) => boolean;
+/** A frozen file's text, by its key; null when it is not there. */
+export declare const frozenText: (paperDir: string, key: string, files: Files) => string | null;
+/** The size and digest of a frozen file on disk, by its key: zero bytes of nothing when it is gone. */
+export declare const factsOfFrozen: (paperDir: string, files: Files) => (key: string) => FileFacts;
+/** `versions/lock.json`: null when there is none; else parsed, or why it does not parse. */
+export declare function readLock(paperDir: string, files: Files): Result<Lock, string> | null;
+/** What reading the folder needs: the disk and its listings. */
+export interface VersionsDeps {
+    readonly files: Files;
+    readonly listDir: ListDir;
+}
+/** The entries of a folder, each a file or a folder, by name. */
+export declare const entriesIn: (dir: string, deps: VersionsDeps) => readonly Entry[];
+/** The paper's cycles, when it keeps them and they read; null for the flat form or a broken record. */
+export declare function cyclesIn(paperDir: string, files: Files): Cycles | null;
+/** paper.tex, assembled as the last build read it (its includes spliced in); null without one. */
+export declare function draftText(paperDir: string, deps: ProseDeps): string | null;
+/** The draft against the frozen source of the paper's attempt: none, nothing frozen, the same, or drifted. */
+export declare function draftDrift(paperDir: string, cycles: Cycles, draft: string, files: Files): DraftDrift;
+/**
+ * The version → state table of the paper in `paperDir`: each attempt's frozen files and what they
+ * are, then the draft. Or why there is none: the paper keeps no `cycles`.
+ */
+export declare function versionLines(paperDir: string, deps: ProseDeps): Result<readonly string[], string>;
+/** What a `--save` will freeze once the portal takes the PDF: nothing for the flat form, else where. */
+export type FreezePlan = {
+    readonly kind: "flat";
+} | {
+    readonly kind: "freeze";
+    readonly cycle: CycleId;
+    readonly stage: "submitted" | "camera-ready";
+    /** paper.tex as the build read it, includes spliced in: the source the PDF was built from. */
+    readonly source: string;
+};
+/**
+ * Before a `--save` sends: what it will freeze — the open cycle's `submitted`, or the accepted one's
+ * `camera-ready` — and the source to freeze beside the PDF. Refused when the build's record does not
+ * say the source on disk is the one the PDF was built from: a PDF frozen with another source is a
+ * pair that lies.
+ */
+export declare function freezePlan(paperDir: string, cycles: Cycles | null, deps: ProseDeps): Result<FreezePlan, string>;
+/** What freezing writes with: the disk, and the instant the lock records (ISO 8601). */
+export interface FreezeDeps {
+    readonly files: Files;
+    readonly now: () => string;
+}
+/** What was sent: the paper, its plan, the PDF's bytes, and the paper as the command names it. */
+export interface Sent {
+    readonly paperDir: string;
+    readonly plan: Extract<FreezePlan, {
+        readonly kind: "freeze";
+    }>;
+    readonly pdf: Uint8Array;
+    readonly shownPaper: string;
+}
+/**
+ * After the portal took the PDF: the PDF and its source written to `versions/<cycle>/<stage>.*`,
+ * replacing an earlier upload's, and recorded in the lock. The line to print; an error line when the
+ * lock does not read (the files are frozen, the lock left as it is).
+ */
+export declare function freezeSent(s: Sent, deps: FreezeDeps): Result<string, string>;
+/** What a send in the flat form says instead of a freeze. */
+export declare const NOT_FROZEN = "not frozen    the paper keeps no \"cycles\" in paperlint.json: versions are frozen per attempt, in versions/<cycle>/ (docs/configuration.md, \"The paper's cycles\")";
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

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