@claude-flow/cli 3.0.2 → 3.1.0-alpha.2

package/src/commands/migrate.ts

@@ -1,447 +0,0 @@
-/**
- * V3 CLI Migrate Command
- * Migration tools for V2 to V3 transition
- */
-
-import type { Command, CommandContext, CommandResult } from '../types.js';
-import { output } from '../output.js';
-import { select, confirm, multiSelect } from '../prompt.js';
-
-// Migration targets
-const MIGRATION_TARGETS = [
-  { value: 'config', label: 'Configuration', hint: 'Migrate configuration files' },
-  { value: 'memory', label: 'Memory Data', hint: 'Migrate memory/database content' },
-  { value: 'agents', label: 'Agent Configs', hint: 'Migrate agent configurations' },
-  { value: 'hooks', label: 'Hooks', hint: 'Migrate hook definitions' },
-  { value: 'workflows', label: 'Workflows', hint: 'Migrate workflow definitions' },
-  { value: 'all', label: 'All', hint: 'Full migration' }
-];
-
-// Status command
-const statusCommand: Command = {
-  name: 'status',
-  description: 'Check migration status',
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    const status = {
-      v2Version: '2.6.0',
-      v3Version: '3.0.0-alpha.1',
-      migrationState: 'partial',
-      components: [
-        { name: 'Configuration', status: 'migrated', v2Path: './claude-flow.json', v3Path: './claude-flow.config.json' },
-        { name: 'Memory Data', status: 'pending', v2Path: './.claude-flow/memory', v3Path: './data/memory' },
-        { name: 'Agent Configs', status: 'pending', v2Path: './.claude-flow/agents', v3Path: './v3/agents' },
-        { name: 'Hooks', status: 'pending', v2Path: './src/hooks', v3Path: './v3/hooks' },
-        { name: 'Workflows', status: 'not-required', v2Path: 'N/A', v3Path: 'N/A' }
-      ],
-      recommendations: [
-        'Backup v2 data before migration',
-        'Test migration in staging environment first',
-        'Review breaking changes in CHANGELOG.md'
-      ]
-    };
-
-    if (ctx.flags.format === 'json') {
-      output.printJson(status);
-      return { success: true, data: status };
-    }
-
-    output.writeln();
-    output.writeln(output.bold('Migration Status'));
-    output.writeln();
-    output.writeln(`V2 Version: ${status.v2Version}`);
-    output.writeln(`V3 Version: ${status.v3Version}`);
-    output.writeln(`State: ${formatMigrationStatus(status.migrationState)}`);
-    output.writeln();
-
-    output.writeln(output.bold('Components'));
-    output.printTable({
-      columns: [
-        { key: 'name', header: 'Component', width: 18 },
-        { key: 'status', header: 'Status', width: 15, format: (v) => formatMigrationStatus(String(v)) },
-        { key: 'v2Path', header: 'V2 Path', width: 25 },
-        { key: 'v3Path', header: 'V3 Path', width: 25 }
-      ],
-      data: status.components
-    });
-
-    output.writeln();
-    output.writeln(output.bold('Recommendations'));
-    output.printList(status.recommendations);
-
-    return { success: true, data: status };
-  }
-};
-
-// Run migration
-const runCommand: Command = {
-  name: 'run',
-  description: 'Run migration',
-  options: [
-    {
-      name: 'target',
-      short: 't',
-      description: 'Migration target',
-      type: 'string',
-      choices: MIGRATION_TARGETS.map(t => t.value)
-    },
-    {
-      name: 'dry-run',
-      description: 'Show what would be migrated without making changes',
-      type: 'boolean',
-      default: false
-    },
-    {
-      name: 'backup',
-      description: 'Create backup before migration',
-      type: 'boolean',
-      default: true
-    },
-    {
-      name: 'force',
-      short: 'f',
-      description: 'Force migration (overwrite existing)',
-      type: 'boolean',
-      default: false
-    }
-  ],
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    let target = ctx.flags.target as string;
-    const dryRun = ctx.flags.dryRun as boolean;
-    const backup = ctx.flags.backup as boolean;
-    const force = ctx.flags.force as boolean;
-
-    if (!target && ctx.interactive) {
-      target = await select({
-        message: 'Select migration target:',
-        options: MIGRATION_TARGETS,
-        default: 'all'
-      });
-    }
-
-    target = target || 'all';
-
-    output.writeln();
-
-    if (dryRun) {
-      output.printInfo('DRY RUN - No changes will be made');
-      output.writeln();
-    }
-
-    output.printInfo(`Migrating: ${target}`);
-    output.writeln();
-
-    // Backup step
-    if (backup && !dryRun) {
-      output.writeln(output.dim('Creating backup...'));
-      output.writeln(output.dim(`  Backup created: ./.claude-flow-backup-${Date.now()}`));
-      output.writeln();
-    }
-
-    // Migration steps based on target
-    const steps = getMigrationSteps(target);
-
-    for (const step of steps) {
-      output.writeln(`${output.info('>')} ${step.name}`);
-      output.writeln(output.dim(`   ${step.description}`));
-
-      if (!dryRun) {
-        // Simulate migration
-        output.writeln(output.dim(`   ${output.success('[OK]')} Completed`));
-      } else {
-        output.writeln(output.dim(`   Would migrate: ${step.source} -> ${step.dest}`));
-      }
-
-      output.writeln();
-    }
-
-    const result = {
-      target,
-      dryRun,
-      backup,
-      stepsCompleted: steps.length,
-      success: true
-    };
-
-    if (dryRun) {
-      output.printInfo('Dry run complete. Run without --dry-run to apply changes.');
-    } else {
-      output.printSuccess('Migration completed successfully');
-    }
-
-    return { success: true, data: result };
-  }
-};
-
-// Verify migration
-const verifyCommand: Command = {
-  name: 'verify',
-  description: 'Verify migration integrity',
-  options: [
-    {
-      name: 'fix',
-      description: 'Automatically fix issues',
-      type: 'boolean',
-      default: false
-    }
-  ],
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    const fix = ctx.flags.fix as boolean;
-
-    output.writeln();
-    output.printInfo('Verifying migration...');
-    output.writeln();
-
-    const checks = [
-      { name: 'Configuration Schema', status: 'passed', details: 'V3 schema valid' },
-      { name: 'Memory Data Integrity', status: 'passed', details: 'All entries valid' },
-      { name: 'Agent Configurations', status: 'warning', details: '2 deprecated fields detected' },
-      { name: 'Hook Definitions', status: 'passed', details: 'All hooks registered' },
-      { name: 'File Permissions', status: 'passed', details: 'Correct permissions' },
-      { name: 'Dependencies', status: 'passed', details: 'All dependencies available' }
-    ];
-
-    output.printTable({
-      columns: [
-        { key: 'name', header: 'Check', width: 25 },
-        { key: 'status', header: 'Status', width: 12, format: (v) => {
-          if (v === 'passed') return output.success('PASSED');
-          if (v === 'warning') return output.warning('WARNING');
-          return output.error('FAILED');
-        }},
-        { key: 'details', header: 'Details', width: 30 }
-      ],
-      data: checks
-    });
-
-    const hasIssues = checks.some(c => c.status !== 'passed');
-
-    output.writeln();
-
-    if (hasIssues) {
-      if (fix) {
-        output.printInfo('Attempting to fix issues...');
-        output.printSuccess('Issues fixed');
-      } else {
-        output.printWarning('Some issues detected. Run with --fix to attempt automatic fixes.');
-      }
-    } else {
-      output.printSuccess('All verification checks passed');
-    }
-
-    return { success: true, data: { checks, hasIssues } };
-  }
-};
-
-// Rollback migration
-const rollbackCommand: Command = {
-  name: 'rollback',
-  description: 'Rollback to previous version',
-  options: [
-    {
-      name: 'backup-id',
-      description: 'Backup ID to restore',
-      type: 'string'
-    },
-    {
-      name: 'force',
-      short: 'f',
-      description: 'Skip confirmation',
-      type: 'boolean',
-      default: false
-    }
-  ],
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    const backupId = ctx.flags.backupId as string;
-    const force = ctx.flags.force as boolean;
-
-    // List available backups
-    const backups = [
-      { id: 'backup-1704369600', date: '2024-01-04 10:00:00', size: '45.2 MB' },
-      { id: 'backup-1704283200', date: '2024-01-03 10:00:00', size: '44.8 MB' },
-      { id: 'backup-1704196800', date: '2024-01-02 10:00:00', size: '43.5 MB' }
-    ];
-
-    if (!backupId && ctx.interactive) {
-      output.writeln();
-      output.writeln(output.bold('Available Backups'));
-      output.writeln();
-
-      output.printTable({
-        columns: [
-          { key: 'id', header: 'Backup ID', width: 20 },
-          { key: 'date', header: 'Date', width: 22 },
-          { key: 'size', header: 'Size', width: 12, align: 'right' }
-        ],
-        data: backups
-      });
-
-      output.writeln();
-
-      const confirmed = await confirm({
-        message: `Rollback to most recent backup (${backups[0].id})?`,
-        default: false
-      });
-
-      if (!confirmed) {
-        output.printInfo('Operation cancelled');
-        return { success: true };
-      }
-    }
-
-    const targetBackup = backupId || backups[0].id;
-
-    if (!force && !ctx.interactive) {
-      output.printError('Use --force to rollback without confirmation');
-      return { success: false, exitCode: 1 };
-    }
-
-    output.writeln();
-    output.printInfo(`Rolling back to ${targetBackup}...`);
-    output.writeln();
-
-    output.writeln(output.dim('  Stopping services...'));
-    output.writeln(output.dim('  Restoring configuration...'));
-    output.writeln(output.dim('  Restoring memory data...'));
-    output.writeln(output.dim('  Restoring agent configs...'));
-    output.writeln(output.dim('  Verifying integrity...'));
-
-    output.writeln();
-    output.printSuccess(`Rolled back to ${targetBackup}`);
-    output.writeln(output.dim('  Note: Restart services to apply changes'));
-
-    return { success: true, data: { backupId: targetBackup, rolledBack: true } };
-  }
-};
-
-// Breaking changes info
-const breakingCommand: Command = {
-  name: 'breaking',
-  description: 'Show V3 breaking changes',
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    const changes = [
-      {
-        category: 'Configuration',
-        changes: [
-          { change: 'Config file renamed', from: 'claude-flow.json', to: 'claude-flow.config.json' },
-          { change: 'Swarm config restructured', from: 'swarm.mode', to: 'swarm.topology' },
-          { change: 'Provider config format', from: 'provider: "anthropic"', to: 'providers: [...]' }
-        ]
-      },
-      {
-        category: 'Memory',
-        changes: [
-          { change: 'Backend option changed', from: 'memory: { type }', to: 'memory: { backend }' },
-          { change: 'HNSW enabled by default', from: 'Manual opt-in', to: 'Auto-enabled' },
-          { change: 'Storage path changed', from: '.claude-flow/memory', to: 'data/memory' }
-        ]
-      },
-      {
-        category: 'CLI',
-        changes: [
-          { change: 'Agent command renamed', from: 'spawn <type>', to: 'agent spawn -t <type>' },
-          { change: 'Memory command added', from: 'N/A', to: 'memory <subcommand>' },
-          { change: 'Hook command enhanced', from: 'hook <type>', to: 'hooks <subcommand>' }
-        ]
-      },
-      {
-        category: 'API',
-        changes: [
-          { change: 'Removed Deno support', from: 'Deno + Node.js', to: 'Node.js 20+ only' },
-          { change: 'Event system changed', from: 'EventEmitter', to: 'Event sourcing' },
-          { change: 'Coordination unified', from: 'Multiple coordinators', to: 'SwarmCoordinator' }
-        ]
-      }
-    ];
-
-    if (ctx.flags.format === 'json') {
-      output.printJson(changes);
-      return { success: true, data: changes };
-    }
-
-    output.writeln();
-    output.writeln(output.bold('V3 Breaking Changes'));
-    output.writeln();
-
-    for (const category of changes) {
-      output.writeln(output.highlight(category.category));
-      output.printTable({
-        columns: [
-          { key: 'change', header: 'Change', width: 25 },
-          { key: 'from', header: 'V2', width: 25 },
-          { key: 'to', header: 'V3', width: 25 }
-        ],
-        data: category.changes,
-        border: false
-      });
-      output.writeln();
-    }
-
-    output.printInfo('Run "claude-flow migrate run" to automatically handle these changes');
-
-    return { success: true, data: changes };
-  }
-};
-
-// Main migrate command
-export const migrateCommand: Command = {
-  name: 'migrate',
-  description: 'V2 to V3 migration tools',
-  subcommands: [statusCommand, runCommand, verifyCommand, rollbackCommand, breakingCommand],
-  options: [],
-  examples: [
-    { command: 'claude-flow migrate status', description: 'Check migration status' },
-    { command: 'claude-flow migrate run --dry-run', description: 'Preview migration' },
-    { command: 'claude-flow migrate run -t all', description: 'Run full migration' }
-  ],
-  action: async (ctx: CommandContext): Promise<CommandResult> => {
-    output.writeln();
-    output.writeln(output.bold('V2 to V3 Migration Tools'));
-    output.writeln();
-    output.writeln('Usage: claude-flow migrate <subcommand> [options]');
-    output.writeln();
-    output.writeln('Subcommands:');
-    output.printList([
-      `${output.highlight('status')}    - Check migration status`,
-      `${output.highlight('run')}       - Run migration`,
-      `${output.highlight('verify')}    - Verify migration integrity`,
-      `${output.highlight('rollback')}  - Rollback to previous version`,
-      `${output.highlight('breaking')}  - Show breaking changes`
-    ]);
-
-    return { success: true };
-  }
-};
-
-// Helper functions
-function formatMigrationStatus(status: string): string {
-  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;
-  }
-}
-
-function getMigrationSteps(target: string): Array<{ name: string; description: string; source: string; dest: string }> {
-  const allSteps = [
-    { name: 'Configuration Files', description: 'Migrate config schema to V3 format', source: './claude-flow.json', dest: './claude-flow.config.json' },
-    { name: 'Memory Backend', description: 'Upgrade to hybrid backend with AgentDB', source: './.claude-flow/memory', dest: './data/memory' },
-    { name: 'Agent Definitions', description: 'Convert agent configs to V3 format', source: './.claude-flow/agents', dest: './v3/agents' },
-    { name: 'Hook Registry', description: 'Migrate hooks to V3 hook system', source: './src/hooks', dest: './v3/hooks' },
-    { name: 'Workflow Definitions', description: 'Convert workflows to event-sourced format', source: './.claude-flow/workflows', dest: './data/workflows' }
-  ];
-
-  if (target === 'all') return allSteps;
-
-  return allSteps.filter(s => s.name.toLowerCase().includes(target.toLowerCase()));
-}
-
-export default migrateCommand;