@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/core/merge/unified-merge-resolver.js

@@ -0,0 +1,303 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { v4 as uuidv4 } from "uuid";
+import { ConflictDetector } from "./conflict-detector.js";
+import { StackDiffVisualizer } from "./stack-diff.js";
+import { ResolutionEngine } from "./resolution-engine.js";
+import { logger } from "../monitoring/logger.js";
+class UnifiedMergeResolver {
+  conflictDetector;
+  diffVisualizer;
+  resolutionEngine;
+  activeSessions = /* @__PURE__ */ new Map();
+  rollbackSnapshots = /* @__PURE__ */ new Map();
+  statistics = {
+    totalConflicts: 0,
+    resolvedConflicts: 0,
+    averageResolutionTime: 0,
+    successRate: 0,
+    rollbackCount: 0
+  };
+  constructor() {
+    this.conflictDetector = new ConflictDetector();
+    this.diffVisualizer = new StackDiffVisualizer();
+    this.resolutionEngine = new ResolutionEngine();
+    logger.debug("UnifiedMergeResolver initialized");
+  }
+  /**
+   * Start a new merge session with automatic conflict detection
+   */
+  async startMergeSession(stack1, stack2, options) {
+    const sessionId = `unified-merge-${Date.now()}-${uuidv4().substring(0, 8)}`;
+    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);
+    let rollbackPoint;
+    if (options?.preserveRollback !== false) {
+      rollbackPoint = this.createRollbackSnapshot(sessionId, stack1, stack2);
+    }
+    const session = {
+      sessionId,
+      stack1,
+      stack2,
+      conflicts,
+      status: "analyzing",
+      rollbackPoint,
+      startedAt: Date.now(),
+      metadata: {
+        totalFrames: stack1.frames.length + stack2.frames.length,
+        conflictCount: conflicts.length,
+        resolvedCount: 0
+      }
+    };
+    this.activeSessions.set(sessionId, session);
+    this.statistics.totalConflicts += conflicts.length;
+    logger.info(`Merge session started: ${sessionId}`, {
+      stack1Id: stack1.id,
+      stack2Id: stack2.id,
+      conflictCount: conflicts.length
+    });
+    if (options?.autoResolve && conflicts.length > 0 && options.context) {
+      const defaultStrategy = options.strategy || "ai_suggest";
+      await this.resolveConflicts(sessionId, defaultStrategy, options.context);
+    }
+    return sessionId;
+  }
+  /**
+   * Generate a preview of the merge result
+   */
+  async generatePreview(sessionId, strategy) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const preview = this.diffVisualizer.generateMergePreview(
+      session.stack1,
+      session.stack2,
+      strategy
+    );
+    session.preview = preview;
+    session.status = "preview";
+    session.metadata.strategyUsed = strategy;
+    this.activeSessions.set(sessionId, session);
+    logger.info(`Preview generated for session: ${sessionId}`, {
+      mergedFrameCount: preview.mergedFrames.length,
+      estimatedSuccess: preview.estimatedSuccess
+    });
+    return preview;
+  }
+  /**
+   * Resolve conflicts using the specified strategy
+   */
+  async resolveConflicts(sessionId, strategy, context) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    session.status = "resolving";
+    try {
+      const result = await this.resolutionEngine.resolveConflicts(
+        session.stack1,
+        session.stack2,
+        strategy,
+        context
+      );
+      session.resolution = result.resolution;
+      session.status = result.success ? "completed" : "failed";
+      session.completedAt = Date.now();
+      session.metadata.resolvedCount = session.conflicts.filter(
+        (c) => c.resolution !== void 0
+      ).length;
+      session.metadata.strategyUsed = strategy;
+      this.activeSessions.set(sessionId, session);
+      if (result.success) {
+        this.statistics.resolvedConflicts += session.metadata.resolvedCount;
+        this.updateSuccessRate();
+        this.updateAverageResolutionTime(session);
+      }
+      logger.info(`Conflicts resolved for session: ${sessionId}`, {
+        success: result.success,
+        strategy,
+        resolvedCount: session.metadata.resolvedCount
+      });
+      return result;
+    } catch (error) {
+      session.status = "failed";
+      this.activeSessions.set(sessionId, session);
+      logger.error(
+        `Failed to resolve conflicts for session: ${sessionId}`,
+        error
+      );
+      throw error;
+    }
+  }
+  /**
+   * Rollback a merge to its original state
+   */
+  async rollback(sessionId) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session || !session.rollbackPoint) {
+      logger.warn(`Cannot rollback session: ${sessionId} - no rollback point`);
+      return false;
+    }
+    const snapshot = this.rollbackSnapshots.get(session.rollbackPoint);
+    if (!snapshot) {
+      logger.error(`Rollback snapshot not found: ${session.rollbackPoint}`);
+      return false;
+    }
+    session.stack1 = snapshot.stack1;
+    session.stack2 = snapshot.stack2;
+    session.status = "rolled_back";
+    session.resolution = void 0;
+    session.conflicts = this.conflictDetector.detectConflicts(
+      snapshot.stack1,
+      snapshot.stack2
+    );
+    session.metadata.resolvedCount = 0;
+    this.activeSessions.set(sessionId, session);
+    this.statistics.rollbackCount++;
+    logger.info(`Session rolled back: ${sessionId}`);
+    return true;
+  }
+  /**
+   * Get merge session details
+   */
+  getSession(sessionId) {
+    return this.activeSessions.get(sessionId);
+  }
+  /**
+   * List all active merge sessions
+   */
+  listActiveSessions() {
+    return Array.from(this.activeSessions.values()).filter(
+      (s) => s.status !== "completed" && s.status !== "rolled_back" && s.status !== "failed"
+    );
+  }
+  /**
+   * Get merge statistics
+   */
+  getStatistics() {
+    return { ...this.statistics };
+  }
+  /**
+   * Analyze parallel solutions across stacks
+   */
+  analyzeParallelSolutions(frames) {
+    const solutions = this.conflictDetector.analyzeParallelSolutions(frames);
+    const recommendations = [];
+    if (solutions.length > 1) {
+      const grouped = /* @__PURE__ */ new Map();
+      for (const sol of solutions) {
+        const key = sol.approach.toLowerCase();
+        if (!grouped.has(key)) {
+          grouped.set(key, []);
+        }
+        grouped.get(key).push(sol);
+      }
+      for (const [approach, group] of grouped) {
+        if (group.length > 1) {
+          const avgEffectiveness = group.reduce((sum, s) => sum + (s.effectiveness || 0), 0) / group.length;
+          recommendations.push(
+            `${group.length} parallel solutions using "${approach}" approach (avg effectiveness: ${(avgEffectiveness * 100).toFixed(1)}%)`
+          );
+        }
+      }
+      const best = solutions.reduce(
+        (a, b) => (a.effectiveness || 0) > (b.effectiveness || 0) ? a : b,
+        solutions[0]
+      );
+      if (best && best.effectiveness && best.effectiveness > 0.7) {
+        recommendations.push(
+          `Recommended: Use solution from frame "${best.frameId}" (${(best.effectiveness * 100).toFixed(1)}% effectiveness)`
+        );
+      }
+    }
+    return {
+      solutions: solutions.map((s) => ({
+        frameId: s.frameId,
+        approach: s.approach,
+        effectiveness: s.effectiveness || 0
+      })),
+      recommendations
+    };
+  }
+  /**
+   * Create a visual diff between two stacks
+   */
+  createVisualDiff(baseFrame, stack1, stack2) {
+    const diff = this.diffVisualizer.visualizeDivergence(
+      baseFrame,
+      stack1,
+      stack2
+    );
+    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);
+    return {
+      nodes: diff.nodes.map((n) => ({
+        id: n.id,
+        type: n.type,
+        depth: n.frame?.depth
+      })),
+      edges: diff.edges.map((e) => ({
+        source: e.source,
+        target: e.target,
+        type: e.type
+      })),
+      conflicts: conflicts.map((c) => ({
+        frameId1: c.frameId1,
+        frameId2: c.frameId2,
+        severity: c.severity
+      }))
+    };
+  }
+  /**
+   * Close a merge session and clean up resources
+   */
+  closeSession(sessionId) {
+    const session = this.activeSessions.get(sessionId);
+    if (session) {
+      if (session.rollbackPoint) {
+        this.rollbackSnapshots.delete(session.rollbackPoint);
+      }
+      this.activeSessions.delete(sessionId);
+      logger.debug(`Session closed: ${sessionId}`);
+    }
+  }
+  // Private helpers
+  createRollbackSnapshot(sessionId, stack1, stack2) {
+    const snapshotId = `rollback-${sessionId}`;
+    this.rollbackSnapshots.set(snapshotId, {
+      stack1: this.deepCloneStack(stack1),
+      stack2: this.deepCloneStack(stack2)
+    });
+    return snapshotId;
+  }
+  deepCloneStack(stack) {
+    return {
+      ...stack,
+      frames: stack.frames.map((f) => ({ ...f })),
+      events: stack.events.map((e) => ({ ...e }))
+    };
+  }
+  updateSuccessRate() {
+    if (this.statistics.totalConflicts > 0) {
+      this.statistics.successRate = this.statistics.resolvedConflicts / this.statistics.totalConflicts;
+    }
+  }
+  updateAverageResolutionTime(session) {
+    if (session.completedAt && session.startedAt) {
+      const duration = session.completedAt - session.startedAt;
+      const completedSessions = Array.from(this.activeSessions.values()).filter(
+        (s) => s.completedAt
+      ).length;
+      if (completedSessions === 1) {
+        this.statistics.averageResolutionTime = duration;
+      } else {
+        this.statistics.averageResolutionTime = (this.statistics.averageResolutionTime * (completedSessions - 1) + duration) / completedSessions;
+      }
+    }
+  }
+}
+export {
+  UnifiedMergeResolver
+};
+//# sourceMappingURL=unified-merge-resolver.js.map

package/dist/src/core/merge/unified-merge-resolver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/merge/unified-merge-resolver.ts"],
+  "sourcesContent": ["/**\n * Unified Merge Resolver - STA-101\n * Bridges StackMergeResolver with advanced ConflictDetector and ResolutionEngine\n * Provides a unified interface for all merge conflict resolution scenarios\n */\n\nimport { v4 as uuidv4 } from 'uuid';\nimport type { Frame, Event } from '../context/frame-types.js';\nimport { ConflictDetector } from './conflict-detector.js';\nimport { StackDiffVisualizer, PreviewResult } from './stack-diff.js';\nimport { ResolutionEngine, ResolutionContext } from './resolution-engine.js';\nimport {\n  MergeConflict,\n  ConflictResolution,\n  ResolutionStrategy,\n  FrameStack,\n  MergeResult,\n  MergeStatistics,\n} from './types.js';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface UnifiedMergeSession {\n  sessionId: string;\n  stack1: FrameStack;\n  stack2: FrameStack;\n  conflicts: MergeConflict[];\n  resolution?: ConflictResolution;\n  status:\n    | 'analyzing'\n    | 'preview'\n    | 'resolving'\n    | 'completed'\n    | 'failed'\n    | 'rolled_back';\n  preview?: PreviewResult;\n  rollbackPoint?: string;\n  startedAt: number;\n  completedAt?: number;\n  metadata: {\n    totalFrames: number;\n    conflictCount: number;\n    resolvedCount: number;\n    strategyUsed?: ResolutionStrategy['type'];\n  };\n}\n\nexport interface MergeOptions {\n  strategy?: ResolutionStrategy['type'];\n  autoResolve?: boolean;\n  preserveRollback?: boolean;\n  notifyOnComplete?: boolean;\n  context?: ResolutionContext;\n}\n\nexport class UnifiedMergeResolver {\n  private conflictDetector: ConflictDetector;\n  private diffVisualizer: StackDiffVisualizer;\n  private resolutionEngine: ResolutionEngine;\n  private activeSessions: Map<string, UnifiedMergeSession> = new Map();\n  private rollbackSnapshots: Map<\n    string,\n    { stack1: FrameStack; stack2: FrameStack }\n  > = new Map();\n  private statistics: MergeStatistics = {\n    totalConflicts: 0,\n    resolvedConflicts: 0,\n    averageResolutionTime: 0,\n    successRate: 0,\n    rollbackCount: 0,\n  };\n\n  constructor() {\n    this.conflictDetector = new ConflictDetector();\n    this.diffVisualizer = new StackDiffVisualizer();\n    this.resolutionEngine = new ResolutionEngine();\n    logger.debug('UnifiedMergeResolver initialized');\n  }\n\n  /**\n   * Start a new merge session with automatic conflict detection\n   */\n  async startMergeSession(\n    stack1: FrameStack,\n    stack2: FrameStack,\n    options?: MergeOptions\n  ): Promise<string> {\n    const sessionId = `unified-merge-${Date.now()}-${uuidv4().substring(0, 8)}`;\n\n    // Detect conflicts\n    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);\n\n    // Create rollback snapshot if requested\n    let rollbackPoint: string | undefined;\n    if (options?.preserveRollback !== false) {\n      rollbackPoint = this.createRollbackSnapshot(sessionId, stack1, stack2);\n    }\n\n    const session: UnifiedMergeSession = {\n      sessionId,\n      stack1,\n      stack2,\n      conflicts,\n      status: 'analyzing',\n      rollbackPoint,\n      startedAt: Date.now(),\n      metadata: {\n        totalFrames: stack1.frames.length + stack2.frames.length,\n        conflictCount: conflicts.length,\n        resolvedCount: 0,\n      },\n    };\n\n    this.activeSessions.set(sessionId, session);\n    this.statistics.totalConflicts += conflicts.length;\n\n    logger.info(`Merge session started: ${sessionId}`, {\n      stack1Id: stack1.id,\n      stack2Id: stack2.id,\n      conflictCount: conflicts.length,\n    });\n\n    // Auto-resolve if requested and possible\n    if (options?.autoResolve && conflicts.length > 0 && options.context) {\n      const defaultStrategy = options.strategy || 'ai_suggest';\n      await this.resolveConflicts(sessionId, defaultStrategy, options.context);\n    }\n\n    return sessionId;\n  }\n\n  /**\n   * Generate a preview of the merge result\n   */\n  async generatePreview(\n    sessionId: string,\n    strategy: ResolutionStrategy['type']\n  ): Promise<PreviewResult> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    const preview = this.diffVisualizer.generateMergePreview(\n      session.stack1,\n      session.stack2,\n      strategy\n    );\n\n    session.preview = preview;\n    session.status = 'preview';\n    session.metadata.strategyUsed = strategy;\n\n    this.activeSessions.set(sessionId, session);\n\n    logger.info(`Preview generated for session: ${sessionId}`, {\n      mergedFrameCount: preview.mergedFrames.length,\n      estimatedSuccess: preview.estimatedSuccess,\n    });\n\n    return preview;\n  }\n\n  /**\n   * Resolve conflicts using the specified strategy\n   */\n  async resolveConflicts(\n    sessionId: string,\n    strategy: ResolutionStrategy['type'],\n    context: ResolutionContext\n  ): Promise<MergeResult> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    session.status = 'resolving';\n\n    try {\n      const result = await this.resolutionEngine.resolveConflicts(\n        session.stack1,\n        session.stack2,\n        strategy,\n        context\n      );\n\n      session.resolution = result.resolution;\n      session.status = result.success ? 'completed' : 'failed';\n      session.completedAt = Date.now();\n      session.metadata.resolvedCount = session.conflicts.filter(\n        (c) => c.resolution !== undefined\n      ).length;\n      session.metadata.strategyUsed = strategy;\n\n      this.activeSessions.set(sessionId, session);\n\n      // Update statistics\n      if (result.success) {\n        this.statistics.resolvedConflicts += session.metadata.resolvedCount;\n        this.updateSuccessRate();\n        this.updateAverageResolutionTime(session);\n      }\n\n      logger.info(`Conflicts resolved for session: ${sessionId}`, {\n        success: result.success,\n        strategy,\n        resolvedCount: session.metadata.resolvedCount,\n      });\n\n      return result;\n    } catch (error) {\n      session.status = 'failed';\n      this.activeSessions.set(sessionId, session);\n\n      logger.error(\n        `Failed to resolve conflicts for session: ${sessionId}`,\n        error\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Rollback a merge to its original state\n   */\n  async rollback(sessionId: string): Promise<boolean> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || !session.rollbackPoint) {\n      logger.warn(`Cannot rollback session: ${sessionId} - no rollback point`);\n      return false;\n    }\n\n    const snapshot = this.rollbackSnapshots.get(session.rollbackPoint);\n    if (!snapshot) {\n      logger.error(`Rollback snapshot not found: ${session.rollbackPoint}`);\n      return false;\n    }\n\n    // Restore original state\n    session.stack1 = snapshot.stack1;\n    session.stack2 = snapshot.stack2;\n    session.status = 'rolled_back';\n    session.resolution = undefined;\n    session.conflicts = this.conflictDetector.detectConflicts(\n      snapshot.stack1,\n      snapshot.stack2\n    );\n    session.metadata.resolvedCount = 0;\n\n    this.activeSessions.set(sessionId, session);\n    this.statistics.rollbackCount++;\n\n    logger.info(`Session rolled back: ${sessionId}`);\n    return true;\n  }\n\n  /**\n   * Get merge session details\n   */\n  getSession(sessionId: string): UnifiedMergeSession | undefined {\n    return this.activeSessions.get(sessionId);\n  }\n\n  /**\n   * List all active merge sessions\n   */\n  listActiveSessions(): UnifiedMergeSession[] {\n    return Array.from(this.activeSessions.values()).filter(\n      (s) =>\n        s.status !== 'completed' &&\n        s.status !== 'rolled_back' &&\n        s.status !== 'failed'\n    );\n  }\n\n  /**\n   * Get merge statistics\n   */\n  getStatistics(): MergeStatistics {\n    return { ...this.statistics };\n  }\n\n  /**\n   * Analyze parallel solutions across stacks\n   */\n  analyzeParallelSolutions(frames: Frame[]): {\n    solutions: Array<{\n      frameId: string;\n      approach: string;\n      effectiveness: number;\n    }>;\n    recommendations: string[];\n  } {\n    const solutions = this.conflictDetector.analyzeParallelSolutions(frames);\n\n    const recommendations: string[] = [];\n    if (solutions.length > 1) {\n      // Group by similar solutions\n      const grouped = new Map<string, typeof solutions>();\n      for (const sol of solutions) {\n        const key = sol.approach.toLowerCase();\n        if (!grouped.has(key)) {\n          grouped.set(key, []);\n        }\n        grouped.get(key)!.push(sol);\n      }\n\n      // Generate recommendations\n      for (const [approach, group] of grouped) {\n        if (group.length > 1) {\n          const avgEffectiveness =\n            group.reduce((sum, s) => sum + (s.effectiveness || 0), 0) /\n            group.length;\n          recommendations.push(\n            `${group.length} parallel solutions using \"${approach}\" approach (avg effectiveness: ${(avgEffectiveness * 100).toFixed(1)}%)`\n          );\n        }\n      }\n\n      // Find best solution\n      const best = solutions.reduce(\n        (a, b) => ((a.effectiveness || 0) > (b.effectiveness || 0) ? a : b),\n        solutions[0]\n      );\n      if (best && best.effectiveness && best.effectiveness > 0.7) {\n        recommendations.push(\n          `Recommended: Use solution from frame \"${best.frameId}\" (${(best.effectiveness * 100).toFixed(1)}% effectiveness)`\n        );\n      }\n    }\n\n    return {\n      solutions: solutions.map((s) => ({\n        frameId: s.frameId,\n        approach: s.approach,\n        effectiveness: s.effectiveness || 0,\n      })),\n      recommendations,\n    };\n  }\n\n  /**\n   * Create a visual diff between two stacks\n   */\n  createVisualDiff(\n    baseFrame: Frame,\n    stack1: FrameStack,\n    stack2: FrameStack\n  ): {\n    nodes: Array<{ id: string; type: string; depth?: number }>;\n    edges: Array<{ source: string; target: string; type: string }>;\n    conflicts: Array<{ frameId1: string; frameId2: string; severity: string }>;\n  } {\n    const diff = this.diffVisualizer.visualizeDivergence(\n      baseFrame,\n      stack1,\n      stack2\n    );\n    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);\n\n    return {\n      nodes: diff.nodes.map((n) => ({\n        id: n.id,\n        type: n.type,\n        depth: n.frame?.depth,\n      })),\n      edges: diff.edges.map((e) => ({\n        source: e.source,\n        target: e.target,\n        type: e.type,\n      })),\n      conflicts: conflicts.map((c) => ({\n        frameId1: c.frameId1,\n        frameId2: c.frameId2,\n        severity: c.severity,\n      })),\n    };\n  }\n\n  /**\n   * Close a merge session and clean up resources\n   */\n  closeSession(sessionId: string): void {\n    const session = this.activeSessions.get(sessionId);\n    if (session) {\n      // Clean up rollback snapshot\n      if (session.rollbackPoint) {\n        this.rollbackSnapshots.delete(session.rollbackPoint);\n      }\n      this.activeSessions.delete(sessionId);\n\n      logger.debug(`Session closed: ${sessionId}`);\n    }\n  }\n\n  // Private helpers\n\n  private createRollbackSnapshot(\n    sessionId: string,\n    stack1: FrameStack,\n    stack2: FrameStack\n  ): string {\n    const snapshotId = `rollback-${sessionId}`;\n\n    // Deep clone stacks\n    this.rollbackSnapshots.set(snapshotId, {\n      stack1: this.deepCloneStack(stack1),\n      stack2: this.deepCloneStack(stack2),\n    });\n\n    return snapshotId;\n  }\n\n  private deepCloneStack(stack: FrameStack): FrameStack {\n    return {\n      ...stack,\n      frames: stack.frames.map((f) => ({ ...f })),\n      events: stack.events.map((e) => ({ ...e })),\n    };\n  }\n\n  private updateSuccessRate(): void {\n    if (this.statistics.totalConflicts > 0) {\n      this.statistics.successRate =\n        this.statistics.resolvedConflicts / this.statistics.totalConflicts;\n    }\n  }\n\n  private updateAverageResolutionTime(session: UnifiedMergeSession): void {\n    if (session.completedAt && session.startedAt) {\n      const duration = session.completedAt - session.startedAt;\n      const completedSessions = Array.from(this.activeSessions.values()).filter(\n        (s) => s.completedAt\n      ).length;\n\n      if (completedSessions === 1) {\n        this.statistics.averageResolutionTime = duration;\n      } else {\n        // Running average\n        this.statistics.averageResolutionTime =\n          (this.statistics.averageResolutionTime * (completedSessions - 1) +\n            duration) /\n          completedSessions;\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/models/fallback-monitor.js

@@ -0,0 +1,232 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { spawn } from "child_process";
+import {
+  loadModelRouterConfig,
+  buildModelEnv
+} from "./model-router.js";
+const DEFAULT_ERROR_PATTERNS = [
+  /rate.?limit/i,
+  /429/,
+  /too.?many.?requests/i,
+  /overloaded/i,
+  /capacity/i,
+  /temporarily.?unavailable/i,
+  /503/,
+  /502/,
+  /500/,
+  /internal.?server.?error/i,
+  /timeout/i,
+  /ETIMEDOUT/,
+  /ESOCKETTIMEDOUT/,
+  /ECONNRESET/,
+  /ECONNREFUSED/
+];
+class FallbackMonitor {
+  config;
+  routerConfig = loadModelRouterConfig();
+  currentProvider = "anthropic";
+  restartCount = 0;
+  inFallback = false;
+  errorBuffer = "";
+  lastErrorTime = 0;
+  errorCount = 0;
+  constructor(config = {}) {
+    this.config = {
+      enabled: true,
+      maxRestarts: 3,
+      restartDelayMs: 2e3,
+      errorPatterns: DEFAULT_ERROR_PATTERNS,
+      ...config
+    };
+  }
+  /**
+   * Check if text contains error patterns that should trigger fallback
+   */
+  detectError(text) {
+    for (const pattern of this.config.errorPatterns) {
+      if (pattern.test(text)) {
+        return {
+          shouldFallback: true,
+          reason: pattern.source
+        };
+      }
+    }
+    return { shouldFallback: false, reason: "" };
+  }
+  /**
+   * Get environment variables for fallback provider
+   */
+  getFallbackEnv() {
+    const fallbackProvider = this.routerConfig.fallback?.provider || "qwen";
+    const providerConfig = this.routerConfig.providers[fallbackProvider];
+    if (!providerConfig) {
+      console.error(`[fallback] Provider not configured: ${fallbackProvider}`);
+      return {};
+    }
+    return buildModelEnv(providerConfig);
+  }
+  /**
+   * Check if fallback is available (has API key)
+   */
+  isFallbackAvailable() {
+    const fallbackProvider = this.routerConfig.fallback?.provider || "qwen";
+    const providerConfig = this.routerConfig.providers[fallbackProvider];
+    if (!providerConfig) return false;
+    return !!process.env[providerConfig.apiKeyEnv];
+  }
+  /**
+   * Wrap a Claude process with fallback monitoring
+   * Returns a function to spawn the process with automatic restart on failure
+   */
+  wrapProcess(command, args, options = {}) {
+    let currentProcess = null;
+    let stopped = false;
+    const startProcess = () => {
+      const env = { ...process.env, ...options.env };
+      if (this.inFallback) {
+        const fallbackEnv = this.getFallbackEnv();
+        Object.assign(env, fallbackEnv);
+        this.currentProvider = this.routerConfig.fallback?.provider || "qwen";
+      }
+      const isTTY = process.stdout.isTTY;
+      currentProcess = spawn(command, args, {
+        stdio: isTTY ? "inherit" : ["inherit", "pipe", "pipe"],
+        env,
+        cwd: options.cwd
+      });
+      if (!isTTY) {
+        currentProcess.stdout?.on("data", (data) => {
+          const text = data.toString();
+          process.stdout.write(data);
+          this.checkForErrors(text);
+        });
+        currentProcess.stderr?.on("data", (data) => {
+          const text = data.toString();
+          process.stderr.write(data);
+          this.checkForErrors(text);
+        });
+      }
+      currentProcess.on("exit", (code, _signal) => {
+        if (stopped) return;
+        if (code !== 0 && this.shouldRestart()) {
+          console.log(
+            `
+[fallback] Process exited with code ${code}, restarting with fallback...`
+          );
+          this.activateFallback("exit_code");
+          setTimeout(() => {
+            if (!stopped) {
+              startProcess();
+            }
+          }, this.config.restartDelayMs);
+        }
+      });
+      return currentProcess;
+    };
+    return {
+      start: startProcess,
+      stop: () => {
+        stopped = true;
+        currentProcess?.kill();
+      },
+      isInFallback: () => this.inFallback,
+      getCurrentProvider: () => this.currentProvider
+    };
+  }
+  /**
+   * Check output text for errors and trigger fallback if needed
+   */
+  checkForErrors(text) {
+    this.errorBuffer += text;
+    if (this.errorBuffer.length > 1e4) {
+      this.errorBuffer = this.errorBuffer.slice(-5e3);
+    }
+    const { shouldFallback, reason } = this.detectError(text);
+    if (shouldFallback) {
+      const now = Date.now();
+      if (now - this.lastErrorTime < 1e3) {
+        this.errorCount++;
+      } else {
+        this.errorCount = 1;
+      }
+      this.lastErrorTime = now;
+      if (this.errorCount >= 2 && !this.inFallback && this.isFallbackAvailable()) {
+        console.log(`
+[fallback] Detected error pattern: ${reason}`);
+        this.activateFallback(reason);
+      }
+    }
+  }
+  /**
+   * Activate fallback mode
+   */
+  activateFallback(reason) {
+    if (this.inFallback) return;
+    this.inFallback = true;
+    this.restartCount++;
+    this.currentProvider = this.routerConfig.fallback?.provider || "qwen";
+    console.log(
+      `[fallback] Switching to ${this.currentProvider} (reason: ${reason})`
+    );
+    if (this.config.onFallback) {
+      this.config.onFallback(this.currentProvider, reason);
+    }
+  }
+  /**
+   * Check if we should restart
+   */
+  shouldRestart() {
+    return this.config.enabled && this.restartCount < this.config.maxRestarts && this.isFallbackAvailable();
+  }
+  /**
+   * Reset fallback state
+   */
+  reset() {
+    this.inFallback = false;
+    this.restartCount = 0;
+    this.errorCount = 0;
+    this.errorBuffer = "";
+    this.currentProvider = "anthropic";
+  }
+  /**
+   * Get current status
+   */
+  getStatus() {
+    return {
+      inFallback: this.inFallback,
+      currentProvider: this.currentProvider,
+      restartCount: this.restartCount,
+      fallbackAvailable: this.isFallbackAvailable()
+    };
+  }
+}
+function spawnWithFallback(command, args, options = {}) {
+  const monitor = new FallbackMonitor({
+    onFallback: options.onFallback
+  });
+  const wrapper = monitor.wrapProcess(command, args, options);
+  return wrapper.start();
+}
+function getEnvWithFallback() {
+  const config = loadModelRouterConfig();
+  const env = {};
+  if (config.fallback?.enabled) {
+    const fallbackProvider = config.providers[config.fallback.provider];
+    if (fallbackProvider) {
+      env["STACKMEMORY_FALLBACK_PROVIDER"] = config.fallback.provider;
+      env["STACKMEMORY_FALLBACK_MODEL"] = fallbackProvider.model;
+      env["STACKMEMORY_FALLBACK_URL"] = fallbackProvider.baseUrl || "";
+      env["STACKMEMORY_FALLBACK_KEY_ENV"] = fallbackProvider.apiKeyEnv;
+    }
+  }
+  return env;
+}
+export {
+  FallbackMonitor,
+  getEnvWithFallback,
+  spawnWithFallback
+};
+//# sourceMappingURL=fallback-monitor.js.map

package/dist/src/core/models/fallback-monitor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/models/fallback-monitor.ts"],
+  "sourcesContent": ["/**\n * Fallback Monitor - Watches Claude output for errors and triggers automatic fallback\n * Restarts session with Qwen when Claude fails\n */\n\nimport { spawn, ChildProcess } from 'child_process';\nimport {\n  loadModelRouterConfig,\n  buildModelEnv,\n  type ModelProvider,\n} from './model-router.js';\n\nexport interface FallbackMonitorConfig {\n  enabled: boolean;\n  maxRestarts: number;\n  restartDelayMs: number;\n  errorPatterns: RegExp[];\n  onFallback?: (provider: ModelProvider, reason: string) => void;\n  onRestore?: (provider: ModelProvider) => void;\n}\n\nconst DEFAULT_ERROR_PATTERNS = [\n  /rate.?limit/i,\n  /429/,\n  /too.?many.?requests/i,\n  /overloaded/i,\n  /capacity/i,\n  /temporarily.?unavailable/i,\n  /503/,\n  /502/,\n  /500/,\n  /internal.?server.?error/i,\n  /timeout/i,\n  /ETIMEDOUT/,\n  /ESOCKETTIMEDOUT/,\n  /ECONNRESET/,\n  /ECONNREFUSED/,\n];\n\n/**\n * FallbackMonitor watches a Claude process and restarts with fallback on errors\n */\nexport class FallbackMonitor {\n  private config: FallbackMonitorConfig;\n  private routerConfig = loadModelRouterConfig();\n  private currentProvider: ModelProvider = 'anthropic';\n  private restartCount = 0;\n  private inFallback = false;\n  private errorBuffer = '';\n  private lastErrorTime = 0;\n  private errorCount = 0;\n\n  constructor(config: Partial<FallbackMonitorConfig> = {}) {\n    this.config = {\n      enabled: true,\n      maxRestarts: 3,\n      restartDelayMs: 2000,\n      errorPatterns: DEFAULT_ERROR_PATTERNS,\n      ...config,\n    };\n  }\n\n  /**\n   * Check if text contains error patterns that should trigger fallback\n   */\n  detectError(text: string): { shouldFallback: boolean; reason: string } {\n    for (const pattern of this.config.errorPatterns) {\n      if (pattern.test(text)) {\n        return {\n          shouldFallback: true,\n          reason: pattern.source,\n        };\n      }\n    }\n    return { shouldFallback: false, reason: '' };\n  }\n\n  /**\n   * Get environment variables for fallback provider\n   */\n  getFallbackEnv(): Record<string, string> {\n    const fallbackProvider = this.routerConfig.fallback?.provider || 'qwen';\n    const providerConfig = this.routerConfig.providers[fallbackProvider];\n\n    if (!providerConfig) {\n      console.error(`[fallback] Provider not configured: ${fallbackProvider}`);\n      return {};\n    }\n\n    return buildModelEnv(providerConfig);\n  }\n\n  /**\n   * Check if fallback is available (has API key)\n   */\n  isFallbackAvailable(): boolean {\n    const fallbackProvider = this.routerConfig.fallback?.provider || 'qwen';\n    const providerConfig = this.routerConfig.providers[fallbackProvider];\n\n    if (!providerConfig) return false;\n\n    return !!process.env[providerConfig.apiKeyEnv];\n  }\n\n  /**\n   * Wrap a Claude process with fallback monitoring\n   * Returns a function to spawn the process with automatic restart on failure\n   */\n  wrapProcess(\n    command: string,\n    args: string[],\n    options: { env?: NodeJS.ProcessEnv; cwd?: string } = {}\n  ): {\n    start: () => ChildProcess;\n    stop: () => void;\n    isInFallback: () => boolean;\n    getCurrentProvider: () => ModelProvider;\n  } {\n    let currentProcess: ChildProcess | null = null;\n    let stopped = false;\n\n    const startProcess = (): ChildProcess => {\n      const env = { ...process.env, ...options.env };\n\n      // Apply fallback env if in fallback mode\n      if (this.inFallback) {\n        const fallbackEnv = this.getFallbackEnv();\n        Object.assign(env, fallbackEnv);\n        this.currentProvider = this.routerConfig.fallback?.provider || 'qwen';\n      }\n\n      // Use 'inherit' for TTY to preserve interactive mode\n      // Claude CLI checks stdout TTY to decide interactive vs print mode\n      const isTTY = process.stdout.isTTY;\n\n      currentProcess = spawn(command, args, {\n        stdio: isTTY ? 'inherit' : ['inherit', 'pipe', 'pipe'],\n        env,\n        cwd: options.cwd,\n      });\n\n      // Only monitor output in non-TTY mode (fallback detection still works via exit code)\n      if (!isTTY) {\n        // Monitor stdout\n        currentProcess.stdout?.on('data', (data: Buffer) => {\n          const text = data.toString();\n          process.stdout.write(data);\n          this.checkForErrors(text);\n        });\n\n        // Monitor stderr\n        currentProcess.stderr?.on('data', (data: Buffer) => {\n          const text = data.toString();\n          process.stderr.write(data);\n          this.checkForErrors(text);\n        });\n      }\n\n      // Handle exit\n      currentProcess.on('exit', (code, _signal) => {\n        if (stopped) return;\n\n        // Check if we should restart with fallback\n        if (code !== 0 && this.shouldRestart()) {\n          console.log(\n            `\\n[fallback] Process exited with code ${code}, restarting with fallback...`\n          );\n          this.activateFallback('exit_code');\n          setTimeout(() => {\n            if (!stopped) {\n              startProcess();\n            }\n          }, this.config.restartDelayMs);\n        }\n      });\n\n      return currentProcess;\n    };\n\n    return {\n      start: startProcess,\n      stop: () => {\n        stopped = true;\n        currentProcess?.kill();\n      },\n      isInFallback: () => this.inFallback,\n      getCurrentProvider: () => this.currentProvider,\n    };\n  }\n\n  /**\n   * Check output text for errors and trigger fallback if needed\n   */\n  private checkForErrors(text: string): void {\n    this.errorBuffer += text;\n\n    // Keep buffer manageable\n    if (this.errorBuffer.length > 10000) {\n      this.errorBuffer = this.errorBuffer.slice(-5000);\n    }\n\n    const { shouldFallback, reason } = this.detectError(text);\n\n    if (shouldFallback) {\n      const now = Date.now();\n\n      // Debounce rapid errors\n      if (now - this.lastErrorTime < 1000) {\n        this.errorCount++;\n      } else {\n        this.errorCount = 1;\n      }\n      this.lastErrorTime = now;\n\n      // Trigger fallback after multiple rapid errors\n      if (\n        this.errorCount >= 2 &&\n        !this.inFallback &&\n        this.isFallbackAvailable()\n      ) {\n        console.log(`\\n[fallback] Detected error pattern: ${reason}`);\n        this.activateFallback(reason);\n      }\n    }\n  }\n\n  /**\n   * Activate fallback mode\n   */\n  private activateFallback(reason: string): void {\n    if (this.inFallback) return;\n\n    this.inFallback = true;\n    this.restartCount++;\n    this.currentProvider = this.routerConfig.fallback?.provider || 'qwen';\n\n    console.log(\n      `[fallback] Switching to ${this.currentProvider} (reason: ${reason})`\n    );\n\n    if (this.config.onFallback) {\n      this.config.onFallback(this.currentProvider, reason);\n    }\n  }\n\n  /**\n   * Check if we should restart\n   */\n  private shouldRestart(): boolean {\n    return (\n      this.config.enabled &&\n      this.restartCount < this.config.maxRestarts &&\n      this.isFallbackAvailable()\n    );\n  }\n\n  /**\n   * Reset fallback state\n   */\n  reset(): void {\n    this.inFallback = false;\n    this.restartCount = 0;\n    this.errorCount = 0;\n    this.errorBuffer = '';\n    this.currentProvider = 'anthropic';\n  }\n\n  /**\n   * Get current status\n   */\n  getStatus(): {\n    inFallback: boolean;\n    currentProvider: ModelProvider;\n    restartCount: number;\n    fallbackAvailable: boolean;\n  } {\n    return {\n      inFallback: this.inFallback,\n      currentProvider: this.currentProvider,\n      restartCount: this.restartCount,\n      fallbackAvailable: this.isFallbackAvailable(),\n    };\n  }\n}\n\n/**\n * Create a simple fallback-aware spawn function\n */\nexport function spawnWithFallback(\n  command: string,\n  args: string[],\n  options: {\n    env?: NodeJS.ProcessEnv;\n    cwd?: string;\n    onFallback?: (provider: ModelProvider, reason: string) => void;\n  } = {}\n): ChildProcess {\n  const monitor = new FallbackMonitor({\n    onFallback: options.onFallback,\n  });\n\n  const wrapper = monitor.wrapProcess(command, args, options);\n  return wrapper.start();\n}\n\n/**\n * Quick helper to get env vars with fallback pre-configured\n */\nexport function getEnvWithFallback(): Record<string, string> {\n  const config = loadModelRouterConfig();\n  const env: Record<string, string> = {};\n\n  // Set fallback provider info for error recovery\n  if (config.fallback?.enabled) {\n    const fallbackProvider = config.providers[config.fallback.provider];\n    if (fallbackProvider) {\n      env['STACKMEMORY_FALLBACK_PROVIDER'] = config.fallback.provider;\n      env['STACKMEMORY_FALLBACK_MODEL'] = fallbackProvider.model;\n      env['STACKMEMORY_FALLBACK_URL'] = fallbackProvider.baseUrl || '';\n      env['STACKMEMORY_FALLBACK_KEY_ENV'] = fallbackProvider.apiKeyEnv;\n    }\n  }\n\n  return env;\n}\n"],
+  "mappings": "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",
+  "names": []
+}