@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/daemon.js

@@ -0,0 +1,223 @@
+/**
+ * CLI command group: cleo daemon — GC sidecar daemon management.
+ *
+ * Manages the CLEO GC sidecar daemon for autonomous transcript cleanup.
+ * The daemon is a node-cron v4 sidecar spawned as a detached Node.js process
+ * with file-based stdio. It persists across CLI invocations.
+ *
+ * Subcommands:
+ *   cleo daemon start  — spawn detached daemon background process
+ *   cleo daemon stop   — send SIGTERM to daemon (read PID from gc-state.json)
+ *   cleo daemon status — show PID, running state, last GC run, disk %
+ *
+ * Running `cleo daemon` without a subcommand is equivalent to `cleo daemon status`.
+ *
+ * @see packages/core/src/gc/daemon.ts for spawn implementation
+ * @see ADR-047 — Autonomous GC and Disk Safety
+ * @task T731
+ * @epic T726
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { getGCDaemonStatus, spawnGCDaemon, stopGCDaemon } from '@cleocode/core/gc/daemon.js';
+import { defineCommand } from 'citty';
+import { isSubCommandDispatch } from '../lib/subcommand-guard.js';
+/**
+ * Display the daemon status to stdout.
+ *
+ * @param cleoDir - Absolute path to the `.cleo/` directory
+ * @param json - Output as JSON when true
+ */
+async function showDaemonStatus(cleoDir, json) {
+    try {
+        const status = await getGCDaemonStatus(cleoDir);
+        const result = { success: true, data: status };
+        if (json) {
+            process.stdout.write(JSON.stringify(result) + '\n');
+        }
+        else {
+            const runningStr = status.running ? `running (PID ${status.pid})` : 'stopped';
+            process.stdout.write(`Daemon:       ${runningStr}\n`);
+            process.stdout.write(`Started at:   ${status.startedAt ?? 'never'}\n`);
+            process.stdout.write(`Last GC run:  ${status.lastRunAt ?? 'never'}\n`);
+            const diskStr = status.lastDiskUsedPct !== null ? `${status.lastDiskUsedPct.toFixed(1)}%` : 'unknown';
+            process.stdout.write(`Disk used:    ${diskStr}\n`);
+            if (status.escalationNeeded) {
+                process.stdout.write(`\nWARNING: Disk threshold breached. Run 'cleo gc run' to reclaim space.\n`);
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (json) {
+            process.stdout.write(JSON.stringify({ success: false, error: { code: 'E_INTERNAL', message } }) + '\n');
+        }
+        else {
+            process.stderr.write(`Error reading daemon status: ${message}\n`);
+        }
+        process.exit(1);
+    }
+}
+/** cleo daemon start — spawn the GC daemon as a detached background process */
+const startCommand = defineCommand({
+    meta: { name: 'start', description: 'Spawn the GC daemon as a detached background process' },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+        },
+    },
+    async run({ args }) {
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        const jsonMode = args.json ?? false;
+        try {
+            const status = await getGCDaemonStatus(cleoDir);
+            if (status.running && status.pid) {
+                const result = {
+                    success: false,
+                    data: {
+                        running: true,
+                        pid: status.pid,
+                        message: `Daemon already running (PID ${status.pid})`,
+                    },
+                };
+                if (jsonMode) {
+                    process.stdout.write(JSON.stringify(result) + '\n');
+                }
+                else {
+                    process.stdout.write(`Daemon already running (PID ${status.pid})\n`);
+                }
+                return;
+            }
+            const pid = await spawnGCDaemon(cleoDir);
+            const result = {
+                success: true,
+                data: { pid, cleoDir, message: `GC daemon started (PID ${pid})` },
+            };
+            if (jsonMode) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stdout.write(`GC daemon started (PID ${pid})\n`);
+                process.stdout.write(`Logs: ${join(cleoDir, 'logs', 'gc.log')}\n`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const result = { success: false, error: { code: 'E_INTERNAL', message } };
+            if (jsonMode) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stderr.write(`Error starting daemon: ${message}\n`);
+            }
+            process.exit(1);
+        }
+    },
+});
+/** cleo daemon stop — stop the GC daemon by sending SIGTERM to its PID */
+const stopCommand = defineCommand({
+    meta: { name: 'stop', description: 'Stop the GC daemon by sending SIGTERM to its PID' },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+        },
+    },
+    async run({ args }) {
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        const jsonMode = args.json ?? false;
+        try {
+            const stopResult = await stopGCDaemon(cleoDir);
+            const result = {
+                success: stopResult.stopped,
+                data: stopResult,
+            };
+            if (jsonMode) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else if (stopResult.stopped) {
+                process.stdout.write(`GC daemon stopped (${stopResult.reason})\n`);
+            }
+            else {
+                process.stdout.write(`${stopResult.reason}\n`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const result = { success: false, error: { code: 'E_INTERNAL', message } };
+            if (jsonMode) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stderr.write(`Error stopping daemon: ${message}\n`);
+            }
+            process.exit(1);
+        }
+    },
+});
+/** cleo daemon status — show daemon running state, PID, last GC run, and disk usage */
+const statusCommand = defineCommand({
+    meta: {
+        name: 'status',
+        description: 'Show daemon running state, PID, last GC run, and disk usage',
+    },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+        },
+    },
+    async run({ args }) {
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        await showDaemonStatus(cleoDir, args.json ?? false);
+    },
+});
+/**
+ * Root daemon command group.
+ *
+ * Manages the CLEO GC sidecar daemon (ADR-047). Running without a subcommand
+ * falls through to show status.
+ */
+export const daemonCommand = defineCommand({
+    meta: {
+        name: 'daemon',
+        description: 'Manage the CLEO GC sidecar daemon for autonomous transcript cleanup',
+    },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+        },
+    },
+    subCommands: {
+        start: startCommand,
+        stop: stopCommand,
+        status: statusCommand,
+    },
+    async run({ args, cmd, rawArgs }) {
+        // Parent run() fires after subcommand per citty@0.2.x — skip default
+        // status print so `cleo daemon start` doesn't also run status. T1187-followup.
+        if (isSubCommandDispatch(rawArgs, cmd.subCommands))
+            return;
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        await showDaemonStatus(cleoDir, args.json ?? false);
+    },
+});
+//# sourceMappingURL=daemon.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../../src/cli/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,IAAa;IAC5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAE/C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,UAAU,IAAI,CAAC,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC;YACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC;YACvE,MAAM,OAAO,GACX,MAAM,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,IAAI,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2EAA2E,CAC5E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,IAAI,CAClF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,OAAO,IAAI,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAC5F,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;SAC9C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;SACrC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,OAAO,GAAI,IAAI,CAAC,UAAU,CAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG;oBACb,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI;wBACb,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,OAAO,EAAE,+BAA+B,MAAM,CAAC,GAAG,GAAG;qBACtD;iBACF,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;gBACtD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;gBACvE,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG;gBACb,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,0BAA0B,GAAG,GAAG,EAAE;aAClE,CAAC;YAEF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC,CAAC;gBACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1E,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kDAAkD,EAAE;IACvF,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;SAC9C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;SACrC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,OAAO,GAAI,IAAI,CAAC,UAAU,CAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG;gBACb,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,IAAI,EAAE,UAAU;aACjB,CAAC;YAEF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1E,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,aAAa,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6DAA6D;KAC3E;IACD,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;SAC9C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;SACrC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,OAAO,GAAI,IAAI,CAAC,UAAU,CAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qEAAqE;KACnF;IACD,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;SAC9C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;SACrC;KACF;IACD,WAAW,EAAE;QACX,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,aAAa;KACtB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;QAC9B,qEAAqE;QACrE,+EAA+E;QAC/E,IAAI,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO;QAC3D,MAAM,OAAO,GAAI,IAAI,CAAC,UAAU,CAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * CLI command: cleo dash — project health dashboard.
+ *
+ * Dispatches to `admin.dash` to show status summary, phase progress,
+ * recent activity, and high-priority tasks. Use at session start for an
+ * overall project overview.
+ *
+ * @task T4535
+ * @epic T4454
+ */
+/**
+ * Project health dashboard command.
+ *
+ * Shows status summary, phase progress, recent activity, and high-priority
+ * tasks. Use for overall project status.
+ */
+export declare const dashCommand: import("citty").CommandDef<{
+    readonly 'blocked-limit': {
+        readonly type: "string";
+        readonly description: "Max blocked tasks to show";
+    };
+}>;
+//# sourceMappingURL=dash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dash.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;EA0BtB,CAAC"}

package/dist/cli/commands/dash.js

@@ -0,0 +1,38 @@
+/**
+ * CLI command: cleo dash — project health dashboard.
+ *
+ * Dispatches to `admin.dash` to show status summary, phase progress,
+ * recent activity, and high-priority tasks. Use at session start for an
+ * overall project overview.
+ *
+ * @task T4535
+ * @epic T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Project health dashboard command.
+ *
+ * Shows status summary, phase progress, recent activity, and high-priority
+ * tasks. Use for overall project status.
+ */
+export const dashCommand = defineCommand({
+    meta: {
+        name: 'dash',
+        description: 'Project health dashboard: status summary, phase progress, recent activity, high priority tasks. Use for overall project status.',
+    },
+    args: {
+        'blocked-limit': {
+            type: 'string',
+            description: 'Max blocked tasks to show',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'dash', {
+            blockedTasksLimit: args['blocked-limit'] !== undefined
+                ? Number.parseInt(args['blocked-limit'], 10)
+                : undefined,
+        }, { command: 'dash' });
+    },
+});
+//# sourceMappingURL=dash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dash.js","sourceRoot":"","sources":["../../../src/cli/commands/dash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,iIAAiI;KACpI;IACD,IAAI,EAAE;QACJ,eAAe,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2BAA2B;SACzC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,MAAM,EACN;YACE,iBAAiB,EACf,IAAI,CAAC,eAAe,CAAC,KAAK,SAAS;gBACjC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;gBAC5C,CAAC,CAAC,SAAS;SAChB,EACD,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI decomposition command - decomposition protocol validation.
+ * Routes through dispatch layer to check.protocol.decomposition.
+ * @task T4537
+ * @epic T4454
+ */
+/**
+ * Root decomposition command group — validates decomposition protocol compliance.
+ *
+ * Alias for `cleo check protocol decomposition`.
+ */
+export declare const decompositionCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=decomposition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposition.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/decomposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiFH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qDAe/B,CAAC"}

package/dist/cli/commands/decomposition.js

@@ -0,0 +1,92 @@
+/**
+ * CLI decomposition command - decomposition protocol validation.
+ * Routes through dispatch layer to check.protocol.decomposition.
+ * @task T4537
+ * @epic T4454
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo decomposition validate <taskId> — validate decomposition protocol for a task */
+const validateCommand = defineCommand({
+    meta: {
+        name: 'validate',
+        description: 'Validate decomposition protocol compliance for task',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to validate',
+            required: true,
+        },
+        strict: {
+            type: 'boolean',
+            description: 'Exit with error code on violations',
+        },
+        epic: {
+            type: 'string',
+            description: 'Specify parent epic ID',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'protocol', {
+            protocolType: 'decomposition',
+            mode: 'task',
+            taskId: args.taskId,
+            strict: args.strict,
+            epicId: args.epic,
+        }, { command: 'decomposition' });
+    },
+});
+/** cleo decomposition check <manifestFile> — validate manifest entry directly */
+const checkCommand = defineCommand({
+    meta: {
+        name: 'check',
+        description: 'Validate manifest entry directly',
+    },
+    args: {
+        manifestFile: {
+            type: 'positional',
+            description: 'Manifest file to validate',
+            required: true,
+        },
+        strict: {
+            type: 'boolean',
+            description: 'Exit with error code on violations',
+        },
+        epic: {
+            type: 'string',
+            description: 'Specify parent epic ID',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'protocol', {
+            protocolType: 'decomposition',
+            mode: 'manifest',
+            manifestFile: args.manifestFile,
+            strict: args.strict,
+            epicId: args.epic,
+        }, { command: 'decomposition' });
+    },
+});
+/**
+ * Root decomposition command group — validates decomposition protocol compliance.
+ *
+ * Alias for `cleo check protocol decomposition`.
+ */
+export const decompositionCommand = defineCommand({
+    meta: {
+        name: 'decomposition',
+        description: 'Validate decomposition protocol compliance (alias for `cleo check protocol decomposition`)',
+    },
+    subCommands: {
+        validate: validateCommand,
+        check: checkCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=decomposition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decomposition.js","sourceRoot":"","sources":["../../../src/cli/commands/decomposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,wFAAwF;AACxF,MAAM,eAAe,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,qDAAqD;KACnE;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACf;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oCAAoC;SAClD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kCAAkC;KAChD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE;YACZ,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,2BAA2B;YACxC,QAAQ,EAAE,IAAI;SACf;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oCAAoC;SAClD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wBAAwB;SACtC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;IAChD,IAAI,EAAE;QACJ,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,4FAA4F;KAC/F;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,KAAK,EAAE,YAAY;KACpB;IACD,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/delete.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI delete command — soft-delete a task to archive.
+ *
+ * Dispatches to the `tasks.delete` registry operation.
+ *
+ * @task T4461
+ * @epic T4454
+ */
+/**
+ * Delete command — soft-deletes the given task (archives it).
+ *
+ * Root alias `rm` is wired in index.ts.
+ */
+export declare const deleteCommand: import("citty").CommandDef<{
+    readonly taskId: {
+        readonly type: "positional";
+        readonly description: "ID of the task to delete";
+        readonly required: true;
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Force delete even with dependents or children";
+    };
+    readonly cascade: {
+        readonly type: "boolean";
+        readonly description: "Delete children recursively";
+    };
+}>;
+//# sourceMappingURL=delete.d.ts.map

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

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

package/dist/cli/commands/delete.js

@@ -0,0 +1,55 @@
+/**
+ * CLI delete command — soft-delete a task to archive.
+ *
+ * Dispatches to the `tasks.delete` registry operation.
+ *
+ * @task T4461
+ * @epic T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Delete command — soft-deletes the given task (archives it).
+ *
+ * Root alias `rm` is wired in index.ts.
+ */
+export const deleteCommand = defineCommand({
+    meta: {
+        name: 'delete',
+        description: 'Delete a task (soft delete to archive)',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'ID of the task to delete',
+            required: true,
+        },
+        force: {
+            type: 'boolean',
+            description: 'Force delete even with dependents or children',
+        },
+        cascade: {
+            type: 'boolean',
+            description: 'Delete children recursively',
+        },
+    },
+    async run({ args }) {
+        const response = await dispatchRaw('mutate', 'tasks', 'delete', {
+            taskId: args.taskId,
+            force: args.force,
+            cascade: args.cascade,
+        });
+        if (!response.success) {
+            handleRawError(response, { command: 'delete', operation: 'tasks.delete' });
+        }
+        const data = response.data;
+        const output = { deletedTask: data?.deletedTask };
+        const cascadeDeleted = data?.cascadeDeleted;
+        if (Array.isArray(cascadeDeleted) && cascadeDeleted.length > 0) {
+            output['cascadeDeleted'] = cascadeDeleted;
+        }
+        cliOutput(output, { command: 'delete', operation: 'tasks.delete' });
+    },
+});
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/cli/commands/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wCAAwC;KACtD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,0BAA0B;YACvC,QAAQ,EAAE,IAAI;SACf;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,+CAA+C;SAC7D;QACD,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6BAA6B;SAC3C;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;YAC9D,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAA4B;YACxC,OAAO,EAAE,IAAI,CAAC,OAA8B;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA2C,CAAC;QAClE,MAAM,MAAM,GAA4B,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC3E,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,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IACtE,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * CLI deps command for dependency visualization and analysis.
+ *
+ * Fix #69: The critical-path subcommand calls depsCriticalPath() from core
+ * directly instead of dispatching to query:orchestrate.critical.path, which was
+ * removed from the registry in T5615 (merged into orchestrate.analyze).
+ *
+ * @task T4464
+ * @epic T4454
+ */
+/**
+ * Root deps command group — dependency visualization and analysis.
+ *
+ * Subcommands: overview, show, waves, critical-path, impact, cycles.
+ */
+export declare const depsCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+/**
+ * Standalone tree command — task hierarchy tree visualization.
+ *
+ * @remarks
+ * Kept as a separate export so that index.ts can wire it to `cleo tree`.
+ *
+ * Flags:
+ * - `--with-deps`  — inline each task's direct dependency chain below the task line.
+ * - `--blockers`   — render transitive blocker chain + leaf blockers for every
+ *                    blocked task in the tree.
+ */
+export declare const treeCommand: import("citty").CommandDef<{
+    readonly rootId: {
+        readonly type: "positional";
+        readonly description: "Root task ID (optional)";
+        readonly required: false;
+    };
+    readonly withDeps: {
+        readonly type: "boolean";
+        readonly description: "Inline dependency chain below each task that has deps";
+        readonly default: false;
+    };
+    readonly blockers: {
+        readonly type: "boolean";
+        readonly description: "Render transitive blocker chain and leaf blockers below each blocked task";
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2IH;;;;GAIG;AACH,eAAO,MAAM,WAAW,qDAetB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;EA8BtB,CAAC"}