@cleocode/contracts 2026.10.27 → 2026.11.1-canary.3

package/dist/docs/modernize.d.ts

@@ -0,0 +1,435 @@
+/**
+ * Docs modernize contract — the plan and receipt of `cleo docs modernize`.
+ *
+ * `cleo docs modernize <path>` turns a messy docs folder into clean, linked
+ * CleoDocs. A dry run produces a {@link DocsModernizePlan}: one
+ * {@link DocsModernizePlanRow} per markdown or text file, carrying the kind,
+ * the stable slug, the disposition and the reasons (including every System
+ * One judgment that was asked). `--apply` executes a plan and writes a
+ * {@link DocsModernizeReceipt}; every receipt op records the state it
+ * replaced, so `--rollback <runId>` can reverse the run.
+ *
+ * Types only — the planner and applier live in
+ * `packages/core/src/docs/modernize/`.
+ *
+ * @task T14113
+ * @epic T14106
+ */
+import { z } from 'zod';
+/** What modernize does with one file. */
+export declare const DOCS_MODERNIZE_DISPOSITIONS: readonly ["keep", "rename", "merge-into", "delete"];
+/**
+ * One of {@link DOCS_MODERNIZE_DISPOSITIONS}.
+ *
+ * - `keep` — the file already sits at its canonical path; it is ingested as is.
+ * - `rename` — the file moves to `<kind folder>/<slug>.md` and is ingested there.
+ * - `merge-into` — the file duplicates another; its content folds into the
+ *   survivor named by `target`, and the file is superseded and removed.
+ * - `delete` — the file carries nothing worth keeping (empty, or byte-identical
+ *   to the survivor); it is superseded by `target` when one exists and removed.
+ */
+export type DocsModernizeDisposition = (typeof DOCS_MODERNIZE_DISPOSITIONS)[number];
+/** Where an acted-on answer came from. */
+export type DocsModernizeJudgmentSource = 'provider' | 'cache' | 'fallback';
+/** The two System One questions modernize asks. */
+export type DocsModernizeJudgmentQuestion = 'classify' | 'merge';
+/**
+ * One judgment taken for a plan row: the rule answer, the System One answer
+ * when one was asked, and which of the two acted.
+ */
+export interface DocsModernizeJudgment {
+    /** Which question was judged. */
+    readonly question: DocsModernizeJudgmentQuestion;
+    /** Decision-site id the question was asked through (`docs.modernize.*`). */
+    readonly site: string;
+    /** Effective site mode (`off`, `shadow` or `on`). */
+    readonly mode: 'off' | 'shadow' | 'on';
+    /** The rule fallback's answer. */
+    readonly ruleAnswer: string;
+    /** The System One answer, or null when none came back (off, unreachable, invalid). */
+    readonly decidedAnswer: string | null;
+    /** Confidence of the System One answer, or null when none came back. */
+    readonly decidedConfidence: number | null;
+    /** Where the decided answer came from; `fallback` when the rule answered. */
+    readonly source: DocsModernizeJudgmentSource;
+    /** The answer the plan acts on. */
+    readonly acted: string;
+}
+/** One file's proposal. */
+export interface DocsModernizePlanRow {
+    /** Path relative to the modernize root, POSIX separators. */
+    readonly path: string;
+    /** SHA-256 of the file bytes, hex. */
+    readonly sha256: string;
+    /** Taxonomy kind (a `DocKindRegistry` kind). */
+    readonly kind: string;
+    /** Stable slug: no task, session or date tokens. */
+    readonly slug: string;
+    /** Human title (first H1, else derived from the slug). */
+    readonly title: string;
+    /** What happens to the file. */
+    readonly disposition: DocsModernizeDisposition;
+    /**
+     * For `keep` / `rename`: the canonical path relative to the root.
+     * For `merge-into` / `delete`: the survivor's slug, or null when there is none.
+     */
+    readonly target: string | null;
+    /** Why, one line each. */
+    readonly reasons: readonly string[];
+    /** Every System One question asked for this row. */
+    readonly judgments: readonly DocsModernizeJudgment[];
+    /** Task (`T####`) and decision (`D####`) ids the old path named; kept as links, not in the slug. */
+    readonly ownerTasks: readonly string[];
+    /** The kind's folder the file belongs in (`''` for the root). */
+    readonly category: string;
+    /** Tracked files outside the root that cite the old path (listed, never rewritten). */
+    readonly refs: readonly string[];
+    /** True when the row came from an override file rather than the rules. */
+    readonly overridden: boolean;
+    /** Code paths this doc documents (from the override; written to front matter by the caller). */
+    readonly covers: readonly string[];
+    /** True when the old name broke the slug rule (task, session or date tokens) and the new one does not. */
+    readonly baselineRemove: boolean;
+}
+/** One reviewer decision for a path; it wins over the rules and System One. */
+export interface DocsModernizeOverride {
+    /** What happens to the file. */
+    readonly disposition: DocsModernizeDisposition;
+    /** Canonical path (`keep`/`rename`) or survivor slug (`merge-into`/`delete`). */
+    readonly target?: string;
+    /** Why; recorded on the plan row. */
+    readonly reason: string;
+    /** Kind to use instead of the classified one. */
+    readonly kind?: string;
+    /** Slug to use instead of the derived one. */
+    readonly slug?: string;
+    /** Code paths this doc documents, copied onto the plan row. */
+    readonly covers?: readonly string[];
+}
+/** `--overrides <file>`: decisions keyed by path relative to the modernize root. */
+export type DocsModernizeOverrides = Readonly<Record<string, DocsModernizeOverride>>;
+/** A dry-run proposal for a whole tree. */
+export interface DocsModernizePlan {
+    /** Absolute modernize root. */
+    readonly root: string;
+    /** ISO 8601 time the plan was made. */
+    readonly generatedAt: string;
+    /** One row per scanned file, sorted by path. */
+    readonly rows: readonly DocsModernizePlanRow[];
+    /** Files counted per disposition. */
+    readonly counts: Readonly<Record<DocsModernizeDisposition, number>>;
+    /**
+     * `tree` reorganises the folder; `store-only` ingests every file into the
+     * store (task-owned, slugless) and leaves the folder untouched; `store`
+     * re-kinds and re-slugs the rows already in the store (`storeRows`, T14118).
+     */
+    readonly mode: 'tree' | 'store-only' | 'store';
+    /** Store-mode rows (`mode: 'store'`); absent or empty otherwise. */
+    readonly storeRows?: readonly DocsModernizeStoreRow[];
+    /**
+     * The only edits `--apply` makes to `keep` files (`tree` mode, T14185): one
+     * row per relative link whose target moves. Absent or empty means kept
+     * files are not touched.
+     */
+    readonly linkFixes?: readonly DocsModernizeLinkFix[];
+}
+/**
+ * One href re-pointed inside a `keep` file because its target moves
+ * (T14185). Only the href changes; the rest of the file stays byte-identical.
+ */
+export interface DocsModernizeLinkFix {
+    /** Always `link-fix`. */
+    readonly kind: 'link-fix';
+    /** The kept file, relative to the root. */
+    readonly path: string;
+    /** The href as written now. */
+    readonly href: string;
+    /** The href after the move. */
+    readonly newHref: string;
+}
+/**
+ * One existing store doc in a `--store` plan (T14118): its kind and slug now,
+ * and what modernize proposes. An unchanged field repeats the current value.
+ */
+export interface DocsModernizeStoreRow {
+    /** Attachment row id. */
+    readonly attachmentId: string;
+    /** Content hash. */
+    readonly sha256: string;
+    /** Current slug (null for a slugless row). */
+    readonly slug: string | null;
+    /** Proposed slug; the current one stays resolvable as an alias. */
+    readonly newSlug: string | null;
+    /** Current kind (null when untyped). */
+    readonly kind: string | null;
+    /** Proposed kind. */
+    readonly newKind: string;
+    /** Task ids the old slug named; linked to the doc as task refs. */
+    readonly ownerTasks: readonly string[];
+    /** Why, one line each. */
+    readonly reasons: readonly string[];
+    /** Every System One question asked for this row. */
+    readonly judgments: readonly DocsModernizeJudgment[];
+}
+/** The reversible steps an apply run takes. */
+export declare const DOCS_MODERNIZE_OPS: readonly ["ingest", "merge", "fold", "supersede", "write-file", "remove-file", "link", "rekind", "reslug", "link-task"];
+/** One of {@link DOCS_MODERNIZE_OPS}. */
+export type DocsModernizeOpKind = (typeof DOCS_MODERNIZE_OPS)[number];
+/**
+ * Write-ahead state of a receipt op: written `pending` before the step acts,
+ * `done` after it, `reversed` once a rollback has undone it.
+ */
+export type DocsModernizeOpState = 'pending' | 'done' | 'reversed';
+/** Store values a step replaced, so a rollback restores them exactly. */
+export interface DocsModernizeOpPrior {
+    /** `supersede`: the older row's lifecycle status before the step. */
+    readonly lifecycleStatus?: string | null;
+    /** `supersede`: the older row's `superseded_by` before the step. */
+    readonly supersededBy?: string | null;
+    /** `supersede`: the newer row's `supersedes` before the step. */
+    readonly supersedes?: string | null;
+    /** `merge`: the row that held the slug before the update. */
+    readonly previousAttachmentId?: string | null;
+    /** `merge`: the row the update moved the slug to. */
+    readonly newAttachmentId?: string | null;
+    /** `link`: the slug's `links-to` targets before the step. */
+    readonly linkTargets?: readonly string[];
+    /** `rekind`: the row's kind before the step. */
+    readonly kind?: string | null;
+}
+/**
+ * One step with the state it replaced.
+ *
+ * - `ingest` — a doc stored under `slug` (or slugless) for `ownerId`; `attachmentId` is the row.
+ * - `merge` — the stored doc `slug` was updated with merged content; `prior` names both rows.
+ * - `fold` — the file `path` was folded into the survivor `target` (content went there).
+ * - `supersede` — `slug` was superseded by `target`; `prior` holds the replaced pointers.
+ * - `write-file` — `path` was written; `beforeSha256` is the old bytes, or null when it was new.
+ * - `remove-file` — `path` was removed; `beforeSha256` names the bytes kept for rollback.
+ * - `link` — the `links-to` edges leaving `slug` were set; `prior.linkTargets` holds the old set.
+ * - `rekind` — the row `attachmentId` changed kind; `prior.kind` holds the old one (T14118).
+ * - `reslug` — `slug` was renamed to `target`; `slug` stays an alias (T14118).
+ * - `link-task` — the row `attachmentId` gained a ref to task `ownerId` (T14118).
+ */
+export interface DocsModernizeReceiptOp {
+    /** Step kind. */
+    readonly op: DocsModernizeOpKind;
+    /** Write-ahead state. */
+    readonly state: DocsModernizeOpState;
+    /** Doc slug the step touched, when any. */
+    readonly slug: string | null;
+    /** File path relative to the root, when any. */
+    readonly path: string | null;
+    /** The other end: survivor slug for `supersede` and `fold`. */
+    readonly target: string | null;
+    /** Attachment row created or touched by the step, when any. */
+    readonly attachmentId: string | null;
+    /** Owner the `ingest` ref was made for (`T####` or the project sentinel); rollback drops that ref. */
+    readonly ownerId: string | null;
+    /** Content the step replaced or removed, when any. */
+    readonly beforeSha256: string | null;
+    /** Content the step wrote, when any. */
+    readonly afterSha256: string | null;
+    /** Store values the step replaced. */
+    readonly prior?: DocsModernizeOpPrior;
+}
+/** The record of one apply run; the input to rollback. */
+export interface DocsModernizeReceipt {
+    /** Run id (`dm-<timestamp>`); names the receipt file. */
+    readonly runId: string;
+    /** Absolute modernize root. */
+    readonly root: string;
+    /** ISO 8601 time the run started. */
+    readonly appliedAt: string;
+    /** SHA-256 of the canonical JSON of the plan that was applied. */
+    readonly planSha256: string;
+    /** Steps in the order they ran. */
+    readonly ops: readonly DocsModernizeReceiptOp[];
+    /** Wikilink edges in the graph after the run. */
+    readonly edgeCount: number;
+    /** Every scanned file whose bytes were hash-verified in the blob store, before any removal. */
+    readonly blobs: readonly {
+        readonly path: string;
+        readonly sha256: string;
+    }[];
+    /** Files moved, relative to the root (stage exactly these). */
+    readonly moves: readonly {
+        readonly from: string;
+        readonly to: string;
+    }[];
+    /** Files removed, relative to the root. */
+    readonly deleted: readonly string[];
+    /** ISO 8601 time the run was rolled back, or null. */
+    readonly rolledBackAt: string | null;
+    /** Wall time of the apply, in ms (store mode). */
+    readonly durationMs?: number;
+}
+/** Shape check for a {@link DocsModernizePlan} read from a `--plan` file. */
+export declare const docsModernizePlanSchema: z.ZodObject<{
+    root: z.ZodString;
+    generatedAt: z.ZodString;
+    mode: z.ZodEnum<{
+        tree: "tree";
+        "store-only": "store-only";
+    }>;
+    counts: z.ZodRecord<z.ZodEnum<{
+        keep: "keep";
+        delete: "delete";
+        rename: "rename";
+        "merge-into": "merge-into";
+    }>, z.ZodNumber>;
+    rows: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        kind: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        disposition: z.ZodEnum<{
+            keep: "keep";
+            delete: "delete";
+            rename: "rename";
+            "merge-into": "merge-into";
+        }>;
+        target: z.ZodNullable<z.ZodString>;
+        reasons: z.ZodArray<z.ZodString>;
+        judgments: z.ZodArray<z.ZodObject<{
+            question: z.ZodEnum<{
+                merge: "merge";
+                classify: "classify";
+            }>;
+            site: z.ZodString;
+            mode: z.ZodEnum<{
+                off: "off";
+                shadow: "shadow";
+                on: "on";
+            }>;
+            ruleAnswer: z.ZodString;
+            decidedAnswer: z.ZodNullable<z.ZodString>;
+            decidedConfidence: z.ZodNullable<z.ZodNumber>;
+            source: z.ZodEnum<{
+                cache: "cache";
+                fallback: "fallback";
+                provider: "provider";
+            }>;
+            acted: z.ZodString;
+        }, z.core.$strip>>;
+        ownerTasks: z.ZodArray<z.ZodString>;
+        category: z.ZodString;
+        refs: z.ZodArray<z.ZodString>;
+        overridden: z.ZodBoolean;
+        covers: z.ZodArray<z.ZodString>;
+        baselineRemove: z.ZodBoolean;
+    }, z.core.$strip>>;
+    linkFixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"link-fix">;
+        path: z.ZodString;
+        href: z.ZodString;
+        newHref: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Shape check for an `--overrides` file ({@link DocsModernizeOverrides}). */
+export declare const docsModernizeOverridesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    disposition: z.ZodEnum<{
+        keep: "keep";
+        delete: "delete";
+        rename: "rename";
+        "merge-into": "merge-into";
+    }>;
+    target: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    covers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+/** Shape check for one line of a run's write-ahead journal (`<runId>.ops.jsonl`). */
+export declare const docsModernizeJournalLineSchema: z.ZodObject<{
+    op: z.ZodEnum<{
+        link: "link";
+        merge: "merge";
+        ingest: "ingest";
+        fold: "fold";
+        supersede: "supersede";
+        "write-file": "write-file";
+        "remove-file": "remove-file";
+        rekind: "rekind";
+        reslug: "reslug";
+        "link-task": "link-task";
+    }>;
+    state: z.ZodEnum<{
+        pending: "pending";
+        done: "done";
+        reversed: "reversed";
+    }>;
+    slug: z.ZodNullable<z.ZodString>;
+    path: z.ZodNullable<z.ZodString>;
+    target: z.ZodNullable<z.ZodString>;
+    attachmentId: z.ZodNullable<z.ZodString>;
+    ownerId: z.ZodNullable<z.ZodString>;
+    beforeSha256: z.ZodNullable<z.ZodString>;
+    afterSha256: z.ZodNullable<z.ZodString>;
+    prior: z.ZodOptional<z.ZodObject<{
+        lifecycleStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        supersededBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        previousAttachmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        newAttachmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        linkTargets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    i: z.ZodNumber;
+}, z.core.$strip>;
+/** Shape check for a {@link DocsModernizeReceipt} read back for rollback. */
+export declare const docsModernizeReceiptSchema: z.ZodObject<{
+    runId: z.ZodString;
+    root: z.ZodString;
+    appliedAt: z.ZodString;
+    planSha256: z.ZodString;
+    edgeCount: z.ZodNumber;
+    rolledBackAt: z.ZodNullable<z.ZodString>;
+    blobs: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strip>>;
+    moves: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>;
+    deleted: z.ZodArray<z.ZodString>;
+    ops: z.ZodArray<z.ZodObject<{
+        op: z.ZodEnum<{
+            link: "link";
+            merge: "merge";
+            ingest: "ingest";
+            fold: "fold";
+            supersede: "supersede";
+            "write-file": "write-file";
+            "remove-file": "remove-file";
+            rekind: "rekind";
+            reslug: "reslug";
+            "link-task": "link-task";
+        }>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            done: "done";
+            reversed: "reversed";
+        }>;
+        slug: z.ZodNullable<z.ZodString>;
+        path: z.ZodNullable<z.ZodString>;
+        target: z.ZodNullable<z.ZodString>;
+        attachmentId: z.ZodNullable<z.ZodString>;
+        ownerId: z.ZodNullable<z.ZodString>;
+        beforeSha256: z.ZodNullable<z.ZodString>;
+        afterSha256: z.ZodNullable<z.ZodString>;
+        prior: z.ZodOptional<z.ZodObject<{
+            lifecycleStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            supersededBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            previousAttachmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            newAttachmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            linkTargets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=modernize.d.ts.map

package/dist/docs/modernize.d.ts.map

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

package/dist/docs/modernize.js

@@ -0,0 +1,137 @@
+/**
+ * Docs modernize contract — the plan and receipt of `cleo docs modernize`.
+ *
+ * `cleo docs modernize <path>` turns a messy docs folder into clean, linked
+ * CleoDocs. A dry run produces a {@link DocsModernizePlan}: one
+ * {@link DocsModernizePlanRow} per markdown or text file, carrying the kind,
+ * the stable slug, the disposition and the reasons (including every System
+ * One judgment that was asked). `--apply` executes a plan and writes a
+ * {@link DocsModernizeReceipt}; every receipt op records the state it
+ * replaced, so `--rollback <runId>` can reverse the run.
+ *
+ * Types only — the planner and applier live in
+ * `packages/core/src/docs/modernize/`.
+ *
+ * @task T14113
+ * @epic T14106
+ */
+import { z } from 'zod';
+/** What modernize does with one file. */
+export const DOCS_MODERNIZE_DISPOSITIONS = ['keep', 'rename', 'merge-into', 'delete'];
+/** The reversible steps an apply run takes. */
+export const DOCS_MODERNIZE_OPS = [
+    'ingest',
+    'merge',
+    'fold',
+    'supersede',
+    'write-file',
+    'remove-file',
+    'link',
+    'rekind',
+    'reslug',
+    'link-task',
+];
+// ─── Schemas (a plan or receipt read from disk is untrusted input) ───────────
+const judgmentSchema = z.object({
+    question: z.enum(['classify', 'merge']),
+    site: z.string(),
+    mode: z.enum(['off', 'shadow', 'on']),
+    ruleAnswer: z.string(),
+    decidedAnswer: z.string().nullable(),
+    decidedConfidence: z.number().nullable(),
+    source: z.enum(['provider', 'cache', 'fallback']),
+    acted: z.string(),
+});
+const relPath = z.string().min(1).max(1024);
+/** Shape check for a {@link DocsModernizePlan} read from a `--plan` file. */
+export const docsModernizePlanSchema = z.object({
+    root: z.string().min(1),
+    generatedAt: z.string(),
+    mode: z.enum(['tree', 'store-only']),
+    counts: z.record(z.enum(DOCS_MODERNIZE_DISPOSITIONS), z.number()),
+    rows: z.array(z.object({
+        path: relPath,
+        sha256: z.string().regex(/^[0-9a-f]{64}$/),
+        kind: z.string().min(1),
+        slug: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
+        title: z.string(),
+        disposition: z.enum(DOCS_MODERNIZE_DISPOSITIONS),
+        target: z.string().min(1).max(1024).nullable(),
+        reasons: z.array(z.string()),
+        judgments: z.array(judgmentSchema),
+        ownerTasks: z.array(z.string().regex(/^[TD]\d+$/)),
+        category: z.string(),
+        refs: z.array(z.string()),
+        overridden: z.boolean(),
+        covers: z.array(z.string()),
+        baselineRemove: z.boolean(),
+    })),
+    linkFixes: z
+        .array(z.object({
+        kind: z.literal('link-fix'),
+        path: relPath,
+        href: z.string().min(1).max(2048),
+        newHref: z.string().min(1).max(2048),
+    }))
+        .optional(),
+});
+/** Shape check for an `--overrides` file ({@link DocsModernizeOverrides}). */
+export const docsModernizeOverridesSchema = z.record(relPath, z.object({
+    disposition: z.enum(DOCS_MODERNIZE_DISPOSITIONS),
+    target: z.string().min(1).max(1024).optional(),
+    reason: z.string().min(1),
+    kind: z.string().min(1).optional(),
+    slug: z
+        .string()
+        .regex(/^[a-z0-9][a-z0-9-]*$/)
+        .optional(),
+    covers: z.array(z.string()).optional(),
+}));
+/** Shape check for one receipt op. */
+const receiptOpSchema = z.object({
+    op: z.enum(DOCS_MODERNIZE_OPS),
+    state: z.enum(['pending', 'done', 'reversed']),
+    slug: z.string().nullable(),
+    path: relPath.nullable(),
+    target: z.string().nullable(),
+    attachmentId: z.string().nullable(),
+    ownerId: z.string().nullable(),
+    beforeSha256: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/)
+        .nullable(),
+    afterSha256: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/)
+        .nullable(),
+    prior: z
+        .object({
+        lifecycleStatus: z.string().nullable().optional(),
+        supersededBy: z.string().nullable().optional(),
+        supersedes: z.string().nullable().optional(),
+        previousAttachmentId: z.string().nullable().optional(),
+        newAttachmentId: z.string().nullable().optional(),
+        linkTargets: z.array(z.string()).optional(),
+        kind: z.string().nullable().optional(),
+    })
+        .optional(),
+});
+/** Shape check for one line of a run's write-ahead journal (`<runId>.ops.jsonl`). */
+export const docsModernizeJournalLineSchema = receiptOpSchema.extend({
+    i: z.number().int().min(0),
+});
+/** Shape check for a {@link DocsModernizeReceipt} read back for rollback. */
+export const docsModernizeReceiptSchema = z.object({
+    runId: z.string().regex(/^dm-[\w-]+$/),
+    root: z.string().min(1),
+    appliedAt: z.string(),
+    planSha256: z.string(),
+    edgeCount: z.number(),
+    rolledBackAt: z.string().nullable(),
+    blobs: z.array(z.object({ path: relPath, sha256: z.string() })),
+    moves: z.array(z.object({ from: relPath, to: relPath })),
+    deleted: z.array(relPath),
+    ops: z.array(receiptOpSchema),
+    durationMs: z.number().optional(),
+});
+//# sourceMappingURL=modernize.js.map

package/dist/docs/modernize.js.map

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

package/dist/docs-taxonomy.d.ts

@@ -104,6 +104,12 @@ export interface DocKindMetadata {
      * @epic T10157
      */
     readonly requiredSections?: ReadonlyArray<string>;
+    /**
+     * When `true`, docs of this kind live only in the CLEO doc store and are
+     * never published to a repository mirror (T14107, D11210: session
+     * handoffs are exactly the rot published docs must not carry).
+     */
+    readonly storeOnly?: boolean;
 }
 /**
  * Canonical list of built-in document kinds.

package/dist/docs-taxonomy.d.ts.map

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