claude-flow 2.0.0-alpha.61 → 2.0.0-alpha.62

package/src/migration/README.md

@@ -5,6 +5,7 @@ A comprehensive migration system for existing claude-flow projects to adopt opti
 ## Overview
 
 The migration system provides tools to:
+
 - Analyze existing projects for migration readiness
 - Migrate projects using different strategies (full, selective, merge)
 - Create automatic backups for safe rollback
@@ -33,25 +34,28 @@ npx claude-flow migrate rollback
 
 1. **MigrationAnalyzer** - Analyzes project structure and detects conflicts
 2. **MigrationRunner** - Executes migration strategies
-3. **RollbackManager** - Handles backup creation and restoration  
+3. **RollbackManager** - Handles backup creation and restoration
 4. **MigrationValidator** - Validates successful migrations
 5. **ProgressReporter** - Provides visual feedback during operations
 
 ### Migration Strategies
 
 #### Full Strategy
+
 - **Use Case**: New projects or complete overhaul
 - **Behavior**: Replaces entire `.claude` folder
 - **Risk Level**: High (with backup)
 - **Command**: `--strategy full`
 
-#### Selective Strategy  
+#### Selective Strategy
+
 - **Use Case**: Projects with custom commands (default)
 - **Behavior**: Updates core files, preserves customizations
 - **Risk Level**: Medium
 - **Command**: `--strategy selective --preserve-custom`
 
 #### Merge Strategy
+
 - **Use Case**: Complex projects with custom configurations
 - **Behavior**: Merges configurations, preserves custom commands
 - **Risk Level**: Low
@@ -128,6 +132,7 @@ claude-flow migrate status
 ### Migration Manifest
 
 The system uses a manifest file (`migration-manifest.json`) to define:
+
 - File mappings and transformations
 - Strategy configurations
 - Validation requirements
@@ -162,6 +167,7 @@ Projects can include migration preferences in `CLAUDE.md`:
 
 ```markdown
 ## Migration Configuration
+
 - strategy: selective
 - preserveCustom: true
 - customCommands: ['my-command', 'special-workflow']
@@ -183,7 +189,7 @@ const runner = new MigrationRunner({
   projectPath: './my-project',
   strategy: 'selective',
   preserveCustom: true,
-  dryRun: false
+  dryRun: false,
 });
 
 const result = await runner.run();
@@ -200,7 +206,7 @@ const rollback = new RollbackManager('./my-project');
 // Create backup
 const backup = await rollback.createBackup({
   type: 'pre-migration',
-  description: 'Before optimization update'
+  description: 'Before optimization update',
 });
 
 // List backups
@@ -275,6 +281,7 @@ done
 ### Automatic Backups
 
 Every migration creates automatic backups:
+
 - **Location**: `.claude-backup/` directory
 - **Format**: Timestamped folders with full file content
 - **Retention**: Configurable (default: 30 days, max 10 backups)
@@ -283,6 +290,7 @@ Every migration creates automatic backups:
 ### Conflict Detection
 
 The analyzer detects potential conflicts:
+
 - **Custom Commands**: Commands not in standard set
 - **Modified Files**: Files with custom modifications
 - **Configuration Conflicts**: Incompatible settings
@@ -291,6 +299,7 @@ The analyzer detects potential conflicts:
 ### Rollback Safety
 
 Multiple rollback options:
+
 - **Automatic**: Failed migrations auto-rollback
 - **Manual**: User-initiated rollback to any backup
 - **Validation**: Checksum verification during restore
@@ -301,6 +310,7 @@ Multiple rollback options:
 ### Common Issues
 
 #### Migration Fails with Permission Errors
+
 ```bash
 # Check and fix permissions
 chmod -R u+w .claude/
@@ -308,12 +318,14 @@ claude-flow migrate --strategy selective
 ```
 
 #### Custom Commands Not Preserved
+
 ```bash
 # Use preserve-custom flag
 claude-flow migrate --strategy selective --preserve-custom
 ```
 
 #### Validation Failures
+
 ```bash
 # Run detailed validation
 claude-flow migrate validate --verbose
@@ -323,6 +335,7 @@ ls -la .claude/commands/
 ```
 
 #### Rollback Not Working
+
 ```bash
 # List available backups
 claude-flow migrate rollback --list
@@ -334,6 +347,7 @@ cat .claude-backup/*/backup-manifest.json
 ### Debug Mode
 
 Enable detailed logging:
+
 ```bash
 export DEBUG=true
 claude-flow migrate --verbose
@@ -342,6 +356,7 @@ claude-flow migrate --verbose
 ### Log Files
 
 Migration logs are stored in:
+
 - **Development**: Console output
 - **Production**: `logs/migration.log`
 
@@ -386,11 +401,11 @@ Automate migrations in CI/CD pipelines:
 steps:
   - name: Analyze Migration
     run: claude-flow migrate analyze --output analysis.json
-  
+
   - name: Run Migration
     run: claude-flow migrate --strategy selective --force
-  
-  - name: Validate Migration  
+
+  - name: Validate Migration
     run: claude-flow migrate validate
 ```
 
@@ -406,6 +421,7 @@ steps:
 ### Benchmarks
 
 Typical performance metrics:
+
 - **Analysis**: ~100ms for standard project
 - **Full Migration**: ~500ms for complete replacement
 - **Selective Migration**: ~200ms preserving customizations
@@ -451,7 +467,7 @@ npm run build:migration
 # Unit tests
 npm test src/migration/tests/
 
-# Integration tests  
+# Integration tests
 npm run test:integration
 
 # End-to-end tests
@@ -478,4 +494,4 @@ This migration system is part of claude-code-flow and follows the same license t
 
 ---
 
-For more information, see the [main claude-code-flow documentation](../../README.md).
+For more information, see the [main claude-code-flow documentation](../../README.md).

package/src/migration/index.ts

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
-import { getErrorMessage } from '../utils/error-handler.js';
 /**
  * Claude-Flow Migration Tool
  * Helps existing projects migrate to optimized prompts and configurations
  */
 
-import { Command } from "@cliffy/command";
+import { Command } from '@cliffy/command';
 import { MigrationRunner } from './migration-runner.js';
 import { MigrationAnalyzer } from './migration-analyzer.js';
 import type { MigrationStrategy } from './types.js';
@@ -29,12 +28,12 @@ program
     try {
       const analyzer = new MigrationAnalyzer();
       const analysis = await analyzer.analyze(path.resolve(projectPath));
-      
+
       if (options.output) {
         await analyzer.saveAnalysis(analysis, options.output);
         logger.success(`Analysis saved to ${options.output}`);
       }
-      
+
       analyzer.printAnalysis(analysis, options.detailed);
     } catch (error) {
       logger.error('Analysis failed:', error);
@@ -60,9 +59,9 @@ program
         force: options.force,
         dryRun: options.dryRun,
         preserveCustom: options.preserveCustom,
-        skipValidation: options.skipValidation
+        skipValidation: options.skipValidation,
       });
-      
+
       await runner.run();
     } catch (error) {
       logger.error('Migration failed:', error);
@@ -82,9 +81,9 @@ program
         projectPath: path.resolve(projectPath),
         strategy: 'full',
         backupDir: options.backup,
-        force: options.force
+        force: options.force,
       });
-      
+
       await runner.rollback(options.timestamp);
     } catch (error) {
       logger.error('Rollback failed:', error);
@@ -100,11 +99,11 @@ program
     try {
       const runner = new MigrationRunner({
         projectPath: path.resolve(projectPath),
-        strategy: 'full'
+        strategy: 'full',
       });
-      
+
       const isValid = await runner.validate(options.verbose);
-      
+
       if (isValid) {
         logger.success('Migration validated successfully!');
       } else {
@@ -126,9 +125,9 @@ program
       const runner = new MigrationRunner({
         projectPath: path.resolve(projectPath),
         strategy: 'full',
-        backupDir: options.backup
+        backupDir: options.backup,
       });
-      
+
       await runner.listBackups();
     } catch (error) {
       logger.error('Failed to list backups:', error);
@@ -141,4 +140,4 @@ if (!process.argv.slice(2).length) {
   program.outputHelp();
 }
 
-program.parse(process.argv);
+program.parse(process.argv);

package/src/migration/logger.ts

@@ -1,4 +1,3 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 import * as process from 'node:process';
 /**
  * Migration Logger - Structured logging for migration operations
@@ -38,7 +37,7 @@ export class MigrationLogger {
     this.log('error', message, context, error?.stack);
     console.log(chalk.red(`❌ ${message}`));
     if (error && (error instanceof Error ? error.message : String(error)) !== message) {
-      console.log(chalk.red(`   ${(error instanceof Error ? error.message : String(error))}`));
+      console.log(chalk.red(`   ${error instanceof Error ? error.message : String(error)}`));
     }
   }
 
@@ -60,7 +59,7 @@ export class MigrationLogger {
       level,
       message,
       context,
-      stack
+      stack,
     };
 
     this.entries.push(entry);
@@ -81,7 +80,10 @@ export class MigrationLogger {
       await fs.appendFile(this.logFile, logLine);
     } catch (error) {
       // Prevent recursive logging
-      console.error('Failed to write to log file:', (error instanceof Error ? error.message : String(error)));
+      console.error(
+        'Failed to write to log file:',
+        error instanceof Error ? error.message : String(error),
+      );
     }
   }
 
@@ -95,7 +97,7 @@ export class MigrationLogger {
   }
 
   getEntriesByLevel(level: LogEntry['level']): LogEntry[] {
-    return this.entries.filter(entry => entry.level === level);
+    return this.entries.filter((entry) => entry.level === level);
   }
 
   clear(): void {
@@ -109,7 +111,7 @@ export class MigrationLogger {
       warn: this.getEntriesByLevel('warn').length,
       error: this.getEntriesByLevel('error').length,
       success: this.getEntriesByLevel('success').length,
-      debug: this.getEntriesByLevel('debug').length
+      debug: this.getEntriesByLevel('debug').length,
     };
 
     console.log(chalk.bold('\n📊 Migration Log Summary'));
@@ -133,4 +135,4 @@ export const logger = new MigrationLogger();
 if (process.env.NODE_ENV === 'production') {
   const logFile = path.join(process.cwd(), 'logs', 'migration.log');
   logger['logFile'] = logFile;
-}
+}

package/src/migration/migration-analyzer.ts

@@ -1,4 +1,3 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 /**
  * Migration Analyzer - Analyzes existing projects for migration readiness
  */
@@ -13,8 +12,13 @@ import { glob } from 'glob';
 
 export class MigrationAnalyzer {
   private optimizedCommands = [
-    'sparc', 'sparc-architect', 'sparc-code', 'sparc-tdd',
-    'claude-flow-help', 'claude-flow-memory', 'claude-flow-swarm'
+    'sparc',
+    'sparc-architect',
+    'sparc-code',
+    'sparc-tdd',
+    'claude-flow-help',
+    'claude-flow-memory',
+    'claude-flow-swarm',
   ];
 
   async analyze(projectPath: string): Promise<MigrationAnalysis> {
@@ -29,23 +33,23 @@ export class MigrationAnalyzer {
       conflictingFiles: [],
       migrationRisks: [],
       recommendations: [],
-      timestamp: new Date()
+      timestamp: new Date(),
     };
 
     // Check for .claude folder
     const claudePath = path.join(projectPath, '.claude');
     if (await fs.pathExists(claudePath)) {
       analysis.hasClaudeFolder = true;
-      
+
       // Analyze existing commands
       await this.analyzeCommands(claudePath, analysis);
-      
+
       // Check for optimized prompts
       await this.checkOptimizedPrompts(claudePath, analysis);
-      
+
       // Analyze configurations
       await this.analyzeConfigurations(projectPath, analysis);
-      
+
       // Detect conflicts
       await this.detectConflicts(projectPath, analysis);
     }
@@ -59,13 +63,13 @@ export class MigrationAnalyzer {
 
   private async analyzeCommands(claudePath: string, analysis: MigrationAnalysis): Promise<void> {
     const commandsPath = path.join(claudePath, 'commands');
-    
+
     if (await fs.pathExists(commandsPath)) {
       const files = await glob('**/*.md', { cwd: commandsPath });
-      
+
       for (const file of files) {
         const commandName = path.basename(file, '.md');
-        
+
         if (!this.optimizedCommands.includes(commandName)) {
           analysis.customCommands.push(commandName);
         }
@@ -73,13 +77,16 @@ export class MigrationAnalyzer {
     }
   }
 
-  private async checkOptimizedPrompts(claudePath: string, analysis: MigrationAnalysis): Promise<void> {
+  private async checkOptimizedPrompts(
+    claudePath: string,
+    analysis: MigrationAnalysis,
+  ): Promise<void> {
     // Check for key optimized prompt files
     const optimizedFiles = [
       'BATCHTOOLS_GUIDE.md',
       'BATCHTOOLS_BEST_PRACTICES.md',
       'MIGRATION_GUIDE.md',
-      'PERFORMANCE_BENCHMARKS.md'
+      'PERFORMANCE_BENCHMARKS.md',
     ];
 
     let hasOptimized = 0;
@@ -92,7 +99,10 @@ export class MigrationAnalyzer {
     analysis.hasOptimizedPrompts = hasOptimized >= 2;
   }
 
-  private async analyzeConfigurations(projectPath: string, analysis: MigrationAnalysis): Promise<void> {
+  private async analyzeConfigurations(
+    projectPath: string,
+    analysis: MigrationAnalysis,
+  ): Promise<void> {
     // Check for CLAUDE.md
     const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
     if (await fs.pathExists(claudeMdPath)) {
@@ -100,7 +110,7 @@ export class MigrationAnalyzer {
       analysis.customConfigurations['CLAUDE.md'] = {
         exists: true,
         size: content.length,
-        hasCustomContent: !content.includes('SPARC Development Environment')
+        hasCustomContent: !content.includes('SPARC Development Environment'),
       };
     }
 
@@ -112,16 +122,16 @@ export class MigrationAnalyzer {
         analysis.customConfigurations['.roomodes'] = {
           exists: true,
           modeCount: Object.keys(roomodes).length,
-          customModes: Object.keys(roomodes).filter(mode => 
-            !['architect', 'code', 'tdd', 'debug', 'docs-writer'].includes(mode)
-          )
+          customModes: Object.keys(roomodes).filter(
+            (mode) => !['architect', 'code', 'tdd', 'debug', 'docs-writer'].includes(mode),
+          ),
         };
       } catch (error) {
         analysis.migrationRisks.push({
           level: 'medium',
           description: 'Invalid .roomodes file',
           file: roomodesPath,
-          mitigation: 'File will be backed up and replaced'
+          mitigation: 'File will be backed up and replaced',
         });
       }
     }
@@ -133,7 +143,7 @@ export class MigrationAnalyzer {
       '.claude/commands/sparc.md',
       '.claude/BATCHTOOLS_GUIDE.md',
       'memory/memory-store.json',
-      'coordination/config.json'
+      'coordination/config.json',
     ];
 
     for (const file of potentialConflicts) {
@@ -141,7 +151,7 @@ export class MigrationAnalyzer {
       if (await fs.pathExists(filePath)) {
         const content = await fs.readFile(filePath, 'utf-8');
         const checksum = crypto.createHash('md5').update(content).digest('hex');
-        
+
         // Check if it's a custom version
         if (!this.isStandardFile(file, checksum)) {
           analysis.conflictingFiles.push(file);
@@ -162,7 +172,7 @@ export class MigrationAnalyzer {
       analysis.migrationRisks.push({
         level: 'high',
         description: `Found ${analysis.customCommands.length} custom commands that may be affected`,
-        mitigation: 'Use --preserve-custom flag or selective migration'
+        mitigation: 'Use --preserve-custom flag or selective migration',
       });
     }
 
@@ -171,7 +181,7 @@ export class MigrationAnalyzer {
       analysis.migrationRisks.push({
         level: 'medium',
         description: 'Project already has some optimized prompts',
-        mitigation: 'Consider using merge strategy to preserve customizations'
+        mitigation: 'Consider using merge strategy to preserve customizations',
       });
     }
 
@@ -180,7 +190,7 @@ export class MigrationAnalyzer {
       analysis.migrationRisks.push({
         level: 'low',
         description: 'No existing .claude folder found',
-        mitigation: 'Fresh installation will be performed'
+        mitigation: 'Fresh installation will be performed',
       });
     }
 
@@ -189,7 +199,7 @@ export class MigrationAnalyzer {
       analysis.migrationRisks.push({
         level: 'high',
         description: `${analysis.conflictingFiles.length} files may have custom modifications`,
-        mitigation: 'Files will be backed up before migration'
+        mitigation: 'Files will be backed up before migration',
       });
     }
   }
@@ -198,54 +208,58 @@ export class MigrationAnalyzer {
     // Strategy recommendations
     if (analysis.customCommands.length > 0 || analysis.conflictingFiles.length > 0) {
       analysis.recommendations.push(
-        'Use "selective" or "merge" strategy to preserve customizations'
+        'Use "selective" or "merge" strategy to preserve customizations',
       );
     } else if (!analysis.hasClaudeFolder) {
-      analysis.recommendations.push(
-        'Use "full" strategy for clean installation'
-      );
+      analysis.recommendations.push('Use "full" strategy for clean installation');
     }
 
     // Backup recommendations
     if (analysis.hasClaudeFolder) {
       analysis.recommendations.push(
-        'Create a backup before migration (automatic with default settings)'
+        'Create a backup before migration (automatic with default settings)',
       );
     }
 
     // Custom command recommendations
     if (analysis.customCommands.length > 0) {
       analysis.recommendations.push(
-        `Review custom commands: ${analysis.customCommands.join(', ')}`
+        `Review custom commands: ${analysis.customCommands.join(', ')}`,
       );
     }
 
     // Validation recommendations
-    if (analysis.migrationRisks.some(r => r.level === 'high')) {
-      analysis.recommendations.push(
-        'Run with --dry-run first to preview changes'
-      );
+    if (analysis.migrationRisks.some((r) => r.level === 'high')) {
+      analysis.recommendations.push('Run with --dry-run first to preview changes');
     }
   }
 
   printAnalysis(analysis: MigrationAnalysis, detailed: boolean = false): void {
     console.log(chalk.bold('\n📊 Migration Analysis Report'));
     console.log(chalk.gray('─'.repeat(50)));
-    
+
     console.log(`\n${chalk.bold('Project:')} ${analysis.projectPath}`);
     console.log(`${chalk.bold('Timestamp:')} ${analysis.timestamp.toISOString()}`);
-    
+
     // Status
     console.log(chalk.bold('\n📋 Current Status:'));
-    console.log(`  • .claude folder: ${analysis.hasClaudeFolder ? chalk.green('✓') : chalk.red('✗')}`);
-    console.log(`  • Optimized prompts: ${analysis.hasOptimizedPrompts ? chalk.green('✓') : chalk.red('✗')}`);
-    console.log(`  • Custom commands: ${analysis.customCommands.length > 0 ? chalk.yellow(analysis.customCommands.length) : chalk.green('0')}`);
-    console.log(`  • Conflicts: ${analysis.conflictingFiles.length > 0 ? chalk.yellow(analysis.conflictingFiles.length) : chalk.green('0')}`);
-    
+    console.log(
+      `  • .claude folder: ${analysis.hasClaudeFolder ? chalk.green('✓') : chalk.red('✗')}`,
+    );
+    console.log(
+      `  • Optimized prompts: ${analysis.hasOptimizedPrompts ? chalk.green('✓') : chalk.red('✗')}`,
+    );
+    console.log(
+      `  • Custom commands: ${analysis.customCommands.length > 0 ? chalk.yellow(analysis.customCommands.length) : chalk.green('0')}`,
+    );
+    console.log(
+      `  • Conflicts: ${analysis.conflictingFiles.length > 0 ? chalk.yellow(analysis.conflictingFiles.length) : chalk.green('0')}`,
+    );
+
     // Risks
     if (analysis.migrationRisks.length > 0) {
       console.log(chalk.bold('\n⚠️  Migration Risks:'));
-      analysis.migrationRisks.forEach(risk => {
+      analysis.migrationRisks.forEach((risk) => {
         const icon = risk.level === 'high' ? '🔴' : risk.level === 'medium' ? '🟡' : '🟢';
         console.log(`  ${icon} ${chalk.bold(risk.level.toUpperCase())}: ${risk.description}`);
         if (risk.mitigation) {
@@ -253,31 +267,31 @@ export class MigrationAnalyzer {
         }
       });
     }
-    
+
     // Recommendations
     if (analysis.recommendations.length > 0) {
       console.log(chalk.bold('\n💡 Recommendations:'));
-      analysis.recommendations.forEach(rec => {
+      analysis.recommendations.forEach((rec) => {
         console.log(`  • ${rec}`);
       });
     }
-    
+
     // Detailed information
     if (detailed) {
       if (analysis.customCommands.length > 0) {
         console.log(chalk.bold('\n🔧 Custom Commands:'));
-        analysis.customCommands.forEach(cmd => {
+        analysis.customCommands.forEach((cmd) => {
           console.log(`  • ${cmd}`);
         });
       }
-      
+
       if (analysis.conflictingFiles.length > 0) {
         console.log(chalk.bold('\n📁 Conflicting Files:'));
-        analysis.conflictingFiles.forEach(file => {
+        analysis.conflictingFiles.forEach((file) => {
           console.log(`  • ${file}`);
         });
       }
-      
+
       if (Object.keys(analysis.customConfigurations).length > 0) {
         console.log(chalk.bold('\n⚙️  Configurations:'));
         Object.entries(analysis.customConfigurations).forEach(([file, config]) => {
@@ -285,11 +299,11 @@ export class MigrationAnalyzer {
         });
       }
     }
-    
+
     console.log(chalk.gray('\n' + '─'.repeat(50)));
   }
 
   async saveAnalysis(analysis: MigrationAnalysis, outputPath: string): Promise<void> {
     await fs.writeJson(outputPath, analysis, { spaces: 2 });
   }
-}
+}

package/src/migration/migration-manifest.json

@@ -144,11 +144,7 @@
       ".claude/commands/claude-flow-help.md",
       ".claude/BATCHTOOLS_GUIDE.md"
     ],
-    "requiredCommands": [
-      "sparc",
-      "claude-flow-help",
-      "claude-flow-memory"
-    ],
+    "requiredCommands": ["sparc", "claude-flow-help", "claude-flow-memory"],
     "optionalFiles": [
       ".claude/PERFORMANCE_BENCHMARKS.md",
       ".claude/MIGRATION_GUIDE.md"
@@ -174,4 +170,4 @@
       "Progress reporting and logging"
     ]
   }
-}
+}