@cleocode/cleo 2026.3.57 → 2026.3.58

package/dist/cli/commander-shim.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Commander.js API shim for citty migration.
+ *
+ * Provides a minimal Commander-compatible Command class that captures
+ * command definitions (name, args, options, actions, subcommands) without
+ * any dependency on the `commander` package. The captured definitions are
+ * then translated into citty commands by the entry point.
+ *
+ * Only the API surface actually used by the 90 command files is implemented:
+ *   .command(nameAndArgs) → ShimCommand
+ *   .description(desc) → this
+ *   .option(flags, desc, parseOrDefault?, defaultVal?) → this
+ *   .requiredOption(flags, desc) → this
+ *   .alias(name) → this
+ *   .action(fn) → this
+ *   .allowUnknownOption() → this  (no-op, compatibility)
+ *   .opts() → Record<string, unknown>
+ *   .optsWithGlobals() → Record<string, unknown>
+ *
+ * Positional arguments are extracted from the command name string:
+ *   'add <title>'       → name='add', args=[{name:'title', required:true}]
+ *   'find [query]'      → name='find', args=[{name:'query', required:false}]
+ *   'trend [days]'      → name='trend', args=[{name:'days', required:false}]
+ */
+/** Parsed option definition. */
+export interface ShimOption {
+    /** Long flag name (camelCase), e.g. 'dryRun' */
+    longName: string;
+    /** Short alias, e.g. 's' */
+    shortName?: string;
+    /** Whether it takes a value (vs boolean flag) */
+    takesValue: boolean;
+    /** Description text */
+    description: string;
+    /** Whether this option is required */
+    required: boolean;
+    /** Custom parse function (e.g. parseInt) */
+    parseFn?: (val: string) => unknown;
+    /** Default value */
+    defaultValue?: unknown;
+}
+/** Positional argument definition. */
+export interface ShimArg {
+    name: string;
+    required: boolean;
+    variadic?: boolean;
+}
+/** Commander-compatible option view for tests. */
+export interface CommanderCompatOption {
+    long: string;
+    required: boolean;
+    defaultValue?: unknown;
+}
+/**
+ * Type for the action handler function - flexible to support various signatures
+ */
+export type ActionHandler = (...args: unknown[]) => Promise<void> | void;
+/**
+ * Minimal Commander-compatible Command class.
+ * Captures command definitions for later translation into citty commands.
+ */
+export declare class ShimCommand {
+    _name: string;
+    _description: string;
+    _aliases: string[];
+    _options: ShimOption[];
+    _args: ShimArg[];
+    _action?: ActionHandler;
+    _subcommands: ShimCommand[];
+    _parent?: ShimCommand;
+    _isDefault: boolean;
+    /** Commander-compatible property: list of registered subcommands. */
+    get commands(): ShimCommand[];
+    /** Commander-compatible property: options with .long, .required, .defaultValue */
+    get options(): CommanderCompatOption[];
+    /** Commander-compatible property: positional arguments with .required, .variadic */
+    get registeredArguments(): ShimArg[];
+    constructor(name?: string);
+    /** Register a subcommand. Returns the new subcommand for chaining. */
+    command(nameAndArgs: string, opts?: {
+        isDefault?: boolean;
+    }): ShimCommand;
+    /** Set description (chaining). */
+    description(desc: string): this;
+    /** Get description (Commander compat). */
+    description(): string;
+    alias(name: string): this;
+    option(flags: string, description: string, parseOrDefault?: unknown, defaultVal?: unknown): this;
+    requiredOption(flags: string, description: string): this;
+    /**
+     * Add a positional argument after command creation.
+     * Commander compat: .argument('[name]', 'description')
+     */
+    argument(spec: string, _description?: string): this;
+    action(fn: (...args: any[]) => Promise<void> | void): this;
+    /** No-op for Commander compatibility. citty handles unknown options gracefully. */
+    allowUnknownOption(_allow?: boolean): this;
+    /** No-op for Commander compatibility. */
+    allowExcessArguments(_allow?: boolean): this;
+    /** Get the command name. Commander compat method. */
+    name(): string;
+    /**
+     * Return parsed global flags from process.argv.
+     * Commander compat: returns parent + own options merged.
+     */
+    optsWithGlobals(): Record<string, unknown>;
+    /**
+     * Return parsed options. For shim purposes, same as optsWithGlobals().
+     */
+    opts(): Record<string, unknown>;
+}
+//# sourceMappingURL=commander-shim.d.ts.map

package/dist/cli/commander-shim.d.ts.map

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

package/dist/cli/commander-shim.js

@@ -0,0 +1,233 @@
+/**
+ * Commander.js API shim for citty migration.
+ *
+ * Provides a minimal Commander-compatible Command class that captures
+ * command definitions (name, args, options, actions, subcommands) without
+ * any dependency on the `commander` package. The captured definitions are
+ * then translated into citty commands by the entry point.
+ *
+ * Only the API surface actually used by the 90 command files is implemented:
+ *   .command(nameAndArgs) → ShimCommand
+ *   .description(desc) → this
+ *   .option(flags, desc, parseOrDefault?, defaultVal?) → this
+ *   .requiredOption(flags, desc) → this
+ *   .alias(name) → this
+ *   .action(fn) → this
+ *   .allowUnknownOption() → this  (no-op, compatibility)
+ *   .opts() → Record<string, unknown>
+ *   .optsWithGlobals() → Record<string, unknown>
+ *
+ * Positional arguments are extracted from the command name string:
+ *   'add <title>'       → name='add', args=[{name:'title', required:true}]
+ *   'find [query]'      → name='find', args=[{name:'query', required:false}]
+ *   'trend [days]'      → name='trend', args=[{name:'days', required:false}]
+ */
+/**
+ * Minimal Commander-compatible Command class.
+ * Captures command definitions for later translation into citty commands.
+ */
+export class ShimCommand {
+    _name = '';
+    _description = '';
+    _aliases = [];
+    _options = [];
+    _args = [];
+    _action;
+    _subcommands = [];
+    _parent;
+    _isDefault = false;
+    /** Commander-compatible property: list of registered subcommands. */
+    get commands() {
+        return this._subcommands;
+    }
+    /** Commander-compatible property: options with .long, .required, .defaultValue */
+    get options() {
+        return this._options.map((o) => ({
+            long: `--${camelToKebab(o.longName)}`,
+            required: o.required,
+            defaultValue: o.defaultValue,
+        }));
+    }
+    /** Commander-compatible property: positional arguments with .required, .variadic */
+    get registeredArguments() {
+        return this._args;
+    }
+    constructor(name) {
+        if (name) {
+            const parsed = parseCommandName(name);
+            this._name = parsed.name;
+            this._args = parsed.args;
+        }
+    }
+    /** Register a subcommand. Returns the new subcommand for chaining. */
+    command(nameAndArgs, opts) {
+        const sub = new ShimCommand(nameAndArgs);
+        sub._parent = this;
+        if (opts?.isDefault)
+            sub._isDefault = true;
+        this._subcommands.push(sub);
+        return sub;
+    }
+    description(desc) {
+        if (desc === undefined) {
+            return this._description;
+        }
+        this._description = desc;
+        return this;
+    }
+    alias(name) {
+        this._aliases.push(name);
+        return this;
+    }
+    option(flags, description, parseOrDefault, defaultVal) {
+        const opt = parseOptionFlags(flags, description, false);
+        if (typeof parseOrDefault === 'function') {
+            opt.parseFn = parseOrDefault;
+            if (defaultVal !== undefined)
+                opt.defaultValue = defaultVal;
+        }
+        else if (parseOrDefault !== undefined) {
+            opt.defaultValue = parseOrDefault;
+        }
+        this._options.push(opt);
+        return this;
+    }
+    requiredOption(flags, description) {
+        const opt = parseOptionFlags(flags, description, true);
+        this._options.push(opt);
+        return this;
+    }
+    /**
+     * Add a positional argument after command creation.
+     * Commander compat: .argument('[name]', 'description')
+     */
+    argument(spec, _description) {
+        if (spec.startsWith('<') && spec.endsWith('>')) {
+            this._args.push({ name: spec.slice(1, -1), required: true });
+        }
+        else if (spec.startsWith('[') && spec.endsWith(']')) {
+            this._args.push({ name: spec.slice(1, -1), required: false });
+        }
+        return this;
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: Commander compat requires accepting any handler signature
+    action(fn) {
+        this._action = fn;
+        return this;
+    }
+    /** No-op for Commander compatibility. citty handles unknown options gracefully. */
+    allowUnknownOption(_allow) {
+        return this;
+    }
+    /** No-op for Commander compatibility. */
+    allowExcessArguments(_allow) {
+        return this;
+    }
+    /** Get the command name. Commander compat method. */
+    name() {
+        return this._name;
+    }
+    /**
+     * Return parsed global flags from process.argv.
+     * Commander compat: returns parent + own options merged.
+     */
+    optsWithGlobals() {
+        return parseGlobalFlagsFromArgv();
+    }
+    /**
+     * Return parsed options. For shim purposes, same as optsWithGlobals().
+     */
+    opts() {
+        return parseGlobalFlagsFromArgv();
+    }
+}
+// ---------------------------------------------------------------------------
+// Parsing helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse global flags from process.argv for opts()/optsWithGlobals() compat.
+ * Extracts --json, --human, --quiet, --field, --fields, --mvi.
+ */
+function parseGlobalFlagsFromArgv() {
+    const argv = process.argv.slice(2);
+    const opts = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--json')
+            opts['json'] = true;
+        else if (arg === '--human')
+            opts['human'] = true;
+        else if (arg === '--quiet')
+            opts['quiet'] = true;
+        else if (arg === '--field' && i + 1 < argv.length)
+            opts['field'] = argv[++i];
+        else if (arg === '--fields' && i + 1 < argv.length)
+            opts['fields'] = argv[++i];
+        else if (arg === '--mvi' && i + 1 < argv.length)
+            opts['mvi'] = argv[++i];
+    }
+    return opts;
+}
+/**
+ * Parse a Commander-style command name string.
+ * 'add <title>'  → { name: 'add', args: [{ name: 'title', required: true }] }
+ * 'find [query]' → { name: 'find', args: [{ name: 'query', required: false }] }
+ */
+function parseCommandName(input) {
+    const parts = input.trim().split(/\s+/);
+    const name = parts[0];
+    const args = [];
+    for (let i = 1; i < parts.length; i++) {
+        const part = parts[i];
+        if (part.startsWith('<') && part.endsWith('>')) {
+            const inner = part.slice(1, -1);
+            const variadic = inner.endsWith('...');
+            args.push({ name: variadic ? inner.slice(0, -3) : inner, required: true, variadic });
+        }
+        else if (part.startsWith('[') && part.endsWith(']')) {
+            const inner = part.slice(1, -1);
+            const variadic = inner.endsWith('...');
+            args.push({ name: variadic ? inner.slice(0, -3) : inner, required: false, variadic });
+        }
+    }
+    return { name, args };
+}
+/**
+ * Parse Commander-style option flags.
+ * '-s, --status <status>'   → { longName: 'status', shortName: 's', takesValue: true }
+ * '--dry-run'               → { longName: 'dryRun', takesValue: false }
+ * '-d, --description <desc>'→ { longName: 'description', shortName: 'd', takesValue: true }
+ */
+function parseOptionFlags(flags, description, required) {
+    let shortName;
+    let longName = '';
+    let takesValue = false;
+    // Check if there's a value placeholder like <status> or <desc>
+    if (/<[^>]+>/.test(flags)) {
+        takesValue = true;
+    }
+    // Extract short and long flags
+    const flagParts = flags
+        .replace(/<[^>]+>/, '')
+        .trim()
+        .split(/,\s*/);
+    for (const part of flagParts) {
+        const trimmed = part.trim();
+        if (trimmed.startsWith('--')) {
+            longName = kebabToCamel(trimmed.replace(/^--/, '').trim());
+        }
+        else if (trimmed.startsWith('-') && trimmed.length <= 3) {
+            shortName = trimmed.replace(/^-/, '').trim();
+        }
+    }
+    return { longName, shortName, takesValue, description, required };
+}
+/** Convert kebab-case to camelCase: 'dry-run' → 'dryRun' */
+function kebabToCamel(str) {
+    return str.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Convert camelCase to kebab-case: 'dryRun' → 'dry-run' */
+function camelToKebab(str) {
+    return str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+//# sourceMappingURL=commander-shim.js.map

package/dist/cli/commander-shim.js.map

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

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

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

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

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

package/dist/cli/commands/add.js

@@ -0,0 +1,91 @@
+/**
+ * CLI add command.
+ * @task T4460
+ * @epic T4454
+ */
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Register the add command.
+ * @task T4460
+ */
+export function registerAddCommand(program) {
+    program
+        .command('add <title>')
+        .description('Create a new task')
+        .option('-s, --status <status>', 'Task status (pending|active|blocked|done)')
+        .option('-p, --priority <priority>', 'Priority: low, medium, high, critical')
+        .option('-t, --type <type>', 'Task type: epic, task, subtask')
+        .option('--parent <id>', 'Parent task ID')
+        .option('--size <size>', 'Scope size: small, medium, large')
+        .option('-P, --phase <phase>', 'Phase slug')
+        .option('--add-phase', 'Create new phase if it does not exist')
+        .option('-d, --description <desc>', 'Task description')
+        .option('-l, --labels <labels>', 'Comma-separated labels')
+        .option('--files <files>', 'Comma-separated file paths')
+        .option('--acceptance <criteria>', 'Comma-separated acceptance criteria')
+        .option('-D, --depends <ids>', 'Comma-separated dependency IDs')
+        .option('--notes <note>', 'Initial note entry')
+        .option('--position <pos>', 'Position within sibling group', parseInt)
+        .option('--dry-run', 'Show what would be created without making changes')
+        .action(async (title, opts) => {
+        const params = { title };
+        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['size'] !== undefined)
+            params['size'] = opts['size'];
+        if (opts['phase'] !== undefined)
+            params['phase'] = opts['phase'];
+        if (opts['addPhase'] !== undefined)
+            params['addPhase'] = opts['addPhase'];
+        if (opts['description'] !== undefined) {
+            params['description'] = opts['description'];
+        }
+        else {
+            params['description'] = title;
+        }
+        if (opts['labels'])
+            params['labels'] = opts['labels'].split(',').map((s) => s.trim());
+        if (opts['files'])
+            params['files'] = opts['files'].split(',').map((s) => s.trim());
+        if (opts['acceptance'])
+            params['acceptance'] = opts['acceptance'].split(',').map((s) => s.trim());
+        if (opts['depends'])
+            params['depends'] = opts['depends'].split(',').map((s) => s.trim());
+        if (opts['notes'] !== undefined)
+            params['notes'] = opts['notes'];
+        if (opts['position'] !== undefined)
+            params['position'] = opts['position'];
+        if (opts['dryRun'] !== undefined)
+            params['dryRun'] = opts['dryRun'];
+        const response = await dispatchRaw('mutate', 'tasks', 'add', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'add', 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=add.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * CLI adr command group — ADR validation, listing, sync, and search.
+ *
+ * Thin CLI wrapper delegating to dispatch layer (admin domain).
+ * Core logic lives in src/core/adrs/.
+ *
+ * Commands:
+ *   ct adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   ct adr list [--status]       — list ADRs with optional status filter
+ *   ct adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   ct adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   ct adr find <query>          — fuzzy search ADRs by title, summary, keywords, topics
+ *
+ * MCP equivalents:
+ *   mutate({domain:'admin', operation:'adr.validate'})
+ *   query({domain:'admin',  operation:'adr.list',  params:{status?}})
+ *   query({domain:'admin',  operation:'adr.show',  params:{adrId}})
+ *   mutate({domain:'admin', operation:'adr.sync'})
+ *   query({domain:'admin',  operation:'adr.find',  params:{query, topics?, keywords?, status?}})
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ * @see ADR-017 §5.4 for cognitive search spec
+ * @see schemas/adr-frontmatter.schema.json for validation schema
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerAdrCommand(program: Command): void;
+//# sourceMappingURL=adr.d.ts.map

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

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

package/dist/cli/commands/adr.js

@@ -0,0 +1,79 @@
+/**
+ * CLI adr command group — ADR validation, listing, sync, and search.
+ *
+ * Thin CLI wrapper delegating to dispatch layer (admin domain).
+ * Core logic lives in src/core/adrs/.
+ *
+ * Commands:
+ *   ct adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   ct adr list [--status]       — list ADRs with optional status filter
+ *   ct adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   ct adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   ct adr find <query>          — fuzzy search ADRs by title, summary, keywords, topics
+ *
+ * MCP equivalents:
+ *   mutate({domain:'admin', operation:'adr.validate'})
+ *   query({domain:'admin',  operation:'adr.list',  params:{status?}})
+ *   query({domain:'admin',  operation:'adr.show',  params:{adrId}})
+ *   mutate({domain:'admin', operation:'adr.sync'})
+ *   query({domain:'admin',  operation:'adr.find',  params:{query, topics?, keywords?, status?}})
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ * @see ADR-017 §5.4 for cognitive search spec
+ * @see schemas/adr-frontmatter.schema.json for validation schema
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerAdrCommand(program) {
+    const adr = program
+        .command('adr')
+        .description('Manage and validate Architecture Decision Records in .cleo/adrs/');
+    // ct adr validate
+    adr
+        .command('validate')
+        .description('Validate frontmatter on all .cleo/adrs/*.md files against ADR-017 schema')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', { validate: true }, { command: 'adr validate', operation: 'admin.adr.sync' });
+    });
+    // ct adr list
+    adr
+        .command('list')
+        .description('List ADRs from .cleo/adrs/')
+        .option('--status <status>', 'Filter by status: proposed | accepted | superseded | deprecated')
+        .option('--since <date>', 'Filter to ADRs created on or after YYYY-MM-DD')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            status: opts['status'],
+            since: opts['since'],
+        }, { command: 'adr list', operation: 'admin.adr.find' });
+    });
+    // ct adr show <id>
+    adr
+        .command('show <adrId>')
+        .description('Show full details for a single ADR (e.g., ct adr show ADR-017)')
+        .action(async (adrId) => {
+        await dispatchFromCli('query', 'admin', 'adr.show', { adrId }, { command: 'adr show', operation: 'admin.adr.show' });
+    });
+    // ct adr sync
+    adr
+        .command('sync')
+        .description('Sync .cleo/adrs/ markdown files into the architecture_decisions DB table')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', {}, { command: 'adr sync', operation: 'admin.adr.sync' });
+    });
+    // ct adr find <query>
+    adr
+        .command('find <query>')
+        .description('Fuzzy search ADRs by title, summary, keywords, and topics')
+        .option('--topics <topics>', 'Filter by topics (comma-separated domain tags)')
+        .option('--keywords <keywords>', 'Filter by keywords (comma-separated tags)')
+        .option('--status <status>', 'Filter by status: proposed | accepted | superseded | deprecated')
+        .action(async (query, opts) => {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            query,
+            topics: opts['topics'],
+            keywords: opts['keywords'],
+            status: opts['status'],
+        }, { command: 'adr find', operation: 'admin.adr.find' });
+    });
+}
+//# sourceMappingURL=adr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adr.js","sourceRoot":"","sources":["../../../src/cli/commands/adr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kEAAkE,CAAC,CAAC;IAEnF,kBAAkB;IAClB,GAAG;SACA,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACzD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;SAC9F,MAAM,CAAC,gBAAgB,EAAE,+CAA+C,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;YAC5C,KAAK,EAAE,IAAI,CAAC,OAAO,CAAuB;SAC3C,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,EAAE,KAAK,EAAE,EACT,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,EAAE,EACF,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CAAC,uBAAuB,EAAE,2CAA2C,CAAC;SAC5E,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;SAC9F,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAA6B,EAAE,EAAE;QAC7D,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;YAC5C,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAuB;YAChD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;SAC7C,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * CLI analyze command - task triage with leverage scoring.
+ * @task T4538
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the analyze command.
+ * @task T4538
+ */
+export declare function registerAnalyzeCommand(program: Command): void;
+//# sourceMappingURL=analyze.d.ts.map

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

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

package/dist/cli/commands/analyze.js

@@ -0,0 +1,20 @@
+/**
+ * CLI analyze command - task triage with leverage scoring.
+ * @task T4538
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the analyze command.
+ * @task T4538
+ */
+export function registerAnalyzeCommand(program) {
+    program
+        .command('analyze')
+        .description('Task triage with leverage scoring and bottleneck detection')
+        .option('--auto-start', 'Automatically start working on recommended task')
+        .action(async () => {
+        await dispatchFromCli('query', 'tasks', 'analyze', {}, { command: 'analyze' });
+    });
+}
+//# sourceMappingURL=analyze.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;SACzE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC"}