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

package/src/swarm/prompt-copying-README.md

@@ -5,6 +5,7 @@ A comprehensive, enterprise-grade prompt copying mechanism designed for Claude-F
 ## Features
 
 ### Core Functionality
+
 - ✅ **Parallel Processing**: Multi-threaded copying for faster performance
 - ✅ **Conflict Resolution**: Smart handling of file conflicts (skip, overwrite, backup, merge)
 - ✅ **File Verification**: Hash-based integrity checking
@@ -15,8 +16,9 @@ A comprehensive, enterprise-grade prompt copying mechanism designed for Claude-F
 - ✅ **Dry Run Mode**: Preview operations without making changes
 
 ### Advanced Features
+
 - 🔍 **Pattern Matching**: Flexible include/exclude patterns
-- 📁 **Directory Discovery**: Automatic detection of prompt directories  
+- 📁 **Directory Discovery**: Automatic detection of prompt directories
 - ✅ **File Validation**: Validate prompt files for common issues
 - 🔧 **Configuration Profiles**: Pre-configured settings for different use cases
 - 📊 **Comprehensive Reporting**: Detailed operation reports and statistics
@@ -32,7 +34,7 @@ import { copyPrompts } from './prompt-copier';
 
 const result = await copyPrompts({
   source: './.roo',
-  destination: './project-prompts'
+  destination: './project-prompts',
 });
 
 console.log(`Copied ${result.copiedFiles} files successfully`);
@@ -44,11 +46,11 @@ console.log(`Copied ${result.copiedFiles} files successfully`);
 import { copyPromptsEnhanced } from './prompt-copier-enhanced';
 
 const result = await copyPromptsEnhanced({
-  source: './.roo', 
+  source: './.roo',
   destination: './project-prompts',
   parallel: true,
   maxWorkers: 8,
-  verify: true
+  verify: true,
 });
 ```
 
@@ -59,7 +61,7 @@ import { PromptManager } from './prompt-manager';
 
 const manager = new PromptManager({
   defaultProfile: 'sparc',
-  autoDiscovery: true
+  autoDiscovery: true,
 });
 
 await manager.initialize();
@@ -69,6 +71,7 @@ const result = await manager.copyPrompts();
 ## CLI Usage
 
 ### Installation
+
 ```bash
 npm install -g @claude-flow/prompt-copier
 ```
@@ -97,7 +100,7 @@ npx prompt-copier validate ./prompts --recursive
 # Initialize configuration
 npx prompt-copier config --init
 
-# Show current configuration  
+# Show current configuration
 npx prompt-copier config --show
 
 # Rollback from backup
@@ -110,11 +113,7 @@ npx prompt-copier rollback ./prompts/.prompt-backups/manifest-123456.json
 
 ```json
 {
-  "sourceDirectories": [
-    ".roo",
-    ".claude/commands", 
-    "src/templates"
-  ],
+  "sourceDirectories": [".roo", ".claude/commands", "src/templates"],
   "destinationDirectory": "./project-prompts",
   "defaultOptions": {
     "backup": true,
@@ -150,26 +149,34 @@ npx prompt-copier rollback ./prompts/.prompt-backups/manifest-123456.json
 ### Built-in Profiles
 
 #### `sparc` Profile
+
 Optimized for SPARC methodology prompts:
+
 - Includes: `*.md`, `rules.md`, `sparc-*.md`
 - Excludes: README and changelog files
 - Backup enabled, merge conflicts
 
-#### `templates` Profile  
+#### `templates` Profile
+
 For template files:
+
 - Includes: `*.template`, `*.tmpl`, `*.hbs`, `*.mustache`
 - Merge conflict resolution
 - Template variable preservation
 
 #### `safe` Profile
+
 Conservative copying:
+
 - Backup enabled
 - Verification enabled
 - Skip conflicts (no overwrites)
 - Sequential processing
 
 #### `fast` Profile
+
 Performance optimized:
+
 - No backups
 - No verification
 - Overwrite conflicts
@@ -183,17 +190,17 @@ The main copying class with comprehensive options:
 
 ```typescript
 interface CopyOptions {
-  source: string;                    // Source directory
-  destination: string;               // Destination directory
-  backup?: boolean;                  // Create backups (default: true)
-  overwrite?: boolean;               // Overwrite existing files
-  verify?: boolean;                  // Verify copied files (default: true)
-  preservePermissions?: boolean;     // Preserve file permissions
-  excludePatterns?: string[];        // Exclude patterns
-  includePatterns?: string[];        // Include patterns  
-  parallel?: boolean;                // Enable parallel processing
-  maxWorkers?: number;               // Worker thread count
-  dryRun?: boolean;                  // Preview mode
+  source: string; // Source directory
+  destination: string; // Destination directory
+  backup?: boolean; // Create backups (default: true)
+  overwrite?: boolean; // Overwrite existing files
+  verify?: boolean; // Verify copied files (default: true)
+  preservePermissions?: boolean; // Preserve file permissions
+  excludePatterns?: string[]; // Exclude patterns
+  includePatterns?: string[]; // Include patterns
+  parallel?: boolean; // Enable parallel processing
+  maxWorkers?: number; // Worker thread count
+  dryRun?: boolean; // Preview mode
   conflictResolution?: 'skip' | 'overwrite' | 'backup' | 'merge';
   progressCallback?: (progress: CopyProgress) => void;
 }
@@ -210,7 +217,7 @@ const copier = new EnhancedPromptCopier({
   source: './source',
   destination: './dest',
   parallel: true,
-  maxWorkers: 8
+  maxWorkers: 8,
 });
 
 const result = await copier.copy();
@@ -247,7 +254,7 @@ const sparcSettings = manager.getProfile('sparc');
 
 // Update configuration
 await manager.saveConfig({
-  destinationDirectory: './new-destination'
+  destinationDirectory: './new-destination',
 });
 ```
 
@@ -262,7 +269,7 @@ await manager.initialize();
 
 const result = await manager.copyPrompts({
   verify: true,
-  backup: true
+  backup: true,
 });
 
 if (result.success) {
@@ -306,7 +313,7 @@ const copier = new EnhancedPromptCopier({
   source: './source',
   destination: './dest',
   parallel: true,
-  maxWorkers: 16 // Scale based on CPU cores
+  maxWorkers: 16, // Scale based on CPU cores
 });
 
 // Monitor progress
@@ -327,7 +334,7 @@ await copyPrompts({
   source: './.roo',
   destination: './prompts',
   includePatterns: ['**/rules-*.md', '**/sparc-*.md'],
-  excludePatterns: ['**/debug/**', '**/temp/**']
+  excludePatterns: ['**/debug/**', '**/temp/**'],
 });
 ```
 
@@ -351,7 +358,7 @@ const result = await copyPrompts({
   source: './source',
   destination: './dest',
   backup: true,
-  conflictResolution: 'backup'
+  conflictResolution: 'backup',
 });
 
 // Restore from backup if needed
@@ -364,17 +371,20 @@ if (!result.success && result.backupLocation) {
 ## Performance Considerations
 
 ### Parallel Processing
+
 - Default workers: 4 (good for most systems)
 - High-end systems: 8-16 workers
 - Network storage: Reduce workers to 2-4
 - SSD storage: Can handle more workers
 
 ### Memory Usage
+
 - Large files: Enable streaming mode
 - Many files: Use chunked processing
 - Worker threads: Monitor memory per worker
 
 ### Network Considerations
+
 - Remote sources: Reduce parallelization
 - Slow connections: Disable verification temporarily
 - Bandwidth limits: Use sequential processing
@@ -384,6 +394,7 @@ if (!result.success && result.backupLocation) {
 ### Common Errors and Solutions
 
 **Permission Denied**
+
 ```typescript
 // Solution: Check file permissions
 try {
@@ -396,6 +407,7 @@ try {
 ```
 
 **Disk Space**
+
 ```typescript
 // Solution: Check available space
 import { promises as fs } from 'fs';
@@ -407,12 +419,13 @@ if (stats.bavail * stats.bsize < requiredSpace) {
 ```
 
 **Network Timeouts**
+
 ```typescript
 // Solution: Reduce parallelization
 const options = {
   ...defaultOptions,
   parallel: false, // or reduce maxWorkers
-  timeout: 30000   // increase timeout
+  timeout: 30000, // increase timeout
 };
 ```
 
@@ -439,11 +452,13 @@ npm run test:performance
 ## Troubleshooting
 
 ### Debug Mode
+
 ```bash
 DEBUG=prompt-copier* npx prompt-copier copy --source ./source --destination ./dest
 ```
 
 ### Verbose Logging
+
 ```typescript
 import { logger } from '../logger';
 logger.level = 'debug';
@@ -455,7 +470,7 @@ const result = await copyPrompts(options);
 
 1. **Files not copying**: Check include/exclude patterns
 2. **Slow performance**: Increase worker count or disable verification
-3. **Permission errors**: Check file/directory permissions  
+3. **Permission errors**: Check file/directory permissions
 4. **Memory issues**: Reduce worker count or enable streaming
 5. **Verification failures**: Check disk space and file integrity
 
@@ -475,7 +490,7 @@ npm test
 
 ```bash
 npm run example:basic
-npm run example:enhanced  
+npm run example:enhanced
 npm run example:manager
 ```
 
@@ -494,7 +509,8 @@ MIT License - see LICENSE file for details.
 ## Changelog
 
 ### v1.0.0
+
 - Initial release with core copying functionality
 - Parallel processing with worker threads
 - Configuration profiles and CLI interface
-- Comprehensive testing and documentation
+- Comprehensive testing and documentation

package/src/swarm/prompt-manager.ts

@@ -1,14 +1,13 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 import * as path from 'path';
 import { EventEmitter } from 'events';
 import { copyPromptsEnhanced, EnhancedPromptCopier } from './prompt-copier-enhanced.js';
 import type { CopyOptions, CopyResult } from './prompt-copier.js';
-import { 
-  PromptConfigManager, 
-  PromptPathResolver, 
+import {
+  PromptConfigManager,
+  PromptPathResolver,
   PromptValidator,
   formatDuration,
-  formatFileSize
+  formatFileSize,
 } from './prompt-utils.js';
 import { logger } from '../core/logger.js';
 
@@ -44,56 +43,58 @@ export class PromptManager extends EventEmitter {
 
   constructor(options: PromptManagerOptions = {}) {
     super();
-    
+
     this.options = {
       configPath: options.configPath || '.prompt-config.json',
       basePath: options.basePath || process.cwd(),
       autoDiscovery: options.autoDiscovery ?? true,
-      defaultProfile: options.defaultProfile || 'sparc'
+      defaultProfile: options.defaultProfile || 'sparc',
     };
 
     this.configManager = new PromptConfigManager(
-      path.resolve(this.options.basePath, this.options.configPath)
+      path.resolve(this.options.basePath, this.options.configPath),
     );
     this.pathResolver = new PromptPathResolver(this.options.basePath);
   }
 
   async initialize(): Promise<void> {
     logger.info('Initializing PromptManager...');
-    
+
     // Load configuration
     await this.configManager.loadConfig();
-    
+
     // Auto-discover prompt directories if enabled
     if (this.options.autoDiscovery) {
       const discovered = await this.pathResolver.discoverPromptDirectories();
       if (discovered.length > 0) {
         logger.info(`Auto-discovered ${discovered.length} prompt directories`);
-        
+
         // Update config with discovered directories
         const config = this.configManager.getConfig();
-        const uniqueDirs = Array.from(new Set([
-          ...config.sourceDirectories,
-          ...discovered.map(dir => path.relative(this.options.basePath, dir))
-        ]));
-        
+        const uniqueDirs = Array.from(
+          new Set([
+            ...config.sourceDirectories,
+            ...discovered.map((dir) => path.relative(this.options.basePath, dir)),
+          ]),
+        );
+
         await this.configManager.saveConfig({
-          sourceDirectories: uniqueDirs
+          sourceDirectories: uniqueDirs,
         });
       }
     }
-    
+
     this.emit('initialized');
   }
 
   async copyPrompts(options: Partial<CopyOptions> = {}): Promise<CopyResult> {
     const config = this.configManager.getConfig();
     const profile = this.options.defaultProfile;
-    
+
     // Resolve paths
     const resolved = this.pathResolver.resolvePaths(
       config.sourceDirectories,
-      config.destinationDirectory
+      config.destinationDirectory,
     );
 
     if (resolved.sources.length === 0) {
@@ -105,22 +106,21 @@ export class PromptManager extends EventEmitter {
       source: resolved.sources[0], // Use first available source
       destination: resolved.destination,
       ...this.configManager.getProfile(profile),
-      ...options
+      ...options,
     };
 
     logger.info('Starting prompt copy operation', {
       source: copyOptions.source,
       destination: copyOptions.destination,
-      profile
+      profile,
     });
 
     this.emit('copyStart', copyOptions);
 
     try {
-      const result = await (copyOptions.parallel ? 
-        copyPromptsEnhanced(copyOptions) : 
-        copyPrompts(copyOptions)
-      );
+      const result = await (copyOptions.parallel
+        ? copyPromptsEnhanced(copyOptions)
+        : copyPrompts(copyOptions));
 
       this.emit('copyComplete', result);
       return result;
@@ -134,29 +134,29 @@ export class PromptManager extends EventEmitter {
     const config = this.configManager.getConfig();
     const resolved = this.pathResolver.resolvePaths(
       config.sourceDirectories,
-      config.destinationDirectory
+      config.destinationDirectory,
     );
 
     const results: CopyResult[] = [];
-    
+
     for (const source of resolved.sources) {
       try {
         const copyOptions: CopyOptions = {
           source,
           destination: resolved.destination,
           ...this.configManager.getProfile(this.options.defaultProfile),
-          ...options
+          ...options,
         };
 
         logger.info(`Copying from source: ${source}`);
         const result = await copyPrompts(copyOptions);
         results.push(result);
-        
+
         this.emit('sourceComplete', { source, result });
       } catch (error) {
         logger.error(`Failed to copy from ${source}:`, error);
         this.emit('sourceError', { source, error });
-        
+
         // Add error result
         results.push({
           success: false,
@@ -164,8 +164,14 @@ export class PromptManager extends EventEmitter {
           copiedFiles: 0,
           failedFiles: 0,
           skippedFiles: 0,
-          errors: [{ file: source, error: (error instanceof Error ? error.message : String(error)), phase: 'read' }],
-          duration: 0
+          errors: [
+            {
+              file: source,
+              error: error instanceof Error ? error.message : String(error),
+              phase: 'read',
+            },
+          ],
+          duration: 0,
         });
       }
     }
@@ -176,11 +182,8 @@ export class PromptManager extends EventEmitter {
   async validatePrompts(sourcePath?: string): Promise<ValidationReport> {
     const config = this.configManager.getConfig();
     const sources = sourcePath ? [sourcePath] : config.sourceDirectories;
-    
-    const resolved = this.pathResolver.resolvePaths(
-      sources,
-      config.destinationDirectory
-    );
+
+    const resolved = this.pathResolver.resolvePaths(sources, config.destinationDirectory);
 
     let totalFiles = 0;
     let validFiles = 0;
@@ -192,36 +195,39 @@ export class PromptManager extends EventEmitter {
     }
 
     totalFiles = issues.length;
-    validFiles = issues.filter(issue => issue.issues.length === 0).length;
+    validFiles = issues.filter((issue) => issue.issues.length === 0).length;
     invalidFiles = totalFiles - validFiles;
 
     const report: ValidationReport = {
       totalFiles,
       validFiles,
       invalidFiles,
-      issues: issues.filter(issue => issue.issues.length > 0) // Only include files with issues
+      issues: issues.filter((issue) => issue.issues.length > 0), // Only include files with issues
     };
 
     this.emit('validationComplete', report);
     return report;
   }
 
-  private async validateDirectory(dirPath: string, issues: ValidationReport['issues']): Promise<void> {
+  private async validateDirectory(
+    dirPath: string,
+    issues: ValidationReport['issues'],
+  ): Promise<void> {
     const fs = require('fs').promises;
-    
+
     try {
       const entries = await fs.readdir(dirPath, { withFileTypes: true });
-      
+
       for (const entry of entries) {
         const fullPath = path.join(dirPath, entry.name);
-        
+
         if (entry.isFile() && this.isPromptFile(entry.name)) {
           const result = await PromptValidator.validatePromptFile(fullPath);
-          
+
           issues.push({
             file: fullPath,
             issues: result.issues,
-            metadata: result.metadata
+            metadata: result.metadata,
           });
         } else if (entry.isDirectory()) {
           await this.validateDirectory(fullPath, issues);
@@ -235,8 +241,8 @@ export class PromptManager extends EventEmitter {
   private isPromptFile(fileName: string): boolean {
     const config = this.configManager.getConfig();
     const patterns = config.defaultOptions.includePatterns;
-    
-    return patterns.some(pattern => {
+
+    return patterns.some((pattern) => {
       const regex = pattern.replace(/\./g, '\\.').replace(/\*/g, '.*');
       return new RegExp(regex).test(fileName);
     });
@@ -249,7 +255,7 @@ export class PromptManager extends EventEmitter {
     const config = this.configManager.getConfig();
     const resolved = this.pathResolver.resolvePaths(
       config.sourceDirectories,
-      config.destinationDirectory
+      config.destinationDirectory,
     );
 
     const syncOptions: SyncOptions = {
@@ -257,14 +263,14 @@ export class PromptManager extends EventEmitter {
       deleteOrphaned: false,
       compareHashes: true,
       incrementalOnly: true,
-      ...options
+      ...options,
     };
 
     // Forward sync (source to destination)
     const forwardResult = await this.performIncrementalSync(
       resolved.sources[0],
       resolved.destination,
-      syncOptions
+      syncOptions,
     );
 
     let backwardResult: CopyResult | undefined;
@@ -274,20 +280,20 @@ export class PromptManager extends EventEmitter {
       backwardResult = await this.performIncrementalSync(
         resolved.destination,
         resolved.sources[0],
-        syncOptions
+        syncOptions,
       );
     }
 
     return {
       forward: forwardResult,
-      backward: backwardResult
+      backward: backwardResult,
     };
   }
 
   private async performIncrementalSync(
     source: string,
     destination: string,
-    options: SyncOptions
+    options: SyncOptions,
   ): Promise<CopyResult> {
     // This would implement incremental sync logic
     // For now, we'll use the regular copy with overwrite
@@ -295,7 +301,7 @@ export class PromptManager extends EventEmitter {
       source,
       destination,
       conflictResolution: 'overwrite',
-      verify: options.compareHashes
+      verify: options.compareHashes,
     });
   }
 
@@ -317,7 +323,7 @@ export class PromptManager extends EventEmitter {
     const config = this.configManager.getConfig();
     const resolved = this.pathResolver.resolvePaths(
       config.sourceDirectories,
-      config.destinationDirectory
+      config.destinationDirectory,
     );
 
     // Analyze sources
@@ -326,7 +332,7 @@ export class PromptManager extends EventEmitter {
         try {
           const fs = require('fs').promises;
           const stats = await fs.stat(sourcePath);
-          
+
           if (!stats.isDirectory()) {
             return { path: sourcePath, exists: false };
           }
@@ -337,10 +343,10 @@ export class PromptManager extends EventEmitter {
 
           const scanDir = async (dir: string) => {
             const entries = await fs.readdir(dir, { withFileTypes: true });
-            
+
             for (const entry of entries) {
               const fullPath = path.join(dir, entry.name);
-              
+
               if (entry.isFile() && this.isPromptFile(entry.name)) {
                 const fileStats = await fs.stat(fullPath);
                 fileCount++;
@@ -357,17 +363,17 @@ export class PromptManager extends EventEmitter {
             path: sourcePath,
             exists: true,
             fileCount,
-            totalSize
+            totalSize,
           };
         } catch {
           return { path: sourcePath, exists: false };
         }
-      })
+      }),
     );
 
     return {
       configuration: config,
-      sources
+      sources,
     };
   }
 
@@ -406,4 +412,4 @@ export function getDefaultPromptManager(): PromptManager {
     defaultManager = new PromptManager();
   }
   return defaultManager;
-}
+}