@cleocode/cleo 2026.4.9 → 2026.4.11

package/dist/cli/commands/restore.js

@@ -0,0 +1,224 @@
+/**
+ * CLI restore command - universal restoration (backup, archived, cancelled, completed tasks).
+ * Delegates to dispatch operations (tasks.restore, admin.backup.restore).
+ * @task T4454
+ * @task T4795
+ * @task T4904
+ * @task T5329
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError, formatError, getAccessor } from '@cleocode/core';
+import { dispatchRaw } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+export function registerRestoreCommand(program) {
+    const restoreCmd = program
+        .command('restore')
+        .description('Restore from backup or restore tasks from terminal states (archived, cancelled, completed)');
+    // Subcommand: restore backup
+    restoreCmd
+        .command('backup')
+        .description('Restore todo files from backup')
+        .option('--file <name>', 'Specific file to restore (tasks.db, config.json, etc.)')
+        .option('--dry-run', 'Preview what would be restored')
+        .action(async (opts) => {
+        try {
+            const fileName = opts['file'] || 'tasks.db';
+            const response = await dispatchRaw('mutate', 'admin', 'backup', {
+                action: 'restore',
+                file: fileName,
+                dryRun: opts['dryRun'],
+            });
+            if (!response.success) {
+                const code = ExitCode[response.error?.code] ?? ExitCode.GENERAL_ERROR;
+                throw new CleoError(code, response.error?.message ?? 'Backup restore failed');
+            }
+            const data = response.data;
+            if (opts['dryRun']) {
+                cliOutput({
+                    dryRun: true,
+                    file: fileName,
+                    wouldRestore: data?.from,
+                    targetPath: data?.targetPath,
+                }, {
+                    command: 'restore',
+                    message: 'Dry run - no changes made',
+                    operation: 'admin.backup.restore',
+                });
+                return;
+            }
+            cliOutput({
+                restored: true,
+                file: fileName,
+                restoredFrom: data?.from,
+                targetPath: data?.targetPath,
+            }, { command: 'restore', operation: 'admin.backup.restore' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    // Universal task restore - handles archived, cancelled, and completed tasks
+    restoreCmd
+        .command('task <task-id>')
+        .description('Restore task from terminal state (archived, cancelled, or completed) back to active')
+        .option('--status <status>', 'Status to restore task as (default: pending)', 'pending')
+        .option('--preserve-status', 'Keep the original task status')
+        .option('--reason <reason>', 'Reason for restoring/reopening the task')
+        .option('--dry-run', 'Preview changes without applying')
+        .action(async (taskId, opts) => {
+        try {
+            const idPattern = /^T\d{3,}$/;
+            if (!idPattern.test(taskId)) {
+                throw new CleoError(ExitCode.INVALID_INPUT, `Invalid task ID: ${taskId}`);
+            }
+            const accessor = await getAccessor();
+            // First, check if task exists in active tasks
+            const activeTask = await accessor.loadSingleTask(taskId);
+            if (activeTask) {
+                // Task is active but might be in terminal state (cancelled, done)
+                if (activeTask.status === 'cancelled') {
+                    if (opts['dryRun']) {
+                        cliOutput({
+                            dryRun: true,
+                            taskId,
+                            title: activeTask.title,
+                            previousStatus: activeTask.status,
+                            newStatus: opts['preserveStatus']
+                                ? activeTask.status
+                                : opts['status'],
+                            source: 'active-tasks',
+                        }, {
+                            command: 'restore',
+                            message: 'Dry run - no changes made',
+                            operation: 'tasks.restore',
+                        });
+                        return;
+                    }
+                    const response = await dispatchRaw('mutate', 'tasks', 'restore', { taskId });
+                    if (!response.success) {
+                        const code = ExitCode[response.error?.code] ?? ExitCode.GENERAL_ERROR;
+                        throw new CleoError(code, response.error?.message ?? 'Task restore failed');
+                    }
+                    const resultData = response.data;
+                    cliOutput({
+                        restored: true,
+                        taskId: resultData?.task,
+                        count: resultData?.count,
+                        source: 'active-tasks',
+                    }, { command: 'restore', operation: 'tasks.restore' });
+                    return;
+                }
+                else if (activeTask.status === 'done') {
+                    if (opts['dryRun']) {
+                        const newStatus = opts['preserveStatus']
+                            ? activeTask.status
+                            : opts['status'];
+                        cliOutput({
+                            dryRun: true,
+                            taskId,
+                            title: activeTask.title,
+                            previousStatus: activeTask.status,
+                            newStatus,
+                            source: 'active-tasks',
+                        }, {
+                            command: 'restore',
+                            message: 'Dry run - no changes made',
+                            operation: 'tasks.restore',
+                        });
+                        return;
+                    }
+                    const targetStatus = opts['preserveStatus'] ? undefined : opts['status'];
+                    const response = await dispatchRaw('mutate', 'tasks', 'restore', {
+                        taskId,
+                        from: 'done',
+                        status: targetStatus,
+                        reason: opts['reason'],
+                    });
+                    if (!response.success) {
+                        const code = ExitCode[response.error?.code] ?? ExitCode.GENERAL_ERROR;
+                        throw new CleoError(code, response.error?.message ?? 'Task restore failed');
+                    }
+                    const resultData = response.data;
+                    cliOutput({
+                        restored: true,
+                        taskId: resultData?.task,
+                        previousStatus: resultData?.previousStatus,
+                        newStatus: resultData?.newStatus,
+                        source: 'active-tasks',
+                    }, { command: 'restore', operation: 'tasks.restore' });
+                    return;
+                }
+                else {
+                    throw new CleoError(ExitCode.VALIDATION_ERROR, `Task ${taskId} is already active with status: ${activeTask.status}`);
+                }
+            }
+            // Task not in active list - check archive
+            if (opts['dryRun']) {
+                const archiveData = await accessor.loadArchive();
+                if (archiveData) {
+                    const archivedTasks = archiveData.archivedTasks;
+                    if (Array.isArray(archivedTasks)) {
+                        const task = archivedTasks.find((t) => t.id === taskId);
+                        if (task) {
+                            cliOutput({
+                                dryRun: true,
+                                taskId,
+                                title: task.title,
+                                previousStatus: task.status,
+                                newStatus: opts['preserveStatus'] ? task.status : opts['status'],
+                                source: 'archive',
+                            }, {
+                                command: 'restore',
+                                message: 'Dry run - no changes made',
+                                operation: 'tasks.restore',
+                            });
+                            return;
+                        }
+                    }
+                }
+                throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found in active tasks or archive`, {
+                    fix: `cleo find "${taskId}" to search for the task`,
+                });
+            }
+            // Delegate to unarchive via dispatch
+            try {
+                const targetStatus = opts['preserveStatus'] ? undefined : opts['status'];
+                const response = await dispatchRaw('mutate', 'tasks', 'restore', {
+                    taskId,
+                    from: 'archive',
+                    status: targetStatus,
+                    preserveStatus: !!opts['preserveStatus'],
+                });
+                if (!response.success) {
+                    const code = ExitCode[response.error?.code] ?? ExitCode.GENERAL_ERROR;
+                    throw new CleoError(code, response.error?.message ?? 'Task unarchive failed');
+                }
+                const resultData = response.data;
+                cliOutput({
+                    restored: true,
+                    taskId: resultData?.task,
+                    title: resultData?.title,
+                    newStatus: resultData?.status,
+                    source: 'archive',
+                }, { command: 'restore', operation: 'tasks.restore' });
+            }
+            catch {
+                throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found in active tasks or archive`, {
+                    fix: `cleo find "${taskId}" to search for the task`,
+                });
+            }
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=restore.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * CLI roadmap command - roadmap generation from pending epics and changelog.
+ * @task T4538
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerRoadmapCommand(program: Command): void;
+//# sourceMappingURL=roadmap.d.ts.map

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

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

package/dist/cli/commands/roadmap.js

@@ -0,0 +1,21 @@
+/**
+ * CLI roadmap command - roadmap generation from pending epics and changelog.
+ * @task T4538
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerRoadmapCommand(program) {
+    program
+        .command('roadmap')
+        .description('Generate roadmap from pending epics and CHANGELOG history')
+        .option('--include-history', 'Include release history from CHANGELOG')
+        .option('--upcoming-only', 'Only show upcoming/planned releases')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'dash', {
+            type: 'roadmap',
+            includeHistory: opts['includeHistory'],
+            upcomingOnly: opts['upcomingOnly'],
+        }, { command: 'roadmap' });
+    });
+}
+//# sourceMappingURL=roadmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.js","sourceRoot":"","sources":["../../../src/cli/commands/roadmap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,CAAC;SACrE,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,MAAM,EACN;YACE,IAAI,EAAE,SAAS;YACf,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;YACtC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;SACnC,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * CLI safestop command - graceful shutdown for agents approaching context limits.
+ * Ported from scripts/safestop.sh
+ * @task T4551
+ * @epic T4545
+ * @task T4904
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the safestop command.
+ * @task T4551
+ */
+export declare function registerSafestopCommand(program: Command): void;
+//# sourceMappingURL=safestop.d.ts.map

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

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

package/dist/cli/commands/safestop.js

@@ -0,0 +1,32 @@
+/**
+ * CLI safestop command - graceful shutdown for agents approaching context limits.
+ * Ported from scripts/safestop.sh
+ * @task T4551
+ * @epic T4545
+ * @task T4904
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the safestop command.
+ * @task T4551
+ */
+export function registerSafestopCommand(program) {
+    program
+        .command('safestop')
+        .description('Graceful shutdown for agents approaching context limits')
+        .requiredOption('--reason <reason>', 'Reason for stopping')
+        .option('--commit', 'Commit pending git changes with WIP message')
+        .option('--handoff <file>', 'Generate handoff document (use - for stdout)')
+        .option('--no-session-end', 'Update notes but do not end session')
+        .option('--dry-run', 'Show actions without executing')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'admin', 'safestop', {
+            reason: opts['reason'],
+            commit: opts['commit'],
+            handoff: opts['handoff'],
+            noSessionEnd: opts['sessionEnd'] === false,
+            dryRun: opts['dryRun'],
+        }, { command: 'safestop', operation: 'admin.safestop' });
+    });
+}
+//# sourceMappingURL=safestop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safestop.js","sourceRoot":"","sources":["../../../src/cli/commands/safestop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yDAAyD,CAAC;SACtE,cAAc,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;SAC1D,MAAM,CAAC,UAAU,EAAE,6CAA6C,CAAC;SACjE,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,CAAC;SAC1E,MAAM,CAAC,kBAAkB,EAAE,qCAAqC,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,gCAAgC,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV;YACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;YACxB,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK;YAC1C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/self-update.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI self-update command - check for and install updates.
+ *
+ * After updating, runs post-update diagnostics:
+ *   - Pre-flight storage migration check
+ *   - Auto-triggers upgrade if JSON data needs SQLite migration
+ *
+ * Designed for LLM agents: structured JSON output, actionable fix commands.
+ *
+ * @task T4699
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerSelfUpdateCommand(program: Command): void;
+//# sourceMappingURL=self-update.d.ts.map

package/dist/cli/commands/self-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/self-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA8EnE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmMhE"}