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

package/.claude/commands/hooks-overview.md

@@ -1,245 +0,0 @@
-# Claude Flow Hooks Overview
-
-## What Are Hooks?
-
-Claude Flow hooks are automated commands that execute at specific points in Claude Code's lifecycle. They provide deterministic control over Claude Code's behavior, enabling automated workflows for validation, formatting, memory management, and performance optimization.
-
-## Quick Start
-
-Hooks are already configured in `.claude/settings.json`. To enable them:
-
-```bash
-# Enable hooks globally
-export CLAUDE_FLOW_HOOKS_ENABLED=true
-
-# Or update settings.json
-"env": {
-  "CLAUDE_FLOW_HOOKS_ENABLED": "true"
-}
-```
-
-## Available Hook Types
-
-### 1. PreToolUse Hooks
-Execute **before** Claude Code runs a tool:
-
-- **Edit/MultiEdit**: Validates syntax, assigns agents
-- **Write**: Creates directories, checks permissions
-- **Bash**: Validates command safety
-- **Task**: Optimizes topology, spawns agents
-
-### 2. PostToolUse Hooks
-Execute **after** tool completion:
-
-- **File Operations**: Formats code, updates memory
-- **Commands**: Tracks metrics, stores results
-- **Tasks**: Analyzes performance, updates telemetry
-- **Searches**: Caches results, optimizes patterns
-
-### 3. Notification Hooks
-Handle system notifications:
-- Broadcasts to agents
-- Updates swarm status
-- Logs important events
-
-### 4. Stop Hooks
-Execute when session ends:
-- Generates summary
-- Persists state
-- Exports metrics
-- Cleans up temp files
-
-### 5. SubagentStop Hooks
-Execute when agents complete:
-- Saves agent knowledge
-- Updates swarm status
-- Transfers learnings
-
-## Hook Configuration
-
-### Basic Structure
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Edit|MultiEdit",
-        "hooks": [{
-          "type": "command",
-          "command": "npx claude-flow hooks pre-edit --file \"${CLAUDE_FLOW_FILE}\"",
-          "blocking": false
-        }]
-      }
-    ]
-  }
-}
-```
-
-### Environment Variables
-- `${CLAUDE_FLOW_FILE}` - Current file path
-- `${CLAUDE_FLOW_COMMAND}` - Bash command being executed
-- `${CLAUDE_FLOW_TASK}` - Task description
-- `${CLAUDE_FLOW_TASK_ID}` - Unique task ID
-- `${CLAUDE_FLOW_PATTERN}` - Search pattern
-- `${CLAUDE_FLOW_MESSAGE}` - Notification message
-- `${CLAUDE_FLOW_AGENT_ID}` - Agent identifier
-
-## Common Use Cases
-
-### 1. Auto-Format on Save
-```json
-{
-  "matcher": "Edit|MultiEdit|Write",
-  "hooks": [{
-    "type": "command",
-    "command": "npx claude-flow hooks post-edit --file \"${CLAUDE_FLOW_FILE}\" --format-code"
-  }]
-}
-```
-
-### 2. Command Safety Validation
-```json
-{
-  "matcher": "Bash",
-  "hooks": [{
-    "type": "command",
-    "command": "npx claude-flow hooks pre-command --command \"${CLAUDE_FLOW_COMMAND}\" --validate-safety",
-    "blocking": true
-  }]
-}
-```
-
-### 3. Auto-Spawn Agents for Tasks
-```json
-{
-  "matcher": "Task",
-  "hooks": [{
-    "type": "command",
-    "command": "npx claude-flow hooks pre-task --description \"${CLAUDE_FLOW_TASK}\" --auto-spawn-agents"
-  }]
-}
-```
-
-### 4. Performance Tracking
-```json
-{
-  "matcher": ".*",
-  "hooks": [{
-    "type": "command",
-    "command": "npx claude-flow hooks post-command --track-metrics"
-  }]
-}
-```
-
-## Best Practices
-
-### 1. Use Non-Blocking for Performance
-```json
-{
-  "blocking": false  // Runs in background
-}
-```
-
-### 2. Block Critical Operations
-```json
-{
-  "matcher": "Bash",
-  "blocking": true  // Prevents dangerous commands
-}
-```
-
-### 3. Cache Frequently Used Data
-```json
-{
-  "command": "npx claude-flow hooks post-search --cache-results"
-}
-```
-
-### 4. Keep Hooks Lightweight
-- Avoid heavy processing in blocking hooks
-- Use async operations where possible
-- Cache results to avoid repeated work
-
-## Troubleshooting
-
-### Disable Hooks Temporarily
-```bash
-export CLAUDE_FLOW_HOOKS_ENABLED=false
-```
-
-### Check Hook Logs
-```bash
-npx claude-flow logs hooks --tail 50
-```
-
-### Test Individual Hooks
-```bash
-npx claude-flow hooks pre-edit --file test.js
-```
-
-### Reset to Defaults
-```bash
-npx claude-flow init --force
-```
-
-## Security Considerations
-
-1. **Full Permissions**: Hooks run with user permissions
-2. **Command Validation**: Pre-command hooks validate safety
-3. **Blocking Behavior**: Can prevent tool execution
-4. **Review Commands**: Always review hook commands
-
-## Performance Impact
-
-- **Non-blocking hooks**: Minimal impact (run in parallel)
-- **Blocking hooks**: Add latency to operations
-- **Caching hooks**: Improve performance over time
-- **Neural training**: Happens asynchronously
-
-## Advanced Configuration
-
-### Custom Hook Commands
-```json
-{
-  "hooks": [{
-    "type": "command",
-    "command": "/path/to/custom/script.sh",
-    "args": ["--file", "${CLAUDE_FLOW_FILE}"]
-  }]
-}
-```
-
-### Conditional Hooks
-```json
-{
-  "matcher": ".*\\.py$",  // Python files only
-  "hooks": [{
-    "command": "npx claude-flow hooks python-lint --file \"${CLAUDE_FLOW_FILE}\""
-  }]
-}
-```
-
-### Chain Multiple Hooks
-```json
-{
-  "hooks": [
-    {
-      "command": "npx claude-flow hooks validate --file \"${CLAUDE_FLOW_FILE}\""
-    },
-    {
-      "command": "npx claude-flow hooks format --file \"${CLAUDE_FLOW_FILE}\""
-    }
-  ]
-}
-```
-
-## Integration with Claude Flow Features
-
-Hooks integrate seamlessly with:
-- **Memory System**: Auto-saves context
-- **Neural Training**: Learns from patterns
-- **Swarm Coordination**: Auto-assigns agents
-- **GitHub Integration**: Tracks changes
-- **Performance Monitoring**: Collects metrics
-
-For detailed hook documentation, see the individual command docs in this directory.

package/.claude/commands/memory/README.md

@@ -1,9 +0,0 @@
-# Memory Commands
-
-Commands for memory operations in Claude Flow.
-
-## Available Commands
-
-- [memory-usage](./memory-usage.md)
-- [memory-persist](./memory-persist.md)
-- [memory-search](./memory-search.md)

package/.claude/commands/memory/memory-persist.md

@@ -1,25 +0,0 @@
-# memory-persist
-
-Persist memory across sessions.
-
-## Usage
-```bash
-npx claude-flow memory persist [options]
-```
-
-## Options
-- `--export <file>` - Export to file
-- `--import <file>` - Import from file
-- `--compress` - Compress memory data
-
-## Examples
-```bash
-# Export memory
-npx claude-flow memory persist --export memory-backup.json
-
-# Import memory
-npx claude-flow memory persist --import memory-backup.json
-
-# Compressed export
-npx claude-flow memory persist --export memory.gz --compress
-```

package/.claude/commands/memory/memory-search.md

@@ -1,25 +0,0 @@
-# memory-search
-
-Search through stored memory.
-
-## Usage
-```bash
-npx claude-flow memory search [options]
-```
-
-## Options
-- `--query <text>` - Search query
-- `--pattern <regex>` - Pattern matching
-- `--limit <n>` - Result limit
-
-## Examples
-```bash
-# Search memory
-npx claude-flow memory search --query "authentication"
-
-# Pattern search
-npx claude-flow memory search --pattern "api-.*"
-
-# Limited results
-npx claude-flow memory search --query "config" --limit 10
-```

package/.claude/commands/memory/memory-usage.md

@@ -1,25 +0,0 @@
-# memory-usage
-
-Manage persistent memory storage.
-
-## Usage
-```bash
-npx claude-flow memory usage [options]
-```
-
-## Options
-- `--action <type>` - Action (store, retrieve, list, clear)
-- `--key <key>` - Memory key
-- `--value <data>` - Data to store (JSON)
-
-## Examples
-```bash
-# Store memory
-npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'
-
-# Retrieve memory
-npx claude-flow memory usage --action retrieve --key "project-config"
-
-# List all keys
-npx claude-flow memory usage --action list
-```

package/.claude/commands/monitoring/README.md

@@ -1,9 +0,0 @@
-# Monitoring Commands
-
-Commands for monitoring operations in Claude Flow.
-
-## Available Commands
-
-- [swarm-monitor](./swarm-monitor.md)
-- [agent-metrics](./agent-metrics.md)
-- [real-time-view](./real-time-view.md)

package/.claude/commands/monitoring/agent-metrics.md

@@ -1,25 +0,0 @@
-# agent-metrics
-
-View agent performance metrics.
-
-## Usage
-```bash
-npx claude-flow agent metrics [options]
-```
-
-## Options
-- `--agent-id <id>` - Specific agent
-- `--period <time>` - Time period
-- `--format <type>` - Output format
-
-## Examples
-```bash
-# All agents metrics
-npx claude-flow agent metrics
-
-# Specific agent
-npx claude-flow agent metrics --agent-id agent-001
-
-# Last hour
-npx claude-flow agent metrics --period 1h
-```

package/.claude/commands/monitoring/real-time-view.md

@@ -1,25 +0,0 @@
-# real-time-view
-
-Real-time view of swarm activity.
-
-## Usage
-```bash
-npx claude-flow monitoring real-time-view [options]
-```
-
-## Options
-- `--filter <type>` - Filter view
-- `--highlight <pattern>` - Highlight pattern
-- `--tail <n>` - Show last N events
-
-## Examples
-```bash
-# Start real-time view
-npx claude-flow monitoring real-time-view
-
-# Filter errors
-npx claude-flow monitoring real-time-view --filter errors
-
-# Highlight pattern
-npx claude-flow monitoring real-time-view --highlight "API"
-```

package/.claude/commands/monitoring/swarm-monitor.md

@@ -1,25 +0,0 @@
-# swarm-monitor
-
-Real-time swarm monitoring.
-
-## Usage
-```bash
-npx claude-flow swarm monitor [options]
-```
-
-## Options
-- `--interval <ms>` - Update interval
-- `--metrics` - Show detailed metrics
-- `--export` - Export monitoring data
-
-## Examples
-```bash
-# Start monitoring
-npx claude-flow swarm monitor
-
-# Custom interval
-npx claude-flow swarm monitor --interval 5000
-
-# With metrics
-npx claude-flow swarm monitor --metrics
-```

package/.claude/commands/optimization/README.md

@@ -1,9 +0,0 @@
-# Optimization Commands
-
-Commands for optimization operations in Claude Flow.
-
-## Available Commands
-
-- [topology-optimize](./topology-optimize.md)
-- [parallel-execute](./parallel-execute.md)
-- [cache-manage](./cache-manage.md)

package/.claude/commands/optimization/cache-manage.md

@@ -1,25 +0,0 @@
-# cache-manage
-
-Manage operation cache for performance.
-
-## Usage
-```bash
-npx claude-flow optimization cache-manage [options]
-```
-
-## Options
-- `--action <type>` - Action (view, clear, optimize)
-- `--max-size <mb>` - Maximum cache size
-- `--ttl <seconds>` - Time to live
-
-## Examples
-```bash
-# View cache stats
-npx claude-flow optimization cache-manage --action view
-
-# Clear cache
-npx claude-flow optimization cache-manage --action clear
-
-# Set limits
-npx claude-flow optimization cache-manage --max-size 100 --ttl 3600
-```

package/.claude/commands/optimization/parallel-execute.md

@@ -1,25 +0,0 @@
-# parallel-execute
-
-Execute tasks in parallel for maximum efficiency.
-
-## Usage
-```bash
-npx claude-flow optimization parallel-execute [options]
-```
-
-## Options
-- `--tasks <file>` - Task list file
-- `--max-parallel <n>` - Maximum parallel tasks
-- `--strategy <type>` - Execution strategy
-
-## Examples
-```bash
-# Execute task list
-npx claude-flow optimization parallel-execute --tasks tasks.json
-
-# Limit parallelism
-npx claude-flow optimization parallel-execute --tasks tasks.json --max-parallel 5
-
-# Custom strategy
-npx claude-flow optimization parallel-execute --strategy adaptive
-```

package/.claude/commands/optimization/topology-optimize.md

@@ -1,25 +0,0 @@
-# topology-optimize
-
-Optimize swarm topology for current workload.
-
-## Usage
-```bash
-npx claude-flow optimization topology-optimize [options]
-```
-
-## Options
-- `--analyze-first` - Analyze before optimizing
-- `--target <metric>` - Optimization target
-- `--apply` - Apply optimizations
-
-## Examples
-```bash
-# Analyze and suggest
-npx claude-flow optimization topology-optimize --analyze-first
-
-# Optimize for speed
-npx claude-flow optimization topology-optimize --target speed
-
-# Apply changes
-npx claude-flow optimization topology-optimize --target efficiency --apply
-```

package/.claude/commands/training/README.md

@@ -1,9 +0,0 @@
-# Training Commands
-
-Commands for training operations in Claude Flow.
-
-## Available Commands
-
-- [neural-train](./neural-train.md)
-- [pattern-learn](./pattern-learn.md)
-- [model-update](./model-update.md)

package/.claude/commands/training/model-update.md

@@ -1,25 +0,0 @@
-# model-update
-
-Update neural models with new data.
-
-## Usage
-```bash
-npx claude-flow training model-update [options]
-```
-
-## Options
-- `--model <name>` - Model to update
-- `--incremental` - Incremental update
-- `--validate` - Validate after update
-
-## Examples
-```bash
-# Update all models
-npx claude-flow training model-update
-
-# Specific model
-npx claude-flow training model-update --model agent-selector
-
-# Incremental with validation
-npx claude-flow training model-update --incremental --validate
-```

package/.claude/commands/training/neural-train.md

@@ -1,25 +0,0 @@
-# neural-train
-
-Train neural patterns from operations.
-
-## Usage
-```bash
-npx claude-flow training neural-train [options]
-```
-
-## Options
-- `--data <source>` - Training data source
-- `--model <name>` - Target model
-- `--epochs <n>` - Training epochs
-
-## Examples
-```bash
-# Train from recent ops
-npx claude-flow training neural-train --data recent
-
-# Specific model
-npx claude-flow training neural-train --model task-predictor
-
-# Custom epochs
-npx claude-flow training neural-train --epochs 100
-```

package/.claude/commands/training/pattern-learn.md

@@ -1,25 +0,0 @@
-# pattern-learn
-
-Learn patterns from successful operations.
-
-## Usage
-```bash
-npx claude-flow training pattern-learn [options]
-```
-
-## Options
-- `--source <type>` - Pattern source
-- `--threshold <score>` - Success threshold
-- `--save <name>` - Save pattern set
-
-## Examples
-```bash
-# Learn from all ops
-npx claude-flow training pattern-learn
-
-# High success only
-npx claude-flow training pattern-learn --threshold 0.9
-
-# Save patterns
-npx claude-flow training pattern-learn --save optimal-patterns
-```

package/.claude/commands/workflows/README.md

@@ -1,9 +0,0 @@
-# Workflows Commands
-
-Commands for workflows operations in Claude Flow.
-
-## Available Commands
-
-- [workflow-create](./workflow-create.md)
-- [workflow-execute](./workflow-execute.md)
-- [workflow-export](./workflow-export.md)

package/.claude/commands/workflows/workflow-create.md

@@ -1,25 +0,0 @@
-# workflow-create
-
-Create reusable workflow templates.
-
-## Usage
-```bash
-npx claude-flow workflow create [options]
-```
-
-## Options
-- `--name <name>` - Workflow name
-- `--from-history` - Create from history
-- `--interactive` - Interactive creation
-
-## Examples
-```bash
-# Create workflow
-npx claude-flow workflow create --name "deploy-api"
-
-# From history
-npx claude-flow workflow create --name "test-suite" --from-history
-
-# Interactive mode
-npx claude-flow workflow create --interactive
-```

package/.claude/commands/workflows/workflow-execute.md

@@ -1,25 +0,0 @@
-# workflow-execute
-
-Execute saved workflows.
-
-## Usage
-```bash
-npx claude-flow workflow execute [options]
-```
-
-## Options
-- `--name <name>` - Workflow name
-- `--params <json>` - Workflow parameters
-- `--dry-run` - Preview execution
-
-## Examples
-```bash
-# Execute workflow
-npx claude-flow workflow execute --name "deploy-api"
-
-# With parameters
-npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'
-
-# Dry run
-npx claude-flow workflow execute --name "deploy-api" --dry-run
-```

package/.claude/commands/workflows/workflow-export.md

@@ -1,25 +0,0 @@
-# workflow-export
-
-Export workflows for sharing.
-
-## Usage
-```bash
-npx claude-flow workflow export [options]
-```
-
-## Options
-- `--name <name>` - Workflow to export
-- `--format <type>` - Export format
-- `--include-history` - Include execution history
-
-## Examples
-```bash
-# Export workflow
-npx claude-flow workflow export --name "deploy-api"
-
-# As YAML
-npx claude-flow workflow export --name "test-suite" --format yaml
-
-# With history
-npx claude-flow workflow export --name "deploy-api" --include-history
-```