claude-flow 2.0.0-alpha.35 → 2.0.0-alpha.37

package/README.md

@@ -30,7 +30,23 @@
 - **⚡ Performance**: 84.8% SWE-Bench solve rate, 2.8-4.4x speed improvement
 
 > 🔥 **Revolutionary AI Coordination**: Build faster, smarter, and more efficiently with AI-powered development orchestration
- 
+
+## 📚 **Table of Contents**
+
+- [⚡ Quick Start](#-try-v200-alpha-in-4-commands)
+- [🪝 Advanced Hooks System](#-advanced-hooks-system)
+- [🧠 Neural Features](#neural-features)
+- [🔧 DAA MCP Endpoints](#-daa-mcp-endpoints)
+- [🐝 Hive-Mind Intelligence](#-revolutionary-hive-mind-intelligence)
+- [🔧 Hive-Mind Optimization](#-hive-mind-database-optimization)
+- [⚡ 87 Advanced MCP Tools](#-87-advanced-mcp-tools)
+- [🎮 Advanced Usage Examples](#-advanced-usage-examples)
+- [🏗️ Architecture Overview](#️-alpha-architecture-overview)
+- [🛠️ Installation & Setup](#️-alpha-installation--setup)
+- [📖 Documentation](#-comprehensive-documentation)
+- [🤝 Contributing](#-contributing-to-alpha)
+- [📜 License](#-license)
+
 ## ⚡ **Try v2.0.0 Alpha in 4 Commands**
 
 ### 🎯 **Instant Alpha Testing**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "2.0.0-alpha.35",
+  "version": "2.0.0-alpha.37",
   "description": "Enterprise-grade AI agent orchestration with ruv-swarm integration (Alpha Release)",
   "main": "cli.mjs",
   "bin": {

package/scripts/ruv-swarm-safe.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+/**
+ * Safe wrapper for ruv-swarm MCP server
+ * Handles known logger issue in v1.0.8
+ */
+
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+
+console.log('🚀 Starting ruv-swarm MCP server with error handling...');
+
+const ruvSwarmProcess = spawn('npx', ['ruv-swarm', 'mcp', 'start'], {
+  stdio: ['pipe', 'pipe', 'pipe'],
+  env: {
+    ...process.env,
+    MCP_MODE: 'stdio',
+    LOG_LEVEL: 'WARN'
+  }
+});
+
+// Forward stdin to ruv-swarm
+process.stdin.pipe(ruvSwarmProcess.stdin);
+
+// Handle stdout (JSON-RPC messages)
+ruvSwarmProcess.stdout.pipe(process.stdout);
+
+// Handle stderr with filtering
+const rlErr = createInterface({
+  input: ruvSwarmProcess.stderr,
+  crlfDelay: Infinity
+});
+
+let errorHandled = false;
+
+rlErr.on('line', (line) => {
+  // Filter out the known logger error
+  if (line.includes('logger.logMemoryUsage is not a function')) {
+    if (!errorHandled) {
+      console.error('⚠️  Known ruv-swarm v1.0.8 logger issue detected - continuing normally');
+      console.error('💡 This error does not affect functionality');
+      errorHandled = true;
+    }
+    return;
+  }
+  
+  // Forward other stderr output
+  process.stderr.write(line + '\n');
+});
+
+// Handle process exit
+ruvSwarmProcess.on('exit', (code, signal) => {
+  if (code !== null && code !== 0) {
+    console.error(`\n❌ ruv-swarm exited with code ${code}`);
+    console.error('💡 Try using: npx claude-flow@alpha mcp start');
+  }
+  process.exit(code || 0);
+});
+
+// Handle errors
+ruvSwarmProcess.on('error', (error) => {
+  console.error('❌ Failed to start ruv-swarm:', error.message);
+  console.error('💡 Try using: npx claude-flow@alpha mcp start');
+  process.exit(1);
+});
+
+// Handle termination signals
+process.on('SIGTERM', () => {
+  ruvSwarmProcess.kill('SIGTERM');
+});
+
+process.on('SIGINT', () => {
+  ruvSwarmProcess.kill('SIGINT');
+});

package/src/cli/simple-commands/hive-mind.js

@@ -1602,7 +1602,7 @@ async function spawnClaudeCodeInstances(swarmId, swarmName, objective, workers,
         claudeAvailable = true;
       } catch {
         console.log(chalk.yellow('\n⚠️  Claude Code CLI not found in PATH'));
-        console.log(chalk.gray('Install it with: npm install -g @anthropic/claude-code-cli'));
+        console.log(chalk.gray('Install it with: npm install -g @anthropic-ai/claude-code'));
         console.log(chalk.gray('\nFalling back to displaying instructions...'));
       }
       
@@ -1646,7 +1646,7 @@ async function spawnClaudeCodeInstances(swarmId, swarmName, objective, workers,
         console.log(chalk.yellow('\n📋 Manual Execution Instructions:'));
         console.log(chalk.gray('─'.repeat(50)));
         console.log(chalk.gray('1. Install Claude Code:'));
-        console.log(chalk.green('   npm install -g @anthropic/claude-code-cli'));
+        console.log(chalk.green('   npm install -g @anthropic-ai/claude-code'));
         console.log(chalk.gray('\n2. Run with the saved prompt:'));
         console.log(chalk.green(`   claude < ${promptFile}`));
         console.log(chalk.gray('\n3. Or copy the prompt manually:'));

package/src/cli/simple-commands/swarm.js

@@ -115,7 +115,7 @@ export async function swarmCommand(args, flags) {
         claudeAvailable = true;
       } catch {
         console.log('⚠️  Claude Code CLI not found in PATH');
-        console.log('Install it with: npm install -g @anthropic/claude-code-cli');
+        console.log('Install it with: npm install -g @anthropic-ai/claude-code');
         console.log('\nWould spawn Claude Code with swarm objective:');
         console.log(`📋 Objective: ${objective}`);
         console.log('\nTo use the built-in executor instead: claude-flow swarm "objective" --executor');

package/src/mcp/ruv-swarm-wrapper.js

@@ -0,0 +1,202 @@
+/**
+ * Wrapper for ruv-swarm MCP server to handle logger issues
+ * This wrapper ensures compatibility and handles known issues in ruv-swarm
+ */
+
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+
+export class RuvSwarmWrapper {
+  constructor(options = {}) {
+    this.options = {
+      silent: options.silent || false,
+      autoRestart: options.autoRestart !== false,
+      maxRestarts: options.maxRestarts || 3,
+      restartDelay: options.restartDelay || 1000,
+      ...options
+    };
+    
+    this.process = null;
+    this.restartCount = 0;
+    this.isShuttingDown = false;
+  }
+
+  async start() {
+    if (this.process) {
+      throw new Error('RuvSwarm MCP server is already running');
+    }
+
+    return new Promise((resolve, reject) => {
+      try {
+        // Spawn ruv-swarm MCP server
+        this.process = spawn('npx', ['ruv-swarm', 'mcp', 'start'], {
+          stdio: ['pipe', 'pipe', 'pipe'],
+          env: {
+            ...process.env,
+            // Ensure stdio mode for MCP
+            MCP_MODE: 'stdio',
+            // Set log level to reduce noise
+            LOG_LEVEL: 'WARN'
+          }
+        });
+
+        let initialized = false;
+        let initTimeout;
+
+        // Handle stdout (JSON-RPC messages)
+        const rlOut = createInterface({
+          input: this.process.stdout,
+          crlfDelay: Infinity
+        });
+
+        rlOut.on('line', (line) => {
+          try {
+            const message = JSON.parse(line);
+            
+            // Check for initialization
+            if (message.method === 'server.initialized' && !initialized) {
+              initialized = true;
+              clearTimeout(initTimeout);
+              resolve({
+                process: this.process,
+                stdout: this.process.stdout,
+                stdin: this.process.stdin
+              });
+            }
+            
+            // Forward JSON-RPC messages
+            process.stdout.write(line + '\n');
+          } catch (err) {
+            // Not JSON, ignore
+          }
+        });
+
+        // Handle stderr (logs and errors)
+        const rlErr = createInterface({
+          input: this.process.stderr,
+          crlfDelay: Infinity
+        });
+
+        rlErr.on('line', (line) => {
+          // Filter out known harmless errors
+          if (line.includes('logger.logMemoryUsage is not a function')) {
+            // This is a known issue in ruv-swarm v1.0.8
+            // The server continues to work despite this error
+            if (!this.options.silent) {
+              console.error('⚠️  Known ruv-swarm logger issue detected (continuing normally)');
+            }
+            return;
+          }
+
+          // Filter out initialization messages if silent
+          if (this.options.silent) {
+            if (line.includes('✅') || line.includes('🧠') || line.includes('📊')) {
+              return;
+            }
+          }
+
+          // Forward other stderr output
+          if (!this.options.silent) {
+            process.stderr.write(line + '\n');
+          }
+        });
+
+        // Handle process errors
+        this.process.on('error', (error) => {
+          if (!initialized) {
+            clearTimeout(initTimeout);
+            reject(new Error(`Failed to start ruv-swarm: ${error.message}`));
+          } else {
+            console.error('RuvSwarm process error:', error);
+            this.handleProcessExit(error.code || 1);
+          }
+        });
+
+        // Handle process exit
+        this.process.on('exit', (code, signal) => {
+          if (!initialized) {
+            clearTimeout(initTimeout);
+            reject(new Error(`RuvSwarm exited before initialization: code ${code}, signal ${signal}`));
+          } else {
+            this.handleProcessExit(code || 0);
+          }
+        });
+
+        // Set initialization timeout
+        initTimeout = setTimeout(() => {
+          if (!initialized) {
+            this.stop();
+            reject(new Error('RuvSwarm initialization timeout'));
+          }
+        }, 30000); // 30 second timeout
+
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  handleProcessExit(code) {
+    this.process = null;
+
+    if (this.isShuttingDown) {
+      return;
+    }
+
+    console.error(`RuvSwarm MCP server exited with code ${code}`);
+
+    // Auto-restart if enabled and under limit
+    if (this.options.autoRestart && this.restartCount < this.options.maxRestarts) {
+      this.restartCount++;
+      console.log(`Attempting to restart RuvSwarm (attempt ${this.restartCount}/${this.options.maxRestarts})...`);
+      
+      setTimeout(() => {
+        this.start().catch(err => {
+          console.error('Failed to restart RuvSwarm:', err);
+        });
+      }, this.options.restartDelay);
+    }
+  }
+
+  async stop() {
+    this.isShuttingDown = true;
+    
+    if (!this.process) {
+      return;
+    }
+
+    return new Promise((resolve) => {
+      const killTimeout = setTimeout(() => {
+        console.warn('RuvSwarm did not exit gracefully, forcing kill...');
+        this.process.kill('SIGKILL');
+      }, 5000);
+
+      this.process.on('exit', () => {
+        clearTimeout(killTimeout);
+        this.process = null;
+        resolve();
+      });
+
+      // Send graceful shutdown signal
+      this.process.kill('SIGTERM');
+    });
+  }
+
+  isRunning() {
+    return this.process !== null && !this.process.killed;
+  }
+}
+
+// Export a function to start ruv-swarm with error handling
+export async function startRuvSwarmMCP(options = {}) {
+  const wrapper = new RuvSwarmWrapper(options);
+  
+  try {
+    const result = await wrapper.start();
+    console.log('✅ RuvSwarm MCP server started successfully');
+    return { wrapper, ...result };
+  } catch (error) {
+    console.error('❌ Failed to start RuvSwarm MCP server:', error.message);
+    throw error;
+  }
+}