agentic-flow 2.0.6 → 3.0.0-alpha.1

package/dist/utils/agentdbCommands.js

@@ -0,0 +1,175 @@
+/**
+ * AgentDB CLI Command Handlers
+ *
+ * Handles all AgentDB vector database commands for the CLI
+ */
+/**
+ * Handle AgentDB command
+ */
+export async function handleAgentDBCommand(args) {
+    const command = args[0];
+    if (!command || command === 'help') {
+        printAgentDBHelp();
+        return;
+    }
+    // Import AgentDB CLI
+    const { createAgentDBCLI } = await import('agentdb/reasoningbank/cli/commands');
+    // Create AgentDB CLI instance
+    const program = createAgentDBCLI();
+    // Run command with proper args
+    const cliArgs = ['node', 'agentdb', ...args];
+    await program.parseAsync(cliArgs);
+}
+/**
+ * Print AgentDB help
+ */
+function printAgentDBHelp() {
+    console.log(`
+🗄️  AgentDB - Ultra-Fast Vector Database for ReasoningBank
+
+USAGE:
+  npx agentic-flow agentdb <command> [options]
+
+COMMANDS:
+  init                    Initialize AgentDB database
+  insert                  Insert pattern with embedding
+  search                  Search for similar patterns
+  train                   Train learning model on experiences
+  stats                   Display database statistics
+  optimize                Optimize database (consolidation, pruning)
+  update <id>             Update pattern statistics
+  delete <id>             Delete pattern
+  migrate                 Migrate from legacy ReasoningBank
+  export                  Export patterns to JSON
+  import <file>           Import patterns from JSON
+
+INIT:
+  npx agentic-flow agentdb init [options]
+
+  Options:
+    -p, --path <path>       Database path (default: .agentdb/reasoningbank.db)
+    --dimension <dim>       Embedding dimension (default: 768)
+
+INSERT:
+  npx agentic-flow agentdb insert [options]
+
+  Options:
+    -e, --embedding <json>  Embedding vector (JSON array)
+    -d, --domain <domain>   Domain name
+    -p, --pattern <json>    Pattern data (JSON)
+    -c, --confidence <val>  Confidence (0-1, default: 0.5)
+
+SEARCH:
+  npx agentic-flow agentdb search [options]
+
+  Options:
+    -q, --query <json>      Query embedding (JSON array)
+    -l, --limit <n>         Result limit (default: 10)
+    -d, --domain <domain>   Filter by domain
+    --min-confidence <val>  Minimum confidence
+
+TRAIN:
+  npx agentic-flow agentdb train [options]
+
+  Options:
+    -e, --epochs <n>        Number of epochs (default: 50)
+    -b, --batch-size <n>    Batch size (default: 32)
+
+STATS:
+  npx agentic-flow agentdb stats
+
+  Displays:
+    • Total patterns
+    • Total trajectories
+    • Average confidence
+    • Domains
+    • Database size
+
+OPTIMIZE:
+  npx agentic-flow agentdb optimize
+
+  Performs:
+    • Pattern consolidation (95%+ similarity)
+    • Low-quality pattern pruning
+    • Database reindexing
+    • Space optimization
+
+UPDATE:
+  npx agentic-flow agentdb update <id> [options]
+
+  Options:
+    -c, --confidence <val>  New confidence value
+    -u, --usage <n>         Usage count
+    -s, --success <n>       Success count
+
+DELETE:
+  npx agentic-flow agentdb delete <id>
+
+MIGRATE:
+  npx agentic-flow agentdb migrate [options]
+
+  Options:
+    -s, --source <path>     Source database path (legacy)
+    -d, --destination <p>   Destination path (default: .agentdb/reasoningbank.db)
+
+  Automatically:
+    • Creates backup of source database
+    • Migrates all patterns and trajectories
+    • Validates migration
+    • Zero data loss guarantee
+
+EXPORT:
+  npx agentic-flow agentdb export [options]
+
+  Options:
+    -o, --output <file>     Output file (default: patterns.json)
+    -d, --domain <domain>   Filter by domain
+
+IMPORT:
+  npx agentic-flow agentdb import <file>
+
+EXAMPLES:
+  # Initialize database
+  npx agentic-flow agentdb init --path .agentdb/reasoningbank.db
+
+  # Search similar patterns
+  npx agentic-flow agentdb search --query '[0.1, 0.2, ...]' --limit 10
+
+  # Train learning model
+  npx agentic-flow agentdb train --epochs 50 --batch-size 32
+
+  # Get statistics
+  npx agentic-flow agentdb stats
+
+  # Optimize database
+  npx agentic-flow agentdb optimize
+
+  # Migrate from legacy
+  npx agentic-flow agentdb migrate --source .swarm/memory.db
+
+  # Export patterns
+  npx agentic-flow agentdb export --output patterns.json --domain code-generation
+
+  # Import patterns
+  npx agentic-flow agentdb import patterns.json
+
+PERFORMANCE:
+  • Pattern Search: 150x faster (100µs vs 15ms)
+  • Batch Insert: 500x faster (2ms vs 1s)
+  • Large-scale: 12,500x faster (8ms vs 100s at 1M patterns)
+  • Memory: 4-32x reduction with quantization
+
+FEATURES:
+  ✅ HNSW Vector Indexing - O(log n) search complexity
+  ✅ 9 Learning Algorithms - Decision Transformer, Q-Learning, etc.
+  ✅ 4 Reasoning Agents - Pattern Matching, Context Synthesis, etc.
+  ✅ QUIC Synchronization - Multi-agent memory sync
+  ✅ Quantization - Binary (32x), Scalar (4x), Product (8-16x)
+  ✅ 100% Backward Compatible - Drop-in replacement
+
+DOCUMENTATION:
+  Integration Guide: docs/AGENTDB_INTEGRATION.md
+  API Reference: packages/agentdb/docs/integration/IMPLEMENTATION_SUMMARY.md
+  GitHub: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
+`);
+}

package/dist/utils/circular-rate-limiter.js

@@ -0,0 +1,391 @@
+/**
+ * Optimized Rate Limiter with Circular Buffers
+ * 2-5% CPU reduction through efficient circular buffer implementation
+ * Phase 3 Optimization
+ */
+/**
+ * Circular Buffer for efficient timestamp storage
+ * Avoids array shifts and allocations
+ */
+class CircularBuffer {
+    buffer;
+    head = 0;
+    tail = 0;
+    count = 0;
+    size;
+    constructor(size) {
+        this.size = size;
+        this.buffer = new Array(size);
+    }
+    /**
+     * Add timestamp to buffer
+     */
+    add(timestamp) {
+        this.buffer[this.tail] = timestamp;
+        this.tail = (this.tail + 1) % this.size;
+        if (this.count < this.size) {
+            this.count++;
+        }
+        else {
+            // Buffer is full, move head forward
+            this.head = (this.head + 1) % this.size;
+        }
+    }
+    /**
+     * Remove timestamps older than cutoff
+     */
+    removeOlderThan(cutoff) {
+        let removed = 0;
+        while (this.count > 0) {
+            const timestamp = this.buffer[this.head];
+            if (timestamp >= cutoff) {
+                break;
+            }
+            this.head = (this.head + 1) % this.size;
+            this.count--;
+            removed++;
+        }
+        return removed;
+    }
+    /**
+     * Get current count
+     */
+    getCount() {
+        return this.count;
+    }
+    /**
+     * Get oldest timestamp
+     */
+    getOldest() {
+        return this.count > 0 ? this.buffer[this.head] : null;
+    }
+    /**
+     * Clear buffer
+     */
+    clear() {
+        this.head = 0;
+        this.tail = 0;
+        this.count = 0;
+    }
+    /**
+     * Check if buffer is full
+     */
+    isFull() {
+        return this.count === this.size;
+    }
+    /**
+     * Get buffer utilization
+     */
+    getUtilization() {
+        return (this.count / this.size) * 100;
+    }
+}
+/**
+ * Circular Rate Limiter
+ * Uses circular buffers for efficient rate limiting with minimal CPU overhead
+ */
+export class CircularRateLimiter {
+    config;
+    clients = new Map();
+    stats;
+    constructor(config) {
+        this.config = {
+            enabled: config.enabled,
+            windowMs: config.windowMs || 60000, // 1 minute default
+            maxRequests: config.maxRequests || 100,
+            bufferSize: config.bufferSize || 200 // 2x maxRequests for safety
+        };
+        this.stats = {
+            totalRequests: 0,
+            allowedRequests: 0,
+            blockedRequests: 0,
+            uniqueClients: 0,
+            avgCheckTime: 0
+        };
+    }
+    /**
+     * Check if request is allowed
+     */
+    checkLimit(clientId) {
+        if (!this.config.enabled) {
+            return {
+                allowed: true,
+                remaining: this.config.maxRequests,
+                resetAt: Date.now() + this.config.windowMs
+            };
+        }
+        const startTime = performance.now();
+        const now = Date.now();
+        const windowStart = now - this.config.windowMs;
+        // Get or create buffer for client
+        let buffer = this.clients.get(clientId);
+        if (!buffer) {
+            buffer = new CircularBuffer(this.config.bufferSize);
+            this.clients.set(clientId, buffer);
+            this.stats.uniqueClients = this.clients.size;
+        }
+        // Remove expired timestamps
+        buffer.removeOlderThan(windowStart);
+        const currentCount = buffer.getCount();
+        const allowed = currentCount < this.config.maxRequests;
+        if (allowed) {
+            buffer.add(now);
+            this.stats.allowedRequests++;
+        }
+        else {
+            this.stats.blockedRequests++;
+        }
+        this.stats.totalRequests++;
+        // Update average check time
+        const checkTime = performance.now() - startTime;
+        this.updateAvgCheckTime(checkTime);
+        const oldest = buffer.getOldest();
+        const resetAt = oldest ? oldest + this.config.windowMs : now + this.config.windowMs;
+        const retryAfter = allowed ? undefined : resetAt - now;
+        return {
+            allowed,
+            remaining: Math.max(0, this.config.maxRequests - currentCount - (allowed ? 1 : 0)),
+            resetAt,
+            retryAfter
+        };
+    }
+    /**
+     * Update average check time
+     */
+    updateAvgCheckTime(newTime) {
+        const total = this.stats.totalRequests;
+        const currentAvg = this.stats.avgCheckTime;
+        this.stats.avgCheckTime = (currentAvg * (total - 1) + newTime) / total;
+    }
+    /**
+     * Reset limit for a client
+     */
+    reset(clientId) {
+        const buffer = this.clients.get(clientId);
+        if (buffer) {
+            buffer.clear();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Remove a client
+     */
+    removeClient(clientId) {
+        const removed = this.clients.delete(clientId);
+        if (removed) {
+            this.stats.uniqueClients = this.clients.size;
+        }
+        return removed;
+    }
+    /**
+     * Clean up expired clients
+     */
+    cleanup() {
+        const now = Date.now();
+        const windowStart = now - this.config.windowMs;
+        let cleaned = 0;
+        for (const [clientId, buffer] of this.clients) {
+            buffer.removeOlderThan(windowStart);
+            // Remove clients with no recent activity
+            if (buffer.getCount() === 0) {
+                this.clients.delete(clientId);
+                cleaned++;
+            }
+        }
+        this.stats.uniqueClients = this.clients.size;
+        return cleaned;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get block rate
+     */
+    getBlockRate() {
+        return this.stats.totalRequests > 0
+            ? (this.stats.blockedRequests / this.stats.totalRequests) * 100
+            : 0;
+    }
+    /**
+     * Get client info
+     */
+    getClientInfo(clientId) {
+        const buffer = this.clients.get(clientId);
+        if (!buffer) {
+            return null;
+        }
+        return {
+            count: buffer.getCount(),
+            utilization: buffer.getUtilization(),
+            oldest: buffer.getOldest()
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalRequests: 0,
+            allowedRequests: 0,
+            blockedRequests: 0,
+            uniqueClients: this.clients.size,
+            avgCheckTime: 0
+        };
+    }
+    /**
+     * Clear all clients
+     */
+    clear() {
+        this.clients.clear();
+        this.stats.uniqueClients = 0;
+    }
+    /**
+     * Get configuration (for subclasses)
+     */
+    getConfig() {
+        return this.config;
+    }
+}
+/**
+ * Sliding Window Rate Limiter
+ * More accurate than fixed window, uses circular buffers
+ */
+export class SlidingWindowRateLimiter extends CircularRateLimiter {
+    /**
+     * Check with sliding window algorithm
+     */
+    checkLimitSliding(clientId) {
+        const result = this.checkLimit(clientId);
+        // Sliding window provides more accurate rate limiting
+        // by continuously cleaning up old timestamps
+        const clientInfo = this.getClientInfo(clientId);
+        if (clientInfo && clientInfo.oldest) {
+            const now = Date.now();
+            const config = this.getConfig();
+            const windowStart = now - config.windowMs;
+            // More accurate remaining calculation
+            const timeInWindow = now - Math.max(clientInfo.oldest, windowStart);
+            const weightedCount = (clientInfo.count * timeInWindow) / config.windowMs;
+            result.remaining = Math.max(0, Math.floor(config.maxRequests - weightedCount));
+        }
+        return result;
+    }
+}
+/**
+ * Token Bucket Rate Limiter
+ * Allows burst traffic while maintaining average rate
+ */
+export class TokenBucketRateLimiter {
+    config;
+    buckets = new Map();
+    stats;
+    constructor(config) {
+        this.config = {
+            capacity: config.capacity,
+            refillRate: config.refillRate,
+            refillInterval: config.refillInterval || 1000
+        };
+        this.stats = {
+            totalRequests: 0,
+            allowedRequests: 0,
+            blockedRequests: 0,
+            uniqueClients: 0,
+            avgCheckTime: 0
+        };
+    }
+    /**
+     * Check if tokens available
+     */
+    checkLimit(clientId, tokens = 1) {
+        let bucket = this.buckets.get(clientId);
+        if (!bucket) {
+            bucket = new TokenBucket(this.config.capacity, this.config.refillRate, this.config.refillInterval);
+            this.buckets.set(clientId, bucket);
+            this.stats.uniqueClients = this.buckets.size;
+        }
+        const allowed = bucket.consume(tokens);
+        this.stats.totalRequests++;
+        if (allowed) {
+            this.stats.allowedRequests++;
+        }
+        else {
+            this.stats.blockedRequests++;
+        }
+        return {
+            allowed,
+            remaining: Math.floor(bucket.getTokens()),
+            resetAt: Date.now() + this.config.refillInterval
+        };
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+}
+/**
+ * Token Bucket implementation
+ */
+class TokenBucket {
+    tokens;
+    capacity;
+    refillRate;
+    lastRefill;
+    refillInterval;
+    constructor(capacity, refillRate, refillInterval) {
+        this.capacity = capacity;
+        this.tokens = capacity;
+        this.refillRate = refillRate;
+        this.refillInterval = refillInterval;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Consume tokens
+     */
+    consume(tokens) {
+        this.refill();
+        if (this.tokens >= tokens) {
+            this.tokens -= tokens;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Refill tokens
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const intervals = Math.floor(elapsed / this.refillInterval);
+        if (intervals > 0) {
+            this.tokens = Math.min(this.capacity, this.tokens + intervals * this.refillRate);
+            this.lastRefill = now;
+        }
+    }
+    /**
+     * Get current tokens
+     */
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+}
+/**
+ * Calculate CPU savings from circular buffer optimization
+ */
+export function calculateRateLimiterSavings(oldAvgTime, newAvgTime, totalRequests) {
+    const savings = oldAvgTime - newAvgTime;
+    const savingsPercentage = (savings / oldAvgTime) * 100;
+    const totalTimeSaved = savings * totalRequests;
+    const cpuReduction = savingsPercentage;
+    return {
+        savingsPercentage,
+        totalTimeSaved,
+        cpuReduction
+    };
+}

package/dist/utils/cli.d.ts

@@ -1,5 +1,5 @@
 export interface CliOptions {
-    mode: 'agent' | 'parallel' | 'list' | 'mcp' | 'mcp-manager' | 'config' | 'agent-manager' | 'proxy' | 'quic' | 'claude-code' | 'reasoningbank' | 'federation';
+    mode: 'agent' | 'parallel' | 'list' | 'mcp' | 'mcp-manager' | 'config' | 'agent-manager' | 'proxy' | 'quic' | 'claude-code' | 'reasoningbank' | 'federation' | 'daemon' | 'hive-mind' | 'hivemind' | 'hooks' | 'session' | 'swarm' | 'memory' | 'task' | 'doctor' | 'autopilot';
     agent?: string;
     task?: string;
     model?: string;

package/dist/utils/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/utils/cli.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,CAAC;IAC7J,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,IAAI,UAAU,CA4LtC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAiLhC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAWlE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/utils/cli.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAChR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,IAAI,UAAU,CA4LtC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAiLhC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAWlE"}

package/dist/utils/cli.js.map

@@ -1 +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"]}
+{"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' | 'daemon' | 'hive-mind' | 'hivemind' | 'hooks' | 'session' | 'swarm' | 'memory' | 'task' | 'doctor' | 'autopilot';\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"]}