// Detects npm cache errors
if (error.includes('ENOTEMPTY') && error.includes('npm')) {
  // Automatic recovery triggered
}

// Detects better-sqlite3 issues
if (error.includes('better-sqlite3')) {
  // Automatic recovery triggered
}

// Automatic retry with backoff
retryWithRecovery(operation, {
  maxRetries: 5,        // Try up to 5 times
  delay: 1000,          // Start with 1s delay
  exponentialBackoff: true  // 1s, 2s, 4s, 8s, 16s
});

// Automatic fallback to JSON storage
if (sqliteInitFails && retries > maxRetries) {
  console.log('🔄 Switching to JSON storage...');
  switchToJSONProvider();
}

# Standard initialization with automatic recovery
npx claude-flow@alpha init

# Force mode with extended retries (5 attempts)
npx claude-flow@alpha init --force

# Clean npm cache manually
npm cache clean --force
rm -rf ~/.npm/_npx

# Check WSL environment
npx claude-flow@alpha diagnose --wsl

# Verify dependencies
npx claude-flow@alpha verify --deps

┌─────────────────────────┐
│  Initialize Command     │
└───────────┬─────────────┘
            │
            ▼
┌─────────────────────────┐
│  Detect WSL? Apply Fixes│
└───────────┬─────────────┘
            │
            ▼
┌─────────────────────────┐
│  Run Initialization     │
└───────────┬─────────────┘
            │
            ▼
      Error Detected?
            │
    ┌───────┴───────┐
    │               │
   Yes              No
    │               │
    ▼               ▼
┌─────────────┐  Success!
│ Is Npm Cache│
│   Error?    │
└─────┬───────┘
      │
     Yes
      │
      ▼
┌─────────────────────────┐
│ Clean npm/npx cache     │
│ Fix permissions         │
│ Apply WSL optimizations │
└───────────┬─────────────┘
            │
            ▼
┌─────────────────────────┐
│  Retry with Backoff     │
│  (Attempt N/5)          │
└───────────┬─────────────┘
            │
            ▼
      Max Retries?
            │
    ┌───────┴───────┐
    │               │
   Yes              No
    │               │
    ▼               ▼
┌─────────────┐  Try Again
│ Fallback to │
│ JSON Storage│
└─────────────┘

// Automatic WSL detection
if (process.platform === 'linux') {
  const isWSL = fs.readFileSync('/proc/version', 'utf8')
    .toLowerCase()
    .includes('microsoft');

  if (isWSL) {
    applyWSLOptimizations();
  }
}

// In your code or configuration
export interface RetryOptions {
  maxRetries?: number;      // Default: 3 (5 with --force)
  delay?: number;           // Default: 1000ms
  exponentialBackoff?: boolean;  // Default: true
  cleanupFn?: () => Promise<void>;  // Custom cleanup
}

// .claude-flow/config.json
{
  "errorRecovery": {
    "enabled": true,
    "maxRetries": 5,
    "cleanCacheOnError": true,
    "wslOptimizations": true,
    "fallbackToJSON": true
  }
}

npx claude-flow@alpha init --force

🔍 WSL environment detected
✅ WSL environment optimized

📁 Phase 1: Creating directory structure...
⚠️  Detected npm cache error (attempt 1/5)
🧹 Cleaning npm cache...
✅ npm cache cleaned
🗑️  Removing npx cache: /home/user/.npm/_npx
✅ npx cache removed
✅ npm directory permissions fixed
✅ Cache cleaned, retrying...

🔄 Retry attempt 1 after error recovery...
✅ Recovered from error, retrying initialization...

📁 Phase 1: Creating directory structure...
⚙️  Phase 2: Creating configuration...
🎉 Project initialized successfully!

# Enable verbose error recovery logging
DEBUG=claude-flow:error-recovery npx claude-flow@alpha init --force

import { errorRecovery } from 'claude-flow/utils/error-recovery';

// Check if error is recoverable
if (errorRecovery.isNpmCacheError(error)) {
  // Clean cache
  await errorRecovery.cleanNpmCache();

  // Retry operation
  await errorRecovery.retryWithRecovery(myOperation, {
    maxRetries: 5,
    delay: 1000
  });
}

// Custom cleanup function
await errorRecovery.retryWithRecovery(
  async () => {
    return await myOperation();
  },
  {
    maxRetries: 3,
    cleanupFn: async () => {
      // Custom cleanup logic
      await fs.remove('./temp-files');
      await clearCustomCache();
    }
  }
);