@cleocode/cleo 2026.4.10 → 2026.4.12

package/dist/cli/commands/restore.js

@@ -0,0 +1,228 @@
+/**
+ * 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
+ * @task T306 — added --scope flag to restore backup (epic T299)
+ */
+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')
+        .option('--scope <scope>', 'Backup scope to restore from: project or global (default: project)', 'project')
+        .action(async (opts) => {
+        try {
+            const fileName = opts['file'] || 'tasks.db';
+            const scope = opts['scope'] || 'project';
+            const response = await dispatchRaw('mutate', 'admin', 'backup', {
+                action: 'restore',
+                file: fileName,
+                dryRun: opts['dryRun'],
+                scope,
+            });
+            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/schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI `schema` command — operation introspection for agents.
+ *
+ * Allows agents to inspect the full parameter signature and declared precondition
+ * gates for any CLEO operation before calling it, replacing trial-and-error.
+ *
+ * Usage:
+ *   cleo schema <domain.operation>
+ *   cleo schema tasks.add
+ *   cleo schema tasks.add --format human
+ *   cleo schema tasks.add --include-examples
+ *
+ * @task T340
+ * @epic T335
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the `cleo schema <operation>` command.
+ *
+ * @param program - The root ShimCommand to register against.
+ *
+ * @remarks
+ * Does NOT dispatch through the main dispatcher — schema introspection is
+ * pure metadata over the registry and does not require a live session or DB.
+ */
+export declare function registerSchemaCommand(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAoGnE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyD5D"}

package/dist/cli/commands/schema.js

@@ -0,0 +1,160 @@
+/**
+ * CLI `schema` command — operation introspection for agents.
+ *
+ * Allows agents to inspect the full parameter signature and declared precondition
+ * gates for any CLEO operation before calling it, replacing trial-and-error.
+ *
+ * Usage:
+ *   cleo schema <domain.operation>
+ *   cleo schema tasks.add
+ *   cleo schema tasks.add --format human
+ *   cleo schema tasks.add --include-examples
+ *
+ * @task T340
+ * @epic T335
+ */
+import { describeOperation } from '@cleocode/lafs';
+import { OPERATIONS } from '../../dispatch/registry.js';
+import { cliError, cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the target `OperationDef` from a `"domain.operation"` key.
+ *
+ * @param operationArg - The user-supplied string (e.g. `"tasks.add"`).
+ * @returns The matching `OperationDef`, or `null` if not found.
+ *
+ * @remarks
+ * The first dot separates domain from operation, so dotted operation names
+ * like `"complexity.estimate"` are handled correctly.
+ */
+function resolveOperationDef(operationArg) {
+    const dotIdx = operationArg.indexOf('.');
+    if (dotIdx === -1) {
+        // No domain separator — search all domains for unambiguous match
+        const matches = OPERATIONS.filter((op) => op.operation === operationArg);
+        if (matches.length === 1) {
+            return matches[0] ?? null;
+        }
+        return null;
+    }
+    const domain = operationArg.slice(0, dotIdx);
+    const operation = operationArg.slice(dotIdx + 1);
+    return OPERATIONS.find((op) => op.domain === domain && op.operation === operation) ?? null;
+}
+/**
+ * Format an `OperationSchema` as a human-readable summary table.
+ *
+ * @param schema - The operation schema to render.
+ * @returns Multi-line human-readable string.
+ */
+function renderSchemaHuman(schema) {
+    const lines = [];
+    lines.push(`Operation : ${schema.operation}`);
+    lines.push(`Gateway   : ${schema.gateway}`);
+    lines.push(`Description: ${schema.description}`);
+    lines.push('');
+    lines.push('Parameters:');
+    if (schema.params.length === 0) {
+        lines.push('  (none declared)');
+    }
+    else {
+        for (const p of schema.params) {
+            const req = p.required ? '[required]' : '[optional]';
+            const enumStr = p.enum ? `  enum: ${p.enum.join(' | ')}` : '';
+            let cliStr = '';
+            if (p.cli) {
+                const parts = [];
+                if (p.cli.positional)
+                    parts.push('positional');
+                if (p.cli.short)
+                    parts.push(`short: ${p.cli.short}`);
+                if (p.cli.flag)
+                    parts.push(`flag: --${p.cli.flag}`);
+                if (parts.length > 0)
+                    cliStr = `  cli: ${parts.join(', ')}`;
+            }
+            lines.push(`  ${p.name} (${p.type}) ${req}`);
+            lines.push(`    ${p.description}${enumStr}${cliStr}`);
+        }
+    }
+    if (schema.gates !== undefined) {
+        lines.push('');
+        lines.push('Gates:');
+        if (schema.gates.length === 0) {
+            lines.push('  (none declared — see note on static gate table)');
+        }
+        else {
+            for (const g of schema.gates) {
+                lines.push(`  ${g.name} → ${g.errorCode}`);
+                lines.push(`    ${g.description}`);
+                for (const t of g.triggers) {
+                    lines.push(`    - ${t}`);
+                }
+            }
+        }
+    }
+    if (schema.examples !== undefined && schema.examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        for (const ex of schema.examples) {
+            lines.push(`  ${ex.command}`);
+            lines.push(`    ${ex.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `cleo schema <operation>` command.
+ *
+ * @param program - The root ShimCommand to register against.
+ *
+ * @remarks
+ * Does NOT dispatch through the main dispatcher — schema introspection is
+ * pure metadata over the registry and does not require a live session or DB.
+ */
+export function registerSchemaCommand(program) {
+    program
+        .command('schema <operation>')
+        .description('Introspect a CLEO operation: show params, types, enums, and declared gates')
+        .option('--format <format>', 'Output format: json (default) or human (pretty table)', 'json')
+        .option('--include-gates', 'Include precondition gates in output (default: true)')
+        .option('--no-include-gates', 'Exclude precondition gates from output')
+        .option('--include-examples', 'Include usage examples in output (default: false)')
+        .action(async (operationArg, opts) => {
+        const format = opts.format ?? 'json';
+        // When --no-include-gates is passed, Commander sets includeGates=false
+        const includeGates = opts.includeGates !== false;
+        const includeExamples = opts.includeExamples === true;
+        // Resolve operation from registry
+        const def = resolveOperationDef(operationArg);
+        if (def === null) {
+            cliError(`Unknown operation: "${operationArg}". Run \`cleo schema --list\` to see all operations.`, 4, {
+                name: 'E_NOT_FOUND',
+                fix: 'cleo schema --list',
+            });
+            process.exit(4);
+            return;
+        }
+        // Build schema via LAFS discovery
+        const schema = describeOperation(def, {
+            includeGates,
+            includeExamples,
+        });
+        if (format === 'human') {
+            console.log(renderSchemaHuman(schema));
+            return;
+        }
+        // JSON output — go through cliOutput for LAFS envelope compliance
+        cliOutput(schema, {
+            command: 'schema',
+            operation: `schema.${operationArg}`,
+            message: `Schema for ${schema.operation}`,
+        });
+    });
+}
+//# sourceMappingURL=schema.js.map

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

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

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"}