@cleocode/core 2026.10.27 → 2026.11.1-canary.3

package/dist/docs/modernize/plan.js

@@ -0,0 +1,510 @@
+/**
+ * `cleo docs modernize <path> --dry-run` — propose, per file, a kind, a
+ * stable slug and a disposition (T14113).
+ *
+ * Steps:
+ *
+ * 1. Scan `.md` / `.txt` files under the root (the `docs import` scanner),
+ *    skipping build, generated and image folders.
+ * 2. Classify each file by rules (front matter, folder, filename, headings);
+ *    a rule below {@link MODERNIZE_CLASSIFY_FLOOR} is judged by System One
+ *    (`docs.modernize.classify`).
+ * 3. Derive the stable slug: no task, session or date tokens.
+ * 4. Group files by slug. Byte-identical members are deleted in favour of the
+ *    survivor; other members merge when their line similarity is high, stay
+ *    apart (with a numbered slug) when it is low, and are judged by System
+ *    One (`docs.modernize.merge`) in between.
+ * 5. Survivors keep or move to `<kind folder>/<slug><ext>`.
+ *
+ * Read-only: nothing is written except the decision-audit line each System
+ * One question gets. The plan is the input to `applyDocsModernize`.
+ *
+ * @task T14113
+ * @epic T14106
+ */
+import { execFileSync } from 'node:child_process';
+import { extname, relative, sep } from 'node:path';
+import { DocKindRegistry } from '@cleocode/contracts/docs-taxonomy.js';
+import { createAttachmentStore } from '../../store/attachment-store.js';
+import { docNameViolation } from '../doc-name-rule.js';
+import { DEFAULT_EXCLUDE_DIRS, scanDirectory } from '../import/scanner.js';
+import { judgeDocKind, judgeDocMerge, resolveModernizeJudgeSettings } from './judge.js';
+import { classifyDocByRules, docSimilarity, finalPaths, folderKind, MODERNIZE_CLASSIFY_FLOOR, MODERNIZE_MERGE_APART, MODERNIZE_MERGE_SURE, markdownLinkFixes, readTitle, stableSlugFor, versionOf, } from './rules.js';
+/** Folders modernize never descends into, beyond the scanner's defaults. */
+export const MODERNIZE_EXCLUDE_DIRS = new Set([
+    ...DEFAULT_EXCLUDE_DIRS,
+    'generated',
+    'images',
+    'assets',
+]);
+/** File extensions modernize reads. */
+export const MODERNIZE_EXTENSIONS = ['.md', '.txt'];
+/**
+ * Task and decision ids an old path names (`T1234`, `D11180`), upper-cased,
+ * in order of appearance.
+ *
+ * @param relPath - Path relative to the root.
+ * @returns Unique ids.
+ */
+export function ownerIdsFromPath(relPath) {
+    const ids = new Set();
+    for (const m of relPath.matchAll(/(?:^|[^a-z0-9])([td]\d{3,})(?=[^0-9]|$)/gi)) {
+        if (m[1])
+            ids.add(m[1].toUpperCase());
+    }
+    return [...ids];
+}
+/**
+ * Tracked files outside `root` that cite any of `paths` (one `git grep`).
+ *
+ * @param repoRoot - Repository root.
+ * @param root - Absolute modernize root.
+ * @param paths - Root-relative paths to look for.
+ * @returns Root-relative path → citing repo-relative files.
+ */
+function findRefs(repoRoot, root, paths) {
+    const out = new Map();
+    if (paths.length === 0)
+        return out;
+    const prefix = relative(repoRoot, root).split(sep).join('/');
+    if (prefix.startsWith('..'))
+        return out;
+    const needles = paths.map((p) => (prefix ? `${prefix}/${p}` : p));
+    const byNeedle = new Map(needles.map((n, i) => [n, paths[i] ?? n]));
+    let stdout = '';
+    try {
+        stdout = execFileSync('git', [
+            'grep',
+            '-o',
+            '-F',
+            '-I',
+            ...needles.flatMap((n) => ['-e', n]),
+            '--',
+            '.',
+            ...(prefix ? [`:!${prefix}/**`] : []),
+        ], {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+            maxBuffer: 64 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+    }
+    catch {
+        return out; // exit 1 = no match; not a repo = nothing to report
+    }
+    for (const line of stdout.split('\n')) {
+        const at = line.indexOf(':');
+        if (at <= 0)
+            continue;
+        const file = line.slice(0, at);
+        const path = byNeedle.get(line.slice(at + 1));
+        if (!path)
+            continue;
+        const list = out.get(path) ?? [];
+        if (!list.includes(file))
+            list.push(file);
+        out.set(path, list);
+    }
+    return out;
+}
+/** The folder, relative to the root, that a kind's docs live in. */
+export function kindFolder(kind, kinds) {
+    const publishDir = kinds.find((k) => k.kind === kind)?.publishDir ?? kind;
+    if (publishDir === '.' || publishDir === '')
+        return '';
+    return publishDir.split('/').filter(Boolean).pop() ?? kind;
+}
+/** The canonical path of a survivor, relative to the root. */
+function canonicalPath(relPath, kind, slug, kinds) {
+    const folder = kindFolder(kind, kinds);
+    const ext = extname(relPath).toLowerCase() === '.txt' ? '.txt' : '.md';
+    return folder ? `${folder}/${slug}${ext}` : `${slug}${ext}`;
+}
+/**
+ * Order survivors first: highest claimed version, then a file already at its
+ * canonical path, then the most content, then path order.
+ */
+function survivorOrder(kinds) {
+    const settled = (c) => canonicalPath(c.file.relPath, c.kind, c.slug, kinds) === c.file.relPath ? 1 : 0;
+    return (a, b) => versionOf(b.file.relPath) - versionOf(a.file.relPath) ||
+        settled(b) - settled(a) ||
+        b.file.content.length - a.file.content.length ||
+        a.file.relPath.localeCompare(b.file.relPath);
+}
+/** Classify one file, asking System One when the rule is unsure. */
+async function classify(file, kinds, settings, forced) {
+    const rule = forced.kind
+        ? { kind: forced.kind, confidence: 1, reason: 'kind given by the caller' }
+        : classifyDocByRules(file.relPath, file.content, kinds);
+    const reasons = [`kind ${rule.kind}: ${rule.reason}`];
+    const judgments = [];
+    let kind = rule.kind;
+    const title = readTitle(file.content) ?? '';
+    if (rule.confidence < MODERNIZE_CLASSIFY_FLOOR && !forced.overridden) {
+        const judgment = await judgeDocKind({
+            path: file.relPath,
+            title,
+            content: file.content,
+            ruleKind: rule.kind,
+            ruleConfidence: rule.confidence,
+            kinds,
+        }, settings);
+        judgments.push(judgment);
+        kind = judgment.acted;
+        if (kind !== rule.kind)
+            reasons.push(`kind ${kind}: System One overrode the rule`);
+    }
+    const slug = stableSlugFor(file.relPath, file.content, kind);
+    if (slug !==
+        file.relPath
+            .split('/')
+            .pop()
+            ?.replace(/\.[^.]+$/, '')) {
+        reasons.push(`slug ${slug}: task, session and date tokens dropped from the name`);
+    }
+    return { file, kind, slug, title: title || slug, reasons, judgments };
+}
+/**
+ * Whether two files live in the same home: the same folder, or folders that
+ * name the same kind under one parent (`docs/specs` and `docs/spec`).
+ */
+function sameHome(a, b, kinds) {
+    const dirA = a.split('/').slice(0, -1);
+    const dirB = b.split('/').slice(0, -1);
+    if (dirA.join('/') === dirB.join('/'))
+        return true;
+    if (dirA.slice(0, -1).join('/') !== dirB.slice(0, -1).join('/'))
+        return false;
+    const kindA = folderKind(dirA.at(-1) ?? '', kinds);
+    return kindA !== null && kindA === folderKind(dirB.at(-1) ?? '', kinds);
+}
+/** Next free numbered slug (`<slug>-2`, `-3` …). */
+function numberedSlug(slug, taken) {
+    let n = 2;
+    while (taken.has(`${slug}-${n}`))
+        n += 1;
+    return `${slug}-${n}`;
+}
+/**
+ * Plan a modernize run over `options.root`.
+ *
+ * @param options - Root, project root and System One overrides.
+ * @returns The plan: one row per scanned file, sorted by path.
+ */
+export async function planDocsModernize(options) {
+    const kinds = DocKindRegistry.load(options.projectRoot).list();
+    const settings = await resolveModernizeJudgeSettings(options.projectRoot, options.decide, options.mode);
+    const files = await scanDirectory({
+        root: options.root,
+        extensions: MODERNIZE_EXTENSIONS,
+        excludeDirs: new Set([...MODERNIZE_EXCLUDE_DIRS, ...(options.exclude ?? [])]),
+    });
+    const candidates = [];
+    const overrides = options.overrides ?? {};
+    for (const file of files) {
+        const override = overrides[file.relPath];
+        candidates.push(await classify(file, kinds, settings, {
+            kind: override?.kind ?? options.kind,
+            overridden: override !== undefined,
+        }));
+    }
+    if (options.storeOnly)
+        return finishPlan(options, kinds, candidates.map(storeOnlyRow), files);
+    const groups = new Map();
+    for (const c of candidates) {
+        const group = groups.get(c.slug) ?? [];
+        group.push(c);
+        groups.set(c.slug, group);
+    }
+    const taken = new Set(groups.keys());
+    const rows = [];
+    const survivorRow = (c, slug) => {
+        const target = canonicalPath(c.file.relPath, c.kind, slug, kinds);
+        const disposition = target === c.file.relPath ? 'keep' : 'rename';
+        return {
+            path: c.file.relPath,
+            sha256: c.file.contentSha,
+            kind: c.kind,
+            slug,
+            title: c.title,
+            disposition,
+            target,
+            reasons: disposition === 'rename' ? [...c.reasons, `moves to ${target}`] : c.reasons,
+            judgments: c.judgments,
+        };
+    };
+    for (const [slug, group] of groups) {
+        const [survivor, ...rest] = [...group].sort(survivorOrder(kinds));
+        if (!survivor)
+            continue;
+        rows.push(survivorRow(survivor, slug));
+        for (const other of rest) {
+            const reasons = [...other.reasons];
+            const judgments = [...other.judgments];
+            const reviewed = overrides[other.file.relPath] ?? overrides[survivor.file.relPath];
+            const home = sameHome(survivor.file.relPath, other.file.relPath, kinds);
+            if (other.file.contentSha === survivor.file.contentSha && home) {
+                rows.push({
+                    path: other.file.relPath,
+                    sha256: other.file.contentSha,
+                    kind: survivor.kind,
+                    slug,
+                    title: other.title,
+                    disposition: 'delete',
+                    target: slug,
+                    reasons: [...reasons, `byte-identical to ${survivor.file.relPath}`],
+                    judgments,
+                });
+                continue;
+            }
+            const similarity = docSimilarity(survivor.file.content, other.file.content);
+            const pct = Math.round(similarity * 100);
+            let verdict = home && similarity >= MODERNIZE_MERGE_SURE ? 'merge' : 'separate';
+            // Different homes (two packages' api-design.md) never merge by rule:
+            // System One or an override decides, and the rule says keep apart.
+            const ambiguous = home
+                ? similarity >= MODERNIZE_MERGE_APART && similarity < MODERNIZE_MERGE_SURE
+                : similarity >= MODERNIZE_MERGE_APART;
+            if (ambiguous && !reviewed) {
+                const rule = home && similarity >= (MODERNIZE_MERGE_APART + MODERNIZE_MERGE_SURE) / 2
+                    ? 'merge'
+                    : 'separate';
+                const judgment = await judgeDocMerge({
+                    left: { path: survivor.file.relPath, content: survivor.file.content },
+                    right: { path: other.file.relPath, content: other.file.content },
+                    similarity,
+                    rule,
+                }, settings);
+                judgments.push(judgment);
+                verdict = judgment.acted === 'merge' ? 'merge' : 'separate';
+            }
+            if (verdict === 'merge') {
+                rows.push({
+                    path: other.file.relPath,
+                    sha256: other.file.contentSha,
+                    kind: survivor.kind,
+                    slug,
+                    title: other.title,
+                    disposition: 'merge-into',
+                    target: slug,
+                    reasons: [
+                        ...reasons,
+                        `${pct}% of lines shared with ${survivor.file.relPath}; folds into it`,
+                    ],
+                    judgments,
+                });
+            }
+            else {
+                const own = numberedSlug(slug, taken);
+                taken.add(own);
+                const row = survivorRow({ ...other, judgments }, own);
+                rows.push({
+                    ...row,
+                    reasons: [
+                        ...row.reasons,
+                        `shares the name ${slug} with ${survivor.file.relPath} but only ${pct}% of lines; kept apart as ${own}`,
+                    ],
+                });
+            }
+        }
+    }
+    // Update before create: a survivor whose slug the store already holds
+    // updates that doc when they are alike, and takes a numbered slug when not.
+    const store = createAttachmentStore();
+    const texts = new Map(files.map((f) => [f.relPath, f.content]));
+    for (let i = 0; i < rows.length; i += 1) {
+        const row = rows[i];
+        if (!row || (row.disposition !== 'keep' && row.disposition !== 'rename'))
+            continue;
+        const existing = await store.findBySlug(row.slug, options.projectRoot);
+        if (existing?.metadata.sha256 === row.sha256)
+            continue;
+        const sameBytes = await store.getMetadata(row.sha256, options.projectRoot);
+        if (sameBytes) {
+            const extras = await store.getExtras(sameBytes.id, options.projectRoot);
+            rows[i] = {
+                ...row,
+                reasons: [
+                    ...row.reasons,
+                    `already stored in CleoDocs${extras?.slug ? ` as ${extras.slug}` : ''}; the file moves, the stored doc is left as is`,
+                ],
+            };
+            continue;
+        }
+        if (!existing)
+            continue;
+        const stored = await store.get(existing.metadata.sha256, options.projectRoot);
+        const similarity = stored
+            ? docSimilarity(stored.bytes.toString('utf-8'), texts.get(row.path) ?? '')
+            : 0;
+        const pct = Math.round(similarity * 100);
+        if (similarity >= MODERNIZE_MERGE_APART) {
+            rows[i] = {
+                ...row,
+                reasons: [
+                    ...row.reasons,
+                    `merges into the existing CleoDocs doc ${row.slug} (${pct}% of lines shared; nothing of either is dropped)`,
+                ],
+            };
+            continue;
+        }
+        let own = numberedSlug(row.slug, taken);
+        while ((await store.findBySlug(own, options.projectRoot)) !== null) {
+            taken.add(own);
+            own = numberedSlug(row.slug, taken);
+        }
+        taken.add(own);
+        const moved = canonicalPath(row.path, row.kind, own, kinds);
+        for (let j = 0; j < rows.length; j += 1) {
+            const dup = rows[j];
+            if (dup &&
+                dup.target === row.slug &&
+                (dup.disposition === 'merge-into' || dup.disposition === 'delete')) {
+                rows[j] = { ...dup, slug: own, target: own };
+            }
+        }
+        rows[i] = {
+            ...row,
+            slug: own,
+            target: moved,
+            disposition: moved === row.path ? 'keep' : 'rename',
+            reasons: [
+                ...row.reasons,
+                `the store's ${row.slug} is a different doc (${pct}% of lines shared); stored as ${own}`,
+            ],
+        };
+    }
+    return finishPlan(options, kinds, rows, files);
+}
+/** A store-only row: ingest the file as is, owned by its task, without a slug. */
+function storeOnlyRow(c) {
+    const owner = ownerIdsFromPath(c.file.relPath).find((id) => id.startsWith('T'));
+    return {
+        path: c.file.relPath,
+        sha256: c.file.contentSha,
+        kind: c.kind,
+        slug: c.slug,
+        title: c.title,
+        disposition: 'keep',
+        target: null,
+        reasons: [
+            ...c.reasons,
+            `stored without a slug, owned by ${owner ?? 'the project'}; the file stays where it is`,
+        ],
+        judgments: c.judgments,
+    };
+}
+/** Apply overrides, add links, category and refs, sort and count. */
+function finishPlan(options, kinds, coreRows, files) {
+    const overrides = options.overrides ?? {};
+    const moved = options.storeOnly
+        ? []
+        : coreRows.filter((r) => r.disposition !== 'keep' || overrides[r.path]).map((r) => r.path);
+    const refs = findRefs(options.repoRoot ?? options.projectRoot, options.root, moved);
+    const scanned = new Set(files.map((f) => f.relPath));
+    const rows = coreRows.map((row) => {
+        const override = overrides[row.path];
+        const kind = override?.kind ?? row.kind;
+        const base = {
+            ...row,
+            kind,
+            ownerTasks: ownerIdsFromPath(row.path),
+            category: kindFolder(kind, kinds),
+            refs: refs.get(row.path) ?? [],
+            overridden: override !== undefined,
+            covers: override?.covers ?? [],
+            baselineRemove: false,
+        };
+        const settled = override ? applyOverride(base, override, kinds) : base;
+        return { ...settled, baselineRemove: !options.storeOnly && clearsSlugRule(settled) };
+    });
+    const survivors = new Set(rows.filter((r) => r.disposition === 'keep' || r.disposition === 'rename').map((r) => r.slug));
+    for (const row of rows) {
+        if (!row.overridden)
+            continue;
+        if ((row.disposition === 'merge-into' || row.disposition === 'delete') &&
+            !survivors.has(row.target ?? '')) {
+            // @sync-invariant none:input-shape an override that folds a file into no survivor is refused before any write
+            throw new DocsModernizeOverrideError(`override for ${row.path}: ${row.disposition} must name a survivor's slug (got ${row.target ?? 'none'})`);
+        }
+    }
+    for (const path of Object.keys(overrides)) {
+        if (!scanned.has(path)) {
+            // @sync-invariant none:input-shape an override for a file the scan did not find is refused before any write
+            throw new DocsModernizeOverrideError(`override names ${path}, which is not a scanned file under the root`);
+        }
+    }
+    rows.sort((a, b) => a.path.localeCompare(b.path));
+    const counts = {
+        keep: 0,
+        rename: 0,
+        'merge-into': 0,
+        delete: 0,
+    };
+    for (const row of rows)
+        counts[row.disposition] += 1;
+    // A kept file stays byte-identical except for hrefs whose targets move;
+    // each such edit is a plan row, so --apply never does more than the dry
+    // run showed (T14185).
+    const linkFixes = [];
+    if (!options.storeOnly) {
+        const finalPathOf = finalPaths(rows);
+        const contentOf = new Map(files.map((f) => [f.relPath, f.content]));
+        for (const row of rows) {
+            if (row.disposition !== 'keep')
+                continue;
+            for (const fix of markdownLinkFixes(contentOf.get(row.path) ?? '', row.path, finalPathOf)) {
+                linkFixes.push({ kind: 'link-fix', path: row.path, ...fix });
+            }
+        }
+    }
+    return {
+        root: options.root,
+        generatedAt: (options.now?.() ?? new Date()).toISOString(),
+        rows,
+        counts,
+        mode: options.storeOnly ? 'store-only' : 'tree',
+        ...(linkFixes.length > 0 ? { linkFixes } : {}),
+    };
+}
+/**
+ * Apply one reviewer override to a row. `keep` stays at the file's own path;
+ * `rename` uses the override's target or the canonical path; `merge-into` and
+ * `delete` use the override's target or the row's own survivor slug.
+ */
+function applyOverride(row, override, kinds) {
+    const slug = override.slug ?? row.slug;
+    const wasSurvivor = row.disposition === 'keep' || row.disposition === 'rename';
+    let target;
+    if (override.disposition === 'keep')
+        target = row.path;
+    else if (override.disposition === 'rename') {
+        target =
+            override.target ??
+                (wasSurvivor && !override.slug && !override.kind
+                    ? row.target
+                    : canonicalPath(row.path, row.kind, slug, kinds));
+    }
+    else
+        target = override.target ?? (wasSurvivor ? null : row.target);
+    return {
+        ...row,
+        slug,
+        disposition: override.disposition,
+        target,
+        reasons: [...row.reasons, `override: ${override.reason}`],
+    };
+}
+/** Whether the old name broke the T14107 slug rule and the row's outcome no longer does. */
+function clearsSlugRule(row) {
+    if (row.disposition === 'keep')
+        return false;
+    const base = (row.path.split('/').pop() ?? '').replace(/\.[^.]+$/, '');
+    return docNameViolation(base, row.kind) !== null && docNameViolation(row.slug, row.kind) === null;
+}
+/** Raised when an override names a path the scan did not find. */
+export class DocsModernizeOverrideError extends Error {
+    /** Stable code for the envelope. */
+    code = 'E_MODERNIZE_OVERRIDE';
+}
+//# sourceMappingURL=plan.js.map

package/dist/docs/modernize/plan.js.map

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

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

@@ -0,0 +1,41 @@
+/**
+ * Exact store restores for `cleo docs modernize --rollback` (T14113).
+ *
+ * Apply records the values a step replaced (`DocsModernizeOpPrior`); these
+ * helpers read those values before a step and put them back afterwards, so a
+ * rollback restores the registry rows as they were rather than writing a new
+ * version on top.
+ *
+ * @task T14113
+ * @epic T14106
+ */
+import type { DocsModernizeOpPrior } from '@cleocode/contracts';
+/**
+ * The supersession pointers a `supersedeDoc(old, new)` will replace.
+ *
+ * @param projectRoot - Project root.
+ * @param oldSlug - Doc about to be superseded.
+ * @param newSlug - Doc about to supersede it.
+ * @returns The prior values, or null when either slug is unknown.
+ */
+export declare function readSupersessionPrior(projectRoot: string, oldSlug: string, newSlug: string): Promise<DocsModernizeOpPrior | null>;
+/**
+ * Put back the pointers and status a supersede replaced.
+ *
+ * @param projectRoot - Project root.
+ * @param oldSlug - The superseded doc.
+ * @param newSlug - The superseding doc.
+ * @param prior - Values recorded by {@link readSupersessionPrior}.
+ */
+export declare function restoreSupersession(projectRoot: string, oldSlug: string, newSlug: string, prior: DocsModernizeOpPrior): Promise<void>;
+/**
+ * Undo a `docs update` of `slug`: give the slug back to the row that held it
+ * and drop the refs the update copied onto the new row (the new row is purged
+ * when none remain). The new row must have been created by that update.
+ *
+ * @param projectRoot - Project root.
+ * @param slug - The updated slug.
+ * @param prior - `previousAttachmentId` and `newAttachmentId` from the merge op.
+ */
+export declare function revertDocUpdate(projectRoot: string, slug: string, prior: DocsModernizeOpPrior): Promise<void>;
+//# sourceMappingURL=restore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/docs/modernize/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAehE;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqBf"}