claude-flow 2.0.0-alpha.2 → 2.0.0-alpha.21

package/src/cli/simple-commands/init/templates/enhanced-templates.js

@@ -10,19 +10,13 @@ const loadTemplate = (filename) => {
   try {
     return readFileSync(join(__dirname, filename), 'utf8');
   } catch (error) {
-    // Silently return null for missing templates - they'll use fallback content
+    // Silently fall back to hardcoded templates if files not found
+    // This handles npm packaging scenarios where template files may not be included
     return null;
   }
 };
 
 export function createEnhancedClaudeMd() {
-  // First try to load the claude-flow specific template
-  const specificTemplate = loadTemplate('CLAUDE-FLOW-SPECIFIC.md');
-  if (specificTemplate) {
-    return specificTemplate;
-  }
-  
-  // Fallback to generic template if specific not found
   const template = loadTemplate('CLAUDE.md');
   if (!template) {
     // Fallback to hardcoded if template file not found
@@ -40,6 +34,14 @@ export function createEnhancedSettingsJson() {
 }
 
 export function createWrapperScript(type = 'unix') {
+  // For unix, use the universal wrapper that works in both CommonJS and ES modules
+  if (type === 'unix') {
+    const universalTemplate = loadTemplate('claude-flow-universal');
+    if (universalTemplate) {
+      return universalTemplate;
+    }
+  }
+  
   const filename = type === 'unix' ? 'claude-flow' : 
                    type === 'windows' ? 'claude-flow.bat' : 
                    'claude-flow.ps1';
@@ -54,6 +56,7 @@ export function createWrapperScript(type = 'unix') {
 export function createCommandDoc(category, command) {
   const template = loadTemplate(`commands/${category}/${command}.md`);
   if (!template) {
+    // Silently fall back to generated documentation
     return createCommandDocFallback(category, command);
   }
   return template;
@@ -442,7 +445,7 @@ Hook executed before task execution.
 
 ## Usage
 \`\`\`bash
-npx claude-flow hooks pre-task [options]
+npx claude-flow hook pre-task [options]
 \`\`\`
 
 ## Options
@@ -453,13 +456,13 @@ npx claude-flow hooks pre-task [options]
 ## Examples
 \`\`\`bash
 # Basic pre-task hook
-npx claude-flow hooks pre-task --description "Building API endpoints"
+npx claude-flow hook pre-task --description "Building API endpoints"
 
 # With auto-spawn
-npx claude-flow hooks pre-task --description "Complex refactoring" --auto-spawn-agents
+npx claude-flow hook pre-task --description "Complex refactoring" --auto-spawn-agents
 
 # Load context
-npx claude-flow hooks pre-task --description "Continue feature" --load-context
+npx claude-flow hook pre-task --description "Continue feature" --load-context
 \`\`\`
 `,
       'post-task': `# post-task
@@ -468,7 +471,7 @@ Hook executed after task completion.
 
 ## Usage
 \`\`\`bash
-npx claude-flow hooks post-task [options]
+npx claude-flow hook post-task [options]
 \`\`\`
 
 ## Options
@@ -479,13 +482,13 @@ npx claude-flow hooks post-task [options]
 ## Examples
 \`\`\`bash
 # Basic post-task
-npx claude-flow hooks post-task --task-id task-123
+npx claude-flow hook post-task --task-id task-123
 
 # With performance analysis
-npx claude-flow hooks post-task --task-id task-123 --analyze-performance
+npx claude-flow hook post-task --task-id task-123 --analyze-performance
 
 # Update memory
-npx claude-flow hooks post-task --task-id task-123 --update-memory
+npx claude-flow hook post-task --task-id task-123 --update-memory
 \`\`\`
 `,
       'pre-edit': `# pre-edit
@@ -494,7 +497,7 @@ Hook executed before file edits.
 
 ## Usage
 \`\`\`bash
-npx claude-flow hooks pre-edit [options]
+npx claude-flow hook pre-edit [options]
 \`\`\`
 
 ## Options
@@ -505,13 +508,13 @@ npx claude-flow hooks pre-edit [options]
 ## Examples
 \`\`\`bash
 # Pre-edit hook
-npx claude-flow hooks pre-edit --file src/api.js
+npx claude-flow hook pre-edit --file src/api.js
 
 # With validation
-npx claude-flow hooks pre-edit --file src/api.js --validate-syntax
+npx claude-flow hook pre-edit --file src/api.js --validate-syntax
 
 # Create backup
-npx claude-flow hooks pre-edit --file src/api.js --backup
+npx claude-flow hook pre-edit --file src/api.js --backup
 \`\`\`
 `,
       'post-edit': `# post-edit
@@ -520,7 +523,7 @@ Hook executed after file edits.
 
 ## Usage
 \`\`\`bash
-npx claude-flow hooks post-edit [options]
+npx claude-flow hook post-edit [options]
 \`\`\`
 
 ## Options
@@ -531,13 +534,13 @@ npx claude-flow hooks post-edit [options]
 ## Examples
 \`\`\`bash
 # Post-edit hook
-npx claude-flow hooks post-edit --file src/api.js
+npx claude-flow hook post-edit --file src/api.js
 
 # Store in memory
-npx claude-flow hooks post-edit --file src/api.js --memory-key "api-changes"
+npx claude-flow hook post-edit --file src/api.js --memory-key "api-changes"
 
 # With formatting
-npx claude-flow hooks post-edit --file src/api.js --format
+npx claude-flow hook post-edit --file src/api.js --format
 \`\`\`
 `,
       'session-end': `# session-end
@@ -546,7 +549,7 @@ Hook executed at session end.
 
 ## Usage
 \`\`\`bash
-npx claude-flow hooks session-end [options]
+npx claude-flow hook session-end [options]
 \`\`\`
 
 ## Options
@@ -557,13 +560,13 @@ npx claude-flow hooks session-end [options]
 ## Examples
 \`\`\`bash
 # End session
-npx claude-flow hooks session-end
+npx claude-flow hook session-end
 
 # Export metrics
-npx claude-flow hooks session-end --export-metrics
+npx claude-flow hook session-end --export-metrics
 
 # Full closure
-npx claude-flow hooks session-end --export-metrics --generate-summary --persist-state
+npx claude-flow hook session-end --export-metrics --generate-summary --persist-state
 \`\`\`
 `
     },
@@ -1065,29 +1068,85 @@ echo "  - npx claude-flow issue triage"
 // Wrapper script fallbacks
 function createWrapperScriptFallback(type) {
   if (type === 'unix') {
-    return `#!/bin/bash
-# Claude Flow wrapper script for Unix-like systems
+    // Return the universal ES module compatible wrapper
+    return `#!/usr/bin/env node
+
+/**
+ * Claude Flow CLI - Universal Wrapper
+ * Works in both CommonJS and ES Module projects
+ */
+
+// Use dynamic import to work in both CommonJS and ES modules
+(async () => {
+  const { spawn } = await import('child_process');
+  const { resolve } = await import('path');
+  const { fileURLToPath } = await import('url');
+  
+  try {
+    // Try to use import.meta.url (ES modules)
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = resolve(__filename, '..');
+  } catch {
+    // Fallback for CommonJS
+  }
 
-# Find the directory where this script is located
-SCRIPT_DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
+  // Try multiple strategies to find claude-flow
+  const strategies = [
+    // 1. Local node_modules
+    async () => {
+      try {
+        const localPath = resolve(process.cwd(), 'node_modules/.bin/claude-flow');
+        const { existsSync } = await import('fs');
+        if (existsSync(localPath)) {
+          return spawn(localPath, process.argv.slice(2), { stdio: 'inherit' });
+        }
+      } catch {}
+    },
+    
+    // 2. Parent node_modules (monorepo)
+    async () => {
+      try {
+        const parentPath = resolve(process.cwd(), '../node_modules/.bin/claude-flow');
+        const { existsSync } = await import('fs');
+        if (existsSync(parentPath)) {
+          return spawn(parentPath, process.argv.slice(2), { stdio: 'inherit' });
+        }
+      } catch {}
+    },
+    
+    // 3. Global installation
+    async () => {
+      try {
+        return spawn('claude-flow', process.argv.slice(2), { stdio: 'inherit', shell: true });
+      } catch {}
+    },
+    
+    // 4. NPX fallback
+    async () => {
+      return spawn('npx', ['claude-flow@alpha', ...process.argv.slice(2)], { stdio: 'inherit' });
+    }
+  ];
 
-# Check if we're in a local development environment
-if [ -f "$SCRIPT_DIR/package.json" ] && [ -d "$SCRIPT_DIR/node_modules" ]; then
-    # Local development mode
-    if [ -f "$SCRIPT_DIR/src/cli/simple-cli.js" ]; then
-        # Use the simple CLI
-        exec node "$SCRIPT_DIR/src/cli/simple-cli.js" "$@"
-    elif [ -f "$SCRIPT_DIR/dist/cli.js" ]; then
-        # Use compiled version
-        exec node "$SCRIPT_DIR/dist/cli.js" "$@"
-    else
-        echo "Error: Could not find Claude Flow CLI files"
-        exit 1
-    fi
-else
-    # Production mode - use npx
-    exec npx claude-flow "$@"
-fi`;
+  // Try each strategy
+  for (const strategy of strategies) {
+    try {
+      const child = await strategy();
+      if (child) {
+        child.on('exit', (code) => process.exit(code || 0));
+        child.on('error', (err) => {
+          if (err.code !== 'ENOENT') {
+            console.error('Error:', err);
+            process.exit(1);
+          }
+        });
+        return;
+      }
+    } catch {}
+  }
+  
+  console.error('Could not find claude-flow. Please install it with: npm install claude-flow');
+  process.exit(1);
+})();`;
   } else if (type === 'windows') {
     return `@echo off
 rem Claude Flow wrapper script for Windows
@@ -1104,8 +1163,8 @@ if exist "%~dp0package.json" (
         exit /b 1
     )
 ) else (
-    rem Production mode - use npx
-    npx claude-flow %*
+    rem Production mode - use npx alpha
+    npx claude-flow@alpha %*
 )`;
   } else if (type === 'powershell') {
     return `# Claude Flow wrapper script for PowerShell
@@ -1123,8 +1182,8 @@ if (Test-Path "$scriptPath\\package.json") {
         exit 1
     }
 } else {
-    # Production mode - use npx
-    & npx claude-flow $args
+    # Production mode - use npx alpha
+    & npx claude-flow@alpha $args
 }`;
   }
   return '';
@@ -1132,73 +1191,42 @@ if (Test-Path "$scriptPath\\package.json") {
 
 // Fallback functions for when templates can't be loaded
 function createEnhancedClaudeMdFallback() {
-  // Try to read from the claude-flow specific template first
+  // Read from the actual template file we created
   try {
-    return readFileSync(join(__dirname, 'CLAUDE-FLOW-SPECIFIC.md'), 'utf8');
+    return readFileSync(join(__dirname, 'CLAUDE.md'), 'utf8');
   } catch (error) {
-    // Try the generic template next
-    try {
-      return readFileSync(join(__dirname, 'CLAUDE.md'), 'utf8');
-    } catch (error) {
-      // If both fail, return a minimal claude-flow focused version
-      return `# Claude Code Configuration
-
-## Build Commands
-- \`npm run build\`: Build the project using Deno compile
-- \`npm run test\`: Run the full test suite
-- \`npm run lint\`: Run ESLint and format checks
-- \`npm run typecheck\`: Run TypeScript type checking
-- \`npx claude-flow start\`: Start the orchestration system
-- \`npx claude-flow --help\`: Show all available commands
-
-## Code Style Preferences
-- Use ES modules (import/export) syntax, not CommonJS (require)
-- Destructure imports when possible
-- Use TypeScript for all new code
-- Follow existing naming conventions
-- Add JSDoc comments for public APIs
-- Use async/await instead of Promise chains
-
-## Project Architecture
-This is a Claude-Flow AI agent orchestration system with:
-- **CLI Interface**: Command-line tools for managing the system
-- **Orchestrator**: Core engine for coordinating agents and tasks
-- **Memory System**: Persistent storage and retrieval
-- **MCP Integration**: Model Context Protocol server for Claude
-
-## Claude Flow CLI Commands
-
-### Swarm Management
-- \`npx claude-flow swarm "task"\`: Create and execute an agent swarm
-- \`npx claude-flow swarm --mode distributed\`: Use distributed execution
-- \`npx claude-flow swarm --max-agents 10\`: Limit agent count
-
-### Agent Operations
-- \`npx claude-flow agent list\`: List all active agents
-- \`npx claude-flow agent spawn <type>\`: Spawn a specific agent type
-- \`npx claude-flow agent metrics <id>\`: View agent performance metrics
-
-### Memory Management
-- \`npx claude-flow memory store <key> <value>\`: Store data in memory
-- \`npx claude-flow memory get <key>\`: Retrieve data from memory
-- \`npx claude-flow memory list\`: List all memory keys
-
-### MCP Server
-- \`npx claude-flow mcp start\`: Start MCP server
-- \`npx claude-flow mcp status\`: Check MCP server status
-- \`npx claude-flow mcp stop\`: Stop MCP server
+    // If that fails, return a minimal version
+    return `# Claude Code Configuration for Claude Flow
+
+## 🚀 IMPORTANT: Claude Flow AI-Driven Development
+
+### Claude Code Handles:
+- ✅ **ALL file operations** (Read, Write, Edit, MultiEdit)
+- ✅ **ALL code generation** and development tasks
+- ✅ **ALL bash commands** and system operations
+- ✅ **ALL actual implementation** work
+- ✅ **Project navigation** and code analysis
+
+### Claude Flow MCP Tools Handle:
+- 🧠 **Coordination only** - Orchestrating Claude Code's actions
+- 💾 **Memory management** - Persistent state across sessions
+- 🤖 **Neural features** - Cognitive patterns and learning
+- 📊 **Performance tracking** - Monitoring and metrics
+- 🐝 **Swarm orchestration** - Multi-agent coordination
+- 🔗 **GitHub integration** - Advanced repository management
+
+### ⚠️ Key Principle:
+**MCP tools DO NOT create content or write code.** They coordinate and enhance Claude Code's native capabilities.
 
 ## Quick Start
 
 1. Add MCP server: \`claude mcp add claude-flow npx claude-flow mcp start\`
-2. Use MCP tools in Claude Code:
-   - \`mcp__claude-flow__swarm_init\`: Initialize swarm
-   - \`mcp__claude-flow__agent_spawn\`: Create agents
-   - \`mcp__claude-flow__task_orchestrate\`: Orchestrate tasks
+2. Initialize swarm: \`mcp__claude-flow__swarm_init { topology: "hierarchical" }\`
+3. Spawn agents: \`mcp__claude-flow__agent_spawn { type: "coder" }\`
+4. Orchestrate: \`mcp__claude-flow__task_orchestrate { task: "Build feature" }\`
 
-Remember: Claude Flow coordinates, Claude Code creates!
+See full documentation in \`.claude/commands/\`
 `;
-    }
   }
 }
 
@@ -1239,116 +1267,36 @@ function createEnhancedSettingsJsonFallback() {
       ]
     },
     hooks: {
-      PreToolUse: [
-        {
-          matcher: "Edit|MultiEdit",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks pre-edit --file \"${CLAUDE_FLOW_FILE}\" --validate-syntax --auto-assign-agents",
-              blocking: false
-            }
-          ]
-        },
-        {
-          matcher: "Write",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks pre-write --file \"${CLAUDE_FLOW_FILE}\" --prepare-directory",
-              blocking: true
-            }
-          ]
-        },
-        {
-          matcher: "Bash",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks pre-command --command \"${CLAUDE_FLOW_COMMAND}\" --validate-safety",
-              blocking: true
-            }
-          ]
-        },
-        {
-          matcher: "Task",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks pre-task --description \"${CLAUDE_FLOW_TASK}\" --auto-spawn-agents --optimize-topology",
-              blocking: false
-            }
-          ]
-        }
-      ],
-      PostToolUse: [
-        {
-          matcher: "Edit|MultiEdit|Write",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks post-edit --file \"${CLAUDE_FLOW_FILE}\" --format-code --update-memory --train-neural"
-            }
-          ]
-        },
-        {
-          matcher: "Bash",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks post-command --command \"${CLAUDE_FLOW_COMMAND}\" --track-metrics --store-results"
-            }
-          ]
-        },
-        {
-          matcher: "Task",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks post-task --task-id \"${CLAUDE_FLOW_TASK_ID}\" --analyze-performance --update-telemetry"
-            }
-          ]
-        },
-        {
-          matcher: "Read|Grep|Glob",
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks post-search --pattern \"${CLAUDE_FLOW_PATTERN}\" --cache-results --optimize-future"
-            }
-          ]
-        }
-      ],
-      Notification: [
-        {
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks notification --message \"${CLAUDE_FLOW_MESSAGE}\" --update-status --broadcast-agents"
-            }
-          ]
-        }
-      ],
-      Stop: [
-        {
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks session-end --generate-summary --persist-state --export-metrics --cleanup-temp"
-            }
-          ]
-        }
-      ],
-      SubagentStop: [
-        {
-          hooks: [
-            {
-              type: "command",
-              command: "npx claude-flow hooks agent-stop --agent-id \"${CLAUDE_FLOW_AGENT_ID}\" --save-knowledge --update-swarm-status"
-            }
-          ]
-        }
-      ]
+      preEditHook: {
+        command: "npx",
+        args: ["claude-flow", "hook", "pre-edit", "--file", "${file}", "--auto-assign-agents", "true", "--load-context", "true"],
+        alwaysRun: false,
+        outputFormat: "json"
+      },
+      postEditHook: {
+        command: "npx",
+        args: ["claude-flow", "hook", "post-edit", "--file", "${file}", "--format", "true", "--update-memory", "true", "--train-neural", "true"],
+        alwaysRun: true,
+        outputFormat: "json"
+      },
+      preCommandHook: {
+        command: "npx",
+        args: ["claude-flow", "hook", "pre-command", "--command", "${command}", "--validate-safety", "true", "--prepare-resources", "true"],
+        alwaysRun: false,
+        outputFormat: "json"
+      },
+      postCommandHook: {
+        command: "npx",
+        args: ["claude-flow", "hook", "post-command", "--command", "${command}", "--track-metrics", "true", "--store-results", "true"],
+        alwaysRun: false,
+        outputFormat: "json"
+      },
+      sessionEndHook: {
+        command: "npx",
+        args: ["claude-flow", "hook", "session-end", "--generate-summary", "true", "--persist-state", "true", "--export-metrics", "true"],
+        alwaysRun: true,
+        outputFormat: "json"
+      }
     },
     mcpServers: {
       "claude-flow": {