claude-flow 2.7.42 → 2.7.44

package/dist/src/memory/swarm-memory.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/memory/swarm-memory.js"],"sourcesContent":["/**\n * SwarmMemory - MCP-specific memory persistence extending SharedMemory\n * Provides swarm-specific features like agent coordination, task tracking, and neural patterns\n *\n * @module swarm-memory\n */\n\nimport { SharedMemory } from './shared-memory.js';\nimport path from 'path';\n\n/**\n * Swarm-specific namespaces\n */\nconst SWARM_NAMESPACES = {\n  AGENTS: 'swarm:agents',\n  TASKS: 'swarm:tasks',\n  COMMUNICATIONS: 'swarm:communications',\n  CONSENSUS: 'swarm:consensus',\n  PATTERNS: 'swarm:patterns',\n  METRICS: 'swarm:metrics',\n  COORDINATION: 'swarm:coordination',\n};\n\n/**\n * SwarmMemory class - Extends SharedMemory with MCP features\n */\nexport class SwarmMemory extends SharedMemory {\n  constructor(options = {}) {\n    // Default to .swarm directory for MCP\n    super({\n      directory: options.directory || '.swarm',\n      filename: options.filename || 'swarm-memory.db',\n      ...options,\n    });\n\n    this.swarmId = options.swarmId || 'default';\n    this.mcpMode = options.mcpMode !== false;\n\n    // Additional swarm-specific caches\n    this.agentCache = new Map();\n    this.taskCache = new Map();\n    this.patternCache = new Map();\n  }\n\n  /**\n   * Initialize with swarm-specific setup\n   */\n  async initialize() {\n    await super.initialize();\n\n    // Initialize swarm-specific namespaces\n    await this._initializeSwarmNamespaces();\n\n    // Load active agents and tasks into cache\n    await this._loadSwarmState();\n\n    this.emit('swarm:initialized', { swarmId: this.swarmId });\n  }\n\n  /**\n   * Store agent information\n   */\n  async storeAgent(agentId, agentData) {\n    const key = `agent:${agentId}`;\n    const enrichedData = {\n      ...agentData,\n      swarmId: this.swarmId,\n      lastUpdated: new Date().toISOString(),\n    };\n\n    await this.store(key, enrichedData, {\n      namespace: SWARM_NAMESPACES.AGENTS,\n      tags: ['agent', agentData.type, agentData.status],\n      metadata: {\n        swarmId: this.swarmId,\n        agentType: agentData.type,\n      },\n    });\n\n    // Update agent cache\n    this.agentCache.set(agentId, enrichedData);\n\n    this.emit('swarm:agentStored', { agentId, type: agentData.type });\n\n    return { agentId, stored: true };\n  }\n\n  /**\n   * Retrieve agent information\n   */\n  async getAgent(agentId) {\n    // Check cache first\n    if (this.agentCache.has(agentId)) {\n      return this.agentCache.get(agentId);\n    }\n\n    const key = `agent:${agentId}`;\n    const agent = await this.retrieve(key, SWARM_NAMESPACES.AGENTS);\n\n    if (agent) {\n      this.agentCache.set(agentId, agent);\n    }\n\n    return agent;\n  }\n\n  /**\n   * List all agents in swarm\n   */\n  async listAgents(filter = {}) {\n    const agents = await this.list(SWARM_NAMESPACES.AGENTS, {\n      limit: filter.limit || 100,\n    });\n\n    return agents\n      .map((entry) => entry.value)\n      .filter((agent) => {\n        if (filter.type && agent.type !== filter.type) return false;\n        if (filter.status && agent.status !== filter.status) return false;\n        if (filter.swarmId && agent.swarmId !== filter.swarmId) return false;\n        return true;\n      });\n  }\n\n  /**\n   * Store task information\n   */\n  async storeTask(taskId, taskData) {\n    const key = `task:${taskId}`;\n    const enrichedData = {\n      ...taskData,\n      swarmId: this.swarmId,\n      createdAt: taskData.createdAt || new Date().toISOString(),\n      updatedAt: new Date().toISOString(),\n    };\n\n    await this.store(key, enrichedData, {\n      namespace: SWARM_NAMESPACES.TASKS,\n      tags: ['task', taskData.status, taskData.priority],\n      metadata: {\n        swarmId: this.swarmId,\n        assignedAgents: taskData.assignedAgents || [],\n      },\n    });\n\n    // Update task cache\n    this.taskCache.set(taskId, enrichedData);\n\n    this.emit('swarm:taskStored', { taskId, status: taskData.status });\n\n    return { taskId, stored: true };\n  }\n\n  /**\n   * Update task status\n   */\n  async updateTaskStatus(taskId, status, result = null) {\n    const task = await this.getTask(taskId);\n    if (!task) {\n      throw new Error(`Task ${taskId} not found`);\n    }\n\n    task.status = status;\n    task.updatedAt = new Date().toISOString();\n\n    if (result) {\n      task.result = result;\n    }\n\n    if (status === 'completed') {\n      task.completedAt = new Date().toISOString();\n    }\n\n    await this.storeTask(taskId, task);\n\n    this.emit('swarm:taskStatusUpdated', { taskId, status });\n\n    return { taskId, status, updated: true };\n  }\n\n  /**\n   * Get task information\n   */\n  async getTask(taskId) {\n    // Check cache first\n    if (this.taskCache.has(taskId)) {\n      return this.taskCache.get(taskId);\n    }\n\n    const key = `task:${taskId}`;\n    const task = await this.retrieve(key, SWARM_NAMESPACES.TASKS);\n\n    if (task) {\n      this.taskCache.set(taskId, task);\n    }\n\n    return task;\n  }\n\n  /**\n   * Store inter-agent communication\n   */\n  async storeCommunication(fromAgent, toAgent, message) {\n    const commId = `comm:${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n    const communication = {\n      id: commId,\n      fromAgent,\n      toAgent,\n      message,\n      swarmId: this.swarmId,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.store(commId, communication, {\n      namespace: SWARM_NAMESPACES.COMMUNICATIONS,\n      ttl: 86400, // 24 hours\n      tags: ['communication', message.type],\n      metadata: {\n        fromAgent,\n        toAgent,\n        messageType: message.type,\n      },\n    });\n\n    this.emit('swarm:communication', { fromAgent, toAgent, type: message.type });\n\n    return { id: commId, stored: true };\n  }\n\n  /**\n   * Store consensus decision\n   */\n  async storeConsensus(consensusId, decision) {\n    const key = `consensus:${consensusId}`;\n    const consensusData = {\n      ...decision,\n      swarmId: this.swarmId,\n      timestamp: new Date().toISOString(),\n    };\n\n    await this.store(key, consensusData, {\n      namespace: SWARM_NAMESPACES.CONSENSUS,\n      tags: ['consensus', decision.status],\n      metadata: {\n        swarmId: this.swarmId,\n        taskId: decision.taskId,\n        threshold: decision.threshold,\n      },\n    });\n\n    this.emit('swarm:consensus', { consensusId, status: decision.status });\n\n    return { consensusId, stored: true };\n  }\n\n  /**\n   * Store neural pattern\n   */\n  async storePattern(patternId, pattern) {\n    const key = `pattern:${patternId}`;\n    const patternData = {\n      ...pattern,\n      swarmId: this.swarmId,\n      createdAt: new Date().toISOString(),\n      usageCount: 0,\n      successRate: 0,\n    };\n\n    await this.store(key, patternData, {\n      namespace: SWARM_NAMESPACES.PATTERNS,\n      tags: ['pattern', pattern.type],\n      metadata: {\n        swarmId: this.swarmId,\n        patternType: pattern.type,\n        confidence: pattern.confidence || 0,\n      },\n    });\n\n    // Cache frequently used patterns\n    if (pattern.type === 'coordination' || pattern.type === 'optimization') {\n      this.patternCache.set(patternId, patternData);\n    }\n\n    this.emit('swarm:patternStored', { patternId, type: pattern.type });\n\n    return { patternId, stored: true };\n  }\n\n  /**\n   * Update pattern usage and success metrics\n   */\n  async updatePatternMetrics(patternId, success = true) {\n    const pattern = await this.getPattern(patternId);\n    if (!pattern) {\n      throw new Error(`Pattern ${patternId} not found`);\n    }\n\n    pattern.usageCount++;\n    pattern.lastUsedAt = new Date().toISOString();\n\n    // Update success rate with exponential moving average\n    const alpha = 0.1; // Smoothing factor\n    const currentSuccess = success ? 1 : 0;\n    pattern.successRate = alpha * currentSuccess + (1 - alpha) * (pattern.successRate || 0);\n\n    await this.storePattern(patternId, pattern);\n\n    return { patternId, usageCount: pattern.usageCount, successRate: pattern.successRate };\n  }\n\n  /**\n   * Get pattern\n   */\n  async getPattern(patternId) {\n    // Check cache first\n    if (this.patternCache.has(patternId)) {\n      return this.patternCache.get(patternId);\n    }\n\n    const key = `pattern:${patternId}`;\n    return await this.retrieve(key, SWARM_NAMESPACES.PATTERNS);\n  }\n\n  /**\n   * Find best patterns for a given context\n   */\n  async findBestPatterns(context, limit = 5) {\n    const patterns = await this.search({\n      namespace: SWARM_NAMESPACES.PATTERNS,\n      tags: context.tags,\n      limit: 100,\n    });\n\n    // Score patterns based on success rate and relevance\n    const scored = patterns.map((entry) => {\n      const pattern = entry.value;\n      const score =\n        pattern.successRate * 0.7 +\n        (pattern.confidence || 0) * 0.2 +\n        (pattern.usageCount > 0 ? 0.1 : 0);\n\n      return { ...pattern, score };\n    });\n\n    // Sort by score and return top patterns\n    return scored.sort((a, b) => b.score - a.score).slice(0, limit);\n  }\n\n  /**\n   * Store coordination state\n   */\n  async storeCoordination(key, state) {\n    await this.store(key, state, {\n      namespace: SWARM_NAMESPACES.COORDINATION,\n      ttl: 3600, // 1 hour\n      metadata: {\n        swarmId: this.swarmId,\n        timestamp: new Date().toISOString(),\n      },\n    });\n\n    return { key, stored: true };\n  }\n\n  /**\n   * Get coordination state\n   */\n  async getCoordination(key) {\n    return await this.retrieve(key, SWARM_NAMESPACES.COORDINATION);\n  }\n\n  /**\n   * Store performance metrics\n   */\n  async storeMetrics(metricsId, metrics) {\n    const key = `metrics:${metricsId}`;\n    await this.store(key, metrics, {\n      namespace: SWARM_NAMESPACES.METRICS,\n      ttl: 86400 * 7, // 7 days\n      tags: ['metrics', metrics.type],\n      metadata: {\n        swarmId: this.swarmId,\n        agentId: metrics.agentId,\n        timestamp: new Date().toISOString(),\n      },\n    });\n\n    this.emit('swarm:metricsStored', { metricsId, type: metrics.type });\n\n    return { metricsId, stored: true };\n  }\n\n  /**\n   * Get swarm statistics\n   */\n  async getSwarmStats() {\n    const baseStats = await this.getStats();\n\n    // Add swarm-specific stats\n    const agentCount = await this._countNamespace(SWARM_NAMESPACES.AGENTS);\n    const taskCount = await this._countNamespace(SWARM_NAMESPACES.TASKS);\n    const patternCount = await this._countNamespace(SWARM_NAMESPACES.PATTERNS);\n\n    // Get active agents\n    const activeAgents = Array.from(this.agentCache.values()).filter(\n      (agent) => agent.status === 'active' || agent.status === 'busy',\n    ).length;\n\n    // Get task statistics\n    const tasks = Array.from(this.taskCache.values());\n    const taskStats = {\n      total: tasks.length,\n      pending: tasks.filter((t) => t.status === 'pending').length,\n      inProgress: tasks.filter((t) => t.status === 'in_progress').length,\n      completed: tasks.filter((t) => t.status === 'completed').length,\n      failed: tasks.filter((t) => t.status === 'failed').length,\n    };\n\n    return {\n      ...baseStats,\n      swarm: {\n        swarmId: this.swarmId,\n        agents: {\n          total: agentCount,\n          active: activeAgents,\n          cached: this.agentCache.size,\n        },\n        tasks: taskStats,\n        patterns: {\n          total: patternCount,\n          cached: this.patternCache.size,\n        },\n        namespaces: Object.values(SWARM_NAMESPACES),\n      },\n    };\n  }\n\n  /**\n   * Clean up old swarm data\n   */\n  async cleanupSwarmData(options = {}) {\n    const {\n      maxAge = 86400 * 7, // 7 days\n      keepPatterns = true,\n      keepConsensus = true,\n    } = options;\n\n    const cutoffTime = Date.now() - maxAge * 1000;\n    let cleaned = 0;\n\n    // Clean old communications\n    const comms = await this.list(SWARM_NAMESPACES.COMMUNICATIONS);\n    for (const comm of comms) {\n      if (new Date(comm.value.timestamp).getTime() < cutoffTime) {\n        await this.delete(comm.key, SWARM_NAMESPACES.COMMUNICATIONS);\n        cleaned++;\n      }\n    }\n\n    // Clean completed tasks\n    const tasks = await this.list(SWARM_NAMESPACES.TASKS);\n    for (const task of tasks) {\n      if (\n        task.value.status === 'completed' &&\n        new Date(task.value.completedAt).getTime() < cutoffTime\n      ) {\n        await this.delete(task.key, SWARM_NAMESPACES.TASKS);\n        this.taskCache.delete(task.value.id);\n        cleaned++;\n      }\n    }\n\n    // Clean old metrics\n    const metrics = await this.list(SWARM_NAMESPACES.METRICS);\n    for (const metric of metrics) {\n      if (new Date(metric.createdAt).getTime() < cutoffTime) {\n        await this.delete(metric.key, SWARM_NAMESPACES.METRICS);\n        cleaned++;\n      }\n    }\n\n    this.emit('swarm:cleanup', { cleaned, maxAge });\n\n    return { cleaned };\n  }\n\n  /**\n   * Export swarm state\n   */\n  async exportSwarmState() {\n    const agents = await this.listAgents();\n    const tasks = Array.from(this.taskCache.values());\n    const patterns = await this.list(SWARM_NAMESPACES.PATTERNS);\n\n    return {\n      swarmId: this.swarmId,\n      exportedAt: new Date().toISOString(),\n      agents: agents,\n      tasks: tasks,\n      patterns: patterns.map((p) => p.value),\n      statistics: await this.getSwarmStats(),\n    };\n  }\n\n  /**\n   * Import swarm state\n   */\n  async importSwarmState(state) {\n    let imported = {\n      agents: 0,\n      tasks: 0,\n      patterns: 0,\n    };\n\n    // Import agents\n    if (state.agents) {\n      for (const agent of state.agents) {\n        await this.storeAgent(agent.id, agent);\n        imported.agents++;\n      }\n    }\n\n    // Import tasks\n    if (state.tasks) {\n      for (const task of state.tasks) {\n        await this.storeTask(task.id, task);\n        imported.tasks++;\n      }\n    }\n\n    // Import patterns\n    if (state.patterns) {\n      for (const pattern of state.patterns) {\n        await this.storePattern(pattern.id, pattern);\n        imported.patterns++;\n      }\n    }\n\n    this.emit('swarm:imported', imported);\n\n    return imported;\n  }\n\n  /**\n   * Private helper methods\n   */\n\n  async _initializeSwarmNamespaces() {\n    // Create swarm metadata\n    await this.store(\n      'swarm:metadata',\n      {\n        swarmId: this.swarmId,\n        createdAt: new Date().toISOString(),\n        version: '1.0.0',\n        namespaces: Object.values(SWARM_NAMESPACES),\n      },\n      {\n        namespace: 'swarm:system',\n      },\n    );\n  }\n\n  async _loadSwarmState() {\n    // Load active agents\n    const agents = await this.list(SWARM_NAMESPACES.AGENTS, { limit: 100 });\n    for (const entry of agents) {\n      if (entry.value.status === 'active' || entry.value.status === 'busy') {\n        this.agentCache.set(entry.value.id, entry.value);\n      }\n    }\n\n    // Load in-progress tasks\n    const tasks = await this.search({\n      namespace: SWARM_NAMESPACES.TASKS,\n      tags: ['in_progress'],\n      limit: 100,\n    });\n    for (const entry of tasks) {\n      this.taskCache.set(entry.value.id, entry.value);\n    }\n\n    // Load high-confidence patterns\n    const patterns = await this.list(SWARM_NAMESPACES.PATTERNS, { limit: 50 });\n    for (const entry of patterns) {\n      if (entry.value.confidence > 0.7 || entry.value.successRate > 0.8) {\n        this.patternCache.set(entry.value.id, entry.value);\n      }\n    }\n  }\n\n  async _countNamespace(namespace) {\n    const stats = await this.getStats();\n    return stats.namespaces[namespace]?.count || 0;\n  }\n}\n\n// Export factory function for easy creation\nexport function createSwarmMemory(options = {}) {\n  return new SwarmMemory(options);\n}\n\n// Export for backwards compatibility\nexport default SwarmMemory;\n"],"names":["SharedMemory","SWARM_NAMESPACES","AGENTS","TASKS","COMMUNICATIONS","CONSENSUS","PATTERNS","METRICS","COORDINATION","SwarmMemory","options","directory","filename","swarmId","mcpMode","agentCache","Map","taskCache","patternCache","initialize","_initializeSwarmNamespaces","_loadSwarmState","emit","storeAgent","agentId","agentData","key","enrichedData","lastUpdated","Date","toISOString","store","namespace","tags","type","status","metadata","agentType","set","stored","getAgent","has","get","agent","retrieve","listAgents","filter","agents","list","limit","map","entry","value","storeTask","taskId","taskData","createdAt","updatedAt","priority","assignedAgents","updateTaskStatus","result","task","getTask","Error","completedAt","updated","storeCommunication","fromAgent","toAgent","message","commId","now","Math","random","toString","substr","communication","id","timestamp","ttl","messageType","storeConsensus","consensusId","decision","consensusData","threshold","storePattern","patternId","pattern","patternData","usageCount","successRate","patternType","confidence","updatePatternMetrics","success","getPattern","lastUsedAt","alpha","currentSuccess","findBestPatterns","context","patterns","search","scored","score","sort","a","b","slice","storeCoordination","state","getCoordination","storeMetrics","metricsId","metrics","getSwarmStats","baseStats","getStats","agentCount","_countNamespace","taskCount","patternCount","activeAgents","Array","from","values","length","tasks","taskStats","total","pending","t","inProgress","completed","failed","swarm","active","cached","size","namespaces","Object","cleanupSwarmData","maxAge","keepPatterns","keepConsensus","cutoffTime","cleaned","comms","comm","getTime","delete","metric","exportSwarmState","exportedAt","p","statistics","importSwarmState","imported","version","stats","count","createSwarmMemory"],"mappings":"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"}
+{"version":3,"sources":["../../../src/memory/swarm-memory.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport { Logger } from '../core/logger.js';\nimport { MemoryManager } from './manager.js';\nimport { EventBus } from '../core/event-bus.js';\nimport { generateId } from '../utils/helpers.js';\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\n\nexport interface SwarmMemoryEntry {\n  id: string;\n  agentId: string;\n  type: 'knowledge' | 'result' | 'state' | 'communication' | 'error';\n  content: any;\n  timestamp: Date;\n  metadata: {\n    taskId?: string;\n    objectiveId?: string;\n    tags?: string[];\n    priority?: number;\n    shareLevel?: 'private' | 'team' | 'public';\n  };\n}\n\nexport interface SwarmMemoryQuery {\n  agentId?: string;\n  type?: SwarmMemoryEntry['type'];\n  taskId?: string;\n  objectiveId?: string;\n  tags?: string[];\n  since?: Date;\n  before?: Date;\n  limit?: number;\n  shareLevel?: SwarmMemoryEntry['metadata']['shareLevel'];\n}\n\nexport interface SwarmKnowledgeBase {\n  id: string;\n  name: string;\n  description: string;\n  entries: SwarmMemoryEntry[];\n  metadata: {\n    domain: string;\n    expertise: string[];\n    contributors: string[];\n    lastUpdated: Date;\n  };\n}\n\nexport interface SwarmMemoryConfig {\n  namespace: string;\n  enableDistribution: boolean;\n  enableReplication: boolean;\n  syncInterval: number;\n  maxEntries: number;\n  compressionThreshold: number;\n  enableKnowledgeBase: boolean;\n  enableCrossAgentSharing: boolean;\n  persistencePath: string;\n}\n\nexport class SwarmMemoryManager extends EventEmitter {\n  private logger: Logger;\n  private config: SwarmMemoryConfig;\n  private baseMemory: MemoryManager;\n  private entries: Map<string, SwarmMemoryEntry>;\n  private knowledgeBases: Map<string, SwarmKnowledgeBase>;\n  private agentMemories: Map<string, Set<string>>; // agentId -> set of entry IDs\n  private syncTimer?: NodeJS.Timeout;\n  private isInitialized: boolean = false;\n\n  constructor(config: Partial<SwarmMemoryConfig> = {}) {\n    super();\n    this.logger = new Logger('SwarmMemoryManager');\n    this.config = {\n      namespace: 'swarm',\n      enableDistribution: true,\n      enableReplication: true,\n      syncInterval: 10000, // 10 seconds\n      maxEntries: 10000,\n      compressionThreshold: 1000,\n      enableKnowledgeBase: true,\n      enableCrossAgentSharing: true,\n      persistencePath: './swarm-memory',\n      ...config,\n    };\n\n    this.entries = new Map();\n    this.knowledgeBases = new Map();\n    this.agentMemories = new Map();\n\n    const eventBus = EventBus.getInstance();\n    this.baseMemory = new MemoryManager(\n      {\n        backend: 'sqlite',\n        namespace: this.config.namespace,\n        cacheSizeMB: 50,\n        syncOnExit: true,\n        maxEntries: this.config.maxEntries,\n        ttlMinutes: 60,\n      },\n      eventBus,\n      this.logger,\n    );\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) return;\n\n    this.logger.info('Initializing swarm memory manager...');\n\n    // Initialize base memory\n    await this.baseMemory.initialize();\n\n    // Create persistence directory\n    await fs.mkdir(this.config.persistencePath, { recursive: true });\n\n    // Load existing memory\n    await this.loadMemoryState();\n\n    // Start sync timer\n    if (this.config.syncInterval > 0) {\n      this.syncTimer = setInterval(() => {\n        this.syncMemoryState();\n      }, this.config.syncInterval);\n    }\n\n    this.isInitialized = true;\n    this.emit('memory:initialized');\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.isInitialized) return;\n\n    this.logger.info('Shutting down swarm memory manager...');\n\n    // Stop sync timer\n    if (this.syncTimer) {\n      clearInterval(this.syncTimer);\n      this.syncTimer = undefined;\n    }\n\n    // Save final state\n    await this.saveMemoryState();\n\n    this.isInitialized = false;\n    this.emit('memory:shutdown');\n  }\n\n  async remember(\n    agentId: string,\n    type: SwarmMemoryEntry['type'],\n    content: any,\n    metadata: Partial<SwarmMemoryEntry['metadata']> = {},\n  ): Promise<string> {\n    const entryId = generateId('mem');\n    const entry: SwarmMemoryEntry = {\n      id: entryId,\n      agentId,\n      type,\n      content,\n      timestamp: new Date(),\n      metadata: {\n        shareLevel: 'team',\n        priority: 1,\n        ...metadata,\n      },\n    };\n\n    this.entries.set(entryId, entry);\n\n    // Associate with agent\n    if (!this.agentMemories.has(agentId)) {\n      this.agentMemories.set(agentId, new Set());\n    }\n    this.agentMemories.get(agentId)!.add(entryId);\n\n    // Store in base memory for persistence\n    await this.baseMemory.remember({\n      namespace: this.config.namespace,\n      key: `entry:${entryId}`,\n      content: JSON.stringify(entry),\n      metadata: {\n        type: 'swarm-memory',\n        agentId,\n        entryType: type,\n        shareLevel: entry.metadata.shareLevel,\n      },\n    });\n\n    this.logger.debug(`Agent ${agentId} remembered: ${type} - ${entryId}`);\n    this.emit('memory:added', entry);\n\n    // Update knowledge base if applicable\n    if (type === 'knowledge' && this.config.enableKnowledgeBase) {\n      await this.updateKnowledgeBase(entry);\n    }\n\n    // Check for memory limits\n    await this.enforceMemoryLimits();\n\n    return entryId;\n  }\n\n  async recall(query: SwarmMemoryQuery): Promise<SwarmMemoryEntry[]> {\n    let results = Array.from(this.entries.values());\n\n    // Apply filters\n    if (query.agentId) {\n      results = results.filter((e) => e.agentId === query.agentId);\n    }\n\n    if (query.type) {\n      results = results.filter((e) => e.type === query.type);\n    }\n\n    if (query.taskId) {\n      results = results.filter((e) => e.metadata.taskId === query.taskId);\n    }\n\n    if (query.objectiveId) {\n      results = results.filter((e) => e.metadata.objectiveId === query.objectiveId);\n    }\n\n    if (query.tags && query.tags.length > 0) {\n      results = results.filter(\n        (e) => e.metadata.tags && query.tags!.some((tag) => e.metadata.tags!.includes(tag)),\n      );\n    }\n\n    if (query.since) {\n      results = results.filter((e) => e.timestamp >= query.since!);\n    }\n\n    if (query.before) {\n      results = results.filter((e) => e.timestamp <= query.before!);\n    }\n\n    if (query.shareLevel) {\n      results = results.filter((e) => e.metadata.shareLevel === query.shareLevel);\n    }\n\n    // Sort by timestamp (newest first)\n    results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n\n    // Apply limit\n    if (query.limit) {\n      results = results.slice(0, query.limit);\n    }\n\n    this.logger.debug(`Recalled ${results.length} memories for query`);\n    return results;\n  }\n\n  async shareMemory(entryId: string, targetAgentId: string): Promise<void> {\n    const entry = this.entries.get(entryId);\n    if (!entry) {\n      throw new Error('Memory entry not found');\n    }\n\n    if (!this.config.enableCrossAgentSharing) {\n      throw new Error('Cross-agent sharing is disabled');\n    }\n\n    // Check share level permissions\n    if (entry.metadata.shareLevel === 'private') {\n      throw new Error('Memory entry is private and cannot be shared');\n    }\n\n    // Create a shared copy for the target agent\n    const sharedEntry: SwarmMemoryEntry = {\n      ...entry,\n      id: generateId('mem'),\n      metadata: {\n        ...entry.metadata,\n        originalId: entryId,\n        sharedFrom: entry.agentId,\n        sharedTo: targetAgentId,\n        sharedAt: new Date(),\n      },\n    };\n\n    this.entries.set(sharedEntry.id, sharedEntry);\n\n    // Associate with target agent\n    if (!this.agentMemories.has(targetAgentId)) {\n      this.agentMemories.set(targetAgentId, new Set());\n    }\n    this.agentMemories.get(targetAgentId)!.add(sharedEntry.id);\n\n    this.logger.info(`Shared memory ${entryId} from ${entry.agentId} to ${targetAgentId}`);\n    this.emit('memory:shared', { original: entry, shared: sharedEntry });\n  }\n\n  async broadcastMemory(entryId: string, agentIds?: string[]): Promise<void> {\n    const entry = this.entries.get(entryId);\n    if (!entry) {\n      throw new Error('Memory entry not found');\n    }\n\n    if (entry.metadata.shareLevel === 'private') {\n      throw new Error('Cannot broadcast private memory');\n    }\n\n    const targets =\n      agentIds || Array.from(this.agentMemories.keys()).filter((id) => id !== entry.agentId);\n\n    for (const targetId of targets) {\n      try {\n        await this.shareMemory(entryId, targetId);\n      } catch (error) {\n        this.logger.warn(`Failed to share memory to ${targetId}:`, error);\n      }\n    }\n\n    this.logger.info(`Broadcasted memory ${entryId} to ${targets.length} agents`);\n  }\n\n  async createKnowledgeBase(\n    name: string,\n    description: string,\n    domain: string,\n    expertise: string[],\n  ): Promise<string> {\n    const kbId = generateId('kb');\n    const knowledgeBase: SwarmKnowledgeBase = {\n      id: kbId,\n      name,\n      description,\n      entries: [],\n      metadata: {\n        domain,\n        expertise,\n        contributors: [],\n        lastUpdated: new Date(),\n      },\n    };\n\n    this.knowledgeBases.set(kbId, knowledgeBase);\n\n    this.logger.info(`Created knowledge base: ${name} (${kbId})`);\n    this.emit('knowledgebase:created', knowledgeBase);\n\n    return kbId;\n  }\n\n  async updateKnowledgeBase(entry: SwarmMemoryEntry): Promise<void> {\n    if (!this.config.enableKnowledgeBase) return;\n\n    // Find relevant knowledge bases\n    const relevantKBs = Array.from(this.knowledgeBases.values()).filter((kb) => {\n      // Simple matching based on tags and content\n      const tags = entry.metadata.tags || [];\n      return tags.some((tag) =>\n        kb.metadata.expertise.some(\n          (exp) =>\n            exp.toLowerCase().includes(tag.toLowerCase()) ||\n            tag.toLowerCase().includes(exp.toLowerCase()),\n        ),\n      );\n    });\n\n    for (const kb of relevantKBs) {\n      // Add entry to knowledge base\n      kb.entries.push(entry);\n      kb.metadata.lastUpdated = new Date();\n\n      // Add contributor\n      if (!kb.metadata.contributors.includes(entry.agentId)) {\n        kb.metadata.contributors.push(entry.agentId);\n      }\n\n      this.logger.debug(`Updated knowledge base ${kb.id} with entry ${entry.id}`);\n    }\n  }\n\n  async searchKnowledge(\n    query: string,\n    domain?: string,\n    expertise?: string[],\n  ): Promise<SwarmMemoryEntry[]> {\n    const allEntries: SwarmMemoryEntry[] = [];\n\n    // Search in knowledge bases\n    for (const kb of this.knowledgeBases.values()) {\n      if (domain && kb.metadata.domain !== domain) continue;\n\n      if (expertise && !expertise.some((exp) => kb.metadata.expertise.includes(exp))) {\n        continue;\n      }\n\n      allEntries.push(...kb.entries);\n    }\n\n    // Simple text search (in real implementation, use better search)\n    const queryLower = query.toLowerCase();\n    const results = allEntries.filter((entry) => {\n      const contentStr = JSON.stringify(entry.content).toLowerCase();\n      return contentStr.includes(queryLower);\n    });\n\n    return results.slice(0, 50); // Limit results\n  }\n\n  async getAgentMemorySnapshot(agentId: string): Promise<{\n    totalEntries: number;\n    recentEntries: SwarmMemoryEntry[];\n    knowledgeContributions: number;\n    sharedEntries: number;\n  }> {\n    const agentEntryIds = this.agentMemories.get(agentId) || new Set();\n    const agentEntries = Array.from(agentEntryIds)\n      .map((id) => this.entries.get(id))\n      .filter(Boolean) as SwarmMemoryEntry[];\n\n    const recentEntries = agentEntries\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())\n      .slice(0, 10);\n\n    const knowledgeContributions = agentEntries.filter((e) => e.type === 'knowledge').length;\n\n    const sharedEntries = agentEntries.filter(\n      (e) => e.metadata.shareLevel === 'public' || e.metadata.shareLevel === 'team',\n    ).length;\n\n    return {\n      totalEntries: agentEntries.length,\n      recentEntries,\n      knowledgeContributions,\n      sharedEntries,\n    };\n  }\n\n  private async loadMemoryState(): Promise<void> {\n    try {\n      // Load entries\n      const entriesFile = path.join(this.config.persistencePath, 'entries.json');\n      try {\n        const entriesData = await fs.readFile(entriesFile, 'utf-8');\n        const entriesArray = JSON.parse(entriesData);\n\n        for (const entry of entriesArray) {\n          this.entries.set(entry.id, {\n            ...entry,\n            timestamp: new Date(entry.timestamp),\n          });\n\n          // Rebuild agent memory associations\n          if (!this.agentMemories.has(entry.agentId)) {\n            this.agentMemories.set(entry.agentId, new Set());\n          }\n          this.agentMemories.get(entry.agentId)!.add(entry.id);\n        }\n\n        this.logger.info(`Loaded ${entriesArray.length} memory entries`);\n      } catch (error) {\n        this.logger.warn('No existing memory entries found');\n      }\n\n      // Load knowledge bases\n      const kbFile = path.join(this.config.persistencePath, 'knowledge-bases.json');\n      try {\n        const kbData = await fs.readFile(kbFile, 'utf-8');\n        const kbArray = JSON.parse(kbData);\n\n        for (const kb of kbArray) {\n          this.knowledgeBases.set(kb.id, {\n            ...kb,\n            metadata: {\n              ...kb.metadata,\n              lastUpdated: new Date(kb.metadata.lastUpdated),\n            },\n            entries: kb.entries.map((e: any) => ({\n              ...e,\n              timestamp: new Date(e.timestamp),\n            })),\n          });\n        }\n\n        this.logger.info(`Loaded ${kbArray.length} knowledge bases`);\n      } catch (error) {\n        this.logger.warn('No existing knowledge bases found');\n      }\n    } catch (error) {\n      this.logger.error('Error loading memory state:', error);\n    }\n  }\n\n  private async saveMemoryState(): Promise<void> {\n    try {\n      // Save entries\n      const entriesArray = Array.from(this.entries.values());\n      const entriesFile = path.join(this.config.persistencePath, 'entries.json');\n      await fs.writeFile(entriesFile, JSON.stringify(entriesArray, null, 2));\n\n      // Save knowledge bases\n      const kbArray = Array.from(this.knowledgeBases.values());\n      const kbFile = path.join(this.config.persistencePath, 'knowledge-bases.json');\n      await fs.writeFile(kbFile, JSON.stringify(kbArray, null, 2));\n\n      this.logger.debug('Saved memory state to disk');\n    } catch (error) {\n      this.logger.error('Error saving memory state:', error);\n    }\n  }\n\n  private async syncMemoryState(): Promise<void> {\n    try {\n      await this.saveMemoryState();\n      this.emit('memory:synced');\n    } catch (error) {\n      this.logger.error('Error syncing memory state:', error);\n    }\n  }\n\n  private async enforceMemoryLimits(): Promise<void> {\n    if (this.entries.size <= this.config.maxEntries) return;\n\n    this.logger.info('Enforcing memory limits...');\n\n    // Remove oldest entries that are not marked as important\n    const entries = Array.from(this.entries.values())\n      .filter((e) => (e.metadata.priority || 1) <= 1) // Only remove low priority\n      .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());\n\n    const toRemove = entries.slice(0, this.entries.size - this.config.maxEntries);\n\n    for (const entry of toRemove) {\n      this.entries.delete(entry.id);\n\n      // Remove from agent memory\n      const agentEntries = this.agentMemories.get(entry.agentId);\n      if (agentEntries) {\n        agentEntries.delete(entry.id);\n      }\n\n      this.logger.debug(`Removed old memory entry: ${entry.id}`);\n    }\n\n    this.emit('memory:cleaned', toRemove.length);\n  }\n\n  // Public API methods\n  getMemoryStats(): {\n    totalEntries: number;\n    entriesByType: Record<string, number>;\n    entriesByAgent: Record<string, number>;\n    knowledgeBases: number;\n    memoryUsage: number;\n  } {\n    const entries = Array.from(this.entries.values());\n    const entriesByType: Record<string, number> = {};\n    const entriesByAgent: Record<string, number> = {};\n\n    for (const entry of entries) {\n      entriesByType[entry.type] = (entriesByType[entry.type] || 0) + 1;\n      entriesByAgent[entry.agentId] = (entriesByAgent[entry.agentId] || 0) + 1;\n    }\n\n    // Rough memory usage calculation\n    const memoryUsage = JSON.stringify(entries).length;\n\n    return {\n      totalEntries: entries.length,\n      entriesByType,\n      entriesByAgent,\n      knowledgeBases: this.knowledgeBases.size,\n      memoryUsage,\n    };\n  }\n\n  async exportMemory(agentId?: string): Promise<any> {\n    const entries = agentId ? await this.recall({ agentId }) : Array.from(this.entries.values());\n\n    return {\n      entries,\n      knowledgeBases: agentId\n        ? Array.from(this.knowledgeBases.values()).filter((kb) =>\n            kb.metadata.contributors.includes(agentId),\n          )\n        : Array.from(this.knowledgeBases.values()),\n      exportedAt: new Date(),\n      stats: this.getMemoryStats(),\n    };\n  }\n\n  async clearMemory(agentId?: string): Promise<void> {\n    if (agentId) {\n      // Clear specific agent's memory\n      const entryIds = this.agentMemories.get(agentId) || new Set();\n      for (const entryId of entryIds) {\n        this.entries.delete(entryId);\n      }\n      this.agentMemories.delete(agentId);\n      this.logger.info(`Cleared memory for agent ${agentId}`);\n    } else {\n      // Clear all memory\n      this.entries.clear();\n      this.agentMemories.clear();\n      this.knowledgeBases.clear();\n      this.logger.info('Cleared all swarm memory');\n    }\n\n    this.emit('memory:cleared', { agentId });\n  }\n\n  // Compatibility methods for hive.ts\n  async store(key: string, value: any): Promise<void> {\n    // Extract namespace and actual key from the path\n    const parts = key.split('/');\n    const type = (parts[0] as SwarmMemoryEntry['type']) || 'state';\n    const agentId = parts[1] || 'system';\n\n    await this.remember(agentId, type, value, {\n      tags: [parts[0], parts[1]].filter(Boolean),\n      shareLevel: 'team',\n    });\n  }\n\n  async search(pattern: string, limit: number = 10): Promise<any[]> {\n    // Simple pattern matching on stored keys/content\n    const results: any[] = [];\n\n    for (const entry of this.entries.values()) {\n      const entryString = JSON.stringify(entry);\n      if (entryString.includes(pattern.replace('*', ''))) {\n        results.push(entry.content);\n        if (results.length >= limit) break;\n      }\n    }\n\n    return results;\n  }\n}\n"],"names":["EventEmitter","Logger","MemoryManager","EventBus","generateId","fs","path","SwarmMemoryManager","logger","config","baseMemory","entries","knowledgeBases","agentMemories","syncTimer","isInitialized","namespace","enableDistribution","enableReplication","syncInterval","maxEntries","compressionThreshold","enableKnowledgeBase","enableCrossAgentSharing","persistencePath","Map","eventBus","getInstance","backend","cacheSizeMB","syncOnExit","ttlMinutes","initialize","info","mkdir","recursive","loadMemoryState","setInterval","syncMemoryState","emit","shutdown","clearInterval","undefined","saveMemoryState","remember","agentId","type","content","metadata","entryId","entry","id","timestamp","Date","shareLevel","priority","set","has","Set","get","add","key","JSON","stringify","entryType","debug","updateKnowledgeBase","enforceMemoryLimits","recall","query","results","Array","from","values","filter","e","taskId","objectiveId","tags","length","some","tag","includes","since","before","sort","a","b","getTime","limit","slice","shareMemory","targetAgentId","Error","sharedEntry","originalId","sharedFrom","sharedTo","sharedAt","original","shared","broadcastMemory","agentIds","targets","keys","targetId","error","warn","createKnowledgeBase","name","description","domain","expertise","kbId","knowledgeBase","contributors","lastUpdated","relevantKBs","kb","exp","toLowerCase","push","searchKnowledge","allEntries","queryLower","contentStr","getAgentMemorySnapshot","agentEntryIds","agentEntries","map","Boolean","recentEntries","knowledgeContributions","sharedEntries","totalEntries","entriesFile","join","entriesData","readFile","entriesArray","parse","kbFile","kbData","kbArray","writeFile","size","toRemove","delete","getMemoryStats","entriesByType","entriesByAgent","memoryUsage","exportMemory","exportedAt","stats","clearMemory","entryIds","clear","store","value","parts","split","search","pattern","entryString","replace"],"mappings":"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"}

package/dist/src/utils/error-recovery.js

@@ -6,6 +6,33 @@ export function isNpmCacheError(error) {
     const errorStr = error?.message || String(error);
     return errorStr.includes('ENOTEMPTY') && (errorStr.includes('npm') || errorStr.includes('npx') || errorStr.includes('_npx')) || errorStr.includes('better-sqlite3');
 }
+export function isNativeModuleVersionError(error) {
+    const errorStr = error?.message || String(error);
+    return errorStr.includes('NODE_MODULE_VERSION') || errorStr.includes('was compiled against a different Node.js version') || errorStr.includes('re-compiling or re-installing the module');
+}
+export function getNativeModuleRecoveryMessage(error) {
+    const errorStr = error?.message || String(error);
+    const compiledMatch = errorStr.match(/NODE_MODULE_VERSION (\d+)/);
+    const requiredMatch = errorStr.match(/requires\s+NODE_MODULE_VERSION (\d+)/);
+    let message = '⚠️  Native module version mismatch detected.\n';
+    if (compiledMatch && requiredMatch) {
+        const nodeVersionMap = {
+            '108': '18.x',
+            '115': '20.x',
+            '120': '21.x',
+            '127': '22.x',
+            '131': '23.x'
+        };
+        const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;
+        const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;
+        message += `   Module was compiled for Node.js ${compiled}, but running Node.js ${required}.\n`;
+    }
+    message += '\n   To fix this, try one of:\n';
+    message += '   1. npm rebuild better-sqlite3\n';
+    message += '   2. rm -rf node_modules && npm install\n';
+    message += '   3. npx cache: rm -rf ~/.npm/_npx/ && run command again\n';
+    return message;
+}
 export function isWSL() {
     if (process.platform !== 'linux') {
         return false;
@@ -203,6 +230,8 @@ export async function recoverInitErrors(error) {
 }
 export const errorRecovery = {
     isNpmCacheError,
+    isNativeModuleVersionError,
+    getNativeModuleRecoveryMessage,
     isWSL,
     cleanNpmCache,
     retryWithRecovery,

package/dist/src/utils/error-recovery.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/error-recovery.ts"],"sourcesContent":["/**\n * Error Recovery Utilities\n * Automatic error detection and recovery for common installation issues\n */\n\nimport { execSync } from 'child_process';\nimport * as fs from 'fs-extra';\nimport * as path from 'path';\nimport * as os from 'os';\n\nexport interface RecoveryResult {\n  success: boolean;\n  action: string;\n  message: string;\n  recovered: boolean;\n}\n\nexport interface RetryOptions {\n  maxRetries?: number;\n  delay?: number;\n  onRetry?: (attempt: number, error: Error) => void;\n  cleanupFn?: () => Promise<void>;\n}\n\n/**\n * Detect if an error is the ENOTEMPTY npm cache error\n */\nexport function isNpmCacheError(error: any): boolean {\n  const errorStr = error?.message || String(error);\n  return (\n    errorStr.includes('ENOTEMPTY') &&\n    (errorStr.includes('npm') || errorStr.includes('npx') || errorStr.includes('_npx'))\n  ) || errorStr.includes('better-sqlite3');\n}\n\n/**\n * Detect if running on WSL (Windows Subsystem for Linux)\n */\nexport function isWSL(): boolean {\n  if (process.platform !== 'linux') {\n    return false;\n  }\n\n  try {\n    const release = fs.readFileSync('/proc/version', 'utf8').toLowerCase();\n    return release.includes('microsoft') || release.includes('wsl');\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Clean npm and npx cache directories\n */\nexport async function cleanNpmCache(): Promise<RecoveryResult> {\n  const homeDir = os.homedir();\n  const npxCacheDir = path.join(homeDir, '.npm', '_npx');\n\n  try {\n    console.log('🧹 Cleaning npm cache...');\n\n    // Clean npm cache\n    try {\n      execSync('npm cache clean --force', { stdio: 'pipe' });\n      console.log('✅ npm cache cleaned');\n    } catch (error) {\n      console.warn('⚠️  npm cache clean failed, continuing...');\n    }\n\n    // Remove npx cache directory\n    if (await fs.pathExists(npxCacheDir)) {\n      console.log(`🗑️  Removing npx cache: ${npxCacheDir}`);\n      await fs.remove(npxCacheDir);\n      console.log('✅ npx cache removed');\n    }\n\n    // Fix permissions on WSL\n    if (isWSL()) {\n      const npmDir = path.join(homeDir, '.npm');\n      if (await fs.pathExists(npmDir)) {\n        try {\n          execSync(`chmod -R 755 \"${npmDir}\"`, { stdio: 'pipe' });\n          console.log('✅ npm directory permissions fixed');\n        } catch (error) {\n          console.warn('⚠️  Permission fix failed, continuing...');\n        }\n      }\n    }\n\n    return {\n      success: true,\n      action: 'cache-cleanup',\n      message: 'npm/npx cache cleaned successfully',\n      recovered: true\n    };\n  } catch (error) {\n    return {\n      success: false,\n      action: 'cache-cleanup',\n      message: `Failed to clean cache: ${error instanceof Error ? error.message : String(error)}`,\n      recovered: false\n    };\n  }\n}\n\n/**\n * Automatic retry with exponential backoff and error recovery\n */\nexport async function retryWithRecovery<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const {\n    maxRetries = 3,\n    delay = 1000,\n    onRetry,\n    cleanupFn\n  } = options;\n\n  let lastError: Error | undefined;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n\n      // Check if it's a recoverable error\n      if (isNpmCacheError(error)) {\n        console.log(`\\n⚠️  Detected npm cache error (attempt ${attempt}/${maxRetries})`);\n\n        // Attempt automatic recovery\n        const recovery = await cleanNpmCache();\n        if (recovery.success) {\n          console.log('✅ Cache cleaned, retrying...\\n');\n\n          // Run custom cleanup if provided\n          if (cleanupFn) {\n            await cleanupFn();\n          }\n\n          // Exponential backoff\n          const backoffDelay = delay * Math.pow(2, attempt - 1);\n          await new Promise(resolve => setTimeout(resolve, backoffDelay));\n\n          continue; // Retry\n        } else {\n          console.error('❌ Cache cleanup failed:', recovery.message);\n        }\n      }\n\n      // Call retry callback\n      if (onRetry && attempt < maxRetries) {\n        onRetry(attempt, lastError);\n        await new Promise(resolve => setTimeout(resolve, delay));\n        continue;\n      }\n\n      // Last attempt failed\n      if (attempt === maxRetries) {\n        break;\n      }\n    }\n  }\n\n  // All retries exhausted\n  throw new Error(\n    `Operation failed after ${maxRetries} attempts. ` +\n    `Last error: ${lastError?.message || 'Unknown error'}`\n  );\n}\n\n/**\n * WSL-specific error recovery\n */\nexport async function recoverWSLErrors(): Promise<RecoveryResult> {\n  if (!isWSL()) {\n    return {\n      success: true,\n      action: 'wsl-check',\n      message: 'Not running on WSL, no recovery needed',\n      recovered: false\n    };\n  }\n\n  console.log('🔍 Detected WSL environment, applying fixes...');\n\n  try {\n    const homeDir = os.homedir();\n\n    // Check if running from Windows mount\n    const cwd = process.cwd();\n    if (cwd.startsWith('/mnt/')) {\n      console.warn('⚠️  WARNING: Running from Windows filesystem (/mnt/)');\n      console.warn('   For best results, run from WSL filesystem (e.g., ~/projects/)');\n    }\n\n    // Ensure build tools are available\n    try {\n      execSync('which gcc', { stdio: 'pipe' });\n    } catch {\n      console.warn('⚠️  build-essential not found. Install with:');\n      console.warn('   sudo apt-get update && sudo apt-get install -y build-essential python3');\n    }\n\n    // Clean cache with WSL-specific handling\n    return await cleanNpmCache();\n  } catch (error) {\n    return {\n      success: false,\n      action: 'wsl-recovery',\n      message: `WSL recovery failed: ${error instanceof Error ? error.message : String(error)}`,\n      recovered: false\n    };\n  }\n}\n\n/**\n * Verify better-sqlite3 installation\n */\nexport async function verifyBetterSqlite3(): Promise<boolean> {\n  try {\n    require.resolve('better-sqlite3');\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Install better-sqlite3 with retry and error recovery\n */\nexport async function installBetterSqlite3WithRecovery(): Promise<RecoveryResult> {\n  console.log('📦 Installing better-sqlite3...');\n\n  return retryWithRecovery(\n    async () => {\n      execSync('npm install better-sqlite3 --no-save', {\n        stdio: 'inherit',\n        cwd: process.cwd()\n      });\n\n      // Verify installation\n      if (await verifyBetterSqlite3()) {\n        return {\n          success: true,\n          action: 'install-sqlite',\n          message: 'better-sqlite3 installed successfully',\n          recovered: true\n        };\n      } else {\n        throw new Error('Installation completed but module not found');\n      }\n    },\n    {\n      maxRetries: 3,\n      delay: 2000,\n      onRetry: (attempt, error) => {\n        console.log(`⚠️  Install attempt ${attempt} failed: ${error.message}`);\n        console.log('🔄 Cleaning cache and retrying...');\n      }\n    }\n  );\n}\n\n/**\n * Comprehensive error recovery for initialization\n */\nexport async function recoverInitErrors(error: any): Promise<RecoveryResult> {\n  console.log('\\n🚨 Error detected during initialization');\n  console.log(`   Error: ${error?.message || String(error)}\\n`);\n\n  // WSL-specific recovery\n  if (isWSL()) {\n    console.log('🔧 Applying WSL-specific fixes...');\n    const wslRecovery = await recoverWSLErrors();\n    if (!wslRecovery.success) {\n      return wslRecovery;\n    }\n  }\n\n  // npm cache error recovery\n  if (isNpmCacheError(error)) {\n    console.log('🔧 Detected npm cache error, attempting recovery...');\n    const cacheRecovery = await cleanNpmCache();\n    if (!cacheRecovery.success) {\n      return cacheRecovery;\n    }\n\n    // Try to reinstall better-sqlite3\n    if (!await verifyBetterSqlite3()) {\n      console.log('🔧 better-sqlite3 missing, attempting reinstall...');\n      return await installBetterSqlite3WithRecovery();\n    }\n\n    return {\n      success: true,\n      action: 'error-recovery',\n      message: 'Cache cleaned and dependencies verified',\n      recovered: true\n    };\n  }\n\n  // Generic error handling\n  return {\n    success: false,\n    action: 'error-recovery',\n    message: `Unable to automatically recover from error: ${error?.message || String(error)}`,\n    recovered: false\n  };\n}\n\n/**\n * Export utility functions\n */\nexport const errorRecovery = {\n  isNpmCacheError,\n  isWSL,\n  cleanNpmCache,\n  retryWithRecovery,\n  recoverWSLErrors,\n  verifyBetterSqlite3,\n  installBetterSqlite3WithRecovery,\n  recoverInitErrors\n};\n"],"names":["execSync","fs","path","os","isNpmCacheError","error","errorStr","message","String","includes","isWSL","process","platform","release","readFileSync","toLowerCase","cleanNpmCache","homeDir","homedir","npxCacheDir","join","console","log","stdio","warn","pathExists","remove","npmDir","success","action","recovered","Error","retryWithRecovery","fn","options","maxRetries","delay","onRetry","cleanupFn","lastError","attempt","recovery","backoffDelay","Math","pow","Promise","resolve","setTimeout","recoverWSLErrors","cwd","startsWith","verifyBetterSqlite3","require","installBetterSqlite3WithRecovery","recoverInitErrors","wslRecovery","cacheRecovery","errorRecovery"],"mappings":"AAKA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,YAAYC,QAAQ,WAAW;AAC/B,YAAYC,UAAU,OAAO;AAC7B,YAAYC,QAAQ,KAAK;AAmBzB,OAAO,SAASC,gBAAgBC,KAAU;IACxC,MAAMC,WAAWD,OAAOE,WAAWC,OAAOH;IAC1C,OAAO,AACLC,SAASG,QAAQ,CAAC,gBACjBH,CAAAA,SAASG,QAAQ,CAAC,UAAUH,SAASG,QAAQ,CAAC,UAAUH,SAASG,QAAQ,CAAC,OAAM,KAC9EH,SAASG,QAAQ,CAAC;AACzB;AAKA,OAAO,SAASC;IACd,IAAIC,QAAQC,QAAQ,KAAK,SAAS;QAChC,OAAO;IACT;IAEA,IAAI;QACF,MAAMC,UAAUZ,GAAGa,YAAY,CAAC,iBAAiB,QAAQC,WAAW;QACpE,OAAOF,QAAQJ,QAAQ,CAAC,gBAAgBI,QAAQJ,QAAQ,CAAC;IAC3D,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAKA,OAAO,eAAeO;IACpB,MAAMC,UAAUd,GAAGe,OAAO;IAC1B,MAAMC,cAAcjB,KAAKkB,IAAI,CAACH,SAAS,QAAQ;IAE/C,IAAI;QACFI,QAAQC,GAAG,CAAC;QAGZ,IAAI;YACFtB,SAAS,2BAA2B;gBAAEuB,OAAO;YAAO;YACpDF,QAAQC,GAAG,CAAC;QACd,EAAE,OAAOjB,OAAO;YACdgB,QAAQG,IAAI,CAAC;QACf;QAGA,IAAI,MAAMvB,GAAGwB,UAAU,CAACN,cAAc;YACpCE,QAAQC,GAAG,CAAC,CAAC,yBAAyB,EAAEH,aAAa;YACrD,MAAMlB,GAAGyB,MAAM,CAACP;YAChBE,QAAQC,GAAG,CAAC;QACd;QAGA,IAAIZ,SAAS;YACX,MAAMiB,SAASzB,KAAKkB,IAAI,CAACH,SAAS;YAClC,IAAI,MAAMhB,GAAGwB,UAAU,CAACE,SAAS;gBAC/B,IAAI;oBACF3B,SAAS,CAAC,cAAc,EAAE2B,OAAO,CAAC,CAAC,EAAE;wBAAEJ,OAAO;oBAAO;oBACrDF,QAAQC,GAAG,CAAC;gBACd,EAAE,OAAOjB,OAAO;oBACdgB,QAAQG,IAAI,CAAC;gBACf;YACF;QACF;QAEA,OAAO;YACLI,SAAS;YACTC,QAAQ;YACRtB,SAAS;YACTuB,WAAW;QACb;IACF,EAAE,OAAOzB,OAAO;QACd,OAAO;YACLuB,SAAS;YACTC,QAAQ;YACRtB,SAAS,CAAC,uBAAuB,EAAEF,iBAAiB0B,QAAQ1B,MAAME,OAAO,GAAGC,OAAOH,QAAQ;YAC3FyB,WAAW;QACb;IACF;AACF;AAKA,OAAO,eAAeE,kBACpBC,EAAoB,EACpBC,UAAwB,CAAC,CAAC;IAE1B,MAAM,EACJC,aAAa,CAAC,EACdC,QAAQ,IAAI,EACZC,OAAO,EACPC,SAAS,EACV,GAAGJ;IAEJ,IAAIK;IAEJ,IAAK,IAAIC,UAAU,GAAGA,WAAWL,YAAYK,UAAW;QACtD,IAAI;YACF,OAAO,MAAMP;QACf,EAAE,OAAO5B,OAAO;YACdkC,YAAYlC;YAGZ,IAAID,gBAAgBC,QAAQ;gBAC1BgB,QAAQC,GAAG,CAAC,CAAC,wCAAwC,EAAEkB,QAAQ,CAAC,EAAEL,WAAW,CAAC,CAAC;gBAG/E,MAAMM,WAAW,MAAMzB;gBACvB,IAAIyB,SAASb,OAAO,EAAE;oBACpBP,QAAQC,GAAG,CAAC;oBAGZ,IAAIgB,WAAW;wBACb,MAAMA;oBACR;oBAGA,MAAMI,eAAeN,QAAQO,KAAKC,GAAG,CAAC,GAAGJ,UAAU;oBACnD,MAAM,IAAIK,QAAQC,CAAAA,UAAWC,WAAWD,SAASJ;oBAEjD;gBACF,OAAO;oBACLrB,QAAQhB,KAAK,CAAC,2BAA2BoC,SAASlC,OAAO;gBAC3D;YACF;YAGA,IAAI8B,WAAWG,UAAUL,YAAY;gBACnCE,QAAQG,SAASD;gBACjB,MAAM,IAAIM,QAAQC,CAAAA,UAAWC,WAAWD,SAASV;gBACjD;YACF;YAGA,IAAII,YAAYL,YAAY;gBAC1B;YACF;QACF;IACF;IAGA,MAAM,IAAIJ,MACR,CAAC,uBAAuB,EAAEI,WAAW,WAAW,CAAC,GACjD,CAAC,YAAY,EAAEI,WAAWhC,WAAW,iBAAiB;AAE1D;AAKA,OAAO,eAAeyC;IACpB,IAAI,CAACtC,SAAS;QACZ,OAAO;YACLkB,SAAS;YACTC,QAAQ;YACRtB,SAAS;YACTuB,WAAW;QACb;IACF;IAEAT,QAAQC,GAAG,CAAC;IAEZ,IAAI;QACF,MAAML,UAAUd,GAAGe,OAAO;QAG1B,MAAM+B,MAAMtC,QAAQsC,GAAG;QACvB,IAAIA,IAAIC,UAAU,CAAC,UAAU;YAC3B7B,QAAQG,IAAI,CAAC;YACbH,QAAQG,IAAI,CAAC;QACf;QAGA,IAAI;YACFxB,SAAS,aAAa;gBAAEuB,OAAO;YAAO;QACxC,EAAE,OAAM;YACNF,QAAQG,IAAI,CAAC;YACbH,QAAQG,IAAI,CAAC;QACf;QAGA,OAAO,MAAMR;IACf,EAAE,OAAOX,OAAO;QACd,OAAO;YACLuB,SAAS;YACTC,QAAQ;YACRtB,SAAS,CAAC,qBAAqB,EAAEF,iBAAiB0B,QAAQ1B,MAAME,OAAO,GAAGC,OAAOH,QAAQ;YACzFyB,WAAW;QACb;IACF;AACF;AAKA,OAAO,eAAeqB;IACpB,IAAI;QACFC,QAAQN,OAAO,CAAC;QAChB,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAKA,OAAO,eAAeO;IACpBhC,QAAQC,GAAG,CAAC;IAEZ,OAAOU,kBACL;QACEhC,SAAS,wCAAwC;YAC/CuB,OAAO;YACP0B,KAAKtC,QAAQsC,GAAG;QAClB;QAGA,IAAI,MAAME,uBAAuB;YAC/B,OAAO;gBACLvB,SAAS;gBACTC,QAAQ;gBACRtB,SAAS;gBACTuB,WAAW;YACb;QACF,OAAO;YACL,MAAM,IAAIC,MAAM;QAClB;IACF,GACA;QACEI,YAAY;QACZC,OAAO;QACPC,SAAS,CAACG,SAASnC;YACjBgB,QAAQC,GAAG,CAAC,CAAC,oBAAoB,EAAEkB,QAAQ,SAAS,EAAEnC,MAAME,OAAO,EAAE;YACrEc,QAAQC,GAAG,CAAC;QACd;IACF;AAEJ;AAKA,OAAO,eAAegC,kBAAkBjD,KAAU;IAChDgB,QAAQC,GAAG,CAAC;IACZD,QAAQC,GAAG,CAAC,CAAC,UAAU,EAAEjB,OAAOE,WAAWC,OAAOH,OAAO,EAAE,CAAC;IAG5D,IAAIK,SAAS;QACXW,QAAQC,GAAG,CAAC;QACZ,MAAMiC,cAAc,MAAMP;QAC1B,IAAI,CAACO,YAAY3B,OAAO,EAAE;YACxB,OAAO2B;QACT;IACF;IAGA,IAAInD,gBAAgBC,QAAQ;QAC1BgB,QAAQC,GAAG,CAAC;QACZ,MAAMkC,gBAAgB,MAAMxC;QAC5B,IAAI,CAACwC,cAAc5B,OAAO,EAAE;YAC1B,OAAO4B;QACT;QAGA,IAAI,CAAC,MAAML,uBAAuB;YAChC9B,QAAQC,GAAG,CAAC;YACZ,OAAO,MAAM+B;QACf;QAEA,OAAO;YACLzB,SAAS;YACTC,QAAQ;YACRtB,SAAS;YACTuB,WAAW;QACb;IACF;IAGA,OAAO;QACLF,SAAS;QACTC,QAAQ;QACRtB,SAAS,CAAC,4CAA4C,EAAEF,OAAOE,WAAWC,OAAOH,QAAQ;QACzFyB,WAAW;IACb;AACF;AAKA,OAAO,MAAM2B,gBAAgB;IAC3BrD;IACAM;IACAM;IACAgB;IACAgB;IACAG;IACAE;IACAC;AACF,EAAE"}
+{"version":3,"sources":["../../../src/utils/error-recovery.ts"],"sourcesContent":["/**\n * Error Recovery Utilities\n * Automatic error detection and recovery for common installation issues\n */\n\nimport { execSync } from 'child_process';\nimport * as fs from 'fs-extra';\nimport * as path from 'path';\nimport * as os from 'os';\n\nexport interface RecoveryResult {\n  success: boolean;\n  action: string;\n  message: string;\n  recovered: boolean;\n}\n\nexport interface RetryOptions {\n  maxRetries?: number;\n  delay?: number;\n  onRetry?: (attempt: number, error: Error) => void;\n  cleanupFn?: () => Promise<void>;\n}\n\n/**\n * Detect if an error is the ENOTEMPTY npm cache error\n */\nexport function isNpmCacheError(error: any): boolean {\n  const errorStr = error?.message || String(error);\n  return (\n    errorStr.includes('ENOTEMPTY') &&\n    (errorStr.includes('npm') || errorStr.includes('npx') || errorStr.includes('_npx'))\n  ) || errorStr.includes('better-sqlite3');\n}\n\n/**\n * Detect if an error is a native module version mismatch (NODE_MODULE_VERSION)\n * This happens when native modules are compiled for a different Node.js version\n */\nexport function isNativeModuleVersionError(error: any): boolean {\n  const errorStr = error?.message || String(error);\n  return (\n    errorStr.includes('NODE_MODULE_VERSION') ||\n    errorStr.includes('was compiled against a different Node.js version') ||\n    errorStr.includes('re-compiling or re-installing the module')\n  );\n}\n\n/**\n * Get helpful message for native module version mismatch\n */\nexport function getNativeModuleRecoveryMessage(error: any): string {\n  const errorStr = error?.message || String(error);\n\n  // Extract version numbers if available\n  const compiledMatch = errorStr.match(/NODE_MODULE_VERSION (\\d+)/);\n  const requiredMatch = errorStr.match(/requires\\s+NODE_MODULE_VERSION (\\d+)/);\n\n  let message = '⚠️  Native module version mismatch detected.\\n';\n\n  if (compiledMatch && requiredMatch) {\n    const nodeVersionMap: Record<string, string> = {\n      '108': '18.x',\n      '115': '20.x',\n      '120': '21.x',\n      '127': '22.x',\n      '131': '23.x'\n    };\n    const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;\n    const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;\n    message += `   Module was compiled for Node.js ${compiled}, but running Node.js ${required}.\\n`;\n  }\n\n  message += '\\n   To fix this, try one of:\\n';\n  message += '   1. npm rebuild better-sqlite3\\n';\n  message += '   2. rm -rf node_modules && npm install\\n';\n  message += '   3. npx cache: rm -rf ~/.npm/_npx/ && run command again\\n';\n\n  return message;\n}\n\n/**\n * Detect if running on WSL (Windows Subsystem for Linux)\n */\nexport function isWSL(): boolean {\n  if (process.platform !== 'linux') {\n    return false;\n  }\n\n  try {\n    const release = fs.readFileSync('/proc/version', 'utf8').toLowerCase();\n    return release.includes('microsoft') || release.includes('wsl');\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Clean npm and npx cache directories\n */\nexport async function cleanNpmCache(): Promise<RecoveryResult> {\n  const homeDir = os.homedir();\n  const npxCacheDir = path.join(homeDir, '.npm', '_npx');\n\n  try {\n    console.log('🧹 Cleaning npm cache...');\n\n    // Clean npm cache\n    try {\n      execSync('npm cache clean --force', { stdio: 'pipe' });\n      console.log('✅ npm cache cleaned');\n    } catch (error) {\n      console.warn('⚠️  npm cache clean failed, continuing...');\n    }\n\n    // Remove npx cache directory\n    if (await fs.pathExists(npxCacheDir)) {\n      console.log(`🗑️  Removing npx cache: ${npxCacheDir}`);\n      await fs.remove(npxCacheDir);\n      console.log('✅ npx cache removed');\n    }\n\n    // Fix permissions on WSL\n    if (isWSL()) {\n      const npmDir = path.join(homeDir, '.npm');\n      if (await fs.pathExists(npmDir)) {\n        try {\n          execSync(`chmod -R 755 \"${npmDir}\"`, { stdio: 'pipe' });\n          console.log('✅ npm directory permissions fixed');\n        } catch (error) {\n          console.warn('⚠️  Permission fix failed, continuing...');\n        }\n      }\n    }\n\n    return {\n      success: true,\n      action: 'cache-cleanup',\n      message: 'npm/npx cache cleaned successfully',\n      recovered: true\n    };\n  } catch (error) {\n    return {\n      success: false,\n      action: 'cache-cleanup',\n      message: `Failed to clean cache: ${error instanceof Error ? error.message : String(error)}`,\n      recovered: false\n    };\n  }\n}\n\n/**\n * Automatic retry with exponential backoff and error recovery\n */\nexport async function retryWithRecovery<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const {\n    maxRetries = 3,\n    delay = 1000,\n    onRetry,\n    cleanupFn\n  } = options;\n\n  let lastError: Error | undefined;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n\n      // Check if it's a recoverable error\n      if (isNpmCacheError(error)) {\n        console.log(`\\n⚠️  Detected npm cache error (attempt ${attempt}/${maxRetries})`);\n\n        // Attempt automatic recovery\n        const recovery = await cleanNpmCache();\n        if (recovery.success) {\n          console.log('✅ Cache cleaned, retrying...\\n');\n\n          // Run custom cleanup if provided\n          if (cleanupFn) {\n            await cleanupFn();\n          }\n\n          // Exponential backoff\n          const backoffDelay = delay * Math.pow(2, attempt - 1);\n          await new Promise(resolve => setTimeout(resolve, backoffDelay));\n\n          continue; // Retry\n        } else {\n          console.error('❌ Cache cleanup failed:', recovery.message);\n        }\n      }\n\n      // Call retry callback\n      if (onRetry && attempt < maxRetries) {\n        onRetry(attempt, lastError);\n        await new Promise(resolve => setTimeout(resolve, delay));\n        continue;\n      }\n\n      // Last attempt failed\n      if (attempt === maxRetries) {\n        break;\n      }\n    }\n  }\n\n  // All retries exhausted\n  throw new Error(\n    `Operation failed after ${maxRetries} attempts. ` +\n    `Last error: ${lastError?.message || 'Unknown error'}`\n  );\n}\n\n/**\n * WSL-specific error recovery\n */\nexport async function recoverWSLErrors(): Promise<RecoveryResult> {\n  if (!isWSL()) {\n    return {\n      success: true,\n      action: 'wsl-check',\n      message: 'Not running on WSL, no recovery needed',\n      recovered: false\n    };\n  }\n\n  console.log('🔍 Detected WSL environment, applying fixes...');\n\n  try {\n    const homeDir = os.homedir();\n\n    // Check if running from Windows mount\n    const cwd = process.cwd();\n    if (cwd.startsWith('/mnt/')) {\n      console.warn('⚠️  WARNING: Running from Windows filesystem (/mnt/)');\n      console.warn('   For best results, run from WSL filesystem (e.g., ~/projects/)');\n    }\n\n    // Ensure build tools are available\n    try {\n      execSync('which gcc', { stdio: 'pipe' });\n    } catch {\n      console.warn('⚠️  build-essential not found. Install with:');\n      console.warn('   sudo apt-get update && sudo apt-get install -y build-essential python3');\n    }\n\n    // Clean cache with WSL-specific handling\n    return await cleanNpmCache();\n  } catch (error) {\n    return {\n      success: false,\n      action: 'wsl-recovery',\n      message: `WSL recovery failed: ${error instanceof Error ? error.message : String(error)}`,\n      recovered: false\n    };\n  }\n}\n\n/**\n * Verify better-sqlite3 installation\n */\nexport async function verifyBetterSqlite3(): Promise<boolean> {\n  try {\n    require.resolve('better-sqlite3');\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Install better-sqlite3 with retry and error recovery\n */\nexport async function installBetterSqlite3WithRecovery(): Promise<RecoveryResult> {\n  console.log('📦 Installing better-sqlite3...');\n\n  return retryWithRecovery(\n    async () => {\n      execSync('npm install better-sqlite3 --no-save', {\n        stdio: 'inherit',\n        cwd: process.cwd()\n      });\n\n      // Verify installation\n      if (await verifyBetterSqlite3()) {\n        return {\n          success: true,\n          action: 'install-sqlite',\n          message: 'better-sqlite3 installed successfully',\n          recovered: true\n        };\n      } else {\n        throw new Error('Installation completed but module not found');\n      }\n    },\n    {\n      maxRetries: 3,\n      delay: 2000,\n      onRetry: (attempt, error) => {\n        console.log(`⚠️  Install attempt ${attempt} failed: ${error.message}`);\n        console.log('🔄 Cleaning cache and retrying...');\n      }\n    }\n  );\n}\n\n/**\n * Comprehensive error recovery for initialization\n */\nexport async function recoverInitErrors(error: any): Promise<RecoveryResult> {\n  console.log('\\n🚨 Error detected during initialization');\n  console.log(`   Error: ${error?.message || String(error)}\\n`);\n\n  // WSL-specific recovery\n  if (isWSL()) {\n    console.log('🔧 Applying WSL-specific fixes...');\n    const wslRecovery = await recoverWSLErrors();\n    if (!wslRecovery.success) {\n      return wslRecovery;\n    }\n  }\n\n  // npm cache error recovery\n  if (isNpmCacheError(error)) {\n    console.log('🔧 Detected npm cache error, attempting recovery...');\n    const cacheRecovery = await cleanNpmCache();\n    if (!cacheRecovery.success) {\n      return cacheRecovery;\n    }\n\n    // Try to reinstall better-sqlite3\n    if (!await verifyBetterSqlite3()) {\n      console.log('🔧 better-sqlite3 missing, attempting reinstall...');\n      return await installBetterSqlite3WithRecovery();\n    }\n\n    return {\n      success: true,\n      action: 'error-recovery',\n      message: 'Cache cleaned and dependencies verified',\n      recovered: true\n    };\n  }\n\n  // Generic error handling\n  return {\n    success: false,\n    action: 'error-recovery',\n    message: `Unable to automatically recover from error: ${error?.message || String(error)}`,\n    recovered: false\n  };\n}\n\n/**\n * Export utility functions\n */\nexport const errorRecovery = {\n  isNpmCacheError,\n  isNativeModuleVersionError,\n  getNativeModuleRecoveryMessage,\n  isWSL,\n  cleanNpmCache,\n  retryWithRecovery,\n  recoverWSLErrors,\n  verifyBetterSqlite3,\n  installBetterSqlite3WithRecovery,\n  recoverInitErrors\n};\n"],"names":["execSync","fs","path","os","isNpmCacheError","error","errorStr","message","String","includes","isNativeModuleVersionError","getNativeModuleRecoveryMessage","compiledMatch","match","requiredMatch","nodeVersionMap","compiled","required","isWSL","process","platform","release","readFileSync","toLowerCase","cleanNpmCache","homeDir","homedir","npxCacheDir","join","console","log","stdio","warn","pathExists","remove","npmDir","success","action","recovered","Error","retryWithRecovery","fn","options","maxRetries","delay","onRetry","cleanupFn","lastError","attempt","recovery","backoffDelay","Math","pow","Promise","resolve","setTimeout","recoverWSLErrors","cwd","startsWith","verifyBetterSqlite3","require","installBetterSqlite3WithRecovery","recoverInitErrors","wslRecovery","cacheRecovery","errorRecovery"],"mappings":"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"}

package/dist/src/utils/metrics-reader.js

@@ -166,14 +166,4 @@ export class MetricsReader {
     }
 }
 
-//# sourceMappingURL=metrics-reader.js.map               processCount: 0,
-                orchestratorRunning: false,
-                port: null,
-                connections: 0
-            };
-        }
-    }
-};
-export { MetricsReader };
-
 //# sourceMappingURL=metrics-reader.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "2.7.42",
+  "version": "2.7.44",
   "description": "Enterprise-grade AI agent orchestration with WASM-powered ReasoningBank memory and AgentDB vector database (always uses latest agentic-flow)",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": "cli.mjs",

package/src/cli/simple-commands/hooks.js

@@ -6,15 +6,45 @@ import {
   checkRuvSwarmAvailable,
 } from '../utils.js';
 import { SqliteMemoryStore } from '../../memory/sqlite-store.js';
+import { InMemoryStore } from '../../memory/in-memory-store.js';
 
 // Initialize memory store
 let memoryStore = null;
+let storeInitFailed = false;
 
 async function getMemoryStore() {
-  if (!memoryStore) {
+  if (memoryStore) return memoryStore;
+
+  // If we already failed, return a working in-memory store
+  if (storeInitFailed) {
+    if (!memoryStore) {
+      memoryStore = new InMemoryStore();
+      await memoryStore.initialize();
+    }
+    return memoryStore;
+  }
+
+  try {
     memoryStore = new SqliteMemoryStore();
     await memoryStore.initialize();
+  } catch (err) {
+    // Check if it's a native module error (NODE_MODULE_VERSION mismatch)
+    const isNativeModuleError =
+      err.message?.includes('NODE_MODULE_VERSION') ||
+      err.message?.includes('was compiled against a different Node.js version') ||
+      err.message?.includes('better-sqlite3') ||
+      err.message?.includes('SQLite is not available');
+
+    if (isNativeModuleError) {
+      printWarning(`SQLite unavailable, using in-memory storage for hooks (data won't persist)`);
+      storeInitFailed = true;
+      memoryStore = new InMemoryStore();
+      await memoryStore.initialize();
+    } else {
+      throw err;
+    }
   }
+
   return memoryStore;
 }
 

package/src/core/DatabaseManager.ts

@@ -6,6 +6,21 @@
 import * as fs from 'fs-extra';
 import * as path from 'path';
 import { IDatabaseProvider } from '../types/interfaces.js';
+import { isNativeModuleVersionError, getNativeModuleRecoveryMessage } from '../utils/error-recovery.js';
+
+/**
+ * Custom error class for native module issues
+ */
+export class NativeModuleError extends Error {
+  public readonly originalError: Error;
+  public readonly isNativeModuleError = true;
+
+  constructor(message: string, originalError: Error) {
+    super(message);
+    this.name = 'NativeModuleError';
+    this.originalError = originalError;
+  }
+}
 
 export class DatabaseManager implements IDatabaseProvider {
   private provider: IDatabaseProvider;
@@ -36,12 +51,17 @@ export class DatabaseManager implements IDatabaseProvider {
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
 
+      // Check for native module version mismatch (NODE_MODULE_VERSION error)
+      if (error instanceof NativeModuleError || isNativeModuleVersionError(error)) {
+        console.warn('\n' + (error instanceof NativeModuleError ? error.message : getNativeModuleRecoveryMessage(error)));
+        console.warn('   Falling back to JSON storage (no data loss, just slower).\n');
+      }
       // Check if it's an npm cache error
-      if (errorMsg.includes('ENOTEMPTY') || errorMsg.includes('better-sqlite3')) {
+      else if (errorMsg.includes('ENOTEMPTY') || errorMsg.includes('better-sqlite3')) {
         console.warn('⚠️  SQLite initialization failed due to npm cache error');
         console.warn('   Will attempt automatic recovery during initialize()');
       } else {
-        console.warn('SQLite not available, falling back to JSON storage:', error);
+        console.warn('SQLite not available, falling back to JSON storage:', errorMsg);
       }
 
       // Fallback to JSON for now
@@ -177,6 +197,11 @@ class SQLiteProvider implements IDatabaseProvider {
       const Database = require('better-sqlite3');
       this.db = new Database(dbPath);
     } catch (error) {
+      // Check for native module version mismatch (NODE_MODULE_VERSION error)
+      if (isNativeModuleVersionError(error)) {
+        const recoveryMsg = getNativeModuleRecoveryMessage(error);
+        throw new NativeModuleError(recoveryMsg, error as Error);
+      }
       throw new Error('better-sqlite3 not available. Install with: npm install better-sqlite3');
     }
   }

package/src/memory/in-memory-store.js

@@ -20,11 +20,13 @@ class InMemoryStore {
     this.data.set('default', new Map());
 
     // Start cleanup interval for expired entries
+    // Use unref() so the interval doesn't prevent process exit
     this.cleanupInterval = setInterval(() => {
       this.cleanup().catch((err) =>
         console.error(`[${new Date().toISOString()}] ERROR [in-memory-store] Cleanup failed:`, err),
       );
     }, 60000); // Run cleanup every minute
+    this.cleanupInterval.unref(); // Don't keep process alive just for cleanup
 
     this.isInitialized = true;
     console.error(

package/src/memory/sqlite-wrapper.js

@@ -33,35 +33,79 @@ async function tryLoadSQLite() {
       return true;
     } catch (importErr) {
       loadError = importErr;
-      
-      // Check for specific Windows errors
-      if (requireErr.message.includes('was compiled against a different Node.js version') ||
-          requireErr.message.includes('Could not locate the bindings file') ||
-          requireErr.message.includes('The specified module could not be found') ||
+
+      // Check for NODE_MODULE_VERSION mismatch (different Node.js ABI)
+      const isVersionMismatch =
+        requireErr.message?.includes('NODE_MODULE_VERSION') ||
+        importErr.message?.includes('NODE_MODULE_VERSION') ||
+        requireErr.message?.includes('was compiled against a different Node.js version') ||
+        importErr.message?.includes('was compiled against a different Node.js version');
+
+      if (isVersionMismatch) {
+        // Extract version info for helpful message
+        const errorMsg = requireErr.message || importErr.message || '';
+        const compiledMatch = errorMsg.match(/NODE_MODULE_VERSION (\d+)/);
+        const requiredMatch = errorMsg.match(/requires\s+NODE_MODULE_VERSION (\d+)/);
+
+        const nodeVersionMap = {
+          '108': '18.x', '115': '20.x', '120': '21.x', '127': '22.x', '131': '23.x'
+        };
+
+        let versionInfo = '';
+        if (compiledMatch && requiredMatch) {
+          const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;
+          const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;
+          versionInfo = `\n║  Module compiled for Node.js ${compiled}, running Node.js ${required}`.padEnd(79) + '║';
+        }
+
+        console.warn(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║              Native Module Version Mismatch (NODE_MODULE_VERSION)            ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  The better-sqlite3 module was compiled for a different Node.js version.    ║${versionInfo}
+║                                                                              ║
+║  Claude Flow will continue with JSON fallback storage (still works fine).   ║
+║                                                                              ║
+║  To fix this and use SQLite:                                                 ║
+║                                                                              ║
+║  Option 1 - Rebuild the module:                                              ║
+║  > npm rebuild better-sqlite3                                                ║
+║                                                                              ║
+║  Option 2 - Clear npx cache (if using npx):                                  ║
+║  > rm -rf ~/.npm/_npx/ && npx claude-flow@alpha ...                         ║
+║                                                                              ║
+║  Option 3 - Reinstall dependencies:                                         ║
+║  > rm -rf node_modules && npm install                                        ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+`);
+        return false;
+      }
+
+      // Check for other Windows/installation errors
+      if (requireErr.message?.includes('Could not locate the bindings file') ||
+          requireErr.message?.includes('The specified module could not be found') ||
           requireErr.code === 'MODULE_NOT_FOUND') {
-        
+
         console.warn(`
 ╔══════════════════════════════════════════════════════════════════════════════╗
-║                     Windows SQLite Installation Issue                         ║
+║                     SQLite Native Module Installation Issue                   ║
 ╠══════════════════════════════════════════════════════════════════════════════╣
 ║                                                                              ║
 ║  The native SQLite module failed to load. This is common on Windows when    ║
-║  using 'npx' or when node-gyp build tools are not available.               ║
-║                                                                              ║
-║  Claude Flow will continue with in-memory storage (non-persistent).         ║
+║  using 'npx' or when node-gyp build tools are not available.                ║
 ║                                                                              ║
-║  To enable persistent storage on Windows:                                    ║
+║  Claude Flow will continue with JSON fallback storage (still works fine).   ║
 ║                                                                              ║
-║  Option 1 - Install Windows Build Tools:                                    ║
-║  > npm install --global windows-build-tools                                 ║
-║  > npm install claude-flow@alpha                                           ║
+║  To enable SQLite storage:                                                   ║
 ║                                                                              ║
-║  Option 2 - Use Pre-built Binaries:                                        ║
-║  > npm config set python python3                                           ║
-║  > npm install claude-flow@alpha --build-from-source=false                 ║
+║  Option 1 - Install Build Tools (Windows):                                   ║
+║  > npm install --global windows-build-tools                                  ║
+║  > npm install claude-flow@alpha                                             ║
 ║                                                                              ║
-║  Option 3 - Use WSL (Windows Subsystem for Linux):                         ║
-║  Install WSL and run Claude Flow inside a Linux environment                 ║
+║  Option 2 - Use WSL (Windows Subsystem for Linux):                           ║
+║  Install WSL and run Claude Flow inside a Linux environment                  ║
 ║                                                                              ║
 ╚══════════════════════════════════════════════════════════════════════════════╝
 `);

package/src/utils/error-recovery.ts

@@ -33,6 +33,52 @@ export function isNpmCacheError(error: any): boolean {
   ) || errorStr.includes('better-sqlite3');
 }
 
+/**
+ * Detect if an error is a native module version mismatch (NODE_MODULE_VERSION)
+ * This happens when native modules are compiled for a different Node.js version
+ */
+export function isNativeModuleVersionError(error: any): boolean {
+  const errorStr = error?.message || String(error);
+  return (
+    errorStr.includes('NODE_MODULE_VERSION') ||
+    errorStr.includes('was compiled against a different Node.js version') ||
+    errorStr.includes('re-compiling or re-installing the module')
+  );
+}
+
+/**
+ * Get helpful message for native module version mismatch
+ */
+export function getNativeModuleRecoveryMessage(error: any): string {
+  const errorStr = error?.message || String(error);
+
+  // Extract version numbers if available
+  const compiledMatch = errorStr.match(/NODE_MODULE_VERSION (\d+)/);
+  const requiredMatch = errorStr.match(/requires\s+NODE_MODULE_VERSION (\d+)/);
+
+  let message = '⚠️  Native module version mismatch detected.\n';
+
+  if (compiledMatch && requiredMatch) {
+    const nodeVersionMap: Record<string, string> = {
+      '108': '18.x',
+      '115': '20.x',
+      '120': '21.x',
+      '127': '22.x',
+      '131': '23.x'
+    };
+    const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;
+    const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;
+    message += `   Module was compiled for Node.js ${compiled}, but running Node.js ${required}.\n`;
+  }
+
+  message += '\n   To fix this, try one of:\n';
+  message += '   1. npm rebuild better-sqlite3\n';
+  message += '   2. rm -rf node_modules && npm install\n';
+  message += '   3. npx cache: rm -rf ~/.npm/_npx/ && run command again\n';
+
+  return message;
+}
+
 /**
  * Detect if running on WSL (Windows Subsystem for Linux)
  */
@@ -315,6 +361,8 @@ export async function recoverInitErrors(error: any): Promise<RecoveryResult> {
  */
 export const errorRecovery = {
   isNpmCacheError,
+  isNativeModuleVersionError,
+  getNativeModuleRecoveryMessage,
   isWSL,
   cleanNpmCache,
   retryWithRecovery,