@cleocode/cleo 2026.4.57 → 2026.4.59

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;;;;;;;;;GASG;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,53 @@
+/**
+ * CLI exists command - check if a task ID exists.
+ *
+ * Intentional dispatch bypass: `tasks.exists` was removed during the T5615
+ * rationalization. The canonical replacement is `tasks.find {exact:true}` and
+ * checking `results.length > 0`. This command calls `getTask()` from core
+ * directly for simplicity and exit-code semantics (0=exists, 4=not found).
+ *
+ * @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;;;;;;;;;GASG;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 && 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,OAA6B,EAAE,IAA6B,EAAE,EAAE;QAC7E,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAC5D,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"}

package/dist/cli/commands/export.js

@@ -0,0 +1,46 @@
+/**
+ * CLI export command - export tasks to various formats.
+ * Thin dispatch wrapper routing to admin.export.
+ *
+ * @task T4454, T5323, T5328
+ */
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+export function registerExportCommand(program) {
+    program
+        .command('export')
+        .description('Export tasks to CSV, TSV, JSON, or markdown format')
+        .option('--export-format <format>', 'Export format: json, csv, tsv, markdown', 'json')
+        .option('--output <file>', 'Output file path (stdout if omitted)')
+        .option('--status <statuses>', 'Filter by status (comma-separated)')
+        .option('--parent <id>', 'Filter by parent task')
+        .option('--phase <phase>', 'Filter by phase')
+        .action(async (opts) => {
+        const hasOutput = !!opts['output'];
+        if (hasOutput) {
+            await dispatchFromCli('query', 'admin', 'export', {
+                format: opts['exportFormat'],
+                output: opts['output'],
+                status: opts['status'],
+                parent: opts['parent'],
+                phase: opts['phase'],
+            }, { command: 'export' });
+        }
+        else {
+            // No output file — write content directly to stdout for piping
+            const response = await dispatchRaw('query', 'admin', 'export', {
+                format: opts['exportFormat'],
+                status: opts['status'],
+                parent: opts['parent'],
+                phase: opts['phase'],
+            });
+            handleRawError(response, { command: 'export', 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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAG9F,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,0BAA0B,EAAE,yCAAyC,EAAE,MAAM,CAAC;SACrF,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;SACjE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;SACnE,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR;gBACE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC;gBAC5B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;aACrB,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAC7D,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC;gBAC5B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;aACrB,CAAC,CAAC;YACH,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YAC3E,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/find.d.ts

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

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

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

package/dist/cli/commands/find.js

@@ -0,0 +1,152 @@
+/**
+ * CLI find 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 { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
+import { cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.find
+//
+// The registry entry for tasks.find lacks a params array (T4897 migration
+// pending).  This local definition is the CLI-visible source of truth until
+// the upstream migration completes.
+// ---------------------------------------------------------------------------
+const FIND_PARAMS = [
+    {
+        name: 'query',
+        type: 'string',
+        required: false,
+        description: 'Search text (required unless --id is provided)',
+        cli: { positional: true },
+    },
+    {
+        name: 'id',
+        type: 'string',
+        required: false,
+        description: 'Search by ID prefix',
+        cli: { flag: 'id' },
+    },
+    {
+        name: 'exact',
+        type: 'boolean',
+        required: false,
+        description: 'Exact title match',
+        cli: { flag: 'exact' },
+    },
+    {
+        name: 'status',
+        type: 'string',
+        required: false,
+        description: 'Filter by status',
+        enum: ['pending', 'active', 'blocked', 'done', 'cancelled'],
+        cli: { flag: 'status' },
+    },
+    {
+        name: 'field',
+        type: 'string',
+        required: false,
+        description: 'Field to search in (title|description|notes|id)',
+        cli: { flag: 'in' },
+    },
+    {
+        name: 'includeArchive',
+        type: 'boolean',
+        required: false,
+        description: 'Include archived tasks',
+        cli: { flag: 'include-archive' },
+    },
+    {
+        name: 'limit',
+        type: 'number',
+        required: false,
+        description: 'Max results (default: 20)',
+        cli: { flag: 'limit', parse: parseInt },
+    },
+    {
+        name: 'offset',
+        type: 'number',
+        required: false,
+        description: 'Skip first N results',
+        cli: { flag: 'offset', parse: parseInt },
+    },
+    {
+        name: 'fields',
+        type: 'string',
+        required: false,
+        description: 'Comma-separated additional fields to include (e.g. labels,acceptance,notes,description)',
+        cli: { flag: 'fields' },
+    },
+    {
+        name: 'verbose',
+        type: 'boolean',
+        required: false,
+        description: 'Include all task fields (same as cleo list output)',
+        cli: { flag: 'verbose', short: '-v' },
+    },
+];
+/**
+ * Register the find command.
+ * @task T4460
+ * @task T4668
+ */
+export function registerFindCommand(program) {
+    const cmd = program
+        .command('find')
+        .description(buildOperationHelp('tasks.find', 'Fuzzy search tasks by title/description', FIND_PARAMS));
+    // Auto-generate [query] positional arg and flag options from the ParamDef
+    // registry.  Replaces the previous hand-written .option() chain and surfaces
+    // enum values (e.g. status) in --help output.
+    applyParamDefsToCommand(cmd, FIND_PARAMS, 'tasks.find');
+    cmd.action(async (query, opts) => {
+        const limit = opts['limit'];
+        const offset = opts['offset'];
+        const params = {};
+        if (query !== undefined)
+            params['query'] = query;
+        if (opts['id'] !== undefined)
+            params['id'] = opts['id'];
+        if (opts['exact'] !== undefined)
+            params['exact'] = opts['exact'];
+        if (opts['status'] !== undefined)
+            params['status'] = opts['status'];
+        if (opts['in'] !== undefined)
+            params['field'] = opts['in'];
+        if (opts['includeArchive'] !== undefined)
+            params['includeArchive'] = opts['includeArchive'];
+        if (limit !== undefined)
+            params['limit'] = limit;
+        if (offset !== undefined)
+            params['offset'] = offset;
+        if (opts['fields'] !== undefined)
+            params['fields'] = opts['fields'];
+        if (opts['verbose'] !== undefined)
+            params['verbose'] = opts['verbose'];
+        const response = await dispatchRaw('query', 'tasks', 'find', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'find', operation: 'tasks.find' });
+        }
+        const rawData = response.data;
+        const data = (Array.isArray(rawData)
+            ? { results: rawData, total: rawData.length }
+            : rawData) ?? {};
+        const results = Array.isArray(data?.results) ? data.results : [];
+        if (results.length === 0) {
+            cliOutput(data, {
+                command: 'find',
+                message: 'No matching tasks found',
+                operation: 'tasks.find',
+            });
+            process.exit(ExitCode.NO_DATA);
+            return;
+        }
+        const total = data?.total ?? results.length;
+        const page = createPage({ total, limit, offset });
+        cliOutput(data, { command: 'find', operation: 'tasks.find', page });
+    });
+}
+//# sourceMappingURL=find.js.map

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

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

package/dist/cli/commands/generate-changelog.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI generate-changelog command - generate changelog from completed tasks.
+ * Supports multiple output platforms (Mintlify, Docusaurus, plain).
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the generate-changelog command.
+ * @task T4555
+ */
+export declare function registerGenerateChangelogCommand(program: Command): void;
+//# sourceMappingURL=generate-changelog.d.ts.map

package/dist/cli/commands/generate-changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-changelog.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate-changelog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAsMnE;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkFvE"}

package/dist/cli/commands/generate-changelog.js

@@ -0,0 +1,252 @@
+/**
+ * CLI generate-changelog command - generate changelog from completed tasks.
+ * Supports multiple output platforms (Mintlify, Docusaurus, plain).
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError, formatError, getConfigPath, getProjectRoot } from '@cleocode/core';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Get changelog source path from config.
+ * @task T4555
+ */
+function getChangelogSource(cwd) {
+    const configPath = getConfigPath(cwd);
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        return config?.release?.changelog?.source ?? 'CHANGELOG.md';
+    }
+    catch {
+        return 'CHANGELOG.md';
+    }
+}
+/**
+ * Get enabled output platforms from config.
+ * @task T4555
+ */
+function getEnabledPlatforms(cwd) {
+    const configPath = getConfigPath(cwd);
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const outputs = config?.release?.changelog?.outputs ?? [];
+        return outputs.filter((o) => o.enabled);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get default output path for a platform.
+ * @task T4555
+ */
+function getDefaultOutputPath(platform) {
+    switch (platform) {
+        case 'mintlify':
+            return 'docs/changelog/overview.mdx';
+        case 'docusaurus':
+            return 'docs/changelog.md';
+        default:
+            return 'CHANGELOG.md';
+    }
+}
+/**
+ * Get GitHub repo slug from git remote using execFileSync (no shell injection).
+ * @task T4555
+ */
+function getGitHubRepoSlug(cwd) {
+    const projectRoot = getProjectRoot(cwd);
+    try {
+        const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return remoteUrl.replace(/.*github\.com[:/]/, '').replace(/\.git$/, '');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Generate changelog for a specific platform using CHANGELOG.md as source.
+ * @task T4555
+ */
+function generateForPlatform(platform, sourceContent, repoSlug, limit) {
+    switch (platform) {
+        case 'mintlify':
+            return generateMintlify(sourceContent, repoSlug, limit);
+        case 'docusaurus':
+            return generateDocusaurus(sourceContent, limit);
+        default:
+            return sourceContent;
+    }
+}
+/**
+ * Generate Mintlify MDX changelog format.
+ * @task T4555
+ */
+function generateMintlify(source, repoSlug, limit) {
+    const lines = [];
+    lines.push('---');
+    lines.push('title: "Changelog"');
+    lines.push('description: "CLEO release history and product updates"');
+    lines.push('icon: "clock-rotate-left"');
+    lines.push('rss: true');
+    lines.push('---');
+    lines.push('');
+    lines.push('# Changelog');
+    lines.push('');
+    // Parse version blocks from source
+    const sourceLines = source.split('\n');
+    const blocks = [];
+    let currentBlock = null;
+    for (let i = 0; i < sourceLines.length; i++) {
+        const line = sourceLines[i];
+        const vMatch = line.match(/^## \[v?(\d+\.\d+\.\d+)\] - (\d{4}-\d{2}-\d{2})/);
+        if (vMatch) {
+            if (currentBlock) {
+                blocks.push({
+                    version: currentBlock.version,
+                    date: currentBlock.date,
+                    content: sourceLines
+                        .slice(currentBlock.startLine + 1, i)
+                        .join('\n')
+                        .trim(),
+                });
+            }
+            currentBlock = { version: vMatch[1], date: vMatch[2], startLine: i };
+        }
+    }
+    if (currentBlock) {
+        blocks.push({
+            version: currentBlock.version,
+            date: currentBlock.date,
+            content: sourceLines
+                .slice(currentBlock.startLine + 1)
+                .join('\n')
+                .trim(),
+        });
+    }
+    for (const block of blocks.slice(0, limit)) {
+        lines.push(`## v${block.version} - ${block.date}`);
+        lines.push('');
+        lines.push(block.content);
+        lines.push('');
+        if (repoSlug) {
+            lines.push(`[View full release notes](https://github.com/${repoSlug}/releases/tag/v${block.version})`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate Docusaurus markdown changelog format.
+ * @task T4555
+ */
+function generateDocusaurus(source, limit) {
+    const lines = [];
+    lines.push('---');
+    lines.push('id: changelog');
+    lines.push('title: Changelog');
+    lines.push('sidebar_label: Changelog');
+    lines.push('---');
+    lines.push('');
+    lines.push('# Changelog');
+    lines.push('');
+    const sourceLines = source.split('\n');
+    let versionCount = 0;
+    let inUnreleased = false;
+    for (const line of sourceLines) {
+        if (/^## \[Unreleased\]/.test(line)) {
+            inUnreleased = true;
+            continue;
+        }
+        if (/^## \[v?\d+\.\d+\.\d+\]/.test(line)) {
+            inUnreleased = false;
+            versionCount++;
+            if (versionCount > limit)
+                break;
+        }
+        if (!inUnreleased && versionCount > 0) {
+            lines.push(line);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Register the generate-changelog command.
+ * @task T4555
+ */
+export function registerGenerateChangelogCommand(program) {
+    program
+        .command('generate-changelog')
+        .description('Generate platform-specific changelog from CHANGELOG.md')
+        .option('--platform <platform>', 'Target platform (mintlify, docusaurus, plain, github)')
+        .option('--limit <n>', 'Max versions to include', '15')
+        .option('--dry-run', 'Show what would be generated without writing')
+        .action(async (opts) => {
+        try {
+            const limit = Number(opts['limit'] ?? 15);
+            const targetPlatform = opts['platform'];
+            const dryRun = !!opts['dryRun'];
+            const sourceFile = getChangelogSource();
+            const sourcePath = join(getProjectRoot(), sourceFile);
+            if (!existsSync(sourcePath)) {
+                throw new CleoError(ExitCode.NOT_FOUND, `Changelog source not found: ${sourcePath}`);
+            }
+            const sourceContent = readFileSync(sourcePath, 'utf-8');
+            const repoSlug = getGitHubRepoSlug();
+            const results = [];
+            if (targetPlatform) {
+                const platforms = getEnabledPlatforms();
+                const platformConfig = platforms.find((p) => p.platform === targetPlatform);
+                const outputPath = platformConfig?.path ?? getDefaultOutputPath(targetPlatform);
+                const content = generateForPlatform(targetPlatform, sourceContent, repoSlug, limit);
+                if (!dryRun) {
+                    const fullPath = join(getProjectRoot(), outputPath);
+                    mkdirSync(dirname(fullPath), { recursive: true });
+                    writeFileSync(fullPath, content, 'utf-8');
+                }
+                results.push({ platform: targetPlatform, path: outputPath, written: !dryRun });
+            }
+            else {
+                const platforms = getEnabledPlatforms();
+                if (platforms.length === 0) {
+                    throw new CleoError(ExitCode.CONFIG_ERROR, 'No changelog output platforms configured. Configure in .cleo/config.json under release.changelog.outputs');
+                }
+                for (const platformConfig of platforms) {
+                    const content = generateForPlatform(platformConfig.platform, sourceContent, repoSlug, limit);
+                    if (!dryRun) {
+                        const fullPath = join(getProjectRoot(), platformConfig.path);
+                        mkdirSync(dirname(fullPath), { recursive: true });
+                        writeFileSync(fullPath, content, 'utf-8');
+                    }
+                    results.push({
+                        platform: platformConfig.platform,
+                        path: platformConfig.path,
+                        written: !dryRun,
+                    });
+                }
+            }
+            cliOutput({
+                dryRun,
+                source: sourceFile,
+                repoSlug: repoSlug || null,
+                generated: results,
+            }, { command: 'generate-changelog' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=generate-changelog.js.map