@stackmemoryai/stackmemory 0.5.58 → 0.5.59

package/dist/src/core/context/stack-merge-resolver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/context/stack-merge-resolver.ts"],
+  "sourcesContent": ["/**\n * Stack Merge Conflict Resolution - STA-101\n * Advanced conflict resolution for frame merging between individual and shared stacks\n */\n\nimport type { Frame, Anchor } from './frame-types.js';\nimport {\n  DualStackManager,\n  type StackSyncResult,\n} from './dual-stack-manager.js';\nimport { logger } from '../monitoring/logger.js';\nimport { ValidationError, DatabaseError, ErrorCode } from '../errors/index.js';\nimport {\n  validateInput,\n  StartMergeSessionSchema,\n  CreateMergePolicySchema,\n  ConflictResolutionSchema,\n} from './validation.js';\n\nexport interface MergeConflict {\n  frameId: string;\n  conflictType:\n    | 'content'\n    | 'metadata'\n    | 'sequence'\n    | 'dependency'\n    | 'permission';\n  sourceFrame: Frame;\n  targetFrame: Frame;\n  conflictDetails: {\n    field: string;\n    sourceValue: any;\n    targetValue: any;\n    lastModified: {\n      source: Date;\n      target: Date;\n    };\n  }[];\n  severity: 'low' | 'medium' | 'high' | 'critical';\n  autoResolvable: boolean;\n}\n\nexport interface MergeResolution {\n  conflictId: string;\n  strategy: 'source_wins' | 'target_wins' | 'merge_both' | 'manual' | 'skip';\n  resolutionData?: Record<string, any>;\n  resolvedBy: string;\n  resolvedAt: Date;\n  notes?: string;\n}\n\nexport interface MergePolicy {\n  name: string;\n  description: string;\n  rules: Array<{\n    condition: string; // JSONPath expression\n    action: 'source_wins' | 'target_wins' | 'merge_both' | 'require_manual';\n    priority: number;\n  }>;\n  autoApplyThreshold: 'low' | 'medium' | 'high' | 'never';\n}\n\nexport interface MergeSession {\n  sessionId: string;\n  sourceStackId: string;\n  targetStackId: string;\n  conflicts: MergeConflict[];\n  resolutions: MergeResolution[];\n  policy: MergePolicy;\n  status: 'analyzing' | 'resolving' | 'completed' | 'failed' | 'manual_review';\n  startedAt: Date;\n  completedAt?: Date;\n  metadata: {\n    totalFrames: number;\n    conflictFrames: number;\n    autoResolvedConflicts: number;\n    manualResolvedConflicts: number;\n  };\n}\n\nexport class StackMergeResolver {\n  private dualStackManager: DualStackManager;\n  private activeSessions: Map<string, MergeSession> = new Map();\n  private mergePolicies: Map<string, MergePolicy> = new Map();\n\n  constructor(dualStackManager: DualStackManager) {\n    this.dualStackManager = dualStackManager;\n    this.initializeDefaultPolicies();\n    logger.debug('StackMergeResolver initialized', {\n      policies: Array.from(this.mergePolicies.keys()),\n    });\n  }\n\n  /**\n   * Start a merge session with conflict analysis\n   */\n  async startMergeSession(\n    sourceStackId: string,\n    targetStackId: string,\n    frameIds?: string[],\n    policyName: string = 'default'\n  ): Promise<string> {\n    // Validate input parameters\n    const input = validateInput(StartMergeSessionSchema, {\n      sourceStackId,\n      targetStackId,\n      frameIds,\n      policyName,\n    });\n    const sessionId = `merge-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n\n    logger.debug('Looking for merge policy', {\n      policyName: input.policyName,\n      availablePolicies: Array.from(this.mergePolicies.keys()),\n    });\n    const policy = this.mergePolicies.get(input.policyName);\n    if (!policy) {\n      logger.error('Merge policy not found', {\n        requested: input.policyName,\n        available: Array.from(this.mergePolicies.keys()),\n      });\n      throw new ValidationError(\n        `Merge policy not found: ${input.policyName}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    try {\n      // Check merge permissions on both stacks\n      const currentUserId =\n        this.dualStackManager.getCurrentContext().ownerId || 'unknown';\n      await this.dualStackManager\n        .getPermissionManager()\n        .enforcePermission(\n          this.dualStackManager\n            .getPermissionManager()\n            .createContext(currentUserId, 'merge', 'stack', input.sourceStackId)\n        );\n\n      await this.dualStackManager\n        .getPermissionManager()\n        .enforcePermission(\n          this.dualStackManager\n            .getPermissionManager()\n            .createContext(currentUserId, 'merge', 'stack', input.targetStackId)\n        );\n\n      // Create merge session\n      const session: MergeSession = {\n        sessionId,\n        sourceStackId: input.sourceStackId,\n        targetStackId: input.targetStackId,\n        conflicts: [],\n        resolutions: [],\n        policy,\n        status: 'analyzing',\n        startedAt: new Date(),\n        metadata: {\n          totalFrames: 0,\n          conflictFrames: 0,\n          autoResolvedConflicts: 0,\n          manualResolvedConflicts: 0,\n        },\n      };\n\n      this.activeSessions.set(sessionId, session);\n\n      // Analyze conflicts\n      await this.analyzeConflicts(sessionId, frameIds);\n\n      // Auto-resolve conflicts where possible\n      await this.autoResolveConflicts(sessionId);\n\n      logger.info(`Merge session started: ${sessionId}`, {\n        sourceStack: sourceStackId,\n        targetStack: targetStackId,\n        conflicts: session.conflicts.length,\n        policy: policyName,\n      });\n\n      return sessionId;\n    } catch (error: unknown) {\n      logger.error('Failed to start merge session', {\n        error: error instanceof Error ? error.message : error,\n        sourceStackId: input.sourceStackId,\n        targetStackId: input.targetStackId,\n        policyName: input.policyName,\n      });\n      throw new DatabaseError(\n        'Failed to start merge session',\n        ErrorCode.OPERATION_FAILED,\n        { sourceStackId, targetStackId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Analyze conflicts between source and target stacks\n   */\n  private async analyzeConflicts(\n    sessionId: string,\n    frameIds?: string[]\n  ): Promise<void> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new DatabaseError(\n        `Merge session not found: ${sessionId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    try {\n      const sourceStack = this.getStackManager(session.sourceStackId);\n      const targetStack = this.getStackManager(session.targetStackId);\n\n      // Get frames to analyze\n      const framesToAnalyze =\n        frameIds ||\n        (await sourceStack.getActiveFrames()).map((f) => f.frame_id);\n\n      session.metadata.totalFrames = framesToAnalyze.length;\n\n      for (const frameId of framesToAnalyze) {\n        const sourceFrame = await sourceStack.getFrame(frameId);\n        if (!sourceFrame) continue;\n\n        const targetFrame = await targetStack.getFrame(frameId);\n        if (!targetFrame) continue; // No conflict if target doesn't exist\n\n        // Analyze frame-level conflicts\n        const conflicts = await this.analyzeFrameConflicts(\n          sourceFrame,\n          targetFrame\n        );\n        session.conflicts.push(...conflicts);\n      }\n\n      session.metadata.conflictFrames = new Set(\n        session.conflicts.map((c) => c.frameId)\n      ).size;\n      session.status = 'resolving';\n\n      this.activeSessions.set(sessionId, session);\n\n      logger.info(`Conflict analysis completed: ${sessionId}`, {\n        totalConflicts: session.conflicts.length,\n        conflictFrames: session.metadata.conflictFrames,\n      });\n    } catch (error: unknown) {\n      session.status = 'failed';\n      this.activeSessions.set(sessionId, session);\n      throw error;\n    }\n  }\n\n  /**\n   * Analyze conflicts within a single frame\n   */\n  private async analyzeFrameConflicts(\n    sourceFrame: Frame,\n    targetFrame: Frame\n  ): Promise<MergeConflict[]> {\n    const conflicts: MergeConflict[] = [];\n\n    // Content conflicts\n    if (sourceFrame.name !== targetFrame.name) {\n      conflicts.push({\n        frameId: sourceFrame.frame_id,\n        conflictType: 'content',\n        sourceFrame,\n        targetFrame,\n        conflictDetails: [\n          {\n            field: 'name',\n            sourceValue: sourceFrame.name,\n            targetValue: targetFrame.name,\n            lastModified: {\n              source: new Date(sourceFrame.created_at * 1000),\n              target: new Date(targetFrame.created_at * 1000),\n            },\n          },\n        ],\n        severity: 'medium',\n        autoResolvable: false,\n      });\n    }\n\n    // State conflicts\n    if (sourceFrame.state !== targetFrame.state) {\n      conflicts.push({\n        frameId: sourceFrame.frame_id,\n        conflictType: 'metadata',\n        sourceFrame,\n        targetFrame,\n        conflictDetails: [\n          {\n            field: 'state',\n            sourceValue: sourceFrame.state,\n            targetValue: targetFrame.state,\n            lastModified: {\n              source: new Date(sourceFrame.created_at * 1000),\n              target: new Date(targetFrame.created_at * 1000),\n            },\n          },\n        ],\n        severity: 'high',\n        autoResolvable: true, // Can auto-resolve based on timestamps\n      });\n    }\n\n    // Input/Output conflicts\n    if (\n      JSON.stringify(sourceFrame.inputs) !== JSON.stringify(targetFrame.inputs)\n    ) {\n      conflicts.push({\n        frameId: sourceFrame.frame_id,\n        conflictType: 'content',\n        sourceFrame,\n        targetFrame,\n        conflictDetails: [\n          {\n            field: 'inputs',\n            sourceValue: sourceFrame.inputs,\n            targetValue: targetFrame.inputs,\n            lastModified: {\n              source: new Date(sourceFrame.created_at * 1000),\n              target: new Date(targetFrame.created_at * 1000),\n            },\n          },\n        ],\n        severity: 'medium',\n        autoResolvable: false,\n      });\n    }\n\n    // Analyze event conflicts\n    const eventConflicts = await this.analyzeEventConflicts(\n      sourceFrame,\n      targetFrame\n    );\n    conflicts.push(...eventConflicts);\n\n    // Analyze anchor conflicts\n    const anchorConflicts = await this.analyzeAnchorConflicts(\n      sourceFrame,\n      targetFrame\n    );\n    conflicts.push(...anchorConflicts);\n\n    return conflicts;\n  }\n\n  /**\n   * Analyze conflicts in frame events\n   */\n  private async analyzeEventConflicts(\n    sourceFrame: Frame,\n    targetFrame: Frame\n  ): Promise<MergeConflict[]> {\n    const conflicts: MergeConflict[] = [];\n\n    try {\n      const sourceStack = this.getStackManager(sourceFrame.project_id);\n      const targetStack = this.getStackManager(targetFrame.project_id);\n\n      const sourceEvents = await sourceStack.getFrameEvents(\n        sourceFrame.frame_id\n      );\n      const targetEvents = await targetStack.getFrameEvents(\n        targetFrame.frame_id\n      );\n\n      // Check for sequence conflicts\n      if (sourceEvents.length !== targetEvents.length) {\n        conflicts.push({\n          frameId: sourceFrame.frame_id,\n          conflictType: 'sequence',\n          sourceFrame,\n          targetFrame,\n          conflictDetails: [\n            {\n              field: 'event_count',\n              sourceValue: sourceEvents.length,\n              targetValue: targetEvents.length,\n              lastModified: {\n                source: new Date(),\n                target: new Date(),\n              },\n            },\n          ],\n          severity: 'high',\n          autoResolvable: true, // Can merge events\n        });\n      }\n\n      // Check for content conflicts in matching events\n      const minLength = Math.min(sourceEvents.length, targetEvents.length);\n      for (let i = 0; i < minLength; i++) {\n        const sourceEvent = sourceEvents[i];\n        const targetEvent = targetEvents[i];\n\n        if (\n          sourceEvent.text !== targetEvent.text ||\n          JSON.stringify(sourceEvent.metadata) !==\n            JSON.stringify(targetEvent.metadata)\n        ) {\n          conflicts.push({\n            frameId: sourceFrame.frame_id,\n            conflictType: 'content',\n            sourceFrame,\n            targetFrame,\n            conflictDetails: [\n              {\n                field: `event_${i}`,\n                sourceValue: {\n                  text: sourceEvent.text,\n                  metadata: sourceEvent.metadata,\n                },\n                targetValue: {\n                  text: targetEvent.text,\n                  metadata: targetEvent.metadata,\n                },\n                lastModified: {\n                  source: new Date(),\n                  target: new Date(),\n                },\n              },\n            ],\n            severity: 'medium',\n            autoResolvable: false,\n          });\n        }\n      }\n    } catch (error: unknown) {\n      logger.warn(\n        `Failed to analyze event conflicts for frame: ${sourceFrame.frame_id}`,\n        error\n      );\n    }\n\n    return conflicts;\n  }\n\n  /**\n   * Analyze conflicts in frame anchors\n   */\n  private async analyzeAnchorConflicts(\n    sourceFrame: Frame,\n    targetFrame: Frame\n  ): Promise<MergeConflict[]> {\n    const conflicts: MergeConflict[] = [];\n\n    try {\n      const sourceStack = this.getStackManager(sourceFrame.project_id);\n      const targetStack = this.getStackManager(targetFrame.project_id);\n\n      const sourceAnchors = await sourceStack.getFrameAnchors(\n        sourceFrame.frame_id\n      );\n      const targetAnchors = await targetStack.getFrameAnchors(\n        targetFrame.frame_id\n      );\n\n      // Group anchors by type for comparison\n      const sourceAnchorsByType = this.groupAnchorsByType(sourceAnchors);\n      const targetAnchorsByType = this.groupAnchorsByType(targetAnchors);\n\n      const allTypes = new Set([\n        ...Object.keys(sourceAnchorsByType),\n        ...Object.keys(targetAnchorsByType),\n      ]);\n\n      for (const type of allTypes) {\n        const sourceTypeAnchors = sourceAnchorsByType[type] || [];\n        const targetTypeAnchors = targetAnchorsByType[type] || [];\n\n        if (\n          sourceTypeAnchors.length !== targetTypeAnchors.length ||\n          !this.anchorsEqual(sourceTypeAnchors, targetTypeAnchors)\n        ) {\n          conflicts.push({\n            frameId: sourceFrame.frame_id,\n            conflictType: 'content',\n            sourceFrame,\n            targetFrame,\n            conflictDetails: [\n              {\n                field: `anchors_${type}`,\n                sourceValue: sourceTypeAnchors,\n                targetValue: targetTypeAnchors,\n                lastModified: {\n                  source: new Date(),\n                  target: new Date(),\n                },\n              },\n            ],\n            severity: 'low',\n            autoResolvable: true, // Can merge anchors\n          });\n        }\n      }\n    } catch (error: unknown) {\n      logger.warn(\n        `Failed to analyze anchor conflicts for frame: ${sourceFrame.frame_id}`,\n        error\n      );\n    }\n\n    return conflicts;\n  }\n\n  /**\n   * Auto-resolve conflicts based on merge policy\n   */\n  private async autoResolveConflicts(sessionId: string): Promise<void> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) return;\n\n    const autoResolvableConflicts = session.conflicts.filter(\n      (c) => c.autoResolvable\n    );\n\n    for (const conflict of autoResolvableConflicts) {\n      const resolution = await this.applyMergePolicy(conflict, session.policy);\n      if (resolution) {\n        session.resolutions.push(resolution);\n        session.metadata.autoResolvedConflicts++;\n\n        logger.debug(`Auto-resolved conflict: ${conflict.frameId}`, {\n          type: conflict.conflictType,\n          strategy: resolution.strategy,\n        });\n      }\n    }\n\n    // Update session status\n    const remainingConflicts = session.conflicts.filter(\n      (c) => !session.resolutions.find((r) => r.conflictId === c.frameId)\n    );\n\n    if (remainingConflicts.length === 0) {\n      session.status = 'completed';\n      session.completedAt = new Date();\n    } else if (remainingConflicts.every((c) => !c.autoResolvable)) {\n      session.status = 'manual_review';\n    }\n\n    this.activeSessions.set(sessionId, session);\n  }\n\n  /**\n   * Apply merge policy to resolve conflicts automatically\n   */\n  private async applyMergePolicy(\n    conflict: MergeConflict,\n    policy: MergePolicy\n  ): Promise<MergeResolution | null> {\n    // Sort rules by priority\n    const sortedRules = policy.rules.sort((a, b) => b.priority - a.priority);\n\n    for (const rule of sortedRules) {\n      if (this.evaluateRuleCondition(conflict, rule.condition)) {\n        return {\n          conflictId: conflict.frameId,\n          strategy:\n            rule.action === 'require_manual' ? 'manual' : (rule.action as any),\n          resolvedBy: 'system',\n          resolvedAt: new Date(),\n          notes: `Auto-resolved by policy: ${policy.name}`,\n        };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Manually resolve a specific conflict\n   */\n  async resolveConflict(\n    sessionId: string,\n    conflictId: string,\n    resolution: Omit<MergeResolution, 'conflictId' | 'resolvedAt'>\n  ): Promise<void> {\n    // Validate input parameters\n    const input = validateInput(ConflictResolutionSchema, {\n      strategy: resolution.strategy,\n      resolvedBy: resolution.resolvedBy,\n      notes: resolution.notes,\n    });\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new ValidationError(\n        `Merge session not found: ${sessionId}`,\n        ErrorCode.MERGE_SESSION_INVALID\n      );\n    }\n\n    const conflict = session.conflicts.find((c) => c.frameId === conflictId);\n    if (!conflict) {\n      throw new ValidationError(\n        `Conflict not found: ${conflictId}`,\n        ErrorCode.MERGE_CONFLICT_UNRESOLVABLE\n      );\n    }\n\n    const fullResolution: MergeResolution = {\n      ...input,\n      conflictId,\n      resolvedAt: new Date(),\n    };\n\n    session.resolutions.push(fullResolution);\n    session.metadata.manualResolvedConflicts++;\n\n    // Check if all conflicts are resolved\n    const resolvedConflictIds = new Set(\n      session.resolutions.map((r) => r.conflictId)\n    );\n    const allResolved = session.conflicts.every((c) =>\n      resolvedConflictIds.has(c.frameId)\n    );\n\n    if (allResolved) {\n      session.status = 'completed';\n      session.completedAt = new Date();\n    }\n\n    this.activeSessions.set(sessionId, session);\n\n    logger.info(`Conflict manually resolved: ${conflictId}`, {\n      strategy: resolution.strategy,\n      resolvedBy: resolution.resolvedBy,\n    });\n  }\n\n  /**\n   * Execute merge with resolved conflicts\n   */\n  async executeMerge(sessionId: string): Promise<StackSyncResult> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new DatabaseError(\n        `Merge session not found: ${sessionId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    if (session.status !== 'completed') {\n      throw new DatabaseError(\n        `Merge session not ready for execution: ${session.status}`,\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    try {\n      const resolutionMap = new Map(\n        session.resolutions.map((r) => [r.conflictId, r])\n      );\n\n      const result: StackSyncResult = {\n        success: true,\n        conflictFrames: [],\n        mergedFrames: [],\n        errors: [],\n      };\n\n      const sourceStack = this.getStackManager(session.sourceStackId);\n      const targetStack = this.getStackManager(session.targetStackId);\n\n      // Group conflicts by frameId\n      const conflictsByFrame = new Map<string, MergeConflict[]>();\n      for (const conflict of session.conflicts) {\n        const existing = conflictsByFrame.get(conflict.frameId) || [];\n        existing.push(conflict);\n        conflictsByFrame.set(conflict.frameId, existing);\n      }\n\n      // Process each frame according to its resolution\n      for (const [frameId] of conflictsByFrame) {\n        try {\n          const resolution = resolutionMap.get(frameId);\n          if (!resolution) {\n            result.errors.push({\n              frameId,\n              error: 'No resolution found',\n              resolution: 'skipped',\n            });\n            result.conflictFrames.push(frameId);\n            continue;\n          }\n\n          const sourceFrame = await sourceStack.getFrame(frameId);\n          const targetFrame = await targetStack.getFrame(frameId);\n\n          if (!sourceFrame) {\n            result.errors.push({\n              frameId,\n              error: 'Source frame not found',\n              resolution: 'skipped',\n            });\n            continue;\n          }\n\n          switch (resolution.strategy) {\n            case 'source_wins':\n              if (targetFrame) await targetStack.deleteFrame(frameId);\n              await this.copyFrameToStack(\n                sourceFrame,\n                sourceStack,\n                targetStack\n              );\n              result.mergedFrames.push(frameId);\n              break;\n\n            case 'target_wins':\n              result.mergedFrames.push(frameId);\n              break;\n\n            case 'merge_both':\n              if (targetFrame) {\n                await this.mergeFrameContents(\n                  sourceFrame,\n                  targetFrame,\n                  sourceStack,\n                  targetStack\n                );\n              } else {\n                await this.copyFrameToStack(\n                  sourceFrame,\n                  sourceStack,\n                  targetStack\n                );\n              }\n              result.mergedFrames.push(frameId);\n              break;\n\n            case 'skip':\n              result.conflictFrames.push(frameId);\n              break;\n\n            case 'manual':\n              result.errors.push({\n                frameId,\n                error: 'Manual resolution not applied',\n                resolution: 'skipped',\n              });\n              result.conflictFrames.push(frameId);\n              break;\n          }\n        } catch (error: unknown) {\n          result.errors.push({\n            frameId,\n            error: error instanceof Error ? error.message : String(error),\n            resolution: 'skipped',\n          });\n          result.success = false;\n        }\n      }\n\n      logger.info(`Merge executed: ${sessionId}`, {\n        mergedFrames: result.mergedFrames.length,\n        conflicts: result.conflictFrames.length,\n        errors: result.errors.length,\n      });\n\n      return result;\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        'Failed to execute merge',\n        ErrorCode.OPERATION_FAILED,\n        { sessionId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  private async copyFrameToStack(\n    frame: Frame,\n    sourceStack: any,\n    targetStack: any\n  ): Promise<void> {\n    await targetStack.createFrame({\n      frame_id: frame.frame_id,\n      name: frame.name,\n      type: frame.type,\n      parent_frame_id: frame.parent_frame_id,\n      inputs: frame.inputs,\n      outputs: frame.outputs,\n    });\n\n    const events = await sourceStack.getFrameEvents(frame.frame_id);\n    for (const event of events) {\n      await targetStack.addEvent(frame.frame_id, {\n        type: event.type,\n        text: event.text,\n        metadata: event.metadata,\n      });\n    }\n\n    const anchors = await sourceStack.getFrameAnchors(frame.frame_id);\n    for (const anchor of anchors) {\n      await targetStack.addAnchor(frame.frame_id, {\n        type: anchor.type,\n        text: anchor.text,\n        priority: anchor.priority,\n        metadata: anchor.metadata,\n      });\n    }\n  }\n\n  private async mergeFrameContents(\n    sourceFrame: Frame,\n    targetFrame: Frame,\n    sourceStack: any,\n    targetStack: any\n  ): Promise<void> {\n    // Merge events with deduplication\n    const sourceEvents = await sourceStack.getFrameEvents(sourceFrame.frame_id);\n    const targetEvents = await targetStack.getFrameEvents(targetFrame.frame_id);\n\n    const existingSignatures = new Set(\n      targetEvents.map((e: any) => `${e.type}:${e.text}`)\n    );\n\n    for (const event of sourceEvents) {\n      const sig = `${event.type}:${event.text}`;\n      if (!existingSignatures.has(sig)) {\n        await targetStack.addEvent(targetFrame.frame_id, {\n          type: event.type,\n          text: event.text,\n          metadata: { ...event.metadata, merged: true },\n        });\n        existingSignatures.add(sig);\n      }\n    }\n\n    // Merge anchors with deduplication\n    const sourceAnchors = await sourceStack.getFrameAnchors(\n      sourceFrame.frame_id\n    );\n    const targetAnchors = await targetStack.getFrameAnchors(\n      targetFrame.frame_id\n    );\n\n    const existingAnchorSigs = new Set(\n      targetAnchors.map((a: any) => `${a.type}:${a.text}:${a.priority}`)\n    );\n\n    for (const anchor of sourceAnchors) {\n      const sig = `${anchor.type}:${anchor.text}:${anchor.priority}`;\n      if (!existingAnchorSigs.has(sig)) {\n        await targetStack.addAnchor(targetFrame.frame_id, {\n          type: anchor.type,\n          text: anchor.text,\n          priority: anchor.priority,\n          metadata: { ...anchor.metadata, merged: true },\n        });\n        existingAnchorSigs.add(sig);\n      }\n    }\n\n    logger.debug(`Merged frame contents: ${sourceFrame.frame_id}`);\n  }\n\n  /**\n   * Get merge session details\n   */\n  async getMergeSession(sessionId: string): Promise<MergeSession | null> {\n    return this.activeSessions.get(sessionId) || null;\n  }\n\n  /**\n   * Create custom merge policy\n   */\n  async createMergePolicy(policy: MergePolicy): Promise<void> {\n    // Validate input parameters\n    const input = validateInput(CreateMergePolicySchema, policy);\n\n    this.mergePolicies.set(input.name, input);\n    logger.info(`Created merge policy: ${input.name}`, {\n      rules: input.rules.length,\n      autoApplyThreshold: input.autoApplyThreshold,\n    });\n  }\n\n  /**\n   * Initialize default merge policies\n   */\n  private initializeDefaultPolicies(): void {\n    // Conservative policy - prefer manual resolution\n    this.mergePolicies.set('conservative', {\n      name: 'conservative',\n      description: 'Prefer manual resolution for most conflicts',\n      rules: [\n        {\n          condition: '$.conflictType == \"metadata\" && $.severity == \"low\"',\n          action: 'target_wins',\n          priority: 1,\n        },\n        {\n          condition: '$.severity == \"critical\"',\n          action: 'require_manual',\n          priority: 10,\n        },\n      ],\n      autoApplyThreshold: 'never',\n    });\n\n    // Aggressive policy - auto-resolve when possible\n    this.mergePolicies.set('aggressive', {\n      name: 'aggressive',\n      description: 'Auto-resolve conflicts when safe',\n      rules: [\n        {\n          condition: '$.conflictType == \"sequence\"',\n          action: 'merge_both',\n          priority: 5,\n        },\n        {\n          condition: '$.severity == \"low\"',\n          action: 'source_wins',\n          priority: 2,\n        },\n        {\n          condition: '$.severity == \"medium\" && $.autoResolvable',\n          action: 'merge_both',\n          priority: 4,\n        },\n      ],\n      autoApplyThreshold: 'medium',\n    });\n\n    // Default policy - balanced approach\n    this.mergePolicies.set('default', {\n      name: 'default',\n      description: 'Balanced conflict resolution',\n      rules: [\n        {\n          condition: '$.conflictType == \"sequence\" && $.severity == \"low\"',\n          action: 'merge_both',\n          priority: 3,\n        },\n        {\n          condition: '$.conflictType == \"metadata\" && $.autoResolvable',\n          action: 'target_wins',\n          priority: 2,\n        },\n        {\n          condition: '$.severity == \"critical\"',\n          action: 'require_manual',\n          priority: 10,\n        },\n      ],\n      autoApplyThreshold: 'low',\n    });\n  }\n\n  // Helper methods\n  private getStackManager(stackId: string): any {\n    // Use DualStackManager's getStackManager method to get the right stack\n    return this.dualStackManager.getStackManager(stackId);\n  }\n\n  private groupAnchorsByType(anchors: Anchor[]): Record<string, Anchor[]> {\n    return anchors.reduce(\n      (groups, anchor) => {\n        if (!groups[anchor.type]) groups[anchor.type] = [];\n        groups[anchor.type].push(anchor);\n        return groups;\n      },\n      {} as Record<string, Anchor[]>\n    );\n  }\n\n  private anchorsEqual(anchors1: Anchor[], anchors2: Anchor[]): boolean {\n    if (anchors1.length !== anchors2.length) return false;\n\n    // Sort by text for comparison\n    const sorted1 = [...anchors1].sort((a, b) => a.text.localeCompare(b.text));\n    const sorted2 = [...anchors2].sort((a, b) => a.text.localeCompare(b.text));\n\n    return sorted1.every(\n      (anchor, i) =>\n        anchor.text === sorted2[i].text &&\n        anchor.priority === sorted2[i].priority\n    );\n  }\n\n  private evaluateRuleCondition(\n    conflict: MergeConflict,\n    condition: string\n  ): boolean {\n    // Simple condition evaluation - in real implementation would use JSONPath\n    return (\n      condition.includes(conflict.conflictType) ||\n      condition.includes(conflict.severity)\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/context/validation.js

@@ -0,0 +1,130 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { z } from "zod";
+import { ValidationError, ErrorCode } from "../errors/index.js";
+const StackPermissionsSchema = z.object({
+  canRead: z.boolean(),
+  canWrite: z.boolean(),
+  canHandoff: z.boolean(),
+  canMerge: z.boolean(),
+  canAdminister: z.boolean()
+});
+const stackIdSchema = z.string().min(1).max(200);
+const userIdSchema = z.string().min(1).max(100);
+const frameIdSchema = z.string().min(1).max(100);
+const teamIdSchema = z.string().min(1).max(100);
+const CreateSharedStackSchema = z.object({
+  teamId: teamIdSchema,
+  name: z.string().min(1).max(200),
+  ownerId: userIdSchema,
+  permissions: StackPermissionsSchema.optional()
+});
+const SwitchStackSchema = z.object({
+  stackId: stackIdSchema
+});
+const FrameContextSchema = z.object({
+  totalFrames: z.number().min(1).max(1e4),
+  frameTypes: z.array(z.string()).min(1).max(50),
+  estimatedSize: z.number().min(0).max(1e6),
+  // Max 1MB
+  dependencies: z.array(z.string()).max(100)
+});
+const BusinessContextSchema = z.object({
+  milestone: z.string().max(100).optional(),
+  priority: z.enum(["low", "medium", "high", "critical"]).optional(),
+  deadline: z.date().optional(),
+  stakeholders: z.array(userIdSchema).max(20).optional()
+});
+const HandoffRequestSchema = z.object({
+  initiatedAt: z.date(),
+  initiatorId: userIdSchema,
+  frameContext: FrameContextSchema,
+  businessContext: BusinessContextSchema.optional()
+});
+const InitiateHandoffSchema = z.object({
+  targetStackId: stackIdSchema,
+  frameIds: z.array(frameIdSchema).min(1).max(1e3),
+  handoffRequest: HandoffRequestSchema,
+  reviewerId: userIdSchema.optional(),
+  description: z.string().max(1e3).optional()
+});
+const HandoffApprovalSchema = z.object({
+  reviewerId: userIdSchema,
+  decision: z.enum(["approved", "rejected", "needs_changes"]),
+  feedback: z.string().max(2e3).optional(),
+  suggestedChanges: z.array(
+    z.object({
+      frameId: frameIdSchema,
+      suggestion: z.string().max(500),
+      reason: z.string().max(300).optional()
+    })
+  ).max(50).optional()
+});
+const ConflictResolutionSchema = z.object({
+  strategy: z.enum(["source_wins", "target_wins", "merge_both", "manual"]),
+  resolvedBy: userIdSchema,
+  notes: z.string().max(1e3).optional()
+});
+const MergePolicyRuleSchema = z.object({
+  condition: z.string().min(1).max(500),
+  action: z.enum(["source_wins", "target_wins", "merge_both", "manual_review"]),
+  priority: z.number().min(1).max(10)
+});
+const CreateMergePolicySchema = z.object({
+  name: z.string().min(1).max(100),
+  description: z.string().max(500).optional(),
+  rules: z.array(MergePolicyRuleSchema).min(1).max(20),
+  autoApplyThreshold: z.enum(["low", "medium", "high"])
+});
+const StartMergeSessionSchema = z.object({
+  sourceStackId: stackIdSchema,
+  targetStackId: stackIdSchema,
+  frameIds: z.array(frameIdSchema).max(1e3).optional(),
+  policyName: z.string().max(100).optional()
+});
+function validateInput(schema, input) {
+  try {
+    return schema.parse(input);
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      const details = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+      throw new ValidationError(
+        `Validation failed: ${details}`,
+        ErrorCode.VALIDATION_FAILED,
+        { errors: error.errors }
+      );
+    }
+    throw error;
+  }
+}
+function validateInputSafe(schema, input) {
+  try {
+    const data = schema.parse(input);
+    return { success: true, data };
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      const details = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+      return { success: false, error: `Validation failed: ${details}` };
+    }
+    return { success: false, error: "Unknown validation error" };
+  }
+}
+export {
+  BusinessContextSchema,
+  ConflictResolutionSchema,
+  CreateMergePolicySchema,
+  CreateSharedStackSchema,
+  FrameContextSchema,
+  HandoffApprovalSchema,
+  HandoffRequestSchema,
+  InitiateHandoffSchema,
+  MergePolicyRuleSchema,
+  StackPermissionsSchema,
+  StartMergeSessionSchema,
+  SwitchStackSchema,
+  validateInput,
+  validateInputSafe
+};
+//# sourceMappingURL=validation.js.map

package/dist/src/core/context/validation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/context/validation.ts"],
+  "sourcesContent": ["/**\n * Input validation schemas for collaboration layer\n */\n\nimport { z } from 'zod';\nimport { ValidationError, ErrorCode } from '../errors/index.js';\n\n// Permission validation\nexport const StackPermissionsSchema = z.object({\n  canRead: z.boolean(),\n  canWrite: z.boolean(),\n  canHandoff: z.boolean(),\n  canMerge: z.boolean(),\n  canAdminister: z.boolean(),\n});\n\n// Common string validations\nconst stackIdSchema = z.string().min(1).max(200);\nconst userIdSchema = z.string().min(1).max(100);\nconst frameIdSchema = z.string().min(1).max(100);\nconst teamIdSchema = z.string().min(1).max(100);\n\n// Dual Stack Manager validation\nexport const CreateSharedStackSchema = z.object({\n  teamId: teamIdSchema,\n  name: z.string().min(1).max(200),\n  ownerId: userIdSchema,\n  permissions: StackPermissionsSchema.optional(),\n});\n\nexport const SwitchStackSchema = z.object({\n  stackId: stackIdSchema,\n});\n\n// Frame Handoff validation\nexport const FrameContextSchema = z.object({\n  totalFrames: z.number().min(1).max(10000),\n  frameTypes: z.array(z.string()).min(1).max(50),\n  estimatedSize: z.number().min(0).max(1000000), // Max 1MB\n  dependencies: z.array(z.string()).max(100),\n});\n\nexport const BusinessContextSchema = z.object({\n  milestone: z.string().max(100).optional(),\n  priority: z.enum(['low', 'medium', 'high', 'critical']).optional(),\n  deadline: z.date().optional(),\n  stakeholders: z.array(userIdSchema).max(20).optional(),\n});\n\nexport const HandoffRequestSchema = z.object({\n  initiatedAt: z.date(),\n  initiatorId: userIdSchema,\n  frameContext: FrameContextSchema,\n  businessContext: BusinessContextSchema.optional(),\n});\n\nexport const InitiateHandoffSchema = z.object({\n  targetStackId: stackIdSchema,\n  frameIds: z.array(frameIdSchema).min(1).max(1000),\n  handoffRequest: HandoffRequestSchema,\n  reviewerId: userIdSchema.optional(),\n  description: z.string().max(1000).optional(),\n});\n\nexport const HandoffApprovalSchema = z.object({\n  reviewerId: userIdSchema,\n  decision: z.enum(['approved', 'rejected', 'needs_changes']),\n  feedback: z.string().max(2000).optional(),\n  suggestedChanges: z\n    .array(\n      z.object({\n        frameId: frameIdSchema,\n        suggestion: z.string().max(500),\n        reason: z.string().max(300).optional(),\n      })\n    )\n    .max(50)\n    .optional(),\n});\n\n// Merge Resolution validation\nexport const ConflictResolutionSchema = z.object({\n  strategy: z.enum(['source_wins', 'target_wins', 'merge_both', 'manual']),\n  resolvedBy: userIdSchema,\n  notes: z.string().max(1000).optional(),\n});\n\nexport const MergePolicyRuleSchema = z.object({\n  condition: z.string().min(1).max(500),\n  action: z.enum(['source_wins', 'target_wins', 'merge_both', 'manual_review']),\n  priority: z.number().min(1).max(10),\n});\n\nexport const CreateMergePolicySchema = z.object({\n  name: z.string().min(1).max(100),\n  description: z.string().max(500).optional(),\n  rules: z.array(MergePolicyRuleSchema).min(1).max(20),\n  autoApplyThreshold: z.enum(['low', 'medium', 'high']),\n});\n\nexport const StartMergeSessionSchema = z.object({\n  sourceStackId: stackIdSchema,\n  targetStackId: stackIdSchema,\n  frameIds: z.array(frameIdSchema).max(1000).optional(),\n  policyName: z.string().max(100).optional(),\n});\n\n// Type exports for use in implementation\nexport type StackPermissions = z.infer<typeof StackPermissionsSchema>;\nexport type CreateSharedStackInput = z.infer<typeof CreateSharedStackSchema>;\nexport type SwitchStackInput = z.infer<typeof SwitchStackSchema>;\nexport type FrameContext = z.infer<typeof FrameContextSchema>;\nexport type BusinessContext = z.infer<typeof BusinessContextSchema>;\nexport type HandoffRequest = z.infer<typeof HandoffRequestSchema>;\nexport type InitiateHandoffInput = z.infer<typeof InitiateHandoffSchema>;\nexport type HandoffApprovalInput = z.infer<typeof HandoffApprovalSchema>;\nexport type ConflictResolutionInput = z.infer<typeof ConflictResolutionSchema>;\nexport type MergePolicyRule = z.infer<typeof MergePolicyRuleSchema>;\nexport type CreateMergePolicyInput = z.infer<typeof CreateMergePolicySchema>;\nexport type StartMergeSessionInput = z.infer<typeof StartMergeSessionSchema>;\n\n// Validation helper functions\nexport function validateInput<T>(schema: z.ZodSchema<T>, input: unknown): T {\n  try {\n    return schema.parse(input);\n  } catch (error: unknown) {\n    if (error instanceof z.ZodError) {\n      const details = error.errors\n        .map((e) => `${e.path.join('.')}: ${e.message}`)\n        .join(', ');\n      throw new ValidationError(\n        `Validation failed: ${details}`,\n        ErrorCode.VALIDATION_FAILED,\n        { errors: error.errors }\n      );\n    }\n    throw error;\n  }\n}\n\nexport function validateInputSafe<T>(\n  schema: z.ZodSchema<T>,\n  input: unknown\n): { success: true; data: T } | { success: false; error: string } {\n  try {\n    const data = schema.parse(input);\n    return { success: true, data };\n  } catch (error: unknown) {\n    if (error instanceof z.ZodError) {\n      const details = error.errors\n        .map((e) => `${e.path.join('.')}: ${e.message}`)\n        .join(', ');\n      return { success: false, error: `Validation failed: ${details}` };\n    }\n    return { success: false, error: 'Unknown validation error' };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/database/batch-operations.js

@@ -0,0 +1,384 @@
+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";
+import { trace } from "../trace/index.js";
+import { ErrorCode, wrapError } from "../errors/index.js";
+class BatchOperationsManager {
+  db;
+  preparedStatements = /* @__PURE__ */ new Map();
+  batchQueue = [];
+  isProcessing = false;
+  constructor(db) {
+    if (db) {
+      this.db = db;
+      this.initializePreparedStatements();
+    } else {
+      this.db = void 0;
+    }
+  }
+  /**
+   * Add events in bulk with optimized batching
+   */
+  async bulkInsertEvents(events, options = {}) {
+    const {
+      batchSize = 100,
+      onConflict = "ignore",
+      enableTransactions = true
+    } = options;
+    return this.performBulkInsert("events", events, {
+      batchSize,
+      onConflict,
+      enableTransactions,
+      preprocessor: (event) => ({
+        ...event,
+        event_id: `evt_${event.frame_id}_${event.seq}_${Date.now()}`,
+        payload: JSON.stringify(event.payload)
+      })
+    });
+  }
+  /**
+   * Add anchors in bulk
+   */
+  async bulkInsertAnchors(anchors, options = {}) {
+    return this.performBulkInsert("anchors", anchors, {
+      ...options,
+      preprocessor: (anchor) => ({
+        ...anchor,
+        anchor_id: `anc_${anchor.frame_id}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+        metadata: JSON.stringify(anchor.metadata),
+        created_at: Date.now()
+      })
+    });
+  }
+  /**
+   * Bulk update frame digests
+   */
+  async bulkUpdateFrameDigests(updates, options = {}) {
+    const { batchSize = 50, enableTransactions = true } = options;
+    return trace.traceAsync(
+      "function",
+      "bulkUpdateFrameDigests",
+      { count: updates.length },
+      async () => {
+        const startTime = performance.now();
+        const stats = {
+          totalRecords: updates.length,
+          batchesProcessed: 0,
+          successfulInserts: 0,
+          failedInserts: 0,
+          totalTimeMs: 0,
+          avgBatchTimeMs: 0
+        };
+        if (updates.length === 0) return stats;
+        const stmt = this.db.prepare(`
+        UPDATE frames 
+        SET digest_text = ?, 
+            digest_json = ?, 
+            closed_at = COALESCE(?, closed_at),
+            state = CASE WHEN ? IS NOT NULL THEN 'closed' ELSE state END
+        WHERE frame_id = ?
+      `);
+        const updateFn = (batch) => {
+          for (const update of batch) {
+            try {
+              const result = stmt.run(
+                update.digest_text,
+                JSON.stringify(update.digest_json),
+                update.closed_at,
+                update.closed_at,
+                update.frame_id
+              );
+              stats.successfulInserts += result.changes;
+            } catch (error) {
+              stats.failedInserts++;
+              const wrappedError = wrapError(
+                error,
+                "Failed to update frame digest",
+                ErrorCode.DB_UPDATE_FAILED,
+                { frameId: update.frame_id }
+              );
+              logger.warn("Failed to update frame digest", {
+                frameId: update.frame_id,
+                error: wrappedError.message
+              });
+            }
+          }
+        };
+        if (enableTransactions) {
+          const transaction = this.db.transaction(updateFn);
+          await this.processBatches(updates, batchSize, transaction, stats);
+        } else {
+          await this.processBatches(updates, batchSize, updateFn, stats);
+        }
+        stats.totalTimeMs = performance.now() - startTime;
+        stats.avgBatchTimeMs = stats.batchesProcessed > 0 ? stats.totalTimeMs / stats.batchesProcessed : 0;
+        logger.info(
+          "Bulk frame digest update completed",
+          stats
+        );
+        return stats;
+      }
+    );
+  }
+  /**
+   * Generic bulk insert with preprocessing
+   */
+  async performBulkInsert(table, records, options = {}) {
+    const {
+      batchSize = 100,
+      onConflict = "ignore",
+      enableTransactions = true,
+      preprocessor
+    } = options;
+    return trace.traceAsync(
+      "function",
+      `bulkInsert${table}`,
+      { count: records.length },
+      async () => {
+        const startTime = performance.now();
+        const stats = {
+          totalRecords: records.length,
+          batchesProcessed: 0,
+          successfulInserts: 0,
+          failedInserts: 0,
+          totalTimeMs: 0,
+          avgBatchTimeMs: 0
+        };
+        if (records.length === 0) return stats;
+        const processedRecords = preprocessor ? records.map(preprocessor) : records;
+        const firstRecord = processedRecords[0];
+        const columns = Object.keys(firstRecord);
+        const placeholders = columns.map(() => "?").join(", ");
+        const conflictClause = this.getConflictClause(onConflict);
+        const insertSql = `INSERT ${conflictClause} INTO ${table} (${columns.join(", ")}) VALUES (${placeholders})`;
+        const stmt = this.db.prepare(insertSql);
+        const insertFn = (batch) => {
+          for (const record of batch) {
+            try {
+              const values = columns.map((col) => record[col]);
+              const result = stmt.run(...values);
+              stats.successfulInserts += result.changes;
+            } catch (error) {
+              stats.failedInserts++;
+              const wrappedError = wrapError(
+                error,
+                `Failed to insert ${table} record`,
+                ErrorCode.DB_INSERT_FAILED,
+                { table, record }
+              );
+              logger.warn(`Failed to insert ${table} record`, {
+                record,
+                error: wrappedError.message
+              });
+            }
+          }
+        };
+        if (enableTransactions) {
+          const transaction = this.db.transaction(insertFn);
+          await this.processBatches(
+            processedRecords,
+            batchSize,
+            transaction,
+            stats
+          );
+        } else {
+          await this.processBatches(
+            processedRecords,
+            batchSize,
+            insertFn,
+            stats
+          );
+        }
+        stats.totalTimeMs = performance.now() - startTime;
+        stats.avgBatchTimeMs = stats.batchesProcessed > 0 ? stats.totalTimeMs / stats.batchesProcessed : 0;
+        logger.info(
+          `Bulk ${table} insert completed`,
+          stats
+        );
+        return stats;
+      }
+    );
+  }
+  /**
+   * Process records in batches
+   */
+  async processBatches(records, batchSize, processFn, stats) {
+    for (let i = 0; i < records.length; i += batchSize) {
+      const batch = records.slice(i, i + batchSize);
+      const batchStart = performance.now();
+      try {
+        processFn(batch);
+        stats.batchesProcessed++;
+        const batchTime = performance.now() - batchStart;
+        logger.debug("Batch processed", {
+          batchNumber: stats.batchesProcessed,
+          records: batch.length,
+          timeMs: batchTime.toFixed(2)
+        });
+        if (stats.batchesProcessed % 10 === 0) {
+          await new Promise((resolve) => setImmediate(resolve));
+        }
+      } catch (error) {
+        stats.failedInserts += batch.length;
+        const wrappedError = wrapError(
+          error,
+          "Batch processing failed",
+          ErrorCode.DB_TRANSACTION_FAILED,
+          { batchNumber: stats.batchesProcessed + 1, batchSize: batch.length }
+        );
+        logger.error("Batch processing failed", wrappedError, {
+          batchNumber: stats.batchesProcessed + 1,
+          batchSize: batch.length
+        });
+      }
+    }
+  }
+  /**
+   * Queue batch operation for later processing
+   */
+  queueBatchOperation(operation) {
+    this.batchQueue.push(operation);
+    if (this.batchQueue.length >= 10 && !this.isProcessing) {
+      setImmediate(() => this.processBatchQueue());
+    }
+  }
+  /**
+   * Process queued batch operations
+   */
+  async processBatchQueue() {
+    if (this.isProcessing || this.batchQueue.length === 0) {
+      return;
+    }
+    this.isProcessing = true;
+    const operations = [...this.batchQueue];
+    this.batchQueue = [];
+    try {
+      const groupedOps = this.groupOperationsByTable(operations);
+      for (const [table, tableOps] of groupedOps) {
+        await this.processTableOperations(table, tableOps);
+      }
+      logger.info("Batch queue processed", {
+        operations: operations.length,
+        tables: groupedOps.size
+      });
+    } catch (error) {
+      const wrappedError = wrapError(
+        error,
+        "Batch queue processing failed",
+        ErrorCode.DB_TRANSACTION_FAILED,
+        { operationsCount: operations.length }
+      );
+      logger.error("Batch queue processing failed", wrappedError);
+    } finally {
+      this.isProcessing = false;
+    }
+  }
+  /**
+   * Flush any remaining queued operations
+   */
+  async flush() {
+    if (this.batchQueue.length > 0) {
+      await this.processBatchQueue();
+    }
+  }
+  /**
+   * Get SQL conflict clause
+   */
+  getConflictClause(onConflict) {
+    switch (onConflict) {
+      case "ignore":
+        return "OR IGNORE";
+      case "replace":
+        return "OR REPLACE";
+      case "update":
+        return "ON CONFLICT DO UPDATE SET";
+      default:
+        return "";
+    }
+  }
+  /**
+   * Group operations by table for efficient processing
+   */
+  groupOperationsByTable(operations) {
+    const grouped = /* @__PURE__ */ new Map();
+    for (const op of operations) {
+      if (!grouped.has(op.table)) {
+        grouped.set(op.table, []);
+      }
+      grouped.get(op.table).push(op);
+    }
+    return grouped;
+  }
+  /**
+   * Process all operations for a specific table
+   */
+  async processTableOperations(table, operations) {
+    for (const op of operations) {
+      switch (op.operation) {
+        case "insert":
+          await this.performBulkInsert(table, op.data, {
+            onConflict: op.onConflict
+          });
+          break;
+        // Add update and delete operations as needed
+        default:
+          logger.warn("Unsupported batch operation", {
+            table,
+            operation: op.operation
+          });
+      }
+    }
+  }
+  /**
+   * Initialize commonly used prepared statements
+   */
+  initializePreparedStatements() {
+    this.preparedStatements.set(
+      "insert_event",
+      this.db.prepare(`
+        INSERT OR IGNORE INTO events 
+        (event_id, frame_id, run_id, seq, event_type, payload, ts) 
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `)
+    );
+    this.preparedStatements.set(
+      "insert_anchor",
+      this.db.prepare(`
+        INSERT OR IGNORE INTO anchors 
+        (anchor_id, frame_id, type, text, priority, metadata, created_at) 
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `)
+    );
+    logger.info("Batch operations prepared statements initialized");
+  }
+  /**
+   * Cleanup resources
+   */
+  cleanup() {
+    this.preparedStatements.clear();
+  }
+}
+let globalBatchManager = null;
+function getBatchManager(db) {
+  if (!globalBatchManager) {
+    globalBatchManager = new BatchOperationsManager(db);
+  }
+  return globalBatchManager;
+}
+async function bulkInsertEvents(events, options) {
+  const manager = getBatchManager();
+  return manager.bulkInsertEvents(events, options);
+}
+async function bulkInsertAnchors(anchors, options) {
+  const manager = getBatchManager();
+  return manager.bulkInsertAnchors(anchors, options);
+}
+export {
+  BatchOperationsManager,
+  bulkInsertAnchors,
+  bulkInsertEvents,
+  getBatchManager
+};
+//# sourceMappingURL=batch-operations.js.map