@claude-flow/cli 3.5.43 → 3.5.44

package/dist/src/commands/migrate.js

@@ -3,6 +3,8 @@
  * Migration tools for V2 to V3 transition
  */
 import { output } from '../output.js';
+import * as fs from 'fs';
+import * as path from 'path';
 // Migration targets
 const MIGRATION_TARGETS = [
     { value: 'config', label: 'Configuration', hint: 'Migrate configuration files' },
@@ -17,13 +19,118 @@ const MIGRATION_TARGETS = [
 const statusCommand = {
     name: 'status',
     description: 'Check migration status',
-    action: async (_ctx) => {
-        // #1425: This command is not yet implemented — was returning hardcoded fake migration status
+    action: async (ctx) => {
+        const cwd = ctx.cwd || process.cwd();
+        const components = [];
+        // Check v2 config: claude-flow.config.json with version "2" or missing version
+        const v2ConfigPath = path.join(cwd, 'claude-flow.config.json');
+        const v3ConfigDir = path.join(cwd, '.claude-flow');
+        let hasV2Config = false;
+        let hasV3Config = false;
+        try {
+            if (fs.existsSync(v2ConfigPath)) {
+                const raw = fs.readFileSync(v2ConfigPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.version === '2' || parsed.version === 2 || !parsed.version) {
+                    hasV2Config = true;
+                }
+            }
+        }
+        catch { /* ignore parse errors */ }
+        try {
+            hasV3Config = fs.existsSync(v3ConfigDir) && fs.statSync(v3ConfigDir).isDirectory();
+        }
+        catch { /* ignore */ }
+        if (hasV2Config && hasV3Config) {
+            components.push({ component: 'Config', status: 'v2 + v3', migrationNeeded: 'no' });
+        }
+        else if (hasV2Config) {
+            components.push({ component: 'Config', status: 'v2', migrationNeeded: 'yes' });
+        }
+        else if (hasV3Config) {
+            components.push({ component: 'Config', status: 'v3', migrationNeeded: 'no' });
+        }
+        else {
+            components.push({ component: 'Config', status: 'missing', migrationNeeded: 'no' });
+        }
+        // Check v2 memory: ./data/memory/*.json or memory.db
+        const v2MemoryDir = path.join(cwd, 'data', 'memory');
+        let hasV2MemoryJson = false;
+        let hasV2MemoryDb = false;
+        try {
+            if (fs.existsSync(v2MemoryDir)) {
+                const files = fs.readdirSync(v2MemoryDir);
+                hasV2MemoryJson = files.some(f => f.endsWith('.json'));
+                hasV2MemoryDb = files.includes('memory.db');
+            }
+        }
+        catch { /* ignore */ }
+        if (hasV2MemoryJson || hasV2MemoryDb) {
+            components.push({ component: 'Memory', status: 'v2', migrationNeeded: 'yes' });
+        }
+        else {
+            components.push({ component: 'Memory', status: 'missing', migrationNeeded: 'no' });
+        }
+        // Check v2 sessions: ./data/sessions/
+        const v2SessionsDir = path.join(cwd, 'data', 'sessions');
+        let hasV2Sessions = false;
+        try {
+            if (fs.existsSync(v2SessionsDir)) {
+                const files = fs.readdirSync(v2SessionsDir);
+                hasV2Sessions = files.length > 0;
+            }
+        }
+        catch { /* ignore */ }
+        if (hasV2Sessions) {
+            components.push({ component: 'Sessions', status: 'v2', migrationNeeded: 'yes' });
+        }
+        else {
+            components.push({ component: 'Sessions', status: 'missing', migrationNeeded: 'no' });
+        }
+        // Check migration state
+        const migrationStatePath = path.join(cwd, '.claude-flow', 'migration-state.json');
+        let migrationState = null;
+        try {
+            if (fs.existsSync(migrationStatePath)) {
+                const raw = fs.readFileSync(migrationStatePath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                migrationState = parsed.status || 'unknown';
+            }
+        }
+        catch { /* ignore */ }
+        if (migrationState) {
+            components.push({ component: 'Migration State', status: migrationState, migrationNeeded: 'no' });
+        }
+        // Display results
+        if (ctx.flags.format === 'json') {
+            output.printJson({ components, migrationState });
+            return { success: true, data: { components, migrationState } };
+        }
+        output.writeln();
+        output.writeln(output.bold('Migration Status'));
+        output.writeln();
+        output.printTable({
+            columns: [
+                { key: 'component', header: 'Component', width: 20 },
+                { key: 'status', header: 'Status', width: 15 },
+                { key: 'migrationNeeded', header: 'Migration Needed', width: 20 }
+            ],
+            data: components.map(c => ({
+                component: c.component,
+                status: formatMigrationStatus(c.status),
+                migrationNeeded: c.migrationNeeded === 'yes' ? output.warning('yes') : output.dim('no')
+            })),
+            border: false
+        });
+        const needsMigration = components.some(c => c.migrationNeeded === 'yes');
         output.writeln();
-        output.printError('migrate status is not yet implemented');
-        output.writeln(output.dim('Migration status detection requires filesystem analysis not yet built.'));
-        output.writeln(output.dim('Track progress: https://github.com/ruvnet/claude-flow/issues/1425'));
-        return { success: false, exitCode: 1 };
+        if (needsMigration) {
+            output.printInfo('V2 artifacts detected. Run "claude-flow migrate run" to migrate.');
+        }
+        else {
+            output.printSuccess('No migration needed.');
+        }
+        return { success: true, data: { components, needsMigration } };
     }
 };
 // Run migration
@@ -58,14 +165,200 @@ const runCommand = {
             default: false
         }
     ],
-    action: async (_ctx) => {
-        // #1425: This command is not yet implemented — was faking migration execution
-        output.writeln();
-        output.printError('migrate run is not yet implemented');
-        output.writeln(output.dim('V2→V3 migration requires file transformation logic not yet built.'));
-        output.writeln(output.dim('See "migrate breaking" for a list of V3 breaking changes.'));
-        output.writeln(output.dim('Track progress: https://github.com/ruvnet/claude-flow/issues/1425'));
-        return { success: false, exitCode: 1 };
+    action: async (ctx) => {
+        const cwd = ctx.cwd || process.cwd();
+        const dryRun = ctx.flags['dry-run'] === true;
+        const skipBackup = ctx.flags.backup === false;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const v3Dir = path.join(cwd, '.claude-flow');
+        const backupDir = path.join(v3Dir, 'backup', `v2-${timestamp}`);
+        const migrationStatePath = path.join(v3Dir, 'migration-state.json');
+        const migrated = [];
+        const skipped = [];
+        output.writeln();
+        output.writeln(output.bold('V2 to V3 Migration'));
+        if (dryRun) {
+            output.printWarning('Dry run mode — no changes will be made.');
+        }
+        output.writeln();
+        // Ensure .claude-flow directory exists
+        if (!dryRun) {
+            fs.mkdirSync(v3Dir, { recursive: true });
+        }
+        // --- Backup ---
+        if (!skipBackup && !dryRun) {
+            output.writeln(output.dim('Creating backup...'));
+            fs.mkdirSync(backupDir, { recursive: true });
+        }
+        // --- Config migration ---
+        const v2ConfigPath = path.join(cwd, 'claude-flow.config.json');
+        try {
+            if (fs.existsSync(v2ConfigPath)) {
+                const raw = fs.readFileSync(v2ConfigPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.version === '2' || parsed.version === 2 || !parsed.version) {
+                    if (dryRun) {
+                        output.printInfo(`Would migrate config: ${v2ConfigPath}`);
+                    }
+                    else {
+                        // Backup
+                        if (!skipBackup) {
+                            fs.copyFileSync(v2ConfigPath, path.join(backupDir, 'claude-flow.config.json'));
+                        }
+                        // Transform to v3 format
+                        const v3Config = { ...parsed, version: '3' };
+                        // Rename swarm.mode -> swarm.topology if present
+                        if (v3Config.swarm && typeof v3Config.swarm === 'object') {
+                            const swarm = v3Config.swarm;
+                            if ('mode' in swarm && !('topology' in swarm)) {
+                                swarm.topology = swarm.mode;
+                                delete swarm.mode;
+                            }
+                        }
+                        // Rename memory.type -> memory.backend if present
+                        if (v3Config.memory && typeof v3Config.memory === 'object') {
+                            const mem = v3Config.memory;
+                            if ('type' in mem && !('backend' in mem)) {
+                                mem.backend = mem.type;
+                                delete mem.type;
+                            }
+                        }
+                        const v3ConfigPath = path.join(v3Dir, 'config.json');
+                        fs.writeFileSync(v3ConfigPath, JSON.stringify(v3Config, null, 2));
+                        output.printSuccess(`Config migrated to ${v3ConfigPath}`);
+                    }
+                    migrated.push('config');
+                }
+                else {
+                    output.printInfo('Config already at v3 — skipping.');
+                    skipped.push('config');
+                }
+            }
+            else {
+                output.writeln(output.dim('No v2 config found — skipping config migration.'));
+                skipped.push('config');
+            }
+        }
+        catch (err) {
+            output.printError('Config migration failed', String(err));
+            skipped.push('config');
+        }
+        // --- Memory migration ---
+        const v2MemoryDir = path.join(cwd, 'data', 'memory');
+        try {
+            if (fs.existsSync(v2MemoryDir)) {
+                const files = fs.readdirSync(v2MemoryDir);
+                const jsonFiles = files.filter(f => f.endsWith('.json'));
+                const hasDb = files.includes('memory.db');
+                if (jsonFiles.length > 0 || hasDb) {
+                    if (dryRun) {
+                        output.printInfo(`Would migrate memory: ${jsonFiles.length} JSON files, ${hasDb ? '1 DB' : 'no DB'}`);
+                    }
+                    else {
+                        // Backup memory files
+                        if (!skipBackup) {
+                            const memBackup = path.join(backupDir, 'data', 'memory');
+                            fs.mkdirSync(memBackup, { recursive: true });
+                            for (const f of files) {
+                                const src = path.join(v2MemoryDir, f);
+                                if (fs.statSync(src).isFile()) {
+                                    fs.copyFileSync(src, path.join(memBackup, f));
+                                }
+                            }
+                        }
+                        output.printSuccess(`Memory files backed up (${jsonFiles.length} JSON, ${hasDb ? '1 DB' : '0 DB'}).`);
+                        output.printInfo('Run "claude-flow memory init --force" to import v2 memory into v3 AgentDB.');
+                    }
+                    migrated.push('memory');
+                }
+                else {
+                    output.writeln(output.dim('No v2 memory files found — skipping.'));
+                    skipped.push('memory');
+                }
+            }
+            else {
+                output.writeln(output.dim('No v2 memory directory found — skipping.'));
+                skipped.push('memory');
+            }
+        }
+        catch (err) {
+            output.printError('Memory migration failed', String(err));
+            skipped.push('memory');
+        }
+        // --- Session migration ---
+        const v2SessionsDir = path.join(cwd, 'data', 'sessions');
+        try {
+            if (fs.existsSync(v2SessionsDir)) {
+                const files = fs.readdirSync(v2SessionsDir);
+                if (files.length > 0) {
+                    if (dryRun) {
+                        output.printInfo(`Would migrate sessions: ${files.length} files from ${v2SessionsDir}`);
+                    }
+                    else {
+                        const v3SessionsDir = path.join(v3Dir, 'sessions');
+                        fs.mkdirSync(v3SessionsDir, { recursive: true });
+                        // Backup
+                        if (!skipBackup) {
+                            const sessBackup = path.join(backupDir, 'data', 'sessions');
+                            fs.mkdirSync(sessBackup, { recursive: true });
+                            for (const f of files) {
+                                const src = path.join(v2SessionsDir, f);
+                                if (fs.statSync(src).isFile()) {
+                                    fs.copyFileSync(src, path.join(sessBackup, f));
+                                }
+                            }
+                        }
+                        // Copy to v3 location
+                        for (const f of files) {
+                            const src = path.join(v2SessionsDir, f);
+                            if (fs.statSync(src).isFile()) {
+                                fs.copyFileSync(src, path.join(v3SessionsDir, f));
+                            }
+                        }
+                        output.printSuccess(`Sessions migrated: ${files.length} files to ${v3SessionsDir}`);
+                    }
+                    migrated.push('sessions');
+                }
+                else {
+                    output.writeln(output.dim('No v2 session files found — skipping.'));
+                    skipped.push('sessions');
+                }
+            }
+            else {
+                output.writeln(output.dim('No v2 sessions directory found — skipping.'));
+                skipped.push('sessions');
+            }
+        }
+        catch (err) {
+            output.printError('Session migration failed', String(err));
+            skipped.push('sessions');
+        }
+        // --- Save migration state ---
+        if (!dryRun && migrated.length > 0) {
+            const state = {
+                status: 'completed',
+                timestamp,
+                backupPath: skipBackup ? null : backupDir,
+                migrated,
+                skipped
+            };
+            fs.writeFileSync(migrationStatePath, JSON.stringify(state, null, 2));
+            output.writeln();
+            output.printSuccess(`Migration state saved to ${migrationStatePath}`);
+        }
+        // Summary
+        output.writeln();
+        if (dryRun) {
+            output.printInfo(`Dry run complete. ${migrated.length} component(s) would be migrated.`);
+        }
+        else if (migrated.length > 0) {
+            output.printSuccess(`Migration complete. ${migrated.length} component(s) migrated: ${migrated.join(', ')}`);
+            output.printInfo('Run "claude-flow migrate verify" to validate the migration.');
+        }
+        else {
+            output.printInfo('Nothing to migrate.');
+        }
+        return { success: true, data: { migrated, skipped, dryRun } };
     }
 };
 // Verify migration
@@ -80,13 +373,126 @@ const verifyCommand = {
             default: false
         }
     ],
-    action: async (_ctx) => {
-        // #1425: This command is not yet implemented — was returning hardcoded fake verification results
+    action: async (ctx) => {
+        const cwd = ctx.cwd || process.cwd();
+        const v3Dir = path.join(cwd, '.claude-flow');
+        const migrationStatePath = path.join(v3Dir, 'migration-state.json');
+        const checks = [];
+        let allPassed = true;
+        output.writeln();
+        output.writeln(output.bold('Migration Verification'));
         output.writeln();
-        output.printError('migrate verify is not yet implemented');
-        output.writeln(output.dim('Migration verification requires integrity checks not yet built.'));
-        output.writeln(output.dim('Track progress: https://github.com/ruvnet/claude-flow/issues/1425'));
-        return { success: false, exitCode: 1 };
+        // Check 1: Migration state file exists
+        let migrationState = null;
+        try {
+            if (fs.existsSync(migrationStatePath)) {
+                const raw = fs.readFileSync(migrationStatePath, 'utf-8');
+                migrationState = JSON.parse(raw);
+                checks.push({ check: 'Migration state file', result: 'passed' });
+            }
+            else {
+                checks.push({ check: 'Migration state file', result: 'failed' });
+                allPassed = false;
+            }
+        }
+        catch {
+            checks.push({ check: 'Migration state file', result: 'failed' });
+            allPassed = false;
+        }
+        // Check 2: V3 config exists and is valid JSON
+        const v3ConfigPath = path.join(v3Dir, 'config.json');
+        try {
+            if (fs.existsSync(v3ConfigPath)) {
+                const raw = fs.readFileSync(v3ConfigPath, 'utf-8');
+                JSON.parse(raw); // validate JSON
+                checks.push({ check: 'V3 config (valid JSON)', result: 'passed' });
+            }
+            else {
+                // Config might not have been migrated if there was no v2 config
+                const wasMigrated = migrationState &&
+                    Array.isArray(migrationState.migrated) &&
+                    migrationState.migrated.includes('config');
+                if (wasMigrated) {
+                    checks.push({ check: 'V3 config (valid JSON)', result: 'failed' });
+                    allPassed = false;
+                }
+                else {
+                    checks.push({ check: 'V3 config (valid JSON)', result: 'skipped' });
+                }
+            }
+        }
+        catch {
+            checks.push({ check: 'V3 config (valid JSON)', result: 'failed' });
+            allPassed = false;
+        }
+        // Check 3: Backup exists
+        if (migrationState && migrationState.backupPath) {
+            const backupPath = migrationState.backupPath;
+            try {
+                if (fs.existsSync(backupPath) && fs.statSync(backupPath).isDirectory()) {
+                    checks.push({ check: 'Backup directory', result: 'passed' });
+                }
+                else {
+                    checks.push({ check: 'Backup directory', result: 'failed' });
+                    allPassed = false;
+                }
+            }
+            catch {
+                checks.push({ check: 'Backup directory', result: 'failed' });
+                allPassed = false;
+            }
+        }
+        else if (migrationState && migrationState.backupPath === null) {
+            checks.push({ check: 'Backup directory', result: 'skipped (backup was disabled)' });
+        }
+        else {
+            checks.push({ check: 'Backup directory', result: 'failed' });
+            allPassed = false;
+        }
+        // Check 4: V3 sessions directory if sessions were migrated
+        if (migrationState &&
+            Array.isArray(migrationState.migrated) &&
+            migrationState.migrated.includes('sessions')) {
+            const v3Sessions = path.join(v3Dir, 'sessions');
+            try {
+                if (fs.existsSync(v3Sessions) && fs.readdirSync(v3Sessions).length > 0) {
+                    checks.push({ check: 'V3 sessions directory', result: 'passed' });
+                }
+                else {
+                    checks.push({ check: 'V3 sessions directory', result: 'failed' });
+                    allPassed = false;
+                }
+            }
+            catch {
+                checks.push({ check: 'V3 sessions directory', result: 'failed' });
+                allPassed = false;
+            }
+        }
+        // Display
+        if (ctx.flags.format === 'json') {
+            output.printJson({ checks, allPassed });
+            return { success: allPassed, data: { checks, allPassed } };
+        }
+        output.printTable({
+            columns: [
+                { key: 'check', header: 'Check', width: 30 },
+                { key: 'result', header: 'Result', width: 35 }
+            ],
+            data: checks.map(c => ({
+                check: c.check,
+                result: formatMigrationStatus(c.result)
+            })),
+            border: false
+        });
+        output.writeln();
+        if (allPassed) {
+            output.printSuccess('All verification checks passed.');
+        }
+        else {
+            output.printError('Some verification checks failed.');
+            output.printInfo('Run "claude-flow migrate run" to re-run the migration, or "migrate rollback" to restore from backup.');
+        }
+        return { success: allPassed, data: { checks, allPassed }, exitCode: allPassed ? 0 : 1 };
     }
 };
 // Rollback migration
@@ -107,13 +513,94 @@ const rollbackCommand = {
             default: false
         }
     ],
-    action: async (_ctx) => {
-        // #1425: This command is not yet implemented — was faking rollback execution
+    action: async (ctx) => {
+        const cwd = ctx.cwd || process.cwd();
+        const v3Dir = path.join(cwd, '.claude-flow');
+        const migrationStatePath = path.join(v3Dir, 'migration-state.json');
+        output.writeln();
+        output.writeln(output.bold('Migration Rollback'));
         output.writeln();
-        output.printError('migrate rollback is not yet implemented');
-        output.writeln(output.dim('Migration rollback requires backup/restore logic not yet built.'));
-        output.writeln(output.dim('Track progress: https://github.com/ruvnet/claude-flow/issues/1425'));
-        return { success: false, exitCode: 1 };
+        // Read migration state
+        let migrationState;
+        try {
+            if (!fs.existsSync(migrationStatePath)) {
+                output.printError('No migration state found.', 'Run "migrate run" first before attempting rollback.');
+                return { success: false, exitCode: 1 };
+            }
+            const raw = fs.readFileSync(migrationStatePath, 'utf-8');
+            migrationState = JSON.parse(raw);
+        }
+        catch (err) {
+            output.printError('Failed to read migration state', String(err));
+            return { success: false, exitCode: 1 };
+        }
+        const backupPath = migrationState.backupPath;
+        if (!backupPath) {
+            output.printError('No backup path in migration state.', 'Migration was run with --no-backup. Cannot rollback.');
+            return { success: false, exitCode: 1 };
+        }
+        if (!fs.existsSync(backupPath)) {
+            output.printError('Backup directory not found.', `Expected: ${backupPath}`);
+            return { success: false, exitCode: 1 };
+        }
+        const restored = [];
+        try {
+            // Restore config
+            const backupConfig = path.join(backupPath, 'claude-flow.config.json');
+            if (fs.existsSync(backupConfig)) {
+                const destConfig = path.join(cwd, 'claude-flow.config.json');
+                fs.copyFileSync(backupConfig, destConfig);
+                // Remove v3 config
+                const v3Config = path.join(v3Dir, 'config.json');
+                if (fs.existsSync(v3Config)) {
+                    fs.unlinkSync(v3Config);
+                }
+                output.printSuccess('Restored: config');
+                restored.push('config');
+            }
+            // Restore memory
+            const backupMemory = path.join(backupPath, 'data', 'memory');
+            if (fs.existsSync(backupMemory)) {
+                const destMemory = path.join(cwd, 'data', 'memory');
+                fs.mkdirSync(destMemory, { recursive: true });
+                const files = fs.readdirSync(backupMemory);
+                for (const f of files) {
+                    fs.copyFileSync(path.join(backupMemory, f), path.join(destMemory, f));
+                }
+                output.printSuccess(`Restored: memory (${files.length} files)`);
+                restored.push('memory');
+            }
+            // Restore sessions
+            const backupSessions = path.join(backupPath, 'data', 'sessions');
+            if (fs.existsSync(backupSessions)) {
+                const destSessions = path.join(cwd, 'data', 'sessions');
+                fs.mkdirSync(destSessions, { recursive: true });
+                const files = fs.readdirSync(backupSessions);
+                for (const f of files) {
+                    fs.copyFileSync(path.join(backupSessions, f), path.join(destSessions, f));
+                }
+                // Remove v3 sessions
+                const v3Sessions = path.join(v3Dir, 'sessions');
+                if (fs.existsSync(v3Sessions)) {
+                    const v3Files = fs.readdirSync(v3Sessions);
+                    for (const f of v3Files) {
+                        fs.unlinkSync(path.join(v3Sessions, f));
+                    }
+                    fs.rmdirSync(v3Sessions);
+                }
+                output.printSuccess(`Restored: sessions (${files.length} files)`);
+                restored.push('sessions');
+            }
+            // Delete migration state
+            fs.unlinkSync(migrationStatePath);
+            output.writeln();
+            output.printSuccess(`Rollback complete. Restored: ${restored.join(', ') || 'nothing to restore'}`);
+            return { success: true, data: { restored } };
+        }
+        catch (err) {
+            output.printError('Rollback failed', String(err));
+            return { success: false, exitCode: 1 };
+        }
     }
 };
 // Breaking changes info
@@ -218,20 +705,25 @@ export const migrateCommand = {
 };
 // Helper functions
 function formatMigrationStatus(status) {
-    switch (status) {
-        case 'migrated':
-        case 'passed':
-            return output.success(status);
-        case 'pending':
-        case 'partial':
-            return output.warning(status);
-        case 'failed':
-            return output.error(status);
-        case 'not-required':
-            return output.dim(status);
-        default:
-            return status;
+    if (status === 'migrated' || status === 'passed' || status === 'completed') {
+        return output.success(status);
+    }
+    if (status === 'pending' || status === 'partial') {
+        return output.warning(status);
+    }
+    if (status === 'failed') {
+        return output.error(status);
+    }
+    if (status === 'not-required' || status.startsWith('skipped') || status === 'v3' || status === 'missing') {
+        return output.dim(status);
+    }
+    if (status === 'v2') {
+        return output.warning(status);
+    }
+    if (status === 'v2 + v3') {
+        return output.success(status);
     }
+    return status;
 }
 function getMigrationSteps(target) {
     const allSteps = [