@cleocode/cleo 2026.4.161 → 2026.5.0

package/dist/cli/commands/dynamic.js

@@ -0,0 +1,21 @@
+/**
+ * Dynamic command registration stub.
+ *
+ * Currently a no-op; T4897+ will populate this with auto-generated citty
+ * subcommands derived from OperationDef.params arrays in the registry.
+ *
+ * @epic T4894
+ * @task T4900
+ */
+import { defineCommand } from 'citty';
+/**
+ * Stub dynamic command — no operations registered until T4897 populates
+ * OperationDef.params arrays for all operations.
+ */
+export const dynamicCommand = defineCommand({
+    meta: { name: 'dynamic', description: 'STUB — auto-generated commands (T4897)' },
+    async run() {
+        // No-op until T4897 populates OperationDef.params arrays.
+    },
+});
+//# sourceMappingURL=dynamic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.js","sourceRoot":"","sources":["../../../src/cli/commands/dynamic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wCAAwC,EAAE;IAChF,KAAK,CAAC,GAAG;QACP,0DAA0D;IAC5D,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/** Native citty command for `cleo exists <task-id>`. */
+export declare const existsCommand: import("citty").CommandDef<{
+    readonly 'task-id': {
+        readonly type: "positional";
+        readonly description: "Task ID to look up";
+        readonly required: true;
+    };
+    readonly verbose: {
+        readonly type: "boolean";
+        readonly description: "Show task title and status when found";
+    };
+}>;
+//# sourceMappingURL=exists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/exists.ts"],"names":[],"mappings":"AASA,wDAAwD;AACxD,eAAO,MAAM,aAAa;;;;;;;;;;EA2BxB,CAAC"}

package/dist/cli/commands/exists.js

@@ -0,0 +1,40 @@
+/**
+ * CLI exists command
+ * @task T4454
+ * @task T487
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { getTask, resolveProjectRoot } from '@cleocode/core/internal';
+import { defineCommand } from 'citty';
+import { cliOutput } from '../renderers/index.js';
+/** Native citty command for `cleo exists <task-id>`. */
+export const existsCommand = defineCommand({
+    meta: { name: 'exists', description: 'Check if a task ID exists (exit 0=exists, 4=not found)' },
+    args: {
+        'task-id': { type: 'positional', description: 'Task ID to look up', required: true },
+        verbose: { type: 'boolean', description: 'Show task title and status when found' },
+    },
+    async run({ args }) {
+        const taskId = args['task-id'];
+        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) {
+            cliOutput({ exists: false, taskId }, { command: 'exists', operation: 'tasks.exists' });
+            process.exit(ExitCode.NOT_FOUND);
+        }
+        const data = { exists: true, taskId };
+        if (args.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;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;IAC/F,IAAI,EAAE;QACJ,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE;KACnF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,IAAI,IAAyC,CAAC;QAC9C,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;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * 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
+ */
+/**
+ * Export tasks to a portable `.cleo-export.json` package for cross-project transfer.
+ *
+ * Dispatches to `admin.export` with `scope: 'tasks'`. When `--output` or `--dry-run`
+ * is provided the result goes through the standard LAFS formatter; otherwise the raw
+ * JSON content is written directly to stdout for piping.
+ */
+export declare const exportTasksCommand: import("citty").CommandDef<{
+    readonly taskIds: {
+        readonly type: "positional";
+        readonly description: "Task IDs to export (space-separated; omit to export all)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output file path (stdout if omitted)";
+        readonly alias: "o";
+    };
+    readonly subtree: {
+        readonly type: "boolean";
+        readonly description: "Include all descendants of specified task(s)";
+        readonly default: false;
+    };
+    readonly filter: {
+        readonly type: "string";
+        readonly description: "Filter tasks by criteria (key=value)";
+    };
+    readonly 'include-deps': {
+        readonly type: "boolean";
+        readonly description: "Auto-include task dependencies";
+        readonly default: false;
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly description: "Preview selection without creating export file";
+        readonly default: false;
+    };
+}>;
+//# 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;AAKH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+D7B,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * 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 { defineCommand } from 'citty';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+/**
+ * Export tasks to a portable `.cleo-export.json` package for cross-project transfer.
+ *
+ * Dispatches to `admin.export` with `scope: 'tasks'`. When `--output` or `--dry-run`
+ * is provided the result goes through the standard LAFS formatter; otherwise the raw
+ * JSON content is written directly to stdout for piping.
+ */
+export const exportTasksCommand = defineCommand({
+    meta: {
+        name: 'export-tasks',
+        description: 'Export tasks to portable .cleo-export.json package for cross-project transfer',
+    },
+    args: {
+        taskIds: {
+            type: 'positional',
+            description: 'Task IDs to export (space-separated; omit to export all)',
+            required: false,
+        },
+        output: {
+            type: 'string',
+            description: 'Output file path (stdout if omitted)',
+            alias: 'o',
+        },
+        subtree: {
+            type: 'boolean',
+            description: 'Include all descendants of specified task(s)',
+            default: false,
+        },
+        filter: {
+            type: 'string',
+            description: 'Filter tasks by criteria (key=value)',
+        },
+        'include-deps': {
+            type: 'boolean',
+            description: 'Auto-include task dependencies',
+            default: false,
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Preview selection without creating export file',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const hasOutput = !!args.output;
+        const dryRun = args['dry-run'];
+        const params = {
+            taskIds: args.taskIds ? [args.taskIds] : undefined,
+            output: args.output,
+            subtree: args.subtree,
+            filter: args.filter,
+            includeDeps: args['include-deps'],
+            dryRun,
+            scope: 'tasks',
+        };
+        if (hasOutput || dryRun) {
+            await dispatchFromCli('query', 'admin', 'export', params, { command: 'export-tasks' });
+        }
+        else {
+            // No output file — write content directly to stdout for piping
+            const response = await dispatchRaw('query', 'admin', 'export', params);
+            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,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;IAC9C,IAAI,EAAE;QACJ,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,+EAA+E;KAC7F;IACD,IAAI,EAAE;QACJ,OAAO,EAAE;YACP,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,0DAA0D;YACvE,QAAQ,EAAE,KAAK;SAChB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;YACnD,KAAK,EAAE,GAAG;SACX;QACD,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8CAA8C;YAC3D,OAAO,EAAE,KAAK;SACf;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;SACpD;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gCAAgC;YAC7C,OAAO,EAAE,KAAK;SACf;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gDAAgD;YAC7D,OAAO,EAAE,KAAK;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAClD,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;YACjC,MAAM;YACN,KAAK,EAAE,OAAO;SACf,CAAC;QAEF,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvE,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;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * CLI export command — export tasks to various formats.
+ *
+ * Thin dispatch wrapper routing to admin.export.  When no --output file is
+ * given the raw content is written directly to stdout for piping.
+ *
+ * @task T4454, T5323, T5328
+ */
+/**
+ * `cleo export` — export tasks to CSV, TSV, JSON, or markdown format.
+ */
+export declare const exportCommand: import("citty").CommandDef<{
+    readonly 'export-format': {
+        readonly type: "string";
+        readonly description: "Export format: json, csv, tsv, markdown";
+        readonly default: "json";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output file path (stdout if omitted)";
+    };
+    readonly status: {
+        readonly type: "string";
+        readonly description: "Filter by status (comma-separated)";
+    };
+    readonly parent: {
+        readonly type: "string";
+        readonly description: "Filter by parent task";
+    };
+    readonly phase: {
+        readonly type: "string";
+        readonly description: "Filter by phase";
+    };
+}>;
+//# 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;;;;;;;GAOG;AAKH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EA0DxB,CAAC"}

package/dist/cli/commands/export.js

@@ -0,0 +1,68 @@
+/**
+ * CLI export command — export tasks to various formats.
+ *
+ * Thin dispatch wrapper routing to admin.export.  When no --output file is
+ * given the raw content is written directly to stdout for piping.
+ *
+ * @task T4454, T5323, T5328
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+/**
+ * `cleo export` — export tasks to CSV, TSV, JSON, or markdown format.
+ */
+export const exportCommand = defineCommand({
+    meta: { name: 'export', description: 'Export tasks to CSV, TSV, JSON, or markdown format' },
+    args: {
+        'export-format': {
+            type: 'string',
+            description: 'Export format: json, csv, tsv, markdown',
+            default: 'json',
+        },
+        output: {
+            type: 'string',
+            description: 'Output file path (stdout if omitted)',
+        },
+        status: {
+            type: 'string',
+            description: 'Filter by status (comma-separated)',
+        },
+        parent: {
+            type: 'string',
+            description: 'Filter by parent task',
+        },
+        phase: {
+            type: 'string',
+            description: 'Filter by phase',
+        },
+    },
+    async run({ args }) {
+        const hasOutput = !!args.output;
+        if (hasOutput) {
+            await dispatchFromCli('query', 'admin', 'export', {
+                format: args['export-format'],
+                output: args.output,
+                status: args.status,
+                parent: args.parent,
+                phase: args.phase,
+            }, { command: 'export' });
+        }
+        else {
+            // No output file — write content directly to stdout for piping.
+            const response = await dispatchRaw('query', 'admin', 'export', {
+                format: args['export-format'],
+                status: args.status,
+                parent: args.parent,
+                phase: args.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;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAE9F;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;IAC3F,IAAI,EAAE;QACJ,eAAe,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,OAAO,EAAE,MAAM;SAChB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;SACpD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oCAAoC;SAClD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uBAAuB;SACrC;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iBAAiB;SAC/B;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAEhC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR;gBACE,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;gBAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;aACxC,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAC7D,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;gBAC7B,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;aACxC,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;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,54 @@
+/** Native citty command for `cleo find [query]`. */
+export declare const findCommand: import("citty").CommandDef<{
+    readonly query: {
+        readonly type: "positional";
+        readonly description: "Search text (required unless --id is provided)";
+        readonly required: false;
+    };
+    readonly id: {
+        readonly type: "string";
+        readonly description: "Search by ID prefix";
+    };
+    readonly exact: {
+        readonly type: "boolean";
+        readonly description: "Exact title match";
+    };
+    readonly status: {
+        readonly type: "string";
+        readonly description: "Filter by status (pending|active|blocked|done|cancelled)";
+    };
+    readonly in: {
+        readonly type: "string";
+        readonly description: "Field to search in (title|description|notes|id)";
+    };
+    readonly 'include-archive': {
+        readonly type: "boolean";
+        readonly description: "Include archived tasks";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default: 20)";
+    };
+    readonly offset: {
+        readonly type: "string";
+        readonly description: "Skip first N results";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated additional fields to include";
+    };
+    readonly verbose: {
+        readonly type: "boolean";
+        readonly description: "Include all task fields";
+        readonly alias: "v";
+    };
+    /**
+     * Filter by task role axis (T944).
+     * Values: work | research | experiment | bug | spike | release
+     */
+    readonly role: {
+        readonly type: "string";
+        readonly description: "Filter by role axis (work|research|experiment|bug|spike|release) — T944";
+    };
+}>;
+//# 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":"AAWA,oDAAoD;AACpD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBpB;;;OAGG;;;;;EA6CL,CAAC"}

package/dist/cli/commands/find.js

@@ -0,0 +1,92 @@
+/**
+ * CLI find command
+ * @task T4460
+ * @task T4668
+ * @task T487
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { createPage } from '@cleocode/core';
+import { defineCommand } from 'citty';
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/** Native citty command for `cleo find [query]`. */
+export const findCommand = defineCommand({
+    meta: { name: 'find', description: 'Fuzzy search tasks by title/description' },
+    args: {
+        query: {
+            type: 'positional',
+            description: 'Search text (required unless --id is provided)',
+            required: false,
+        },
+        id: { type: 'string', description: 'Search by ID prefix' },
+        exact: { type: 'boolean', description: 'Exact title match' },
+        status: {
+            type: 'string',
+            description: 'Filter by status (pending|active|blocked|done|cancelled)',
+        },
+        in: { type: 'string', description: 'Field to search in (title|description|notes|id)' },
+        'include-archive': { type: 'boolean', description: 'Include archived tasks' },
+        limit: { type: 'string', description: 'Max results (default: 20)' },
+        offset: { type: 'string', description: 'Skip first N results' },
+        fields: { type: 'string', description: 'Comma-separated additional fields to include' },
+        verbose: { type: 'boolean', description: 'Include all task fields', alias: 'v' },
+        /**
+         * Filter by task role axis (T944).
+         * Values: work | research | experiment | bug | spike | release
+         */
+        role: {
+            type: 'string',
+            description: 'Filter by role axis (work|research|experiment|bug|spike|release) — T944',
+        },
+    },
+    async run({ args }) {
+        const limit = args.limit !== undefined ? Number.parseInt(args.limit, 10) : undefined;
+        const offset = args.offset !== undefined ? Number.parseInt(args.offset, 10) : undefined;
+        const params = {};
+        if (args.query !== undefined)
+            params['query'] = args.query;
+        if (args.id !== undefined)
+            params['id'] = args.id;
+        if (args.exact !== undefined)
+            params['exact'] = args.exact;
+        if (args.status !== undefined)
+            params['status'] = args.status;
+        if (args.in !== undefined)
+            params['field'] = args.in;
+        if (args['include-archive'] !== undefined)
+            params['includeArchive'] = args['include-archive'];
+        if (limit !== undefined)
+            params['limit'] = limit;
+        if (offset !== undefined)
+            params['offset'] = offset;
+        if (args.fields !== undefined)
+            params['fields'] = args.fields;
+        if (args.verbose !== undefined)
+            params['verbose'] = args.verbose;
+        // T944: role filter
+        if (args.role !== undefined)
+            params['role'] = args.role;
+        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/gc.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI command: cleo gc
+ *
+ * Manual GC trigger and status reporting.
+ *
+ * Subcommands:
+ *   cleo gc run     — manual GC trigger (blocking, for debugging/immediate need)
+ *   cleo gc status  — show last run stats, disk%, escalation state
+ *
+ * The GC engine checks disk pressure on `~/.cleo/` and prunes transcripts
+ * under `~/.claude/projects/` based on the five-tier threshold model.
+ *
+ * @see packages/core/src/gc/runner.ts for GC logic
+ * @see ADR-047 — Autonomous GC and Disk Safety
+ * @task T731
+ * @epic T726
+ */
+/**
+ * Root GC command group — transcript garbage collection manual trigger and status.
+ *
+ * Subcommands dispatch directly to the GC runner and state reader without
+ * going through the dispatch layer (GC is a local utility, not a domain operation).
+ */
+export declare const gcCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=gc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/gc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuIH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,qDAcpB,CAAC"}