@cleocode/cleo 2026.3.57 → 2026.3.58

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

@@ -0,0 +1,34 @@
+/**
+ * CLI init command - project initialization.
+ *
+ * Thin handler: parse args -> call core -> format output.
+ * All business logic lives in src/core/init.ts (shared-core pattern).
+ *
+ * @task T4454
+ * @task T4681
+ * @task T4682
+ * @task T4684
+ * @task T4685
+ * @task T4686
+ * @task T4687
+ * @task T4689
+ * @task T4706
+ * @task T4707
+ * @epic T4663
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Load the gitignore template from the package's templates/ directory.
+ * Falls back to embedded content if file not found.
+ *
+ * Kept as export for backward compatibility (used by upgrade.ts).
+ * @task T4700
+ */
+export declare function getGitignoreTemplate(): string;
+/**
+ * Register the init command.
+ * @task T4681
+ * @epic T4663
+ */
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAgB7C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC1D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,89 @@
+/**
+ * CLI init command - project initialization.
+ *
+ * Thin handler: parse args -> call core -> format output.
+ * All business logic lives in src/core/init.ts (shared-core pattern).
+ *
+ * @task T4454
+ * @task T4681
+ * @task T4682
+ * @task T4684
+ * @task T4685
+ * @task T4686
+ * @task T4687
+ * @task T4689
+ * @task T4706
+ * @task T4707
+ * @epic T4663
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CleoError, formatError, initProject } from '@cleocode/core';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Load the gitignore template from the package's templates/ directory.
+ * Falls back to embedded content if file not found.
+ *
+ * Kept as export for backward compatibility (used by upgrade.ts).
+ * @task T4700
+ */
+export function getGitignoreTemplate() {
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        const packageRoot = join(thisFile, '..', '..', '..', '..');
+        // Try package-local templates first, then monorepo root
+        const localTemplatePath = join(packageRoot, 'templates', 'cleo-gitignore');
+        const monorepoTemplatePath = join(packageRoot, '..', '..', 'templates', 'cleo-gitignore');
+        const templatePath = existsSync(localTemplatePath) ? localTemplatePath : monorepoTemplatePath;
+        if (existsSync(templatePath)) {
+            return readFileSync(templatePath, 'utf-8');
+        }
+    }
+    catch {
+        // fallback
+    }
+    return '# CLEO Project Data - Selective Git Tracking\nagent-outputs/\n';
+}
+/**
+ * Register the init command.
+ * @task T4681
+ * @epic T4663
+ */
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Initialize CLEO in a project directory')
+        .option('--name <name>', 'Project name')
+        .option('--force', 'Overwrite existing files')
+        .option('--detect', 'Auto-detect project configuration')
+        .option('--map-codebase', 'Run codebase analysis and store findings to brain.db')
+        .argument('[projectName]', 'Project name (alternative to --name)')
+        .action(async (projectName, opts) => {
+        try {
+            const initOpts = {
+                name: opts['name'] || projectName || undefined,
+                force: !!opts['force'],
+                detect: !!opts['detect'],
+                mapCodebase: !!opts['mapCodebase'],
+            };
+            const result = await initProject(initOpts);
+            cliOutput({
+                initialized: result.initialized,
+                directory: result.directory,
+                created: result.created,
+                skipped: result.skipped,
+                ...(result.warnings.length > 0 ? { warnings: result.warnings } : {}),
+                ...(result.updateDocsOnly ? { updateDocsOnly: true } : {}),
+            }, { command: 'init' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * CLI inject command - prepare tasks for external injection.
+ * @task T4539
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerInjectCommand(program: Command): void;
+//# sourceMappingURL=inject.d.ts.map

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

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

package/dist/cli/commands/inject.js

@@ -0,0 +1,28 @@
+/**
+ * CLI inject command - prepare tasks for external injection.
+ * @task T4539
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerInjectCommand(program) {
+    program
+        .command('inject')
+        .description('Prepare tasks for external system injection')
+        .option('--max-tasks <n>', 'Maximum tasks to inject', '8')
+        .option('--focused-only', 'Only inject the focused task')
+        .option('--phase <slug>', 'Filter tasks to specific phase')
+        .option('--output <file>', 'Write to file instead of stdout')
+        .option('--save-state', 'Save session state for extraction', true)
+        .option('--dry-run', 'Preview without writing')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'admin', 'inject.generate', {
+            maxTasks: opts['maxTasks'] ? Number(opts['maxTasks']) : 8,
+            focusedOnly: opts['focusedOnly'],
+            phase: opts['phase'],
+            output: opts['output'],
+            saveState: opts['saveState'],
+            dryRun: opts['dryRun'],
+        }, { command: 'inject' });
+    });
+}
+//# sourceMappingURL=inject.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../../src/cli/commands/inject.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;SACxD,MAAM,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;SAC1D,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SAC5D,MAAM,CAAC,cAAc,EAAE,mCAAmC,EAAE,IAAI,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,iBAAiB,EACjB;YACE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;YACpB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;YAC5B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/install-global.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Global install/refresh command - refresh global CLEO setup.
+ *
+ * Delegates to the shared bootstrap module in @cleocode/core so that
+ * both postinstall and `cleo install-global` use the same logic.
+ *
+ * Equivalent to re-running the global steps from postinstall:
+ *   - Refreshes ~/.cleo/templates/CLEO-INJECTION.md to latest bundled version
+ *   - Creates/updates ~/.agents/AGENTS.md with CAAMP block
+ *   - Injects @~/.agents/AGENTS.md into global provider files
+ *   - Updates MCP server configs for each provider
+ *   - Installs core skills globally
+ *   - Installs provider adapters
+ *
+ * @task T4916
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerInstallGlobalCommand(program: Command): void;
+//# sourceMappingURL=install-global.d.ts.map

package/dist/cli/commands/install-global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-global.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install-global.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoCnE"}

package/dist/cli/commands/install-global.js

@@ -0,0 +1,50 @@
+/**
+ * Global install/refresh command - refresh global CLEO setup.
+ *
+ * Delegates to the shared bootstrap module in @cleocode/core so that
+ * both postinstall and `cleo install-global` use the same logic.
+ *
+ * Equivalent to re-running the global steps from postinstall:
+ *   - Refreshes ~/.cleo/templates/CLEO-INJECTION.md to latest bundled version
+ *   - Creates/updates ~/.agents/AGENTS.md with CAAMP block
+ *   - Injects @~/.agents/AGENTS.md into global provider files
+ *   - Updates MCP server configs for each provider
+ *   - Installs core skills globally
+ *   - Installs provider adapters
+ *
+ * @task T4916
+ */
+import { cliOutput } from '../renderers/index.js';
+export function registerInstallGlobalCommand(program) {
+    program
+        .command('install-global')
+        .description('Refresh global CLEO setup: provider files, MCP configs, templates')
+        .option('--dry-run', 'Preview changes without applying')
+        .action(async (opts) => {
+        const isDryRun = !!opts['dryRun'];
+        try {
+            const { bootstrapGlobalCleo } = await import('@cleocode/core/internal');
+            // No packageRoot override — let bootstrap resolve templates from
+            // @cleocode/core's getPackageRoot() (templates live in core, not cleo)
+            const result = await bootstrapGlobalCleo({
+                dryRun: isDryRun,
+            });
+            cliOutput({
+                success: true,
+                dryRun: isDryRun,
+                updated: result.created,
+                warnings: result.warnings.length > 0 ? result.warnings : undefined,
+            }, {
+                command: 'install-global',
+                message: isDryRun
+                    ? `Dry run: ${result.created.length} items would be updated`
+                    : `Global CLEO setup refreshed (${result.created.length} items)`,
+            });
+        }
+        catch (err) {
+            cliOutput({ success: false, error: String(err) }, { command: 'install-global' });
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=install-global.js.map

package/dist/cli/commands/install-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-global.js","sourceRoot":"","sources":["../../../src/cli/commands/install-global.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YAExE,iEAAiE;YACjE,uEAAuE;YACvE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;gBACvC,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,SAAS,CACP;gBACE,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACnE,EACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,OAAO,EAAE,QAAQ;oBACf,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,yBAAyB;oBAC5D,CAAC,CAAC,gCAAgC,MAAM,CAAC,OAAO,CAAC,MAAM,SAAS;aACnE,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * CLI issue command - file bug reports, feature requests, or questions to CLEO GitHub.
+ * Supports subcommands: bug, feature, help, diagnostics.
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the issue command with all subcommands.
+ * @task T4555
+ */
+export declare function registerIssueCommand(program: Command): void;
+//# sourceMappingURL=issue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/issue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKnE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D3D"}

package/dist/cli/commands/issue.js

@@ -0,0 +1,105 @@
+/**
+ * CLI issue command - file bug reports, feature requests, or questions to CLEO GitHub.
+ * Supports subcommands: bug, feature, help, diagnostics.
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import { execFileSync } from 'node:child_process';
+import { BUILD_CONFIG } from '@cleocode/core/internal';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+const CLEO_REPO = BUILD_CONFIG.repository.fullName;
+/**
+ * Register the issue command with all subcommands.
+ * @task T4555
+ */
+export function registerIssueCommand(program) {
+    const issueCmd = program
+        .command('issue')
+        .description('File bug reports, feature requests, or questions to CLEO GitHub repo');
+    // Subcommand: bug
+    issueCmd
+        .command('bug')
+        .description('File a bug report')
+        .requiredOption('--title <title>', 'Issue title')
+        .requiredOption('--body <body>', 'Issue description')
+        .option('--severity <severity>', 'Severity level (Blocker, Major, Moderate, Minor)')
+        .option('--area <area>', 'Affected area (cli, mcp, docs, tests, other)')
+        .option('--open', 'Open issue in browser after creation')
+        .option('--dry-run', 'Preview without filing')
+        .action(async (opts) => {
+        await handleIssueType('bug', opts);
+    });
+    // Subcommand: feature
+    issueCmd
+        .command('feature')
+        .description('Request a new feature')
+        .requiredOption('--title <title>', 'Issue title')
+        .requiredOption('--body <body>', 'Issue description')
+        .option('--area <area>', 'Affected area')
+        .option('--open', 'Open issue in browser after creation')
+        .option('--dry-run', 'Preview without filing')
+        .action(async (opts) => {
+        await handleIssueType('feature', opts);
+    });
+    // Subcommand: help
+    issueCmd
+        .command('help')
+        .description('Ask a question')
+        .requiredOption('--title <title>', 'Issue title')
+        .requiredOption('--body <body>', 'Issue description')
+        .option('--open', 'Open issue in browser after creation')
+        .option('--dry-run', 'Preview without filing')
+        .action(async (opts) => {
+        await handleIssueType('help', opts);
+    });
+    // Subcommand: diagnostics
+    issueCmd
+        .command('diagnostics')
+        .description('Show system diagnostics (no issue filed)')
+        .action(async () => {
+        await dispatchFromCli('query', 'tools', 'issue.diagnostics', {}, {
+            command: 'issue',
+            operation: 'tools.issue.diagnostics',
+        });
+    });
+}
+/**
+ * Handle issue creation for a subcommand type (bug, feature, help).
+ * Routes through dispatch for the mutation, with post-dispatch browser open.
+ * @task T4555
+ */
+async function handleIssueType(issueType, opts) {
+    const params = {
+        issueType,
+        title: opts['title'],
+        body: opts['body'],
+        dryRun: !!opts['dryRun'],
+    };
+    if (opts['severity'])
+        params['severity'] = opts['severity'];
+    if (opts['area'])
+        params['area'] = opts['area'];
+    const opName = `issue.add.${issueType}`;
+    const response = await dispatchRaw('mutate', 'tools', opName, params);
+    if (!response.success) {
+        handleRawError(response, { command: 'issue', operation: `tools.${opName}` });
+        return;
+    }
+    const result = response.data;
+    // Handle browser open if requested
+    if (opts['open'] && typeof result['url'] === 'string' && result['url'].startsWith('https://')) {
+        const issueNumber = result['url'].match(/(\d+)$/)?.[1] ?? 'unknown';
+        try {
+            execFileSync('gh', ['issue', 'view', issueNumber, '--repo', CLEO_REPO, '--web'], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch {
+            // Browser open is non-fatal
+        }
+    }
+    cliOutput(result, { command: 'issue', operation: `tools.${opName}` });
+}
+//# sourceMappingURL=issue.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * CLI labels command - label management.
+ * Routes through dispatch layer to tasks.label.list and tasks.label.show.
+ * @task T4538
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the labels command group.
+ * @task T4538
+ */
+export declare function registerLabelsCommand(program: Command): void;
+//# sourceMappingURL=labels.d.ts.map

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

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

package/dist/cli/commands/labels.js

@@ -0,0 +1,44 @@
+/**
+ * CLI labels command - label management.
+ * Routes through dispatch layer to tasks.label.list and tasks.label.show.
+ * @task T4538
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the labels command group.
+ * @task T4538
+ */
+export function registerLabelsCommand(program) {
+    const labels = program
+        .command('labels')
+        .description('List all labels with counts or show tasks with specific label');
+    labels
+        .command('list')
+        .description('List all labels with task counts (default)')
+        .action(async () => {
+        await dispatchFromCli('query', 'tasks', 'label.list', {}, { command: 'labels' });
+    });
+    labels
+        .command('show <label>')
+        .description('Show tasks with specific label')
+        .action(async (label) => {
+        await dispatchFromCli('query', 'tasks', 'label.show', { label }, { command: 'labels' });
+    });
+    labels
+        .command('stats')
+        .description('Show detailed label statistics')
+        .action(async () => {
+        // stats is essentially label.list with additional computed fields
+        // For now, route through label.list since it provides the same base data
+        await dispatchFromCli('query', 'tasks', 'label.list', {}, { command: 'labels' });
+    });
+    // Alias: tags -> labels
+    program
+        .command('tags')
+        .description('Alias for labels command')
+        .action(async () => {
+        await dispatchFromCli('query', 'tasks', 'label.list', {}, { command: 'labels' });
+    });
+}
+//# sourceMappingURL=labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/cli/commands/labels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+DAA+D,CAAC,CAAC;IAEhF,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,kEAAkE;QAClE,yEAAyE;QACzE,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEL,wBAAwB;IACxB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * CLI lifecycle command group.
+ * @task T4467
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerLifecycleCommand(program: Command): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

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

package/dist/cli/commands/lifecycle.js

@@ -0,0 +1,72 @@
+/**
+ * CLI lifecycle command group.
+ * @task T4467
+ * @epic T4454
+ */
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+export function registerLifecycleCommand(program) {
+    const lifecycle = program
+        .command('lifecycle')
+        .description('RCASD-IVTR+C lifecycle pipeline management');
+    lifecycle
+        .command('show <epicId>')
+        .description('Show lifecycle state for an epic')
+        .action(async (epicId) => {
+        await dispatchFromCli('query', 'pipeline', 'stage.status', { epicId }, { command: 'lifecycle' });
+    });
+    lifecycle
+        .command('start <epicId> <stage>')
+        .description('Start a lifecycle stage')
+        .action(async (epicId, stage) => {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.record', {
+            taskId: epicId,
+            stage,
+            status: 'in_progress',
+        }, { command: 'lifecycle' });
+    });
+    lifecycle
+        .command('complete <epicId> <stage>')
+        .description('Complete a lifecycle stage')
+        .option('--artifacts <artifacts>', 'Comma-separated artifact paths')
+        .option('--notes <notes>', 'Completion notes')
+        .action(async (epicId, stage, opts) => {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.record', {
+            taskId: epicId,
+            stage,
+            status: 'completed',
+            notes: opts['notes'],
+        }, { command: 'lifecycle' });
+    });
+    lifecycle
+        .command('skip <epicId> <stage>')
+        .description('Skip a lifecycle stage')
+        .requiredOption('--reason <reason>', 'Reason for skipping')
+        .action(async (epicId, stage, opts) => {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.skip', {
+            taskId: epicId,
+            stage,
+            reason: opts['reason'],
+        }, { command: 'lifecycle' });
+    });
+    lifecycle
+        .command('gate <epicId> <stage>')
+        .description('Check lifecycle gate for a stage')
+        .action(async (epicId, stage) => {
+        const result = await dispatchRaw('query', 'pipeline', 'stage.validate', {
+            epicId,
+            targetStage: stage,
+        });
+        if (result.success) {
+            const { cliOutput } = await import('../renderers/index.js');
+            cliOutput(result.data, { command: 'lifecycle' });
+            const data = result.data;
+            if (data && !data['canProgress']) {
+                process.exit(80);
+            }
+        }
+        else {
+            handleRawError(result, { command: 'lifecycle', operation: 'pipeline.stage.validate' });
+        }
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * CLI list command.
+ * @task T4460
+ * @task T4668
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the list command.
+ * @task T4460
+ * @task T4668
+ */
+export declare function registerListCommand(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD1D"}

package/dist/cli/commands/list.js

@@ -0,0 +1,71 @@
+/**
+ * CLI list command.
+ * @task T4460
+ * @task T4668
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { createPage } from '@cleocode/core';
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Register the list command.
+ * @task T4460
+ * @task T4668
+ */
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('List tasks with optional filters')
+        .option('--status <status>', 'Filter by status')
+        .option('--priority <priority>', 'Filter by priority')
+        .option('--type <type>', 'Filter by type')
+        .option('--parent <id>', 'Filter by parent ID')
+        .option('--phase <phase>', 'Filter by phase')
+        .option('--label <label>', 'Filter by label')
+        .option('--children', 'Show direct children only (requires --parent)')
+        .option('--limit <n>', 'Limit number of results', parseInt)
+        .option('--offset <n>', 'Skip first N results', parseInt)
+        .action(async (opts) => {
+        const limit = opts['limit'];
+        const offset = opts['offset'];
+        const params = {};
+        if (opts['status'] !== undefined)
+            params['status'] = opts['status'];
+        if (opts['priority'] !== undefined)
+            params['priority'] = opts['priority'];
+        if (opts['type'] !== undefined)
+            params['type'] = opts['type'];
+        if (opts['parent'] !== undefined)
+            params['parent'] = opts['parent'];
+        if (opts['phase'] !== undefined)
+            params['phase'] = opts['phase'];
+        if (opts['label'] !== undefined)
+            params['label'] = opts['label'];
+        if (opts['children'] !== undefined)
+            params['children'] = opts['children'];
+        if (limit !== undefined)
+            params['limit'] = limit;
+        if (offset !== undefined)
+            params['offset'] = offset;
+        const response = await dispatchRaw('query', 'tasks', 'list', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'list', operation: 'tasks.list' });
+        }
+        const rawData = response.data;
+        const data = (Array.isArray(rawData)
+            ? { tasks: rawData, total: rawData.length }
+            : rawData) ?? {};
+        const tasks = Array.isArray(data?.tasks) ? data.tasks : [];
+        if (tasks.length === 0) {
+            cliOutput(data, { command: 'list', message: 'No tasks found', operation: 'tasks.list' });
+            process.exit(ExitCode.NO_DATA);
+            return;
+        }
+        const filtered = data?.filtered ?? tasks.length;
+        const page = response.page ?? createPage({ total: filtered, limit, offset });
+        cliOutput(data, { command: 'list', operation: 'tasks.list', page });
+    });
+}
+//# sourceMappingURL=list.js.map