agentic-flow 2.0.1 → 2.0.2-alpha

package/agentic-flow/dist/utils/cli.js

@@ -0,0 +1,344 @@
+// CLI argument parsing and help utilities
+export function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {
+        mode: 'parallel'
+    };
+    // Check for proxy command first
+    if (args[0] === 'proxy') {
+        options.mode = 'proxy';
+        return options;
+    }
+    // Check for claude-code command
+    if (args[0] === 'claude-code') {
+        options.mode = 'claude-code';
+        return options;
+    }
+    // Check for quic command
+    if (args[0] === 'quic') {
+        options.mode = 'quic';
+        return options;
+    }
+    // Check for MCP command
+    if (args[0] === 'mcp') {
+        const mcpSubcommand = args[1];
+        // MCP Manager commands (CLI configuration)
+        const managerCommands = ['add', 'list', 'remove', 'enable', 'disable', 'update', 'test', 'info', 'export', 'import'];
+        if (managerCommands.includes(mcpSubcommand)) {
+            options.mode = 'mcp-manager';
+            return options;
+        }
+        // MCP Server commands (start/stop server)
+        options.mode = 'mcp';
+        options.mcpCommand = mcpSubcommand || 'start'; // default to start
+        options.mcpServer = args[2] || 'all'; // default to all servers
+        return options;
+    }
+    // Check for config command
+    if (args[0] === 'config') {
+        options.mode = 'config';
+        return options;
+    }
+    // Check for agent management command
+    if (args[0] === 'agent') {
+        options.mode = 'agent-manager';
+        return options;
+    }
+    // Check for federation command
+    if (args[0] === 'federation') {
+        options.mode = 'federation';
+        return options;
+    }
+    // Check for reasoningbank command
+    if (args[0] === 'reasoningbank') {
+        options.mode = 'reasoningbank';
+        return options;
+    }
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                options.help = true;
+                break;
+            case '--version':
+            case '-v':
+                options.version = true;
+                break;
+            case '--agent':
+            case '-a':
+                options.mode = 'agent';
+                options.agent = args[++i];
+                break;
+            case '--task':
+            case '-t':
+                options.task = args[++i];
+                break;
+            case '--model':
+            case '-m':
+                options.model = args[++i];
+                break;
+            case '--provider':
+            case '-p':
+                options.provider = args[++i];
+                break;
+            case '--stream':
+            case '-s':
+                options.stream = true;
+                break;
+            case '--list':
+            case '-l':
+                options.mode = 'list';
+                break;
+            // API Configuration
+            case '--anthropic-key':
+                options.anthropicApiKey = args[++i];
+                break;
+            case '--openrouter-key':
+                options.openrouterApiKey = args[++i];
+                break;
+            // Agent Behavior
+            case '--temperature':
+                options.temperature = parseFloat(args[++i]);
+                break;
+            case '--max-tokens':
+                options.maxTokens = parseInt(args[++i], 10);
+                break;
+            // Directory Configuration
+            case '--agents-dir':
+                options.agentsDir = args[++i];
+                break;
+            // Output Options
+            case '--output':
+                options.outputFormat = args[++i];
+                break;
+            case '--verbose':
+                options.verbose = true;
+                break;
+            // Execution Control
+            case '--timeout':
+                options.timeout = parseInt(args[++i], 10);
+                break;
+            case '--retry':
+                options.retryOnError = true;
+                break;
+            // Model Optimization
+            case '--optimize':
+            case '-O':
+                options.optimize = true;
+                break;
+            case '--priority':
+                options.optimizePriority = args[++i];
+                break;
+            case '--max-cost':
+                options.maxCost = parseFloat(args[++i]);
+                break;
+            // Agent Booster
+            case '--agent-booster':
+            case '--booster':
+                options.agentBooster = true;
+                break;
+            case '--booster-threshold':
+                options.boosterThreshold = parseFloat(args[++i]);
+                break;
+        }
+    }
+    // Check environment variable for Agent Booster
+    if (process.env.AGENTIC_FLOW_AGENT_BOOSTER === 'true') {
+        options.agentBooster = true;
+    }
+    if (process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD) {
+        options.boosterThreshold = parseFloat(process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD);
+    }
+    return options;
+}
+export function printHelp() {
+    console.log(`
+🤖 Agentic Flow - AI Agent Orchestration CLI
+
+USAGE:
+  npx agentic-flow [COMMAND] [OPTIONS]
+
+COMMANDS:
+  reasoningbank <cmd>     Memory system that learns from experience (demo, test, init)
+  claude-code [options]   Spawn Claude Code with proxy + Agent Booster (57x faster edits)
+  mcp <command> [server]  Manage MCP servers (start, stop, status, list)
+  config [command]        Configuration wizard (set, get, list, delete, reset)
+  agent <command>         Agent management (list, create, info, conflicts)
+  --list, -l              List all available agents
+  --agent, -a <name>      Run specific agent mode
+  (default)               Run parallel mode (3 agents)
+
+REASONINGBANK COMMANDS:
+  npx agentic-flow reasoningbank demo         Run interactive demo comparison
+  npx agentic-flow reasoningbank test         Run validation tests
+  npx agentic-flow reasoningbank init         Initialize database
+  npx agentic-flow reasoningbank benchmark    Run performance benchmarks
+  npx agentic-flow reasoningbank status       Show memory statistics
+
+MCP COMMANDS:
+  npx agentic-flow mcp start [server]    Start MCP server(s)
+  npx agentic-flow mcp stop [server]     Stop MCP server(s)
+  npx agentic-flow mcp status [server]   Check MCP server status
+  npx agentic-flow mcp list              List all available MCP tools
+
+  Available servers: claude-flow, flow-nexus, agentic-payments, all (default)
+
+OPTIONS:
+  --task, -t <task>           Task description for agent mode
+  --model, -m <model>         Model to use (supports OpenRouter models)
+  --provider, -p <name>       Provider (anthropic, openrouter, onnx)
+  --stream, -s                Enable real-time streaming output
+
+  API CONFIGURATION:
+  --anthropic-key <key>       Override ANTHROPIC_API_KEY
+  --openrouter-key <key>      Override OPENROUTER_API_KEY
+
+  AGENT BEHAVIOR:
+  --temperature <0.0-1.0>     Sampling temperature (creativity)
+  --max-tokens <number>       Maximum response tokens
+
+  DIRECTORY:
+  --agents-dir <path>         Custom agents directory
+
+  OUTPUT:
+  --output <text|json|md>     Output format
+  --verbose                   Enable verbose logging
+
+  EXECUTION:
+  --timeout <ms>              Execution timeout
+  --retry                     Auto-retry on errors
+
+  MODEL OPTIMIZATION:
+  --optimize, -O              Auto-select best model for agent/task
+  --priority <type>           Optimization priority (quality|balanced|cost|speed|privacy)
+  --max-cost <dollars>        Maximum cost per task in dollars
+
+  AGENT BOOSTER (200x faster code edits!):
+  --agent-booster             Enable Agent Booster pre-processing
+  --booster-threshold <0-1>   Confidence threshold (default: 0.7)
+
+  --help, -h                  Show this help message
+
+EXAMPLES:
+  # ReasoningBank (Learn from agent experience!)
+  npx agentic-flow reasoningbank demo       # See 0% → 100% success transformation
+  npx agentic-flow reasoningbank test       # Run 27 validation tests
+  npx agentic-flow reasoningbank init       # Setup memory database
+  export ANTHROPIC_API_KEY=sk-ant-...      # Enable LLM-based learning
+
+  # Agent Booster Integration (200x faster code edits!)
+  npx agentic-flow --agent coder --task "Convert var to const in utils.js" --agent-booster
+  npx agentic-flow --agent coder --task "Add types to api.ts" --agent-booster --provider openrouter
+  export AGENTIC_FLOW_AGENT_BOOSTER=true  # Enable for all tasks
+
+  # Claude Code with Agent Booster
+  npx agentic-flow claude-code --provider openrouter --agent-booster
+  npx agentic-flow claude-code --provider gemini "Write a REST API"
+  npx agentic-flow claude-code --help     # See all claude-code options
+
+  # Agent Management
+  npx agentic-flow agent list             # List all agents with sources
+  npx agentic-flow agent create           # Interactive agent creator
+  npx agentic-flow agent info coder       # Get agent details
+  npx agentic-flow agent conflicts        # Check for conflicts
+
+  # Configuration
+  npx agentic-flow config                 # Interactive config wizard
+  npx agentic-flow config set PROVIDER openrouter
+  npx agentic-flow config list            # View all settings
+
+  # MCP Server Management
+  npx agentic-flow mcp start              # Start all MCP servers
+  npx agentic-flow mcp list               # List all 209+ MCP tools
+
+  # Agent Execution (Basic)
+  npx agentic-flow --list                 # List all agents
+  npx agentic-flow --agent coder --task "Build REST API"
+
+  # Agent Execution (Advanced)
+  npx agentic-flow --agent coder --task "Build API" \\
+    --provider openrouter \\
+    --model "meta-llama/llama-3.1-8b-instruct" \\
+    --temperature 0.7 \\
+    --max-tokens 2000 \\
+    --output json \\
+    --verbose
+
+  # Agent Execution (Custom)
+  npx agentic-flow --agent my-custom-agent --task "Your task" \\
+    --agents-dir ./my-agents
+
+  # Parallel Mode
+  npx agentic-flow  # Run 3 agents in parallel
+
+  # Model Optimization (Auto-select best model)
+  npx agentic-flow --agent coder --task "Build API" --optimize
+  npx agentic-flow --agent coder --task "Build API" --optimize --priority cost
+  npx agentic-flow --agent researcher --task "Analyze data" --optimize --priority quality
+  npx agentic-flow --agent coder --task "Simple function" --optimize --max-cost 0.001
+
+ENVIRONMENT VARIABLES:
+  ANTHROPIC_API_KEY       Anthropic API key (for Claude models)
+  OPENROUTER_API_KEY      OpenRouter API key (for alternative models)
+  USE_ONNX                Set to 'true' to force ONNX local inference
+  AGENT                   Agent name for agent mode
+  TASK                    Task description for agent mode
+  MODEL                   Model override for agent mode
+  PROVIDER                Provider to use (anthropic, openrouter, onnx)
+  TOPIC                   Research topic for parallel mode
+  DIFF                    Code diff for parallel mode
+  DATASET                 Dataset hint for parallel mode
+  ENABLE_STREAMING        Enable streaming (true/false)
+  HEALTH_PORT             Health check port (default: 8080)
+
+MCP TOOLS (209+ available):
+  • agentic-flow: 6 tools (agent execution, creation, management)
+  • claude-flow: 101 tools (neural networks, GitHub, workflows, DAA)
+  • flow-nexus: 96 cloud tools (sandboxes, distributed swarms, templates)
+  • agentic-payments: 6 tools (payment authorization, multi-agent consensus)
+
+PARALLEL EXECUTION & SWARM OPTIMIZATION (v2.0):
+  • Automatic Topology Selection: AI recommends optimal swarm configuration
+  • Self-Learning System: Learns from 100+ execution patterns (0.6 → 0.95 confidence)
+  • Pattern Recognition: ReasoningBank stores & retrieves successful strategies
+  • Performance Tracking: 3.5-5.0x speedup with hierarchical topology
+  • Reward System: Multi-factor scoring (speedup, success rate, efficiency)
+  • Adaptive Optimization: Improves recommendations over time
+
+  Supported Topologies:
+    - Mesh (1-10 agents): Full peer-to-peer coordination (2.5x speedup)
+    - Hierarchical (6-50 agents): Coordinator delegation (3.5-4.0x speedup) ⭐ BEST
+    - Ring (1-20 agents): Sequential token passing + parallel processing
+    - Star (1-30 agents): Central coordinator pattern
+
+  Usage Example (CLI subprocess spawning):
+    const results = await Promise.all([
+      exec('npx agentic-flow --agent researcher --task "domain1"'),
+      exec('npx agentic-flow --agent researcher --task "domain2"'),
+      exec('npx agentic-flow --agent coder --task "implement"')
+    ]);
+
+  Auto-Optimization Example:
+    import { autoSelectSwarmConfig } from './hooks/swarm-learning-optimizer';
+    const config = await autoSelectSwarmConfig(reasoningBank, taskDesc, options);
+    // Returns: recommendedTopology, expectedSpeedup, confidence, reasoning
+
+  See: /agentic-flow/src/prompts/parallel-execution-guide.md (v2.0)
+       /docs/swarm-optimization-report.md
+
+For more information, visit: https://github.com/ruvnet/agentic-flow
+  `);
+}
+export function validateOptions(options) {
+    if (options.mode === 'agent') {
+        if (!options.agent && !process.env.AGENT) {
+            return 'Agent mode requires --agent <name> or AGENT env variable';
+        }
+        if (!options.task && !process.env.TASK) {
+            return 'Agent mode requires --task <description> or TASK env variable';
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=cli.js.map

package/agentic-flow/dist/utils/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/utils/cli.ts"],"names":[],"mappings":"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","sourcesContent":["// CLI argument parsing and help utilities\n\nexport interface CliOptions {\n  mode: 'agent' | 'parallel' | 'list' | 'mcp' | 'mcp-manager' | 'config' | 'agent-manager' | 'proxy' | 'quic' | 'claude-code' | 'reasoningbank' | 'federation';\n  agent?: string;\n  task?: string;\n\n  // Provider Configuration\n  model?: string;\n  provider?: string;\n\n  // API Configuration\n  anthropicApiKey?: string;\n  openrouterApiKey?: string;\n\n  // Agent Behavior\n  stream?: boolean;\n  temperature?: number;\n  maxTokens?: number;\n\n  // Directory Configuration\n  agentsDir?: string;\n\n  // Output Options\n  outputFormat?: 'text' | 'json' | 'markdown';\n  verbose?: boolean;\n\n  // Execution Control\n  timeout?: number;\n  retryOnError?: boolean;\n\n  // Model Optimization\n  optimize?: boolean;\n  optimizePriority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';\n  maxCost?: number;\n\n  // Agent Booster Integration\n  claudeCode?: boolean; // Use Agent Booster for 57x faster code edits\n  agentBooster?: boolean; // Enable Agent Booster pre-processing\n  boosterThreshold?: number; // Confidence threshold for Agent Booster\n\n  help?: boolean;\n  version?: boolean;\n  mcpCommand?: string; // start, stop, status, list\n  mcpServer?: string; // claude-flow, flow-nexus, agentic-payments, all\n}\n\nexport function parseArgs(): CliOptions {\n  const args = process.argv.slice(2);\n  const options: CliOptions = {\n    mode: 'parallel'\n  };\n\n  // Check for proxy command first\n  if (args[0] === 'proxy') {\n    options.mode = 'proxy';\n    return options;\n  }\n\n  // Check for claude-code command\n  if (args[0] === 'claude-code') {\n    options.mode = 'claude-code';\n    return options;\n  }\n\n  // Check for quic command\n  if (args[0] === 'quic') {\n    options.mode = 'quic';\n    return options;\n  }\n\n  // Check for MCP command\n  if (args[0] === 'mcp') {\n    const mcpSubcommand = args[1];\n\n    // MCP Manager commands (CLI configuration)\n    const managerCommands = ['add', 'list', 'remove', 'enable', 'disable', 'update', 'test', 'info', 'export', 'import'];\n\n    if (managerCommands.includes(mcpSubcommand)) {\n      options.mode = 'mcp-manager';\n      return options;\n    }\n\n    // MCP Server commands (start/stop server)\n    options.mode = 'mcp';\n    options.mcpCommand = mcpSubcommand || 'start'; // default to start\n    options.mcpServer = args[2] || 'all'; // default to all servers\n    return options;\n  }\n\n  // Check for config command\n  if (args[0] === 'config') {\n    options.mode = 'config';\n    return options;\n  }\n\n  // Check for agent management command\n  if (args[0] === 'agent') {\n    options.mode = 'agent-manager';\n    return options;\n  }\n\n  // Check for federation command\n  if (args[0] === 'federation') {\n    options.mode = 'federation';\n    return options;\n  }\n\n  // Check for reasoningbank command\n  if (args[0] === 'reasoningbank') {\n    options.mode = 'reasoningbank';\n    return options;\n  }\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    switch (arg) {\n      case '--help':\n      case '-h':\n        options.help = true;\n        break;\n\n      case '--version':\n      case '-v':\n        options.version = true;\n        break;\n\n      case '--agent':\n      case '-a':\n        options.mode = 'agent';\n        options.agent = args[++i];\n        break;\n\n      case '--task':\n      case '-t':\n        options.task = args[++i];\n        break;\n\n      case '--model':\n      case '-m':\n        options.model = args[++i];\n        break;\n\n      case '--provider':\n      case '-p':\n        options.provider = args[++i];\n        break;\n\n      case '--stream':\n      case '-s':\n        options.stream = true;\n        break;\n\n      case '--list':\n      case '-l':\n        options.mode = 'list';\n        break;\n\n      // API Configuration\n      case '--anthropic-key':\n        options.anthropicApiKey = args[++i];\n        break;\n\n      case '--openrouter-key':\n        options.openrouterApiKey = args[++i];\n        break;\n\n      // Agent Behavior\n      case '--temperature':\n        options.temperature = parseFloat(args[++i]);\n        break;\n\n      case '--max-tokens':\n        options.maxTokens = parseInt(args[++i], 10);\n        break;\n\n      // Directory Configuration\n      case '--agents-dir':\n        options.agentsDir = args[++i];\n        break;\n\n      // Output Options\n      case '--output':\n        options.outputFormat = args[++i] as 'text' | 'json' | 'markdown';\n        break;\n\n      case '--verbose':\n        options.verbose = true;\n        break;\n\n      // Execution Control\n      case '--timeout':\n        options.timeout = parseInt(args[++i], 10);\n        break;\n\n      case '--retry':\n        options.retryOnError = true;\n        break;\n\n      // Model Optimization\n      case '--optimize':\n      case '-O':\n        options.optimize = true;\n        break;\n\n      case '--priority':\n        options.optimizePriority = args[++i] as 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';\n        break;\n\n      case '--max-cost':\n        options.maxCost = parseFloat(args[++i]);\n        break;\n\n      // Agent Booster\n      case '--agent-booster':\n      case '--booster':\n        options.agentBooster = true;\n        break;\n\n      case '--booster-threshold':\n        options.boosterThreshold = parseFloat(args[++i]);\n        break;\n    }\n  }\n\n  // Check environment variable for Agent Booster\n  if (process.env.AGENTIC_FLOW_AGENT_BOOSTER === 'true') {\n    options.agentBooster = true;\n  }\n  if (process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD) {\n    options.boosterThreshold = parseFloat(process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD);\n  }\n\n  return options;\n}\n\nexport function printHelp(): void {\n  console.log(`\n🤖 Agentic Flow - AI Agent Orchestration CLI\n\nUSAGE:\n  npx agentic-flow [COMMAND] [OPTIONS]\n\nCOMMANDS:\n  reasoningbank <cmd>     Memory system that learns from experience (demo, test, init)\n  claude-code [options]   Spawn Claude Code with proxy + Agent Booster (57x faster edits)\n  mcp <command> [server]  Manage MCP servers (start, stop, status, list)\n  config [command]        Configuration wizard (set, get, list, delete, reset)\n  agent <command>         Agent management (list, create, info, conflicts)\n  --list, -l              List all available agents\n  --agent, -a <name>      Run specific agent mode\n  (default)               Run parallel mode (3 agents)\n\nREASONINGBANK COMMANDS:\n  npx agentic-flow reasoningbank demo         Run interactive demo comparison\n  npx agentic-flow reasoningbank test         Run validation tests\n  npx agentic-flow reasoningbank init         Initialize database\n  npx agentic-flow reasoningbank benchmark    Run performance benchmarks\n  npx agentic-flow reasoningbank status       Show memory statistics\n\nMCP COMMANDS:\n  npx agentic-flow mcp start [server]    Start MCP server(s)\n  npx agentic-flow mcp stop [server]     Stop MCP server(s)\n  npx agentic-flow mcp status [server]   Check MCP server status\n  npx agentic-flow mcp list              List all available MCP tools\n\n  Available servers: claude-flow, flow-nexus, agentic-payments, all (default)\n\nOPTIONS:\n  --task, -t <task>           Task description for agent mode\n  --model, -m <model>         Model to use (supports OpenRouter models)\n  --provider, -p <name>       Provider (anthropic, openrouter, onnx)\n  --stream, -s                Enable real-time streaming output\n\n  API CONFIGURATION:\n  --anthropic-key <key>       Override ANTHROPIC_API_KEY\n  --openrouter-key <key>      Override OPENROUTER_API_KEY\n\n  AGENT BEHAVIOR:\n  --temperature <0.0-1.0>     Sampling temperature (creativity)\n  --max-tokens <number>       Maximum response tokens\n\n  DIRECTORY:\n  --agents-dir <path>         Custom agents directory\n\n  OUTPUT:\n  --output <text|json|md>     Output format\n  --verbose                   Enable verbose logging\n\n  EXECUTION:\n  --timeout <ms>              Execution timeout\n  --retry                     Auto-retry on errors\n\n  MODEL OPTIMIZATION:\n  --optimize, -O              Auto-select best model for agent/task\n  --priority <type>           Optimization priority (quality|balanced|cost|speed|privacy)\n  --max-cost <dollars>        Maximum cost per task in dollars\n\n  AGENT BOOSTER (200x faster code edits!):\n  --agent-booster             Enable Agent Booster pre-processing\n  --booster-threshold <0-1>   Confidence threshold (default: 0.7)\n\n  --help, -h                  Show this help message\n\nEXAMPLES:\n  # ReasoningBank (Learn from agent experience!)\n  npx agentic-flow reasoningbank demo       # See 0% → 100% success transformation\n  npx agentic-flow reasoningbank test       # Run 27 validation tests\n  npx agentic-flow reasoningbank init       # Setup memory database\n  export ANTHROPIC_API_KEY=sk-ant-...      # Enable LLM-based learning\n\n  # Agent Booster Integration (200x faster code edits!)\n  npx agentic-flow --agent coder --task \"Convert var to const in utils.js\" --agent-booster\n  npx agentic-flow --agent coder --task \"Add types to api.ts\" --agent-booster --provider openrouter\n  export AGENTIC_FLOW_AGENT_BOOSTER=true  # Enable for all tasks\n\n  # Claude Code with Agent Booster\n  npx agentic-flow claude-code --provider openrouter --agent-booster\n  npx agentic-flow claude-code --provider gemini \"Write a REST API\"\n  npx agentic-flow claude-code --help     # See all claude-code options\n\n  # Agent Management\n  npx agentic-flow agent list             # List all agents with sources\n  npx agentic-flow agent create           # Interactive agent creator\n  npx agentic-flow agent info coder       # Get agent details\n  npx agentic-flow agent conflicts        # Check for conflicts\n\n  # Configuration\n  npx agentic-flow config                 # Interactive config wizard\n  npx agentic-flow config set PROVIDER openrouter\n  npx agentic-flow config list            # View all settings\n\n  # MCP Server Management\n  npx agentic-flow mcp start              # Start all MCP servers\n  npx agentic-flow mcp list               # List all 209+ MCP tools\n\n  # Agent Execution (Basic)\n  npx agentic-flow --list                 # List all agents\n  npx agentic-flow --agent coder --task \"Build REST API\"\n\n  # Agent Execution (Advanced)\n  npx agentic-flow --agent coder --task \"Build API\" \\\\\n    --provider openrouter \\\\\n    --model \"meta-llama/llama-3.1-8b-instruct\" \\\\\n    --temperature 0.7 \\\\\n    --max-tokens 2000 \\\\\n    --output json \\\\\n    --verbose\n\n  # Agent Execution (Custom)\n  npx agentic-flow --agent my-custom-agent --task \"Your task\" \\\\\n    --agents-dir ./my-agents\n\n  # Parallel Mode\n  npx agentic-flow  # Run 3 agents in parallel\n\n  # Model Optimization (Auto-select best model)\n  npx agentic-flow --agent coder --task \"Build API\" --optimize\n  npx agentic-flow --agent coder --task \"Build API\" --optimize --priority cost\n  npx agentic-flow --agent researcher --task \"Analyze data\" --optimize --priority quality\n  npx agentic-flow --agent coder --task \"Simple function\" --optimize --max-cost 0.001\n\nENVIRONMENT VARIABLES:\n  ANTHROPIC_API_KEY       Anthropic API key (for Claude models)\n  OPENROUTER_API_KEY      OpenRouter API key (for alternative models)\n  USE_ONNX                Set to 'true' to force ONNX local inference\n  AGENT                   Agent name for agent mode\n  TASK                    Task description for agent mode\n  MODEL                   Model override for agent mode\n  PROVIDER                Provider to use (anthropic, openrouter, onnx)\n  TOPIC                   Research topic for parallel mode\n  DIFF                    Code diff for parallel mode\n  DATASET                 Dataset hint for parallel mode\n  ENABLE_STREAMING        Enable streaming (true/false)\n  HEALTH_PORT             Health check port (default: 8080)\n\nMCP TOOLS (209+ available):\n  • agentic-flow: 6 tools (agent execution, creation, management)\n  • claude-flow: 101 tools (neural networks, GitHub, workflows, DAA)\n  • flow-nexus: 96 cloud tools (sandboxes, distributed swarms, templates)\n  • agentic-payments: 6 tools (payment authorization, multi-agent consensus)\n\nPARALLEL EXECUTION & SWARM OPTIMIZATION (v2.0):\n  • Automatic Topology Selection: AI recommends optimal swarm configuration\n  • Self-Learning System: Learns from 100+ execution patterns (0.6 → 0.95 confidence)\n  • Pattern Recognition: ReasoningBank stores & retrieves successful strategies\n  • Performance Tracking: 3.5-5.0x speedup with hierarchical topology\n  • Reward System: Multi-factor scoring (speedup, success rate, efficiency)\n  • Adaptive Optimization: Improves recommendations over time\n\n  Supported Topologies:\n    - Mesh (1-10 agents): Full peer-to-peer coordination (2.5x speedup)\n    - Hierarchical (6-50 agents): Coordinator delegation (3.5-4.0x speedup) ⭐ BEST\n    - Ring (1-20 agents): Sequential token passing + parallel processing\n    - Star (1-30 agents): Central coordinator pattern\n\n  Usage Example (CLI subprocess spawning):\n    const results = await Promise.all([\n      exec('npx agentic-flow --agent researcher --task \"domain1\"'),\n      exec('npx agentic-flow --agent researcher --task \"domain2\"'),\n      exec('npx agentic-flow --agent coder --task \"implement\"')\n    ]);\n\n  Auto-Optimization Example:\n    import { autoSelectSwarmConfig } from './hooks/swarm-learning-optimizer';\n    const config = await autoSelectSwarmConfig(reasoningBank, taskDesc, options);\n    // Returns: recommendedTopology, expectedSpeedup, confidence, reasoning\n\n  See: /agentic-flow/src/prompts/parallel-execution-guide.md (v2.0)\n       /docs/swarm-optimization-report.md\n\nFor more information, visit: https://github.com/ruvnet/agentic-flow\n  `);\n}\n\nexport function validateOptions(options: CliOptions): string | null {\n  if (options.mode === 'agent') {\n    if (!options.agent && !process.env.AGENT) {\n      return 'Agent mode requires --agent <name> or AGENT env variable';\n    }\n    if (!options.task && !process.env.TASK) {\n      return 'Agent mode requires --task <description> or TASK env variable';\n    }\n  }\n\n  return null;\n}\n"]}

package/agentic-flow/docs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Claude Flow Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/agentic-flow/docs/README.md

@@ -0,0 +1,217 @@
+# Agentic-Flow Documentation
+
+Complete documentation for the agentic-flow platform - AI agent orchestration with 66 specialized agents, 213 MCP tools, ReasoningBank learning memory, and autonomous multi-agent swarms.
+
+## 📚 Documentation Structure
+
+### Core Documentation
+- **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC development environment setup
+
+### Quick Start & Guides
+- **[guides/](guides/)** - User guides, tutorials, and how-to documentation
+  - [Quick Start Guide](guides/QUICK-START-v1.7.1.md)
+  - [MCP Tools](guides/MCP-TOOLS.md)
+  - [Claude Code Integration](guides/CLAUDE-CODE-INTEGRATION.md)
+  - [Agent Booster](guides/AGENT-BOOSTER.md)
+  - [ReasoningBank](guides/REASONINGBANK.md)
+  - [Multi-Model Router](guides/MULTI-MODEL-ROUTER.md)
+  - [Deployment Guide](guides/DEPLOYMENT.md)
+
+### Architecture & Design
+- **[architecture/](architecture/)** - System architecture and design documents
+  - [Executive Summary](architecture/EXECUTIVE_SUMMARY.md)
+  - [Package Structure](architecture/PACKAGE_STRUCTURE.md)
+  - [QUIC Implementation](architecture/QUIC-IMPLEMENTATION-SUMMARY.md)
+  - [Integration Status](architecture/INTEGRATION-STATUS.md)
+  - [Improvement Plan](architecture/IMPROVEMENT_PLAN.md)
+
+### Integration Documentation
+- **[integration-docs/](integration-docs/)** - Integration guides and implementation summaries
+- **[integrations/](integrations/)** - Specific integration implementations
+  - [Claude Flow Integration](integrations/CLAUDE_FLOW_INTEGRATION.md)
+  - [Flow Nexus Integration](integrations/FLOW-NEXUS-INTEGRATION.md)
+  - [FastMCP Integration](integrations/FASTMCP_CLI_INTEGRATION.md)
+
+### Feature Documentation
+
+#### Provider & Router
+- **[providers/](providers/)** - Provider fallback and configuration
+  - [Provider Fallback Guide](providers/PROVIDER-FALLBACK-GUIDE.md)
+  - [Provider Fallback Summary](providers/PROVIDER-FALLBACK-SUMMARY.md)
+  - [Landing Page Provider Content](providers/LANDING-PAGE-PROVIDER-CONTENT.md)
+- **[router/](router/)** - Multi-model router documentation
+  - [Router User Guide](router/ROUTER_USER_GUIDE.md)
+  - [Router Config Reference](router/ROUTER_CONFIG_REFERENCE.md)
+
+#### QUIC Transport
+- **[quic/](quic/)** - QUIC protocol implementation
+  - [QUIC Status](quic/QUIC-STATUS.md)
+  - [Implementation Complete](quic/IMPLEMENTATION-COMPLETE-SUMMARY.md)
+  - [Final Validation](quic/FINAL-VALIDATION.md)
+  - [Performance Validation](quic/PERFORMANCE-VALIDATION.md)
+
+#### ReasoningBank
+- **[reasoningbank/](reasoningbank/)** - ReasoningBank learning memory system
+  - [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md)
+  - [Backends](reasoningbank/REASONINGBANK_BACKENDS.md)
+  - [Benchmark Results](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md)
+  - [Validation](reasoningbank/REASONINGBANK-VALIDATION.md)
+
+#### Supabase Integration
+- **[supabase/](supabase/)** - Supabase realtime federation
+  - [Quick Start](supabase/QUICKSTART.md)
+  - [Implementation Summary](supabase/IMPLEMENTATION-SUMMARY.md)
+  - [Test Report](supabase/TEST-REPORT.md)
+
+#### Federation
+- **[federation/](federation/)** - Agent federation and deployment
+  - [Deployment Validation](federation/DEPLOYMENT-VALIDATION-SUCCESS.md)
+  - [Debug Streaming](federation/DEBUG-STREAMING-COMPLETE.md)
+
+### Testing & Validation
+- **[testing/](testing/)** - Test documentation and results
+  - [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md)
+  - [Final Testing Summary](testing/FINAL-TESTING-SUMMARY.md)
+  - [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md)
+- **[validation/](validation/)** - Validation reports and processes
+- **[validation-reports/](validation-reports/)** - Detailed validation results
+  - [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md)
+  - [No Regressions Confirmed](validation-reports/NO_REGRESSIONS_CONFIRMED.md)
+- **[docker-tests/](docker-tests/)** - Docker test configurations
+
+### MCP Validation
+- **[mcp-validation/](mcp-validation/)** - Model Context Protocol validation
+  - [MCP CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md)
+  - [Implementation Summary](mcp-validation/IMPLEMENTATION-SUMMARY.md)
+
+### Benchmarks & Performance
+- **[benchmarks/](benchmarks/)** - Performance benchmarks
+  - [QUIC Results](benchmarks/quic-results.md)
+  - [Optimization Guide](benchmarks/optimization-guide.md)
+
+### Release Information
+- **[releases/](releases/)** - Release notes and GitHub issues
+  - [v1.8.13 Release](releases/RELEASE-v1.8.13.md)
+  - [v1.5.14 QUIC Transport](releases/v1.5.14-QUIC-TRANSPORT.md)
+  - [v1.4.6 ReasoningBank](releases/v1.4.6-reasoningbank-release.md)
+- **[version-releases/](version-releases/)** - Version-specific release documentation
+
+### Planning & Research
+- **[plans/](plans/)** - Feature plans and roadmaps
+  - [QUIC Implementation](plans/QUIC/)
+  - [Agent Booster](plans/agent-booster/)
+  - [Requesty](plans/requesty/)
+- **[quantum-goap/](quantum-goap/)** - Goal-Oriented Action Planning
+- **[quantum-research/](quantum-research/)** - Quantum research literature
+
+### Issues & Reports
+- **[issues/](issues/)** - Known issues and troubleshooting
+  - [Supabase Integration Issue](issues/ISSUE-SUPABASE-INTEGRATION.md)
+  - [Xenova Transformers Dependency](issues/ISSUE-xenova-transformers-dependency.md)
+- **[reports/](reports/)** - Status reports and completion summaries
+- **[reviews/](reviews/)** - Code and implementation reviews
+
+### Archived Documentation
+- **[archived/](archived/)** - Historical documentation (kept for reference)
+  - Old validation reports
+  - Deprecated integration guides
+  - Previous version documentation
+
+## 🚀 Quick Links
+
+### Getting Started
+1. [Quick Start Guide](guides/QUICK-START-v1.7.1.md)
+2. [Claude Code Setup](CLAUDE.md)
+3. [Installation Guide](guides/DEPLOYMENT.md)
+
+### Core Features
+- [66 Specialized Agents](CLAUDE.md#-available-agents-54-total)
+- [213 MCP Tools](guides/MCP-TOOLS.md)
+- [ReasoningBank Learning](reasoningbank/README.md)
+- [Multi-Model Router](router/README.md)
+- [QUIC Transport](quic/QUIC-STATUS.md)
+
+### Integration
+- [Claude Flow](integrations/CLAUDE_FLOW_INTEGRATION.md)
+- [Flow Nexus](integrations/FLOW-NEXUS-INTEGRATION.md)
+- [FastMCP](integrations/FASTMCP_CLI_INTEGRATION.md)
+- [Supabase](supabase/README.md)
+
+### Development
+- [Architecture Overview](architecture/EXECUTIVE_SUMMARY.md)
+- [SPARC Methodology](CLAUDE.md#sparc-workflow-phases)
+- [Testing Guide](testing/README.md)
+
+## 📖 Documentation Standards
+
+### File Organization
+- Use descriptive filenames in UPPERCASE-WITH-DASHES.md format
+- Group related docs in topic-specific directories
+- Keep root directory minimal (README, CLAUDE, LICENSE only)
+
+### Content Guidelines
+- Start with a clear title and description
+- Include table of contents for docs > 200 lines
+- Use code blocks with language identifiers
+- Add examples and use cases where applicable
+
+### Directory Structure
+```
+docs/
+├── README.md              # This file
+├── CLAUDE.md             # Claude Code config
+├── LICENSE               # License file
+├── architecture/         # System architecture
+├── guides/              # User guides
+├── integration-docs/    # Integration documentation
+├── integrations/        # Specific integrations
+├── testing/            # Test documentation
+├── releases/           # Release notes
+├── issues/             # Known issues
+├── providers/          # Provider configuration
+├── quic/              # QUIC implementation
+├── reasoningbank/     # ReasoningBank docs
+├── router/            # Router documentation
+├── supabase/          # Supabase integration
+└── archived/          # Historical docs
+```
+
+## 🔍 Search Tips
+
+### Finding Documentation
+- Use `grep -r "keyword" docs/` to search all docs
+- Check the appropriate category directory first
+- Look in archived/ for historical documentation
+
+### Common Topics
+- **Setup**: See guides/ and CLAUDE.md
+- **API Reference**: See integration-docs/
+- **Troubleshooting**: See issues/
+- **Performance**: See benchmarks/
+- **Releases**: See releases/ and version-releases/
+
+## 🤝 Contributing to Docs
+
+### Adding New Documentation
+1. Identify the appropriate directory
+2. Follow naming conventions
+3. Include proper frontmatter/headers
+4. Update this README index
+5. Add cross-references as needed
+
+### Updating Existing Docs
+1. Keep archived versions if major changes
+2. Update last modified date
+3. Maintain backward compatibility links
+4. Test all code examples
+
+## 📞 Support
+
+- **GitHub Issues**: https://github.com/ruvnet/agentic-flow/issues
+- **Documentation Updates**: Submit PR to docs/ directory
+- **Questions**: Check issues/ directory first
+
+---
+
+**Last Updated**: November 6, 2025
+**Version**: 1.9.1