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

package/dist/cli/commands/help.js

@@ -46,9 +46,9 @@ const HELP_TOPICS = [
             'You can also use the interactive REPL mode:',
             '   claude-flow repl',
             '',
-            'For more help, try: claude-flow help <topic>'
+            'For more help, try: claude-flow help <topic>',
         ],
-        related: ['agents', 'tasks', 'configuration']
+        related: ['agents', 'tasks', 'configuration'],
     },
     {
         name: 'agents',
@@ -58,23 +58,23 @@ const HELP_TOPICS = [
             {
                 description: 'Spawn a research agent',
                 command: 'claude-flow agent spawn researcher --name "Research Assistant"',
-                explanation: 'Creates a new research agent with specialized capabilities for information gathering'
+                explanation: 'Creates a new research agent with specialized capabilities for information gathering',
             },
             {
                 description: 'List all active agents',
                 command: 'claude-flow agent list',
-                explanation: 'Shows all currently running agents with their status and task counts'
+                explanation: 'Shows all currently running agents with their status and task counts',
             },
             {
                 description: 'Get detailed agent information',
                 command: 'claude-flow agent info agent-001',
-                explanation: 'Displays comprehensive information about a specific agent'
+                explanation: 'Displays comprehensive information about a specific agent',
             },
             {
                 description: 'Terminate an agent',
                 command: 'claude-flow agent terminate agent-001',
-                explanation: 'Safely shuts down an agent and reassigns its tasks'
-            }
+                explanation: 'Safely shuts down an agent and reassigns its tasks',
+            },
         ],
         tutorial: [
             'Agents are the core workers in Claude-Flow. Each agent has:',
@@ -95,9 +95,9 @@ const HELP_TOPICS = [
             '• Use descriptive names for your agents',
             '• Match agent types to your workflow needs',
             '• Monitor agent performance with "claude-flow status"',
-            '• Terminate idle agents to free resources'
+            '• Terminate idle agents to free resources',
         ],
-        related: ['tasks', 'workflows', 'coordination']
+        related: ['tasks', 'workflows', 'coordination'],
     },
     {
         name: 'tasks',
@@ -107,28 +107,28 @@ const HELP_TOPICS = [
             {
                 description: 'Create a research task',
                 command: 'claude-flow task create research "Find papers on quantum computing" --priority 5',
-                explanation: 'Creates a high-priority research task with specific instructions'
+                explanation: 'Creates a high-priority research task with specific instructions',
             },
             {
                 description: 'Create a task with dependencies',
                 command: 'claude-flow task create analysis "Analyze research results" --dependencies task-001',
-                explanation: 'Creates a task that waits for task-001 to complete before starting'
+                explanation: 'Creates a task that waits for task-001 to complete before starting',
             },
             {
                 description: 'Assign task to specific agent',
                 command: 'claude-flow task create implementation "Write API client" --assign agent-003',
-                explanation: 'Directly assigns a task to a specific agent'
+                explanation: 'Directly assigns a task to a specific agent',
             },
             {
                 description: 'Monitor task progress',
                 command: 'claude-flow task status task-001',
-                explanation: 'Shows detailed status and progress information for a task'
+                explanation: 'Shows detailed status and progress information for a task',
             },
             {
                 description: 'Cancel a running task',
                 command: 'claude-flow task cancel task-001 --reason "Requirements changed"',
-                explanation: 'Stops a task and provides a reason for cancellation'
-            }
+                explanation: 'Stops a task and provides a reason for cancellation',
+            },
         ],
         tutorial: [
             'Tasks are units of work that agents execute. Key concepts:',
@@ -153,9 +153,9 @@ const HELP_TOPICS = [
             '• Tasks can depend on other tasks',
             '• Dependencies must complete before task starts',
             '• Use for sequential workflows',
-            '• Circular dependencies are not allowed'
+            '• Circular dependencies are not allowed',
         ],
-        related: ['agents', 'workflows', 'coordination']
+        related: ['agents', 'workflows', 'coordination'],
     },
     {
         name: 'claude',
@@ -165,28 +165,28 @@ const HELP_TOPICS = [
             {
                 description: 'Spawn Claude with web research capabilities',
                 command: 'claude-flow claude spawn "implement user authentication" --research --parallel',
-                explanation: 'Creates a Claude instance with WebFetchTool and BatchTool for parallel web research'
+                explanation: 'Creates a Claude instance with WebFetchTool and BatchTool for parallel web research',
             },
             {
                 description: 'Spawn Claude without permission prompts',
                 command: 'claude-flow claude spawn "fix payment bug" --no-permissions',
-                explanation: 'Runs Claude with --dangerously-skip-permissions flag to avoid interruptions'
+                explanation: 'Runs Claude with --dangerously-skip-permissions flag to avoid interruptions',
             },
             {
                 description: 'Spawn Claude with custom tools',
                 command: 'claude-flow claude spawn "analyze codebase" --tools "View,Edit,GrepTool,LS"',
-                explanation: 'Specifies exactly which tools Claude can use for the task'
+                explanation: 'Specifies exactly which tools Claude can use for the task',
             },
             {
                 description: 'Spawn Claude with test coverage target',
                 command: 'claude-flow claude spawn "write unit tests" --coverage 95 --commit feature',
-                explanation: 'Sets test coverage goal to 95% and commits after each feature'
+                explanation: 'Sets test coverage goal to 95% and commits after each feature',
             },
             {
                 description: 'Dry run to preview command',
                 command: 'claude-flow claude spawn "build API" --mode backend-only --dry-run',
-                explanation: 'Shows what would be executed without actually running Claude'
-            }
+                explanation: 'Shows what would be executed without actually running Claude',
+            },
         ],
         tutorial: [
             'The claude spawn command launches Claude instances with specific configurations.',
@@ -214,9 +214,9 @@ const HELP_TOPICS = [
             '• API development: --mode backend-only --coverage 90',
             '• Bug fixing: --no-permissions --verbose',
             '• Research tasks: --research --parallel',
-            '• Test writing: --coverage 95 --commit feature'
+            '• Test writing: --coverage 95 --commit feature',
         ],
-        related: ['agents', 'tasks', 'workflows']
+        related: ['agents', 'tasks', 'workflows'],
     },
     {
         name: 'workflows',
@@ -226,28 +226,28 @@ const HELP_TOPICS = [
             {
                 description: 'Run a workflow from file',
                 command: 'claude-flow workflow run research-pipeline.json --watch',
-                explanation: 'Executes a workflow definition and monitors progress in real-time'
+                explanation: 'Executes a workflow definition and monitors progress in real-time',
             },
             {
                 description: 'Validate workflow before running',
                 command: 'claude-flow workflow validate my-workflow.json --strict',
-                explanation: 'Checks workflow syntax and dependencies without executing'
+                explanation: 'Checks workflow syntax and dependencies without executing',
             },
             {
                 description: 'Generate workflow template',
                 command: 'claude-flow workflow template research --output research-workflow.json',
-                explanation: 'Creates a pre-configured workflow template for research tasks'
+                explanation: 'Creates a pre-configured workflow template for research tasks',
             },
             {
                 description: 'Monitor running workflows',
                 command: 'claude-flow workflow list --all',
-                explanation: 'Shows all workflows including completed ones'
+                explanation: 'Shows all workflows including completed ones',
             },
             {
                 description: 'Stop a running workflow',
                 command: 'claude-flow workflow stop workflow-001 --force',
-                explanation: 'Immediately stops all tasks in a workflow'
-            }
+                explanation: 'Immediately stops all tasks in a workflow',
+            },
         ],
         tutorial: [
             'Workflows orchestrate multiple tasks and agents. Structure:',
@@ -288,9 +288,9 @@ const HELP_TOPICS = [
             '• Start with simple workflows',
             '• Use descriptive task names',
             '• Plan dependencies carefully',
-            '• Test with --dry-run first'
+            '• Test with --dry-run first',
         ],
-        related: ['tasks', 'agents', 'templates']
+        related: ['tasks', 'agents', 'templates'],
     },
     {
         name: 'configuration',
@@ -300,28 +300,28 @@ const HELP_TOPICS = [
             {
                 description: 'Initialize default configuration',
                 command: 'claude-flow config init --template development',
-                explanation: 'Creates a configuration file optimized for development'
+                explanation: 'Creates a configuration file optimized for development',
             },
             {
                 description: 'View current configuration',
                 command: 'claude-flow config show --diff',
-                explanation: 'Shows only settings that differ from defaults'
+                explanation: 'Shows only settings that differ from defaults',
             },
             {
                 description: 'Update a setting',
                 command: 'claude-flow config set orchestrator.maxConcurrentAgents 20',
-                explanation: 'Changes the maximum number of concurrent agents'
+                explanation: 'Changes the maximum number of concurrent agents',
             },
             {
                 description: 'Save configuration profile',
                 command: 'claude-flow config profile save production',
-                explanation: 'Saves current settings as a named profile'
+                explanation: 'Saves current settings as a named profile',
             },
             {
                 description: 'Load configuration profile',
                 command: 'claude-flow config profile load development',
-                explanation: 'Switches to a previously saved configuration profile'
-            }
+                explanation: 'Switches to a previously saved configuration profile',
+            },
         ],
         tutorial: [
             'Configuration controls all aspects of Claude-Flow behavior.',
@@ -354,9 +354,9 @@ const HELP_TOPICS = [
             'Environment Variables:',
             '• CLAUDE_FLOW_LOG_LEVEL: Override log level',
             '• CLAUDE_FLOW_MAX_AGENTS: Override agent limit',
-            '• CLAUDE_FLOW_MCP_PORT: Override MCP port'
+            '• CLAUDE_FLOW_MCP_PORT: Override MCP port',
         ],
-        related: ['profiles', 'environment', 'troubleshooting']
+        related: ['profiles', 'environment', 'troubleshooting'],
     },
     {
         name: 'monitoring',
@@ -366,23 +366,23 @@ const HELP_TOPICS = [
             {
                 description: 'Check system status',
                 command: 'claude-flow status --watch',
-                explanation: 'Continuously monitors system health and updates every few seconds'
+                explanation: 'Continuously monitors system health and updates every few seconds',
             },
             {
                 description: 'Start monitoring dashboard',
                 command: 'claude-flow monitor --interval 5',
-                explanation: 'Opens a live dashboard with real-time metrics and graphs'
+                explanation: 'Opens a live dashboard with real-time metrics and graphs',
             },
             {
                 description: 'View component-specific status',
                 command: 'claude-flow status --component orchestrator',
-                explanation: 'Shows detailed status for a specific system component'
+                explanation: 'Shows detailed status for a specific system component',
             },
             {
                 description: 'Monitor in compact mode',
                 command: 'claude-flow monitor --compact --no-graphs',
-                explanation: 'Simplified monitoring view without visual graphs'
-            }
+                explanation: 'Simplified monitoring view without visual graphs',
+            },
         ],
         tutorial: [
             'Claude-Flow provides comprehensive monitoring capabilities.',
@@ -410,9 +410,9 @@ const HELP_TOPICS = [
             '• High CPU: Too many concurrent tasks',
             '• High Memory: Large cache or memory leaks',
             '• Failed Tasks: Agent or system issues',
-            '• Slow Performance: Resource constraints'
+            '• Slow Performance: Resource constraints',
         ],
-        related: ['status', 'performance', 'troubleshooting']
+        related: ['status', 'performance', 'troubleshooting'],
     },
     {
         name: 'sessions',
@@ -422,28 +422,28 @@ const HELP_TOPICS = [
             {
                 description: 'Save current session',
                 command: 'claude-flow session save "Development Session" --description "Working on API integration"',
-                explanation: 'Saves all current agents, tasks, and memory state'
+                explanation: 'Saves all current agents, tasks, and memory state',
             },
             {
                 description: 'List saved sessions',
                 command: 'claude-flow session list',
-                explanation: 'Shows all saved sessions with creation dates and metadata'
+                explanation: 'Shows all saved sessions with creation dates and metadata',
             },
             {
                 description: 'Restore a session',
                 command: 'claude-flow session restore session-001 --merge',
-                explanation: 'Restores session state, merging with current state'
+                explanation: 'Restores session state, merging with current state',
             },
             {
                 description: 'Export session to file',
                 command: 'claude-flow session export session-001 backup.json --include-memory',
-                explanation: 'Creates a portable backup including agent memory'
+                explanation: 'Creates a portable backup including agent memory',
             },
             {
                 description: 'Clean up old sessions',
                 command: 'claude-flow session clean --older-than 30 --dry-run',
-                explanation: 'Shows what sessions would be deleted (older than 30 days)'
-            }
+                explanation: 'Shows what sessions would be deleted (older than 30 days)',
+            },
         ],
         tutorial: [
             'Sessions capture the complete state of your Claude-Flow environment.',
@@ -472,9 +472,9 @@ const HELP_TOPICS = [
             '• Use descriptive names and tags',
             '• Regular cleanup of old sessions',
             '• Export important sessions as backups',
-            '• Test restore before relying on sessions'
+            '• Test restore before relying on sessions',
         ],
-        related: ['backup', 'state', 'persistence']
+        related: ['backup', 'state', 'persistence'],
     },
     {
         name: 'repl',
@@ -484,18 +484,18 @@ const HELP_TOPICS = [
             {
                 description: 'Start REPL mode',
                 command: 'claude-flow repl',
-                explanation: 'Opens interactive command line with tab completion'
+                explanation: 'Opens interactive command line with tab completion',
             },
             {
                 description: 'REPL with custom history file',
                 command: 'claude-flow repl --history-file .my-history',
-                explanation: 'Uses a specific file for command history'
+                explanation: 'Uses a specific file for command history',
             },
             {
                 description: 'Skip welcome banner',
                 command: 'claude-flow repl --no-banner',
-                explanation: 'Starts REPL in minimal mode'
-            }
+                explanation: 'Starts REPL in minimal mode',
+            },
         ],
         tutorial: [
             'The REPL (Read-Eval-Print Loop) provides an interactive interface.',
@@ -520,9 +520,9 @@ const HELP_TOPICS = [
             '• Check connection status regularly',
             '• Use "help <command>" for detailed help',
             '• History is saved between sessions',
-            '• Ctrl+C or "exit" to quit'
+            '• Ctrl+C or "exit" to quit',
         ],
-        related: ['completion', 'interactive', 'commands']
+        related: ['completion', 'interactive', 'commands'],
     },
     {
         name: 'troubleshooting',
@@ -532,23 +532,23 @@ const HELP_TOPICS = [
             {
                 description: 'Check system health',
                 command: 'claude-flow status --component all',
-                explanation: 'Comprehensive health check of all components'
+                explanation: 'Comprehensive health check of all components',
             },
             {
                 description: 'Enable debug logging',
                 command: 'claude-flow start --log-level debug',
-                explanation: 'Start with verbose logging for debugging'
+                explanation: 'Start with verbose logging for debugging',
             },
             {
                 description: 'Validate configuration',
                 command: 'claude-flow config validate claude-flow.config.json --strict',
-                explanation: 'Check configuration file for errors'
+                explanation: 'Check configuration file for errors',
             },
             {
                 description: 'Reset to defaults',
                 command: 'claude-flow config reset --confirm',
-                explanation: 'Restore default configuration settings'
-            }
+                explanation: 'Restore default configuration settings',
+            },
         ],
         tutorial: [
             'Common issues and solutions:',
@@ -582,10 +582,10 @@ const HELP_TOPICS = [
             '• claude-flow status: System health check',
             '• claude-flow config validate: Configuration check',
             '• claude-flow --verbose: Enable detailed logging',
-            '• claude-flow monitor: Real-time diagnostics'
+            '• claude-flow monitor: Real-time diagnostics',
         ],
-        related: ['monitoring', 'configuration', 'debugging']
-    }
+        related: ['monitoring', 'configuration', 'debugging'],
+    },
 ];
 function showMainHelp() {
     const mainHelp = {
@@ -597,86 +597,86 @@ function showMainHelp() {
         commands: [
             {
                 name: 'hive-mind',
-                description: 'Manage hive mind swarm intelligence'
+                description: 'Manage hive mind swarm intelligence',
             },
             {
                 name: 'init',
-                description: 'Initialize Claude Flow configuration'
+                description: 'Initialize Claude Flow configuration',
             },
             {
                 name: 'start',
-                description: 'Start orchestration system'
+                description: 'Start orchestration system',
             },
             {
                 name: 'swarm',
-                description: 'Execute multi-agent swarm coordination'
+                description: 'Execute multi-agent swarm coordination',
             },
             {
                 name: 'agent',
-                description: 'Manage individual agents'
+                description: 'Manage individual agents',
             },
             {
                 name: 'sparc',
-                description: 'Execute SPARC development modes'
+                description: 'Execute SPARC development modes',
             },
             {
                 name: 'memory',
-                description: 'Manage persistent memory operations'
+                description: 'Manage persistent memory operations',
             },
             {
                 name: 'github',
-                description: 'Automate GitHub workflows'
+                description: 'Automate GitHub workflows',
             },
             {
                 name: 'status',
-                description: 'Show system status and health'
+                description: 'Show system status and health',
             },
             {
                 name: 'config',
-                description: 'Manage configuration settings'
+                description: 'Manage configuration settings',
             },
             {
                 name: 'session',
-                description: 'Manage sessions and state persistence'
+                description: 'Manage sessions and state persistence',
             },
             {
                 name: 'help',
-                description: 'Show help information'
-            }
+                description: 'Show help information',
+            },
         ],
         globalOptions: [
             {
                 flags: '--config <path>',
                 description: 'Configuration file path',
-                defaultValue: '.claude/config.json'
+                defaultValue: '.claude/config.json',
             },
             {
                 flags: '--verbose',
-                description: 'Enable verbose output'
+                description: 'Enable verbose output',
             },
             {
                 flags: '--quiet',
-                description: 'Suppress non-error output'
+                description: 'Suppress non-error output',
             },
             {
                 flags: '--json',
-                description: 'Output in JSON format'
+                description: 'Output in JSON format',
             },
             {
                 flags: '--help',
-                description: 'Show help information'
+                description: 'Show help information',
             },
             {
                 flags: '--version',
-                description: 'Show version information'
-            }
+                description: 'Show version information',
+            },
         ],
         examples: [
             'claude-flow init --sparc',
             'claude-flow hive-mind wizard',
             'claude-flow swarm "Build REST API"',
-            'claude-flow status --json'
-        ]
+            'claude-flow status --json',
+        ],
     };
     console.log(HelpFormatter.formatHelp(mainHelp));
 }
@@ -702,41 +702,41 @@ function getCommandHelp(command) {
                 { name: 'stop', description: 'Stop a running swarm' },
                 { name: 'ps', description: 'List all running processes' },
                 { name: 'resume', description: 'Resume a paused swarm' },
-                { name: 'wizard', description: 'Interactive setup wizard' }
+                { name: 'wizard', description: 'Interactive setup wizard' },
             ],
             options: [
                 {
                     flags: '--queen-type <type>',
                     description: 'Queen coordination type',
                     defaultValue: 'adaptive',
-                    validValues: ['strategic', 'tactical', 'adaptive']
+                    validValues: ['strategic', 'tactical', 'adaptive'],
                 },
                 {
                     flags: '--workers <count>',
                     description: 'Number of worker agents',
-                    defaultValue: '5'
+                    defaultValue: '5',
                 },
                 {
                     flags: '--timeout <seconds>',
                     description: 'Operation timeout',
-                    defaultValue: '300'
+                    defaultValue: '300',
                 },
                 {
                     flags: '--no-consensus',
-                    description: 'Disable consensus requirements'
+                    description: 'Disable consensus requirements',
                 },
                 {
                     flags: '--help',
-                    description: 'Show this help message'
-                }
+                    description: 'Show this help message',
+                },
             ],
             examples: [
                 'claude-flow hive-mind spawn "Build REST API" --queen-type strategic',
                 'claude-flow hive-mind status --json',
-                'claude-flow hive-mind stop swarm-123'
-            ]
+                'claude-flow hive-mind stop swarm-123',
+            ],
         },
-        'agent': {
+        agent: {
             name: 'claude-flow agent',
             description: 'Manage individual agents',
             usage: 'claude-flow agent <action> [options]',
@@ -744,62 +744,57 @@ function getCommandHelp(command) {
                 { name: 'spawn', description: 'Create a new agent' },
                 { name: 'list', description: 'List all active agents' },
                 { name: 'info', description: 'Show agent details' },
-                { name: 'terminate', description: 'Stop an agent' }
+                { name: 'terminate', description: 'Stop an agent' },
             ],
             options: [
                 {
                     flags: '--type <type>',
                     description: 'Agent type',
-                    validValues: ['coordinator', 'researcher', 'coder', 'analyst', 'tester']
+                    validValues: ['coordinator', 'researcher', 'coder', 'analyst', 'tester'],
                 },
                 {
                     flags: '--name <name>',
-                    description: 'Agent name'
+                    description: 'Agent name',
                 },
                 {
                     flags: '--json',
-                    description: 'Output in JSON format'
+                    description: 'Output in JSON format',
                 },
                 {
                     flags: '--help',
-                    description: 'Show this help message'
-                }
+                    description: 'Show this help message',
+                },
             ],
             examples: [
                 'claude-flow agent spawn researcher --name "Research Bot"',
                 'claude-flow agent list --json',
-                'claude-flow agent terminate agent-123'
-            ]
-        }
+                'claude-flow agent terminate agent-123',
+            ],
+        },
     };
     return commandHelpMap[command] || null;
 }
 function showAllTopics() {
     console.log(chalk.cyan.bold('All Help Topics'));
     console.log('─'.repeat(50));
-    const table = new Table.default({
+    const table = new Table({
         head: ['Topic', 'Category', 'Description'],
-        style: { head: ['cyan'] }
+        style: { head: ['cyan'] },
     });
     for (const topic of HELP_TOPICS) {
-        table.push([
-            chalk.cyan(topic.name),
-            chalk.yellow(topic.category),
-            topic.description
-        ]);
+        table.push([chalk.cyan(topic.name), chalk.yellow(topic.category), topic.description]);
     }
     console.log(table.toString());
     console.log();
     console.log(chalk.gray('Use "claude-flow help <topic>" for detailed information.'));
 }
 async function showTopicHelp(topicName, options) {
-    const topic = HELP_TOPICS.find(t => t.name === topicName);
+    const topic = HELP_TOPICS.find((t) => t.name === topicName);
     if (!topic) {
         console.log(chalk.red(`Help topic '${topicName}' not found.`));
         console.log();
         // Suggest similar topics
-        const similar = HELP_TOPICS.filter(t => t.name.includes(topicName) ||
-            t.description.toLowerCase().includes(topicName.toLowerCase()));
+        const similar = HELP_TOPICS.filter((t) => t.name.includes(topicName) || t.description.toLowerCase().includes(topicName.toLowerCase()));
         if (similar.length > 0) {
             console.log(chalk.gray('Did you mean:'));
             for (const suggestion of similar) {
@@ -902,14 +897,16 @@ async function startInteractiveHelp() {
             { name: 'REPL Mode', value: 'repl' },
             { name: 'Troubleshooting', value: 'troubleshooting' },
             { name: 'Browse All Topics', value: 'all' },
-            { name: 'Exit', value: 'exit' }
+            { name: 'Exit', value: 'exit' },
         ];
-        const result = await inquirer.prompt([{
+        const result = await inquirer.prompt([
+            {
                 type: 'list',
                 name: 'choice',
                 message: 'What would you like help with?',
                 choices: categories,
-            }]);
+            },
+        ]);
         const choice = result.choice;
         if (choice === 'exit') {
             console.log(chalk.gray('Goodbye!'));
@@ -924,7 +921,7 @@ async function startInteractiveHelp() {
         }
         console.log();
         console.log(chalk.gray('Press Enter to continue...'));
-        await new Promise(resolve => {
+        await new Promise((resolve) => {
             process.stdin.setRawMode(true);
             process.stdin.resume();
             process.stdin.once('data', () => {