claude-flow 2.0.0-alpha.7 → 2.0.0-alpha.71

package/src/cli/completion.ts

@@ -1,4 +1,3 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 /**
  * Shell completion generator for Claude-Flow CLI
  */
@@ -8,8 +7,18 @@ import { promises as fs } from 'node:fs';
 
 export class CompletionGenerator {
   private commands = [
-    'start', 'agent', 'task', 'memory', 'config', 'status', 
-    'monitor', 'session', 'workflow', 'repl', 'version', 'completion'
+    'start',
+    'agent',
+    'task',
+    'memory',
+    'config',
+    'status',
+    'monitor',
+    'session',
+    'workflow',
+    'repl',
+    'version',
+    'completion',
   ];
 
   private subcommands = {
@@ -23,7 +32,7 @@ export class CompletionGenerator {
 
   async generate(shell: string, install: boolean = false): Promise<void> {
     const detectedShell = shell === 'detect' ? await this.detectShell() : shell;
-    
+
     switch (detectedShell) {
       case 'bash':
         await this.generateBashCompletion(install);
@@ -43,18 +52,18 @@ export class CompletionGenerator {
 
   private async detectShell(): Promise<string> {
     const shell = process.env['SHELL'] || '';
-    
+
     if (shell.includes('bash')) return 'bash';
     if (shell.includes('zsh')) return 'zsh';
     if (shell.includes('fish')) return 'fish';
-    
+
     console.log(chalk.yellow('Could not detect shell, defaulting to bash'));
     return 'bash';
   }
 
   private async generateBashCompletion(install: boolean): Promise<void> {
     const script = this.getBashCompletionScript();
-    
+
     if (install) {
       await this.installBashCompletion(script);
     } else {
@@ -64,7 +73,7 @@ export class CompletionGenerator {
 
   private async generateZshCompletion(install: boolean): Promise<void> {
     const script = this.getZshCompletionScript();
-    
+
     if (install) {
       await this.installZshCompletion(script);
     } else {
@@ -74,7 +83,7 @@ export class CompletionGenerator {
 
   private async generateFishCompletion(install: boolean): Promise<void> {
     const script = this.getFishCompletionScript();
-    
+
     if (install) {
       await this.installFishCompletion(script);
     } else {
@@ -476,7 +485,7 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
       '/etc/bash_completion.d/claude-flow',
       '/usr/local/etc/bash_completion.d/claude-flow',
       `${process.env['HOME']}/.local/share/bash-completion/completions/claude-flow`,
-      `${process.env['HOME']}/.bash_completion.d/claude-flow`
+      `${process.env['HOME']}/.bash_completion.d/claude-flow`,
     ];
 
     for (const path of possiblePaths) {
@@ -484,7 +493,7 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
         const dir = path.substring(0, path.lastIndexOf('/'));
         await Deno.mkdir(dir, { recursive: true });
         await fs.writeFile(path, script);
-        
+
         console.log(chalk.green('✓ Bash completion installed'));
         console.log(`${chalk.white('Location:')} ${path}`);
         console.log(chalk.gray('Restart your shell or run: source ~/.bashrc'));
@@ -496,14 +505,16 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
     }
 
     console.error(chalk.red('Failed to install bash completion'));
-    console.log(chalk.gray('You can manually save the completion script to a bash completion directory'));
+    console.log(
+      chalk.gray('You can manually save the completion script to a bash completion directory'),
+    );
   }
 
   private async installZshCompletion(script: string): Promise<void> {
     const possiblePaths = [
       `${process.env['HOME']}/.zsh/completions/_claude-flow`,
       '/usr/local/share/zsh/site-functions/_claude-flow',
-      '/usr/share/zsh/site-functions/_claude-flow'
+      '/usr/share/zsh/site-functions/_claude-flow',
     ];
 
     for (const path of possiblePaths) {
@@ -511,7 +522,7 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
         const dir = path.substring(0, path.lastIndexOf('/'));
         await Deno.mkdir(dir, { recursive: true });
         await fs.writeFile(path, script);
-        
+
         console.log(chalk.green('✓ Zsh completion installed'));
         console.log(`${chalk.white('Location:')} ${path}`);
         console.log(chalk.gray('Restart your shell or run: autoload -U compinit && compinit'));
@@ -523,14 +534,16 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
     }
 
     console.error(chalk.red('Failed to install zsh completion'));
-    console.log(chalk.gray('You can manually save the completion script to your zsh completion directory'));
+    console.log(
+      chalk.gray('You can manually save the completion script to your zsh completion directory'),
+    );
   }
 
   private async installFishCompletion(script: string): Promise<void> {
     const possiblePaths = [
       `${process.env['HOME']}/.config/fish/completions/claude-flow.fish`,
       '/usr/local/share/fish/completions/claude-flow.fish',
-      '/usr/share/fish/completions/claude-flow.fish'
+      '/usr/share/fish/completions/claude-flow.fish',
     ];
 
     for (const path of possiblePaths) {
@@ -538,7 +551,7 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
         const dir = path.substring(0, path.lastIndexOf('/'));
         await Deno.mkdir(dir, { recursive: true });
         await fs.writeFile(path, script);
-        
+
         console.log(chalk.green('✓ Fish completion installed'));
         console.log(`${chalk.white('Location:')} ${path}`);
         console.log(chalk.gray('Completions will be available in new fish sessions'));
@@ -550,6 +563,8 @@ complete -f -c claude-flow -n '__fish_claude_flow_using_command completion' -a '
     }
 
     console.error(chalk.red('Failed to install fish completion'));
-    console.log(chalk.gray('You can manually save the completion script to your fish completion directory'));
+    console.log(
+      chalk.gray('You can manually save the completion script to your fish completion directory'),
+    );
   }
-}
+}

package/src/cli/create-enhanced-task.js

@@ -107,18 +107,26 @@ Bash("npx claude-flow status")
 Bash("npx claude-flow monitor")  # Real-time monitoring
 Bash("npx claude-flow agent list")
 Bash("npx claude-flow task list --verbose")
-${flags.parallel ? `
+${
+  flags.parallel
+    ? `
 # Parallel Execution (enabled for this instance)
 Bash("npx claude-flow agent spawn researcher --name research-bot")
 Bash("npx claude-flow agent spawn coder --name code-bot")
 Bash("npx claude-flow task create research 'Analyze best practices'")
 Bash("npx claude-flow task create implementation 'Implement auth module'")
-Bash("npx claude-flow task assign task-123 agent-456")` : ''}
-${flags.research ? `
+Bash("npx claude-flow task assign task-123 agent-456")`
+    : ''
+}
+${
+  flags.research
+    ? `
 # Research Operations (research mode enabled)
 # Use WebFetchTool for web research, then store findings
 Bash("npx claude-flow memory store web_research_urls '[\\"url1\\", \\"url2\\"]'")
-Bash("npx claude-flow memory store research_summary 'Key findings from research...'")` : ''}
+Bash("npx claude-flow memory store research_summary 'Key findings from research...'")`
+    : ''
+}
 
 # Configuration Management
 Bash("npx claude-flow config show")
@@ -131,30 +139,46 @@ Bash("npx claude-flow workflow examples/research-workflow.json --async")
 \`\`\`
 
 ## Mode-Specific Guidelines
-${flags.mode === 'backend-only' ? `
+${
+  flags.mode === 'backend-only'
+    ? `
 ### Backend-Only Mode
 - Focus exclusively on server-side implementation
 - Prioritize API design, database schemas, and business logic
 - Ignore frontend/UI considerations
-- Test coverage should emphasize unit and integration tests` : ''}
-${flags.mode === 'frontend-only' ? `
+- Test coverage should emphasize unit and integration tests`
+    : ''
+}
+${
+  flags.mode === 'frontend-only'
+    ? `
 ### Frontend-Only Mode
 - Focus exclusively on client-side implementation
 - Prioritize UI/UX, component design, and user interactions
 - Assume backend APIs are already available
-- Test coverage should emphasize component and E2E tests` : ''}
-${flags.mode === 'api-only' ? `
+- Test coverage should emphasize component and E2E tests`
+    : ''
+}
+${
+  flags.mode === 'api-only'
+    ? `
 ### API-Only Mode
 - Focus exclusively on API design and implementation
 - Prioritize RESTful principles, documentation, and contracts
 - Include comprehensive API documentation
-- Test coverage should emphasize API endpoint testing` : ''}
-${flags.mode === 'full' || !flags.mode ? `
+- Test coverage should emphasize API endpoint testing`
+    : ''
+}
+${
+  flags.mode === 'full' || !flags.mode
+    ? `
 ### Full Stack Mode (Default)
 - Consider both frontend and backend requirements
 - Ensure proper integration between all layers
 - Balance test coverage across all components
-- Document both API contracts and user interfaces` : ''}
+- Document both API contracts and user interfaces`
+    : ''
+}
 
 ## Commit Strategy
 ${flags.commit === 'phase' ? `- **Phase Commits**: Commit after completing major phases (planning, implementation, testing)` : ''}
@@ -163,19 +187,27 @@ ${flags.commit === 'manual' ? `- **Manual Commits**: Only commit when explicitly
 ${!flags.commit ? `- **Default (Phase)**: Commit after completing major phases` : ''}
 
 ## Additional Guidelines
-${flags.noPermissions ? `
+${
+  flags.noPermissions
+    ? `
 ### No-Permissions Mode
 - All file operations will execute without confirmation prompts
 - Be extra careful with destructive operations
-- Ensure all changes are intentional and well-tested` : ''}
-${flags.verbose ? `
+- Ensure all changes are intentional and well-tested`
+    : ''
+}
+${
+  flags.verbose
+    ? `
 ### Verbose Mode
 - Provide detailed explanations for all actions
 - Include reasoning behind technical decisions
 - Show intermediate steps and thought processes
-- Log all command outputs comprehensively` : ''}
+- Log all command outputs comprehensively`
+    : ''
+}
 
 Now, please proceed with the task: ${task}`;
 
   return enhancedTask;
-}
+}

package/src/cli/formatter.ts

@@ -1,4 +1,3 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 /**
  * Output formatting utilities for CLI
  */
@@ -14,19 +13,19 @@ import * as process from 'process';
  */
 export function formatError(error: unknown): string {
   if (error instanceof Error) {
-    let message = (error instanceof Error ? error.message : String(error));
-    
+    let message = error instanceof Error ? error.message : String(error);
+
     if ('code' in error) {
       message = `[${(error as any).code}] ${message}`;
     }
-    
+
     if ('details' in error && (error as any).details) {
       message += '\n' + chalk.gray('Details: ' + JSON.stringify((error as any).details, null, 2));
     }
-    
+
     return message;
   }
-  
+
   return String(error);
 }
 
@@ -42,7 +41,7 @@ export function formatAgent(agent: AgentProfile): string {
     chalk.gray(`Max Tasks: ${agent.maxConcurrentTasks}`),
     chalk.gray(`Capabilities: ${agent.capabilities.join(', ')}`),
   ];
-  
+
   return lines.join('\n');
 }
 
@@ -50,15 +49,16 @@ export function formatAgent(agent: AgentProfile): string {
  * Formats a task for display
  */
 export function formatTask(task: Task): string {
-  const statusColor = {
-    pending: chalk.gray,
-    queued: chalk.yellow,
-    assigned: chalk.blue,
-    running: chalk.cyan,
-    completed: chalk.green,
-    failed: chalk.red,
-    cancelled: chalk.magenta,
-  }[task.status] || chalk.white;
+  const statusColor =
+    {
+      pending: chalk.gray,
+      queued: chalk.yellow,
+      assigned: chalk.blue,
+      running: chalk.cyan,
+      completed: chalk.green,
+      failed: chalk.red,
+      cancelled: chalk.magenta,
+    }[task.status] || chalk.white;
 
   const lines = [
     chalk.yellow.bold(`Task: ${task.description}`),
@@ -130,7 +130,7 @@ export function formatHealthStatus(health: HealthStatus): string {
     }[component.status];
 
     lines.push(compColor(`  ${name}: ${component.status}`));
-    
+
     if (component.error) {
       lines.push(chalk.red(`    Error: ${component.error}`));
     }
@@ -150,7 +150,7 @@ export function formatHealthStatus(health: HealthStatus): string {
  */
 export function createAgentTable(agents: AgentProfile[]): any {
   const table = new Table({
-    head: ['ID', 'Name', 'Type', 'Priority', 'Max Tasks']
+    head: ['ID', 'Name', 'Type', 'Priority', 'Max Tasks'],
   });
 
   for (const agent of agents) {
@@ -171,19 +171,20 @@ export function createAgentTable(agents: AgentProfile[]): any {
  */
 export function createTaskTable(tasks: Task[]): any {
   const table = new Table({
-    head: ['ID', 'Type', 'Description', 'Status', 'Agent']
+    head: ['ID', 'Type', 'Description', 'Status', 'Agent'],
   });
 
   for (const task of tasks) {
-    const statusCell = {
-      pending: chalk.gray(task.status),
-      queued: chalk.yellow(task.status),
-      assigned: chalk.blue(task.status),
-      running: chalk.cyan(task.status),
-      completed: chalk.green(task.status),
-      failed: chalk.red(task.status),
-      cancelled: chalk.magenta(task.status),
-    }[task.status] || task.status;
+    const statusCell =
+      {
+        pending: chalk.gray(task.status),
+        queued: chalk.yellow(task.status),
+        assigned: chalk.blue(task.status),
+        running: chalk.cyan(task.status),
+        completed: chalk.green(task.status),
+        failed: chalk.red(task.status),
+        cancelled: chalk.magenta(task.status),
+      }[task.status] || task.status;
 
     table.push([
       task.id,
@@ -204,7 +205,7 @@ export function formatDuration(ms: number): string {
   if (ms < 1000) {
     return `${ms}ms`;
   }
-  
+
   const seconds = Math.floor(ms / 1000);
   const minutes = Math.floor(seconds / 60);
   const hours = Math.floor(minutes / 60);
@@ -219,7 +220,7 @@ export function formatDuration(ms: number): string {
   if (minutes > 0) {
     return `${minutes}m ${seconds % 60}s`;
   }
-  
+
   return `${seconds}s`;
 }
 
@@ -256,9 +257,9 @@ export function displayVersion(version: string, buildDate: string): void {
     chalk.white('  • MCP Server'),
     chalk.white('  • Task Coordination'),
     '',
-    chalk.blue('Homepage: ') + chalk.underline('https://github.com/anthropics/claude-code-flow'),
+    chalk.blue('Homepage: ') + chalk.underline('https://github.com/ruvnet/claude-flow'),
   ];
-  
+
   console.log(info.join('\n'));
 }
 
@@ -269,20 +270,20 @@ export function formatProgressBar(
   current: number,
   total: number,
   width: number = 40,
-  label?: string
+  label?: string,
 ): string {
   const percentage = Math.min(100, (current / total) * 100);
   const filled = Math.floor((percentage / 100) * width);
   const empty = width - filled;
-  
+
   const bar = chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
   const percent = percentage.toFixed(1).padStart(5) + '%';
-  
+
   let result = `[${bar}] ${percent}`;
   if (label) {
     result = `${label}: ${result}`;
   }
-  
+
   return result;
 }
 
@@ -298,7 +299,7 @@ export function formatStatusIndicator(status: string): string {
     running: chalk.cyan('⟳'),
     pending: chalk.gray('○'),
   };
-  
+
   return indicators[status as keyof typeof indicators] || status;
 }
 
@@ -330,4 +331,4 @@ export function formatSpinner(message: string, frame: number = 0): string {
   const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
   const spinner = chalk.cyan(frames[frame % frames.length]);
   return `${spinner} ${message}`;
-}
+}

package/src/cli/help-formatter.js

@@ -0,0 +1,145 @@
+/**
+ * Standardized CLI Help Formatter
+ * Follows Unix/Linux conventions for help output
+ */
+
+export class HelpFormatter {
+  static INDENT = '    ';
+  static COLUMN_GAP = 2;
+  static MIN_DESCRIPTION_COLUMN = 25;
+
+  /**
+   * Format main command help
+   */
+  static formatHelp(info) {
+    const sections = [];
+
+    // NAME section
+    sections.push(this.formatSection('NAME', [`${info.name} - ${info.description}`]));
+
+    // SYNOPSIS section
+    if (info.usage) {
+      sections.push(this.formatSection('SYNOPSIS', [info.usage]));
+    }
+
+    // COMMANDS section
+    if (info.commands && info.commands.length > 0) {
+      sections.push(this.formatSection('COMMANDS', this.formatCommands(info.commands)));
+    }
+
+    // OPTIONS section
+    if (info.options && info.options.length > 0) {
+      sections.push(this.formatSection('OPTIONS', this.formatOptions(info.options)));
+    }
+
+    // GLOBAL OPTIONS section
+    if (info.globalOptions && info.globalOptions.length > 0) {
+      sections.push(this.formatSection('GLOBAL OPTIONS', this.formatOptions(info.globalOptions)));
+    }
+
+    // EXAMPLES section
+    if (info.examples && info.examples.length > 0) {
+      sections.push(this.formatSection('EXAMPLES', info.examples));
+    }
+
+    // Footer
+    if (info.commands && info.commands.length > 0) {
+      sections.push(`Run '${info.name} <command> --help' for more information on a command.`);
+    }
+
+    return sections.join('\n\n');
+  }
+
+  /**
+   * Format error message with usage hint
+   */
+  static formatError(error, command, usage) {
+    const lines = [`Error: ${error}`, ''];
+
+    if (usage) {
+      lines.push(`Usage: ${usage}`);
+    }
+
+    lines.push(`Try '${command} --help' for more information.`);
+
+    return lines.join('\n');
+  }
+
+  /**
+   * Format validation error with valid options
+   */
+  static formatValidationError(value, paramName, validOptions, command) {
+    return this.formatError(
+      `'${value}' is not a valid ${paramName}. Valid options are: ${validOptions.join(', ')}.`,
+      command,
+    );
+  }
+
+  static formatSection(title, content) {
+    return `${title}\n${content.map((line) => `${this.INDENT}${line}`).join('\n')}`;
+  }
+
+  static formatCommands(commands) {
+    const maxNameLength = Math.max(
+      this.MIN_DESCRIPTION_COLUMN,
+      ...commands.map((cmd) => {
+        const nameLength = cmd.name.length;
+        const aliasLength = cmd.aliases ? ` (${cmd.aliases.join(', ')})`.length : 0;
+        return nameLength + aliasLength;
+      }),
+    );
+
+    return commands.map((cmd) => {
+      let name = cmd.name;
+      if (cmd.aliases && cmd.aliases.length > 0) {
+        name += ` (${cmd.aliases.join(', ')})`;
+      }
+      const padding = ' '.repeat(maxNameLength - name.length + this.COLUMN_GAP);
+      return `${name}${padding}${cmd.description}`;
+    });
+  }
+
+  static formatOptions(options) {
+    const maxFlagsLength = Math.max(
+      this.MIN_DESCRIPTION_COLUMN,
+      ...options.map((opt) => opt.flags.length),
+    );
+
+    return options.map((opt) => {
+      const padding = ' '.repeat(maxFlagsLength - opt.flags.length + this.COLUMN_GAP);
+      let description = opt.description;
+
+      // Add default value
+      if (opt.defaultValue !== undefined) {
+        description += ` [default: ${opt.defaultValue}]`;
+      }
+
+      // Add valid values on next line if present
+      if (opt.validValues && opt.validValues.length > 0) {
+        const validValuesLine =
+          ' '.repeat(maxFlagsLength + this.COLUMN_GAP) + `Valid: ${opt.validValues.join(', ')}`;
+        return `${opt.flags}${padding}${description}\n${this.INDENT}${validValuesLine}`;
+      }
+
+      return `${opt.flags}${padding}${description}`;
+    });
+  }
+
+  /**
+   * Strip ANSI color codes and emojis from text
+   */
+  static stripFormatting(text) {
+    // Remove ANSI color codes
+    text = text.replace(/\x1b\[[0-9;]*m/g, '');
+
+    // Remove common emojis used in the CLI
+    const emojiPattern =
+      /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{27BF}]|[\u{1F000}-\u{1F6FF}]|[\u{1F680}-\u{1F6FF}]/gu;
+    text = text.replace(emojiPattern, '').trim();
+
+    // Remove multiple spaces
+    text = text.replace(/\s+/g, ' ');
+
+    return text;
+  }
+}