claude-flow 2.0.0-alpha.99 → 2.0.0

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

@@ -983,6 +983,12 @@ To enable persistence, see: https://github.com/ruvnet/claude-code-flow/docs/wind
       return true;
     }
     
+    // Check if database connection is still open before operations
+    if (!this.db || !this.db.open) {
+      console.warn('Database connection closed, cannot remove child PID during cleanup');
+      return false;
+    }
+    
     const session = this.db.prepare('SELECT child_pids FROM sessions WHERE id = ?').get(sessionId);
     if (!session) return false;
 
@@ -1016,6 +1022,12 @@ To enable persistence, see: https://github.com/ruvnet/claude-code-flow/docs/wind
       if (!session || !session.child_pids) return [];
       return sessionSerializer.deserializeLogData(session.child_pids);
     } else {
+      // Check if database connection is still open
+      if (!this.db || !this.db.open) {
+        console.warn('Database connection closed, cannot get child PIDs during cleanup');
+        return [];
+      }
+      
       // Use SQLite
       const session = this.db.prepare('SELECT child_pids FROM sessions WHERE id = ?').get(sessionId);
       if (!session || !session.child_pids) return [];

package/src/cli/simple-commands/init/agent-copier.js

@@ -162,7 +162,10 @@ export async function createAgentDirectories(targetDir, dryRun = false) {
     '.claude/agents/documentation',
     '.claude/agents/documentation/api-docs',
     '.claude/agents/specialized',
-    '.claude/agents/specialized/mobile'
+    '.claude/agents/specialized/mobile',
+    '.claude/agents/flow-nexus',
+    '.claude/commands',
+    '.claude/commands/flow-nexus'
   ];
   
   if (dryRun) {
@@ -180,6 +183,131 @@ export async function createAgentDirectories(targetDir, dryRun = false) {
 /**
  * Validate agent system after copying
  */
+/**
+ * Copy all command files from the installed package to project directory
+ */
+export async function copyCommandFiles(targetDir, options = {}) {
+  const { force = false, dryRun = false } = options;
+  
+  // Path to command files - try multiple locations
+  const packageCommandsDir = join(__dirname, '../../../../.claude/commands'); // From npm package
+  const localCommandsDir = '/workspaces/claude-code-flow/.claude/commands';   // Local development
+  const cwdCommandsDir = join(process.cwd(), '.claude/commands');              // Current working directory
+  
+  let sourceCommandsDir;
+  
+  // Try local development first, then package, then cwd
+  try {
+    await fs.access(localCommandsDir);
+    sourceCommandsDir = localCommandsDir;
+    console.log('  📁 Using local development command files');
+  } catch {
+    try {
+      await fs.access(packageCommandsDir);
+      sourceCommandsDir = packageCommandsDir;
+      console.log('  📁 Using packaged command files');
+    } catch {
+      try {
+        await fs.access(cwdCommandsDir);
+        sourceCommandsDir = cwdCommandsDir;
+        console.log('  📁 Using current directory command files');
+      } catch {
+        console.log('  ⚠️  No command files found in any location');
+        return { success: false, error: 'Command files not found' };
+      }
+    }
+  }
+  
+  const targetCommandsDir = join(targetDir, '.claude/commands');
+  
+  console.log('📁 Copying command system files...');
+  console.log(`  📂 Source: ${sourceCommandsDir}`);
+  console.log(`  📂 Target: ${targetCommandsDir}`);
+  
+  try {
+    // Create target directory
+    if (!dryRun) {
+      await fs.mkdir(targetCommandsDir, { recursive: true });
+    }
+    
+    const copiedFiles = [];
+    const errors = [];
+    
+    // Recursively copy all command files
+    async function copyRecursive(srcDir, destDir) {
+      const items = await fs.readdir(srcDir, { withFileTypes: true });
+      
+      for (const item of items) {
+        const srcPath = join(srcDir, item.name);
+        const destPath = join(destDir, item.name);
+        
+        if (item.isDirectory()) {
+          if (!dryRun) {
+            await fs.mkdir(destPath, { recursive: true });
+          }
+          await copyRecursive(srcPath, destPath);
+        } else if (item.isFile() && item.name.endsWith('.md')) {
+          try {
+            // Check if file already exists
+            let shouldCopy = force;
+            if (!force) {
+              try {
+                await fs.access(destPath);
+                // File exists, skip unless force is true
+                continue;
+              } catch {
+                // File doesn't exist, safe to copy
+                shouldCopy = true;
+              }
+            }
+            
+            if (shouldCopy && !dryRun) {
+              const content = await fs.readFile(srcPath, 'utf8');
+              await fs.writeFile(destPath, content, 'utf8');
+              copiedFiles.push(destPath.replace(targetDir + '/', ''));
+            } else if (dryRun) {
+              copiedFiles.push(destPath.replace(targetDir + '/', ''));
+            }
+          } catch (err) {
+            errors.push(`Failed to copy ${item.name}: ${err.message}`);
+          }
+        }
+      }
+    }
+    
+    await copyRecursive(sourceCommandsDir, targetCommandsDir);
+    
+    if (!dryRun && copiedFiles.length > 0) {
+      console.log(`  ✅ Copied ${copiedFiles.length} command files`);
+      console.log('  📋 Command system initialized with comprehensive documentation');
+      console.log('  🎯 Available categories: Analysis, Automation, GitHub, Hooks, Memory, Flow Nexus');
+    } else if (dryRun) {
+      console.log(`  [DRY RUN] Would copy ${copiedFiles.length} command files`);
+    }
+    
+    if (errors.length > 0) {
+      console.log('  ⚠️  Some command files could not be copied:');
+      errors.forEach(error => console.log(`    - ${error}`));
+    }
+    
+    return {
+      success: true,
+      copiedFiles,
+      errors,
+      totalCommands: copiedFiles.length
+    };
+    
+  } catch (err) {
+    console.log(`  ❌ Failed to copy command files: ${err.message}`);
+    return {
+      success: false,
+      error: err.message,
+      copiedFiles: [],
+      errors: [err.message]
+    };
+  }
+}
+
 export async function validateAgentSystem(targetDir) {
   const agentsDir = join(targetDir, '.claude/agents');
   

package/src/cli/simple-commands/init/index.js

@@ -41,7 +41,7 @@ import { createOptimizedClaudeSlashCommands } from './claude-commands/optimized-
 import { promises as fs } from 'fs';
 import { copyTemplates } from './template-copier.js';
 import { copyRevisedTemplates, validateTemplatesExist } from './copy-revised-templates.js';
-import { copyAgentFiles, createAgentDirectories, validateAgentSystem } from './agent-copier.js';
+import { copyAgentFiles, createAgentDirectories, validateAgentSystem, copyCommandFiles } from './agent-copier.js';
 import { showInitHelp } from './help.js';
 import { batchInitCommand, batchInitFromConfig, validateBatchOptions } from './batch-init.js';
 import { ValidationSystem, runFullValidation } from './validation/index.js';
@@ -110,6 +110,11 @@ async function setupMcpServers(dryRun = false) {
       command: 'npx ruv-swarm mcp start',
       description: 'ruv-swarm MCP server for enhanced coordination',
     },
+    {
+      name: 'flow-nexus',
+      command: 'npx flow-nexus@latest mcp start',
+      description: 'Flow Nexus Complete MCP server for advanced AI orchestration',
+    },
   ];
 
   for (const server of servers) {
@@ -150,6 +155,11 @@ export async function initCommand(subArgs, flags) {
   const hasVerificationFlags = subArgs.includes('--verify') || subArgs.includes('--pair') || 
                                flags.verify || flags.pair;
   
+  // Handle Flow Nexus minimal init
+  if (flags['flow-nexus']) {
+    return await flowNexusMinimalInit(flags, subArgs);
+  }
+
   // Default to enhanced Claude Flow v2 init unless other modes are specified
   // Use --basic flag for old behavior, or verification flags for verification mode
   if (!flags.basic && !flags.minimal && !flags.sparc && !hasVerificationFlags) {
@@ -529,6 +539,7 @@ export async function initCommand(subArgs, flags) {
         console.log('  📋 Then add MCP servers manually with:');
         console.log('     claude mcp add claude-flow claude-flow mcp start');
         console.log('     claude mcp add ruv-swarm npx ruv-swarm mcp start');
+        console.log('     claude mcp add flow-nexus npx flow-nexus@latest mcp start');
       }
     }
   } catch (err) {
@@ -1437,6 +1448,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}
         console.log('\n  📋 To add MCP servers manually:');
         console.log('     claude mcp add claude-flow npx claude-flow@alpha mcp start');
         console.log('     claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');
+        console.log('     claude mcp add flow-nexus npx flow-nexus@latest mcp start');
         console.log('\n  💡 MCP servers are defined in .mcp.json (project scope)');
       }
     } else if (!dryRun && !isClaudeCodeInstalled()) {
@@ -1446,6 +1458,7 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}
       console.log('\n  📋 After installing, add MCP servers:');
       console.log('     claude mcp add claude-flow npx claude-flow@alpha mcp start');
       console.log('     claude mcp add ruv-swarm npx ruv-swarm@latest mcp start');
+      console.log('     claude mcp add flow-nexus npx flow-nexus@latest mcp start');
       console.log('\n  💡 MCP servers are defined in .mcp.json (project scope)');
     }
 
@@ -1460,6 +1473,20 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}
       
       if (agentResult.success) {
         await validateAgentSystem(workingDir);
+        
+        // Copy command files including Flow Nexus commands
+        console.log('\n📚 Setting up command system...');
+        const commandResult = await copyCommandFiles(workingDir, {
+          force: force,
+          dryRun: dryRun
+        });
+        
+        if (commandResult.success) {
+          console.log('✅ ✓ Command system setup complete with Flow Nexus integration');
+        } else {
+          console.log('⚠️  Command system setup failed:', commandResult.error);
+        }
+        
         console.log('✅ ✓ Agent system setup complete with 64 specialized agents');
       } else {
         console.log('⚠️  Agent system setup failed:', agentResult.error);
@@ -1531,3 +1558,91 @@ ${commands.map((cmd) => `- [${cmd}](./${cmd}.md)`).join('\n')}
     }
   }
 }
+
+/**
+ * Flow Nexus minimal initialization - only creates Flow Nexus CLAUDE.md, commands, and agents
+ */
+async function flowNexusMinimalInit(flags, subArgs) {
+  console.log('🌐 Flow Nexus: Initializing minimal setup...');
+  
+  try {
+    const force = flags.force || flags.f;
+    
+    // Import functions we need
+    const { createFlowNexusClaudeMd } = await import('./templates/claude-md.js');
+    const { promises: fs } = await import('fs');
+    
+    // Create Flow Nexus CLAUDE.md
+    console.log('📝 Creating Flow Nexus CLAUDE.md...');
+    const flowNexusClaudeMd = createFlowNexusClaudeMd();
+    await fs.writeFile('CLAUDE.md', flowNexusClaudeMd);
+    console.log('  ✅ Created CLAUDE.md with Flow Nexus integration');
+    
+    // Create .claude/commands/flow-nexus directory and copy commands
+    console.log('📁 Setting up Flow Nexus commands...');
+    await fs.mkdir('.claude/commands/flow-nexus', { recursive: true });
+    
+    // Copy Flow Nexus command files
+    const sourceCommandsDir = '/workspaces/claude-code-flow/.claude/commands/flow-nexus';
+    try {
+      const commandFiles = await fs.readdir(sourceCommandsDir);
+      let copiedCommands = 0;
+      
+      for (const file of commandFiles) {
+        if (file.endsWith('.md')) {
+          const sourcePath = `${sourceCommandsDir}/${file}`;
+          const destPath = `.claude/commands/flow-nexus/${file}`;
+          const content = await fs.readFile(sourcePath, 'utf8');
+          await fs.writeFile(destPath, content);
+          copiedCommands++;
+        }
+      }
+      
+      console.log(`  ✅ Copied ${copiedCommands} Flow Nexus command files`);
+    } catch (err) {
+      console.log('  ⚠️  Could not copy Flow Nexus commands:', err.message);
+    }
+    
+    // Create .claude/agents/flow-nexus directory and copy agents
+    console.log('🤖 Setting up Flow Nexus agents...');
+    await fs.mkdir('.claude/agents/flow-nexus', { recursive: true });
+    
+    // Copy Flow Nexus agent files
+    const sourceAgentsDir = '/workspaces/claude-code-flow/.claude/agents/flow-nexus';
+    try {
+      const agentFiles = await fs.readdir(sourceAgentsDir);
+      let copiedAgents = 0;
+      
+      for (const file of agentFiles) {
+        if (file.endsWith('.md')) {
+          const sourcePath = `${sourceAgentsDir}/${file}`;
+          const destPath = `.claude/agents/flow-nexus/${file}`;
+          const content = await fs.readFile(sourcePath, 'utf8');
+          await fs.writeFile(destPath, content);
+          copiedAgents++;
+        }
+      }
+      
+      console.log(`  ✅ Copied ${copiedAgents} Flow Nexus agent files`);
+    } catch (err) {
+      console.log('  ⚠️  Could not copy Flow Nexus agents:', err.message);
+    }
+    
+    console.log('\n🎉 Flow Nexus minimal initialization complete!');
+    console.log('📚 Created: CLAUDE.md with Flow Nexus documentation');
+    console.log('📁 Created: .claude/commands/flow-nexus/ directory with command documentation');
+    console.log('🤖 Created: .claude/agents/flow-nexus/ directory with specialized agents');
+    console.log('');
+    console.log('💡 Quick Start:');
+    console.log('  1. Register: mcp__flow-nexus__user_register({ email, password })');
+    console.log('  2. Login: mcp__flow-nexus__user_login({ email, password })');
+    console.log('  3. Deploy: mcp__flow-nexus__swarm_init({ topology: "mesh", maxAgents: 5 })');
+    console.log('');
+    console.log('🔗 Use Flow Nexus MCP tools in Claude Code for full functionality');
+    
+  } catch (err) {
+    console.log(`❌ Flow Nexus initialization failed: ${err.message}`);
+    console.log('Stack trace:', err.stack);
+    process.exit(1);
+  }
+}

package/src/cli/simple-commands/init/templates/claude-md.js

@@ -36,6 +36,57 @@ If ANY answer is "No", you MUST combine operations into a single message!
 - Follow project conventions
 - Run typecheck before committing
 
+## 🌐 Flow Nexus Cloud Platform
+
+Flow Nexus extends Claude Flow with cloud-powered features:
+
+### Quick Start
+1. **Register**: \`mcp__flow-nexus__user_register\` with email/password
+2. **Login**: \`mcp__flow-nexus__user_login\` to access features
+3. **Check Balance**: \`mcp__flow-nexus__check_balance\` for credits
+
+### Key Capabilities
+
+**🤖 AI Swarms**
+- Deploy multi-agent swarms in cloud sandboxes
+- Pre-built templates for common architectures
+- Auto-scaling and load balancing
+
+**📦 E2B Sandboxes**
+- \`mcp__flow-nexus__sandbox_create\` - Isolated execution environments
+- Support for Node.js, Python, React, Next.js
+- Real-time code execution with environment variables
+
+**⚡ Workflows**
+- \`mcp__flow-nexus__workflow_create\` - Event-driven automation
+- Parallel task processing with message queues
+- Reusable workflow templates
+
+**🎯 Challenges & Learning**
+- \`mcp__flow-nexus__challenges_list\` - Coding challenges
+- Earn rUv credits by completing tasks
+- Global leaderboard and achievements
+
+**🧠 Neural Networks**
+- \`mcp__flow-nexus__neural_train\` - Train custom models
+- Distributed training across sandboxes
+- Pre-built templates for ML tasks
+
+**💰 Credits & Billing**
+- Pay-as-you-go with rUv credits
+- Auto-refill configuration available
+- Free tier for getting started
+
+### Example: Deploy a Swarm
+\`\`\`javascript
+// Login and deploy
+mcp__flow-nexus__user_login { email: "user@example.com", password: "***" }
+mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }
+mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }
+\`\`\`
+
+Learn more: https://github.com/ruvnet/claude-flow#flow-nexus
+
 ## Project Info
 This is a Claude-Flow AI agent orchestration system.
 `;
@@ -141,6 +192,57 @@ This is a Claude-Flow AI agent orchestration system with the following component
 - Use \`./claude-flow status\` to check system health
 - Monitor with \`./claude-flow monitor\` for real-time updates
 - Verbose output available with \`--verbose\` flag on most commands
+
+## 🌐 Flow Nexus Cloud Platform
+
+Flow Nexus extends Claude Flow with cloud-powered features:
+
+### Quick Start
+1. **Register**: \`mcp__flow-nexus__user_register\` with email/password
+2. **Login**: \`mcp__flow-nexus__user_login\` to access features
+3. **Check Balance**: \`mcp__flow-nexus__check_balance\` for credits
+
+### Key Capabilities
+
+**🤖 AI Swarms**
+- Deploy multi-agent swarms in cloud sandboxes
+- Pre-built templates for common architectures
+- Auto-scaling and load balancing
+
+**📦 E2B Sandboxes**
+- \`mcp__flow-nexus__sandbox_create\` - Isolated execution environments
+- Support for Node.js, Python, React, Next.js
+- Real-time code execution with environment variables
+
+**⚡ Workflows**
+- \`mcp__flow-nexus__workflow_create\` - Event-driven automation
+- Parallel task processing with message queues
+- Reusable workflow templates
+
+**🎯 Challenges & Learning**
+- \`mcp__flow-nexus__challenges_list\` - Coding challenges
+- Earn rUv credits by completing tasks
+- Global leaderboard and achievements
+
+**🧠 Neural Networks**
+- \`mcp__flow-nexus__neural_train\` - Train custom models
+- Distributed training across sandboxes
+- Pre-built templates for ML tasks
+
+**💰 Credits & Billing**
+- Pay-as-you-go with rUv credits
+- Auto-refill configuration available
+- Free tier for getting started
+
+### Example: Deploy a Swarm
+\`\`\`javascript
+// Login and deploy
+mcp__flow-nexus__user_login { email: "user@example.com", password: "***" }
+mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }
+mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }
+\`\`\`
+
+Learn more: https://github.com/ruvnet/claude-flow#flow-nexus
 `;
 }
 
@@ -466,6 +568,57 @@ This SPARC-enabled project follows a systematic development approach:
 - Claude Code slash commands provide quick access to SPARC modes
 
 For more information about SPARC methodology, see: https://github.com/ruvnet/claude-code-flow/docs/sparc.md
+
+## 🌐 Flow Nexus Cloud Platform
+
+Flow Nexus extends Claude Flow with cloud-powered features:
+
+### Quick Start
+1. **Register**: \`mcp__flow-nexus__user_register\` with email/password
+2. **Login**: \`mcp__flow-nexus__user_login\` to access features
+3. **Check Balance**: \`mcp__flow-nexus__check_balance\` for credits
+
+### Key Capabilities
+
+**🤖 AI Swarms**
+- Deploy multi-agent swarms in cloud sandboxes
+- Pre-built templates for common architectures
+- Auto-scaling and load balancing
+
+**📦 E2B Sandboxes**
+- \`mcp__flow-nexus__sandbox_create\` - Isolated execution environments
+- Support for Node.js, Python, React, Next.js
+- Real-time code execution with environment variables
+
+**⚡ Workflows**
+- \`mcp__flow-nexus__workflow_create\` - Event-driven automation
+- Parallel task processing with message queues
+- Reusable workflow templates
+
+**🎯 Challenges & Learning**
+- \`mcp__flow-nexus__challenges_list\` - Coding challenges
+- Earn rUv credits by completing tasks
+- Global leaderboard and achievements
+
+**🧠 Neural Networks**
+- \`mcp__flow-nexus__neural_train\` - Train custom models
+- Distributed training across sandboxes
+- Pre-built templates for ML tasks
+
+**💰 Credits & Billing**
+- Pay-as-you-go with rUv credits
+- Auto-refill configuration available
+- Free tier for getting started
+
+### Example: Deploy a Swarm
+\`\`\`javascript
+// Login and deploy
+mcp__flow-nexus__user_login { email: "user@example.com", password: "***" }
+mcp__flow-nexus__swarm_init { topology: "mesh", maxAgents: 5 }
+mcp__flow-nexus__sandbox_create { template: "node", name: "api-dev" }
+\`\`\`
+
+Learn more: https://github.com/ruvnet/claude-flow#flow-nexus
 `;
 }
 
@@ -614,8 +767,10 @@ This project uses SPARC (Specification, Pseudocode, Architecture, Refinement, Co
 ## 🚀 Quick Setup
 
 \`\`\`bash
-# Add Claude Flow MCP server
+# Add MCP servers (Claude Flow required, others optional)
 claude mcp add claude-flow npx claude-flow@alpha mcp start
+claude mcp add ruv-swarm npx ruv-swarm mcp start  # Optional: Enhanced coordination
+claude mcp add flow-nexus npx flow-nexus@latest mcp start  # Optional: Cloud features
 \`\`\`
 
 ## MCP Tool Categories
@@ -635,6 +790,23 @@ claude mcp add claude-flow npx claude-flow@alpha mcp start
 ### System
 \`benchmark_run\`, \`features_detect\`, \`swarm_monitor\`
 
+### Flow-Nexus MCP Tools (Optional Advanced Features)
+Flow-Nexus extends MCP capabilities with 70+ cloud-based orchestration tools:
+
+**Key MCP Tool Categories:**
+- **Swarm & Agents**: \`swarm_init\`, \`swarm_scale\`, \`agent_spawn\`, \`task_orchestrate\`
+- **Sandboxes**: \`sandbox_create\`, \`sandbox_execute\`, \`sandbox_upload\` (cloud execution)
+- **Templates**: \`template_list\`, \`template_deploy\` (pre-built project templates)
+- **Neural AI**: \`neural_train\`, \`neural_patterns\`, \`seraphina_chat\` (AI assistant)
+- **GitHub**: \`github_repo_analyze\`, \`github_pr_manage\` (repository management)
+- **Real-time**: \`execution_stream_subscribe\`, \`realtime_subscribe\` (live monitoring)
+- **Storage**: \`storage_upload\`, \`storage_list\` (cloud file management)
+
+**Authentication Required:**
+- Register: \`mcp__flow-nexus__user_register\` or \`npx flow-nexus@latest register\`
+- Login: \`mcp__flow-nexus__user_login\` or \`npx flow-nexus@latest login\`
+- Access 70+ specialized MCP tools for advanced orchestration
+
 ## 🚀 Agent Execution Flow with Claude Code
 
 ### The Correct Pattern:
@@ -792,6 +964,7 @@ Message 4: Write "file.js"
 
 - Documentation: https://github.com/ruvnet/claude-flow
 - Issues: https://github.com/ruvnet/claude-flow/issues
+- Flow-Nexus Platform: https://flow-nexus.ruv.io (registration required for cloud features)
 
 ---
 
@@ -805,3 +978,124 @@ NEVER proactively create documentation files (*.md) or README files. Only create
 Never save working files, text/mds and tests to the root folder.
 `;
 }
+
+export function createFlowNexusClaudeMd() {
+  return `# Claude Code Configuration - Flow Nexus Integration
+
+## 🌐 Flow Nexus Cloud Platform
+
+Flow Nexus extends Claude Flow with cloud-powered features for AI development and deployment.
+
+### Quick Start
+1. **Register**: Use \`mcp__flow-nexus__user_register\` with email/password
+2. **Login**: Use \`mcp__flow-nexus__user_login\` to access features
+3. **Check Balance**: Use \`mcp__flow-nexus__check_balance\` for credits
+
+### 🚀 Key Capabilities
+
+**🤖 AI Swarms**
+- Deploy multi-agent swarms in cloud sandboxes
+- Pre-built templates for common architectures
+- Auto-scaling and load balancing
+
+**📦 E2B Sandboxes**
+- \`mcp__flow-nexus__sandbox_create\` - Isolated execution environments
+- Support for Node.js, Python, React, Next.js
+- Real-time code execution with environment variables
+
+**⚡ Workflows**
+- \`mcp__flow-nexus__workflow_create\` - Event-driven automation
+- Parallel task processing with message queues
+- Reusable workflow templates
+
+**🎯 Challenges & Learning**
+- \`mcp__flow-nexus__challenges_list\` - Coding challenges
+- Earn rUv credits by completing tasks
+- Global leaderboard and achievements
+
+**🧠 Neural Networks**
+- \`mcp__flow-nexus__neural_train\` - Train custom models
+- Distributed training across sandboxes
+- Pre-built templates for ML tasks
+
+**💰 Credits & Billing**
+- Pay-as-you-go with rUv credits
+- Auto-refill configuration available
+- Free tier for getting started
+
+### 🤖 Flow Nexus Agents
+
+Specialized agents for Flow Nexus operations available in \`.claude/agents/flow-nexus/\`:
+
+- **flow-nexus-auth**: Authentication and user management
+- **flow-nexus-sandbox**: E2B sandbox deployment and management  
+- **flow-nexus-swarm**: AI swarm orchestration and scaling
+- **flow-nexus-workflow**: Event-driven workflow automation
+- **flow-nexus-neural**: Neural network training and deployment
+- **flow-nexus-challenges**: Coding challenges and gamification
+- **flow-nexus-app-store**: Application marketplace management
+- **flow-nexus-payments**: Credit management and billing
+- **flow-nexus-user-tools**: User management and system utilities
+
+### 📁 Flow Nexus Commands
+
+Detailed Flow Nexus command documentation available in \`.claude/commands/flow-nexus/\`:
+
+- \`login-registration.md\` - Authentication workflows
+- \`sandbox.md\` - E2B sandbox management
+- \`swarm.md\` - AI swarm deployment
+- \`workflow.md\` - Automation workflows
+- \`neural-network.md\` - ML model training
+- \`challenges.md\` - Coding challenges
+- \`app-store.md\` - App marketplace
+- \`payments.md\` - Credit and billing
+- \`user-tools.md\` - User utilities
+
+### 💡 Example: Deploy a Swarm
+\`\`\`javascript
+// 1. Login to Flow Nexus
+mcp__flow-nexus__user_login({ 
+  email: "user@example.com", 
+  password: "password" 
+})
+
+// 2. Initialize swarm
+mcp__flow-nexus__swarm_init({ 
+  topology: "mesh", 
+  maxAgents: 5 
+})
+
+// 3. Create sandbox
+mcp__flow-nexus__sandbox_create({ 
+  template: "node", 
+  name: "api-dev" 
+})
+
+// 4. Orchestrate task
+mcp__flow-nexus__task_orchestrate({
+  task: "Build REST API with authentication",
+  strategy: "parallel"
+})
+\`\`\`
+
+### 🔗 Integration with Claude Code
+
+Flow Nexus seamlessly integrates with Claude Code through MCP (Model Context Protocol):
+
+1. **Add MCP Server**: \`claude mcp add flow-nexus npx flow-nexus@latest mcp start\`
+2. **Use in Claude Code**: Access all Flow Nexus tools through MCP interface
+3. **Agent Coordination**: Use Flow Nexus agents for specialized cloud operations
+4. **Command Reference**: Use slash commands for quick Flow Nexus operations
+
+### 📚 Learn More
+
+- Documentation: https://github.com/ruvnet/claude-flow#flow-nexus
+- MCP Integration: Use \`mcp__flow-nexus__*\` tools in Claude Code
+- Agent Usage: Type \`/\` in Claude Code to see Flow Nexus commands
+- Community: Join discussions and share templates
+
+---
+
+**Ready to build with Flow Nexus? Start with authentication and explore the cloud-powered AI development platform!**
+`;
+}

package/src/core/version.js

@@ -24,7 +24,7 @@ try {
 } catch (error) {
   // Fallback version if package.json can't be read
   console.warn('Warning: Could not read version from package.json, using fallback');
-  VERSION = '2.0.0-alpha.99';
+  VERSION = '2.0.0-alpha.101';
   BUILD_DATE = new Date().toISOString().split('T')[0];
 }