/self-healing

Self-Healing Workflows

Purpose

Automatically detect and recover from errors without interrupting your flow.

Self-Healing Features

1. Error Detection

Monitors for:

• Failed commands
• Syntax errors
• Missing dependencies
• Broken tests

2. Automatic Recovery

**Missing Dependencies:**

Error: Cannot find module 'express'
→ Automatically runs: npm install express
→ Retries original command

**Syntax Errors:**

Error: Unexpected token
→ Analyzes error location
→ Suggests fix through analyzer agent
→ Applies fix with confirmation

**Test Failures:**

Test failed: "user authentication"
→ Spawns debugger agent
→ Analyzes failure cause
→ Implements fix
→ Re-runs tests

3. Learning from Failures

Each recovery improves future prevention:

• Patterns saved to knowledge base
• Similar errors prevented proactively
• Recovery strategies optimized

**Pattern Storage:**

// Store error patterns
mcp__claude-flow__memory_usage({
  "action": "store",
  "key": "error-pattern-" + Date.now(),
  "value": JSON.stringify(errorData),
  "namespace": "error-patterns",
  "ttl": 2592000 // 30 days
})

// Analyze patterns
mcp__claude-flow__neural_patterns({
  "action": "analyze",
  "operation": "error-recovery",
  "outcome": "success"
})

Self-Healing Integration

MCP Tool Coordination

// Initialize self-healing swarm
mcp__claude-flow__swarm_init({
  "topology": "star",
  "maxAgents": 4,
  "strategy": "adaptive"
})

// Spawn recovery agents
mcp__claude-flow__agent_spawn({
  "type": "monitor",
  "name": "Error Monitor",
  "capabilities": ["error-detection", "recovery"]
})

// Orchestrate recovery
mcp__claude-flow__task_orchestrate({
  "task": "recover from error",
  "strategy": "sequential",
  "priority": "critical"
})

Fallback Hook Configuration

{
  "PostToolUse": [{
    "matcher": "^Bash$",
    "command": "npx claude-flow hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"
  }]
}

Benefits

• 🛡️ Resilient workflows
• 🔄 Automatic recovery
• 📚 Learns from errors
• ⏱️ Saves debugging time