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

package/src/cli/simple-commands/init/templates/claude-flow-universal

@@ -0,0 +1,78 @@
+#!/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
+  }
+
+  // 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' });
+    }
+  ];
+
+  // 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);
+})();

package/src/cli/simple-commands/init/templates/commands/hooks/notification.md

@@ -0,0 +1,102 @@
+# hook notification
+
+Send coordination notifications and track important decisions.
+
+## Usage
+
+```bash
+npx claude-flow hook notification [options]
+```
+
+## Options
+
+- `--message, -m <text>` - Notification message
+- `--level, -l <level>` - Message level (info/warning/error/success)
+- `--telemetry` - Include in telemetry (default: true)
+- `--broadcast` - Broadcast to all agents
+- `--memory-store` - Store in memory
+
+## Examples
+
+### Basic notification
+```bash
+npx claude-flow hook notification --message "Completed authentication module"
+```
+
+### Warning notification
+```bash
+npx claude-flow hook notification -m "Potential security issue found" -l warning
+```
+
+### Broadcast to swarm
+```bash
+npx claude-flow hook notification -m "API refactoring started" --broadcast
+```
+
+### Decision tracking
+```bash
+npx claude-flow hook notification -m "Chose JWT over sessions for auth" --memory-store
+```
+
+## Features
+
+### Message Levels
+- **info** - General information
+- **warning** - Important notices
+- **error** - Error conditions
+- **success** - Completion notices
+
+### Telemetry Integration
+- Tracks key events
+- Records decisions
+- Monitors progress
+- Enables analytics
+
+### Agent Broadcasting
+- Notifies all agents
+- Ensures coordination
+- Shares context
+- Prevents conflicts
+
+### Memory Storage
+- Persists decisions
+- Creates audit trail
+- Enables learning
+- Maintains history
+
+## Integration
+
+This hook is used by agents for:
+- Sharing progress updates
+- Recording decisions
+- Warning about issues
+- Coordinating actions
+
+Manual usage in agents:
+```bash
+# For coordination
+npx claude-flow hook notification --message "Starting database migration" --broadcast --memory-store
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "message": "Completed authentication module",
+  "level": "success",
+  "timestamp": 1234567890,
+  "telemetryRecorded": true,
+  "broadcasted": false,
+  "memoryKey": "notifications/success/auth-complete",
+  "recipients": ["coordinator", "tester"],
+  "acknowledged": true
+}
+```
+
+## See Also
+
+- `agent list` - View active agents
+- `memory usage` - Memory storage
+- `swarm monitor` - Real-time monitoring
+- `telemetry` - Analytics tracking

package/src/cli/simple-commands/init/templates/commands/hooks/post-command.md

@@ -0,0 +1,105 @@
+# hook post-command
+
+Execute post-command processing including output analysis and state updates.
+
+## Usage
+
+```bash
+npx claude-flow hook post-command [options]
+```
+
+## Options
+
+- `--command, -c <cmd>` - Command that was executed
+- `--exit-code, -e <code>` - Command exit code
+- `--analyze-output` - Analyze command output (default: true)
+- `--update-cache` - Update command cache
+- `--track-metrics` - Track performance metrics
+
+## Examples
+
+### Basic post-command hook
+```bash
+npx claude-flow hook post-command --command "npm test" --exit-code 0
+```
+
+### With output analysis
+```bash
+npx claude-flow hook post-command -c "git status" -e 0 --analyze-output
+```
+
+### Cache update
+```bash
+npx claude-flow hook post-command -c "npm list" -e 0 --update-cache
+```
+
+### Performance tracking
+```bash
+npx claude-flow hook post-command -c "build.sh" -e 0 --track-metrics
+```
+
+## Features
+
+### Output Analysis
+- Parses command output
+- Extracts key information
+- Identifies errors/warnings
+- Summarizes results
+
+### Cache Management
+- Stores command results
+- Enables fast re-execution
+- Tracks output changes
+- Reduces redundant runs
+
+### Metric Tracking
+- Records execution time
+- Monitors resource usage
+- Tracks success rates
+- Identifies bottlenecks
+
+### State Updates
+- Updates project state
+- Refreshes file indexes
+- Syncs dependencies
+- Maintains consistency
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- After Bash tool execution
+- Following shell commands
+- Post build/test operations
+- After system changes
+
+Manual usage in agents:
+```bash
+# After running commands
+npx claude-flow hook post-command --command "npm build" --exit-code 0 --analyze-output
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "command": "npm test",
+  "exitCode": 0,
+  "duration": 45230,
+  "outputSummary": "All 42 tests passed",
+  "cached": true,
+  "metrics": {
+    "cpuUsage": "45%",
+    "memoryPeak": "256MB"
+  },
+  "stateChanges": ["test-results.json updated"],
+  "warnings": []
+}
+```
+
+## See Also
+
+- `hook pre-command` - Pre-command validation
+- `Bash` - Command execution tool
+- `cache manage` - Cache operations
+- `metrics collect` - Performance data

package/src/cli/simple-commands/init/templates/commands/hooks/post-edit.md

@@ -0,0 +1,106 @@
+# hook post-edit
+
+Execute post-edit processing including formatting, validation, and memory updates.
+
+## Usage
+
+```bash
+npx claude-flow hook post-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path that was edited
+- `--auto-format` - Automatically format code (default: true)
+- `--memory-key, -m <key>` - Store edit context in memory
+- `--train-patterns` - Train neural patterns from edit
+- `--validate-output` - Validate edited file
+
+## Examples
+
+### Basic post-edit hook
+```bash
+npx claude-flow hook post-edit --file "src/components/Button.jsx"
+```
+
+### With memory storage
+```bash
+npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
+```
+
+### Format and validate
+```bash
+npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
+```
+
+### Neural training
+```bash
+npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
+```
+
+## Features
+
+### Auto Formatting
+- Language-specific formatters
+- Prettier for JS/TS/JSON
+- Black for Python
+- gofmt for Go
+- Maintains consistency
+
+### Memory Storage
+- Saves edit context
+- Records decisions made
+- Tracks implementation details
+- Enables knowledge sharing
+
+### Pattern Training
+- Learns from successful edits
+- Improves future suggestions
+- Adapts to coding style
+- Enhances coordination
+
+### Output Validation
+- Checks syntax correctness
+- Runs linting rules
+- Validates formatting
+- Ensures quality
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- After Edit tool completes
+- Following MultiEdit operations
+- During file saves
+- After code generation
+
+Manual usage in agents:
+```bash
+# After editing files
+npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "file": "src/components/Button.jsx",
+  "formatted": true,
+  "formatterUsed": "prettier",
+  "lintPassed": true,
+  "memorySaved": "component/button-refactor",
+  "patternsTrained": 3,
+  "warnings": [],
+  "stats": {
+    "linesChanged": 45,
+    "charactersAdded": 234
+  }
+}
+```
+
+## See Also
+
+- `hook pre-edit` - Pre-edit preparation
+- `Edit` - File editing tool
+- `memory usage` - Memory management
+- `neural train` - Pattern training

package/src/cli/simple-commands/init/templates/commands/hooks/post-task.md

@@ -0,0 +1,101 @@
+# hook post-task
+
+Execute post-task cleanup, performance analysis, and memory storage.
+
+## Usage
+
+```bash
+npx claude-flow hook post-task [options]
+```
+
+## Options
+
+- `--task-id, -t <id>` - Task identifier for tracking
+- `--analyze-performance` - Generate performance metrics (default: true)
+- `--store-decisions` - Save task decisions to memory
+- `--export-learnings` - Export neural pattern learnings
+- `--generate-report` - Create task completion report
+
+## Examples
+
+### Basic post-task hook
+```bash
+npx claude-flow hook post-task --task-id "auth-implementation"
+```
+
+### With full analysis
+```bash
+npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
+```
+
+### Memory storage
+```bash
+npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
+```
+
+### Quick cleanup
+```bash
+npx claude-flow hook post-task -t "minor-update" --analyze-performance false
+```
+
+## Features
+
+### Performance Analysis
+- Measures execution time
+- Tracks token usage
+- Identifies bottlenecks
+- Suggests optimizations
+
+### Decision Storage
+- Saves key decisions made
+- Records implementation choices
+- Stores error resolutions
+- Maintains knowledge base
+
+### Neural Learning
+- Exports successful patterns
+- Updates coordination models
+- Improves future performance
+- Trains on task outcomes
+
+### Report Generation
+- Creates completion summary
+- Documents changes made
+- Lists files modified
+- Tracks metrics achieved
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Completing a task
+- Switching to a new task
+- Ending a work session
+- After major milestones
+
+Manual usage in agents:
+```bash
+# In agent coordination
+npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "taskId": "auth-implementation",
+  "duration": 1800000,
+  "tokensUsed": 45000,
+  "filesModified": 12,
+  "performanceScore": 0.92,
+  "learningsExported": true,
+  "reportPath": "/reports/task-auth-implementation.md"
+}
+```
+
+## See Also
+
+- `hook pre-task` - Pre-task setup
+- `performance report` - Detailed metrics
+- `memory usage` - Memory management
+- `neural patterns` - Pattern analysis

package/src/cli/simple-commands/init/templates/commands/hooks/pre-command.md

@@ -0,0 +1,102 @@
+# hook pre-command
+
+Execute pre-command validations and safety checks before running shell commands.
+
+## Usage
+
+```bash
+npx claude-flow hook pre-command [options]
+```
+
+## Options
+
+- `--command, -c <cmd>` - Command to be executed
+- `--validate-safety` - Check command safety (default: true)
+- `--check-permissions` - Verify execution permissions
+- `--estimate-duration` - Estimate command runtime
+- `--dry-run` - Preview without executing
+
+## Examples
+
+### Basic pre-command hook
+```bash
+npx claude-flow hook pre-command --command "npm install express"
+```
+
+### Safety validation
+```bash
+npx claude-flow hook pre-command -c "rm -rf node_modules" --validate-safety
+```
+
+### Permission check
+```bash
+npx claude-flow hook pre-command -c "sudo apt update" --check-permissions
+```
+
+### Dry run preview
+```bash
+npx claude-flow hook pre-command -c "git push origin main" --dry-run
+```
+
+## Features
+
+### Safety Validation
+- Detects dangerous commands
+- Warns about destructive operations
+- Checks for sudo/admin usage
+- Validates command syntax
+
+### Permission Checking
+- Verifies execution rights
+- Checks directory access
+- Validates file permissions
+- Ensures proper context
+
+### Duration Estimation
+- Predicts execution time
+- Warns about long operations
+- Suggests timeouts
+- Tracks historical data
+
+### Dry Run Mode
+- Shows command effects
+- Lists files affected
+- Previews changes
+- No actual execution
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Using Bash tool
+- Running shell commands
+- Executing npm/pip/cargo commands
+- System operations
+
+Manual usage in agents:
+```bash
+# Before running commands
+npx claude-flow hook pre-command --command "your command here" --validate-safety
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "continue": true,
+  "command": "npm install express",
+  "safe": true,
+  "estimatedDuration": 15000,
+  "warnings": [],
+  "permissions": "user",
+  "affectedFiles": ["package.json", "package-lock.json"],
+  "dryRunOutput": "Would install 50 packages"
+}
+```
+
+## See Also
+
+- `hook post-command` - Post-command processing
+- `Bash` - Command execution tool
+- `terminal execute` - Terminal operations
+- `security scan` - Security validation

package/src/cli/simple-commands/init/templates/commands/hooks/pre-edit.md

@@ -0,0 +1,102 @@
+# hook pre-edit
+
+Execute pre-edit validations and agent assignment before file modifications.
+
+## Usage
+
+```bash
+npx claude-flow hook pre-edit [options]
+```
+
+## Options
+
+- `--file, -f <path>` - File path to be edited
+- `--auto-assign-agent` - Automatically assign best agent (default: true)
+- `--validate-syntax` - Pre-validate syntax before edit
+- `--check-conflicts` - Check for merge conflicts
+- `--backup-file` - Create backup before editing
+
+## Examples
+
+### Basic pre-edit hook
+```bash
+npx claude-flow hook pre-edit --file "src/auth/login.js"
+```
+
+### With validation
+```bash
+npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
+```
+
+### Manual agent assignment
+```bash
+npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
+```
+
+### Safe editing with backup
+```bash
+npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
+```
+
+## Features
+
+### Auto Agent Assignment
+- Analyzes file type and content
+- Assigns specialist agents
+- TypeScript → TypeScript expert
+- Database → Data specialist
+- Tests → QA engineer
+
+### Syntax Validation
+- Pre-checks syntax validity
+- Identifies potential errors
+- Suggests corrections
+- Prevents broken code
+
+### Conflict Detection
+- Checks for git conflicts
+- Identifies concurrent edits
+- Warns about stale files
+- Suggests merge strategies
+
+### File Backup
+- Creates safety backups
+- Enables quick rollback
+- Tracks edit history
+- Preserves originals
+
+## Integration
+
+This hook is automatically called by Claude Code when:
+- Using Edit or MultiEdit tools
+- Before file modifications
+- During refactoring operations
+- When updating critical files
+
+Manual usage in agents:
+```bash
+# Before editing files
+npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
+```
+
+## Output
+
+Returns JSON with:
+```json
+{
+  "continue": true,
+  "file": "src/auth/login.js",
+  "assignedAgent": "auth-specialist",
+  "syntaxValid": true,
+  "conflicts": false,
+  "backupPath": ".backups/login.js.bak",
+  "warnings": []
+}
+```
+
+## See Also
+
+- `hook post-edit` - Post-edit processing
+- `Edit` - File editing tool
+- `MultiEdit` - Multiple edits tool
+- `agent spawn` - Manual agent creation