@cleocode/cleo 2026.4.10 → 2026.4.11

package/dist/cli/commands/docs.js

@@ -0,0 +1,169 @@
+/**
+ * CLI docs command - documentation management with drift detection and gap checking.
+ * Ported from scripts/docs.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { CleoError, formatError, getAgentOutputsAbsolute, readJson } from '@cleocode/core/internal';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Get list of script files from scripts/ directory.
+ * @task T4551
+ */
+async function getScriptNames(projectRoot) {
+    const scriptsDir = join(projectRoot, 'scripts');
+    try {
+        const files = await readdir(scriptsDir);
+        return files
+            .filter((f) => f.endsWith('.sh'))
+            .map((f) => f.replace('.sh', ''))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get command names from COMMANDS-INDEX.json.
+ * @task T4551
+ */
+async function getIndexedCommands(projectRoot) {
+    const indexPath = join(projectRoot, 'docs', 'commands', 'COMMANDS-INDEX.json');
+    const index = await readJson(indexPath);
+    if (!index)
+        return [];
+    return index.commands.map((c) => c.name).sort();
+}
+/**
+ * Run drift detection between scripts and documentation index.
+ * @task T4551
+ */
+async function detectDrift(projectRoot) {
+    const scripts = await getScriptNames(projectRoot);
+    const indexed = await getIndexedCommands(projectRoot);
+    const scriptSet = new Set(scripts);
+    const indexSet = new Set(indexed);
+    const missingFromIndex = scripts.filter((s) => !indexSet.has(s));
+    const missingFromScripts = indexed.filter((i) => !scriptSet.has(i));
+    const warnings = [];
+    if (missingFromIndex.length > 0) {
+        warnings.push(`${missingFromIndex.length} scripts not in COMMANDS-INDEX.json`);
+    }
+    if (missingFromScripts.length > 0) {
+        warnings.push(`${missingFromScripts.length} index entries without scripts`);
+    }
+    let status = 'clean';
+    if (missingFromIndex.length > 0 || missingFromScripts.length > 0) {
+        status = missingFromIndex.length > 5 ? 'error' : 'warning';
+    }
+    return { status, missingFromIndex, missingFromScripts, warnings };
+}
+/**
+ * Run gap-check validation for review docs.
+ * @task T4551
+ */
+async function runGapCheck(_projectRoot, filterId) {
+    const reviewDir = getAgentOutputsAbsolute();
+    const results = [];
+    try {
+        const files = await readdir(reviewDir);
+        const reviewFiles = files.filter((f) => f.endsWith('.md'));
+        for (const file of reviewFiles) {
+            // Check filter
+            if (filterId && !file.includes(filterId))
+                continue;
+            const filePath = join(reviewDir, file);
+            const content = await readFile(filePath, 'utf-8');
+            // Extract task ID from filename (e.g., T2402-protocol-spec.md)
+            const taskMatch = file.match(/^(T\d+)/);
+            const taskId = taskMatch ? taskMatch[1] : 'UNKNOWN';
+            const gaps = [];
+            // Check for required sections
+            if (!content.includes('## Summary')) {
+                gaps.push('Missing ## Summary section');
+            }
+            if (!content.includes('**Task**:') && !content.includes('**Task:**')) {
+                gaps.push('Missing Task provenance header');
+            }
+            if (gaps.length > 0) {
+                results.push({ file, taskId, gaps });
+            }
+        }
+    }
+    catch {
+        // Review directory might not exist
+    }
+    return results;
+}
+/**
+ * Register the docs command.
+ * @task T4551
+ */
+export function registerDocsCommand(program) {
+    const docsCmd = program
+        .command('docs')
+        .description('Documentation management: drift detection and gap validation');
+    docsCmd
+        .command('sync')
+        .description('Run drift detection between scripts and docs index')
+        .option('--quick', 'Quick check (commands only)')
+        .option('--strict', 'Exit with error on any drift')
+        .action(async (opts) => {
+        try {
+            const projectRoot = process.cwd();
+            const result = await detectDrift(projectRoot);
+            cliOutput({
+                status: result.status,
+                missingFromIndex: result.missingFromIndex,
+                missingFromScripts: result.missingFromScripts,
+                warnings: result.warnings,
+            }, {
+                command: 'docs',
+                message: result.status === 'clean'
+                    ? 'Documentation is in sync'
+                    : `Drift detected: ${result.warnings.join('; ')}`,
+            });
+            if (opts['strict'] && result.status !== 'clean') {
+                process.exit(result.status === 'error' ? 2 : 1);
+            }
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    docsCmd
+        .command('gap-check')
+        .description('Validate knowledge transfer from review docs to canonical docs')
+        .option('--epic <id>', 'Filter by epic ID')
+        .option('--task <id>', 'Filter by task ID')
+        .action(async (opts) => {
+        try {
+            const projectRoot = process.cwd();
+            const filterId = opts['epic'] ?? opts['task'];
+            const gaps = await runGapCheck(projectRoot, filterId);
+            if (gaps.length === 0) {
+                cliOutput({ gapCount: 0, results: [] }, { command: 'docs', message: 'No documentation gaps found' });
+            }
+            else {
+                cliOutput({
+                    gapCount: gaps.length,
+                    results: gaps,
+                }, { command: 'docs', message: `Found ${gaps.length} document(s) with gaps` });
+            }
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=docs.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * CLI doctor command - system diagnostics.
+ * Delegates via dispatch to admin.health handler.
+ * --full flag runs operational smoke tests across all domains.
+ * --hooks flag shows the cross-provider hook support matrix via CAAMP.
+ * @task T4454
+ * @task T4795
+ * @task T4903
+ * @task T5243
+ * @task T130
+ * @task T167
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA2DnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyG5D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,133 @@
+/**
+ * CLI doctor command - system diagnostics.
+ * Delegates via dispatch to admin.health handler.
+ * --full flag runs operational smoke tests across all domains.
+ * --hooks flag shows the cross-provider hook support matrix via CAAMP.
+ * @task T4454
+ * @task T4795
+ * @task T4903
+ * @task T5243
+ * @task T130
+ * @task T167
+ */
+import { dispatchFromCli, dispatchRaw } from '../../dispatch/adapters/cli.js';
+import { createDoctorProgress } from '../progress.js';
+/**
+ * Render the hook matrix as a human-readable provider x event grid.
+ *
+ * Prints a table with events as rows and provider IDs as columns,
+ * then a coverage summary line at the bottom.
+ *
+ * @param data - Hook matrix result from CAAMP
+ */
+function renderHookMatrixHuman(data) {
+    const { events, providers, matrix, summary, caampVersion, detectedProvider } = data;
+    process.stdout.write(`\nProvider Hook Matrix (CAAMP ${caampVersion} canonical taxonomy)\n\n`);
+    if (detectedProvider) {
+        process.stdout.write(`Detected provider: ${detectedProvider}\n\n`);
+    }
+    if (providers.length === 0) {
+        process.stdout.write('No providers found in CAAMP registry.\n');
+        return;
+    }
+    // Column widths
+    const EVENT_COL = Math.max(...events.map((e) => e.length), 'Event'.length);
+    // Each provider column: max(providerId.length, 5) + padding
+    const provCols = providers.map((p) => Math.max(p.length, 5));
+    // Header row
+    const headerParts = [
+        'Event'.padEnd(EVENT_COL),
+        ...providers.map((p, i) => p.padEnd(provCols[i])),
+    ];
+    process.stdout.write(`  ${headerParts.join('  ')}\n`);
+    // Separator
+    const sepParts = ['-'.repeat(EVENT_COL), ...provCols.map((w) => '-'.repeat(w))];
+    process.stdout.write(`  ${sepParts.join('  ')}\n`);
+    // Event rows
+    for (const event of events) {
+        const cells = providers.map((p, i) => {
+            const supported = matrix[event]?.[p] === true;
+            const symbol = supported ? '\u2713' : '-';
+            return symbol.padEnd(provCols[i]);
+        });
+        process.stdout.write(`  ${event.padEnd(EVENT_COL)}  ${cells.join('  ')}\n`);
+    }
+    // Coverage summary
+    process.stdout.write('\n');
+    const coverageParts = summary.map((s) => `${s.providerId} ${s.supportedCount}/${s.totalCanonical} (${s.coverage}%)`);
+    process.stdout.write(`Coverage: ${coverageParts.join(', ')}\n\n`);
+}
+export function registerDoctorCommand(program) {
+    program
+        .command('doctor')
+        .description('Run system diagnostics and health checks')
+        .option('--detailed', 'Show detailed health check results')
+        .option('--comprehensive', 'Run comprehensive doctor report')
+        .option('--full', 'Run operational smoke tests across all domains')
+        .option('--fix', 'Auto-fix failed checks')
+        .option('--coherence', 'Run coherence check across task data')
+        .option('--hooks', 'Show cross-provider hook support matrix (CAAMP canonical taxonomy)')
+        .action(async (opts, command) => {
+        // Merge citty-parsed opts with global flags (--json, --human, etc.)
+        const globalOpts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+        const mergedOpts = { ...globalOpts, ...opts };
+        const isHuman = mergedOpts['human'] === true || (!!process.stdout.isTTY && mergedOpts['json'] !== true);
+        const progress = createDoctorProgress(isHuman);
+        progress.start();
+        try {
+            if (mergedOpts['hooks']) {
+                progress.step(0, 'Building provider hook matrix');
+                if (isHuman) {
+                    // Fetch raw result to render custom table output
+                    const response = await dispatchRaw('query', 'admin', 'hooks.matrix', {
+                        detectProvider: true,
+                    });
+                    progress.complete('Hook matrix complete');
+                    if (response.success && response.data) {
+                        renderHookMatrixHuman(response.data);
+                    }
+                    else {
+                        process.stderr.write(`Error: ${response.error?.message ?? 'Failed to build hook matrix'}\n`);
+                        process.exitCode = 1;
+                    }
+                }
+                else {
+                    await dispatchFromCli('query', 'admin', 'hooks.matrix', { detectProvider: true }, { command: 'doctor', operation: 'admin.hooks.matrix' });
+                    progress.complete('Hook matrix complete');
+                }
+            }
+            else if (mergedOpts['full']) {
+                progress.step(0, 'Running operational smoke tests');
+                await dispatchFromCli('query', 'admin', 'smoke', {}, { command: 'doctor', operation: 'admin.smoke' });
+                progress.complete('Smoke tests complete');
+            }
+            else if (mergedOpts['coherence']) {
+                progress.step(0, 'Running coherence check');
+                await dispatchFromCli('query', 'check', 'coherence', {}, { command: 'doctor', operation: 'check.coherence' });
+                progress.complete('Coherence check complete');
+            }
+            else if (mergedOpts['fix']) {
+                progress.step(4, 'Applying fixes');
+                await dispatchFromCli('mutate', 'admin', 'health', { mode: 'repair' }, { command: 'doctor', operation: 'admin.health' });
+                progress.complete('Fixes applied');
+            }
+            else if (mergedOpts['comprehensive']) {
+                progress.step(0, 'Checking CLEO directory');
+                await dispatchFromCli('query', 'admin', 'health', { mode: 'diagnose' }, { command: 'doctor', operation: 'admin.health' });
+                progress.complete('Comprehensive diagnostics complete');
+            }
+            else {
+                progress.step(0, 'Checking CLEO directory');
+                await dispatchFromCli('query', 'admin', 'health', {
+                    detailed: mergedOpts['detailed'],
+                }, { command: 'doctor', operation: 'admin.health' });
+                progress.complete('Health check complete');
+            }
+        }
+        catch (err) {
+            progress.error('Health check failed');
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Dynamic command registration — thin wrapper around the CLI adapter.
+ *
+ * Provides registerDynamicCommands() so that src/cli/index.ts can import it
+ * via the standard commands/ path. Currently a no-op stub; T4897+ will
+ * populate this with auto-generated Commander commands derived from
+ * OperationDef.params arrays in the registry.
+ *
+ * Usage in src/cli/index.ts:
+ *   import { registerDynamicCommands } from './commands/dynamic.js';
+ *   registerDynamicCommands(program);
+ *
+ * @epic T4894
+ * @task T4900
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register dynamically-generated commands onto the Commander program.
+ *
+ * Stub implementation: no commands registered until T4897 populates
+ * OperationDef.params arrays for all operations.
+ */
+export declare function registerDynamicCommands(_program: Command): void;
+//# sourceMappingURL=dynamic.d.ts.map

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

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

package/dist/cli/commands/dynamic.js

@@ -0,0 +1,27 @@
+/**
+ * Dynamic command registration — thin wrapper around the CLI adapter.
+ *
+ * Provides registerDynamicCommands() so that src/cli/index.ts can import it
+ * via the standard commands/ path. Currently a no-op stub; T4897+ will
+ * populate this with auto-generated Commander commands derived from
+ * OperationDef.params arrays in the registry.
+ *
+ * Usage in src/cli/index.ts:
+ *   import { registerDynamicCommands } from './commands/dynamic.js';
+ *   registerDynamicCommands(program);
+ *
+ * @epic T4894
+ * @task T4900
+ */
+/**
+ * Register dynamically-generated commands onto the Commander program.
+ *
+ * Stub implementation: no commands registered until T4897 populates
+ * OperationDef.params arrays for all operations.
+ */
+export function registerDynamicCommands(_program) {
+    // No-op until T4897 populates OperationDef.params arrays.
+    // The dispatch layer (getCliDispatcher) handles routing for all operations
+    // that already have explicit command registrations in src/cli/commands/.
+}
+//# sourceMappingURL=dynamic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.js","sourceRoot":"","sources":["../../../src/cli/commands/dynamic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAiB;IACvD,0DAA0D;IAC1D,2EAA2E;IAC3E,yEAAyE;AAC3E,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * CLI env command for environment/mode inspection.
+ * @task T4581
+ * @epic T4577
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the env command group.
+ * @task T4581
+ */
+export declare function registerEnvCommand(program: Command): void;
+//# sourceMappingURL=env.d.ts.map

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

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

package/dist/cli/commands/env.js

@@ -0,0 +1,44 @@
+/**
+ * CLI env command for environment/mode inspection.
+ * @task T4581
+ * @epic T4577
+ */
+// CLI-only: no dispatch equivalent for environment diagnostics
+import { getRuntimeDiagnostics } from '@cleocode/core/internal';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Build the env status response.
+ * @task T4581
+ */
+async function getEnvStatus() {
+    return getRuntimeDiagnostics({ detailed: false });
+}
+/**
+ * Build the detailed env info response.
+ * @task T4581
+ */
+async function getEnvInfo() {
+    return getRuntimeDiagnostics({ detailed: true });
+}
+/**
+ * Register the env command group.
+ * @task T4581
+ */
+export function registerEnvCommand(program) {
+    const env = program.command('env').description('Environment and mode inspection');
+    env
+        .command('status', { isDefault: true })
+        .description('Show current environment mode and runtime info')
+        .action(async () => {
+        const result = await getEnvStatus();
+        cliOutput(result, { command: 'env' });
+    });
+    env
+        .command('info')
+        .description('Show detailed environment info including binary paths and compilation status')
+        .action(async () => {
+        const result = await getEnvInfo();
+        cliOutput(result, { command: 'env' });
+    });
+}
+//# sourceMappingURL=env.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/cli/commands/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+DAA+D;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;GAGG;AACH,KAAK,UAAU,YAAY;IACzB,OAAO,qBAAqB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU;IACvB,OAAO,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,iCAAiC,CAAC,CAAC;IAElF,GAAG;SACA,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACtC,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * CLI exists command - check if a task ID exists.
+ *
+ * Fix #68: Calls getTask() from core directly (tasks.exists was never
+ * registered in the operation registry).
+ *
+ * @task T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the exists command.
+ *
+ * @param program - Root CLI program instance.
+ *
+ * @example
+ * ```ts
+ * registerExistsCommand(rootCommand);
+ * // cleo exists T001 → exit 0 if found, exit 4 if not
+ * ```
+ */
+export declare function registerExistsCommand(program: Command): void;
+//# sourceMappingURL=exists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/exists.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8B5D"}

package/dist/cli/commands/exists.js

@@ -0,0 +1,51 @@
+/**
+ * CLI exists command - check if a task ID exists.
+ *
+ * Fix #68: Calls getTask() from core directly (tasks.exists was never
+ * registered in the operation registry).
+ *
+ * @task T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { getTask, resolveProjectRoot } from '@cleocode/core/internal';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Register the exists command.
+ *
+ * @param program - Root CLI program instance.
+ *
+ * @example
+ * ```ts
+ * registerExistsCommand(rootCommand);
+ * // cleo exists T001 → exit 0 if found, exit 4 if not
+ * ```
+ */
+export function registerExistsCommand(program) {
+    program
+        .command('exists <task-id>')
+        .description('Check if a task ID exists (exit 0=exists, 4=not found)')
+        .option('--verbose', 'Show task title and status when found')
+        .action(async (taskId, opts) => {
+        const cwd = resolveProjectRoot();
+        let task;
+        try {
+            task = await getTask(taskId, cwd);
+        }
+        catch (err) {
+            console.error(`exists: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(ExitCode.GENERAL_ERROR);
+        }
+        if (!task) {
+            const data = { exists: false, taskId };
+            cliOutput(data, { command: 'exists', operation: 'tasks.exists' });
+            process.exit(ExitCode.NOT_FOUND);
+        }
+        const data = { exists: true, taskId };
+        if (opts['verbose']) {
+            data['title'] = task.title;
+            data['status'] = task.status;
+        }
+        cliOutput(data, { command: 'exists', operation: 'tasks.exists' });
+    });
+}
+//# sourceMappingURL=exists.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/cli/commands/exists.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6B,EAAE,EAAE;QAC9D,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,IAAI,IAAyC,CAAC;QAE9C,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACvC,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/export-tasks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI export-tasks command - export tasks to portable package for cross-project transfer.
+ * Thin dispatch wrapper routing to admin.export.tasks.
+ *
+ * @task T4551, T5323, T5328
+ * @epic T4545
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerExportTasksCommand(program: Command): void;
+//# sourceMappingURL=export-tasks.d.ts.map

package/dist/cli/commands/export-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-tasks.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2CjE"}

package/dist/cli/commands/export-tasks.js

@@ -0,0 +1,47 @@
+/**
+ * CLI export-tasks command - export tasks to portable package for cross-project transfer.
+ * Thin dispatch wrapper routing to admin.export.tasks.
+ *
+ * @task T4551, T5323, T5328
+ * @epic T4545
+ */
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+export function registerExportTasksCommand(program) {
+    program
+        .command('export-tasks [taskIds...]')
+        .description('Export tasks to portable .cleo-export.json package for cross-project transfer')
+        .option('-o, --output <file>', 'Output file path (stdout if omitted)')
+        .option('--subtree', 'Include all descendants of specified task(s)')
+        .option('--filter <filters...>', 'Filter tasks by criteria (key=value, repeatable)')
+        .option('--include-deps', 'Auto-include task dependencies')
+        .option('--dry-run', 'Preview selection without creating export file')
+        .action(async (taskIds, opts) => {
+        const hasOutput = !!opts['output'];
+        const params = {
+            taskIds: taskIds.length > 0 ? taskIds : undefined,
+            output: opts['output'],
+            subtree: opts['subtree'],
+            filter: opts['filter'],
+            includeDeps: opts['includeDeps'],
+            dryRun: opts['dryRun'],
+        };
+        if (hasOutput || opts['dryRun']) {
+            await dispatchFromCli('query', 'admin', 'export', { ...params, scope: 'tasks' }, { command: 'export-tasks' });
+        }
+        else {
+            // No output file — write content directly to stdout for piping
+            const response = await dispatchRaw('query', 'admin', 'export', {
+                ...params,
+                scope: 'tasks',
+            });
+            handleRawError(response, { command: 'export-tasks', operation: 'admin.export' });
+            const data = response.data;
+            if (data?.content) {
+                process.stdout.write(data.content);
+                if (!data.content.endsWith('\n'))
+                    process.stdout.write('\n');
+            }
+        }
+    });
+}
+//# sourceMappingURL=export-tasks.js.map

package/dist/cli/commands/export-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-tasks.js","sourceRoot":"","sources":["../../../src/cli/commands/export-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAG9F,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO;SACJ,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,+EAA+E,CAAC;SAC5F,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;SACrE,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;SACnE,MAAM,CAAC,uBAAuB,EAAE,kDAAkD,CAAC;SACnF,MAAM,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;SAC1D,MAAM,CAAC,WAAW,EAAE,gDAAgD,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,OAAiB,EAAE,IAA6B,EAAE,EAAE;QACjE,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACjD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;YACxB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,CAAC;QAEF,IAAI,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAC7B,EAAE,OAAO,EAAE,cAAc,EAAE,CAC5B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAC7D,GAAG,MAAM;gBACT,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;YACH,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAwC,CAAC;YAC/D,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * CLI export command - export tasks to various formats.
+ * Thin dispatch wrapper routing to admin.export.
+ *
+ * @task T4454, T5323, T5328
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerExportCommand(program: Command): void;
+//# sourceMappingURL=export.d.ts.map

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

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