@stackmemoryai/stackmemory 0.3.0 → 0.3.3

package/dist/core/context/dual-stack-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/context/dual-stack-manager.ts"],
+  "sourcesContent": ["/**\n * Dual Stack Manager - STA-99\n * Manages both individual and shared team stacks for collaboration\n */\n\nimport type { Frame, Event, Anchor } from './frame-manager.js';\nimport { FrameManager } from './frame-manager.js';\nimport type { DatabaseAdapter } from '../database/database-adapter.js';\nimport { SQLiteAdapter } from '../database/sqlite-adapter.js';\nimport { logger } from '../monitoring/logger.js';\nimport { ValidationError, DatabaseError, ErrorCode } from '../errors/index.js';\nimport {\n  validateInput,\n  CreateSharedStackSchema,\n  SwitchStackSchema,\n  type CreateSharedStackInput,\n  type SwitchStackInput,\n} from './validation.js';\nimport { PermissionManager } from './permission-manager.js';\n\nexport interface StackContext {\n  stackId: string;\n  type: 'individual' | 'shared';\n  projectId: string;\n  ownerId?: string; // For individual stacks\n  teamId?: string; // For shared stacks\n  permissions: StackPermissions;\n  metadata: Record<string, any>;\n  createdAt: Date;\n  lastActive: Date;\n}\n\nexport interface StackPermissions {\n  canRead: boolean;\n  canWrite: boolean;\n  canHandoff: boolean;\n  canMerge: boolean;\n  canAdminister: boolean;\n}\n\nexport interface HandoffRequest {\n  requestId: string;\n  sourceStackId: string;\n  targetStackId: string;\n  frameIds: string[];\n  requesterId: string;\n  targetUserId?: string;\n  message?: string;\n  status: 'pending' | 'accepted' | 'rejected' | 'expired';\n  createdAt: Date;\n  expiresAt: Date;\n}\n\nexport interface StackSyncResult {\n  success: boolean;\n  conflictFrames: string[];\n  mergedFrames: string[];\n  errors: Array<{\n    frameId: string;\n    error: string;\n    resolution?: 'skipped' | 'merged' | 'manual';\n  }>;\n}\n\nexport class DualStackManager {\n  private adapter: DatabaseAdapter;\n  private individualStack: FrameManager;\n  private sharedStacks: Map<string, FrameManager> = new Map();\n  private activeContext: StackContext;\n  private handoffRequests: Map<string, HandoffRequest> = new Map();\n  private permissionManager: PermissionManager;\n\n  constructor(\n    adapter: DatabaseAdapter,\n    projectId: string,\n    userId: string,\n    defaultTeamId?: string\n  ) {\n    this.adapter = adapter;\n    this.permissionManager = new PermissionManager();\n\n    // Initialize individual stack\n    // Extract raw database for FrameManager which expects SQLite directly\n    const rawDb =\n      adapter instanceof SQLiteAdapter ? adapter.getRawDatabase() : null;\n    if (!rawDb) {\n      throw new Error(\n        'DualStackManager requires SQLiteAdapter with connected database'\n      );\n    }\n\n    this.individualStack = new FrameManager(rawDb, projectId, userId);\n\n    // Set default active context to individual stack\n    this.activeContext = {\n      stackId: `individual-${userId}`,\n      type: 'individual',\n      projectId,\n      ownerId: userId,\n      permissions: this.getDefaultIndividualPermissions(),\n      metadata: {},\n      createdAt: new Date(),\n      lastActive: new Date(),\n    };\n\n    // Set up initial permissions for the user's individual stack\n    this.permissionManager.setStackPermissions(\n      userId,\n      `individual-${userId}`,\n      this.getDefaultIndividualPermissions()\n    );\n\n    this.initializeSchema();\n  }\n\n  private async initializeSchema(): Promise<void> {\n    try {\n      // Create stack_contexts table\n      await this.adapter.beginTransaction();\n\n      const createStackContextsTable = `\n        CREATE TABLE IF NOT EXISTS stack_contexts (\n          stack_id TEXT PRIMARY KEY,\n          type TEXT NOT NULL CHECK (type IN ('individual', 'shared')),\n          project_id TEXT NOT NULL,\n          owner_id TEXT,\n          team_id TEXT,\n          permissions TEXT NOT NULL,\n          metadata TEXT DEFAULT '{}',\n          created_at INTEGER NOT NULL,\n          last_active INTEGER NOT NULL,\n          CONSTRAINT valid_ownership CHECK (\n            (type = 'individual' AND owner_id IS NOT NULL AND team_id IS NULL) OR\n            (type = 'shared' AND team_id IS NOT NULL)\n          )\n        )\n      `;\n\n      const createHandoffRequestsTable = `\n        CREATE TABLE IF NOT EXISTS handoff_requests (\n          request_id TEXT PRIMARY KEY,\n          source_stack_id TEXT NOT NULL,\n          target_stack_id TEXT NOT NULL,\n          frame_ids TEXT NOT NULL,\n          requester_id TEXT NOT NULL,\n          target_user_id TEXT,\n          message TEXT,\n          status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'accepted', 'rejected', 'expired')),\n          created_at INTEGER NOT NULL,\n          expires_at INTEGER NOT NULL,\n          FOREIGN KEY (source_stack_id) REFERENCES stack_contexts(stack_id),\n          FOREIGN KEY (target_stack_id) REFERENCES stack_contexts(stack_id)\n        )\n      `;\n\n      const createStackSyncLogTable = `\n        CREATE TABLE IF NOT EXISTS stack_sync_log (\n          sync_id TEXT PRIMARY KEY,\n          source_stack_id TEXT NOT NULL,\n          target_stack_id TEXT NOT NULL,\n          operation TEXT NOT NULL CHECK (operation IN ('handoff', 'merge', 'sync')),\n          frame_count INTEGER NOT NULL,\n          conflicts TEXT DEFAULT '[]',\n          resolution TEXT,\n          timestamp INTEGER NOT NULL,\n          FOREIGN KEY (source_stack_id) REFERENCES stack_contexts(stack_id),\n          FOREIGN KEY (target_stack_id) REFERENCES stack_contexts(stack_id)\n        )\n      `;\n\n      // Execute schema creation using raw SQL\n      if (this.adapter.isConnected()) {\n        // Note: This is a temporary workaround - proper schema creation would use adapter methods\n        (await (this.adapter as any).execute?.(createStackContextsTable)) ||\n          this.executeSchemaQuery(createStackContextsTable);\n        (await (this.adapter as any).execute?.(createHandoffRequestsTable)) ||\n          this.executeSchemaQuery(createHandoffRequestsTable);\n        (await (this.adapter as any).execute?.(createStackSyncLogTable)) ||\n          this.executeSchemaQuery(createStackSyncLogTable);\n      }\n\n      await this.adapter.commitTransaction();\n\n      logger.info('Dual stack schema initialized successfully');\n    } catch (error) {\n      await this.adapter.rollbackTransaction();\n      logger.error('Failed to initialize dual stack schema', error);\n      throw new DatabaseError(\n        'Schema initialization failed',\n        ErrorCode.DB_SCHEMA_ERROR,\n        { adapter: this.adapter.constructor.name },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  private async executeSchemaQuery(sql: string): Promise<void> {\n    // Fallback for adapters that don't have execute method\n    logger.warn(\n      'Using fallback schema creation - implement execute method in adapter'\n    );\n\n    // Execute using raw SQLite database\n    const rawDb =\n      this.adapter instanceof SQLiteAdapter\n        ? this.adapter.getRawDatabase()\n        : null;\n    if (rawDb) {\n      try {\n        rawDb.exec(sql);\n        logger.debug('Executed schema query successfully');\n      } catch (error) {\n        logger.error('Failed to execute schema query', { sql, error });\n        throw error;\n      }\n    } else {\n      throw new Error(\n        'Cannot execute schema query: raw database not available'\n      );\n    }\n  }\n\n  private getDefaultIndividualPermissions(): StackPermissions {\n    return {\n      canRead: true,\n      canWrite: true,\n      canHandoff: true,\n      canMerge: true,\n      canAdminister: true,\n    };\n  }\n\n  private getSharedStackPermissions(\n    role: 'member' | 'lead' | 'admin'\n  ): StackPermissions {\n    const basePermissions = {\n      canRead: true,\n      canWrite: true,\n      canHandoff: true,\n      canMerge: false,\n      canAdminister: false,\n    };\n\n    switch (role) {\n      case 'lead':\n        return { ...basePermissions, canMerge: true };\n      case 'admin':\n        return { ...basePermissions, canMerge: true, canAdminister: true };\n      default:\n        return basePermissions;\n    }\n  }\n\n  /**\n   * Switch between individual and shared stacks\n   */\n  async switchToStack(stackId: string): Promise<void> {\n    // Validate input\n    const input = validateInput(SwitchStackSchema, { stackId });\n\n    try {\n      if (input.stackId.startsWith('individual-')) {\n        this.activeContext = {\n          ...this.activeContext,\n          stackId: input.stackId,\n          type: 'individual',\n        };\n        return;\n      }\n\n      // Load shared stack context\n      const stackContext = await this.loadStackContext(input.stackId);\n      if (!stackContext) {\n        throw new ValidationError(\n          `Stack context not found: ${input.stackId}`,\n          ErrorCode.STACK_CONTEXT_NOT_FOUND\n        );\n      }\n\n      // Check permission to access the stack\n      await this.permissionManager.enforcePermission(\n        this.permissionManager.createContext(\n          this.activeContext.ownerId || 'unknown',\n          'read',\n          'stack',\n          input.stackId,\n          stackContext\n        )\n      );\n\n      this.activeContext = stackContext;\n\n      // Initialize shared stack manager if not already loaded\n      if (!this.sharedStacks.has(input.stackId)) {\n        const rawDb =\n          this.adapter instanceof SQLiteAdapter\n            ? this.adapter.getRawDatabase()\n            : null;\n        if (!rawDb) {\n          throw new Error('Failed to get raw database for shared stack');\n        }\n\n        const sharedStack = new FrameManager(\n          rawDb,\n          stackContext.projectId,\n          input.stackId\n        );\n        this.sharedStacks.set(input.stackId, sharedStack);\n      }\n\n      // Update last active timestamp\n      await this.updateStackActivity(input.stackId);\n\n      logger.info(`Switched to stack: ${input.stackId}`, {\n        type: stackContext.type,\n      });\n    } catch (error) {\n      throw new ValidationError(\n        `Failed to switch to stack: ${input.stackId}`,\n        ErrorCode.OPERATION_FAILED,\n        { stackId: input.stackId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Get the current active stack manager\n   */\n  getActiveStack(): FrameManager {\n    if (this.activeContext.type === 'individual') {\n      return this.individualStack;\n    }\n\n    const sharedStack = this.sharedStacks.get(this.activeContext.stackId);\n    if (!sharedStack) {\n      throw new DatabaseError(\n        `Active shared stack not initialized: ${this.activeContext.stackId}`,\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    return sharedStack;\n  }\n\n  /**\n   * Create a new shared stack for team collaboration\n   */\n  async createSharedStack(\n    teamId: string,\n    name: string,\n    ownerId: string,\n    permissions?: StackPermissions\n  ): Promise<string> {\n    // Validate input parameters\n    const input = validateInput(CreateSharedStackSchema, {\n      teamId,\n      name,\n      ownerId,\n      permissions,\n    });\n\n    // Check permission to create shared stacks\n    await this.permissionManager.enforcePermission(\n      this.permissionManager.createContext(\n        input.ownerId,\n        'administer',\n        'stack',\n        `shared-${input.teamId}`,\n        this.activeContext\n      )\n    );\n\n    const stackId = `shared-${input.teamId}-${Date.now()}`;\n\n    const stackContext: StackContext = {\n      stackId,\n      type: 'shared',\n      projectId: this.activeContext.projectId,\n      teamId: input.teamId,\n      permissions: input.permissions || this.getSharedStackPermissions('admin'),\n      metadata: { name: input.name, ownerId: input.ownerId },\n      createdAt: new Date(),\n      lastActive: new Date(),\n    };\n\n    try {\n      await this.saveStackContext(stackContext);\n\n      // Initialize the shared stack manager\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (!rawDb) {\n        throw new Error('Failed to get raw database for new shared stack');\n      }\n\n      const sharedStack = new FrameManager(\n        rawDb,\n        stackContext.projectId,\n        stackId\n      );\n      this.sharedStacks.set(stackId, sharedStack);\n\n      // Set up permissions for the owner and team\n      const stackPermissions = stackContext.permissions;\n      this.permissionManager.setStackPermissions(\n        input.ownerId,\n        stackId,\n        stackPermissions\n      );\n\n      logger.info(`Created shared stack: ${stackId}`, { teamId, name });\n      return stackId;\n    } catch (error) {\n      throw new DatabaseError(\n        `Failed to create shared stack`,\n        ErrorCode.OPERATION_FAILED,\n        { teamId, name },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Initiate handoff of frames between stacks\n   */\n  async initiateHandoff(\n    targetStackId: string,\n    frameIds: string[],\n    targetUserId?: string,\n    message?: string\n  ): Promise<string> {\n    // Check permission to perform handoff from current stack\n    await this.permissionManager.enforcePermission(\n      this.permissionManager.createContext(\n        this.activeContext.ownerId || 'unknown',\n        'handoff',\n        'stack',\n        this.activeContext.stackId,\n        this.activeContext\n      )\n    );\n\n    const requestId = `handoff-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n\n    const request: HandoffRequest = {\n      requestId,\n      sourceStackId: this.activeContext.stackId,\n      targetStackId,\n      frameIds,\n      requesterId: this.activeContext.ownerId!,\n      targetUserId,\n      message,\n      status: 'pending',\n      createdAt: new Date(),\n      expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24 hours\n    };\n\n    try {\n      await this.saveHandoffRequest(request);\n      this.handoffRequests.set(requestId, request);\n\n      logger.info(`Initiated handoff request: ${requestId}`, {\n        sourceStack: this.activeContext.stackId,\n        targetStack: targetStackId,\n        frameCount: frameIds.length,\n      });\n\n      return requestId;\n    } catch (error) {\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   * Accept a handoff request and move frames\n   */\n  async acceptHandoff(requestId: string): Promise<StackSyncResult> {\n    logger.debug('acceptHandoff called', { requestId });\n    const request = await this.loadHandoffRequest(requestId);\n    logger.debug('loadHandoffRequest returned', {\n      requestId,\n      found: !!request,\n    });\n    if (!request) {\n      logger.error('Handoff request not found', {\n        requestId,\n        availableRequests: Array.from(this.handoffRequests.keys()),\n      });\n      throw new DatabaseError(\n        `Handoff request not found: ${requestId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    if (request.status !== 'pending') {\n      throw new DatabaseError(\n        `Handoff request is not pending: ${request.status}`,\n        ErrorCode.INVALID_STATE\n      );\n    }\n\n    if (request.expiresAt < new Date()) {\n      throw new DatabaseError(\n        `Handoff request has expired`,\n        ErrorCode.OPERATION_EXPIRED\n      );\n    }\n\n    try {\n      // Perform the handoff operation\n      logger.debug('Starting moveFramesBetweenStacks', { requestId });\n      const syncResult = await this.moveFramesBetweenStacks(\n        request.sourceStackId,\n        request.targetStackId,\n        request.frameIds\n      );\n      logger.debug('moveFramesBetweenStacks completed', {\n        requestId,\n        success: syncResult.success,\n      });\n\n      // Update request status\n      logger.debug('Updating request status', { requestId });\n      request.status = 'accepted';\n      logger.debug('Calling saveHandoffRequest', { requestId });\n      await this.saveHandoffRequest(request);\n      logger.debug('saveHandoffRequest completed', { requestId });\n\n      logger.info(`Accepted handoff request: ${requestId}`, {\n        frameCount: request.frameIds.length,\n        conflicts: syncResult.conflictFrames.length,\n      });\n\n      return syncResult;\n    } catch (error) {\n      logger.error('acceptHandoff caught error', {\n        error: error instanceof Error ? error.message : error,\n      });\n      // Update request status to rejected on failure\n      request.status = 'rejected';\n      await this.saveHandoffRequest(request);\n\n      throw new DatabaseError(\n        `Failed to accept handoff`,\n        ErrorCode.OPERATION_FAILED,\n        { requestId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Sync frames between individual and shared stacks\n   */\n  async syncStacks(\n    sourceStackId: string,\n    targetStackId: string,\n    options: {\n      frameIds?: string[];\n      conflictResolution: 'skip' | 'merge' | 'overwrite';\n      dryRun?: boolean;\n    }\n  ): Promise<StackSyncResult> {\n    try {\n      const sourceStack = this.getStackManager(sourceStackId);\n      const targetStack = this.getStackManager(targetStackId);\n\n      // Get frames to sync\n      const framesToSync =\n        options.frameIds ||\n        (await sourceStack.getActiveFrames()).map((f) => f.frame_id);\n\n      const result: StackSyncResult = {\n        success: true,\n        conflictFrames: [],\n        mergedFrames: [],\n        errors: [],\n      };\n\n      for (const frameId of framesToSync) {\n        try {\n          const sourceFrame = await sourceStack.getFrame(frameId);\n          if (!sourceFrame) {\n            result.errors.push({\n              frameId,\n              error: 'Source frame not found',\n              resolution: 'skipped',\n            });\n            continue;\n          }\n\n          const existingFrame = await targetStack.getFrame(frameId);\n\n          if (existingFrame) {\n            // Handle conflict\n            switch (options.conflictResolution) {\n              case 'skip':\n                result.conflictFrames.push(frameId);\n                result.errors.push({\n                  frameId,\n                  error: 'Frame already exists',\n                  resolution: 'skipped',\n                });\n                continue;\n\n              case 'merge':\n                if (!options.dryRun) {\n                  await this.mergeFrames(\n                    existingFrame,\n                    sourceFrame,\n                    targetStack\n                  );\n                }\n                result.mergedFrames.push(frameId);\n                break;\n\n              case 'overwrite':\n                if (!options.dryRun) {\n                  await targetStack.deleteFrame(frameId);\n                  await this.copyFrame(sourceFrame, targetStack);\n                }\n                result.mergedFrames.push(frameId);\n                break;\n            }\n          } else {\n            // Copy frame to target\n            if (!options.dryRun) {\n              await this.copyFrame(sourceFrame, targetStack);\n            }\n            result.mergedFrames.push(frameId);\n          }\n        } catch (error) {\n          result.errors.push({\n            frameId,\n            error: error instanceof Error ? error.message : String(error),\n            resolution: 'skipped',\n          });\n          result.success = false;\n        }\n      }\n\n      logger.info(`Stack sync completed`, {\n        source: sourceStackId,\n        target: targetStackId,\n        merged: result.mergedFrames.length,\n        conflicts: result.conflictFrames.length,\n        errors: result.errors.length,\n      });\n\n      return result;\n    } catch (error) {\n      throw new DatabaseError(\n        `Stack sync failed`,\n        ErrorCode.OPERATION_FAILED,\n        { sourceStackId, targetStackId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  getStackManager(stackId: string): FrameManager {\n    logger.debug('getStackManager called', {\n      stackId,\n      availableStacks: Array.from(this.sharedStacks.keys()),\n    });\n\n    if (stackId.startsWith('individual-')) {\n      logger.debug('Returning individual stack', { stackId });\n      return this.individualStack;\n    }\n\n    const sharedStack = this.sharedStacks.get(stackId);\n    if (!sharedStack) {\n      logger.error('Stack manager not found', {\n        stackId,\n        availableSharedStacks: Array.from(this.sharedStacks.keys()),\n        message: 'getStackManager could not find shared stack',\n      });\n      throw new DatabaseError(\n        `Stack manager not found: ${stackId}`,\n        ErrorCode.RESOURCE_NOT_FOUND\n      );\n    }\n\n    logger.debug('Returning shared stack', { stackId });\n    return sharedStack;\n  }\n\n  private async moveFramesBetweenStacks(\n    sourceStackId: string,\n    targetStackId: string,\n    frameIds: string[]\n  ): Promise<StackSyncResult> {\n    const syncResult = await this.syncStacks(sourceStackId, targetStackId, {\n      frameIds,\n      conflictResolution: 'merge',\n    });\n\n    // Remove frames from source stack after successful sync\n    if (syncResult.success && syncResult.errors.length === 0) {\n      const sourceStack = this.getStackManager(sourceStackId);\n      for (const frameId of frameIds) {\n        try {\n          sourceStack.deleteFrame(frameId);\n          logger.debug('Deleted frame from source stack', {\n            frameId,\n            sourceStackId,\n          });\n        } catch (error) {\n          logger.warn('Failed to delete frame from source stack', {\n            frameId,\n            error,\n          });\n        }\n      }\n      logger.debug('Completed frame cleanup from source stack', {\n        frameIds: frameIds.length,\n      });\n    }\n\n    return syncResult;\n  }\n\n  private async copyFrame(\n    frame: Frame,\n    targetStack: FrameManager\n  ): Promise<void> {\n    // Create frame in target stack\n    await targetStack.createFrame({\n      type: frame.type as any,\n      name: frame.name,\n      inputs: frame.inputs,\n    });\n\n    // Copy events\n    const events = await this.individualStack.getFrameEvents(frame.frame_id);\n    for (const event of events) {\n      await targetStack.addEvent(frame.frame_id, {\n        type: event.type as any,\n        text: event.text,\n        metadata: event.metadata,\n      });\n    }\n\n    // Copy anchors\n    const anchors = await this.individualStack.getFrameAnchors(frame.frame_id);\n    for (const anchor of anchors) {\n      await targetStack.addAnchor(frame.frame_id, {\n        type: anchor.type as any,\n        text: anchor.text,\n        priority: anchor.priority,\n        metadata: anchor.metadata,\n      });\n    }\n  }\n\n  private async mergeFrames(\n    existingFrame: Frame,\n    sourceFrame: Frame,\n    targetStack: FrameManager\n  ): Promise<void> {\n    // Simple merge strategy - append events and anchors\n    const sourceEvents = await this.individualStack.getFrameEvents(\n      sourceFrame.frame_id\n    );\n    for (const event of sourceEvents) {\n      await targetStack.addEvent(existingFrame.frame_id, {\n        type: event.type as any,\n        text: event.text,\n        metadata: { ...event.metadata, merged: true },\n      });\n    }\n\n    const sourceAnchors = await this.individualStack.getFrameAnchors(\n      sourceFrame.frame_id\n    );\n    for (const anchor of sourceAnchors) {\n      await targetStack.addAnchor(existingFrame.frame_id, {\n        type: anchor.type as any,\n        text: anchor.text,\n        priority: anchor.priority,\n        metadata: { ...anchor.metadata, merged: true },\n      });\n    }\n  }\n\n  private async loadStackContext(\n    stackId: string\n  ): Promise<StackContext | null> {\n    try {\n      // Use raw database for direct query\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (!rawDb) {\n        return null;\n      }\n\n      const query = rawDb.prepare(`\n        SELECT stack_id, type, project_id, owner_id, team_id, permissions, metadata, created_at, last_active\n        FROM stack_contexts \n        WHERE stack_id = ?\n      `);\n\n      const row = query.get(stackId) as any;\n      if (!row) {\n        return null;\n      }\n\n      return {\n        stackId: row.stack_id,\n        type: row.type,\n        projectId: row.project_id,\n        ownerId: row.owner_id,\n        teamId: row.team_id,\n        permissions: JSON.parse(row.permissions),\n        metadata: JSON.parse(row.metadata || '{}'),\n        createdAt: new Date(row.created_at),\n        lastActive: new Date(row.last_active),\n      };\n    } catch (error) {\n      logger.error('Failed to load stack context', { stackId, error });\n      return null;\n    }\n  }\n\n  private async saveStackContext(context: StackContext): Promise<void> {\n    try {\n      // Use raw database for direct query\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (!rawDb) {\n        throw new Error('SQLite database not available for stack context save');\n      }\n\n      const query = rawDb.prepare(`\n        INSERT OR REPLACE INTO stack_contexts \n        (stack_id, type, project_id, owner_id, team_id, permissions, metadata, created_at, last_active)\n        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n      `);\n\n      query.run(\n        context.stackId,\n        context.type,\n        context.projectId,\n        context.ownerId || null,\n        context.teamId || null,\n        JSON.stringify(context.permissions),\n        JSON.stringify(context.metadata || {}),\n        context.createdAt.getTime(),\n        context.lastActive.getTime()\n      );\n\n      logger.debug('Saved stack context', { stackId: context.stackId });\n    } catch (error) {\n      logger.error('Failed to save stack context', {\n        stackId: context.stackId,\n        error,\n      });\n      throw error;\n    }\n  }\n\n  private async updateStackActivity(stackId: string): Promise<void> {\n    try {\n      // Use raw database for direct query\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (!rawDb) {\n        logger.warn('SQLite database not available for activity update');\n        return;\n      }\n\n      const query = rawDb.prepare(`\n        UPDATE stack_contexts \n        SET last_active = ?\n        WHERE stack_id = ?\n      `);\n\n      query.run(Date.now(), stackId);\n      logger.debug('Updated stack activity', { stackId });\n    } catch (error) {\n      logger.error('Failed to update stack activity', { stackId, error });\n      // Don't throw - activity updates are not critical\n    }\n  }\n\n  private async loadHandoffRequest(\n    requestId: string\n  ): Promise<HandoffRequest | null> {\n    // Try in-memory first for fast access\n    const memoryRequest = this.handoffRequests.get(requestId);\n    if (memoryRequest) {\n      return memoryRequest;\n    }\n\n    // Try loading from database\n    try {\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (rawDb) {\n        const query = rawDb.prepare(`\n          SELECT * FROM handoff_requests WHERE request_id = ?\n        `);\n\n        const row = query.get(requestId) as any;\n        if (row) {\n          const request: HandoffRequest = {\n            requestId: row.request_id,\n            sourceStackId: row.source_stack_id,\n            targetStackId: row.target_stack_id,\n            frameIds: JSON.parse(row.frame_ids),\n            status: row.status,\n            createdAt: new Date(row.created_at),\n            expiresAt: new Date(row.expires_at),\n            targetUserId: row.target_user_id,\n            message: row.message,\n          };\n\n          // Cache in memory for future access\n          this.handoffRequests.set(requestId, request);\n          return request;\n        }\n      }\n    } catch (error) {\n      logger.error('Failed to load handoff request from database', {\n        requestId,\n        error,\n      });\n    }\n\n    return null;\n  }\n\n  private async saveHandoffRequest(request: HandoffRequest): Promise<void> {\n    try {\n      // Use raw database for direct query\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (rawDb) {\n        const query = rawDb.prepare(`\n          INSERT OR REPLACE INTO handoff_requests \n          (request_id, source_stack_id, target_stack_id, frame_ids, status, created_at, expires_at, target_user_id, message)\n          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n        `);\n\n        query.run(\n          request.requestId,\n          request.sourceStackId,\n          request.targetStackId,\n          JSON.stringify(request.frameIds),\n          request.status,\n          request.createdAt.getTime(),\n          request.expiresAt.getTime(),\n          request.targetUserId || null,\n          request.message || null\n        );\n\n        logger.debug('Saved handoff request to database', {\n          requestId: request.requestId,\n        });\n      }\n\n      // Also keep in-memory for fast access\n      this.handoffRequests.set(request.requestId, request);\n    } catch (error) {\n      logger.error('Failed to save handoff request', {\n        requestId: request.requestId,\n        error,\n      });\n      // Fallback to in-memory only\n      this.handoffRequests.set(request.requestId, request);\n    }\n  }\n\n  /**\n   * Get list of available stacks for the current user\n   */\n  async getAvailableStacks(): Promise<StackContext[]> {\n    try {\n      const stacks: StackContext[] = [];\n\n      // Always include current individual stack context\n      stacks.push(this.activeContext);\n\n      // Query database for all shared stacks the user has access to\n      const rawDb =\n        this.adapter instanceof SQLiteAdapter\n          ? this.adapter.getRawDatabase()\n          : null;\n      if (rawDb) {\n        const query = rawDb.prepare(`\n          SELECT stack_id, type, project_id, owner_id, team_id, permissions, metadata, created_at, last_active\n          FROM stack_contexts \n          WHERE type = 'shared' AND project_id = ?\n        `);\n\n        const rows = query.all(this.activeContext.projectId) as any[];\n\n        for (const row of rows) {\n          const context: StackContext = {\n            stackId: row.stack_id,\n            type: row.type,\n            projectId: row.project_id,\n            ownerId: row.owner_id,\n            teamId: row.team_id,\n            permissions: JSON.parse(row.permissions),\n            metadata: JSON.parse(row.metadata || '{}'),\n            createdAt: new Date(row.created_at),\n            lastActive: new Date(row.last_active),\n          };\n\n          // Check if user has permission to access this stack\n          try {\n            await this.permissionManager.enforcePermission(\n              this.permissionManager.createContext(\n                this.activeContext.ownerId || 'unknown',\n                'read',\n                'stack',\n                context.stackId,\n                context\n              )\n            );\n            stacks.push(context);\n          } catch (permissionError) {\n            // Skip stacks user doesn't have access to\n            logger.debug('User lacks access to stack', {\n              stackId: context.stackId,\n              userId: this.activeContext.ownerId,\n            });\n          }\n        }\n      }\n\n      return stacks;\n    } catch (error) {\n      logger.error('Failed to get available stacks', error);\n      // Return at least the current individual stack\n      return [this.activeContext];\n    }\n  }\n\n  /**\n   * Get pending handoff requests for the current user\n   */\n  async getPendingHandoffRequests(): Promise<HandoffRequest[]> {\n    return Array.from(this.handoffRequests.values()).filter(\n      (request) =>\n        request.status === 'pending' && request.expiresAt > new Date()\n    );\n  }\n\n  /**\n   * Get current stack context\n   */\n  getCurrentContext(): StackContext {\n    return { ...this.activeContext };\n  }\n\n  /**\n   * Get permission manager for external access\n   */\n  getPermissionManager(): PermissionManager {\n    return this.permissionManager;\n  }\n\n  /**\n   * Add user to shared stack with specific permissions\n   */\n  async addUserToSharedStack(\n    stackId: string,\n    userId: string,\n    permissions: StackPermissions,\n    requesterId: string\n  ): Promise<void> {\n    // Check if requester has admin permissions on the stack\n    await this.permissionManager.enforcePermission(\n      this.permissionManager.createContext(\n        requesterId,\n        'administer',\n        'stack',\n        stackId\n      )\n    );\n\n    // Grant permissions to the new user\n    this.permissionManager.setStackPermissions(userId, stackId, permissions);\n\n    logger.info(`Added user to shared stack`, {\n      stackId,\n      userId,\n      permissions,\n      requesterId,\n    });\n  }\n\n  /**\n   * Remove user from shared stack\n   */\n  async removeUserFromSharedStack(\n    stackId: string,\n    userId: string,\n    requesterId: string\n  ): Promise<void> {\n    // Check if requester has admin permissions on the stack\n    await this.permissionManager.enforcePermission(\n      this.permissionManager.createContext(\n        requesterId,\n        'administer',\n        'stack',\n        stackId\n      )\n    );\n\n    // Remove user's permissions\n    const userPermissions = this.permissionManager.getUserPermissions(userId);\n    userPermissions.delete(stackId);\n\n    logger.info(`Removed user from shared stack`, {\n      stackId,\n      userId,\n      requesterId,\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,384 @@
+import { logger } from "../monitoring/logger.js";
+import { ValidationError, DatabaseError, ErrorCode } from "../errors/index.js";
+import {
+  validateInput,
+  InitiateHandoffSchema,
+  HandoffApprovalSchema
+} from "./validation.js";
+class FrameHandoffManager {
+  dualStackManager;
+  activeHandoffs = /* @__PURE__ */ new Map();
+  pendingApprovals = /* @__PURE__ */ new Map();
+  notifications = /* @__PURE__ */ new Map();
+  constructor(dualStackManager) {
+    this.dualStackManager = dualStackManager;
+  }
+  /**
+   * Initiate a frame handoff with rich metadata and approval workflow
+   */
+  async initiateHandoff(targetStackId, frameIds, metadata, targetUserId, message) {
+    const input = validateInput(InitiateHandoffSchema, {
+      targetStackId,
+      frameIds,
+      handoffRequest: metadata,
+      reviewerId: targetUserId,
+      description: message
+    });
+    try {
+      await this.dualStackManager.getPermissionManager().enforcePermission(
+        this.dualStackManager.getPermissionManager().createContext(
+          input.handoffRequest.initiatorId,
+          "handoff",
+          "handoff",
+          input.targetStackId
+        )
+      );
+      await this.validateFramesForHandoff(input.frameIds);
+      const requestId = await this.dualStackManager.initiateHandoff(
+        input.targetStackId,
+        input.frameIds,
+        input.reviewerId,
+        input.description
+      );
+      const progress = {
+        requestId,
+        status: "pending_review",
+        transferredFrames: 0,
+        totalFrames: input.frameIds.length,
+        currentStep: "Awaiting approval",
+        errors: []
+      };
+      this.activeHandoffs.set(requestId, progress);
+      await this.createHandoffNotifications(requestId, metadata, targetUserId);
+      await this.scheduleHandoffReminders(requestId, metadata);
+      logger.info(`Initiated enhanced handoff: ${requestId}`, {
+        frameCount: frameIds.length,
+        priority: metadata.businessContext?.priority,
+        targetUser: targetUserId
+      });
+      return requestId;
+    } catch (error) {
+      throw new DatabaseError(
+        "Failed to initiate handoff",
+        ErrorCode.OPERATION_FAILED,
+        { targetStackId, frameIds },
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
+  /**
+   * Submit approval/rejection for handoff request
+   */
+  async submitHandoffApproval(requestId, approval) {
+    const input = validateInput(HandoffApprovalSchema, {
+      ...approval,
+      reviewerId: approval.reviewerId
+    });
+    const progress = this.activeHandoffs.get(requestId);
+    if (!progress) {
+      throw new ValidationError(
+        `Handoff request not found: ${requestId}`,
+        ErrorCode.HANDOFF_REQUEST_EXPIRED
+      );
+    }
+    const fullApproval = {
+      ...input,
+      requestId,
+      reviewedAt: /* @__PURE__ */ new Date()
+    };
+    const existingApprovals = this.pendingApprovals.get(requestId) || [];
+    existingApprovals.push(fullApproval);
+    this.pendingApprovals.set(requestId, existingApprovals);
+    if (input.decision === "approved") {
+      progress.status = "approved";
+      progress.currentStep = "Ready for transfer";
+      await this.executeHandoffTransfer(requestId);
+    } else if (input.decision === "rejected") {
+      progress.status = "failed";
+      progress.currentStep = "Rejected by reviewer";
+      progress.errors.push({
+        step: "approval",
+        error: input.feedback || "Request rejected",
+        timestamp: /* @__PURE__ */ new Date()
+      });
+    } else if (input.decision === "needs_changes") {
+      progress.status = "pending_review";
+      progress.currentStep = "Changes requested";
+      await this.notifyChangesRequested(requestId, approval);
+    }
+    this.activeHandoffs.set(requestId, progress);
+    logger.info(`Handoff approval submitted: ${requestId}`, {
+      decision: approval.decision,
+      reviewer: approval.reviewerId
+    });
+  }
+  /**
+   * Execute the actual frame transfer after approval
+   */
+  async executeHandoffTransfer(requestId) {
+    logger.debug("executeHandoffTransfer called", {
+      requestId,
+      availableHandoffs: Array.from(this.activeHandoffs.keys())
+    });
+    const progress = this.activeHandoffs.get(requestId);
+    if (!progress) {
+      logger.error("Handoff progress not found", {
+        requestId,
+        availableHandoffs: Array.from(this.activeHandoffs.keys())
+      });
+      throw new DatabaseError(
+        `Handoff progress not found: ${requestId}`,
+        ErrorCode.INVALID_STATE
+      );
+    }
+    try {
+      logger.debug("Setting progress status to in_transfer", { requestId });
+      progress.status = "in_transfer";
+      progress.currentStep = "Transferring frames";
+      progress.estimatedCompletion = new Date(Date.now() + 5 * 60 * 1e3);
+      logger.debug("About to call acceptHandoff", { requestId });
+      const result = await this.dualStackManager.acceptHandoff(requestId);
+      logger.debug("acceptHandoff returned", {
+        requestId,
+        success: result.success
+      });
+      if (result.success) {
+        progress.status = "completed";
+        progress.currentStep = "Transfer completed";
+        progress.transferredFrames = result.mergedFrames.length;
+        await this.notifyHandoffCompletion(requestId, result);
+        logger.info(`Handoff transfer completed: ${requestId}`, {
+          transferredFrames: progress.transferredFrames,
+          conflicts: result.conflictFrames.length
+        });
+      } else {
+        progress.status = "failed";
+        progress.currentStep = "Transfer failed";
+        result.errors.forEach((error) => {
+          progress.errors.push({
+            step: "transfer",
+            error: `Frame ${error.frameId}: ${error.error}`,
+            timestamp: /* @__PURE__ */ new Date()
+          });
+        });
+        throw new DatabaseError(
+          "Handoff transfer failed",
+          ErrorCode.OPERATION_FAILED,
+          { errors: result.errors }
+        );
+      }
+    } catch (error) {
+      progress.status = "failed";
+      progress.currentStep = "Transfer error";
+      progress.errors.push({
+        step: "transfer",
+        error: error instanceof Error ? error.message : String(error),
+        timestamp: /* @__PURE__ */ new Date()
+      });
+      logger.error(`Handoff transfer failed: ${requestId}`, error);
+      throw error;
+    } finally {
+      this.activeHandoffs.set(requestId, progress);
+    }
+  }
+  /**
+   * Get handoff progress and status
+   */
+  async getHandoffProgress(requestId) {
+    return this.activeHandoffs.get(requestId) || null;
+  }
+  /**
+   * Cancel a pending handoff request
+   */
+  async cancelHandoff(requestId, reason) {
+    const progress = this.activeHandoffs.get(requestId);
+    if (!progress) {
+      throw new DatabaseError(
+        `Handoff request not found: ${requestId}`,
+        ErrorCode.RESOURCE_NOT_FOUND
+      );
+    }
+    if (progress.status === "in_transfer") {
+      throw new DatabaseError(
+        "Cannot cancel handoff that is currently transferring",
+        ErrorCode.INVALID_STATE
+      );
+    }
+    progress.status = "cancelled";
+    progress.currentStep = "Cancelled by user";
+    progress.errors.push({
+      step: "cancellation",
+      error: reason,
+      timestamp: /* @__PURE__ */ new Date()
+    });
+    this.activeHandoffs.set(requestId, progress);
+    await this.notifyHandoffCancellation(requestId, reason);
+    logger.info(`Handoff cancelled: ${requestId}`, { reason });
+  }
+  /**
+   * Get all active handoffs for a user or team
+   */
+  async getActiveHandoffs(userId, teamId) {
+    const handoffs = Array.from(this.activeHandoffs.values());
+    if (userId || teamId) {
+      return handoffs.filter(
+        (handoff) => handoff.status === "pending_review" || handoff.status === "approved" || handoff.status === "in_transfer"
+      );
+    }
+    return handoffs;
+  }
+  /**
+   * Get notifications for a user
+   */
+  async getUserNotifications(userId) {
+    return this.notifications.get(userId) || [];
+  }
+  /**
+   * Mark notification as read
+   */
+  async markNotificationRead(notificationId, userId) {
+    const userNotifications = this.notifications.get(userId) || [];
+    const updatedNotifications = userNotifications.filter(
+      (n) => n.id !== notificationId
+    );
+    this.notifications.set(userId, updatedNotifications);
+  }
+  /**
+   * Validate frames are suitable for handoff
+   */
+  async validateFramesForHandoff(frameIds) {
+    const activeStack = this.dualStackManager.getActiveStack();
+    for (const frameId of frameIds) {
+      const frame = await activeStack.getFrame(frameId);
+      if (!frame) {
+        throw new DatabaseError(
+          `Frame not found: ${frameId}`,
+          ErrorCode.RESOURCE_NOT_FOUND
+        );
+      }
+      if (frame.state === "active") {
+        logger.warn(`Transferring active frame: ${frameId}`, {
+          frameName: frame.name
+        });
+      }
+    }
+  }
+  /**
+   * Create notifications for handoff stakeholders
+   */
+  async createHandoffNotifications(requestId, metadata, targetUserId) {
+    const notifications = [];
+    if (targetUserId) {
+      notifications.push({
+        id: `${requestId}-target`,
+        type: "request",
+        requestId,
+        recipientId: targetUserId,
+        title: "Frame Handoff Request",
+        message: `${metadata.initiatorId} wants to transfer ${metadata.frameContext.totalFrames} frames to you`,
+        actionRequired: true,
+        expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1e3),
+        createdAt: /* @__PURE__ */ new Date()
+      });
+    }
+    if (metadata.businessContext?.stakeholders) {
+      for (const stakeholderId of metadata.businessContext.stakeholders) {
+        notifications.push({
+          id: `${requestId}-stakeholder-${stakeholderId}`,
+          type: "request",
+          requestId,
+          recipientId: stakeholderId,
+          title: "Frame Handoff Notification",
+          message: `Frame transfer initiated for ${metadata.businessContext?.milestone || "project milestone"}`,
+          actionRequired: false,
+          createdAt: /* @__PURE__ */ new Date()
+        });
+      }
+    }
+    for (const notification of notifications) {
+      const userNotifications = this.notifications.get(notification.recipientId) || [];
+      userNotifications.push(notification);
+      this.notifications.set(notification.recipientId, userNotifications);
+    }
+  }
+  /**
+   * Schedule reminder notifications
+   */
+  async scheduleHandoffReminders(requestId, metadata) {
+    if (metadata.businessContext?.priority === "high" || metadata.businessContext?.priority === "critical") {
+      setTimeout(
+        async () => {
+          const progress = this.activeHandoffs.get(requestId);
+          if (progress && progress.status === "pending_review") {
+            await this.sendHandoffReminder(requestId, metadata);
+          }
+        },
+        4 * 60 * 60 * 1e3
+      );
+    }
+  }
+  /**
+   * Send handoff reminder
+   */
+  async sendHandoffReminder(requestId, metadata) {
+    logger.info(`Sending handoff reminder: ${requestId}`, {
+      priority: metadata.businessContext?.priority
+    });
+  }
+  /**
+   * Notify when changes are requested
+   */
+  async notifyChangesRequested(requestId, approval) {
+    logger.info(`Changes requested for handoff: ${requestId}`, {
+      reviewer: approval.reviewerId,
+      feedback: approval.feedback
+    });
+  }
+  /**
+   * Notify handoff completion
+   */
+  async notifyHandoffCompletion(requestId, result) {
+    logger.info(`Handoff completed: ${requestId}`, {
+      mergedFrames: result.mergedFrames.length,
+      conflicts: result.conflictFrames.length
+    });
+  }
+  /**
+   * Notify handoff cancellation
+   */
+  async notifyHandoffCancellation(requestId, reason) {
+    logger.info(`Handoff cancelled: ${requestId}`, { reason });
+  }
+  /**
+   * Get handoff analytics and metrics
+   */
+  async getHandoffMetrics(timeRange) {
+    const handoffs = Array.from(this.activeHandoffs.values());
+    const filteredHandoffs = timeRange ? handoffs.filter((h) => {
+      return true;
+    }) : handoffs;
+    const completedHandoffs = filteredHandoffs.filter(
+      (h) => h.status === "completed"
+    );
+    return {
+      totalHandoffs: filteredHandoffs.length,
+      completedHandoffs: completedHandoffs.length,
+      averageProcessingTime: this.calculateAverageProcessingTime(completedHandoffs),
+      topFrameTypes: this.analyzeFrameTypes(filteredHandoffs),
+      collaborationPatterns: this.analyzeCollaborationPatterns(filteredHandoffs)
+    };
+  }
+  calculateAverageProcessingTime(handoffs) {
+    return 0;
+  }
+  analyzeFrameTypes(handoffs) {
+    return [];
+  }
+  analyzeCollaborationPatterns(handoffs) {
+    return [];
+  }
+}
+export {
+  FrameHandoffManager
+};
+//# sourceMappingURL=frame-handoff-manager.js.map

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

@@ -0,0 +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) {\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) {\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    // Implementation would send actual notifications\n    logger.info(`Sending handoff reminder: ${requestId}`, {\n      priority: metadata.businessContext?.priority,\n    });\n  }\n\n  /**\n   * Notify when changes are requested\n   */\n  private async notifyChangesRequested(\n    requestId: string,\n    approval: HandoffApproval\n  ): Promise<void> {\n    // Implementation would notify the requester\n    logger.info(`Changes requested for handoff: ${requestId}`, {\n      reviewer: approval.reviewerId,\n      feedback: approval.feedback,\n    });\n  }\n\n  /**\n   * Notify handoff completion\n   */\n  private async notifyHandoffCompletion(\n    requestId: string,\n    result: any\n  ): Promise<void> {\n    // Implementation would notify all stakeholders\n    logger.info(`Handoff completed: ${requestId}`, {\n      mergedFrames: result.mergedFrames.length,\n      conflicts: result.conflictFrames.length,\n    });\n  }\n\n  /**\n   * Notify handoff cancellation\n   */\n  private async notifyHandoffCancellation(\n    requestId: string,\n    reason: string\n  ): Promise<void> {\n    // Implementation would notify stakeholders\n    logger.info(`Handoff cancelled: ${requestId}`, { reason });\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    // Implementation would calculate actual processing times\n    return 0; // Placeholder\n  }\n\n  private analyzeFrameTypes(\n    handoffs: HandoffProgress[]\n  ): Array<{ type: string; count: number }> {\n    // Implementation would analyze frame types from handoffs\n    return []; // Placeholder\n  }\n\n  private analyzeCollaborationPatterns(\n    handoffs: HandoffProgress[]\n  ): Array<{ sourceUser: string; targetUser: string; count: number }> {\n    // Implementation would analyze collaboration patterns\n    return []; // Placeholder\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}