claude-flow-novice 2.10.9 → 2.11.0

package/claude-assets/commands/claude-soul.js

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CLAUDE-SOUL.md Slash Command
- *
- * Interactive questionnaire to create a project soul document.
- * Guides users through defining their project's who, what, when, where, why
- * to provide context for AI agents when they hit roadblocks.
- * Document size: 250-500 words focusing on project essence and decision context.
- */
-
-// Import from the main implementation
-import { executeClaudeSoulCommand } from '../../src/slash-commands/claude-soul.js';
-
-// Parse arguments
-const args = {
-  preview: process.argv.includes('--preview'),
-  force: process.argv.includes('--force'),
-  backup: !process.argv.includes('--no-backup'),
-  interactive: !process.argv.includes('--no-interactive'),
-  help: process.argv.includes('--help') || process.argv.includes('-h')
-};
-
-// Execute the command
-executeClaudeSoulCommand(args).catch(error => {
-  console.error('Error:', error.message);
-  process.exit(1);
-});

package/claude-assets/commands/cli-integration.js

@@ -1,216 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CLI Integration for Slash Commands
- * 
- * Integrates slash commands with the main CLI system
- */
-
-import { globalRegistry, executeSlashCommand } from './register-all-commands.js';
-import { SlashCommand } from '../core/slash-command.js';
-
-/**
- * CLI Slash Command Handler
- */
-export class CliSlashHandler {
-  constructor() {
-    this.registry = globalRegistry;
-  }
-
-  /**
-   * Handle CLI input and execute slash commands
-   * @param {string[]} args - CLI arguments
-   */
-  async handleCliInput(args) {
-    if (args.length === 0) {
-      this.showHelp();
-      return;
-    }
-
-    const command = args[0];
-    
-    // Handle help commands
-    if (command === 'help' || command === '--help' || command === '-h') {
-      if (args.length > 1) {
-        this.showCommandHelp(args[1]);
-      } else {
-        this.showHelp();
-      }
-      return;
-    }
-
-    // Handle list commands
-    if (command === 'list' || command === 'ls') {
-      this.listCommands();
-      return;
-    }
-
-    // Execute slash command
-    const slashCommand = `/${command}`;
-    const slashArgs = args.slice(1);
-    const input = `${slashCommand} ${slashArgs.join(' ')}`.trim();
-
-    try {
-      const result = await executeSlashCommand(input);
-      
-      if (result.success) {
-        if (result.result && result.result.prompt) {
-          console.log(result.result.prompt);
-        } else {
-          console.log('✅ Command executed successfully');
-          if (result.result) {
-            console.log(JSON.stringify(result.result, null, 2));
-          }
-        }
-      } else {
-        console.error(`❌ ${result.error}`);
-        if (result.suggestions && result.suggestions.length > 0) {
-          console.log(`Did you mean: ${result.suggestions.join(', ')}?`);
-        }
-      }
-    } catch (error) {
-      console.error(`❌ CLI Error: ${error.message}`);
-    }
-  }
-
-  /**
-   * Show general help
-   */
-  showHelp() {
-    console.log(this.registry.generateHelpText());
-  }
-
-  /**
-   * Show help for specific command
-   * @param {string} commandName - Command name
-   */
-  showCommandHelp(commandName) {
-    const helpResult = this.registry.getHelp(commandName);
-    
-    if (helpResult.success) {
-      const help = helpResult.help;
-      console.log(`
-🚀 **${help.name.toUpperCase()} COMMAND**
-`);
-      console.log(`**Description:** ${help.description}`);
-      console.log(`**Usage:** ${help.usage}`);
-      
-      if (help.examples && help.examples.length > 0) {
-        console.log(`
-**Examples:**`);
-        help.examples.forEach(example => {
-          console.log(`  ${example}`);
-        });
-      }
-    } else {
-      console.error(`❌ ${helpResult.error}`);
-    }
-  }
-
-  /**
-   * List all available commands
-   */
-  listCommands() {
-    const commands = this.registry.listCommands();
-    
-    console.log('
-🚀 **AVAILABLE SLASH COMMANDS**
-');
-    
-    commands.forEach(cmd => {
-      console.log(`/${cmd.name} - ${cmd.description}`);
-      if (cmd.aliases.length > 0) {
-        console.log(`  Aliases: ${cmd.aliases.map(a => `/${a}`).join(', ')}`);
-      }
-    });
-    
-    console.log(`
-Total: ${commands.length} commands available`);
-  }
-}
-
-/**
- * Interactive CLI mode
- */
-export class InteractiveCliMode {
-  constructor() {
-    this.handler = new CliSlashHandler();
-    this.running = false;
-  }
-
-  /**
-   * Start interactive mode
-   */
-  async start() {
-    this.running = true;
-    
-    console.log('🚀 Claude-Flow Interactive Slash Command Mode');
-    console.log('Type commands without the leading "/" or "help" for assistance');
-    console.log('Type "exit" to quit\n');
-
-    // Note: In a real implementation, you would use readline or similar
-    // This is a simplified version for demonstration
-    process.stdin.setEncoding('utf8');
-    
-    process.stdin.on('readable', async () => {
-      const chunk = process.stdin.read();
-      if (chunk !== null) {
-        const input = chunk.trim();
-        
-        if (input === 'exit' || input === 'quit') {
-          this.stop();
-          return;
-        }
-        
-        if (input) {
-          const args = input.split(' ');
-          await this.handler.handleCliInput(args);
-        }
-        
-        if (this.running) {
-          process.stdout.write('claude-flow> ');
-        }
-      }
-    });
-
-    process.stdout.write('claude-flow> ');
-  }
-
-  /**
-   * Stop interactive mode
-   */
-  stop() {
-    this.running = false;
-    console.log('\n👋 Goodbye!');
-    process.exit(0);
-  }
-}
-
-/**
- * Main CLI entry point
- * @param {string[]} args - Command line arguments
- */
-export async function runCliSlashCommands(args = process.argv.slice(2)) {
-  const handler = new CliSlashHandler();
-  
-  // Check for interactive mode
-  if (args.includes('--interactive') || args.includes('-i')) {
-    const interactive = new InteractiveCliMode();
-    await interactive.start();
-    return;
-  }
-  
-  // Handle standard CLI input
-  await handler.handleCliInput(args);
-}
-
-// Auto-run if this script is executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  runCliSlashCommands();
-}
-
-export default {
-  CliSlashHandler,
-  InteractiveCliMode,
-  runCliSlashCommands
-};

package/claude-assets/commands/coordination/README.md

@@ -1,9 +0,0 @@
-# Coordination Commands
-
-Commands for coordination operations in Claude Flow.
-
-## Available Commands
-
-- [swarm-init](./swarm-init.md)
-- [agent-spawn](./agent-spawn.md)
-- [task-orchestrate](./task-orchestrate.md)

package/claude-assets/commands/coordination/agent-spawn.md

@@ -1,25 +0,0 @@
-# agent-spawn
-
-Spawn a new agent in the current swarm.
-
-## Usage
-```bash
-npx cfn-spawn agent spawn [options]
-```
-
-## Options
-- `--type <type>` - Agent type (coder, researcher, analyst, tester, coordinator)
-- `--name <name>` - Custom agent name
-- `--skills <list>` - Specific skills (comma-separated)
-
-## Examples
-```bash
-# Spawn coder agent
-npx cfn-spawn agent spawn --type coder
-
-# With custom name
-npx cfn-spawn agent spawn --type researcher --name "API Expert"
-
-# With specific skills
-npx cfn-spawn agent spawn --type coder --skills "python,fastapi,testing"
-```

package/claude-assets/commands/coordination/coordination-system.md

@@ -1,88 +0,0 @@
-# Agent Coordination System
-
-## Overview
-The Claude-Flow coordination system manages multiple AI agents working together on complex tasks. It provides intelligent task distribution, resource management, and inter-agent communication.
-
-## Agent Types and Capabilities
-- **Researcher**: Web search, information gathering, knowledge synthesis
-- **Coder**: Code analysis, development, debugging, testing
-- **Analyst**: Data processing, pattern recognition, insights generation
-- **Coordinator**: Task planning, resource allocation, workflow management
-- **General**: Multi-purpose agent with balanced capabilities
-
-## Task Management
-- **Priority Levels**: 1 (lowest) to 10 (highest)
-- **Dependencies**: Tasks can depend on completion of other tasks
-- **Parallel Execution**: Independent tasks run concurrently
-- **Load Balancing**: Automatic distribution based on agent capacity
-
-## Coordination Commands
-```bash
-# Agent Management
-npx cfn-spawn agent spawn <type> --name <name> --priority <1-10>
-npx cfn-spawn agent list
-npx cfn-spawn agent info <agent-id>
-npx cfn-spawn agent terminate <agent-id>
-
-# Task Management  
-npx claude-flow-novice task create <type> <description> --priority <1-10> --deps <task-ids>
-npx claude-flow-novice task list --verbose
-npx claude-flow-novice task status <task-id>
-npx claude-flow-novice task cancel <task-id>
-
-# System Monitoring
-npx claude-flow-novice status --verbose
-npx claude-flow-novice monitor --interval 5000
-```
-
-## Workflow Execution
-Workflows are defined in JSON format and can orchestrate complex multi-agent operations:
-```bash
-npx claude-flow-novice workflow examples/research-workflow.json
-npx claude-flow-novice workflow examples/development-config.json --async
-```
-
-## Advanced Features
-- **Circuit Breakers**: Automatic failure handling and recovery
-- **Work Stealing**: Dynamic load redistribution for efficiency
-- **Resource Limits**: Memory and CPU usage constraints
-- **Metrics Collection**: Performance monitoring and optimization
-
-## Configuration
-Coordination settings in `claude-flow.config.json`:
-```json
-{
-  "orchestrator": {
-    "maxConcurrentTasks": 10,
-    "taskTimeout": 300000,
-    "defaultPriority": 5
-  },
-  "agents": {
-    "maxAgents": 20,
-    "defaultCapabilities": ["research", "code", "terminal"],
-    "resourceLimits": {
-      "memory": "1GB",
-      "cpu": "50%"
-    }
-  }
-}
-```
-
-## Communication Patterns
-- **Direct Messaging**: Agent-to-agent communication
-- **Event Broadcasting**: System-wide notifications
-- **Shared Memory**: Common information access
-- **Task Handoff**: Seamless work transfer between agents
-
-## Best Practices
-- Start with general agents and specialize as needed
-- Use descriptive task names and clear requirements
-- Monitor system resources during heavy workloads
-- Implement proper error handling in workflows
-- Regular cleanup of completed tasks and inactive agents
-
-## Troubleshooting
-- Check agent health with `npx claude-flow-novice status`
-- View detailed logs with `npx claude-flow-novice monitor`
-- Restart stuck agents with terminate/spawn cycle
-- Use `--verbose` flags for detailed diagnostic information

package/claude-assets/commands/coordination/init.md

@@ -1,44 +0,0 @@
-# Initialize Coordination Framework
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__claude-flow__swarm_init`
-
-## Parameters
-```json
-{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}
-```
-
-## Description
-Set up a coordination topology to guide Claude Code's approach to complex tasks
-
-## Details
-This tool creates a coordination framework that helps Claude Code:
-- Break down complex problems systematically
-- Approach tasks from multiple perspectives
-- Maintain consistency across large projects
-- Work more efficiently through structured coordination
-
-Remember: This does NOT create actual coding agents. It creates a coordination pattern for Claude Code to follow.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__claude-flow__swarm_init`
-2. With parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/claude-assets/commands/coordination/orchestrate.md

@@ -1,43 +0,0 @@
-# Coordinate Task Execution
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__claude-flow__task_orchestrate`
-
-## Parameters
-```json
-{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}
-```
-
-## Description
-Break down and coordinate complex tasks for systematic execution by Claude Code
-
-## Details
-Orchestration strategies:
-- **parallel**: Claude Code works on independent components simultaneously
-- **sequential**: Step-by-step execution for dependent tasks
-- **adaptive**: Dynamically adjusts based on task complexity
-
-The orchestrator creates a plan that Claude Code follows using its native tools.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__claude-flow__task_orchestrate`
-2. With parameters: `{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/claude-assets/commands/coordination/spawn.md

@@ -1,45 +0,0 @@
-# Create Cognitive Patterns
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__claude-flow__agent_spawn`
-
-## Parameters
-```json
-{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}
-```
-
-## Description
-Define cognitive patterns that represent different approaches Claude Code can take
-
-## Details
-Agent types represent thinking patterns, not actual coders:
-- **researcher**: Systematic exploration approach
-- **coder**: Implementation-focused thinking
-- **analyst**: Data-driven decision making
-- **architect**: Big-picture system design
-- **reviewer**: Quality and consistency checking
-
-These patterns guide how Claude Code approaches different aspects of your task.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__claude-flow__agent_spawn`
-2. With parameters: `{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/claude-assets/commands/coordination/swarm-init.md

@@ -1,85 +0,0 @@
-# swarm init
-
-Initialize a Claude Flow swarm with specified topology and configuration.
-
-## Usage
-
-```bash
-npx claude-flow-novice swarm init [options]
-```
-
-## Options
-
-- `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
-- `--max-agents, -m <number>` - Maximum number of agents (default: 8)
-- `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
-- `--auto-spawn` - Automatically spawn agents based on task complexity
-- `--memory` - Enable cross-session memory persistence
-- `--github` - Enable GitHub integration features
-
-## Examples
-
-### Basic initialization
-
-```bash
-npx claude-flow-novice swarm init
-```
-
-### Mesh topology for research
-
-```bash
-npx claude-flow-novice swarm init --topology mesh --max-agents 5 --strategy balanced
-```
-
-### Hierarchical for development
-
-```bash
-npx claude-flow-novice swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
-```
-
-### GitHub-focused swarm
-
-```bash
-npx claude-flow-novice swarm init --topology star --github --memory
-```
-
-## Topologies
-
-### Mesh
-
-- All agents connect to all others
-- Best for: Research, exploration, brainstorming
-- Communication: High overhead, maximum information sharing
-
-### Hierarchical
-
-- Tree structure with clear command chain
-- Best for: Development, structured tasks, large projects
-- Communication: Efficient, clear responsibilities
-
-### Ring
-
-- Agents connect in a circle
-- Best for: Pipeline processing, sequential workflows
-- Communication: Low overhead, ordered processing
-
-### Star
-
-- Central coordinator with satellite agents
-- Best for: Simple tasks, centralized control
-- Communication: Minimal overhead, clear coordination
-
-## Integration with Claude Code
-
-Once initialized, use MCP tools in Claude Code:
-
-```javascript
-mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8 }
-```
-
-## See Also
-
-- `agent spawn` - Create swarm agents
-- `task orchestrate` - Coordinate task execution
-- `swarm status` - Check swarm state
-- `swarm monitor` - Real-time monitoring

package/claude-assets/commands/coordination/task-orchestrate.md

@@ -1,25 +0,0 @@
-# task-orchestrate
-
-Orchestrate complex tasks across the swarm.
-
-## Usage
-```bash
-npx claude-flow-novice task orchestrate [options]
-```
-
-## Options
-- `--task <description>` - Task description
-- `--strategy <type>` - Orchestration strategy
-- `--priority <level>` - Task priority (low, medium, high, critical)
-
-## Examples
-```bash
-# Orchestrate development task
-npx claude-flow-novice task orchestrate --task "Implement user authentication"
-
-# High priority task
-npx claude-flow-novice task orchestrate --task "Fix production bug" --priority critical
-
-# With specific strategy
-npx claude-flow-novice task orchestrate --task "Refactor codebase" --strategy parallel
-```

package/claude-assets/commands/github/README.md

@@ -1,11 +0,0 @@
-# Github Commands
-
-Commands for github operations in Claude Flow.
-
-## Available Commands
-
-- [github-swarm](./github-swarm.md)
-- [repo-analyze](./repo-analyze.md)
-- [pr-enhance](./pr-enhance.md)
-- [issue-triage](./issue-triage.md)
-- [code-review](./code-review.md)