@cleocode/cleo 2026.2.5

package/dist/cli/commands/backup.js

@@ -0,0 +1,122 @@
+/**
+ * CLI backup command - add and list backups.
+ * @task T4454
+ */
+import { formatError } from '../../core/output.js';
+import { cliOutput } from '../renderers/index.js';
+import { CleoError } from '../../core/errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { createBackup, listBackups } from '../../store/backup.js';
+import { getTaskPath, getConfigPath, getArchivePath, getLogPath, getBackupDir } from '../../core/paths.js';
+import { access } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+async function fileExists(path) {
+    try {
+        await access(path, fsConstants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function registerBackupCommand(program) {
+    const backup = program
+        .command('backup')
+        .description('Add backup of todo files or list available backups');
+    backup
+        .command('add')
+        .alias('create')
+        .description('Add a new backup of all CLEO data files')
+        .option('--destination <dir>', 'Backup destination directory')
+        .action(async (opts) => {
+        try {
+            const backupDir = opts['destination'] || getBackupDir();
+            const files = [
+                getTaskPath(),
+                getConfigPath(),
+                getArchivePath(),
+                getLogPath(),
+            ];
+            const backed = [];
+            const skipped = [];
+            for (const file of files) {
+                if (await fileExists(file)) {
+                    const path = await createBackup(file, backupDir);
+                    backed.push(path);
+                }
+                else {
+                    skipped.push(file);
+                }
+            }
+            cliOutput({
+                created: true,
+                backupDir,
+                backedUp: backed.length,
+                skipped: skipped.length,
+                files: backed,
+            }, { command: 'backup' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    backup
+        .command('list')
+        .description('List available backups')
+        .action(async () => {
+        try {
+            const backupDir = getBackupDir();
+            const dataFiles = ['tasks.json', 'config.json', 'tasks-archive.json', 'tasks-log.jsonl'];
+            const allBackups = [];
+            for (const fileName of dataFiles) {
+                const backups = await listBackups(fileName, backupDir);
+                if (backups.length > 0) {
+                    allBackups.push({ file: fileName, backups });
+                }
+            }
+            cliOutput({
+                backupDir,
+                files: allBackups,
+                totalBackups: allBackups.reduce((sum, f) => sum + f.backups.length, 0),
+            }, { command: 'backup' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    // Default action: add backup
+    backup
+        .action(async () => {
+        try {
+            const backupDir = getBackupDir();
+            const todoPath = getTaskPath();
+            if (await fileExists(todoPath)) {
+                const path = await createBackup(todoPath, backupDir);
+                cliOutput({
+                    created: true,
+                    backupDir,
+                    file: path,
+                }, { command: 'backup' });
+            }
+            else {
+                throw new CleoError(ExitCode.NOT_FOUND, 'No tasks.json to backup');
+            }
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=backup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3G,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAEnD,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC,CAAC;IAErE,MAAM;SACH,OAAO,CAAC,KAAK,CAAC;SACd,KAAK,CAAC,QAAQ,CAAC;SACf,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,SAAS,GAAI,IAAI,CAAC,aAAa,CAAY,IAAI,YAAY,EAAE,CAAC;YACpE,MAAM,KAAK,GAAG;gBACZ,WAAW,EAAE;gBACb,aAAa,EAAE;gBACf,cAAc,EAAE;gBAChB,UAAU,EAAE;aACb,CAAC;YAEF,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBACjD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,SAAS,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACvB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,KAAK,EAAE,MAAM;aACd,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;YAEzF,MAAM,UAAU,GAA+C,EAAE,CAAC;YAElE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;YAED,SAAS,CAAC;gBACR,SAAS;gBACT,KAAK,EAAE,UAAU;gBACjB,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;aACvE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,6BAA6B;IAC7B,MAAM;SACH,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;YAE/B,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACrD,SAAS,CAAC;oBACR,OAAO,EAAE,IAAI;oBACb,SAAS;oBACT,IAAI,EAAE,IAAI;iBACX,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * CLI blockers command - show blocked tasks and analyze blocking chains.
+ * @task T4454
+ */
+import { Command } from 'commander';
+export declare function registerBlockersCommand(program: Command): void;
+//# sourceMappingURL=blockers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/blockers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuF9D"}

package/dist/cli/commands/blockers.js

@@ -0,0 +1,107 @@
+/**
+ * CLI blockers command - show blocked tasks and analyze blocking chains.
+ * @task T4454
+ */
+import { formatError } from '../../core/output.js';
+import { CleoError } from '../../core/errors.js';
+import { cliOutput } from '../renderers/index.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getAccessor } from '../../store/data-accessor.js';
+/**
+ * Build the blocking chain for a task (recursive).
+ */
+function buildBlockingChain(task, taskMap, visited = new Set()) {
+    const chain = [];
+    if (visited.has(task.id))
+        return chain;
+    visited.add(task.id);
+    if (task.depends) {
+        for (const depId of task.depends) {
+            const dep = taskMap.get(depId);
+            if (dep && dep.status !== 'done' && dep.status !== 'cancelled') {
+                chain.push(depId);
+                chain.push(...buildBlockingChain(dep, taskMap, visited));
+            }
+        }
+    }
+    return chain;
+}
+export function registerBlockersCommand(program) {
+    program
+        .command('blockers')
+        .description('Show blocked tasks and analyze blocking chains')
+        .option('--analyze', 'Show full blocking chain analysis')
+        .action(async (opts) => {
+        try {
+            const accessor = await getAccessor();
+            const data = await accessor.loadTaskFile();
+            const taskMap = new Map(data.tasks.map((t) => [t.id, t]));
+            // Find blocked tasks
+            const blockedTasks = data.tasks.filter((t) => t.status === 'blocked');
+            // Find tasks with unsatisfied dependencies
+            const depBlockedTasks = data.tasks.filter((t) => t.status === 'pending' &&
+                t.depends &&
+                t.depends.length > 0 &&
+                t.depends.some((depId) => {
+                    const dep = taskMap.get(depId);
+                    return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+                }));
+            const analyze = !!opts['analyze'];
+            const blockerInfos = [
+                ...blockedTasks.map((t) => ({
+                    id: t.id,
+                    title: t.title,
+                    status: t.status,
+                    blockedBy: t.blockedBy,
+                    depends: t.depends,
+                    blockingChain: analyze ? buildBlockingChain(t, taskMap) : [],
+                })),
+                ...depBlockedTasks
+                    .filter((t) => !blockedTasks.some((bt) => bt.id === t.id))
+                    .map((t) => ({
+                    id: t.id,
+                    title: t.title,
+                    status: t.status,
+                    depends: t.depends,
+                    blockingChain: analyze ? buildBlockingChain(t, taskMap) : [],
+                })),
+            ];
+            // Find critical blockers (tasks that block the most others)
+            const blockerCounts = new Map();
+            for (const info of blockerInfos) {
+                for (const depId of info.blockingChain) {
+                    blockerCounts.set(depId, (blockerCounts.get(depId) ?? 0) + 1);
+                }
+            }
+            const criticalBlockers = [...blockerCounts.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([id, count]) => {
+                const task = taskMap.get(id);
+                return { id, title: task?.title ?? 'Unknown', blocksCount: count };
+            });
+            if (blockerInfos.length === 0) {
+                cliOutput({
+                    blockedTasks: [],
+                    criticalBlockers: [],
+                    summary: 'No blocked tasks found',
+                }, { command: 'blockers', operation: 'tasks.blockers' });
+                process.exit(ExitCode.NO_DATA);
+                return;
+            }
+            cliOutput({
+                blockedTasks: blockerInfos,
+                criticalBlockers,
+                summary: `${blockerInfos.length} blocked task(s)`,
+            }, { command: 'blockers', operation: 'tasks.blockers' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=blockers.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * CLI checkpoint command - Git state checkpoint for CLEO data files.
+ * Ported from scripts/checkpoint.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { Command } from 'commander';
+/**
+ * Register the checkpoint command.
+ * @task T4551
+ */
+export declare function registerCheckpointCommand(program: Command): void;
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwIpC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2EhE"}

package/dist/cli/commands/checkpoint.js

@@ -0,0 +1,185 @@
+/**
+ * CLI checkpoint command - Git state checkpoint for CLEO data files.
+ * Ported from scripts/checkpoint.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { formatError } from '../../core/output.js';
+import { cliOutput } from '../renderers/index.js';
+import { CleoError } from '../../core/errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getCleoDir, getConfigPath } from '../../core/paths.js';
+import { readJson } from '../../store/json.js';
+/**
+ * Tracked CLEO state files for checkpointing.
+ * @task T4551
+ */
+const CHECKPOINT_FILES = [
+    'tasks.json',
+    'tasks-log.jsonl',
+    'tasks-archive.json',
+    'config.json',
+    'sessions.json',
+];
+const DEFAULT_CONFIG = {
+    enabled: true,
+    debounceMinutes: 5,
+    messagePrefix: 'chore(cleo):',
+    noVerify: true,
+};
+/**
+ * Load checkpoint configuration from config.json.
+ * @task T4551
+ */
+async function loadCheckpointConfig() {
+    try {
+        const configPath = getConfigPath();
+        const config = await readJson(configPath);
+        if (!config)
+            return DEFAULT_CONFIG;
+        const gc = config['gitCheckpoint'];
+        if (!gc)
+            return DEFAULT_CONFIG;
+        return {
+            enabled: gc['enabled'] !== false,
+            debounceMinutes: typeof gc['debounceMinutes'] === 'number' ? gc['debounceMinutes'] : DEFAULT_CONFIG.debounceMinutes,
+            messagePrefix: typeof gc['messagePrefix'] === 'string' ? gc['messagePrefix'] : DEFAULT_CONFIG.messagePrefix,
+            noVerify: gc['noVerify'] !== false,
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+/**
+ * Check if inside a git repository.
+ * @task T4551
+ */
+function isGitRepo() {
+    try {
+        execFileSync('git', ['rev-parse', '--git-dir'], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get changed CLEO files from git status.
+ * @task T4551
+ */
+function getChangedCleoFiles() {
+    const cleoDir = getCleoDir();
+    const changed = [];
+    for (const file of CHECKPOINT_FILES) {
+        const filePath = join(cleoDir, file);
+        try {
+            const status = execFileSync('git', ['status', '--porcelain', filePath], { encoding: 'utf-8' }).trim();
+            if (status.length > 0) {
+                changed.push(filePath);
+            }
+        }
+        catch {
+            // File doesn't exist or git error - skip
+        }
+    }
+    return changed;
+}
+/**
+ * Get last checkpoint timestamp from git log.
+ * @task T4551
+ */
+function getLastCheckpointTime(prefix) {
+    try {
+        const result = execFileSync('git', ['log', '--oneline', '--format=%aI', `--grep=${prefix}`, '-1'], { encoding: 'utf-8' }).trim();
+        return result || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Perform a git checkpoint commit.
+ * @task T4551
+ */
+function performCheckpoint(files, config) {
+    if (files.length === 0)
+        return;
+    for (const file of files) {
+        execFileSync('git', ['add', file], { stdio: 'ignore' });
+    }
+    const commitArgs = ['commit', '-m', `${config.messagePrefix} auto checkpoint`];
+    if (config.noVerify) {
+        commitArgs.push('--no-verify');
+    }
+    execFileSync('git', commitArgs, { stdio: 'ignore' });
+}
+/**
+ * Register the checkpoint command.
+ * @task T4551
+ */
+export function registerCheckpointCommand(program) {
+    program
+        .command('checkpoint')
+        .description('Git checkpoint for CLEO state files')
+        .option('--status', 'Show configuration and last checkpoint time')
+        .option('--dry-run', 'Show what files would be committed')
+        .action(async (opts) => {
+        try {
+            if (!isGitRepo()) {
+                throw new CleoError(ExitCode.GENERAL_ERROR, 'Not a git repository');
+            }
+            const config = await loadCheckpointConfig();
+            if (opts['status']) {
+                const lastCheckpoint = getLastCheckpointTime(config.messagePrefix);
+                const changedFiles = getChangedCleoFiles();
+                cliOutput({
+                    config: {
+                        enabled: config.enabled,
+                        debounceMinutes: config.debounceMinutes,
+                        messagePrefix: config.messagePrefix,
+                        noVerify: config.noVerify,
+                    },
+                    lastCheckpoint,
+                    pendingFiles: changedFiles.length,
+                    changedFiles,
+                }, { command: 'checkpoint' });
+                return;
+            }
+            if (opts['dryRun']) {
+                const changedFiles = getChangedCleoFiles();
+                cliOutput({
+                    dryRun: true,
+                    wouldCommit: changedFiles,
+                    fileCount: changedFiles.length,
+                }, { command: 'checkpoint', message: changedFiles.length === 0 ? 'No CLEO files to checkpoint' : `Would checkpoint ${changedFiles.length} file(s)` });
+                return;
+            }
+            // Force checkpoint mode
+            if (!config.enabled) {
+                cliOutput({ enabled: false }, { command: 'checkpoint', message: 'Git checkpoint is disabled. Enable with: cleo config set gitCheckpoint.enabled true' });
+                return;
+            }
+            const changedFiles = getChangedCleoFiles();
+            if (changedFiles.length === 0) {
+                cliOutput({ noChange: true }, { command: 'checkpoint', message: 'No CLEO files to checkpoint' });
+                return;
+            }
+            performCheckpoint(changedFiles, config);
+            cliOutput({
+                checkpointed: changedFiles.length,
+                files: changedFiles,
+            }, { command: 'checkpoint', message: 'Checkpoint complete' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=checkpoint.js.map

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

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

package/dist/cli/commands/claude-migrate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI claude-migrate command - detect and migrate legacy installations.
+ * Ported from scripts/claude-migrate.sh
+ * @task T4551
+ * @epic T4545
+ */
+import { Command } from 'commander';
+/**
+ * Register the claude-migrate command.
+ * @task T4551
+ */
+export declare function registerClaudeMigrateCommand(program: Command): void;
+//# sourceMappingURL=claude-migrate.d.ts.map

package/dist/cli/commands/claude-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-migrate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/claude-migrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4TpC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgFnE"}