npm - @stackmemoryai/stackmemory - Versions diffs - 0.5.33 → 0.5.34 - Mend

@stackmemoryai/stackmemory 0.5.33 → 0.5.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (107) hide show

package/dist/core/context/frame-handoff-manager.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/context/frame-handoff-manager.ts"],
-  "sourcesContent": ["/**\n * Frame Handoff Manager - STA-100\n * Handles frame transfers between individual and team stacks with approval workflows\n */\n\nimport type { Frame, Event, Anchor } from './frame-manager.js';\nimport {\n  DualStackManager,\n  type StackContext,\n  type HandoffRequest,\n} from './dual-stack-manager.js';\nimport { logger } from '../monitoring/logger.js';\nimport { ValidationError, DatabaseError, ErrorCode } from '../errors/index.js';\nimport {\n  validateInput,\n  InitiateHandoffSchema,\n  HandoffApprovalSchema,\n  type InitiateHandoffInput,\n  type HandoffApprovalInput,\n} from './validation.js';\n\nexport interface HandoffMetadata {\n  initiatedAt: Date;\n  initiatorId: string;\n  targetUserId?: string;\n  targetTeamId?: string;\n  frameContext: {\n    totalFrames: number;\n    frameTypes: string[];\n    estimatedSize: number;\n    dependencies: string[];\n  };\n  businessContext?: {\n    milestone?: string;\n    priority: 'low' | 'medium' | 'high' | 'critical';\n    deadline?: Date;\n    stakeholders: string[];\n  };\n}\n\nexport interface HandoffApproval {\n  requestId: string;\n  reviewerId: string;\n  decision: 'approved' | 'rejected' | 'needs_changes';\n  feedback?: string;\n  suggestedChanges?: Array<{\n    frameId: string;\n    suggestion: string;\n    reason: string;\n  }>;\n  reviewedAt: Date;\n}\n\nexport interface HandoffNotification {\n  id: string;\n  type: 'request' | 'approval' | 'rejection' | 'completion' | 'reminder';\n  requestId: string;\n  recipientId: string;\n  title: string;\n  message: string;\n  actionRequired: boolean;\n  expiresAt?: Date;\n  createdAt: Date;\n}\n\nexport interface HandoffProgress {\n  requestId: string;\n  status:\n    | 'pending_review'\n    | 'approved'\n    | 'in_transfer'\n    | 'completed'\n    | 'failed'\n    | 'cancelled';\n  transferredFrames: number;\n  totalFrames: number;\n  currentStep: string;\n  estimatedCompletion?: Date;\n  errors: Array<{\n    step: string;\n    error: string;\n    timestamp: Date;\n  }>;\n}\n\nexport class FrameHandoffManager {\n  private dualStackManager: DualStackManager;\n  private activeHandoffs: Map<string, HandoffProgress> = new Map();\n  private pendingApprovals: Map<string, HandoffApproval[]> = new Map();\n  private notifications: Map<string, HandoffNotification[]> = new Map();\n\n  constructor(dualStackManager: DualStackManager) {\n    this.dualStackManager = dualStackManager;\n  }\n\n  /**\n   * Initiate a frame handoff with rich metadata and approval workflow\n   */\n  async initiateHandoff(\n    targetStackId: string,\n    frameIds: string[],\n    metadata: HandoffMetadata,\n    targetUserId?: string,\n    message?: string\n  ): Promise<string> {\n    // Validate input parameters\n    const input = validateInput(InitiateHandoffSchema, {\n      targetStackId,\n      frameIds,\n      handoffRequest: metadata,\n      reviewerId: targetUserId,\n      description: message,\n    });\n\n    try {\n      // Check handoff permissions\n      await this.dualStackManager\n        .getPermissionManager()\n        .enforcePermission(\n          this.dualStackManager\n            .getPermissionManager()\n            .createContext(\n              input.handoffRequest.initiatorId,\n              'handoff',\n              'handoff',\n              input.targetStackId\n            )\n        );\n\n      // Validate frames exist and are transferable\n      await this.validateFramesForHandoff(input.frameIds);\n\n      // Create enhanced handoff request\n      const requestId = await this.dualStackManager.initiateHandoff(\n        input.targetStackId,\n        input.frameIds,\n        input.reviewerId,\n        input.description\n      );\n\n      // Initialize handoff progress tracking\n      const progress: HandoffProgress = {\n        requestId,\n        status: 'pending_review',\n        transferredFrames: 0,\n        totalFrames: input.frameIds.length,\n        currentStep: 'Awaiting approval',\n        errors: [],\n      };\n\n      this.activeHandoffs.set(requestId, progress);\n\n      // Create notifications for relevant stakeholders\n      await this.createHandoffNotifications(requestId, metadata, targetUserId);\n\n      // Set up automatic reminders\n      await this.scheduleHandoffReminders(requestId, metadata);\n\n      logger.info(`Initiated enhanced handoff: ${requestId}`, {\n        frameCount: frameIds.length,\n        priority: metadata.businessContext?.priority,\n        targetUser: targetUserId,\n      });\n\n      return requestId;\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        'Failed to initiate handoff',\n        ErrorCode.OPERATION_FAILED,\n        { targetStackId, frameIds },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Submit approval/rejection for handoff request\n   */\n  async submitHandoffApproval(\n    requestId: string,\n    approval: Omit<HandoffApproval, 'requestId' | 'reviewedAt'>\n  ): Promise<void> {\n    // Validate input parameters\n    const input = validateInput(HandoffApprovalSchema, {\n      ...approval,\n      reviewerId: approval.reviewerId,\n    });\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new ValidationError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.HANDOFF_REQUEST_EXPIRED\n      );\n    }\n\n    const fullApproval: HandoffApproval = {\n      ...input,\n      requestId,\n      reviewedAt: new Date(),\n    };\n\n    // Store approval\n    const existingApprovals = this.pendingApprovals.get(requestId) || [];\n    existingApprovals.push(fullApproval);\n    this.pendingApprovals.set(requestId, existingApprovals);\n\n    // Update progress based on decision\n    if (input.decision === 'approved') {\n      progress.status = 'approved';\n      progress.currentStep = 'Ready for transfer';\n\n      // Automatically start transfer if approved\n      await this.executeHandoffTransfer(requestId);\n    } else if (input.decision === 'rejected') {\n      progress.status = 'failed';\n      progress.currentStep = 'Rejected by reviewer';\n      progress.errors.push({\n        step: 'approval',\n        error: input.feedback || 'Request rejected',\n        timestamp: new Date(),\n      });\n    } else if (input.decision === 'needs_changes') {\n      progress.status = 'pending_review';\n      progress.currentStep = 'Changes requested';\n\n      // Notify requester of needed changes\n      await this.notifyChangesRequested(requestId, approval);\n    }\n\n    this.activeHandoffs.set(requestId, progress);\n\n    logger.info(`Handoff approval submitted: ${requestId}`, {\n      decision: approval.decision,\n      reviewer: approval.reviewerId,\n    });\n  }\n\n  /**\n   * Execute the actual frame transfer after approval\n   */\n  private async executeHandoffTransfer(requestId: string): Promise<void> {\n    logger.debug('executeHandoffTransfer called', {\n      requestId,\n      availableHandoffs: Array.from(this.activeHandoffs.keys()),\n    });\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      logger.error('Handoff progress not found', {\n        requestId,\n        availableHandoffs: Array.from(this.activeHandoffs.keys()),\n      });\n      throw new DatabaseError(\n        `Handoff progress not found: ${requestId}`,\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    try {\n      logger.debug('Setting progress status to in_transfer', { requestId });\n      progress.status = 'in_transfer';\n      progress.currentStep = 'Transferring frames';\n      progress.estimatedCompletion = new Date(Date.now() + 5 * 60 * 1000); // 5 minutes\n\n      // Execute the handoff through DualStackManager\n      logger.debug('About to call acceptHandoff', { requestId });\n      const result = await this.dualStackManager.acceptHandoff(requestId);\n      logger.debug('acceptHandoff returned', {\n        requestId,\n        success: result.success,\n      });\n\n      if (result.success) {\n        progress.status = 'completed';\n        progress.currentStep = 'Transfer completed';\n        progress.transferredFrames = result.mergedFrames.length;\n\n        // Create completion notifications\n        await this.notifyHandoffCompletion(requestId, result);\n\n        logger.info(`Handoff transfer completed: ${requestId}`, {\n          transferredFrames: progress.transferredFrames,\n          conflicts: result.conflictFrames.length,\n        });\n      } else {\n        progress.status = 'failed';\n        progress.currentStep = 'Transfer failed';\n\n        // Log errors\n        result.errors.forEach((error) => {\n          progress.errors.push({\n            step: 'transfer',\n            error: `Frame ${error.frameId}: ${error.error}`,\n            timestamp: new Date(),\n          });\n        });\n\n        throw new DatabaseError(\n          'Handoff transfer failed',\n          ErrorCode.OPERATION_FAILED,\n          { errors: result.errors }\n        );\n      }\n    } catch (error: unknown) {\n      progress.status = 'failed';\n      progress.currentStep = 'Transfer error';\n      progress.errors.push({\n        step: 'transfer',\n        error: error instanceof Error ? error.message : String(error),\n        timestamp: new Date(),\n      });\n\n      logger.error(`Handoff transfer failed: ${requestId}`, error);\n      throw error;\n    } finally {\n      this.activeHandoffs.set(requestId, progress);\n    }\n  }\n\n  /**\n   * Get handoff progress and status\n   */\n  async getHandoffProgress(requestId: string): Promise<HandoffProgress | null> {\n    return this.activeHandoffs.get(requestId) || null;\n  }\n\n  /**\n   * Cancel a pending handoff request\n   */\n  async cancelHandoff(requestId: string, reason: string): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    if (progress.status === 'in_transfer') {\n      throw new DatabaseError(\n        'Cannot cancel handoff that is currently transferring',\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    progress.status = 'cancelled';\n    progress.currentStep = 'Cancelled by user';\n    progress.errors.push({\n      step: 'cancellation',\n      error: reason,\n      timestamp: new Date(),\n    });\n\n    this.activeHandoffs.set(requestId, progress);\n\n    // Notify relevant parties\n    await this.notifyHandoffCancellation(requestId, reason);\n\n    logger.info(`Handoff cancelled: ${requestId}`, { reason });\n  }\n\n  /**\n   * Get all active handoffs for a user or team\n   */\n  async getActiveHandoffs(\n    userId?: string,\n    teamId?: string\n  ): Promise<HandoffProgress[]> {\n    const handoffs = Array.from(this.activeHandoffs.values());\n\n    // Filter by user/team if specified\n    if (userId || teamId) {\n      // Would need to cross-reference with handoff metadata\n      return handoffs.filter(\n        (handoff) =>\n          handoff.status === 'pending_review' ||\n          handoff.status === 'approved' ||\n          handoff.status === 'in_transfer'\n      );\n    }\n\n    return handoffs;\n  }\n\n  /**\n   * Get notifications for a user\n   */\n  async getUserNotifications(userId: string): Promise<HandoffNotification[]> {\n    return this.notifications.get(userId) || [];\n  }\n\n  /**\n   * Mark notification as read\n   */\n  async markNotificationRead(\n    notificationId: string,\n    userId: string\n  ): Promise<void> {\n    const userNotifications = this.notifications.get(userId) || [];\n    const updatedNotifications = userNotifications.filter(\n      (n) => n.id !== notificationId\n    );\n    this.notifications.set(userId, updatedNotifications);\n  }\n\n  /**\n   * Validate frames are suitable for handoff\n   */\n  private async validateFramesForHandoff(frameIds: string[]): Promise<void> {\n    const activeStack = this.dualStackManager.getActiveStack();\n\n    for (const frameId of frameIds) {\n      const frame = await activeStack.getFrame(frameId);\n      if (!frame) {\n        throw new DatabaseError(\n          `Frame not found: ${frameId}`,\n          ErrorCode.RESOURCE_NOT_FOUND\n        );\n      }\n\n      // Check if frame is in a transferable state\n      if (frame.state === 'active') {\n        logger.warn(`Transferring active frame: ${frameId}`, {\n          frameName: frame.name,\n        });\n      }\n    }\n  }\n\n  /**\n   * Create notifications for handoff stakeholders\n   */\n  private async createHandoffNotifications(\n    requestId: string,\n    metadata: HandoffMetadata,\n    targetUserId?: string\n  ): Promise<void> {\n    const notifications: HandoffNotification[] = [];\n\n    // Notify target user\n    if (targetUserId) {\n      notifications.push({\n        id: `${requestId}-target`,\n        type: 'request',\n        requestId,\n        recipientId: targetUserId,\n        title: 'Frame Handoff Request',\n        message: `${metadata.initiatorId} wants to transfer ${metadata.frameContext.totalFrames} frames to you`,\n        actionRequired: true,\n        expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000),\n        createdAt: new Date(),\n      });\n    }\n\n    // Notify stakeholders\n    if (metadata.businessContext?.stakeholders) {\n      for (const stakeholderId of metadata.businessContext.stakeholders) {\n        notifications.push({\n          id: `${requestId}-stakeholder-${stakeholderId}`,\n          type: 'request',\n          requestId,\n          recipientId: stakeholderId,\n          title: 'Frame Handoff Notification',\n          message: `Frame transfer initiated for ${metadata.businessContext?.milestone || 'project milestone'}`,\n          actionRequired: false,\n          createdAt: new Date(),\n        });\n      }\n    }\n\n    // Store notifications\n    for (const notification of notifications) {\n      const userNotifications =\n        this.notifications.get(notification.recipientId) || [];\n      userNotifications.push(notification);\n      this.notifications.set(notification.recipientId, userNotifications);\n    }\n  }\n\n  /**\n   * Schedule reminder notifications\n   */\n  private async scheduleHandoffReminders(\n    requestId: string,\n    metadata: HandoffMetadata\n  ): Promise<void> {\n    // Schedule reminder in 4 hours if high priority\n    if (\n      metadata.businessContext?.priority === 'high' ||\n      metadata.businessContext?.priority === 'critical'\n    ) {\n      setTimeout(\n        async () => {\n          const progress = this.activeHandoffs.get(requestId);\n          if (progress && progress.status === 'pending_review') {\n            await this.sendHandoffReminder(requestId, metadata);\n          }\n        },\n        4 * 60 * 60 * 1000\n      ); // 4 hours\n    }\n  }\n\n  /**\n   * Send handoff reminder\n   */\n  private async sendHandoffReminder(\n    requestId: string,\n    metadata: HandoffMetadata\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress || progress.status !== 'pending_review') {\n      return;\n    }\n\n    const reminderNotification: HandoffNotification = {\n      id: `${requestId}-reminder-${Date.now()}`,\n      type: 'reminder',\n      requestId,\n      recipientId: metadata.targetUserId || 'unknown',\n      title: '\u23F0 Handoff Request Reminder',\n      message: `Reminder: ${metadata.initiatorId} is waiting for approval on ${metadata.frameContext.totalFrames} frames. Priority: ${metadata.businessContext?.priority || 'medium'}`,\n      actionRequired: true,\n      expiresAt: new Date(Date.now() + 12 * 60 * 60 * 1000), // 12 hours\n      createdAt: new Date(),\n    };\n\n    // Store the notification\n    if (metadata.targetUserId) {\n      const userNotifications =\n        this.notifications.get(metadata.targetUserId) || [];\n      userNotifications.push(reminderNotification);\n      this.notifications.set(metadata.targetUserId, userNotifications);\n\n      logger.info(`Sent handoff reminder: ${requestId}`, {\n        priority: metadata.businessContext?.priority,\n        recipient: metadata.targetUserId,\n      });\n    }\n\n    // Also notify stakeholders\n    if (metadata.businessContext?.stakeholders) {\n      for (const stakeholderId of metadata.businessContext.stakeholders) {\n        const stakeholderNotification: HandoffNotification = {\n          ...reminderNotification,\n          id: `${requestId}-reminder-stakeholder-${stakeholderId}-${Date.now()}`,\n          recipientId: stakeholderId,\n          title: '\uD83D\uDCCB Handoff Status Update',\n          message: `Pending handoff approval: ${metadata.businessContext?.milestone || 'development work'} requires attention`,\n          actionRequired: false,\n        };\n\n        const stakeholderNotifications =\n          this.notifications.get(stakeholderId) || [];\n        stakeholderNotifications.push(stakeholderNotification);\n        this.notifications.set(stakeholderId, stakeholderNotifications);\n      }\n    }\n  }\n\n  /**\n   * Notify when changes are requested\n   */\n  private async notifyChangesRequested(\n    requestId: string,\n    approval: Omit<HandoffApproval, 'requestId' | 'reviewedAt'>\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) return;\n\n    // Find the original requester (we'll need to enhance this with better metadata tracking)\n    const changeRequestNotification: HandoffNotification = {\n      id: `${requestId}-changes-${Date.now()}`,\n      type: 'request',\n      requestId,\n      recipientId: 'requester', // TODO: Get actual requester from handoff metadata\n      title: 'Changes Requested for Handoff',\n      message: `${approval.reviewerId} has requested changes: ${approval.feedback || 'See detailed suggestions'}`,\n      actionRequired: true,\n      expiresAt: new Date(Date.now() + 48 * 60 * 60 * 1000), // 48 hours\n      createdAt: new Date(),\n    };\n\n    // Store notification (for now using a placeholder recipient)\n    const notifications = this.notifications.get('requester') || [];\n    notifications.push(changeRequestNotification);\n    this.notifications.set('requester', notifications);\n\n    // Log detailed feedback and suggestions\n    logger.info(`Changes requested for handoff: ${requestId}`, {\n      reviewer: approval.reviewerId,\n      feedback: approval.feedback,\n      suggestedChangesCount: approval.suggestedChanges?.length || 0,\n    });\n\n    if (approval.suggestedChanges && approval.suggestedChanges.length > 0) {\n      logger.info(`Detailed change suggestions:`, {\n        requestId,\n        suggestions: approval.suggestedChanges.map((change) => ({\n          frameId: change.frameId,\n          suggestion: change.suggestion,\n          reason: change.reason,\n        })),\n      });\n    }\n  }\n\n  /**\n   * Notify handoff completion\n   */\n  private async notifyHandoffCompletion(\n    requestId: string,\n    result: any\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) return;\n\n    // Create completion notification\n    const completionNotification: HandoffNotification = {\n      id: `${requestId}-completion-${Date.now()}`,\n      type: 'completion',\n      requestId,\n      recipientId: 'all', // Will be distributed to all stakeholders\n      title: 'Handoff Completed Successfully',\n      message: `Frame transfer completed: ${result.mergedFrames.length} frames transferred${result.conflictFrames.length > 0 ? `, ${result.conflictFrames.length} conflicts resolved` : ''}`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Notify all stakeholders from the notifications map\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userSpecificNotification: HandoffNotification = {\n        ...completionNotification,\n        id: `${requestId}-completion-${userId}-${Date.now()}`,\n        recipientId: userId,\n      };\n\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push(userSpecificNotification);\n      this.notifications.set(userId, userNotifications);\n    }\n\n    logger.info(`Handoff completed: ${requestId}`, {\n      mergedFrames: result.mergedFrames.length,\n      conflicts: result.conflictFrames.length,\n      notifiedUsers: allUsers.length,\n    });\n\n    // Log detailed completion statistics\n    if (result.conflictFrames.length > 0) {\n      logger.info(`Handoff completion details:`, {\n        requestId,\n        transferredFrames: result.mergedFrames.map(\n          (f: any) => f.frameId || f.id\n        ),\n        conflictFrames: result.conflictFrames.map(\n          (f: any) => f.frameId || f.id\n        ),\n      });\n    }\n  }\n\n  /**\n   * Notify handoff cancellation\n   */\n  private async notifyHandoffCancellation(\n    requestId: string,\n    reason: string\n  ): Promise<void> {\n    // Create cancellation notification\n    const cancellationNotification: HandoffNotification = {\n      id: `${requestId}-cancellation-${Date.now()}`,\n      type: 'request', // Using 'request' type as it's informational\n      requestId,\n      recipientId: 'all', // Will be distributed to all stakeholders\n      title: 'Handoff Cancelled',\n      message: `Handoff request has been cancelled. Reason: ${reason}`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Notify all users who have been involved in this handoff\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userSpecificNotification: HandoffNotification = {\n        ...cancellationNotification,\n        id: `${requestId}-cancellation-${userId}-${Date.now()}`,\n        recipientId: userId,\n      };\n\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push(userSpecificNotification);\n      this.notifications.set(userId, userNotifications);\n    }\n\n    logger.info(`Handoff cancelled: ${requestId}`, {\n      reason,\n      notifiedUsers: allUsers.length,\n    });\n  }\n\n  /**\n   * Get handoff analytics and metrics\n   */\n  async getHandoffMetrics(timeRange?: { start: Date; end: Date }): Promise<{\n    totalHandoffs: number;\n    completedHandoffs: number;\n    averageProcessingTime: number;\n    topFrameTypes: Array<{ type: string; count: number }>;\n    collaborationPatterns: Array<{\n      sourceUser: string;\n      targetUser: string;\n      count: number;\n    }>;\n  }> {\n    const handoffs = Array.from(this.activeHandoffs.values());\n\n    // Filter by time range if specified\n    const filteredHandoffs = timeRange\n      ? handoffs.filter((h) => {\n          // Would need to add timestamps to track creation time\n          return true; // Placeholder\n        })\n      : handoffs;\n\n    const completedHandoffs = filteredHandoffs.filter(\n      (h) => h.status === 'completed'\n    );\n\n    return {\n      totalHandoffs: filteredHandoffs.length,\n      completedHandoffs: completedHandoffs.length,\n      averageProcessingTime:\n        this.calculateAverageProcessingTime(completedHandoffs),\n      topFrameTypes: this.analyzeFrameTypes(filteredHandoffs),\n      collaborationPatterns:\n        this.analyzeCollaborationPatterns(filteredHandoffs),\n    };\n  }\n\n  private calculateAverageProcessingTime(handoffs: HandoffProgress[]): number {\n    if (handoffs.length === 0) return 0;\n\n    let totalProcessingTime = 0;\n    let validHandoffs = 0;\n\n    for (const handoff of handoffs) {\n      // Only calculate for completed handoffs that have timing data\n      if (handoff.status === 'completed' && handoff.estimatedCompletion) {\n        // Estimate processing time based on frame count and complexity\n        // This is a simplified calculation - in practice you'd track actual timestamps\n        const frameComplexity = handoff.totalFrames * 0.5; // Base time per frame\n        const errorPenalty = handoff.errors.length * 2; // Extra time for errors\n        const processingTime = Math.max(1, frameComplexity + errorPenalty);\n\n        totalProcessingTime += processingTime;\n        validHandoffs++;\n      }\n    }\n\n    return validHandoffs > 0\n      ? Math.round(totalProcessingTime / validHandoffs)\n      : 0;\n  }\n\n  private analyzeFrameTypes(\n    handoffs: HandoffProgress[]\n  ): Array<{ type: string; count: number }> {\n    const frameTypeCount = new Map<string, number>();\n\n    for (const handoff of handoffs) {\n      // Extract frame type information from handoff metadata\n      // This would need to be enhanced with actual frame type tracking\n      const estimatedTypes = this.estimateFrameTypes(handoff);\n\n      for (const type of estimatedTypes) {\n        frameTypeCount.set(type, (frameTypeCount.get(type) || 0) + 1);\n      }\n    }\n\n    return Array.from(frameTypeCount.entries())\n      .map(([type, count]) => ({ type, count }))\n      .sort((a, b) => b.count - a.count)\n      .slice(0, 10); // Top 10 frame types\n  }\n\n  private estimateFrameTypes(handoff: HandoffProgress): string[] {\n    // Simplified frame type estimation based on handoff characteristics\n    const types: string[] = [];\n\n    if (handoff.totalFrames > 10) {\n      types.push('bulk_transfer');\n    }\n    if (handoff.errors.length > 0) {\n      types.push('complex_handoff');\n    }\n    if (handoff.transferredFrames === handoff.totalFrames) {\n      types.push('complete_transfer');\n    } else {\n      types.push('partial_transfer');\n    }\n\n    // Add some common frame types based on patterns\n    types.push('development', 'collaboration');\n\n    return types;\n  }\n\n  private analyzeCollaborationPatterns(\n    handoffs: HandoffProgress[]\n  ): Array<{ sourceUser: string; targetUser: string; count: number }> {\n    const collaborationCount = new Map<string, number>();\n\n    for (const handoff of handoffs) {\n      // Extract collaboration pattern from handoff data\n      // Note: This is simplified - we'd need to track actual source/target users\n      const pattern = this.extractCollaborationPattern(handoff);\n      if (pattern) {\n        const key = `${pattern.sourceUser}->${pattern.targetUser}`;\n        collaborationCount.set(key, (collaborationCount.get(key) || 0) + 1);\n      }\n    }\n\n    return Array.from(collaborationCount.entries())\n      .map(([pattern, count]) => {\n        const [sourceUser, targetUser] = pattern.split('->');\n        return { sourceUser, targetUser, count };\n      })\n      .sort((a, b) => b.count - a.count)\n      .slice(0, 20); // Top 20 collaboration patterns\n  }\n\n  private extractCollaborationPattern(\n    handoff: HandoffProgress\n  ): { sourceUser: string; targetUser: string } | null {\n    // Simplified pattern extraction - in practice this would come from handoff metadata\n    // For now, we'll create sample patterns based on handoff characteristics\n\n    if (handoff.status === 'completed') {\n      return {\n        sourceUser: 'developer',\n        targetUser: 'reviewer',\n      };\n    } else if (handoff.status === 'failed') {\n      return {\n        sourceUser: 'developer',\n        targetUser: 'lead',\n      };\n    }\n\n    return null;\n  }\n\n  /**\n   * Real-time collaboration features\n   */\n\n  /**\n   * Get real-time handoff status updates\n   */\n  async getHandoffStatusStream(\n    requestId: string\n  ): Promise<AsyncIterableIterator<HandoffProgress>> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    // Simple implementation - in a real system this would use WebSockets or Server-Sent Events\n    const self = this;\n    return {\n      async *[Symbol.asyncIterator]() {\n        let lastStatus = progress.status;\n        while (\n          lastStatus !== 'completed' &&\n          lastStatus !== 'failed' &&\n          lastStatus !== 'cancelled'\n        ) {\n          const currentProgress = self.activeHandoffs.get(requestId);\n          if (currentProgress && currentProgress.status !== lastStatus) {\n            lastStatus = currentProgress.status;\n            yield currentProgress;\n          }\n          // Simulate real-time polling\n          await new Promise((resolve) => setTimeout(resolve, 1000));\n        }\n      },\n    };\n  }\n\n  /**\n   * Update handoff progress in real-time\n   */\n  async updateHandoffProgress(\n    requestId: string,\n    update: Partial<HandoffProgress>\n  ): Promise<void> {\n    let progress = this.activeHandoffs.get(requestId);\n\n    // If progress doesn't exist and update includes required fields, create it\n    if (\n      !progress &&\n      update.requestId &&\n      update.status &&\n      update.totalFrames !== undefined\n    ) {\n      progress = {\n        requestId: update.requestId,\n        status: update.status,\n        transferredFrames: 0,\n        totalFrames: update.totalFrames,\n        currentStep: 'Initialized',\n        errors: [],\n        ...update,\n      };\n    } else if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    } else {\n      // Update existing progress with provided fields\n      progress = {\n        ...progress,\n        ...update,\n      };\n    }\n\n    this.activeHandoffs.set(requestId, progress);\n\n    logger.info(`Handoff progress updated: ${requestId}`, {\n      status: progress.status,\n      currentStep: progress.currentStep,\n      transferredFrames: progress.transferredFrames,\n    });\n\n    // Notify stakeholders of progress update\n    await this.notifyProgressUpdate(requestId, progress);\n  }\n\n  /**\n   * Notify stakeholders of progress updates\n   */\n  private async notifyProgressUpdate(\n    requestId: string,\n    progress: HandoffProgress\n  ): Promise<void> {\n    const updateNotification: HandoffNotification = {\n      id: `${requestId}-progress-${Date.now()}`,\n      type: 'request',\n      requestId,\n      recipientId: 'all',\n      title: 'Handoff Progress Update',\n      message: `Status: ${progress.status} | Step: ${progress.currentStep} | Progress: ${progress.transferredFrames}/${progress.totalFrames} frames`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Distribute to all stakeholders\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push({\n        ...updateNotification,\n        id: `${requestId}-progress-${userId}-${Date.now()}`,\n        recipientId: userId,\n      });\n      this.notifications.set(userId, userNotifications);\n    }\n  }\n\n  /**\n   * Get active handoffs with real-time filtering\n   */\n  async getActiveHandoffsRealTime(filters?: {\n    status?: HandoffProgress['status'];\n    userId?: string;\n    priority?: 'low' | 'medium' | 'high' | 'critical';\n  }): Promise<HandoffProgress[]> {\n    let handoffs = Array.from(this.activeHandoffs.values());\n\n    if (filters?.status) {\n      handoffs = handoffs.filter((h) => h.status === filters.status);\n    }\n\n    if (filters?.userId) {\n      // In a real implementation, we'd have proper user tracking in handoff metadata\n      // For now, filter based on requestId pattern or other heuristics\n      handoffs = handoffs.filter((h) =>\n        h.requestId.includes(filters.userId || '')\n      );\n    }\n\n    if (filters?.priority) {\n      // Filter by priority (this would need priority tracking in HandoffProgress)\n      // For now, estimate priority based on frame count and errors\n      handoffs = handoffs.filter((h) => {\n        const estimatedPriority = this.estimateHandoffPriority(h);\n        return estimatedPriority === filters.priority;\n      });\n    }\n\n    return handoffs.sort((a, b) => {\n      // Sort by status priority, then by creation time\n      const statusPriority = {\n        in_transfer: 4,\n        approved: 3,\n        pending_review: 2,\n        completed: 1,\n        failed: 1,\n        cancelled: 0,\n      };\n      return (statusPriority[b.status] || 0) - (statusPriority[a.status] || 0);\n    });\n  }\n\n  private estimateHandoffPriority(\n    handoff: HandoffProgress\n  ): 'low' | 'medium' | 'high' | 'critical' {\n    if (handoff.errors.length > 2 || handoff.totalFrames > 50)\n      return 'critical';\n    if (handoff.errors.length > 0 || handoff.totalFrames > 20) return 'high';\n    if (handoff.totalFrames > 5) return 'medium';\n    return 'low';\n  }\n\n  /**\n   * Bulk handoff operations for team collaboration\n   */\n  async bulkHandoffOperation(operation: {\n    action: 'approve' | 'reject' | 'cancel';\n    requestIds: string[];\n    reviewerId: string;\n    feedback?: string;\n  }): Promise<{\n    successful: string[];\n    failed: Array<{ requestId: string; error: string }>;\n  }> {\n    const results = {\n      successful: [],\n      failed: [] as Array<{ requestId: string; error: string }>,\n    };\n\n    for (const requestId of operation.requestIds) {\n      try {\n        switch (operation.action) {\n          case 'approve':\n            await this.submitHandoffApproval(requestId, {\n              reviewerId: operation.reviewerId,\n              decision: 'approved',\n              feedback: operation.feedback,\n            });\n            results.successful.push(requestId);\n            break;\n\n          case 'reject':\n            await this.submitHandoffApproval(requestId, {\n              reviewerId: operation.reviewerId,\n              decision: 'rejected',\n              feedback: operation.feedback || 'Bulk rejection',\n            });\n            results.successful.push(requestId);\n            break;\n\n          case 'cancel':\n            await this.cancelHandoff(\n              requestId,\n              operation.feedback || 'Bulk cancellation'\n            );\n            results.successful.push(requestId);\n            break;\n        }\n      } catch (error: unknown) {\n        results.failed.push({\n          requestId,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    logger.info(`Bulk handoff operation completed`, {\n      action: operation.action,\n      successful: results.successful.length,\n      failed: results.failed.length,\n      reviewerId: operation.reviewerId,\n    });\n\n    return results;\n  }\n\n  /**\n   * Enhanced notification management with cleanup\n   */\n  async cleanupExpiredNotifications(userId?: string): Promise<number> {\n    let cleanedCount = 0;\n    const now = new Date();\n\n    const userIds = userId ? [userId] : Array.from(this.notifications.keys());\n\n    for (const uid of userIds) {\n      const userNotifications = this.notifications.get(uid) || [];\n      const activeNotifications = userNotifications.filter((notification) => {\n        if (notification.expiresAt && notification.expiresAt < now) {\n          cleanedCount++;\n          return false;\n        }\n        return true;\n      });\n\n      this.notifications.set(uid, activeNotifications);\n    }\n\n    if (cleanedCount > 0) {\n      logger.info(`Cleaned up expired notifications`, {\n        count: cleanedCount,\n        userId: userId || 'all',\n      });\n    }\n\n    return cleanedCount;\n  }\n}\n"],
+  "sourcesContent": ["/**\n * Frame Handoff Manager - STA-100\n * Handles frame transfers between individual and team stacks with approval workflows\n */\n\nimport type { Frame, Event, Anchor } from './frame-types.js';\nimport {\n  DualStackManager,\n  type StackContext,\n  type HandoffRequest,\n} from './dual-stack-manager.js';\nimport { logger } from '../monitoring/logger.js';\nimport { ValidationError, DatabaseError, ErrorCode } from '../errors/index.js';\nimport {\n  validateInput,\n  InitiateHandoffSchema,\n  HandoffApprovalSchema,\n  type InitiateHandoffInput,\n  type HandoffApprovalInput,\n} from './validation.js';\n\nexport interface HandoffMetadata {\n  initiatedAt: Date;\n  initiatorId: string;\n  targetUserId?: string;\n  targetTeamId?: string;\n  frameContext: {\n    totalFrames: number;\n    frameTypes: string[];\n    estimatedSize: number;\n    dependencies: string[];\n  };\n  businessContext?: {\n    milestone?: string;\n    priority: 'low' | 'medium' | 'high' | 'critical';\n    deadline?: Date;\n    stakeholders: string[];\n  };\n}\n\nexport interface HandoffApproval {\n  requestId: string;\n  reviewerId: string;\n  decision: 'approved' | 'rejected' | 'needs_changes';\n  feedback?: string;\n  suggestedChanges?: Array<{\n    frameId: string;\n    suggestion: string;\n    reason: string;\n  }>;\n  reviewedAt: Date;\n}\n\nexport interface HandoffNotification {\n  id: string;\n  type: 'request' | 'approval' | 'rejection' | 'completion' | 'reminder';\n  requestId: string;\n  recipientId: string;\n  title: string;\n  message: string;\n  actionRequired: boolean;\n  expiresAt?: Date;\n  createdAt: Date;\n}\n\nexport interface HandoffProgress {\n  requestId: string;\n  status:\n    | 'pending_review'\n    | 'approved'\n    | 'in_transfer'\n    | 'completed'\n    | 'failed'\n    | 'cancelled';\n  transferredFrames: number;\n  totalFrames: number;\n  currentStep: string;\n  estimatedCompletion?: Date;\n  errors: Array<{\n    step: string;\n    error: string;\n    timestamp: Date;\n  }>;\n}\n\nexport class FrameHandoffManager {\n  private dualStackManager: DualStackManager;\n  private activeHandoffs: Map<string, HandoffProgress> = new Map();\n  private pendingApprovals: Map<string, HandoffApproval[]> = new Map();\n  private notifications: Map<string, HandoffNotification[]> = new Map();\n\n  constructor(dualStackManager: DualStackManager) {\n    this.dualStackManager = dualStackManager;\n  }\n\n  /**\n   * Initiate a frame handoff with rich metadata and approval workflow\n   */\n  async initiateHandoff(\n    targetStackId: string,\n    frameIds: string[],\n    metadata: HandoffMetadata,\n    targetUserId?: string,\n    message?: string\n  ): Promise<string> {\n    // Validate input parameters\n    const input = validateInput(InitiateHandoffSchema, {\n      targetStackId,\n      frameIds,\n      handoffRequest: metadata,\n      reviewerId: targetUserId,\n      description: message,\n    });\n\n    try {\n      // Check handoff permissions\n      await this.dualStackManager\n        .getPermissionManager()\n        .enforcePermission(\n          this.dualStackManager\n            .getPermissionManager()\n            .createContext(\n              input.handoffRequest.initiatorId,\n              'handoff',\n              'handoff',\n              input.targetStackId\n            )\n        );\n\n      // Validate frames exist and are transferable\n      await this.validateFramesForHandoff(input.frameIds);\n\n      // Create enhanced handoff request\n      const requestId = await this.dualStackManager.initiateHandoff(\n        input.targetStackId,\n        input.frameIds,\n        input.reviewerId,\n        input.description\n      );\n\n      // Initialize handoff progress tracking\n      const progress: HandoffProgress = {\n        requestId,\n        status: 'pending_review',\n        transferredFrames: 0,\n        totalFrames: input.frameIds.length,\n        currentStep: 'Awaiting approval',\n        errors: [],\n      };\n\n      this.activeHandoffs.set(requestId, progress);\n\n      // Create notifications for relevant stakeholders\n      await this.createHandoffNotifications(requestId, metadata, targetUserId);\n\n      // Set up automatic reminders\n      await this.scheduleHandoffReminders(requestId, metadata);\n\n      logger.info(`Initiated enhanced handoff: ${requestId}`, {\n        frameCount: frameIds.length,\n        priority: metadata.businessContext?.priority,\n        targetUser: targetUserId,\n      });\n\n      return requestId;\n    } catch (error: unknown) {\n      throw new DatabaseError(\n        'Failed to initiate handoff',\n        ErrorCode.OPERATION_FAILED,\n        { targetStackId, frameIds },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Submit approval/rejection for handoff request\n   */\n  async submitHandoffApproval(\n    requestId: string,\n    approval: Omit<HandoffApproval, 'requestId' | 'reviewedAt'>\n  ): Promise<void> {\n    // Validate input parameters\n    const input = validateInput(HandoffApprovalSchema, {\n      ...approval,\n      reviewerId: approval.reviewerId,\n    });\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new ValidationError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.HANDOFF_REQUEST_EXPIRED\n      );\n    }\n\n    const fullApproval: HandoffApproval = {\n      ...input,\n      requestId,\n      reviewedAt: new Date(),\n    };\n\n    // Store approval\n    const existingApprovals = this.pendingApprovals.get(requestId) || [];\n    existingApprovals.push(fullApproval);\n    this.pendingApprovals.set(requestId, existingApprovals);\n\n    // Update progress based on decision\n    if (input.decision === 'approved') {\n      progress.status = 'approved';\n      progress.currentStep = 'Ready for transfer';\n\n      // Automatically start transfer if approved\n      await this.executeHandoffTransfer(requestId);\n    } else if (input.decision === 'rejected') {\n      progress.status = 'failed';\n      progress.currentStep = 'Rejected by reviewer';\n      progress.errors.push({\n        step: 'approval',\n        error: input.feedback || 'Request rejected',\n        timestamp: new Date(),\n      });\n    } else if (input.decision === 'needs_changes') {\n      progress.status = 'pending_review';\n      progress.currentStep = 'Changes requested';\n\n      // Notify requester of needed changes\n      await this.notifyChangesRequested(requestId, approval);\n    }\n\n    this.activeHandoffs.set(requestId, progress);\n\n    logger.info(`Handoff approval submitted: ${requestId}`, {\n      decision: approval.decision,\n      reviewer: approval.reviewerId,\n    });\n  }\n\n  /**\n   * Execute the actual frame transfer after approval\n   */\n  private async executeHandoffTransfer(requestId: string): Promise<void> {\n    logger.debug('executeHandoffTransfer called', {\n      requestId,\n      availableHandoffs: Array.from(this.activeHandoffs.keys()),\n    });\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      logger.error('Handoff progress not found', {\n        requestId,\n        availableHandoffs: Array.from(this.activeHandoffs.keys()),\n      });\n      throw new DatabaseError(\n        `Handoff progress not found: ${requestId}`,\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    try {\n      logger.debug('Setting progress status to in_transfer', { requestId });\n      progress.status = 'in_transfer';\n      progress.currentStep = 'Transferring frames';\n      progress.estimatedCompletion = new Date(Date.now() + 5 * 60 * 1000); // 5 minutes\n\n      // Execute the handoff through DualStackManager\n      logger.debug('About to call acceptHandoff', { requestId });\n      const result = await this.dualStackManager.acceptHandoff(requestId);\n      logger.debug('acceptHandoff returned', {\n        requestId,\n        success: result.success,\n      });\n\n      if (result.success) {\n        progress.status = 'completed';\n        progress.currentStep = 'Transfer completed';\n        progress.transferredFrames = result.mergedFrames.length;\n\n        // Create completion notifications\n        await this.notifyHandoffCompletion(requestId, result);\n\n        logger.info(`Handoff transfer completed: ${requestId}`, {\n          transferredFrames: progress.transferredFrames,\n          conflicts: result.conflictFrames.length,\n        });\n      } else {\n        progress.status = 'failed';\n        progress.currentStep = 'Transfer failed';\n\n        // Log errors\n        result.errors.forEach((error) => {\n          progress.errors.push({\n            step: 'transfer',\n            error: `Frame ${error.frameId}: ${error.error}`,\n            timestamp: new Date(),\n          });\n        });\n\n        throw new DatabaseError(\n          'Handoff transfer failed',\n          ErrorCode.OPERATION_FAILED,\n          { errors: result.errors }\n        );\n      }\n    } catch (error: unknown) {\n      progress.status = 'failed';\n      progress.currentStep = 'Transfer error';\n      progress.errors.push({\n        step: 'transfer',\n        error: error instanceof Error ? error.message : String(error),\n        timestamp: new Date(),\n      });\n\n      logger.error(`Handoff transfer failed: ${requestId}`, error);\n      throw error;\n    } finally {\n      this.activeHandoffs.set(requestId, progress);\n    }\n  }\n\n  /**\n   * Get handoff progress and status\n   */\n  async getHandoffProgress(requestId: string): Promise<HandoffProgress | null> {\n    return this.activeHandoffs.get(requestId) || null;\n  }\n\n  /**\n   * Cancel a pending handoff request\n   */\n  async cancelHandoff(requestId: string, reason: string): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    if (progress.status === 'in_transfer') {\n      throw new DatabaseError(\n        'Cannot cancel handoff that is currently transferring',\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    progress.status = 'cancelled';\n    progress.currentStep = 'Cancelled by user';\n    progress.errors.push({\n      step: 'cancellation',\n      error: reason,\n      timestamp: new Date(),\n    });\n\n    this.activeHandoffs.set(requestId, progress);\n\n    // Notify relevant parties\n    await this.notifyHandoffCancellation(requestId, reason);\n\n    logger.info(`Handoff cancelled: ${requestId}`, { reason });\n  }\n\n  /**\n   * Get all active handoffs for a user or team\n   */\n  async getActiveHandoffs(\n    userId?: string,\n    teamId?: string\n  ): Promise<HandoffProgress[]> {\n    const handoffs = Array.from(this.activeHandoffs.values());\n\n    // Filter by user/team if specified\n    if (userId || teamId) {\n      // Would need to cross-reference with handoff metadata\n      return handoffs.filter(\n        (handoff) =>\n          handoff.status === 'pending_review' ||\n          handoff.status === 'approved' ||\n          handoff.status === 'in_transfer'\n      );\n    }\n\n    return handoffs;\n  }\n\n  /**\n   * Get notifications for a user\n   */\n  async getUserNotifications(userId: string): Promise<HandoffNotification[]> {\n    return this.notifications.get(userId) || [];\n  }\n\n  /**\n   * Mark notification as read\n   */\n  async markNotificationRead(\n    notificationId: string,\n    userId: string\n  ): Promise<void> {\n    const userNotifications = this.notifications.get(userId) || [];\n    const updatedNotifications = userNotifications.filter(\n      (n) => n.id !== notificationId\n    );\n    this.notifications.set(userId, updatedNotifications);\n  }\n\n  /**\n   * Validate frames are suitable for handoff\n   */\n  private async validateFramesForHandoff(frameIds: string[]): Promise<void> {\n    const activeStack = this.dualStackManager.getActiveStack();\n\n    for (const frameId of frameIds) {\n      const frame = await activeStack.getFrame(frameId);\n      if (!frame) {\n        throw new DatabaseError(\n          `Frame not found: ${frameId}`,\n          ErrorCode.RESOURCE_NOT_FOUND\n        );\n      }\n\n      // Check if frame is in a transferable state\n      if (frame.state === 'active') {\n        logger.warn(`Transferring active frame: ${frameId}`, {\n          frameName: frame.name,\n        });\n      }\n    }\n  }\n\n  /**\n   * Create notifications for handoff stakeholders\n   */\n  private async createHandoffNotifications(\n    requestId: string,\n    metadata: HandoffMetadata,\n    targetUserId?: string\n  ): Promise<void> {\n    const notifications: HandoffNotification[] = [];\n\n    // Notify target user\n    if (targetUserId) {\n      notifications.push({\n        id: `${requestId}-target`,\n        type: 'request',\n        requestId,\n        recipientId: targetUserId,\n        title: 'Frame Handoff Request',\n        message: `${metadata.initiatorId} wants to transfer ${metadata.frameContext.totalFrames} frames to you`,\n        actionRequired: true,\n        expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000),\n        createdAt: new Date(),\n      });\n    }\n\n    // Notify stakeholders\n    if (metadata.businessContext?.stakeholders) {\n      for (const stakeholderId of metadata.businessContext.stakeholders) {\n        notifications.push({\n          id: `${requestId}-stakeholder-${stakeholderId}`,\n          type: 'request',\n          requestId,\n          recipientId: stakeholderId,\n          title: 'Frame Handoff Notification',\n          message: `Frame transfer initiated for ${metadata.businessContext?.milestone || 'project milestone'}`,\n          actionRequired: false,\n          createdAt: new Date(),\n        });\n      }\n    }\n\n    // Store notifications\n    for (const notification of notifications) {\n      const userNotifications =\n        this.notifications.get(notification.recipientId) || [];\n      userNotifications.push(notification);\n      this.notifications.set(notification.recipientId, userNotifications);\n    }\n  }\n\n  /**\n   * Schedule reminder notifications\n   */\n  private async scheduleHandoffReminders(\n    requestId: string,\n    metadata: HandoffMetadata\n  ): Promise<void> {\n    // Schedule reminder in 4 hours if high priority\n    if (\n      metadata.businessContext?.priority === 'high' ||\n      metadata.businessContext?.priority === 'critical'\n    ) {\n      setTimeout(\n        async () => {\n          const progress = this.activeHandoffs.get(requestId);\n          if (progress && progress.status === 'pending_review') {\n            await this.sendHandoffReminder(requestId, metadata);\n          }\n        },\n        4 * 60 * 60 * 1000\n      ); // 4 hours\n    }\n  }\n\n  /**\n   * Send handoff reminder\n   */\n  private async sendHandoffReminder(\n    requestId: string,\n    metadata: HandoffMetadata\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress || progress.status !== 'pending_review') {\n      return;\n    }\n\n    const reminderNotification: HandoffNotification = {\n      id: `${requestId}-reminder-${Date.now()}`,\n      type: 'reminder',\n      requestId,\n      recipientId: metadata.targetUserId || 'unknown',\n      title: '\u23F0 Handoff Request Reminder',\n      message: `Reminder: ${metadata.initiatorId} is waiting for approval on ${metadata.frameContext.totalFrames} frames. Priority: ${metadata.businessContext?.priority || 'medium'}`,\n      actionRequired: true,\n      expiresAt: new Date(Date.now() + 12 * 60 * 60 * 1000), // 12 hours\n      createdAt: new Date(),\n    };\n\n    // Store the notification\n    if (metadata.targetUserId) {\n      const userNotifications =\n        this.notifications.get(metadata.targetUserId) || [];\n      userNotifications.push(reminderNotification);\n      this.notifications.set(metadata.targetUserId, userNotifications);\n\n      logger.info(`Sent handoff reminder: ${requestId}`, {\n        priority: metadata.businessContext?.priority,\n        recipient: metadata.targetUserId,\n      });\n    }\n\n    // Also notify stakeholders\n    if (metadata.businessContext?.stakeholders) {\n      for (const stakeholderId of metadata.businessContext.stakeholders) {\n        const stakeholderNotification: HandoffNotification = {\n          ...reminderNotification,\n          id: `${requestId}-reminder-stakeholder-${stakeholderId}-${Date.now()}`,\n          recipientId: stakeholderId,\n          title: '\uD83D\uDCCB Handoff Status Update',\n          message: `Pending handoff approval: ${metadata.businessContext?.milestone || 'development work'} requires attention`,\n          actionRequired: false,\n        };\n\n        const stakeholderNotifications =\n          this.notifications.get(stakeholderId) || [];\n        stakeholderNotifications.push(stakeholderNotification);\n        this.notifications.set(stakeholderId, stakeholderNotifications);\n      }\n    }\n  }\n\n  /**\n   * Notify when changes are requested\n   */\n  private async notifyChangesRequested(\n    requestId: string,\n    approval: Omit<HandoffApproval, 'requestId' | 'reviewedAt'>\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) return;\n\n    // Find the original requester (we'll need to enhance this with better metadata tracking)\n    const changeRequestNotification: HandoffNotification = {\n      id: `${requestId}-changes-${Date.now()}`,\n      type: 'request',\n      requestId,\n      recipientId: 'requester', // TODO: Get actual requester from handoff metadata\n      title: 'Changes Requested for Handoff',\n      message: `${approval.reviewerId} has requested changes: ${approval.feedback || 'See detailed suggestions'}`,\n      actionRequired: true,\n      expiresAt: new Date(Date.now() + 48 * 60 * 60 * 1000), // 48 hours\n      createdAt: new Date(),\n    };\n\n    // Store notification (for now using a placeholder recipient)\n    const notifications = this.notifications.get('requester') || [];\n    notifications.push(changeRequestNotification);\n    this.notifications.set('requester', notifications);\n\n    // Log detailed feedback and suggestions\n    logger.info(`Changes requested for handoff: ${requestId}`, {\n      reviewer: approval.reviewerId,\n      feedback: approval.feedback,\n      suggestedChangesCount: approval.suggestedChanges?.length || 0,\n    });\n\n    if (approval.suggestedChanges && approval.suggestedChanges.length > 0) {\n      logger.info(`Detailed change suggestions:`, {\n        requestId,\n        suggestions: approval.suggestedChanges.map((change) => ({\n          frameId: change.frameId,\n          suggestion: change.suggestion,\n          reason: change.reason,\n        })),\n      });\n    }\n  }\n\n  /**\n   * Notify handoff completion\n   */\n  private async notifyHandoffCompletion(\n    requestId: string,\n    result: any\n  ): Promise<void> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) return;\n\n    // Create completion notification\n    const completionNotification: HandoffNotification = {\n      id: `${requestId}-completion-${Date.now()}`,\n      type: 'completion',\n      requestId,\n      recipientId: 'all', // Will be distributed to all stakeholders\n      title: 'Handoff Completed Successfully',\n      message: `Frame transfer completed: ${result.mergedFrames.length} frames transferred${result.conflictFrames.length > 0 ? `, ${result.conflictFrames.length} conflicts resolved` : ''}`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Notify all stakeholders from the notifications map\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userSpecificNotification: HandoffNotification = {\n        ...completionNotification,\n        id: `${requestId}-completion-${userId}-${Date.now()}`,\n        recipientId: userId,\n      };\n\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push(userSpecificNotification);\n      this.notifications.set(userId, userNotifications);\n    }\n\n    logger.info(`Handoff completed: ${requestId}`, {\n      mergedFrames: result.mergedFrames.length,\n      conflicts: result.conflictFrames.length,\n      notifiedUsers: allUsers.length,\n    });\n\n    // Log detailed completion statistics\n    if (result.conflictFrames.length > 0) {\n      logger.info(`Handoff completion details:`, {\n        requestId,\n        transferredFrames: result.mergedFrames.map(\n          (f: any) => f.frameId || f.id\n        ),\n        conflictFrames: result.conflictFrames.map(\n          (f: any) => f.frameId || f.id\n        ),\n      });\n    }\n  }\n\n  /**\n   * Notify handoff cancellation\n   */\n  private async notifyHandoffCancellation(\n    requestId: string,\n    reason: string\n  ): Promise<void> {\n    // Create cancellation notification\n    const cancellationNotification: HandoffNotification = {\n      id: `${requestId}-cancellation-${Date.now()}`,\n      type: 'request', // Using 'request' type as it's informational\n      requestId,\n      recipientId: 'all', // Will be distributed to all stakeholders\n      title: 'Handoff Cancelled',\n      message: `Handoff request has been cancelled. Reason: ${reason}`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Notify all users who have been involved in this handoff\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userSpecificNotification: HandoffNotification = {\n        ...cancellationNotification,\n        id: `${requestId}-cancellation-${userId}-${Date.now()}`,\n        recipientId: userId,\n      };\n\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push(userSpecificNotification);\n      this.notifications.set(userId, userNotifications);\n    }\n\n    logger.info(`Handoff cancelled: ${requestId}`, {\n      reason,\n      notifiedUsers: allUsers.length,\n    });\n  }\n\n  /**\n   * Get handoff analytics and metrics\n   */\n  async getHandoffMetrics(timeRange?: { start: Date; end: Date }): Promise<{\n    totalHandoffs: number;\n    completedHandoffs: number;\n    averageProcessingTime: number;\n    topFrameTypes: Array<{ type: string; count: number }>;\n    collaborationPatterns: Array<{\n      sourceUser: string;\n      targetUser: string;\n      count: number;\n    }>;\n  }> {\n    const handoffs = Array.from(this.activeHandoffs.values());\n\n    // Filter by time range if specified\n    const filteredHandoffs = timeRange\n      ? handoffs.filter((h) => {\n          // Would need to add timestamps to track creation time\n          return true; // Placeholder\n        })\n      : handoffs;\n\n    const completedHandoffs = filteredHandoffs.filter(\n      (h) => h.status === 'completed'\n    );\n\n    return {\n      totalHandoffs: filteredHandoffs.length,\n      completedHandoffs: completedHandoffs.length,\n      averageProcessingTime:\n        this.calculateAverageProcessingTime(completedHandoffs),\n      topFrameTypes: this.analyzeFrameTypes(filteredHandoffs),\n      collaborationPatterns:\n        this.analyzeCollaborationPatterns(filteredHandoffs),\n    };\n  }\n\n  private calculateAverageProcessingTime(handoffs: HandoffProgress[]): number {\n    if (handoffs.length === 0) return 0;\n\n    let totalProcessingTime = 0;\n    let validHandoffs = 0;\n\n    for (const handoff of handoffs) {\n      // Only calculate for completed handoffs that have timing data\n      if (handoff.status === 'completed' && handoff.estimatedCompletion) {\n        // Estimate processing time based on frame count and complexity\n        // This is a simplified calculation - in practice you'd track actual timestamps\n        const frameComplexity = handoff.totalFrames * 0.5; // Base time per frame\n        const errorPenalty = handoff.errors.length * 2; // Extra time for errors\n        const processingTime = Math.max(1, frameComplexity + errorPenalty);\n\n        totalProcessingTime += processingTime;\n        validHandoffs++;\n      }\n    }\n\n    return validHandoffs > 0\n      ? Math.round(totalProcessingTime / validHandoffs)\n      : 0;\n  }\n\n  private analyzeFrameTypes(\n    handoffs: HandoffProgress[]\n  ): Array<{ type: string; count: number }> {\n    const frameTypeCount = new Map<string, number>();\n\n    for (const handoff of handoffs) {\n      // Extract frame type information from handoff metadata\n      // This would need to be enhanced with actual frame type tracking\n      const estimatedTypes = this.estimateFrameTypes(handoff);\n\n      for (const type of estimatedTypes) {\n        frameTypeCount.set(type, (frameTypeCount.get(type) || 0) + 1);\n      }\n    }\n\n    return Array.from(frameTypeCount.entries())\n      .map(([type, count]) => ({ type, count }))\n      .sort((a, b) => b.count - a.count)\n      .slice(0, 10); // Top 10 frame types\n  }\n\n  private estimateFrameTypes(handoff: HandoffProgress): string[] {\n    // Simplified frame type estimation based on handoff characteristics\n    const types: string[] = [];\n\n    if (handoff.totalFrames > 10) {\n      types.push('bulk_transfer');\n    }\n    if (handoff.errors.length > 0) {\n      types.push('complex_handoff');\n    }\n    if (handoff.transferredFrames === handoff.totalFrames) {\n      types.push('complete_transfer');\n    } else {\n      types.push('partial_transfer');\n    }\n\n    // Add some common frame types based on patterns\n    types.push('development', 'collaboration');\n\n    return types;\n  }\n\n  private analyzeCollaborationPatterns(\n    handoffs: HandoffProgress[]\n  ): Array<{ sourceUser: string; targetUser: string; count: number }> {\n    const collaborationCount = new Map<string, number>();\n\n    for (const handoff of handoffs) {\n      // Extract collaboration pattern from handoff data\n      // Note: This is simplified - we'd need to track actual source/target users\n      const pattern = this.extractCollaborationPattern(handoff);\n      if (pattern) {\n        const key = `${pattern.sourceUser}->${pattern.targetUser}`;\n        collaborationCount.set(key, (collaborationCount.get(key) || 0) + 1);\n      }\n    }\n\n    return Array.from(collaborationCount.entries())\n      .map(([pattern, count]) => {\n        const [sourceUser, targetUser] = pattern.split('->');\n        return { sourceUser, targetUser, count };\n      })\n      .sort((a, b) => b.count - a.count)\n      .slice(0, 20); // Top 20 collaboration patterns\n  }\n\n  private extractCollaborationPattern(\n    handoff: HandoffProgress\n  ): { sourceUser: string; targetUser: string } | null {\n    // Simplified pattern extraction - in practice this would come from handoff metadata\n    // For now, we'll create sample patterns based on handoff characteristics\n\n    if (handoff.status === 'completed') {\n      return {\n        sourceUser: 'developer',\n        targetUser: 'reviewer',\n      };\n    } else if (handoff.status === 'failed') {\n      return {\n        sourceUser: 'developer',\n        targetUser: 'lead',\n      };\n    }\n\n    return null;\n  }\n\n  /**\n   * Real-time collaboration features\n   */\n\n  /**\n   * Get real-time handoff status updates\n   */\n  async getHandoffStatusStream(\n    requestId: string\n  ): Promise<AsyncIterableIterator<HandoffProgress>> {\n    const progress = this.activeHandoffs.get(requestId);\n    if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    // Simple implementation - in a real system this would use WebSockets or Server-Sent Events\n    const self = this;\n    return {\n      async *[Symbol.asyncIterator]() {\n        let lastStatus = progress.status;\n        while (\n          lastStatus !== 'completed' &&\n          lastStatus !== 'failed' &&\n          lastStatus !== 'cancelled'\n        ) {\n          const currentProgress = self.activeHandoffs.get(requestId);\n          if (currentProgress && currentProgress.status !== lastStatus) {\n            lastStatus = currentProgress.status;\n            yield currentProgress;\n          }\n          // Simulate real-time polling\n          await new Promise((resolve) => setTimeout(resolve, 1000));\n        }\n      },\n    };\n  }\n\n  /**\n   * Update handoff progress in real-time\n   */\n  async updateHandoffProgress(\n    requestId: string,\n    update: Partial<HandoffProgress>\n  ): Promise<void> {\n    let progress = this.activeHandoffs.get(requestId);\n\n    // If progress doesn't exist and update includes required fields, create it\n    if (\n      !progress &&\n      update.requestId &&\n      update.status &&\n      update.totalFrames !== undefined\n    ) {\n      progress = {\n        requestId: update.requestId,\n        status: update.status,\n        transferredFrames: 0,\n        totalFrames: update.totalFrames,\n        currentStep: 'Initialized',\n        errors: [],\n        ...update,\n      };\n    } else if (!progress) {\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    } else {\n      // Update existing progress with provided fields\n      progress = {\n        ...progress,\n        ...update,\n      };\n    }\n\n    this.activeHandoffs.set(requestId, progress);\n\n    logger.info(`Handoff progress updated: ${requestId}`, {\n      status: progress.status,\n      currentStep: progress.currentStep,\n      transferredFrames: progress.transferredFrames,\n    });\n\n    // Notify stakeholders of progress update\n    await this.notifyProgressUpdate(requestId, progress);\n  }\n\n  /**\n   * Notify stakeholders of progress updates\n   */\n  private async notifyProgressUpdate(\n    requestId: string,\n    progress: HandoffProgress\n  ): Promise<void> {\n    const updateNotification: HandoffNotification = {\n      id: `${requestId}-progress-${Date.now()}`,\n      type: 'request',\n      requestId,\n      recipientId: 'all',\n      title: 'Handoff Progress Update',\n      message: `Status: ${progress.status} | Step: ${progress.currentStep} | Progress: ${progress.transferredFrames}/${progress.totalFrames} frames`,\n      actionRequired: false,\n      createdAt: new Date(),\n    };\n\n    // Distribute to all stakeholders\n    const allUsers = Array.from(this.notifications.keys());\n    for (const userId of allUsers) {\n      const userNotifications = this.notifications.get(userId) || [];\n      userNotifications.push({\n        ...updateNotification,\n        id: `${requestId}-progress-${userId}-${Date.now()}`,\n        recipientId: userId,\n      });\n      this.notifications.set(userId, userNotifications);\n    }\n  }\n\n  /**\n   * Get active handoffs with real-time filtering\n   */\n  async getActiveHandoffsRealTime(filters?: {\n    status?: HandoffProgress['status'];\n    userId?: string;\n    priority?: 'low' | 'medium' | 'high' | 'critical';\n  }): Promise<HandoffProgress[]> {\n    let handoffs = Array.from(this.activeHandoffs.values());\n\n    if (filters?.status) {\n      handoffs = handoffs.filter((h) => h.status === filters.status);\n    }\n\n    if (filters?.userId) {\n      // In a real implementation, we'd have proper user tracking in handoff metadata\n      // For now, filter based on requestId pattern or other heuristics\n      handoffs = handoffs.filter((h) =>\n        h.requestId.includes(filters.userId || '')\n      );\n    }\n\n    if (filters?.priority) {\n      // Filter by priority (this would need priority tracking in HandoffProgress)\n      // For now, estimate priority based on frame count and errors\n      handoffs = handoffs.filter((h) => {\n        const estimatedPriority = this.estimateHandoffPriority(h);\n        return estimatedPriority === filters.priority;\n      });\n    }\n\n    return handoffs.sort((a, b) => {\n      // Sort by status priority, then by creation time\n      const statusPriority = {\n        in_transfer: 4,\n        approved: 3,\n        pending_review: 2,\n        completed: 1,\n        failed: 1,\n        cancelled: 0,\n      };\n      return (statusPriority[b.status] || 0) - (statusPriority[a.status] || 0);\n    });\n  }\n\n  private estimateHandoffPriority(\n    handoff: HandoffProgress\n  ): 'low' | 'medium' | 'high' | 'critical' {\n    if (handoff.errors.length > 2 || handoff.totalFrames > 50)\n      return 'critical';\n    if (handoff.errors.length > 0 || handoff.totalFrames > 20) return 'high';\n    if (handoff.totalFrames > 5) return 'medium';\n    return 'low';\n  }\n\n  /**\n   * Bulk handoff operations for team collaboration\n   */\n  async bulkHandoffOperation(operation: {\n    action: 'approve' | 'reject' | 'cancel';\n    requestIds: string[];\n    reviewerId: string;\n    feedback?: string;\n  }): Promise<{\n    successful: string[];\n    failed: Array<{ requestId: string; error: string }>;\n  }> {\n    const results = {\n      successful: [],\n      failed: [] as Array<{ requestId: string; error: string }>,\n    };\n\n    for (const requestId of operation.requestIds) {\n      try {\n        switch (operation.action) {\n          case 'approve':\n            await this.submitHandoffApproval(requestId, {\n              reviewerId: operation.reviewerId,\n              decision: 'approved',\n              feedback: operation.feedback,\n            });\n            results.successful.push(requestId);\n            break;\n\n          case 'reject':\n            await this.submitHandoffApproval(requestId, {\n              reviewerId: operation.reviewerId,\n              decision: 'rejected',\n              feedback: operation.feedback || 'Bulk rejection',\n            });\n            results.successful.push(requestId);\n            break;\n\n          case 'cancel':\n            await this.cancelHandoff(\n              requestId,\n              operation.feedback || 'Bulk cancellation'\n            );\n            results.successful.push(requestId);\n            break;\n        }\n      } catch (error: unknown) {\n        results.failed.push({\n          requestId,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    logger.info(`Bulk handoff operation completed`, {\n      action: operation.action,\n      successful: results.successful.length,\n      failed: results.failed.length,\n      reviewerId: operation.reviewerId,\n    });\n\n    return results;\n  }\n\n  /**\n   * Enhanced notification management with cleanup\n   */\n  async cleanupExpiredNotifications(userId?: string): Promise<number> {\n    let cleanedCount = 0;\n    const now = new Date();\n\n    const userIds = userId ? [userId] : Array.from(this.notifications.keys());\n\n    for (const uid of userIds) {\n      const userNotifications = this.notifications.get(uid) || [];\n      const activeNotifications = userNotifications.filter((notification) => {\n        if (notification.expiresAt && notification.expiresAt < now) {\n          cleanedCount++;\n          return false;\n        }\n        return true;\n      });\n\n      this.notifications.set(uid, activeNotifications);\n    }\n\n    if (cleanedCount > 0) {\n      logger.info(`Cleaned up expired notifications`, {\n        count: cleanedCount,\n        userId: userId || 'all',\n      });\n    }\n\n    return cleanedCount;\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/core/context/frame-lifecycle-hooks.js ADDED Viewed

@@ -0,0 +1,119 @@
+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 FrameLifecycleHooksRegistry {
+  closeHooks = [];
+  createHooks = [];
+  /**
+   * Register a hook to be called when a frame is closed
+   * @param name - Unique name for the hook (for logging/debugging)
+   * @param handler - Async function to call when frame closes
+   * @param priority - Higher priority hooks run first (default: 0)
+   */
+  onFrameClosed(name, handler, priority = 0) {
+    const hook = { name, handler, priority };
+    this.closeHooks.push(hook);
+    this.closeHooks.sort((a, b) => b.priority - a.priority);
+    logger.debug("Registered frame close hook", { name, priority });
+    return () => {
+      this.closeHooks = this.closeHooks.filter((h) => h !== hook);
+      logger.debug("Unregistered frame close hook", { name });
+    };
+  }
+  /**
+   * Register a hook to be called when a frame is created
+   * @param name - Unique name for the hook (for logging/debugging)
+   * @param handler - Async function to call when frame is created
+   * @param priority - Higher priority hooks run first (default: 0)
+   */
+  onFrameCreated(name, handler, priority = 0) {
+    const hook = { name, handler, priority };
+    this.createHooks.push(hook);
+    this.createHooks.sort((a, b) => b.priority - a.priority);
+    logger.debug("Registered frame create hook", { name, priority });
+    return () => {
+      this.createHooks = this.createHooks.filter((h) => h !== hook);
+      logger.debug("Unregistered frame create hook", { name });
+    };
+  }
+  /**
+   * Trigger all close hooks (called by FrameManager)
+   * Hooks are fire-and-forget - errors don't affect frame closure
+   */
+  async triggerClose(data) {
+    if (this.closeHooks.length === 0) return;
+    const results = await Promise.allSettled(
+      this.closeHooks.map(async (hook) => {
+        try {
+          await hook.handler(data);
+        } catch (error) {
+          logger.warn(`Frame close hook "${hook.name}" failed`, {
+            error: error instanceof Error ? error.message : String(error),
+            frameId: data.frame.frame_id,
+            frameName: data.frame.name
+          });
+        }
+      })
+    );
+    const failed = results.filter((r) => r.status === "rejected").length;
+    if (failed > 0) {
+      logger.debug("Some frame close hooks failed", {
+        total: this.closeHooks.length,
+        failed,
+        frameId: data.frame.frame_id
+      });
+    }
+  }
+  /**
+   * Trigger all create hooks (called by FrameManager)
+   * Hooks are fire-and-forget - errors don't affect frame creation
+   */
+  async triggerCreate(frame) {
+    if (this.createHooks.length === 0) return;
+    const results = await Promise.allSettled(
+      this.createHooks.map(async (hook) => {
+        try {
+          await hook.handler(frame);
+        } catch (error) {
+          logger.warn(`Frame create hook "${hook.name}" failed`, {
+            error: error instanceof Error ? error.message : String(error),
+            frameId: frame.frame_id,
+            frameName: frame.name
+          });
+        }
+      })
+    );
+    const failed = results.filter((r) => r.status === "rejected").length;
+    if (failed > 0) {
+      logger.debug("Some frame create hooks failed", {
+        total: this.createHooks.length,
+        failed,
+        frameId: frame.frame_id
+      });
+    }
+  }
+  /**
+   * Get count of registered hooks (useful for testing)
+   */
+  getHookCounts() {
+    return {
+      close: this.closeHooks.length,
+      create: this.createHooks.length
+    };
+  }
+  /**
+   * Clear all hooks (useful for testing)
+   */
+  clearAll() {
+    this.closeHooks = [];
+    this.createHooks = [];
+    logger.debug("Cleared all frame lifecycle hooks");
+  }
+}
+const frameLifecycleHooks = new FrameLifecycleHooksRegistry();
+export {
+  frameLifecycleHooks
+};
+//# sourceMappingURL=frame-lifecycle-hooks.js.map

package/dist/core/context/frame-lifecycle-hooks.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/context/frame-lifecycle-hooks.ts"],
+  "sourcesContent": ["/**\n * Frame Lifecycle Hooks\n * Allows external modules to subscribe to frame events without coupling to FrameManager\n */\n\nimport { logger } from '../monitoring/logger.js';\nimport type { Frame, Event, Anchor } from './frame-types.js';\n\n/**\n * Data passed to frame close hooks\n */\nexport interface FrameCloseData {\n  frame: Frame;\n  events: Event[];\n  anchors: Anchor[];\n}\n\n/**\n * Hook function type for frame close events\n */\nexport type FrameCloseHook = (data: FrameCloseData) => Promise<void>;\n\n/**\n * Hook function type for frame create events\n */\nexport type FrameCreateHook = (frame: Frame) => Promise<void>;\n\n/**\n * Registered hook with metadata\n */\ninterface RegisteredHook<T> {\n  name: string;\n  handler: T;\n  priority: number;\n}\n\n/**\n * Frame Lifecycle Hooks Registry\n * Singleton that manages all frame lifecycle hooks\n */\nclass FrameLifecycleHooksRegistry {\n  private closeHooks: RegisteredHook<FrameCloseHook>[] = [];\n  private createHooks: RegisteredHook<FrameCreateHook>[] = [];\n\n  /**\n   * Register a hook to be called when a frame is closed\n   * @param name - Unique name for the hook (for logging/debugging)\n   * @param handler - Async function to call when frame closes\n   * @param priority - Higher priority hooks run first (default: 0)\n   */\n  onFrameClosed(\n    name: string,\n    handler: FrameCloseHook,\n    priority: number = 0\n  ): () => void {\n    const hook: RegisteredHook<FrameCloseHook> = { name, handler, priority };\n    this.closeHooks.push(hook);\n    this.closeHooks.sort((a, b) => b.priority - a.priority);\n\n    logger.debug('Registered frame close hook', { name, priority });\n\n    // Return unregister function\n    return () => {\n      this.closeHooks = this.closeHooks.filter((h) => h !== hook);\n      logger.debug('Unregistered frame close hook', { name });\n    };\n  }\n\n  /**\n   * Register a hook to be called when a frame is created\n   * @param name - Unique name for the hook (for logging/debugging)\n   * @param handler - Async function to call when frame is created\n   * @param priority - Higher priority hooks run first (default: 0)\n   */\n  onFrameCreated(\n    name: string,\n    handler: FrameCreateHook,\n    priority: number = 0\n  ): () => void {\n    const hook: RegisteredHook<FrameCreateHook> = { name, handler, priority };\n    this.createHooks.push(hook);\n    this.createHooks.sort((a, b) => b.priority - a.priority);\n\n    logger.debug('Registered frame create hook', { name, priority });\n\n    // Return unregister function\n    return () => {\n      this.createHooks = this.createHooks.filter((h) => h !== hook);\n      logger.debug('Unregistered frame create hook', { name });\n    };\n  }\n\n  /**\n   * Trigger all close hooks (called by FrameManager)\n   * Hooks are fire-and-forget - errors don't affect frame closure\n   */\n  async triggerClose(data: FrameCloseData): Promise<void> {\n    if (this.closeHooks.length === 0) return;\n\n    const results = await Promise.allSettled(\n      this.closeHooks.map(async (hook) => {\n        try {\n          await hook.handler(data);\n        } catch (error) {\n          logger.warn(`Frame close hook \"${hook.name}\" failed`, {\n            error: error instanceof Error ? error.message : String(error),\n            frameId: data.frame.frame_id,\n            frameName: data.frame.name,\n          });\n        }\n      })\n    );\n\n    const failed = results.filter((r) => r.status === 'rejected').length;\n    if (failed > 0) {\n      logger.debug('Some frame close hooks failed', {\n        total: this.closeHooks.length,\n        failed,\n        frameId: data.frame.frame_id,\n      });\n    }\n  }\n\n  /**\n   * Trigger all create hooks (called by FrameManager)\n   * Hooks are fire-and-forget - errors don't affect frame creation\n   */\n  async triggerCreate(frame: Frame): Promise<void> {\n    if (this.createHooks.length === 0) return;\n\n    const results = await Promise.allSettled(\n      this.createHooks.map(async (hook) => {\n        try {\n          await hook.handler(frame);\n        } catch (error) {\n          logger.warn(`Frame create hook \"${hook.name}\" failed`, {\n            error: error instanceof Error ? error.message : String(error),\n            frameId: frame.frame_id,\n            frameName: frame.name,\n          });\n        }\n      })\n    );\n\n    const failed = results.filter((r) => r.status === 'rejected').length;\n    if (failed > 0) {\n      logger.debug('Some frame create hooks failed', {\n        total: this.createHooks.length,\n        failed,\n        frameId: frame.frame_id,\n      });\n    }\n  }\n\n  /**\n   * Get count of registered hooks (useful for testing)\n   */\n  getHookCounts(): { close: number; create: number } {\n    return {\n      close: this.closeHooks.length,\n      create: this.createHooks.length,\n    };\n  }\n\n  /**\n   * Clear all hooks (useful for testing)\n   */\n  clearAll(): void {\n    this.closeHooks = [];\n    this.createHooks = [];\n    logger.debug('Cleared all frame lifecycle hooks');\n  }\n}\n\n/**\n * Singleton instance of the hooks registry\n */\nexport const frameLifecycleHooks = new FrameLifecycleHooksRegistry();\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/context/frame-stack.js CHANGED Viewed

@@ -4,6 +4,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
 import { logger } from "../monitoring/logger.js";
 import { FrameError, ErrorCode } from "../errors/index.js";
+import { FrameQueryMode } from "../session/index.js";
 class FrameStack {
   constructor(frameDb, projectId, runId) {
     this.frameDb = frameDb;
@@ -11,6 +12,7 @@ class FrameStack {
     this.runId = runId;
   }
   activeStack = [];
+  queryMode = FrameQueryMode.PROJECT_ACTIVE;
   /**
    * Initialize stack by loading active frames
    */
@@ -148,6 +150,33 @@ class FrameStack {
     this.activeStack = [];
     logger.info("Cleared frame stack", { previousDepth });
   }
+  /**
+   * Set query mode and reinitialize stack
+   */
+  setQueryMode(mode) {
+    this.queryMode = mode;
+    this.initialize().catch((error) => {
+      logger.warn("Failed to reinitialize stack with new query mode", {
+        mode,
+        error
+      });
+    });
+  }
+  /**
+   * Remove a specific frame from the stack without popping frames above it
+   */
+  removeFrame(frameId) {
+    const index = this.activeStack.indexOf(frameId);
+    if (index === -1) {
+      return false;
+    }
+    this.activeStack.splice(index, 1);
+    logger.debug("Removed frame from stack", {
+      frameId,
+      stackDepth: this.activeStack.length
+    });
+    return true;
+  }
   /**
    * Validate stack consistency
    */

package/dist/core/context/frame-stack.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/context/frame-stack.ts"],
-  "sourcesContent": ["/**\n * Frame Stack Management\n * Handles the call stack of active frames\n */\n\nimport { Frame, FrameContext, FrameType } from './frame-types.js';\nimport { FrameDatabase } from './frame-database.js';\nimport { logger } from '../monitoring/logger.js';\nimport { FrameError, ErrorCode } from '../errors/index.js';\n\nexport class FrameStack {\n  private activeStack: string[] = [];\n\n  constructor(\n    private frameDb: FrameDatabase,\n    private projectId: string,\n    private runId: string\n  ) {}\n\n  /**\n   * Initialize stack by loading active frames\n   */\n  async initialize(): Promise<void> {\n    try {\n      const activeFrames = this.frameDb.getFramesByProject(\n        this.projectId,\n        'active'\n      );\n\n      // Rebuild stack from database\n      this.activeStack = this.buildStackFromFrames(activeFrames);\n\n      logger.info('Frame stack initialized', {\n        stackDepth: this.activeStack.length,\n        projectId: this.projectId,\n      });\n    } catch (error: unknown) {\n      logger.error('Failed to initialize frame stack', {\n        error: error instanceof Error ? error.message : String(error),\n        projectId: this.projectId,\n        runId: this.runId,\n      });\n      throw new FrameError(\n        'Failed to initialize frame stack',\n        ErrorCode.FRAME_INIT_FAILED,\n        {\n          projectId: this.projectId,\n          runId: this.runId,\n          originalError: error instanceof Error ? error.message : String(error),\n        }\n      );\n    }\n  }\n\n  /**\n   * Push new frame onto stack\n   */\n  pushFrame(frameId: string): void {\n    if (this.activeStack.includes(frameId)) {\n      logger.warn('Frame already on stack', { frameId });\n      return;\n    }\n\n    this.activeStack.push(frameId);\n\n    logger.debug('Pushed frame to stack', {\n      frameId,\n      stackDepth: this.activeStack.length,\n    });\n  }\n\n  /**\n   * Pop frame from stack\n   */\n  popFrame(frameId?: string): string | undefined {\n    if (this.activeStack.length === 0) {\n      return undefined;\n    }\n\n    let poppedFrameId: string | undefined;\n\n    if (frameId) {\n      // Pop specific frame (and all frames above it)\n      const index = this.activeStack.indexOf(frameId);\n      if (index === -1) {\n        logger.warn('Frame not found on stack', { frameId });\n        return undefined;\n      }\n\n      // Remove the target frame and all frames above it\n      const removed = this.activeStack.splice(index);\n      poppedFrameId = removed[0];\n\n      if (removed.length > 1) {\n        logger.info('Popped multiple frames due to stack unwinding', {\n          targetFrame: frameId,\n          removedFrames: removed,\n        });\n      }\n    } else {\n      // Pop top frame\n      poppedFrameId = this.activeStack.pop();\n    }\n\n    if (poppedFrameId) {\n      logger.debug('Popped frame from stack', {\n        frameId: poppedFrameId,\n        stackDepth: this.activeStack.length,\n      });\n    }\n\n    return poppedFrameId;\n  }\n\n  /**\n   * Get current (top) frame ID\n   */\n  getCurrentFrameId(): string | undefined {\n    return this.activeStack[this.activeStack.length - 1];\n  }\n\n  /**\n   * Get stack depth\n   */\n  getDepth(): number {\n    return this.activeStack.length;\n  }\n\n  /**\n   * Get complete stack\n   */\n  getStack(): string[] {\n    return [...this.activeStack];\n  }\n\n  /**\n   * Get stack as frame objects\n   */\n  getStackFrames(): Frame[] {\n    return this.activeStack\n      .map((frameId: any) => this.frameDb.getFrame(frameId))\n      .filter(Boolean) as Frame[];\n  }\n\n  /**\n   * Get frame context for the hot stack\n   */\n  getHotStackContext(maxEvents: number = 20): FrameContext[] {\n    return this.activeStack\n      .map((frameId: any) => this.buildFrameContext(frameId, maxEvents))\n      .filter(Boolean) as FrameContext[];\n  }\n\n  /**\n   * Check if frame is on stack\n   */\n  isFrameActive(frameId: string): boolean {\n    return this.activeStack.includes(frameId);\n  }\n\n  /**\n   * Get parent frame ID for current frame\n   */\n  getParentFrameId(): string | undefined {\n    if (this.activeStack.length < 2) {\n      return undefined;\n    }\n    return this.activeStack[this.activeStack.length - 2];\n  }\n\n  /**\n   * Get frame depth on stack (0-based)\n   */\n  getFrameStackDepth(frameId: string): number {\n    return this.activeStack.indexOf(frameId);\n  }\n\n  /**\n   * Clear entire stack\n   */\n  clear(): void {\n    const previousDepth = this.activeStack.length;\n    this.activeStack = [];\n\n    logger.info('Cleared frame stack', { previousDepth });\n  }\n\n  /**\n   * Validate stack consistency\n   */\n  validateStack(): { isValid: boolean; errors: string[] } {\n    const errors: string[] = [];\n\n    // Check if all frames in stack exist and are active\n    for (const frameId of this.activeStack) {\n      const frame = this.frameDb.getFrame(frameId);\n\n      if (!frame) {\n        errors.push(`Frame not found in database: ${frameId}`);\n        continue;\n      }\n\n      if (frame.state !== 'active') {\n        errors.push(\n          `Frame on stack is not active: ${frameId} (state: ${frame.state})`\n        );\n      }\n\n      if (frame.project_id !== this.projectId) {\n        errors.push(`Frame belongs to different project: ${frameId}`);\n      }\n    }\n\n    // Check for parent-child consistency\n    for (let i = 1; i < this.activeStack.length; i++) {\n      const currentFrameId = this.activeStack[i];\n      const expectedParentId = this.activeStack[i - 1];\n      const currentFrame = this.frameDb.getFrame(currentFrameId);\n\n      if (currentFrame?.parent_frame_id !== expectedParentId) {\n        errors.push(\n          `Frame parent mismatch: ${currentFrameId} parent should be ${expectedParentId} but is ${currentFrame?.parent_frame_id}`\n        );\n      }\n    }\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n    };\n  }\n\n  /**\n   * Build frame context for a specific frame\n   */\n  private buildFrameContext(\n    frameId: string,\n    maxEvents: number\n  ): FrameContext | null {\n    try {\n      const frame = this.frameDb.getFrame(frameId);\n      if (!frame) {\n        logger.warn('Frame not found for context building', { frameId });\n        return null;\n      }\n\n      const anchors = this.frameDb.getFrameAnchors(frameId);\n      const recentEvents = this.frameDb.getFrameEvents(frameId, maxEvents);\n      const activeArtifacts = this.extractActiveArtifacts(recentEvents);\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,\n        recentEvents,\n        activeArtifacts,\n      };\n    } catch (error: unknown) {\n      logger.warn('Failed to build frame context', { frameId, error });\n      return null;\n    }\n  }\n\n  /**\n   * Extract constraints from frame inputs\n   */\n  private extractConstraints(inputs: Record<string, any>): string[] {\n    const constraints: string[] = [];\n\n    if (inputs.constraints && Array.isArray(inputs.constraints)) {\n      constraints.push(...inputs.constraints);\n    }\n\n    return constraints;\n  }\n\n  /**\n   * Extract active artifacts from events\n   */\n  private extractActiveArtifacts(events: any[]): string[] {\n    const artifacts: string[] = [];\n\n    for (const event of events) {\n      if (event.event_type === 'artifact' && event.payload?.path) {\n        artifacts.push(event.payload.path);\n      }\n    }\n\n    // Return unique artifacts\n    return [...new Set(artifacts)];\n  }\n\n  /**\n   * Build stack order from database frames\n   */\n  private buildStackFromFrames(frames: Frame[]): string[] {\n    if (frames.length === 0) {\n      return [];\n    }\n\n    // Create parent-child map\n    const parentMap = new Map<string, string>();\n    const frameMap = new Map<string, Frame>();\n\n    for (const frame of frames) {\n      frameMap.set(frame.frame_id, frame);\n      if (frame.parent_frame_id) {\n        parentMap.set(frame.frame_id, frame.parent_frame_id);\n      }\n    }\n\n    // Find root frames (no parent or parent not in active set)\n    const rootFrames = frames.filter(\n      (f: any) => !f.parent_frame_id || !frameMap.has(f.parent_frame_id)\n    );\n\n    if (rootFrames.length === 0) {\n      logger.warn('No root frames found in active set');\n      return [];\n    }\n\n    if (rootFrames.length > 1) {\n      logger.warn('Multiple root frames found, using most recent', {\n        rootFrames: rootFrames.map((f: any) => f.frame_id),\n      });\n    }\n\n    // Build stack from root to leaves\n    const stack: string[] = [];\n    let currentFrame = rootFrames.sort(\n      (a, b) => a.created_at - b.created_at\n    )[0];\n\n    while (currentFrame) {\n      stack.push(currentFrame.frame_id);\n\n      // Find child frame\n      const childFrame = frames.find(\n        (f: any) => f.parent_frame_id === currentFrame.frame_id\n      );\n      if (childFrame) {\n        currentFrame = childFrame;\n      } else {\n        break;\n      }\n    }\n\n    return stack;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Frame Stack Management\n * Handles the call stack of active frames\n */\n\nimport { Frame, FrameContext, FrameType } from './frame-types.js';\nimport { FrameDatabase } from './frame-database.js';\nimport { logger } from '../monitoring/logger.js';\nimport { FrameError, ErrorCode } from '../errors/index.js';\nimport { FrameQueryMode } from '../session/index.js';\n\nexport class FrameStack {\n  private activeStack: string[] = [];\n  private queryMode: FrameQueryMode = FrameQueryMode.PROJECT_ACTIVE;\n\n  constructor(\n    private frameDb: FrameDatabase,\n    private projectId: string,\n    private runId: string\n  ) {}\n\n  /**\n   * Initialize stack by loading active frames\n   */\n  async initialize(): Promise<void> {\n    try {\n      const activeFrames = this.frameDb.getFramesByProject(\n        this.projectId,\n        'active'\n      );\n\n      // Rebuild stack from database\n      this.activeStack = this.buildStackFromFrames(activeFrames);\n\n      logger.info('Frame stack initialized', {\n        stackDepth: this.activeStack.length,\n        projectId: this.projectId,\n      });\n    } catch (error: unknown) {\n      logger.error('Failed to initialize frame stack', {\n        error: error instanceof Error ? error.message : String(error),\n        projectId: this.projectId,\n        runId: this.runId,\n      });\n      throw new FrameError(\n        'Failed to initialize frame stack',\n        ErrorCode.FRAME_INIT_FAILED,\n        {\n          projectId: this.projectId,\n          runId: this.runId,\n          originalError: error instanceof Error ? error.message : String(error),\n        }\n      );\n    }\n  }\n\n  /**\n   * Push new frame onto stack\n   */\n  pushFrame(frameId: string): void {\n    if (this.activeStack.includes(frameId)) {\n      logger.warn('Frame already on stack', { frameId });\n      return;\n    }\n\n    this.activeStack.push(frameId);\n\n    logger.debug('Pushed frame to stack', {\n      frameId,\n      stackDepth: this.activeStack.length,\n    });\n  }\n\n  /**\n   * Pop frame from stack\n   */\n  popFrame(frameId?: string): string | undefined {\n    if (this.activeStack.length === 0) {\n      return undefined;\n    }\n\n    let poppedFrameId: string | undefined;\n\n    if (frameId) {\n      // Pop specific frame (and all frames above it)\n      const index = this.activeStack.indexOf(frameId);\n      if (index === -1) {\n        logger.warn('Frame not found on stack', { frameId });\n        return undefined;\n      }\n\n      // Remove the target frame and all frames above it\n      const removed = this.activeStack.splice(index);\n      poppedFrameId = removed[0];\n\n      if (removed.length > 1) {\n        logger.info('Popped multiple frames due to stack unwinding', {\n          targetFrame: frameId,\n          removedFrames: removed,\n        });\n      }\n    } else {\n      // Pop top frame\n      poppedFrameId = this.activeStack.pop();\n    }\n\n    if (poppedFrameId) {\n      logger.debug('Popped frame from stack', {\n        frameId: poppedFrameId,\n        stackDepth: this.activeStack.length,\n      });\n    }\n\n    return poppedFrameId;\n  }\n\n  /**\n   * Get current (top) frame ID\n   */\n  getCurrentFrameId(): string | undefined {\n    return this.activeStack[this.activeStack.length - 1];\n  }\n\n  /**\n   * Get stack depth\n   */\n  getDepth(): number {\n    return this.activeStack.length;\n  }\n\n  /**\n   * Get complete stack\n   */\n  getStack(): string[] {\n    return [...this.activeStack];\n  }\n\n  /**\n   * Get stack as frame objects\n   */\n  getStackFrames(): Frame[] {\n    return this.activeStack\n      .map((frameId: any) => this.frameDb.getFrame(frameId))\n      .filter(Boolean) as Frame[];\n  }\n\n  /**\n   * Get frame context for the hot stack\n   */\n  getHotStackContext(maxEvents: number = 20): FrameContext[] {\n    return this.activeStack\n      .map((frameId: any) => this.buildFrameContext(frameId, maxEvents))\n      .filter(Boolean) as FrameContext[];\n  }\n\n  /**\n   * Check if frame is on stack\n   */\n  isFrameActive(frameId: string): boolean {\n    return this.activeStack.includes(frameId);\n  }\n\n  /**\n   * Get parent frame ID for current frame\n   */\n  getParentFrameId(): string | undefined {\n    if (this.activeStack.length < 2) {\n      return undefined;\n    }\n    return this.activeStack[this.activeStack.length - 2];\n  }\n\n  /**\n   * Get frame depth on stack (0-based)\n   */\n  getFrameStackDepth(frameId: string): number {\n    return this.activeStack.indexOf(frameId);\n  }\n\n  /**\n   * Clear entire stack\n   */\n  clear(): void {\n    const previousDepth = this.activeStack.length;\n    this.activeStack = [];\n\n    logger.info('Cleared frame stack', { previousDepth });\n  }\n\n  /**\n   * Set query mode and reinitialize stack\n   */\n  setQueryMode(mode: FrameQueryMode): void {\n    this.queryMode = mode;\n    // Reinitialize with new query mode\n    this.initialize().catch((error) => {\n      logger.warn('Failed to reinitialize stack with new query mode', {\n        mode,\n        error,\n      });\n    });\n  }\n\n  /**\n   * Remove a specific frame from the stack without popping frames above it\n   */\n  removeFrame(frameId: string): boolean {\n    const index = this.activeStack.indexOf(frameId);\n    if (index === -1) {\n      return false;\n    }\n\n    this.activeStack.splice(index, 1);\n\n    logger.debug('Removed frame from stack', {\n      frameId,\n      stackDepth: this.activeStack.length,\n    });\n\n    return true;\n  }\n\n  /**\n   * Validate stack consistency\n   */\n  validateStack(): { isValid: boolean; errors: string[] } {\n    const errors: string[] = [];\n\n    // Check if all frames in stack exist and are active\n    for (const frameId of this.activeStack) {\n      const frame = this.frameDb.getFrame(frameId);\n\n      if (!frame) {\n        errors.push(`Frame not found in database: ${frameId}`);\n        continue;\n      }\n\n      if (frame.state !== 'active') {\n        errors.push(\n          `Frame on stack is not active: ${frameId} (state: ${frame.state})`\n        );\n      }\n\n      if (frame.project_id !== this.projectId) {\n        errors.push(`Frame belongs to different project: ${frameId}`);\n      }\n    }\n\n    // Check for parent-child consistency\n    for (let i = 1; i < this.activeStack.length; i++) {\n      const currentFrameId = this.activeStack[i];\n      const expectedParentId = this.activeStack[i - 1];\n      const currentFrame = this.frameDb.getFrame(currentFrameId);\n\n      if (currentFrame?.parent_frame_id !== expectedParentId) {\n        errors.push(\n          `Frame parent mismatch: ${currentFrameId} parent should be ${expectedParentId} but is ${currentFrame?.parent_frame_id}`\n        );\n      }\n    }\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n    };\n  }\n\n  /**\n   * Build frame context for a specific frame\n   */\n  private buildFrameContext(\n    frameId: string,\n    maxEvents: number\n  ): FrameContext | null {\n    try {\n      const frame = this.frameDb.getFrame(frameId);\n      if (!frame) {\n        logger.warn('Frame not found for context building', { frameId });\n        return null;\n      }\n\n      const anchors = this.frameDb.getFrameAnchors(frameId);\n      const recentEvents = this.frameDb.getFrameEvents(frameId, maxEvents);\n      const activeArtifacts = this.extractActiveArtifacts(recentEvents);\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,\n        recentEvents,\n        activeArtifacts,\n      };\n    } catch (error: unknown) {\n      logger.warn('Failed to build frame context', { frameId, error });\n      return null;\n    }\n  }\n\n  /**\n   * Extract constraints from frame inputs\n   */\n  private extractConstraints(inputs: Record<string, any>): string[] {\n    const constraints: string[] = [];\n\n    if (inputs.constraints && Array.isArray(inputs.constraints)) {\n      constraints.push(...inputs.constraints);\n    }\n\n    return constraints;\n  }\n\n  /**\n   * Extract active artifacts from events\n   */\n  private extractActiveArtifacts(events: any[]): string[] {\n    const artifacts: string[] = [];\n\n    for (const event of events) {\n      if (event.event_type === 'artifact' && event.payload?.path) {\n        artifacts.push(event.payload.path);\n      }\n    }\n\n    // Return unique artifacts\n    return [...new Set(artifacts)];\n  }\n\n  /**\n   * Build stack order from database frames\n   */\n  private buildStackFromFrames(frames: Frame[]): string[] {\n    if (frames.length === 0) {\n      return [];\n    }\n\n    // Create parent-child map\n    const parentMap = new Map<string, string>();\n    const frameMap = new Map<string, Frame>();\n\n    for (const frame of frames) {\n      frameMap.set(frame.frame_id, frame);\n      if (frame.parent_frame_id) {\n        parentMap.set(frame.frame_id, frame.parent_frame_id);\n      }\n    }\n\n    // Find root frames (no parent or parent not in active set)\n    const rootFrames = frames.filter(\n      (f: any) => !f.parent_frame_id || !frameMap.has(f.parent_frame_id)\n    );\n\n    if (rootFrames.length === 0) {\n      logger.warn('No root frames found in active set');\n      return [];\n    }\n\n    if (rootFrames.length > 1) {\n      logger.warn('Multiple root frames found, using most recent', {\n        rootFrames: rootFrames.map((f: any) => f.frame_id),\n      });\n    }\n\n    // Build stack from root to leaves\n    const stack: string[] = [];\n    let currentFrame = rootFrames.sort(\n      (a, b) => a.created_at - b.created_at\n    )[0];\n\n    while (currentFrame) {\n      stack.push(currentFrame.frame_id);\n\n      // Find child frame\n      const childFrame = frames.find(\n        (f: any) => f.parent_frame_id === currentFrame.frame_id\n      );\n      if (childFrame) {\n        currentFrame = childFrame;\n      } else {\n        break;\n      }\n    }\n\n    return stack;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/core/context/incremental-gc.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/context/incremental-gc.ts"],
-  "sourcesContent": ["/**\n * Incremental Garbage Collection System (STA-288)\n *\n * Implements incremental GC strategy to avoid stop-the-world pauses\n * with generational aging and priority-based collection.\n */\n\nimport { Frame, FrameManager } from './frame-manager.js';\nimport { Logger } from '../monitoring/logger.js';\n\ninterface GCConfig {\n  framesPerCycle: number; // Process in chunks (default: 100)\n  cycleInterval: number; // Every minute (default: 60s)\n  maxAge: number; // Max age before eligible for collection (30 days)\n  generations: {\n    young: number; // < 1 day\n    mature: number; // 1-7 days\n    old: number; // 7-30 days\n  };\n}\n\ninterface GCStats {\n  totalFrames: number;\n  collectedFrames: number;\n  lastRunTime: number;\n  cycleCount: number;\n  avgCycleTime: number;\n  protectedFrames: number;\n}\n\nexport class IncrementalGarbageCollector {\n  private logger: Logger;\n  private config: GCConfig;\n  private stats: GCStats;\n  private isRunning: boolean = false;\n  private cycleTimer: NodeJS.Timer | null = null;\n  private frameManager: FrameManager;\n\n  constructor(frameManager: FrameManager, config: Partial<GCConfig> = {}) {\n    this.frameManager = frameManager;\n    this.logger = new Logger('IncrementalGC');\n\n    this.config = {\n      framesPerCycle: config.framesPerCycle || 100,\n      cycleInterval: config.cycleInterval || 60000, // 60 seconds\n      maxAge: config.maxAge || 30 * 24 * 60 * 60 * 1000, // 30 days\n      generations: {\n        young: config.generations?.young || 24 * 60 * 60 * 1000, // 1 day\n        mature: config.generations?.mature || 7 * 24 * 60 * 60 * 1000, // 7 days\n        old: config.generations?.old || 30 * 24 * 60 * 60 * 1000, // 30 days\n      },\n    };\n\n    this.stats = {\n      totalFrames: 0,\n      collectedFrames: 0,\n      lastRunTime: 0,\n      cycleCount: 0,\n      avgCycleTime: 0,\n      protectedFrames: 0,\n    };\n\n    this.logger.info('Incremental GC initialized', this.config);\n  }\n\n  /**\n   * Start the garbage collection cycle\n   */\n  start(): void {\n    if (this.isRunning) {\n      this.logger.warn('GC already running');\n      return;\n    }\n\n    this.isRunning = true;\n    this.logger.info(\n      `Starting incremental GC with ${this.config.cycleInterval}ms intervals`\n    );\n\n    this.cycleTimer = setInterval(() => {\n      this.runCycle().catch((error) => {\n        this.logger.error('GC cycle failed', error);\n      });\n    }, this.config.cycleInterval);\n  }\n\n  /**\n   * Stop the garbage collection cycle\n   */\n  stop(): void {\n    if (this.cycleTimer) {\n      clearInterval(this.cycleTimer);\n      this.cycleTimer = null;\n    }\n    this.isRunning = false;\n    this.logger.info('Incremental GC stopped');\n  }\n\n  /**\n   * Run a single GC cycle\n   */\n  async runCycle(): Promise<void> {\n    const startTime = Date.now();\n    this.logger.debug('Starting GC cycle', {\n      cycle: this.stats.cycleCount + 1,\n    });\n\n    try {\n      // Get all frames for analysis\n      const allFrames = await this.frameManager.getAllFrames();\n      this.stats.totalFrames = allFrames.length;\n\n      if (allFrames.length === 0) {\n        this.logger.debug('No frames to collect');\n        return;\n      }\n\n      // Categorize frames by generation and protection status\n      const categorized = this.categorizeFrames(allFrames);\n\n      // Select candidates for collection (prioritized)\n      const candidates = this.selectCollectionCandidates(categorized);\n\n      // Process in chunks to avoid blocking\n      const collected = await this.collectFramesIncremental(candidates);\n\n      // Update statistics\n      this.updateStats(startTime, collected.length);\n\n      this.logger.info('GC cycle completed', {\n        cycle: this.stats.cycleCount,\n        collected: collected.length,\n        protected: this.stats.protectedFrames,\n        duration: Date.now() - startTime,\n      });\n    } catch (error: unknown) {\n      this.logger.error('GC cycle error', error);\n    }\n  }\n\n  /**\n   * Categorize frames by generation and protection status\n   */\n  private categorizeFrames(frames: Frame[]): {\n    young: Frame[];\n    mature: Frame[];\n    old: Frame[];\n    protected: Frame[];\n  } {\n    const now = Date.now();\n    const categories = { young: [], mature: [], old: [], protected: [] };\n\n    for (const frame of frames) {\n      const age = now - frame.created_at;\n\n      // Check if frame is protected\n      if (this.isProtected(frame)) {\n        categories.protected.push(frame);\n        continue;\n      }\n\n      // Categorize by age\n      if (age < this.config.generations.young) {\n        categories.young.push(frame);\n      } else if (age < this.config.generations.mature) {\n        categories.mature.push(frame);\n      } else {\n        categories.old.push(frame);\n      }\n    }\n\n    this.stats.protectedFrames = categories.protected.length;\n\n    this.logger.debug('Frame categorization', {\n      young: categories.young.length,\n      mature: categories.mature.length,\n      old: categories.old.length,\n      protected: categories.protected.length,\n    });\n\n    return categories;\n  }\n\n  /**\n   * Check if a frame should be protected from collection\n   */\n  private isProtected(frame: Frame): boolean {\n    // Protect current session/run frames\n    const currentRunId = this.frameManager.getCurrentRunId?.();\n    if (frame.run_id === currentRunId) {\n      return true;\n    }\n\n    // Protect active frames\n    if (frame.state === 'active') {\n      return true;\n    }\n\n    // Protect recent frames (< 1 hour old)\n    const recentThreshold = Date.now() - 60 * 60 * 1000; // 1 hour\n    if (frame.created_at > recentThreshold) {\n      return true;\n    }\n\n    // Protect frames with important outputs\n    if (frame.outputs && Object.keys(frame.outputs).length > 0) {\n      return true;\n    }\n\n    // Protect parent frames (have children)\n    if (frame.depth === 0) {\n      // Root frames\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Select collection candidates with priority ordering\n   */\n  private selectCollectionCandidates(categorized: any): Frame[] {\n    const candidates: Frame[] = [];\n\n    // Priority 1: Closed frames without outputs\n    const emptyClosedFrames = categorized.old.filter(\n      (f: Frame) =>\n        f.state === 'closed' &&\n        (!f.outputs || Object.keys(f.outputs).length === 0)\n    );\n\n    // Priority 2: Orphaned frames (no dependencies)\n    const orphaned = [...categorized.mature, ...categorized.old].filter(\n      (f: Frame) => this.isOrphaned(f)\n    );\n\n    // Priority 3: Duplicate traces\n    const duplicates = this.findDuplicateTraces([\n      ...categorized.mature,\n      ...categorized.old,\n    ]);\n\n    // Priority 4: Old mature frames\n    const oldMature = categorized.mature.filter((f: Frame) => {\n      const age = Date.now() - f.created_at;\n      return age > this.config.generations.mature * 0.8; // 80% of mature threshold\n    });\n\n    // Combine with priority ordering\n    candidates.push(...emptyClosedFrames);\n    candidates.push(...orphaned);\n    candidates.push(...duplicates);\n    candidates.push(...oldMature);\n\n    // Remove duplicates and limit to cycle size\n    const uniqueCandidates = Array.from(new Set(candidates));\n    return uniqueCandidates.slice(0, this.config.framesPerCycle);\n  }\n\n  /**\n   * Check if frame is orphaned (no dependencies)\n   */\n  private isOrphaned(frame: Frame): boolean {\n    // Check if frame has any references from other frames\n    // This is a simplified check - in practice, would analyze actual dependencies\n    return (\n      !frame.parent_frame_id && frame.depth > 0 && frame.state === 'closed'\n    );\n  }\n\n  /**\n   * Find duplicate trace signatures\n   */\n  private findDuplicateTraces(frames: Frame[]): Frame[] {\n    const signatureMap = new Map<string, Frame[]>();\n\n    for (const frame of frames) {\n      // Create a signature from trace content\n      const signature = this.createTraceSignature(frame);\n      if (!signatureMap.has(signature)) {\n        signatureMap.set(signature, []);\n      }\n      signatureMap.get(signature)!.push(frame);\n    }\n\n    // Return duplicates (keep newest, mark older for collection)\n    const duplicates: Frame[] = [];\n    for (const [signature, frameList] of signatureMap) {\n      if (frameList.length > 1) {\n        // Sort by timestamp, keep newest\n        frameList.sort((a, b) => b.timestamp - a.timestamp);\n        duplicates.push(...frameList.slice(1)); // Mark older ones for collection\n      }\n    }\n\n    return duplicates;\n  }\n\n  /**\n   * Create a signature for duplicate detection\n   */\n  private createTraceSignature(frame: Frame): string {\n    // Create signature from key frame properties\n    const type = frame.type;\n    const name = frame.name;\n    const outputs = JSON.stringify(frame.outputs || {});\n    const digestText = frame.digest_text || '';\n    return `${type}:${name}:${outputs}:${digestText}`.toLowerCase();\n  }\n\n  /**\n   * Collect frames incrementally to avoid blocking\n   */\n  private async collectFramesIncremental(\n    candidates: Frame[]\n  ): Promise<Frame[]> {\n    const collected: Frame[] = [];\n    const chunkSize = Math.min(10, Math.ceil(candidates.length / 10)); // Process in small chunks\n\n    for (let i = 0; i < candidates.length; i += chunkSize) {\n      const chunk = candidates.slice(i, i + chunkSize);\n\n      for (const frame of chunk) {\n        try {\n          await this.frameManager.deleteFrame(frame.frame_id);\n          collected.push(frame);\n\n          this.logger.debug(`Collected frame ${frame.frame_id}`, {\n            age: Date.now() - frame.created_at,\n            type: frame.type,\n            reason: this.getCollectionReason(frame),\n          });\n        } catch (error: unknown) {\n          this.logger.warn(`Failed to collect frame ${frame.frame_id}`, error);\n        }\n      }\n\n      // Yield control to avoid blocking\n      await new Promise((resolve) => setImmediate(resolve));\n    }\n\n    return collected;\n  }\n\n  /**\n   * Get human-readable collection reason\n   */\n  private getCollectionReason(frame: Frame): string {\n    const age = Date.now() - frame.created_at;\n    const ageHours = Math.floor(age / (60 * 60 * 1000));\n\n    if (\n      frame.state === 'closed' &&\n      (!frame.outputs || Object.keys(frame.outputs).length === 0)\n    ) {\n      return 'empty-closed';\n    }\n    if (this.isOrphaned(frame)) return 'orphaned';\n    if (ageHours > 24 * 30) return `old (${ageHours}h)`;\n    return 'duplicate';\n  }\n\n  /**\n   * Update GC statistics\n   */\n  private updateStats(startTime: number, collectedCount: number): void {\n    const cycleTime = Date.now() - startTime;\n\n    this.stats.cycleCount++;\n    this.stats.collectedFrames += collectedCount;\n    this.stats.lastRunTime = startTime;\n    this.stats.avgCycleTime =\n      (this.stats.avgCycleTime * (this.stats.cycleCount - 1) + cycleTime) /\n      this.stats.cycleCount;\n  }\n\n  /**\n   * Get GC statistics\n   */\n  getStats(): GCStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Force a manual GC cycle\n   */\n  async forceCollection(): Promise<void> {\n    this.logger.info('Forcing manual GC cycle');\n    await this.runCycle();\n  }\n\n  /**\n   * Update GC configuration\n   */\n  updateConfig(newConfig: Partial<GCConfig>): void {\n    this.config = { ...this.config, ...newConfig };\n    this.logger.info('GC configuration updated', this.config);\n\n    // Restart with new interval if running\n    if (this.isRunning && newConfig.cycleInterval) {\n      this.stop();\n      this.start();\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Incremental Garbage Collection System (STA-288)\n *\n * Implements incremental GC strategy to avoid stop-the-world pauses\n * with generational aging and priority-based collection.\n */\n\nimport { FrameManager } from './index.js';\nimport type { Frame } from './index.js';\nimport { Logger } from '../monitoring/logger.js';\n\ninterface GCConfig {\n  framesPerCycle: number; // Process in chunks (default: 100)\n  cycleInterval: number; // Every minute (default: 60s)\n  maxAge: number; // Max age before eligible for collection (30 days)\n  generations: {\n    young: number; // < 1 day\n    mature: number; // 1-7 days\n    old: number; // 7-30 days\n  };\n}\n\ninterface GCStats {\n  totalFrames: number;\n  collectedFrames: number;\n  lastRunTime: number;\n  cycleCount: number;\n  avgCycleTime: number;\n  protectedFrames: number;\n}\n\nexport class IncrementalGarbageCollector {\n  private logger: Logger;\n  private config: GCConfig;\n  private stats: GCStats;\n  private isRunning: boolean = false;\n  private cycleTimer: NodeJS.Timer | null = null;\n  private frameManager: FrameManager;\n\n  constructor(frameManager: FrameManager, config: Partial<GCConfig> = {}) {\n    this.frameManager = frameManager;\n    this.logger = new Logger('IncrementalGC');\n\n    this.config = {\n      framesPerCycle: config.framesPerCycle || 100,\n      cycleInterval: config.cycleInterval || 60000, // 60 seconds\n      maxAge: config.maxAge || 30 * 24 * 60 * 60 * 1000, // 30 days\n      generations: {\n        young: config.generations?.young || 24 * 60 * 60 * 1000, // 1 day\n        mature: config.generations?.mature || 7 * 24 * 60 * 60 * 1000, // 7 days\n        old: config.generations?.old || 30 * 24 * 60 * 60 * 1000, // 30 days\n      },\n    };\n\n    this.stats = {\n      totalFrames: 0,\n      collectedFrames: 0,\n      lastRunTime: 0,\n      cycleCount: 0,\n      avgCycleTime: 0,\n      protectedFrames: 0,\n    };\n\n    this.logger.info('Incremental GC initialized', this.config);\n  }\n\n  /**\n   * Start the garbage collection cycle\n   */\n  start(): void {\n    if (this.isRunning) {\n      this.logger.warn('GC already running');\n      return;\n    }\n\n    this.isRunning = true;\n    this.logger.info(\n      `Starting incremental GC with ${this.config.cycleInterval}ms intervals`\n    );\n\n    this.cycleTimer = setInterval(() => {\n      this.runCycle().catch((error) => {\n        this.logger.error('GC cycle failed', error);\n      });\n    }, this.config.cycleInterval);\n  }\n\n  /**\n   * Stop the garbage collection cycle\n   */\n  stop(): void {\n    if (this.cycleTimer) {\n      clearInterval(this.cycleTimer);\n      this.cycleTimer = null;\n    }\n    this.isRunning = false;\n    this.logger.info('Incremental GC stopped');\n  }\n\n  /**\n   * Run a single GC cycle\n   */\n  async runCycle(): Promise<void> {\n    const startTime = Date.now();\n    this.logger.debug('Starting GC cycle', {\n      cycle: this.stats.cycleCount + 1,\n    });\n\n    try {\n      // Get all frames for analysis\n      const allFrames = await this.frameManager.getAllFrames();\n      this.stats.totalFrames = allFrames.length;\n\n      if (allFrames.length === 0) {\n        this.logger.debug('No frames to collect');\n        return;\n      }\n\n      // Categorize frames by generation and protection status\n      const categorized = this.categorizeFrames(allFrames);\n\n      // Select candidates for collection (prioritized)\n      const candidates = this.selectCollectionCandidates(categorized);\n\n      // Process in chunks to avoid blocking\n      const collected = await this.collectFramesIncremental(candidates);\n\n      // Update statistics\n      this.updateStats(startTime, collected.length);\n\n      this.logger.info('GC cycle completed', {\n        cycle: this.stats.cycleCount,\n        collected: collected.length,\n        protected: this.stats.protectedFrames,\n        duration: Date.now() - startTime,\n      });\n    } catch (error: unknown) {\n      this.logger.error('GC cycle error', error);\n    }\n  }\n\n  /**\n   * Categorize frames by generation and protection status\n   */\n  private categorizeFrames(frames: Frame[]): {\n    young: Frame[];\n    mature: Frame[];\n    old: Frame[];\n    protected: Frame[];\n  } {\n    const now = Date.now();\n    const categories = { young: [], mature: [], old: [], protected: [] };\n\n    for (const frame of frames) {\n      const age = now - frame.created_at;\n\n      // Check if frame is protected\n      if (this.isProtected(frame)) {\n        categories.protected.push(frame);\n        continue;\n      }\n\n      // Categorize by age\n      if (age < this.config.generations.young) {\n        categories.young.push(frame);\n      } else if (age < this.config.generations.mature) {\n        categories.mature.push(frame);\n      } else {\n        categories.old.push(frame);\n      }\n    }\n\n    this.stats.protectedFrames = categories.protected.length;\n\n    this.logger.debug('Frame categorization', {\n      young: categories.young.length,\n      mature: categories.mature.length,\n      old: categories.old.length,\n      protected: categories.protected.length,\n    });\n\n    return categories;\n  }\n\n  /**\n   * Check if a frame should be protected from collection\n   */\n  private isProtected(frame: Frame): boolean {\n    // Protect current session/run frames\n    const currentRunId = this.frameManager.getCurrentRunId?.();\n    if (frame.run_id === currentRunId) {\n      return true;\n    }\n\n    // Protect active frames\n    if (frame.state === 'active') {\n      return true;\n    }\n\n    // Protect recent frames (< 1 hour old)\n    const recentThreshold = Date.now() - 60 * 60 * 1000; // 1 hour\n    if (frame.created_at > recentThreshold) {\n      return true;\n    }\n\n    // Protect frames with important outputs\n    if (frame.outputs && Object.keys(frame.outputs).length > 0) {\n      return true;\n    }\n\n    // Protect parent frames (have children)\n    if (frame.depth === 0) {\n      // Root frames\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Select collection candidates with priority ordering\n   */\n  private selectCollectionCandidates(categorized: any): Frame[] {\n    const candidates: Frame[] = [];\n\n    // Priority 1: Closed frames without outputs\n    const emptyClosedFrames = categorized.old.filter(\n      (f: Frame) =>\n        f.state === 'closed' &&\n        (!f.outputs || Object.keys(f.outputs).length === 0)\n    );\n\n    // Priority 2: Orphaned frames (no dependencies)\n    const orphaned = [...categorized.mature, ...categorized.old].filter(\n      (f: Frame) => this.isOrphaned(f)\n    );\n\n    // Priority 3: Duplicate traces\n    const duplicates = this.findDuplicateTraces([\n      ...categorized.mature,\n      ...categorized.old,\n    ]);\n\n    // Priority 4: Old mature frames\n    const oldMature = categorized.mature.filter((f: Frame) => {\n      const age = Date.now() - f.created_at;\n      return age > this.config.generations.mature * 0.8; // 80% of mature threshold\n    });\n\n    // Combine with priority ordering\n    candidates.push(...emptyClosedFrames);\n    candidates.push(...orphaned);\n    candidates.push(...duplicates);\n    candidates.push(...oldMature);\n\n    // Remove duplicates and limit to cycle size\n    const uniqueCandidates = Array.from(new Set(candidates));\n    return uniqueCandidates.slice(0, this.config.framesPerCycle);\n  }\n\n  /**\n   * Check if frame is orphaned (no dependencies)\n   */\n  private isOrphaned(frame: Frame): boolean {\n    // Check if frame has any references from other frames\n    // This is a simplified check - in practice, would analyze actual dependencies\n    return (\n      !frame.parent_frame_id && frame.depth > 0 && frame.state === 'closed'\n    );\n  }\n\n  /**\n   * Find duplicate trace signatures\n   */\n  private findDuplicateTraces(frames: Frame[]): Frame[] {\n    const signatureMap = new Map<string, Frame[]>();\n\n    for (const frame of frames) {\n      // Create a signature from trace content\n      const signature = this.createTraceSignature(frame);\n      if (!signatureMap.has(signature)) {\n        signatureMap.set(signature, []);\n      }\n      signatureMap.get(signature)!.push(frame);\n    }\n\n    // Return duplicates (keep newest, mark older for collection)\n    const duplicates: Frame[] = [];\n    for (const [signature, frameList] of signatureMap) {\n      if (frameList.length > 1) {\n        // Sort by timestamp, keep newest\n        frameList.sort((a, b) => b.timestamp - a.timestamp);\n        duplicates.push(...frameList.slice(1)); // Mark older ones for collection\n      }\n    }\n\n    return duplicates;\n  }\n\n  /**\n   * Create a signature for duplicate detection\n   */\n  private createTraceSignature(frame: Frame): string {\n    // Create signature from key frame properties\n    const type = frame.type;\n    const name = frame.name;\n    const outputs = JSON.stringify(frame.outputs || {});\n    const digestText = frame.digest_text || '';\n    return `${type}:${name}:${outputs}:${digestText}`.toLowerCase();\n  }\n\n  /**\n   * Collect frames incrementally to avoid blocking\n   */\n  private async collectFramesIncremental(\n    candidates: Frame[]\n  ): Promise<Frame[]> {\n    const collected: Frame[] = [];\n    const chunkSize = Math.min(10, Math.ceil(candidates.length / 10)); // Process in small chunks\n\n    for (let i = 0; i < candidates.length; i += chunkSize) {\n      const chunk = candidates.slice(i, i + chunkSize);\n\n      for (const frame of chunk) {\n        try {\n          await this.frameManager.deleteFrame(frame.frame_id);\n          collected.push(frame);\n\n          this.logger.debug(`Collected frame ${frame.frame_id}`, {\n            age: Date.now() - frame.created_at,\n            type: frame.type,\n            reason: this.getCollectionReason(frame),\n          });\n        } catch (error: unknown) {\n          this.logger.warn(`Failed to collect frame ${frame.frame_id}`, error);\n        }\n      }\n\n      // Yield control to avoid blocking\n      await new Promise((resolve) => setImmediate(resolve));\n    }\n\n    return collected;\n  }\n\n  /**\n   * Get human-readable collection reason\n   */\n  private getCollectionReason(frame: Frame): string {\n    const age = Date.now() - frame.created_at;\n    const ageHours = Math.floor(age / (60 * 60 * 1000));\n\n    if (\n      frame.state === 'closed' &&\n      (!frame.outputs || Object.keys(frame.outputs).length === 0)\n    ) {\n      return 'empty-closed';\n    }\n    if (this.isOrphaned(frame)) return 'orphaned';\n    if (ageHours > 24 * 30) return `old (${ageHours}h)`;\n    return 'duplicate';\n  }\n\n  /**\n   * Update GC statistics\n   */\n  private updateStats(startTime: number, collectedCount: number): void {\n    const cycleTime = Date.now() - startTime;\n\n    this.stats.cycleCount++;\n    this.stats.collectedFrames += collectedCount;\n    this.stats.lastRunTime = startTime;\n    this.stats.avgCycleTime =\n      (this.stats.avgCycleTime * (this.stats.cycleCount - 1) + cycleTime) /\n      this.stats.cycleCount;\n  }\n\n  /**\n   * Get GC statistics\n   */\n  getStats(): GCStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Force a manual GC cycle\n   */\n  async forceCollection(): Promise<void> {\n    this.logger.info('Forcing manual GC cycle');\n    await this.runCycle();\n  }\n\n  /**\n   * Update GC configuration\n   */\n  updateConfig(newConfig: Partial<GCConfig>): void {\n    this.config = { ...this.config, ...newConfig };\n    this.logger.info('GC configuration updated', this.config);\n\n    // Restart with new interval if running\n    if (this.isRunning && newConfig.cycleInterval) {\n      this.stop();\n      this.start();\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }