@stackmemoryai/stackmemory 0.5.59 → 0.5.62

package/dist/core/context/frame-manager.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/core/context/frame-manager.ts"],
-  "sourcesContent": ["/**\n * StackMemory Frame Manager - Call Stack Implementation\n * Manages nested frames representing the call stack of work\n */\n\nimport Database from 'better-sqlite3';\nimport { v4 as uuidv4 } from 'uuid';\nimport { logger } from '../monitoring/logger.js';\nimport { trace } from '../trace/index.js';\nimport {\n  DatabaseError,\n  FrameError,\n  SystemError,\n  ErrorCode,\n  wrapError,\n  createErrorHandler,\n} from '../errors/index.js';\nimport { retry, withTimeout } from '../errors/recovery.js';\nimport { sessionManager, FrameQueryMode } from '../session/index.js';\nimport { contextBridge } from './context-bridge.js';\n\n// WhatsApp sync integration - lazy loaded to avoid breaking if module has issues\nlet whatsappSync: {\n  onFrameClosed: (data: any) => Promise<any>;\n  createFrameDigestData: (frame: any, events: any[], anchors: any[]) => any;\n} | null = null;\n\nasync function loadWhatsAppSync() {\n  if (whatsappSync !== null) return whatsappSync;\n  try {\n    const mod = await import('../../hooks/whatsapp-sync.js');\n    whatsappSync = {\n      onFrameClosed: mod.onFrameClosed,\n      createFrameDigestData: mod.createFrameDigestData,\n    };\n    return whatsappSync;\n  } catch {\n    // Module not available or has errors - disable integration\n    whatsappSync = null;\n    return null;\n  }\n}\n\n// Constants for frame validation\nconst MAX_FRAME_DEPTH = 100; // Maximum allowed frame depth\nconst DEFAULT_MAX_DEPTH = 100; // Default if not configured\n\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new SystemError(\n      `Environment variable ${key} is required`,\n      ErrorCode.CONFIGURATION_ERROR,\n      { variable: key }\n    );\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\n// Frame types based on architecture\nexport type FrameType =\n  | 'task'\n  | 'subtask'\n  | 'tool_scope'\n  | 'review'\n  | 'write'\n  | 'debug';\nexport type FrameState = 'active' | 'closed';\n\nexport interface Frame {\n  frame_id: string;\n  run_id: string;\n  project_id: string;\n  parent_frame_id?: string;\n  depth: number;\n  type: FrameType;\n  name: string;\n  state: FrameState;\n  inputs: Record<string, any>;\n  outputs: Record<string, any>;\n  digest_text?: string;\n  digest_json: Record<string, any>;\n  created_at: number;\n  closed_at?: number;\n}\n\nexport interface FrameContext {\n  frameId: string;\n  header: {\n    goal: string;\n    constraints?: string[];\n    definitions?: Record<string, string>;\n  };\n  anchors: Anchor[];\n  recentEvents: Event[];\n  activeArtifacts: string[];\n}\n\nexport interface Anchor {\n  anchor_id: string;\n  frame_id: string;\n  type:\n    | 'FACT'\n    | 'DECISION'\n    | 'CONSTRAINT'\n    | 'INTERFACE_CONTRACT'\n    | 'TODO'\n    | 'RISK';\n  text: string;\n  priority: number;\n  metadata: Record<string, any>;\n}\n\nexport interface Event {\n  event_id: string;\n  frame_id: string;\n  run_id: string;\n  seq: number;\n  event_type:\n    | 'user_message'\n    | 'assistant_message'\n    | 'tool_call'\n    | 'tool_result'\n    | 'decision'\n    | 'constraint'\n    | 'artifact'\n    | 'observation';\n  payload: Record<string, any>;\n  ts: number;\n}\n\nexport interface FrameManagerOptions {\n  skipContextBridge?: boolean;\n  runId?: string;\n  maxFrameDepth?: number; // Maximum allowed frame depth (default: 100)\n}\n\nexport class FrameManager {\n  private db: Database.Database;\n  private currentRunId: string;\n  private sessionId: string;\n  private projectId: string;\n  private activeStack: string[] = []; // Stack of active frame IDs\n  private queryMode: FrameQueryMode = FrameQueryMode.PROJECT_ACTIVE;\n  private maxFrameDepth: number = DEFAULT_MAX_DEPTH;\n\n  constructor(\n    db: Database.Database,\n    projectId: string,\n    runIdOrOptions?: string | FrameManagerOptions\n  ) {\n    this.db = db;\n    this.projectId = projectId;\n\n    // Handle both legacy string runId and new options object\n    let runId: string | undefined;\n    let skipContextBridge = false;\n\n    if (typeof runIdOrOptions === 'string') {\n      runId = runIdOrOptions;\n    } else if (runIdOrOptions) {\n      runId = runIdOrOptions.runId;\n      skipContextBridge = runIdOrOptions.skipContextBridge || false;\n      this.maxFrameDepth = runIdOrOptions.maxFrameDepth || DEFAULT_MAX_DEPTH;\n    }\n\n    // Use session manager for run ID if available\n    const session = sessionManager.getCurrentSession();\n    if (session) {\n      this.currentRunId = session.runId;\n      this.sessionId = session.sessionId;\n    } else {\n      this.currentRunId = runId || uuidv4();\n      this.sessionId = this.currentRunId; // Fallback for legacy behavior\n    }\n\n    this.initializeSchema();\n    this.loadActiveStack();\n\n    // Initialize context bridge for automatic shared context\n    // Skip in test environment, when explicitly requested, or for CLI usage\n    const shouldInitializeBridge =\n      !skipContextBridge &&\n      process.env['NODE_ENV'] !== 'test' &&\n      !process.env['VITEST'] &&\n      !process.env['STACKMEMORY_CLI'];\n\n    if (shouldInitializeBridge) {\n      contextBridge\n        .initialize(this, {\n          autoSync: true,\n          syncInterval: 60000, // 1 minute\n          minFrameScore: 0.5, // Sync frames above 0.5 score\n          importantTags: ['decision', 'error', 'milestone', 'learning'],\n        })\n        .catch((error) => {\n          logger.warn('Failed to initialize context bridge', { error });\n        });\n    }\n  }\n\n  setQueryMode(mode: FrameQueryMode): void {\n    this.queryMode = mode;\n    this.loadActiveStack(); // Reload with new mode\n  }\n\n  private initializeSchema() {\n    const errorHandler = createErrorHandler({\n      operation: 'initializeSchema',\n      projectId: this.projectId,\n      runId: this.currentRunId,\n    });\n\n    try {\n      // Check if database is properly initialized\n      if (!this.db || typeof this.db.exec !== 'function') {\n        throw new DatabaseError(\n          'Database not properly initialized. Expected SQLite Database instance with exec() method.',\n          ErrorCode.DB_CONNECTION_FAILED,\n          { operation: 'initializeSchema' }\n        );\n      }\n\n      // Enforce referential integrity\n      this.db.pragma('foreign_keys = ON');\n\n      // Enhanced frames table matching architecture\n      this.db.exec(`\n        CREATE TABLE IF NOT EXISTS frames (\n          frame_id TEXT PRIMARY KEY,\n          run_id TEXT NOT NULL,\n          project_id TEXT NOT NULL,\n          parent_frame_id TEXT REFERENCES frames(frame_id),\n          depth INTEGER NOT NULL DEFAULT 0,\n          type TEXT NOT NULL,\n          name TEXT NOT NULL,\n          state TEXT DEFAULT 'active',\n          inputs TEXT DEFAULT '{}',\n          outputs TEXT DEFAULT '{}',\n          digest_text TEXT,\n          digest_json TEXT DEFAULT '{}',\n          created_at INTEGER DEFAULT (unixepoch()),\n          closed_at INTEGER\n        );\n\n        CREATE TABLE IF NOT EXISTS events (\n          event_id TEXT PRIMARY KEY,\n          run_id TEXT NOT NULL,\n          frame_id TEXT NOT NULL,\n          seq INTEGER NOT NULL,\n          event_type TEXT NOT NULL,\n          payload TEXT NOT NULL,\n          ts INTEGER DEFAULT (unixepoch()),\n          FOREIGN KEY(frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n        );\n\n        CREATE TABLE IF NOT EXISTS anchors (\n          anchor_id TEXT PRIMARY KEY,\n          frame_id TEXT NOT NULL,\n          project_id TEXT NOT NULL,\n          type TEXT NOT NULL,\n          text TEXT NOT NULL,\n          priority INTEGER DEFAULT 0,\n          created_at INTEGER DEFAULT (unixepoch()),\n          metadata TEXT DEFAULT '{}',\n          FOREIGN KEY(frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n        );\n\n        CREATE TABLE IF NOT EXISTS handoff_requests (\n          request_id TEXT PRIMARY KEY,\n          source_stack_id TEXT NOT NULL,\n          target_stack_id TEXT NOT NULL,\n          frame_ids TEXT NOT NULL,\n          status TEXT NOT NULL DEFAULT 'pending',\n          created_at INTEGER DEFAULT (unixepoch()),\n          expires_at INTEGER,\n          target_user_id TEXT,\n          message TEXT\n        );\n\n        CREATE INDEX IF NOT EXISTS idx_frames_run ON frames(run_id);\n        CREATE INDEX IF NOT EXISTS idx_frames_parent ON frames(parent_frame_id);\n        CREATE INDEX IF NOT EXISTS idx_frames_state ON frames(state);\n        CREATE INDEX IF NOT EXISTS idx_events_frame ON events(frame_id);\n        CREATE INDEX IF NOT EXISTS idx_events_seq ON events(frame_id, seq);\n        CREATE INDEX IF NOT EXISTS idx_anchors_frame ON anchors(frame_id);\n        CREATE INDEX IF NOT EXISTS idx_handoff_requests_status ON handoff_requests(status);\n        CREATE INDEX IF NOT EXISTS idx_handoff_requests_target ON handoff_requests(target_stack_id);\n      `);\n\n      // For existing databases, ensure cascade constraints are applied\n      try {\n        this.ensureCascadeConstraints();\n      } catch (e) {\n        logger.warn(\n          'Failed to ensure cascade constraints (frame-manager)',\n          e as Error\n        );\n      }\n    } catch (error: unknown) {\n      const dbError = errorHandler(error, {\n        operation: 'initializeSchema',\n        schema: 'frames',\n      });\n\n      if (dbError instanceof DatabaseError) {\n        throw new DatabaseError(\n          'Failed to initialize frame database schema',\n          ErrorCode.DB_MIGRATION_FAILED,\n          {\n            projectId: this.projectId,\n            operation: 'initializeSchema',\n            originalError: error,\n          },\n          error instanceof Error ? error : undefined\n        );\n      }\n      throw dbError;\n    }\n  }\n\n  // Ensure ON DELETE CASCADE for events/anchors referencing frames\n  private ensureCascadeConstraints(): void {\n    const needsCascade = (table: string): boolean => {\n      const rows = this.db\n        .prepare(`PRAGMA foreign_key_list(${table})`)\n        .all() as any[];\n      return rows.some(\n        (r) =>\n          r.table === 'frames' &&\n          String(r.on_delete).toUpperCase() !== 'CASCADE'\n      );\n    };\n\n    const migrateTable = (table: 'events' | 'anchors') => {\n      const createSql =\n        table === 'events'\n          ? `CREATE TABLE events_new (\n               event_id TEXT PRIMARY KEY,\n               run_id TEXT NOT NULL,\n               frame_id TEXT NOT NULL,\n               seq INTEGER NOT NULL,\n               event_type TEXT NOT NULL,\n               payload TEXT NOT NULL,\n               ts INTEGER DEFAULT (unixepoch()),\n               FOREIGN KEY(frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n             );`\n          : `CREATE TABLE anchors_new (\n               anchor_id TEXT PRIMARY KEY,\n               frame_id TEXT NOT NULL,\n               project_id TEXT NOT NULL,\n               type TEXT NOT NULL,\n               text TEXT NOT NULL,\n               priority INTEGER DEFAULT 0,\n               created_at INTEGER DEFAULT (unixepoch()),\n               metadata TEXT DEFAULT '{}',\n               FOREIGN KEY(frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE\n             );`;\n\n      const cols =\n        table === 'events'\n          ? 'event_id, run_id, frame_id, seq, event_type, payload, ts'\n          : 'anchor_id, frame_id, project_id, type, text, priority, created_at, metadata';\n\n      const idxSql =\n        table === 'events'\n          ? [\n              'CREATE INDEX IF NOT EXISTS idx_events_frame ON events(frame_id);',\n              'CREATE INDEX IF NOT EXISTS idx_events_seq ON events(frame_id, seq);',\n            ]\n          : [\n              'CREATE INDEX IF NOT EXISTS idx_anchors_frame ON anchors(frame_id);',\n            ];\n\n      this.db.exec('PRAGMA foreign_keys = OFF;');\n      this.db.exec('BEGIN;');\n      this.db.exec(createSql);\n      this.db\n        .prepare(\n          `INSERT INTO ${table === 'events' ? 'events_new' : 'anchors_new'} (${cols}) SELECT ${cols} FROM ${table}`\n        )\n        .run();\n      this.db.exec(`DROP TABLE ${table};`);\n      this.db.exec(`ALTER TABLE ${table}_new RENAME TO ${table};`);\n      for (const stmt of idxSql) this.db.exec(stmt);\n      this.db.exec('COMMIT;');\n      this.db.exec('PRAGMA foreign_keys = ON;');\n      logger.info(\n        `Migrated ${table} to include ON DELETE CASCADE (frame-manager)`\n      );\n    };\n\n    if (needsCascade('events')) migrateTable('events');\n    if (needsCascade('anchors')) migrateTable('anchors');\n  }\n\n  private loadActiveStack() {\n    const errorHandler = createErrorHandler({\n      operation: 'loadActiveStack',\n      runId: this.currentRunId,\n      projectId: this.projectId,\n    });\n\n    try {\n      let query: string;\n      let params: any[];\n\n      // Build query based on query mode\n      switch (this.queryMode) {\n        case FrameQueryMode.ALL_ACTIVE:\n          query = `\n            SELECT frame_id, parent_frame_id, depth\n            FROM frames\n            WHERE state = 'active'\n            ORDER BY created_at DESC, depth ASC\n          `;\n          params = [];\n          break;\n\n        case FrameQueryMode.PROJECT_ACTIVE:\n          query = `\n            SELECT frame_id, parent_frame_id, depth, run_id\n            FROM frames\n            WHERE state = 'active' AND project_id = ?\n            ORDER BY created_at DESC, depth ASC\n          `;\n          params = [this.projectId];\n          break;\n\n        case FrameQueryMode.HISTORICAL:\n          query = `\n            SELECT frame_id, parent_frame_id, depth\n            FROM frames\n            WHERE project_id = ?\n            ORDER BY created_at DESC, depth ASC\n          `;\n          params = [this.projectId];\n          break;\n\n        case FrameQueryMode.CURRENT_SESSION:\n        default:\n          query = `\n            SELECT frame_id, parent_frame_id, depth\n            FROM frames\n            WHERE run_id = ? AND state = 'active'\n            ORDER BY depth ASC\n          `;\n          params = [this.currentRunId];\n          break;\n      }\n\n      const activeFrames = this.db.prepare(query).all(...params) as Frame[];\n\n      // Rebuild stack order\n      this.activeStack = this.buildStackOrder(activeFrames);\n\n      logger.info('Loaded active stack', {\n        runId: this.currentRunId,\n        stackDepth: this.activeStack.length,\n        activeFrames: this.activeStack,\n        queryMode: this.queryMode,\n      });\n    } catch (error: unknown) {\n      const dbError = errorHandler(error, {\n        query: 'Frame loading query',\n        runId: this.currentRunId,\n        queryMode: this.queryMode,\n      });\n\n      if (dbError instanceof DatabaseError) {\n        throw new DatabaseError(\n          'Failed to load active frame stack',\n          ErrorCode.DB_QUERY_FAILED,\n          {\n            runId: this.currentRunId,\n            projectId: this.projectId,\n            operation: 'loadActiveStack',\n          },\n          error instanceof Error ? error : undefined\n        );\n      }\n      throw dbError;\n    }\n  }\n\n  private buildStackOrder(\n    frames: Pick<Frame, 'frame_id' | 'parent_frame_id' | 'depth'>[]\n  ): string[] {\n    const stack: string[] = [];\n\n    // Find root frame (no parent)\n    const rootFrame = frames.find((f) => !f.parent_frame_id);\n    if (!rootFrame) return [];\n\n    // Build stack by following parent-child relationships\n    let currentFrame = rootFrame;\n    stack.push(currentFrame.frame_id);\n\n    while (currentFrame) {\n      const childFrame = frames.find(\n        (f) => f.parent_frame_id === currentFrame.frame_id\n      );\n      if (!childFrame) break;\n      stack.push(childFrame.frame_id);\n      currentFrame = childFrame;\n    }\n\n    return stack;\n  }\n\n  /**\n   * Create a new frame and push to stack\n   */\n  public createFrame(options: {\n    type: FrameType;\n    name: string;\n    inputs?: Record<string, any>;\n    parentFrameId?: string;\n  }): string {\n    return this._createFrame(options);\n  }\n\n  private _createFrame(options: {\n    type: FrameType;\n    name: string;\n    inputs?: Record<string, any>;\n    parentFrameId?: string;\n  }): string {\n    const frameId = uuidv4();\n    const parentFrameId = options.parentFrameId || this.getCurrentFrameId();\n    const depth = parentFrameId ? this.getFrameDepth(parentFrameId) + 1 : 0;\n\n    // Check for depth limit\n    if (depth > this.maxFrameDepth) {\n      throw new FrameError(\n        `Maximum frame depth exceeded: ${depth} > ${this.maxFrameDepth}`,\n        ErrorCode.FRAME_STACK_OVERFLOW,\n        {\n          currentDepth: depth,\n          maxDepth: this.maxFrameDepth,\n          frameId,\n          parentFrameId,\n          frameName: options.name,\n        }\n      );\n    }\n\n    // Check for circular reference before creating frame\n    if (parentFrameId) {\n      const cycle = this.detectCycle(frameId, parentFrameId);\n      if (cycle) {\n        throw new FrameError(\n          `Circular reference detected in frame hierarchy`,\n          ErrorCode.FRAME_CYCLE_DETECTED,\n          {\n            frameId,\n            parentFrameId,\n            cycle,\n            frameName: options.name,\n          }\n        );\n      }\n    }\n\n    const frame: Omit<\n      Frame,\n      'outputs' | 'digest_text' | 'digest_json' | 'closed_at'\n    > = {\n      frame_id: frameId,\n      run_id: this.currentRunId,\n      project_id: this.projectId,\n      parent_frame_id: parentFrameId,\n      depth,\n      type: options.type,\n      name: options.name,\n      state: 'active',\n      inputs: options.inputs || {},\n      created_at: Math.floor(Date.now() / 1000),\n    };\n\n    try {\n      this.db\n        .prepare(\n          `\n        INSERT INTO frames (\n          frame_id, run_id, project_id, parent_frame_id, depth, type, name, state, inputs, created_at\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n      `\n        )\n        .run(\n          frame.frame_id,\n          frame.run_id,\n          frame.project_id,\n          frame.parent_frame_id,\n          frame.depth,\n          frame.type,\n          frame.name,\n          frame.state,\n          JSON.stringify(frame.inputs),\n          frame.created_at\n        );\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to create frame: ${options.name}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          frameId,\n          frameType: options.type,\n          frameName: options.name,\n          parentFrameId,\n          depth,\n          operation: 'createFrame',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    // Push to active stack\n    this.activeStack.push(frameId);\n\n    logger.info('Created frame', {\n      frameId,\n      type: options.type,\n      name: options.name,\n      depth,\n      parentFrameId,\n      stackDepth: this.activeStack.length,\n    });\n\n    return frameId;\n  }\n\n  /**\n   * Close the current frame and generate digest\n   */\n  public closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    this._closeFrame(frameId, outputs);\n  }\n\n  private _closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    const targetFrameId = frameId || this.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame to close',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          operation: 'closeFrame',\n          activeStack: this.activeStack,\n          stackDepth: this.activeStack.length,\n        }\n      );\n    }\n\n    // Get frame details\n    const frame = this.getFrame(targetFrameId);\n    if (!frame) {\n      throw new FrameError(\n        `Frame not found: ${targetFrameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        {\n          frameId: targetFrameId,\n          operation: 'closeFrame',\n          runId: this.currentRunId,\n        }\n      );\n    }\n\n    if (frame.state === 'closed') {\n      logger.warn('Attempted to close already closed frame', {\n        frameId: targetFrameId,\n      });\n      return;\n    }\n\n    // Generate digest before closing\n    const digest = this.generateDigest(targetFrameId);\n    const finalOutputs = { ...outputs, ...digest.structured };\n\n    try {\n      // Update frame to closed state\n      this.db\n        .prepare(\n          `\n        UPDATE frames\n        SET state = 'closed',\n            outputs = ?,\n            digest_text = ?,\n            digest_json = ?,\n            closed_at = unixepoch()\n        WHERE frame_id = ?\n      `\n        )\n        .run(\n          JSON.stringify(finalOutputs),\n          digest.text,\n          JSON.stringify(digest.structured),\n          targetFrameId\n        );\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to close frame: ${targetFrameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          frameId: targetFrameId,\n          frameName: frame.name,\n          operation: 'closeFrame',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    // Remove from active stack\n    this.activeStack = this.activeStack.filter((id) => id !== targetFrameId);\n\n    // Close all child frames recursively\n    this.closeChildFrames(targetFrameId);\n\n    // Trigger WhatsApp auto-sync if enabled (fire and forget)\n    this.triggerWhatsAppSync(frame, targetFrameId).catch(() => {\n      // Silently ignore errors - sync is non-critical\n    });\n\n    logger.info('Closed frame', {\n      frameId: targetFrameId,\n      name: frame.name,\n      duration: Math.floor(Date.now() / 1000) - frame.created_at,\n      digestLength: digest.text.length,\n      stackDepth: this.activeStack.length,\n    });\n  }\n\n  /**\n   * Trigger WhatsApp sync for closed frame (non-blocking)\n   */\n  private async triggerWhatsAppSync(\n    frame: Frame,\n    frameId: string\n  ): Promise<void> {\n    const sync = await loadWhatsAppSync();\n    if (!sync) return;\n\n    try {\n      const events = this.getFrameEvents(frameId);\n      const anchors = this.getFrameAnchors(frameId);\n      const digestData = sync.createFrameDigestData(frame, events, anchors);\n      await sync.onFrameClosed(digestData);\n    } catch {\n      // Silently ignore - WhatsApp sync is optional\n    }\n  }\n\n  /**\n   * Delete a frame completely from the database (used in handoffs)\n   */\n  deleteFrame(frameId: string): void {\n    try {\n      // First delete related data\n      this.db.prepare('DELETE FROM events WHERE frame_id = ?').run(frameId);\n      this.db.prepare('DELETE FROM anchors WHERE frame_id = ?').run(frameId);\n\n      // Remove from active stack if present\n      this.activeStack = this.activeStack.filter((id) => id !== frameId);\n\n      // Delete the frame itself\n      this.db.prepare('DELETE FROM frames WHERE frame_id = ?').run(frameId);\n\n      logger.debug('Deleted frame completely', { frameId });\n    } catch (error: unknown) {\n      logger.error('Failed to delete frame', { frameId, error });\n      throw error;\n    }\n  }\n\n  private closeChildFrames(parentFrameId: string) {\n    try {\n      const children = this.db\n        .prepare(\n          `\n        SELECT frame_id FROM frames\n        WHERE parent_frame_id = ? AND state = 'active'\n      `\n        )\n        .all(parentFrameId) as { frame_id: string }[];\n\n      children.forEach((child) => {\n        try {\n          this.closeFrame(child.frame_id);\n        } catch (error: unknown) {\n          logger.error(\n            'Failed to close child frame',\n            error instanceof Error ? error : new Error(String(error)),\n            {\n              parentFrameId,\n              childFrameId: child.frame_id,\n            }\n          );\n        }\n      });\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to close child frames for parent: ${parentFrameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          parentFrameId,\n          operation: 'closeChildFrames',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Generate digest for a frame\n   */\n  private generateDigest(frameId: string): {\n    text: string;\n    structured: Record<string, any>;\n  } {\n    const frame = this.getFrame(frameId);\n    const events = this.getFrameEvents(frameId);\n    const anchors = this.getFrameAnchors(frameId);\n\n    if (!frame) {\n      throw new FrameError(\n        `Cannot generate digest: frame not found ${frameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        {\n          frameId,\n          operation: 'generateDigest',\n          runId: this.currentRunId,\n        }\n      );\n    }\n\n    // Extract key information\n    const decisions = anchors.filter((a) => a.type === 'DECISION');\n    const constraints = anchors.filter((a) => a.type === 'CONSTRAINT');\n    const risks = anchors.filter((a) => a.type === 'RISK');\n\n    const toolCalls = events.filter((e) => e.event_type === 'tool_call');\n    const artifacts = events.filter((e) => e.event_type === 'artifact');\n\n    // Generate structured digest\n    const structured = {\n      result: frame.name,\n      decisions: decisions.map((d) => ({ id: d.anchor_id, text: d.text })),\n      constraints: constraints.map((c) => ({ id: c.anchor_id, text: c.text })),\n      risks: risks.map((r) => ({ id: r.anchor_id, text: r.text })),\n      artifacts: artifacts.map((a) => ({\n        kind: a.payload.kind || 'unknown',\n        ref: a.payload.ref,\n      })),\n      tool_calls_count: toolCalls.length,\n      duration_seconds: frame.closed_at\n        ? frame.closed_at - frame.created_at\n        : 0,\n    };\n\n    // Generate text summary\n    const text = this.generateDigestText(frame, structured, events.length);\n\n    return { text, structured };\n  }\n\n  private generateDigestText(\n    frame: Frame,\n    structured: any,\n    eventCount: number\n  ): string {\n    let summary = `Completed: ${frame.name}\\n`;\n\n    if (structured.decisions.length > 0) {\n      summary += `\\nDecisions made:\\n${structured.decisions.map((d: any) => `- ${d.text}`).join('\\n')}`;\n    }\n\n    if (structured.constraints.length > 0) {\n      summary += `\\nConstraints established:\\n${structured.constraints.map((c: any) => `- ${c.text}`).join('\\n')}`;\n    }\n\n    if (structured.risks.length > 0) {\n      summary += `\\nRisks identified:\\n${structured.risks.map((r: any) => `- ${r.text}`).join('\\n')}`;\n    }\n\n    summary += `\\nActivity: ${eventCount} events, ${structured.tool_calls_count} tool calls`;\n\n    if (structured.duration_seconds > 0) {\n      summary += `, ${Math.floor(structured.duration_seconds / 60)}m ${structured.duration_seconds % 60}s duration`;\n    }\n\n    return summary;\n  }\n\n  /**\n   * Add event to current frame\n   */\n  public addEvent(\n    eventType: Event['event_type'],\n    payload: Record<string, any>,\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for event',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          operation: 'addEvent',\n          eventType,\n          activeStack: this.activeStack,\n        }\n      );\n    }\n\n    const eventId = uuidv4();\n    const seq = this.getNextEventSequence(targetFrameId);\n\n    try {\n      this.db\n        .prepare(\n          `\n        INSERT INTO events (event_id, run_id, frame_id, seq, event_type, payload)\n        VALUES (?, ?, ?, ?, ?, ?)\n      `\n        )\n        .run(\n          eventId,\n          this.currentRunId,\n          targetFrameId,\n          seq,\n          eventType,\n          JSON.stringify(payload)\n        );\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to add event to frame: ${targetFrameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          eventId,\n          frameId: targetFrameId,\n          eventType,\n          seq,\n          operation: 'addEvent',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    return eventId;\n  }\n\n  /**\n   * Add anchor to frame\n   */\n  public addAnchor(\n    type: Anchor['type'],\n    text: string,\n    priority: number = 0,\n    metadata: Record<string, any> = {},\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for anchor',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          operation: 'addAnchor',\n          anchorType: type,\n          text: text.substring(0, 100),\n          activeStack: this.activeStack,\n        }\n      );\n    }\n\n    const anchorId = uuidv4();\n\n    try {\n      this.db\n        .prepare(\n          `\n        INSERT INTO anchors (anchor_id, frame_id, project_id, type, text, priority, metadata)\n        VALUES (?, ?, ?, ?, ?, ?, ?)\n      `\n        )\n        .run(\n          anchorId,\n          targetFrameId,\n          this.projectId,\n          type,\n          text,\n          priority,\n          JSON.stringify(metadata)\n        );\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to add anchor to frame: ${targetFrameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          anchorId,\n          frameId: targetFrameId,\n          anchorType: type,\n          operation: 'addAnchor',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n\n    return anchorId;\n  }\n\n  /**\n   * Get hot stack context for current active frames\n   */\n  public getHotStackContext(maxEvents: number = 20): FrameContext[] {\n    return this.activeStack\n      .map((frameId) => {\n        const frame = this.getFrame(frameId);\n        if (!frame) return null;\n\n        return {\n          frameId,\n          header: {\n            goal: frame.name,\n            constraints: this.extractConstraints(frame.inputs),\n            definitions: frame.inputs.definitions,\n          },\n          anchors: this.getFrameAnchors(frameId),\n          recentEvents: this.getFrameEvents(frameId, maxEvents),\n          activeArtifacts: this.getActiveArtifacts(frameId),\n        };\n      })\n      .filter(Boolean) as FrameContext[];\n  }\n\n  /**\n   * Get active frame path (root to current)\n   */\n  public getActiveFramePath(): Frame[] {\n    return this.activeStack\n      .map((frameId) => this.getFrame(frameId))\n      .filter(Boolean) as Frame[];\n  }\n\n  // Utility methods\n  public getCurrentFrameId(): string | undefined {\n    return this.activeStack[this.activeStack.length - 1];\n  }\n\n  public getStackDepth(): number {\n    return this.activeStack.length;\n  }\n\n  /**\n   * Get recent frames for context sharing\n   */\n  public async getRecentFrames(limit: number = 100): Promise<Frame[]> {\n    try {\n      const rows = this.db\n        .prepare(\n          `\n          SELECT * FROM frames \n          WHERE project_id = ?\n          ORDER BY created_at DESC\n          LIMIT ?\n        `\n        )\n        .all(this.projectId, limit) as any[];\n\n      return rows.map((row) => ({\n        ...row,\n        frameId: row.frame_id,\n        runId: row.run_id,\n        projectId: row.project_id,\n        parentFrameId: row.parent_frame_id,\n        title: row.name,\n        timestamp: row.created_at,\n        metadata: {\n          tags: this.extractTagsFromFrame(row),\n          importance: this.calculateFrameImportance(row),\n        },\n        data: {\n          inputs: JSON.parse(row.inputs || '{}'),\n          outputs: JSON.parse(row.outputs || '{}'),\n          digest: JSON.parse(row.digest_json || '{}'),\n        },\n        inputs: JSON.parse(row.inputs || '{}'),\n        outputs: JSON.parse(row.outputs || '{}'),\n        digest_json: JSON.parse(row.digest_json || '{}'),\n      }));\n    } catch (error: unknown) {\n      logger.error('Failed to get recent frames', error as Error);\n      return [];\n    }\n  }\n\n  /**\n   * Add context metadata to the current frame\n   */\n  public async addContext(key: string, value: any): Promise<void> {\n    const currentFrameId = this.getCurrentFrameId();\n    if (!currentFrameId) return;\n\n    try {\n      const frame = this.getFrame(currentFrameId);\n      if (!frame) return;\n\n      const metadata = frame.outputs || {};\n      metadata[key] = value;\n\n      this.db\n        .prepare(`UPDATE frames SET outputs = ? WHERE frame_id = ?`)\n        .run(JSON.stringify(metadata), currentFrameId);\n    } catch (error: unknown) {\n      logger.warn('Failed to add context to frame', { error, key });\n    }\n  }\n\n  private extractTagsFromFrame(frame: any): string[] {\n    const tags: string[] = [];\n\n    // Add type as tag\n    if (frame.type) tags.push(frame.type);\n\n    // Extract tags from name\n    if (frame.name) {\n      if (frame.name.toLowerCase().includes('error')) tags.push('error');\n      if (frame.name.toLowerCase().includes('fix')) tags.push('resolution');\n      if (frame.name.toLowerCase().includes('decision')) tags.push('decision');\n      if (frame.name.toLowerCase().includes('milestone'))\n        tags.push('milestone');\n    }\n\n    // Extract from digest\n    try {\n      const digest = JSON.parse(frame.digest_json || '{}');\n      if (digest.tags) tags.push(...digest.tags);\n    } catch {}\n\n    return [...new Set(tags)];\n  }\n\n  private calculateFrameImportance(frame: any): 'high' | 'medium' | 'low' {\n    // Milestones and decisions are high importance\n    if (frame.type === 'milestone' || frame.name?.includes('decision'))\n      return 'high';\n\n    // Errors and resolutions are medium importance\n    if (frame.type === 'error' || frame.type === 'resolution') return 'medium';\n\n    // Long-running frames are potentially important\n    if (frame.closed_at && frame.created_at) {\n      const duration = frame.closed_at - frame.created_at;\n      if (duration > 300) return 'medium'; // More than 5 minutes\n    }\n\n    return 'low';\n  }\n\n  private getFrameDepth(frameId: string): number {\n    const frame = this.getFrame(frameId);\n    return frame?.depth || 0;\n  }\n\n  public getFrame(frameId: string): Frame | undefined {\n    try {\n      const row = this.db\n        .prepare(\n          `\n        SELECT * FROM frames WHERE frame_id = ?\n      `\n        )\n        .get(frameId) as any;\n\n      if (!row) return undefined;\n\n      return {\n        ...row,\n        inputs: JSON.parse(row.inputs || '{}'),\n        outputs: JSON.parse(row.outputs || '{}'),\n        digest_json: JSON.parse(row.digest_json || '{}'),\n      };\n    } catch (error: unknown) {\n      // Log the error but return undefined instead of throwing\n      logger.warn(`Failed to get frame: ${frameId}`, {\n        error: error instanceof Error ? error.message : String(error),\n        frameId,\n        operation: 'getFrame',\n      });\n      return undefined;\n    }\n  }\n\n  public getFrameEvents(frameId: string, limit?: number): Event[] {\n    try {\n      const query = limit\n        ? `SELECT * FROM events WHERE frame_id = ? ORDER BY seq DESC LIMIT ?`\n        : `SELECT * FROM events WHERE frame_id = ? ORDER BY seq ASC`;\n\n      const params = limit ? [frameId, limit] : [frameId];\n      const rows = this.db.prepare(query).all(...params) as any[];\n\n      return rows.map((row) => ({\n        ...row,\n        payload: JSON.parse(row.payload),\n      }));\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to get frame events: ${frameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          frameId,\n          limit,\n          operation: 'getFrameEvents',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  private getFrameAnchors(frameId: string): Anchor[] {\n    try {\n      const rows = this.db\n        .prepare(\n          `\n        SELECT * FROM anchors WHERE frame_id = ? ORDER BY priority DESC, created_at ASC\n      `\n        )\n        .all(frameId) as any[];\n\n      return rows.map((row) => ({\n        ...row,\n        metadata: JSON.parse(row.metadata || '{}'),\n      }));\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to get frame anchors: ${frameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          frameId,\n          operation: 'getFrameAnchors',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  private getNextEventSequence(frameId: string): number {\n    try {\n      const result = this.db\n        .prepare(\n          `\n        SELECT MAX(seq) as max_seq FROM events WHERE frame_id = ?\n      `\n        )\n        .get(frameId) as { max_seq: number | null };\n\n      return (result.max_seq || 0) + 1;\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to get next event sequence for frame: ${frameId}`,\n        ErrorCode.DB_QUERY_FAILED,\n        {\n          frameId,\n          operation: 'getNextEventSequence',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  private extractConstraints(\n    inputs: Record<string, any>\n  ): string[] | undefined {\n    return inputs.constraints;\n  }\n\n  private getActiveArtifacts(frameId: string): string[] {\n    const artifacts = this.getFrameEvents(frameId)\n      .filter((e) => e.event_type === 'artifact')\n      .map((e) => e.payload.ref)\n      .filter(Boolean);\n\n    return artifacts;\n  }\n\n  /**\n   * Detect if setting a parent frame would create a cycle in the frame hierarchy.\n   * Returns the cycle path if detected, or null if no cycle.\n   * @param childFrameId - The frame that would be the child\n   * @param parentFrameId - The proposed parent frame\n   * @returns Array of frame IDs forming the cycle, or null if no cycle\n   */\n  private detectCycle(\n    childFrameId: string,\n    parentFrameId: string\n  ): string[] | null {\n    const visited = new Set<string>();\n    const path: string[] = [];\n\n    // Start from the proposed parent and traverse up the hierarchy\n    let currentId: string | undefined = parentFrameId;\n\n    while (currentId) {\n      // If we've seen this frame before, we have a cycle\n      if (visited.has(currentId)) {\n        // Build the cycle path\n        const cycleStart = path.indexOf(currentId);\n        return path.slice(cycleStart).concat(currentId);\n      }\n\n      // If the current frame is the child we're trying to add, it's a cycle\n      if (currentId === childFrameId) {\n        return path.concat([currentId, childFrameId]);\n      }\n\n      visited.add(currentId);\n      path.push(currentId);\n\n      // Move to the parent of current frame\n      const frame = this.getFrame(currentId);\n      if (!frame) {\n        // Frame not found, no cycle possible through this path\n        break;\n      }\n      currentId = frame.parent_frame_id;\n\n      // Safety check: if we've traversed too many levels, something is wrong\n      if (path.length > this.maxFrameDepth) {\n        throw new FrameError(\n          `Frame hierarchy traversal exceeded maximum depth during cycle detection`,\n          ErrorCode.FRAME_STACK_OVERFLOW,\n          {\n            depth: path.length,\n            maxDepth: this.maxFrameDepth,\n            path,\n          }\n        );\n      }\n    }\n\n    return null; // No cycle detected\n  }\n\n  /**\n   * Update parent frame of an existing frame (with cycle detection)\n   * @param frameId - The frame to update\n   * @param newParentFrameId - The new parent frame ID\n   */\n  public updateParentFrame(\n    frameId: string,\n    newParentFrameId: string | null\n  ): void {\n    // Check if frame exists\n    const frame = this.getFrame(frameId);\n    if (!frame) {\n      throw new FrameError(\n        `Frame not found: ${frameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        { frameId }\n      );\n    }\n\n    // If setting a parent, check for cycles\n    if (newParentFrameId) {\n      const cycle = this.detectCycle(frameId, newParentFrameId);\n      if (cycle) {\n        throw new FrameError(\n          `Cannot set parent: would create circular reference`,\n          ErrorCode.FRAME_CYCLE_DETECTED,\n          {\n            frameId,\n            newParentFrameId,\n            cycle,\n            currentParentId: frame.parent_frame_id,\n          }\n        );\n      }\n\n      // Check depth after parent change\n      const newParentFrame = this.getFrame(newParentFrameId);\n      if (newParentFrame) {\n        const newDepth = newParentFrame.depth + 1;\n        if (newDepth > this.maxFrameDepth) {\n          throw new FrameError(\n            `Cannot set parent: would exceed maximum frame depth`,\n            ErrorCode.FRAME_STACK_OVERFLOW,\n            {\n              frameId,\n              newParentFrameId,\n              newDepth,\n              maxDepth: this.maxFrameDepth,\n            }\n          );\n        }\n      }\n    }\n\n    try {\n      // Update the parent frame\n      this.db\n        .prepare(`UPDATE frames SET parent_frame_id = ? WHERE frame_id = ?`)\n        .run(newParentFrameId, frameId);\n\n      logger.info('Updated parent frame', {\n        frameId,\n        oldParentId: frame.parent_frame_id,\n        newParentId: newParentFrameId,\n      });\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        `Failed to update parent frame`,\n        ErrorCode.DB_UPDATE_FAILED,\n        {\n          frameId,\n          newParentFrameId,\n          operation: 'updateParentFrame',\n        },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/core/context/frame-recovery.js

@@ -1,302 +0,0 @@
-import { fileURLToPath as __fileURLToPath } from 'url';
-import { dirname as __pathDirname } from 'path';
-const __filename = __fileURLToPath(import.meta.url);
-const __dirname = __pathDirname(__filename);
-import { logger } from "../monitoring/logger.js";
-class FrameRecovery {
-  constructor(db, options = {}) {
-    this.db = db;
-    this.orphanThresholdMs = (options.orphanThresholdHours ?? 24) * 60 * 60 * 1e3;
-  }
-  // Sessions older than this are considered orphaned (default: 24 hours)
-  orphanThresholdMs;
-  // Current session/run ID to exclude from orphan detection
-  currentRunId = null;
-  /**
-   * Set the current run ID to exclude from orphan detection
-   */
-  setCurrentRunId(runId) {
-    this.currentRunId = runId;
-  }
-  /**
-   * Main recovery entry point - call on startup
-   */
-  async recoverOnStartup() {
-    const errors = [];
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    logger.info("Starting crash recovery check");
-    const walStatus = this.checkWalStatus();
-    if (walStatus.checkpointNeeded) {
-      try {
-        this.checkpointWal();
-        logger.info("WAL checkpoint completed");
-      } catch (err) {
-        const msg = `WAL checkpoint failed: ${err instanceof Error ? err.message : String(err)}`;
-        errors.push(msg);
-        logger.warn(msg);
-      }
-    }
-    const integrityCheck = this.runIntegrityCheck();
-    if (!integrityCheck.passed) {
-      logger.error("Database integrity check failed", {
-        violations: integrityCheck.foreignKeyViolations,
-        corrupted: integrityCheck.corruptedRows
-      });
-    }
-    const orphanedFrames = this.recoverOrphanedFrames();
-    if (orphanedFrames.detected > 0) {
-      logger.info("Orphaned frames processed", {
-        detected: orphanedFrames.detected,
-        recovered: orphanedFrames.recovered,
-        closed: orphanedFrames.closed
-      });
-    }
-    const report = {
-      timestamp,
-      integrityCheck,
-      orphanedFrames,
-      walStatus,
-      recovered: integrityCheck.passed && orphanedFrames.detected === orphanedFrames.closed,
-      errors
-    };
-    logger.info("Crash recovery completed", {
-      recovered: report.recovered,
-      orphansFound: orphanedFrames.detected,
-      integrityPassed: integrityCheck.passed
-    });
-    return report;
-  }
-  /**
-   * Check WAL mode status
-   */
-  checkWalStatus() {
-    try {
-      const journalMode = this.db.pragma("journal_mode");
-      const isWal = journalMode[0]?.journal_mode === "wal";
-      if (!isWal) {
-        return { enabled: false, checkpointNeeded: false, walSize: 0 };
-      }
-      const walInfo = this.db.pragma("wal_checkpoint(PASSIVE)");
-      const walSize = walInfo[0]?.log ?? 0;
-      const checkpointed = walInfo[0]?.checkpointed ?? 0;
-      return {
-        enabled: true,
-        checkpointNeeded: walSize > 1e3,
-        // Checkpoint if WAL has > 1000 pages
-        walSize: walSize - checkpointed
-      };
-    } catch (err) {
-      logger.warn("Failed to check WAL status", { error: err });
-      return { enabled: false, checkpointNeeded: false, walSize: 0 };
-    }
-  }
-  /**
-   * Force WAL checkpoint
-   */
-  checkpointWal() {
-    this.db.pragma("wal_checkpoint(TRUNCATE)");
-  }
-  /**
-   * Run database integrity checks
-   */
-  runIntegrityCheck() {
-    const errors = [];
-    let foreignKeyViolations = 0;
-    let corruptedRows = 0;
-    try {
-      const fkViolations = this.db.pragma(
-        "foreign_key_check"
-      );
-      foreignKeyViolations = fkViolations.length;
-      if (foreignKeyViolations > 0) {
-        errors.push(`Found ${foreignKeyViolations} foreign key violations`);
-        logger.warn("Foreign key violations detected", {
-          count: foreignKeyViolations,
-          samples: fkViolations.slice(0, 5)
-        });
-      }
-      const integrity = this.db.pragma("integrity_check");
-      const integrityResult = integrity[0]?.integrity_check;
-      if (integrityResult !== "ok") {
-        corruptedRows = integrity.length;
-        errors.push(`Integrity check failed: ${integrityResult}`);
-        logger.error("Database corruption detected", {
-          result: integrityResult
-        });
-      }
-    } catch (err) {
-      errors.push(
-        `Integrity check error: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    return {
-      passed: foreignKeyViolations === 0 && corruptedRows === 0,
-      foreignKeyViolations,
-      corruptedRows,
-      errors
-    };
-  }
-  /**
-   * Detect and recover orphaned frames
-   * Orphaned = active frames from sessions that are no longer running
-   */
-  recoverOrphanedFrames() {
-    const orphanThreshold = Date.now() - this.orphanThresholdMs;
-    const thresholdUnix = Math.floor(orphanThreshold / 1e3);
-    const query = `
-      SELECT frame_id, run_id, project_id, name, type, created_at, depth
-      FROM frames
-      WHERE state = 'active'
-        AND created_at < ?
-        ${this.currentRunId ? "AND run_id != ?" : ""}
-      ORDER BY created_at ASC
-    `;
-    const params = this.currentRunId ? [thresholdUnix, this.currentRunId] : [thresholdUnix];
-    const orphaned = this.db.prepare(query).all(...params);
-    if (orphaned.length === 0) {
-      return { detected: 0, recovered: 0, closed: 0, frameIds: [] };
-    }
-    const frameIds = orphaned.map((f) => f.frame_id);
-    let closed = 0;
-    const closeStmt = this.db.prepare(`
-      UPDATE frames
-      SET state = 'closed',
-          closed_at = unixepoch(),
-          outputs = json_set(COALESCE(outputs, '{}'), '$.recovered', true, '$.recoveryReason', 'orphan_cleanup')
-      WHERE frame_id = ?
-    `);
-    const transaction = this.db.transaction(() => {
-      for (const frame of orphaned) {
-        try {
-          closeStmt.run(frame.frame_id);
-          closed++;
-          logger.debug("Closed orphaned frame", {
-            frameId: frame.frame_id,
-            runId: frame.run_id,
-            name: frame.name,
-            age: Math.round((Date.now() / 1e3 - frame.created_at) / 3600) + "h"
-          });
-        } catch (err) {
-          logger.warn("Failed to close orphaned frame", {
-            frameId: frame.frame_id,
-            error: err
-          });
-        }
-      }
-    });
-    transaction();
-    return {
-      detected: orphaned.length,
-      recovered: 0,
-      // Future: could attempt to resume some frames
-      closed,
-      frameIds
-    };
-  }
-  /**
-   * Validate data integrity for a specific project
-   */
-  validateProjectIntegrity(projectId) {
-    const issues = [];
-    const invalidParents = this.db.prepare(
-      `
-      SELECT f1.frame_id, f1.parent_frame_id
-      FROM frames f1
-      LEFT JOIN frames f2 ON f1.parent_frame_id = f2.frame_id
-      WHERE f1.project_id = ?
-        AND f1.parent_frame_id IS NOT NULL
-        AND f2.frame_id IS NULL
-    `
-    ).all(projectId);
-    if (invalidParents.length > 0) {
-      issues.push(
-        `${invalidParents.length} frames with invalid parent references`
-      );
-    }
-    const depthIssues = this.db.prepare(
-      `
-      SELECT f1.frame_id, f1.depth as child_depth, f2.depth as parent_depth
-      FROM frames f1
-      JOIN frames f2 ON f1.parent_frame_id = f2.frame_id
-      WHERE f1.project_id = ?
-        AND f1.depth != f2.depth + 1
-    `
-    ).all(projectId);
-    if (depthIssues.length > 0) {
-      issues.push(`${depthIssues.length} frames with incorrect depth values`);
-    }
-    const orphanEvents = this.db.prepare(
-      `
-      SELECT COUNT(*) as count
-      FROM events e
-      LEFT JOIN frames f ON e.frame_id = f.frame_id
-      WHERE f.frame_id IS NULL
-    `
-    ).get();
-    if (orphanEvents.count > 0) {
-      issues.push(`${orphanEvents.count} orphaned events without valid frames`);
-    }
-    return {
-      valid: issues.length === 0,
-      issues
-    };
-  }
-  /**
-   * Clean up orphaned events (events without valid frames)
-   */
-  cleanupOrphanedEvents() {
-    const result = this.db.prepare(
-      `
-      DELETE FROM events
-      WHERE frame_id NOT IN (SELECT frame_id FROM frames)
-    `
-    ).run();
-    if (result.changes > 0) {
-      logger.info("Cleaned up orphaned events", { count: result.changes });
-    }
-    return result.changes;
-  }
-  /**
-   * Get recovery statistics
-   */
-  getRecoveryStats() {
-    const stats = this.db.prepare(
-      `
-      SELECT
-        COUNT(*) as total,
-        SUM(CASE WHEN state = 'active' THEN 1 ELSE 0 END) as active,
-        SUM(CASE WHEN state = 'closed' THEN 1 ELSE 0 END) as closed,
-        SUM(CASE WHEN json_extract(outputs, '$.recovered') = true THEN 1 ELSE 0 END) as recovered
-      FROM frames
-    `
-    ).get();
-    const oldest = this.db.prepare(
-      `
-      SELECT datetime(created_at, 'unixepoch') as created
-      FROM frames
-      WHERE state = 'active'
-      ORDER BY created_at ASC
-      LIMIT 1
-    `
-    ).get();
-    return {
-      totalFrames: stats.total,
-      activeFrames: stats.active,
-      closedFrames: stats.closed,
-      recoveredFrames: stats.recovered,
-      oldestActiveFrame: oldest?.created ?? null
-    };
-  }
-}
-async function recoverDatabase(db, currentRunId) {
-  const recovery = new FrameRecovery(db);
-  if (currentRunId) {
-    recovery.setCurrentRunId(currentRunId);
-  }
-  return recovery.recoverOnStartup();
-}
-export {
-  FrameRecovery,
-  recoverDatabase
-};
-//# sourceMappingURL=frame-recovery.js.map

package/dist/core/context/frame-recovery.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/core/context/frame-recovery.ts"],
-  "sourcesContent": ["/**\n * Frame Recovery System\n * Handles crash recovery, integrity checks, and orphan cleanup\n *\n * Key responsibilities:\n * 1. Verify database integrity on startup\n * 2. Detect orphaned frames from crashed sessions\n * 3. Recover or close orphaned frames\n * 4. Provide data integrity validation\n */\n\nimport Database from 'better-sqlite3';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface RecoveryReport {\n  timestamp: string;\n  integrityCheck: IntegrityCheckResult;\n  orphanedFrames: OrphanedFrameResult;\n  walStatus: WalStatus;\n  recovered: boolean;\n  errors: string[];\n}\n\nexport interface IntegrityCheckResult {\n  passed: boolean;\n  foreignKeyViolations: number;\n  corruptedRows: number;\n  errors: string[];\n}\n\nexport interface OrphanedFrameResult {\n  detected: number;\n  recovered: number;\n  closed: number;\n  frameIds: string[];\n}\n\nexport interface WalStatus {\n  enabled: boolean;\n  checkpointNeeded: boolean;\n  walSize: number;\n}\n\ninterface OrphanedFrameRow {\n  frame_id: string;\n  run_id: string;\n  project_id: string;\n  name: string;\n  type: string;\n  created_at: number;\n  depth: number;\n}\n\ninterface ForeignKeyViolation {\n  table: string;\n  rowid: number;\n  parent: string;\n  fkid: number;\n}\n\ninterface IntegrityRow {\n  integrity_check: string;\n}\n\ninterface WalRow {\n  busy: number;\n  log: number;\n  checkpointed: number;\n}\n\ninterface JournalModeRow {\n  journal_mode: string;\n}\n\n/**\n * Frame Recovery Manager\n * Call recoverOnStartup() when initializing StackMemory\n */\nexport class FrameRecovery {\n  // Sessions older than this are considered orphaned (default: 24 hours)\n  private orphanThresholdMs: number;\n  // Current session/run ID to exclude from orphan detection\n  private currentRunId: string | null = null;\n\n  constructor(\n    private db: Database.Database,\n    options: { orphanThresholdHours?: number } = {}\n  ) {\n    this.orphanThresholdMs =\n      (options.orphanThresholdHours ?? 24) * 60 * 60 * 1000;\n  }\n\n  /**\n   * Set the current run ID to exclude from orphan detection\n   */\n  setCurrentRunId(runId: string): void {\n    this.currentRunId = runId;\n  }\n\n  /**\n   * Main recovery entry point - call on startup\n   */\n  async recoverOnStartup(): Promise<RecoveryReport> {\n    const errors: string[] = [];\n    const timestamp = new Date().toISOString();\n\n    logger.info('Starting crash recovery check');\n\n    // 1. Check WAL status and checkpoint if needed\n    const walStatus = this.checkWalStatus();\n    if (walStatus.checkpointNeeded) {\n      try {\n        this.checkpointWal();\n        logger.info('WAL checkpoint completed');\n      } catch (err) {\n        const msg = `WAL checkpoint failed: ${err instanceof Error ? err.message : String(err)}`;\n        errors.push(msg);\n        logger.warn(msg);\n      }\n    }\n\n    // 2. Run integrity check\n    const integrityCheck = this.runIntegrityCheck();\n    if (!integrityCheck.passed) {\n      logger.error('Database integrity check failed', {\n        violations: integrityCheck.foreignKeyViolations,\n        corrupted: integrityCheck.corruptedRows,\n      });\n    }\n\n    // 3. Detect and handle orphaned frames\n    const orphanedFrames = this.recoverOrphanedFrames();\n    if (orphanedFrames.detected > 0) {\n      logger.info('Orphaned frames processed', {\n        detected: orphanedFrames.detected,\n        recovered: orphanedFrames.recovered,\n        closed: orphanedFrames.closed,\n      });\n    }\n\n    const report: RecoveryReport = {\n      timestamp,\n      integrityCheck,\n      orphanedFrames,\n      walStatus,\n      recovered:\n        integrityCheck.passed &&\n        orphanedFrames.detected === orphanedFrames.closed,\n      errors,\n    };\n\n    logger.info('Crash recovery completed', {\n      recovered: report.recovered,\n      orphansFound: orphanedFrames.detected,\n      integrityPassed: integrityCheck.passed,\n    });\n\n    return report;\n  }\n\n  /**\n   * Check WAL mode status\n   */\n  checkWalStatus(): WalStatus {\n    try {\n      const journalMode = this.db.pragma('journal_mode') as JournalModeRow[];\n      const isWal = journalMode[0]?.journal_mode === 'wal';\n\n      if (!isWal) {\n        return { enabled: false, checkpointNeeded: false, walSize: 0 };\n      }\n\n      // Check WAL size\n      const walInfo = this.db.pragma('wal_checkpoint(PASSIVE)') as WalRow[];\n      const walSize = walInfo[0]?.log ?? 0;\n      const checkpointed = walInfo[0]?.checkpointed ?? 0;\n\n      return {\n        enabled: true,\n        checkpointNeeded: walSize > 1000, // Checkpoint if WAL has > 1000 pages\n        walSize: walSize - checkpointed,\n      };\n    } catch (err) {\n      logger.warn('Failed to check WAL status', { error: err });\n      return { enabled: false, checkpointNeeded: false, walSize: 0 };\n    }\n  }\n\n  /**\n   * Force WAL checkpoint\n   */\n  checkpointWal(): void {\n    this.db.pragma('wal_checkpoint(TRUNCATE)');\n  }\n\n  /**\n   * Run database integrity checks\n   */\n  runIntegrityCheck(): IntegrityCheckResult {\n    const errors: string[] = [];\n    let foreignKeyViolations = 0;\n    let corruptedRows = 0;\n\n    try {\n      // Check foreign key constraints\n      const fkViolations = this.db.pragma(\n        'foreign_key_check'\n      ) as ForeignKeyViolation[];\n      foreignKeyViolations = fkViolations.length;\n\n      if (foreignKeyViolations > 0) {\n        errors.push(`Found ${foreignKeyViolations} foreign key violations`);\n        logger.warn('Foreign key violations detected', {\n          count: foreignKeyViolations,\n          samples: fkViolations.slice(0, 5),\n        });\n      }\n\n      // Run integrity check\n      const integrity = this.db.pragma('integrity_check') as IntegrityRow[];\n      const integrityResult = integrity[0]?.integrity_check;\n\n      if (integrityResult !== 'ok') {\n        corruptedRows = integrity.length;\n        errors.push(`Integrity check failed: ${integrityResult}`);\n        logger.error('Database corruption detected', {\n          result: integrityResult,\n        });\n      }\n    } catch (err) {\n      errors.push(\n        `Integrity check error: ${err instanceof Error ? err.message : String(err)}`\n      );\n    }\n\n    return {\n      passed: foreignKeyViolations === 0 && corruptedRows === 0,\n      foreignKeyViolations,\n      corruptedRows,\n      errors,\n    };\n  }\n\n  /**\n   * Detect and recover orphaned frames\n   * Orphaned = active frames from sessions that are no longer running\n   */\n  recoverOrphanedFrames(): OrphanedFrameResult {\n    const orphanThreshold = Date.now() - this.orphanThresholdMs;\n    const thresholdUnix = Math.floor(orphanThreshold / 1000);\n\n    // Find active frames older than threshold (likely from crashed sessions)\n    const query = `\n      SELECT frame_id, run_id, project_id, name, type, created_at, depth\n      FROM frames\n      WHERE state = 'active'\n        AND created_at < ?\n        ${this.currentRunId ? 'AND run_id != ?' : ''}\n      ORDER BY created_at ASC\n    `;\n\n    const params = this.currentRunId\n      ? [thresholdUnix, this.currentRunId]\n      : [thresholdUnix];\n\n    const orphaned = this.db\n      .prepare(query)\n      .all(...params) as OrphanedFrameRow[];\n\n    if (orphaned.length === 0) {\n      return { detected: 0, recovered: 0, closed: 0, frameIds: [] };\n    }\n\n    const frameIds = orphaned.map((f) => f.frame_id);\n    let closed = 0;\n\n    // Close orphaned frames with a \"recovered\" state marker\n    const closeStmt = this.db.prepare(`\n      UPDATE frames\n      SET state = 'closed',\n          closed_at = unixepoch(),\n          outputs = json_set(COALESCE(outputs, '{}'), '$.recovered', true, '$.recoveryReason', 'orphan_cleanup')\n      WHERE frame_id = ?\n    `);\n\n    const transaction = this.db.transaction(() => {\n      for (const frame of orphaned) {\n        try {\n          closeStmt.run(frame.frame_id);\n          closed++;\n          logger.debug('Closed orphaned frame', {\n            frameId: frame.frame_id,\n            runId: frame.run_id,\n            name: frame.name,\n            age:\n              Math.round((Date.now() / 1000 - frame.created_at) / 3600) + 'h',\n          });\n        } catch (err) {\n          logger.warn('Failed to close orphaned frame', {\n            frameId: frame.frame_id,\n            error: err,\n          });\n        }\n      }\n    });\n\n    transaction();\n\n    return {\n      detected: orphaned.length,\n      recovered: 0, // Future: could attempt to resume some frames\n      closed,\n      frameIds,\n    };\n  }\n\n  /**\n   * Validate data integrity for a specific project\n   */\n  validateProjectIntegrity(projectId: string): {\n    valid: boolean;\n    issues: string[];\n  } {\n    const issues: string[] = [];\n\n    // Check for frames with invalid parent references\n    const invalidParents = this.db\n      .prepare(\n        `\n      SELECT f1.frame_id, f1.parent_frame_id\n      FROM frames f1\n      LEFT JOIN frames f2 ON f1.parent_frame_id = f2.frame_id\n      WHERE f1.project_id = ?\n        AND f1.parent_frame_id IS NOT NULL\n        AND f2.frame_id IS NULL\n    `\n      )\n      .all(projectId) as Array<{ frame_id: string; parent_frame_id: string }>;\n\n    if (invalidParents.length > 0) {\n      issues.push(\n        `${invalidParents.length} frames with invalid parent references`\n      );\n    }\n\n    // Check for depth inconsistencies\n    const depthIssues = this.db\n      .prepare(\n        `\n      SELECT f1.frame_id, f1.depth as child_depth, f2.depth as parent_depth\n      FROM frames f1\n      JOIN frames f2 ON f1.parent_frame_id = f2.frame_id\n      WHERE f1.project_id = ?\n        AND f1.depth != f2.depth + 1\n    `\n      )\n      .all(projectId) as Array<{\n      frame_id: string;\n      child_depth: number;\n      parent_depth: number;\n    }>;\n\n    if (depthIssues.length > 0) {\n      issues.push(`${depthIssues.length} frames with incorrect depth values`);\n    }\n\n    // Check for events without valid frames\n    const orphanEvents = this.db\n      .prepare(\n        `\n      SELECT COUNT(*) as count\n      FROM events e\n      LEFT JOIN frames f ON e.frame_id = f.frame_id\n      WHERE f.frame_id IS NULL\n    `\n      )\n      .get() as { count: number };\n\n    if (orphanEvents.count > 0) {\n      issues.push(`${orphanEvents.count} orphaned events without valid frames`);\n    }\n\n    return {\n      valid: issues.length === 0,\n      issues,\n    };\n  }\n\n  /**\n   * Clean up orphaned events (events without valid frames)\n   */\n  cleanupOrphanedEvents(): number {\n    const result = this.db\n      .prepare(\n        `\n      DELETE FROM events\n      WHERE frame_id NOT IN (SELECT frame_id FROM frames)\n    `\n      )\n      .run();\n\n    if (result.changes > 0) {\n      logger.info('Cleaned up orphaned events', { count: result.changes });\n    }\n\n    return result.changes;\n  }\n\n  /**\n   * Get recovery statistics\n   */\n  getRecoveryStats(): {\n    totalFrames: number;\n    activeFrames: number;\n    closedFrames: number;\n    recoveredFrames: number;\n    oldestActiveFrame: string | null;\n  } {\n    const stats = this.db\n      .prepare(\n        `\n      SELECT\n        COUNT(*) as total,\n        SUM(CASE WHEN state = 'active' THEN 1 ELSE 0 END) as active,\n        SUM(CASE WHEN state = 'closed' THEN 1 ELSE 0 END) as closed,\n        SUM(CASE WHEN json_extract(outputs, '$.recovered') = true THEN 1 ELSE 0 END) as recovered\n      FROM frames\n    `\n      )\n      .get() as {\n      total: number;\n      active: number;\n      closed: number;\n      recovered: number;\n    };\n\n    const oldest = this.db\n      .prepare(\n        `\n      SELECT datetime(created_at, 'unixepoch') as created\n      FROM frames\n      WHERE state = 'active'\n      ORDER BY created_at ASC\n      LIMIT 1\n    `\n      )\n      .get() as { created: string } | undefined;\n\n    return {\n      totalFrames: stats.total,\n      activeFrames: stats.active,\n      closedFrames: stats.closed,\n      recoveredFrames: stats.recovered,\n      oldestActiveFrame: oldest?.created ?? null,\n    };\n  }\n}\n\n/**\n * Convenience function to run recovery on a database\n */\nexport async function recoverDatabase(\n  db: Database.Database,\n  currentRunId?: string\n): Promise<RecoveryReport> {\n  const recovery = new FrameRecovery(db);\n  if (currentRunId) {\n    recovery.setCurrentRunId(currentRunId);\n  }\n  return recovery.recoverOnStartup();\n}\n"],
-  "mappings": "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",
-  "names": []
-}