@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/cli/commands/claim.js

@@ -0,0 +1,35 @@
+/**
+ * CLI claim / unclaim commands — assign a task to an agent or session.
+ * @task T473
+ * @epic T443
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Native citty command for claiming a task by assigning it to an agent.
+ *
+ * Dispatches to tasks.claim (mutate). Requires an active session.
+ */
+export const claimCommand = defineCommand({
+    meta: { name: 'claim', description: 'Claim a task by assigning it to an agent' },
+    args: {
+        taskId: { type: 'positional', description: 'Task ID to claim', required: true },
+        agent: { type: 'string', description: 'Agent ID to assign the task to', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'tasks', 'claim', { taskId: args.taskId, agentId: args.agent }, { command: 'claim', operation: 'tasks.claim' });
+    },
+});
+/**
+ * Native citty command for unclaiming a task by removing its current assignee.
+ *
+ * Dispatches to tasks.unclaim (mutate). Requires an active session.
+ */
+export const unclaimCommand = defineCommand({
+    meta: { name: 'unclaim', description: 'Unclaim a task by removing its current assignee' },
+    args: { taskId: { type: 'positional', description: 'Task ID to unclaim', required: true } },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'tasks', 'unclaim', { taskId: args.taskId }, { command: 'unclaim', operation: 'tasks.unclaim' });
+    },
+});
+//# sourceMappingURL=claim.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../../src/cli/commands/claim.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAChF,IAAI,EAAE;QACJ,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE,QAAQ,EAAE,IAAI,EAAE;KACzF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,KAAe,EAAE,EAChE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAC/C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACzF,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAC3F,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,EAAE,EACjC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,CACnD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * CLI commands for Smart Explore code analysis.
+ *
+ * cleo code outline <file>
+ * cleo code search <query> [--lang] [--max] [--path]
+ * cleo code unfold <file> <symbol>
+ *
+ * @task T154
+ */
+/**
+ * Smart Explore code analysis command.
+ *
+ * Provides CLI access to tree-sitter powered code analysis:
+ * - outline: Extract file structure (signatures only)
+ * - search: Find symbols across codebase with relevance scoring
+ * - unfold: Extract complete symbol source with context
+ *
+ * @returns Command definition for citty dispatcher
+ * @task T154, T157
+ */
+export declare const codeCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,qDA0ItB,CAAC"}

package/dist/cli/commands/code.js

@@ -0,0 +1,161 @@
+/**
+ * CLI commands for Smart Explore code analysis.
+ *
+ * cleo code outline <file>
+ * cleo code search <query> [--lang] [--max] [--path]
+ * cleo code unfold <file> <symbol>
+ *
+ * @task T154
+ */
+import { defineCommand } from 'citty';
+/** Check tree-sitter availability before running code analysis. Exits with clear message if missing. */
+async function requireTreeSitter() {
+    const { isTreeSitterAvailable } = await import('@cleocode/core/internal');
+    if (!isTreeSitterAvailable()) {
+        console.error('Error: tree-sitter native module not available.\n\n' +
+            'This usually means the native addon failed to build during install.\n' +
+            'Fix: pnpm install (or npm install -g @cleocode/cleo)\n\n' +
+            'tree-sitter and grammar packages are bundled dependencies that should\n' +
+            'install automatically. If this persists, run: cleo doctor');
+        process.exit(7); // exit code 7 = service unavailable
+    }
+}
+/**
+ * Smart Explore code analysis command.
+ *
+ * Provides CLI access to tree-sitter powered code analysis:
+ * - outline: Extract file structure (signatures only)
+ * - search: Find symbols across codebase with relevance scoring
+ * - unfold: Extract complete symbol source with context
+ *
+ * @returns Command definition for citty dispatcher
+ * @task T154, T157
+ */
+export const codeCommand = defineCommand({
+    meta: { name: 'code', description: 'Code analysis via tree-sitter AST' },
+    subCommands: {
+        /**
+         * Outline subcommand — extract file structure via tree-sitter.
+         *
+         * Shows all top-level symbols and nested methods/properties with signatures only
+         * (bodies collapsed). Provides ~1-2K token overview vs ~12K for full file read.
+         *
+         * Usage:
+         *   cleo code outline packages/core/src/store/sqlite.ts
+         *
+         * @task T154, T157
+         */
+        outline: defineCommand({
+            meta: { name: 'outline', description: 'Show file structural skeleton (signatures only)' },
+            args: {
+                file: { type: 'positional', description: 'Source file path', required: true },
+            },
+            async run({ args }) {
+                await requireTreeSitter();
+                const { smartOutline } = await import('@cleocode/core/internal');
+                const { join } = await import('node:path');
+                const root = process.cwd();
+                const absPath = args.file.startsWith('/') ? args.file : join(root, args.file);
+                const result = smartOutline(absPath, root);
+                if (result.errors.length > 0 && result.symbols.length === 0) {
+                    console.error(`Error: ${result.errors.join(', ')}`);
+                    process.exit(1);
+                }
+                console.log(`${result.filePath} (${result.language}, ~${result.estimatedTokens} tokens)\n`);
+                for (const sym of result.symbols) {
+                    const prefix = sym.exported ? 'export ' : '';
+                    console.log(`${prefix}${sym.kind} ${sym.name} [${sym.startLine}-${sym.endLine}]`);
+                    if (sym.children.length > 0) {
+                        for (const child of sym.children) {
+                            console.log(`  ${child.kind} ${child.name} [${child.startLine}-${child.endLine}]`);
+                        }
+                    }
+                }
+            },
+        }),
+        /**
+         * Search subcommand — find symbols across codebase with relevance scoring.
+         *
+         * Walks directory tree, parses files by language, and matches symbols against
+         * query string with relevance scoring (exact > substring > fuzzy > path).
+         *
+         * Usage:
+         *   cleo code search parseFile --lang typescript --max 10
+         *   cleo code search smartOutline --path "src/**"
+         *
+         * @task T152, T157
+         */
+        search: defineCommand({
+            meta: { name: 'search', description: 'Search for symbols across codebase' },
+            args: {
+                query: { type: 'positional', description: 'Search query', required: true },
+                lang: { type: 'string', description: 'Filter by language (e.g. typescript, python)' },
+                max: { type: 'string', description: 'Max results (default: 20)' },
+                path: { type: 'string', description: 'File pattern filter (e.g. src/**)' },
+            },
+            async run({ args }) {
+                await requireTreeSitter();
+                const { smartSearch } = await import('@cleocode/core/internal');
+                const root = process.cwd();
+                const opts = {
+                    rootDir: root,
+                    maxResults: args.max ? Number.parseInt(args.max, 10) : 20,
+                    filePattern: args.path,
+                };
+                if (args.lang) {
+                    opts.language = args.lang;
+                }
+                const results = smartSearch(args.query, opts);
+                if (results.length === 0) {
+                    console.log(`No symbols found matching "${args.query}"`);
+                    return;
+                }
+                console.log(`Found ${results.length} symbols:\n`);
+                for (const r of results) {
+                    console.log(`  ${r.symbol.kind.padEnd(12)} ${r.symbol.name.padEnd(30)} ${r.symbol.filePath}:${r.symbol.startLine} (${r.matchType}, score: ${r.score})`);
+                }
+            },
+        }),
+        /**
+         * Unfold subcommand — extract complete symbol source code.
+         *
+         * Takes file path + symbol name, finds the symbol via tree-sitter AST,
+         * and extracts complete source including JSDoc/docstrings, decorators,
+         * and full body. AST boundaries guarantee no truncation.
+         *
+         * Usage:
+         *   cleo code unfold packages/core/src/code/outline.ts smartOutline
+         *   cleo code unfold packages/cleo/src/cli/commands/code.ts codeCommand
+         *
+         * @task T153, T157
+         */
+        unfold: defineCommand({
+            meta: { name: 'unfold', description: 'Extract complete symbol source' },
+            args: {
+                file: { type: 'positional', description: 'Source file path', required: true },
+                symbol: {
+                    type: 'positional',
+                    description: 'Symbol name (e.g. parseFile or Class.method)',
+                    required: true,
+                },
+            },
+            async run({ args }) {
+                await requireTreeSitter();
+                const { smartUnfold } = await import('@cleocode/core/internal');
+                const { join } = await import('node:path');
+                const root = process.cwd();
+                const absPath = args.file.startsWith('/') ? args.file : join(root, args.file);
+                const result = smartUnfold(absPath, args.symbol, root);
+                if (!result.found) {
+                    console.error(`Symbol "${args.symbol}" not found in ${args.file}`);
+                    if (result.errors.length > 0)
+                        console.error(result.errors.join(', '));
+                    process.exit(1);
+                }
+                console.log(`// ${result.filePath}:${result.startLine}-${result.endLine} (~${result.estimatedTokens} tokens)\n`);
+                console.log(result.source);
+            },
+        }),
+    },
+});
+//# sourceMappingURL=code.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * CLI complete command — mark a task as completed.
+ *
+ * Dispatches to the `tasks.complete` registry operation.
+ *
+ * As of v2026.4.78 (T832 / ADR-051), the `--force` flag has been removed.
+ * Gates are satisfied by evidence-based `cleo verify --gate … --evidence …`
+ * and re-validated at complete time. For genuine emergencies, set
+ * `CLEO_OWNER_OVERRIDE=1` with `CLEO_OWNER_OVERRIDE_REASON=<reason>` on the
+ * `cleo verify` call — the override is audited.
+ *
+ * As of T1073, the `--acknowledge-risk` flag allows bypassing the nexusImpact gate
+ * when a task touches symbols with CRITICAL impact risk. The acknowledgment is
+ * audited to `.cleo/audit/nexus-risk-ack.jsonl`.
+ *
+ * As of T1632, `cleo complete <epicId>` is REJECTED with E_EPIC_HAS_PENDING_CHILDREN
+ * when the epic has pending or active children. Pass `--override-reason "<reason>"`
+ * to bypass (audited to `.cleo/audit/premature-close.jsonl`).
+ *
+ * @task T4461
+ * @task T832
+ * @task T1632
+ * @adr ADR-051
+ * @epic T4454
+ */
+/**
+ * Complete command — marks the given task as done.
+ *
+ * Root alias `done` is wired in index.ts.
+ */
+export declare const completeCommand: import("citty").CommandDef<{
+    readonly taskId: {
+        readonly type: "positional";
+        readonly description: "ID of the task to complete";
+        readonly required: true;
+    };
+    readonly notes: {
+        readonly type: "string";
+        readonly description: "Completion notes";
+    };
+    readonly changeset: {
+        readonly type: "string";
+        readonly description: "Changeset reference";
+    };
+    readonly 'verification-note': {
+        readonly type: "string";
+        readonly description: "Evidence that acceptance criteria were met";
+    };
+    readonly 'acknowledge-risk': {
+        readonly type: "string";
+        readonly description: "Reason for acknowledging CRITICAL impact risk (bypasses nexusImpact gate)";
+    };
+    readonly 'override-reason': {
+        readonly type: "string";
+        readonly description: "Reason for bypassing E_EPIC_HAS_PENDING_CHILDREN guard (audited to .cleo/audit/premature-close.jsonl)";
+    };
+}>;
+//# sourceMappingURL=complete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;EA8D1B,CAAC"}

package/dist/cli/commands/complete.js

@@ -0,0 +1,83 @@
+/**
+ * CLI complete command — mark a task as completed.
+ *
+ * Dispatches to the `tasks.complete` registry operation.
+ *
+ * As of v2026.4.78 (T832 / ADR-051), the `--force` flag has been removed.
+ * Gates are satisfied by evidence-based `cleo verify --gate … --evidence …`
+ * and re-validated at complete time. For genuine emergencies, set
+ * `CLEO_OWNER_OVERRIDE=1` with `CLEO_OWNER_OVERRIDE_REASON=<reason>` on the
+ * `cleo verify` call — the override is audited.
+ *
+ * As of T1073, the `--acknowledge-risk` flag allows bypassing the nexusImpact gate
+ * when a task touches symbols with CRITICAL impact risk. The acknowledgment is
+ * audited to `.cleo/audit/nexus-risk-ack.jsonl`.
+ *
+ * @task T4461
+ * @task T832
+ * @adr ADR-051
+ * @epic T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Complete command — marks the given task as done.
+ *
+ * Root alias `done` is wired in index.ts.
+ */
+export const completeCommand = defineCommand({
+    meta: {
+        name: 'complete',
+        description: 'Mark a task as completed (requires active session)',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'ID of the task to complete',
+            required: true,
+        },
+        notes: {
+            type: 'string',
+            description: 'Completion notes',
+        },
+        changeset: {
+            type: 'string',
+            description: 'Changeset reference',
+        },
+        'verification-note': {
+            type: 'string',
+            description: 'Evidence that acceptance criteria were met',
+        },
+        'acknowledge-risk': {
+            type: 'string',
+            description: 'Reason for acknowledging CRITICAL impact risk (bypasses nexusImpact gate)',
+        },
+    },
+    async run({ args }) {
+        const response = await dispatchRaw('mutate', 'tasks', 'complete', {
+            taskId: args.taskId,
+            notes: args.notes,
+            changeset: args.changeset,
+            verificationNote: args['verification-note'],
+            acknowledgeRisk: args['acknowledge-risk'],
+        });
+        if (!response.success) {
+            handleRawError(response, { command: 'complete', operation: 'tasks.complete' });
+        }
+        const data = response.data;
+        // Engine may return {task: {...}} or the task record directly
+        const task = data?.task ?? data;
+        const output = { task };
+        const autoCompleted = data?.autoCompleted;
+        if (Array.isArray(autoCompleted) && autoCompleted.length > 0) {
+            output['autoCompleted'] = autoCompleted;
+        }
+        const unblockedTasks = data?.unblockedTasks;
+        if (Array.isArray(unblockedTasks) && unblockedTasks.length > 0) {
+            output['unblockedTasks'] = unblockedTasks;
+        }
+        cliOutput(output, { command: 'complete', operation: 'tasks.complete' });
+    },
+});
+//# sourceMappingURL=complete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,oDAAoD;KAClE;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;SACf;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kBAAkB;SAChC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qBAAqB;SACnC;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4CAA4C;SAC1D;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2EAA2E;SACzF;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE;YAChE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAuB;YACjE,eAAe,EAAE,IAAI,CAAC,kBAAkB,CAAuB;SAChE,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA2C,CAAC;QAClE,8DAA8D;QAC9D,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;QAChC,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,eAAe,CAAC,GAAG,aAAa,CAAC;QAC1C,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC;QAC5C,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI complexity command — estimate complexity of a task.
+ * @task T473
+ * @epic T443
+ */
+/**
+ * Native citty command group for task complexity analysis.
+ *
+ * Exposes tasks.complexity.estimate as cleo complexity estimate <taskId>.
+ * Returns a complexity estimate (small/medium/large) with reasoning.
+ */
+export declare const complexityCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=complexity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/complexity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,qDAQ5B,CAAC"}

package/dist/cli/commands/complexity.js

@@ -0,0 +1,32 @@
+/**
+ * CLI complexity command — estimate complexity of a task.
+ * @task T473
+ * @epic T443
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo complexity estimate — estimate complexity of a single task */
+const complexityEstimateCommand = defineCommand({
+    meta: { name: 'estimate', description: 'Estimate complexity of a task (small / medium / large)' },
+    args: { taskId: { type: 'positional', description: 'Task ID to estimate', required: true } },
+    async run({ args }) {
+        await dispatchFromCli('query', 'tasks', 'complexity.estimate', { taskId: args.taskId }, { command: 'complexity', operation: 'tasks.complexity.estimate' });
+    },
+});
+/**
+ * Native citty command group for task complexity analysis.
+ *
+ * Exposes tasks.complexity.estimate as cleo complexity estimate <taskId>.
+ * Returns a complexity estimate (small/medium/large) with reasoning.
+ */
+export const complexityCommand = defineCommand({
+    meta: { name: 'complexity', description: 'Task complexity analysis' },
+    subCommands: { estimate: complexityEstimateCommand },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=complexity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.js","sourceRoot":"","sources":["../../../src/cli/commands/complexity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,sEAAsE;AACtE,MAAM,yBAAyB,GAAG,aAAa,CAAC;IAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,wDAAwD,EAAE;IACjG,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAC5F,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,qBAAqB,EACrB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,EAAE,EACjC,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAClE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACrE,WAAW,EAAE,EAAE,QAAQ,EAAE,yBAAyB,EAAE;IACpD,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;QACxB,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO;QACvE,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * CLI command group: cleo compliance — compliance metrics and enforcement.
+ *
+ * Monitors and reports compliance metrics for orchestrator and agent outputs.
+ *
+ * Subcommands:
+ *   cleo compliance summary              — aggregate stats (default)
+ *   cleo compliance violations           — list violations
+ *   cleo compliance trend [days]         — show trend over N days
+ *   cleo compliance audit <taskId>       — check compliance for a task
+ *   cleo compliance sync                 — sync metrics to global aggregation
+ *   cleo compliance skills               — per-skill/agent reliability stats
+ *   cleo compliance value [days]         — VALUE PROOF: token savings and impact
+ *   cleo compliance record <taskId> <result> — record a check result
+ *
+ * @task T4535
+ * @task T476
+ * @epic T4454
+ */
+/**
+ * Root compliance command group.
+ *
+ * Monitors and reports compliance metrics for orchestrator and agent outputs.
+ * Dispatches to `check.compliance.*` registry operations.
+ */
+export declare const complianceCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=compliance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compliance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAsPH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,qDAoB5B,CAAC"}