@cleocode/cleo 2026.4.10 → 2026.4.12

package/dist/cli/commands/brain.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI command group: cleo brain
+ *
+ * Subcommands:
+ *   cleo brain maintenance   — run temporal decay + consolidation + embedding backfill
+ *
+ * @task T143
+ * @epic T134
+ * @why Provide a single CLI entry point for brain optimization operations
+ * @what Parent command group with maintenance subcommand and progress reporting
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the `cleo brain` command group.
+ *
+ * Registers a `brain` parent command and a `maintenance` subcommand that
+ * combines temporal decay, memory consolidation, and embedding backfill
+ * into one idempotent pass.
+ *
+ * @param program - The root CLI command to attach to
+ *
+ * @example
+ * ```ts
+ * registerBrainCommand(rootCommand);
+ * // Adds: cleo brain maintenance [--skip-decay] [--skip-consolidation] [--skip-embeddings] [--json]
+ * ```
+ */
+export declare function registerBrainCommand(program: Command): void;
+//# sourceMappingURL=brain.d.ts.map

package/dist/cli/commands/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG3D"}

package/dist/cli/commands/brain.js

@@ -0,0 +1,107 @@
+/**
+ * CLI command group: cleo brain
+ *
+ * Subcommands:
+ *   cleo brain maintenance   — run temporal decay + consolidation + embedding backfill
+ *
+ * @task T143
+ * @epic T134
+ * @why Provide a single CLI entry point for brain optimization operations
+ * @what Parent command group with maintenance subcommand and progress reporting
+ */
+import { getProjectRoot, runBrainMaintenance } from '@cleocode/core/internal';
+/**
+ * Register the `cleo brain` command group.
+ *
+ * Registers a `brain` parent command and a `maintenance` subcommand that
+ * combines temporal decay, memory consolidation, and embedding backfill
+ * into one idempotent pass.
+ *
+ * @param program - The root CLI command to attach to
+ *
+ * @example
+ * ```ts
+ * registerBrainCommand(rootCommand);
+ * // Adds: cleo brain maintenance [--skip-decay] [--skip-consolidation] [--skip-embeddings] [--json]
+ * ```
+ */
+export function registerBrainCommand(program) {
+    const brain = program.command('brain').description('Brain memory optimization operations');
+    brain
+        .command('maintenance')
+        .description('Run brain maintenance: temporal decay, consolidation, and embedding backfill')
+        .option('--skip-decay', 'Skip the temporal decay step (confidence reduction on stale learnings)')
+        .option('--skip-consolidation', 'Skip the memory consolidation step (merging old observations)')
+        .option('--skip-reconciliation', 'Skip the cross-DB orphaned reference reconciliation step')
+        .option('--skip-embeddings', 'Skip the embedding backfill step (vector generation for observations)')
+        .option('--json', 'Output results as JSON')
+        .action(async (opts) => {
+        const root = getProjectRoot();
+        const isJson = !!opts.json;
+        if (!isJson) {
+            console.log('Running brain maintenance...');
+        }
+        try {
+            const result = await runBrainMaintenance(root, {
+                skipDecay: !!opts.skipDecay,
+                skipConsolidation: !!opts.skipConsolidation,
+                skipReconciliation: !!opts.skipReconciliation,
+                skipEmbeddings: !!opts.skipEmbeddings,
+                onProgress: isJson
+                    ? undefined
+                    : (step, current, total) => {
+                        if (step === 'embeddings' && total > 0) {
+                            // Inline progress for embeddings (the only long-running step)
+                            if (process.stdout.isTTY) {
+                                process.stdout.clearLine(0);
+                                process.stdout.cursorTo(0);
+                                process.stdout.write(`  [embeddings] ${current}/${total}...`);
+                            }
+                            else if (current === 1 || current === total) {
+                                console.log(`  [embeddings] ${current}/${total}...`);
+                            }
+                        }
+                        else if (current === 0) {
+                            console.log(`  [${step}] starting...`);
+                        }
+                        else if (current === total && total > 0) {
+                            if (step === 'embeddings' && process.stdout.isTTY) {
+                                process.stdout.write('\n');
+                            }
+                            console.log(`  [${step}] done`);
+                        }
+                    },
+            });
+            if (isJson) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            // Human-readable summary
+            console.log('\nMaintenance complete.');
+            console.log(`  Duration: ${result.duration}ms`);
+            if (!opts.skipDecay) {
+                console.log(`  Decay:         ${result.decay.affected} learning(s) updated`);
+            }
+            if (!opts.skipConsolidation) {
+                console.log(`  Consolidation: ${result.consolidation.merged} merged, ${result.consolidation.removed} archived`);
+            }
+            if (!opts.skipReconciliation) {
+                console.log(`  Reconcile:     ${result.reconciliation.decisionsFixed} decisions, ${result.reconciliation.observationsFixed} observations, ${result.reconciliation.linksRemoved} links`);
+            }
+            if (!opts.skipEmbeddings) {
+                console.log(`  Embeddings:    ${result.embeddings.processed} processed, ${result.embeddings.skipped} skipped, ${result.embeddings.errors} errors`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isJson) {
+                console.log(JSON.stringify({ error: message }));
+            }
+            else {
+                console.error(`Brain maintenance failed: ${message}`);
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=brain.js.map

package/dist/cli/commands/brain.js.map

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

package/dist/cli/commands/briefing.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI briefing command - show composite session-start context.
+ *
+ * Aggregates session-start context from multiple sources:
+ * - Last session handoff
+ * - Current focus
+ * - Top-N next tasks
+ * - Open bugs
+ * - Blocked tasks
+ * - Active epics
+ * - Pipeline stage
+ *
+ * @task T4916
+ * @epic T4914
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the briefing command.
+ * @task T4916
+ */
+export declare function registerBriefingCommand(program: Command): void;
+//# sourceMappingURL=briefing.d.ts.map

package/dist/cli/commands/briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgC9D"}

package/dist/cli/commands/briefing.js

@@ -0,0 +1,45 @@
+/**
+ * CLI briefing command - show composite session-start context.
+ *
+ * Aggregates session-start context from multiple sources:
+ * - Last session handoff
+ * - Current focus
+ * - Top-N next tasks
+ * - Open bugs
+ * - Blocked tasks
+ * - Active epics
+ * - Pipeline stage
+ *
+ * @task T4916
+ * @epic T4914
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the briefing command.
+ * @task T4916
+ */
+export function registerBriefingCommand(program) {
+    program
+        .command('briefing')
+        .description('Show composite session-start context (handoff, focus, next tasks, bugs, blockers, epics)')
+        .option('-s, --scope <scope>', 'Scope filter (global or epic:T###)')
+        .option('--max-next <n>', 'Maximum next tasks to show', '5')
+        .option('--max-bugs <n>', 'Maximum bugs to show', '10')
+        .option('--max-blocked <n>', 'Maximum blocked tasks to show', '10')
+        .option('--max-epics <n>', 'Maximum active epics to show', '5')
+        .action(async (opts) => {
+        const scope = opts['scope'];
+        const maxNextTasks = parseInt(opts['maxNext'], 10);
+        const maxBugs = parseInt(opts['maxBugs'], 10);
+        const maxBlocked = parseInt(opts['maxBlocked'], 10);
+        const maxEpics = parseInt(opts['maxEpics'], 10);
+        await dispatchFromCli('query', 'session', 'briefing.show', {
+            scope,
+            maxNextTasks,
+            maxBugs,
+            maxBlocked,
+            maxEpics,
+        }, { command: 'briefing' });
+    });
+}
+//# sourceMappingURL=briefing.js.map

package/dist/cli/commands/briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../../../src/cli/commands/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,0FAA0F,CAC3F;SACA,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;SACnE,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,EAAE,GAAG,CAAC;SAC3D,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,IAAI,CAAC;SACtD,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,EAAE,IAAI,CAAC;SAClE,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,EAAE,GAAG,CAAC;SAC9D,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAuB,CAAC;QAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAW,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAW,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAW,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAW,EAAE,EAAE,CAAC,CAAC;QAE1D,MAAM,eAAe,CACnB,OAAO,EACP,SAAS,EACT,eAAe,EACf;YACE,KAAK;YACL,YAAY;YACZ,OAAO;YACP,UAAU;YACV,QAAQ;SACT,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/bug.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI bug command - shorthand for creating bug report tasks.
+ * @task T4913
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the bug command.
+ * @task T4913
+ */
+export declare function registerBugCommand(program: Command): void;
+//# sourceMappingURL=bug.d.ts.map

package/dist/cli/commands/bug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/bug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmBnE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DzD"}

package/dist/cli/commands/bug.js

@@ -0,0 +1,81 @@
+/**
+ * CLI bug command - shorthand for creating bug report tasks.
+ * @task T4913
+ * @epic T4454
+ */
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Severity mapping configuration.
+ * Maps severity levels to priority and labels.
+ */
+const SEVERITY_MAP = {
+    P0: { priority: 'critical', labels: ['bug', 'p0'] },
+    P1: { priority: 'high', labels: ['bug', 'p1'] },
+    P2: { priority: 'medium', labels: ['bug', 'p2'] },
+    P3: { priority: 'low', labels: ['bug', 'p3'] },
+};
+/**
+ * Valid severity levels for error messages.
+ */
+const VALID_SEVERITIES = Object.keys(SEVERITY_MAP);
+/**
+ * Register the bug command.
+ * @task T4913
+ */
+export function registerBugCommand(program) {
+    program
+        .command('bug <title>')
+        .description('Create a bug report task with severity mapping')
+        .option('-s, --severity <level>', 'Severity level (P0, P1, P2, P3) - required', 'P2')
+        .option('-e, --epic <id>', 'Epic ID to link as parent (optional)')
+        .option('-d, --description <desc>', 'Bug description')
+        .option('--dry-run', 'Show what would be created without making changes')
+        .action(async (title, opts) => {
+        const severity = opts['severity'] || 'P2';
+        // Validate severity level
+        if (!VALID_SEVERITIES.includes(severity)) {
+            console.error(`Error: Invalid severity "${severity}". Must be one of: ${VALID_SEVERITIES.join(', ')}`);
+            process.exit(1);
+        }
+        const mapping = SEVERITY_MAP[severity];
+        const params = {
+            title,
+            type: 'task',
+            priority: mapping.priority,
+            labels: mapping.labels,
+            origin: 'bug-report',
+            description: opts['description'] || title,
+        };
+        // Link to epic if provided
+        if (opts['epic'] !== undefined) {
+            params['parent'] = opts['epic'];
+        }
+        if (opts['dryRun'] !== undefined) {
+            params['dryRun'] = opts['dryRun'];
+        }
+        const response = await dispatchRaw('mutate', 'tasks', 'add', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'bug', operation: 'tasks.add' });
+        }
+        const data = response.data;
+        if (data?.duplicate) {
+            cliOutput(data, {
+                command: 'add',
+                message: 'Task with identical title was created recently',
+                operation: 'tasks.add',
+            });
+        }
+        else if (data?.dryRun) {
+            cliOutput(data, {
+                command: 'add',
+                message: 'Dry run - no changes made',
+                operation: 'tasks.add',
+            });
+        }
+        else {
+            cliOutput(data, { command: 'add', operation: 'tasks.add' });
+        }
+    });
+}
+//# sourceMappingURL=bug.js.map

package/dist/cli/commands/bug.js.map

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

package/dist/cli/commands/cant.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI command group: cleo cant
+ *
+ * Subcommands:
+ *   cleo cant migrate <file>                      -- Convert markdown to .cant files
+ *   cleo cant parse <file>                        -- Parse a .cant file and emit AST
+ *   cleo cant validate <file>                     -- 42-rule validation report
+ *   cleo cant list <file> [--kind ...]            -- List agents / pipelines / workflows
+ *   cleo cant execute <file> --pipeline <name>    -- Run a deterministic pipeline
+ *
+ * Phase 4 originally shelled out to a `cant-cli` Rust binary. T282 replaced
+ * the binary with the async `cant-napi` napi-rs binding, so all subcommands
+ * now call the `@cleocode/cant` TypeScript API directly (zero subprocess
+ * overhead, single binary distribution).
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the `cleo cant` command group.
+ *
+ * Registers a `cant` parent command and subcommands for parsing,
+ * validating, listing, executing, and migrating CANT DSL files.
+ *
+ * @param program - The root CLI command to attach to
+ *
+ * @example
+ * ```ts
+ * registerCantCommand(rootCommand);
+ * // Adds: cleo cant parse|validate|list|execute|migrate
+ * ```
+ */
+export declare function registerCantCommand(program: Command): void;
+//# sourceMappingURL=cant.d.ts.map

package/dist/cli/commands/cant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cant.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA8CnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmL1D"}

package/dist/cli/commands/cant.js

@@ -0,0 +1,281 @@
+/**
+ * CLI command group: cleo cant
+ *
+ * Subcommands:
+ *   cleo cant migrate <file>                      -- Convert markdown to .cant files
+ *   cleo cant parse <file>                        -- Parse a .cant file and emit AST
+ *   cleo cant validate <file>                     -- 42-rule validation report
+ *   cleo cant list <file> [--kind ...]            -- List agents / pipelines / workflows
+ *   cleo cant execute <file> --pipeline <name>    -- Run a deterministic pipeline
+ *
+ * Phase 4 originally shelled out to a `cant-cli` Rust binary. T282 replaced
+ * the binary with the async `cant-napi` napi-rs binding, so all subcommands
+ * now call the `@cleocode/cant` TypeScript API directly (zero subprocess
+ * overhead, single binary distribution).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { cliError, cliOutput } from '../renderers/index.js';
+/**
+ * Register the `cleo cant` command group.
+ *
+ * Registers a `cant` parent command and subcommands for parsing,
+ * validating, listing, executing, and migrating CANT DSL files.
+ *
+ * @param program - The root CLI command to attach to
+ *
+ * @example
+ * ```ts
+ * registerCantCommand(rootCommand);
+ * // Adds: cleo cant parse|validate|list|execute|migrate
+ * ```
+ */
+export function registerCantCommand(program) {
+    const cant = program.command('cant').description('CANT DSL tooling');
+    cant
+        .command('parse <file>')
+        .description('Parse a .cant file and emit the AST')
+        .action(async (file) => {
+        const filePath = resolveFilePath(file);
+        if (!ensureExists(filePath, 'cant.parse'))
+            return;
+        try {
+            const mod = await loadCantDocument();
+            const result = await mod.parseDocument(filePath);
+            cliOutput(result, { command: 'cant', operation: 'cant.parse' });
+        }
+        catch (err) {
+            emitFailure('cant.parse', 'E_PARSE_FAILED', err);
+        }
+    });
+    cant
+        .command('validate <file>')
+        .description('Run the 42-rule validation suite on a .cant file')
+        .action(async (file) => {
+        const filePath = resolveFilePath(file);
+        if (!ensureExists(filePath, 'cant.validate'))
+            return;
+        try {
+            const mod = await loadCantDocument();
+            const result = await mod.validateDocument(filePath);
+            cliOutput(result, { command: 'cant', operation: 'cant.validate' });
+        }
+        catch (err) {
+            emitFailure('cant.validate', 'E_VALIDATE_FAILED', err);
+        }
+    });
+    cant
+        .command('list <file>')
+        .description('List agents, workflows, or pipelines in a .cant file')
+        .option('--kind <kind>', 'One of: agent | workflow | pipeline (default: agent)', 'agent')
+        .action(async (file, opts) => {
+        const filePath = resolveFilePath(file);
+        if (!ensureExists(filePath, 'cant.list'))
+            return;
+        const kind = (opts['kind'] ?? 'agent').toLowerCase();
+        if (kind !== 'agent' && kind !== 'pipeline' && kind !== 'workflow') {
+            cliError(`Invalid --kind '${kind}'. Use one of: agent, pipeline, workflow.`, 'E_BAD_KIND');
+            process.exitCode = 2;
+            return;
+        }
+        try {
+            const mod = await loadCantDocument();
+            const result = await mod.listSections(filePath, kind);
+            cliOutput(result, { command: 'cant', operation: `cant.list-${kind}s` });
+        }
+        catch (err) {
+            emitFailure(`cant.list-${kind}s`, 'E_LIST_FAILED', err);
+        }
+    });
+    cant
+        .command('execute <file>')
+        .description('Execute a deterministic pipeline from a .cant file. LLM-dependent workflow constructs run via the cant-bridge.')
+        .requiredOption('--pipeline <name>', 'Pipeline name to execute')
+        .action(async (file, opts) => {
+        const filePath = resolveFilePath(file);
+        if (!ensureExists(filePath, 'cant.execute'))
+            return;
+        const pipelineName = opts['pipeline'];
+        try {
+            const mod = await loadCantDocument();
+            const result = (await mod.executePipeline(filePath, pipelineName));
+            cliOutput(result, { command: 'cant', operation: 'cant.execute' });
+            if (!result.success) {
+                process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            emitFailure('cant.execute', 'E_PIPELINE_RUNTIME', err);
+            process.exitCode = 1;
+        }
+    });
+    cant
+        .command('migrate <file>')
+        .description('Convert markdown instruction files to .cant format')
+        .option('--write', 'Write .cant files to disk (default: dry-run preview)')
+        .option('--dry-run', 'Preview conversion without writing files (default behavior)')
+        .option('--output-dir <dir>', 'Output directory for .cant files (default: .cleo/agents/)')
+        .option('--verbose', 'Show detailed conversion log')
+        .option('--json', 'Output results as JSON')
+        .action(async (file, opts) => {
+        const isJson = !!opts.json;
+        const isWrite = !!opts.write && !opts.dryRun;
+        const isVerbose = !!opts.verbose;
+        // Resolve file path
+        const filePath = isAbsolute(file) ? file : resolve(process.cwd(), file);
+        if (!existsSync(filePath)) {
+            const errMsg = `File not found: ${filePath}`;
+            if (isJson) {
+                console.log(JSON.stringify({ error: errMsg }));
+            }
+            else {
+                console.error(errMsg);
+            }
+            process.exit(1);
+        }
+        try {
+            // Dynamic import to avoid pulling cant into the main bundle
+            // when the command is not used.
+            const mod = await loadMigrateEngine();
+            const content = readFileSync(filePath, 'utf-8');
+            const result = mod.migrateMarkdown(content, filePath, {
+                write: isWrite,
+                verbose: isVerbose,
+                outputDir: opts.outputDir,
+            });
+            if (isJson) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (isWrite) {
+                // Write .cant files to disk
+                const projectRoot = process.cwd();
+                let written = 0;
+                for (const outputFile of result.outputFiles) {
+                    const outputPath = isAbsolute(outputFile.path)
+                        ? outputFile.path
+                        : join(projectRoot, outputFile.path);
+                    mkdirSync(dirname(outputPath), { recursive: true });
+                    writeFileSync(outputPath, outputFile.content, 'utf-8');
+                    written++;
+                    if (isVerbose) {
+                        console.log(`  Created: ${outputFile.path} (${outputFile.kind})`);
+                    }
+                }
+                console.log(`Wrote ${written} .cant file(s).`);
+                console.log(result.summary);
+                if (result.unconverted.length > 0) {
+                    console.log('');
+                    console.log(`${result.unconverted.length} section(s) need manual conversion.`);
+                    for (const section of result.unconverted) {
+                        console.log(`  Lines ${section.lineStart}-${section.lineEnd}: ${section.reason}`);
+                    }
+                }
+            }
+            else {
+                // Dry-run: show diff preview
+                const diffOutput = mod.showDiff(result, process.stdout.isTTY ?? false);
+                console.log(diffOutput);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isJson) {
+                console.log(JSON.stringify({ error: message }));
+            }
+            else {
+                console.error(`Migration failed: ${message}`);
+            }
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Resolve a file argument to an absolute path against the current working
+ * directory. Used by every cant subcommand for consistent input handling.
+ */
+function resolveFilePath(file) {
+    return isAbsolute(file) ? file : resolve(process.cwd(), file);
+}
+/**
+ * Verify that a file exists, emitting a LAFS-shaped error envelope and
+ * setting `process.exitCode` to 3 when it doesn't.
+ *
+ * @returns `true` when the file exists and execution can proceed.
+ */
+function ensureExists(filePath, operation) {
+    if (existsSync(filePath))
+        return true;
+    cliError(`File not found: ${filePath}`, 'E_FILE_READ');
+    process.exitCode = 3;
+    // Surface operation context in stderr for human readers when debugging.
+    if (process.env['CLEO_DEBUG']) {
+        console.error(`(operation: ${operation})`);
+    }
+    return false;
+}
+/**
+ * Emit a failure envelope for an unexpected exception thrown by the cant
+ * document API. The error code is caller-provided so each subcommand can
+ * report a meaningful classification.
+ */
+function emitFailure(operation, code, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    cliError(`${operation} failed: ${message}`, code);
+    process.exitCode = process.exitCode ?? 1;
+}
+/**
+ * Dynamically load the high-level CANT document API.
+ *
+ * Tries multiple import paths to support both installed packages and
+ * development workspace layouts. Uses dynamic import to keep the cant
+ * (and napi binding) lazy-loaded.
+ *
+ * @returns The loaded document module
+ * @throws Error if the module cannot be found
+ */
+async function loadCantDocument() {
+    const paths = ['@cleocode/cant', '../../../../cant/dist/index', '../../../../cant/src/index'];
+    for (const p of paths) {
+        try {
+            const mod = (await import(p));
+            if (typeof mod['parseDocument'] === 'function' &&
+                typeof mod['validateDocument'] === 'function' &&
+                typeof mod['listSections'] === 'function' &&
+                typeof mod['executePipeline'] === 'function') {
+                return mod;
+            }
+        }
+        catch {
+            // Try next path
+        }
+    }
+    throw new Error('Cannot load CANT document API. Ensure @cleocode/cant is installed.');
+}
+/**
+ * Dynamically load the CANT migration engine.
+ *
+ * Tries multiple import paths to support both installed packages
+ * and development workspace layouts. Uses dynamic import to keep
+ * the cant dependency lazy-loaded.
+ *
+ * @returns The loaded migration module
+ * @throws Error if the module cannot be found
+ */
+async function loadMigrateEngine() {
+    // Try loading paths in order of preference
+    const paths = ['@cleocode/cant', '../../../../cant/dist/index', '../../../../cant/src/index'];
+    for (const p of paths) {
+        try {
+            const mod = (await import(p));
+            if (typeof mod['migrateMarkdown'] === 'function' && typeof mod['showDiff'] === 'function') {
+                return mod;
+            }
+        }
+        catch {
+            // Try next path
+        }
+    }
+    throw new Error('Cannot load CANT migration engine. Ensure @cleocode/cant is installed.');
+}
+//# sourceMappingURL=cant.js.map