@stackmemoryai/stackmemory 0.3.9 → 0.3.11

package/dist/core/config/config-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/config/config-manager.ts"],
-  "sourcesContent": ["/**\n * Configuration Manager for StackMemory\n * Handles loading, validation, and management of configuration\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as yaml from 'js-yaml';\nimport {\n  StackMemoryConfig,\n  ProfileConfig,\n  DEFAULT_CONFIG,\n  PRESET_PROFILES,\n  ScoringWeights,\n} from './types.js';\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  suggestions: string[];\n}\n\nexport class ConfigManager {\n  private config: StackMemoryConfig;\n  private configPath: string;\n  private fileWatcher?: fs.FSWatcher;\n  private onChangeCallbacks: Array<(config: StackMemoryConfig) => void> = [];\n\n  constructor(configPath?: string) {\n    this.configPath =\n      configPath || path.join(process.cwd(), '.stackmemory', 'config.yaml');\n    this.config = this.loadConfig();\n  }\n\n  /**\n   * Load configuration from file or use defaults\n   */\n  private loadConfig(): StackMemoryConfig {\n    try {\n      if (fs.existsSync(this.configPath)) {\n        const content = fs.readFileSync(this.configPath, 'utf-8');\n        const loaded = yaml.load(content) as Partial<StackMemoryConfig>;\n        return this.mergeWithDefaults(loaded);\n      }\n    } catch (error: unknown) {\n      console.warn(`Failed to load config from ${this.configPath}:`, error);\n    }\n    // Deep clone to prevent mutation of DEFAULT_CONFIG\n    return this.mergeWithDefaults({});\n  }\n\n  /**\n   * Merge loaded config with defaults\n   */\n  private mergeWithDefaults(\n    loaded: Partial<StackMemoryConfig>\n  ): StackMemoryConfig {\n    const config: StackMemoryConfig = {\n      version: loaded.version || DEFAULT_CONFIG.version,\n      profile: loaded.profile,\n      scoring: {\n        weights: {\n          ...DEFAULT_CONFIG.scoring.weights,\n          ...loaded.scoring?.weights,\n        },\n        tool_scores: {\n          ...DEFAULT_CONFIG.scoring.tool_scores,\n          ...loaded.scoring?.tool_scores,\n        },\n      },\n      retention: {\n        local: {\n          ...DEFAULT_CONFIG.retention.local,\n          ...loaded.retention?.local,\n        },\n        remote: {\n          ...DEFAULT_CONFIG.retention.remote,\n          ...loaded.retention?.remote,\n        },\n        generational_gc: {\n          ...DEFAULT_CONFIG.retention.generational_gc,\n          ...loaded.retention?.generational_gc,\n        },\n      },\n      performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },\n      profiles: { ...PRESET_PROFILES, ...loaded.profiles },\n    };\n\n    // Apply active profile if specified\n    if (config.profile && config.profiles?.[config.profile]) {\n      this.applyProfile(config, config.profiles[config.profile]);\n    }\n\n    return config;\n  }\n\n  /**\n   * Apply a profile to the configuration\n   */\n  private applyProfile(\n    config: StackMemoryConfig,\n    profile: ProfileConfig\n  ): void {\n    if (profile.scoring) {\n      if (profile.scoring.weights) {\n        config.scoring.weights = {\n          ...config.scoring.weights,\n          ...profile.scoring.weights,\n        };\n      }\n      if (profile.scoring.tool_scores) {\n        config.scoring.tool_scores = {\n          ...config.scoring.tool_scores,\n          ...profile.scoring.tool_scores,\n        };\n      }\n    }\n\n    if (profile.retention) {\n      if (profile.retention.local) {\n        config.retention.local = {\n          ...config.retention.local,\n          ...profile.retention.local,\n        };\n      }\n      if (profile.retention.remote) {\n        config.retention.remote = {\n          ...config.retention.remote,\n          ...profile.retention.remote,\n        };\n      }\n      if (profile.retention.generational_gc) {\n        config.retention.generational_gc = {\n          ...config.retention.generational_gc,\n          ...profile.retention.generational_gc,\n        };\n      }\n    }\n\n    if (profile.performance) {\n      config.performance = { ...config.performance, ...profile.performance };\n    }\n  }\n\n  /**\n   * Validate configuration\n   */\n  validate(): ValidationResult {\n    const result: ValidationResult = {\n      valid: true,\n      errors: [],\n      warnings: [],\n      suggestions: [],\n    };\n\n    // Validate weights sum to 1.0\n    const weights = this.config.scoring.weights;\n    const weightSum =\n      weights.base + weights.impact + weights.persistence + weights.reference;\n    if (Math.abs(weightSum - 1.0) > 0.001) {\n      result.errors.push(\n        `Weights must sum to 1.0 (current: ${weightSum.toFixed(3)})`\n      );\n      result.valid = false;\n    }\n\n    // Validate weight ranges\n    Object.entries(weights).forEach(([key, value]) => {\n      if (value < 0 || value > 1) {\n        result.errors.push(\n          `Weight ${key} must be between 0 and 1 (current: ${value})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate tool scores\n    Object.entries(this.config.scoring.tool_scores).forEach(([tool, score]) => {\n      if (score !== undefined && (score < 0 || score > 1)) {\n        result.errors.push(\n          `Tool score for ${tool} must be between 0 and 1 (current: ${score})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate retention periods are ordered\n    const youngMs = this.parseDuration(this.config.retention.local.young);\n    const matureMs = this.parseDuration(this.config.retention.local.mature);\n    const oldMs = this.parseDuration(this.config.retention.local.old);\n\n    if (youngMs >= matureMs) {\n      result.errors.push(\n        'Young retention period must be less than mature period'\n      );\n      result.valid = false;\n    }\n    if (matureMs >= oldMs) {\n      result.errors.push(\n        'Mature retention period must be less than old period'\n      );\n      result.valid = false;\n    }\n\n    // Validate max size\n    const maxSize = this.parseSize(this.config.retention.local.max_size);\n    const availableSpace = this.getAvailableDiskSpace();\n    if (availableSpace > 0 && maxSize > availableSpace) {\n      result.warnings.push(\n        `max_size (${this.config.retention.local.max_size}) exceeds available disk space`\n      );\n    }\n\n    // Performance warnings\n    if (this.config.performance.retrieval_timeout_ms < 100) {\n      result.warnings.push(\n        'retrieval_timeout_ms < 100ms may be too aggressive'\n      );\n    }\n\n    if (this.config.performance.max_stack_depth > 10000) {\n      result.warnings.push('max_stack_depth > 10000 may impact performance');\n    }\n\n    // Suggestions\n    if (!this.config.profile) {\n      result.suggestions.push('Consider using a profile for your use case');\n    }\n\n    if (\n      this.config?.scoring?.tool_scores?.search &&\n      this.config.scoring.tool_scores.search < 0.5\n    ) {\n      result.suggestions.push(\n        'Search tool score seems low - consider increasing for better discovery'\n      );\n    }\n\n    return result;\n  }\n\n  /**\n   * Parse duration string to milliseconds\n   */\n  private parseDuration(duration: string): number {\n    const match = duration.match(/^(\\d+)([hdwm])$/);\n    if (!match) return 0;\n\n    const value = parseInt(match[1]);\n    const unit = match[2];\n\n    const multipliers: Record<string, number> = {\n      h: 3600000, // hours\n      d: 86400000, // days\n      w: 604800000, // weeks\n      m: 2592000000, // months (30 days)\n    };\n\n    return value * (multipliers[unit] || 0);\n  }\n\n  /**\n   * Parse size string to bytes\n   */\n  private parseSize(size: string): number {\n    const match = size.match(/^(\\d+(?:\\.\\d+)?)([KMGT]B)?$/i);\n    if (!match) return 0;\n\n    const value = parseFloat(match[1]);\n    const unit = match[2]?.toUpperCase() || 'B';\n\n    const multipliers: Record<string, number> = {\n      B: 1,\n      KB: 1024,\n      MB: 1024 * 1024,\n      GB: 1024 * 1024 * 1024,\n      TB: 1024 * 1024 * 1024 * 1024,\n    };\n\n    return value * (multipliers[unit] || 1);\n  }\n\n  /**\n   * Get available disk space (simplified)\n   */\n  private getAvailableDiskSpace(): number {\n    // This would need platform-specific implementation\n    // For now, return 0 to skip validation\n    return 0;\n  }\n\n  /**\n   * Save configuration to file\n   */\n  save(): void {\n    const dir = path.dirname(this.configPath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n\n    const content = yaml.dump(this.config, {\n      indent: 2,\n      lineWidth: 120,\n      noRefs: true,\n    });\n\n    fs.writeFileSync(this.configPath, content, 'utf-8');\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): StackMemoryConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * Set active profile\n   */\n  setProfile(profileName: string): boolean {\n    const allProfiles = { ...PRESET_PROFILES, ...this.config.profiles };\n    if (!allProfiles[profileName]) {\n      return false;\n    }\n\n    // Apply the profile to current config\n    this.config.profile = profileName;\n    this.applyProfile(this.config, allProfiles[profileName]);\n    this.notifyChange();\n    return true;\n  }\n\n  /**\n   * Update weights\n   */\n  updateWeights(weights: Partial<ScoringWeights>): void {\n    this.config.scoring.weights = {\n      ...this.config.scoring.weights,\n      ...weights,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Update tool scores\n   */\n  updateToolScores(scores: Record<string, number>): void {\n    this.config.scoring.tool_scores = {\n      ...this.config.scoring.tool_scores,\n      ...scores,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Enable hot reload\n   */\n  enableHotReload(): void {\n    if (this.fileWatcher) return;\n\n    if (fs.existsSync(this.configPath)) {\n      this.fileWatcher = fs.watch(this.configPath, (eventType) => {\n        if (eventType === 'change') {\n          const newConfig = this.loadConfig();\n          const validation = this.validate();\n\n          if (validation.valid) {\n            this.config = newConfig;\n            this.notifyChange();\n            console.log('Configuration reloaded');\n          } else {\n            console.error(\n              'Invalid configuration, keeping previous:',\n              validation.errors\n            );\n          }\n        }\n      });\n    }\n  }\n\n  /**\n   * Disable hot reload\n   */\n  disableHotReload(): void {\n    if (this.fileWatcher) {\n      this.fileWatcher.close();\n      this.fileWatcher = undefined;\n    }\n  }\n\n  /**\n   * Register change callback\n   */\n  onChange(callback: (config: StackMemoryConfig) => void): void {\n    this.onChangeCallbacks.push(callback);\n  }\n\n  /**\n   * Notify all change callbacks\n   */\n  private notifyChange(): void {\n    const config = this.getConfig();\n    this.onChangeCallbacks.forEach((cb) => cb(config));\n  }\n\n  /**\n   * Calculate importance score for a tool\n   */\n  calculateScore(\n    tool: string,\n    additionalFactors?: {\n      filesAffected?: number;\n      isPermanent?: boolean;\n      referenceCount?: number;\n    }\n  ): number {\n    const baseScore = this.config.scoring.tool_scores[tool] || 0.5;\n    const weights = this.config.scoring.weights;\n\n    let score = baseScore * weights.base;\n\n    if (additionalFactors) {\n      // Impact multiplier (files affected)\n      if (additionalFactors.filesAffected !== undefined) {\n        const impactMultiplier = Math.min(\n          additionalFactors.filesAffected / 10,\n          1\n        );\n        score += impactMultiplier * weights.impact;\n      }\n\n      // Persistence bonus\n      if (additionalFactors.isPermanent) {\n        score += 0.2 * weights.persistence;\n      }\n\n      // Reference count\n      if (additionalFactors.referenceCount !== undefined) {\n        const refMultiplier = Math.min(\n          additionalFactors.referenceCount / 100,\n          1\n        );\n        score += refMultiplier * weights.reference;\n      }\n    }\n\n    return Math.min(Math.max(score, 0), 1); // Clamp to [0, 1]\n  }\n\n  /**\n   * Get available profiles\n   */\n  getProfiles(): Record<string, ProfileConfig> {\n    return { ...PRESET_PROFILES, ...this.config.profiles };\n  }\n}\n"],
-  "mappings": "AAKA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,YAAY,UAAU;AACtB;AAAA,EAGE;AAAA,EACA;AAAA,OAEK;AASA,MAAM,cAAc;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAgE,CAAC;AAAA,EAEzE,YAAY,YAAqB;AAC/B,SAAK,aACH,cAAc,KAAK,KAAK,QAAQ,IAAI,GAAG,gBAAgB,aAAa;AACtE,SAAK,SAAS,KAAK,WAAW;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKQ,aAAgC;AACtC,QAAI;AACF,UAAI,GAAG,WAAW,KAAK,UAAU,GAAG;AAClC,cAAM,UAAU,GAAG,aAAa,KAAK,YAAY,OAAO;AACxD,cAAM,SAAS,KAAK,KAAK,OAAO;AAChC,eAAO,KAAK,kBAAkB,MAAM;AAAA,MACtC;AAAA,IACF,SAAS,OAAgB;AACvB,cAAQ,KAAK,8BAA8B,KAAK,UAAU,KAAK,KAAK;AAAA,IACtE;AAEA,WAAO,KAAK,kBAAkB,CAAC,CAAC;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKQ,kBACN,QACmB;AACnB,UAAM,SAA4B;AAAA,MAChC,SAAS,OAAO,WAAW,eAAe;AAAA,MAC1C,SAAS,OAAO;AAAA,MAChB,SAAS;AAAA,QACP,SAAS;AAAA,UACP,GAAG,eAAe,QAAQ;AAAA,UAC1B,GAAG,OAAO,SAAS;AAAA,QACrB;AAAA,QACA,aAAa;AAAA,UACX,GAAG,eAAe,QAAQ;AAAA,UAC1B,GAAG,OAAO,SAAS;AAAA,QACrB;AAAA,MACF;AAAA,MACA,WAAW;AAAA,QACT,OAAO;AAAA,UACL,GAAG,eAAe,UAAU;AAAA,UAC5B,GAAG,OAAO,WAAW;AAAA,QACvB;AAAA,QACA,QAAQ;AAAA,UACN,GAAG,eAAe,UAAU;AAAA,UAC5B,GAAG,OAAO,WAAW;AAAA,QACvB;AAAA,QACA,iBAAiB;AAAA,UACf,GAAG,eAAe,UAAU;AAAA,UAC5B,GAAG,OAAO,WAAW;AAAA,QACvB;AAAA,MACF;AAAA,MACA,aAAa,EAAE,GAAG,eAAe,aAAa,GAAG,OAAO,YAAY;AAAA,MACpE,UAAU,EAAE,GAAG,iBAAiB,GAAG,OAAO,SAAS;AAAA,IACrD;AAGA,QAAI,OAAO,WAAW,OAAO,WAAW,OAAO,OAAO,GAAG;AACvD,WAAK,aAAa,QAAQ,OAAO,SAAS,OAAO,OAAO,CAAC;AAAA,IAC3D;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,aACN,QACA,SACM;AACN,QAAI,QAAQ,SAAS;AACnB,UAAI,QAAQ,QAAQ,SAAS;AAC3B,eAAO,QAAQ,UAAU;AAAA,UACvB,GAAG,OAAO,QAAQ;AAAA,UAClB,GAAG,QAAQ,QAAQ;AAAA,QACrB;AAAA,MACF;AACA,UAAI,QAAQ,QAAQ,aAAa;AAC/B,eAAO,QAAQ,cAAc;AAAA,UAC3B,GAAG,OAAO,QAAQ;AAAA,UAClB,GAAG,QAAQ,QAAQ;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW;AACrB,UAAI,QAAQ,UAAU,OAAO;AAC3B,eAAO,UAAU,QAAQ;AAAA,UACvB,GAAG,OAAO,UAAU;AAAA,UACpB,GAAG,QAAQ,UAAU;AAAA,QACvB;AAAA,MACF;AACA,UAAI,QAAQ,UAAU,QAAQ;AAC5B,eAAO,UAAU,SAAS;AAAA,UACxB,GAAG,OAAO,UAAU;AAAA,UACpB,GAAG,QAAQ,UAAU;AAAA,QACvB;AAAA,MACF;AACA,UAAI,QAAQ,UAAU,iBAAiB;AACrC,eAAO,UAAU,kBAAkB;AAAA,UACjC,GAAG,OAAO,UAAU;AAAA,UACpB,GAAG,QAAQ,UAAU;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAEA,QAAI,QAAQ,aAAa;AACvB,aAAO,cAAc,EAAE,GAAG,OAAO,aAAa,GAAG,QAAQ,YAAY;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAA6B;AAC3B,UAAM,SAA2B;AAAA,MAC/B,OAAO;AAAA,MACP,QAAQ,CAAC;AAAA,MACT,UAAU,CAAC;AAAA,MACX,aAAa,CAAC;AAAA,IAChB;AAGA,UAAM,UAAU,KAAK,OAAO,QAAQ;AACpC,UAAM,YACJ,QAAQ,OAAO,QAAQ,SAAS,QAAQ,cAAc,QAAQ;AAChE,QAAI,KAAK,IAAI,YAAY,CAAG,IAAI,MAAO;AACrC,aAAO,OAAO;AAAA,QACZ,qCAAqC,UAAU,QAAQ,CAAC,CAAC;AAAA,MAC3D;AACA,aAAO,QAAQ;AAAA,IACjB;AAGA,WAAO,QAAQ,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAChD,UAAI,QAAQ,KAAK,QAAQ,GAAG;AAC1B,eAAO,OAAO;AAAA,UACZ,UAAU,GAAG,sCAAsC,KAAK;AAAA,QAC1D;AACA,eAAO,QAAQ;AAAA,MACjB;AAAA,IACF,CAAC;AAGD,WAAO,QAAQ,KAAK,OAAO,QAAQ,WAAW,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,MAAM;AACzE,UAAI,UAAU,WAAc,QAAQ,KAAK,QAAQ,IAAI;AACnD,eAAO,OAAO;AAAA,UACZ,kBAAkB,IAAI,sCAAsC,KAAK;AAAA,QACnE;AACA,eAAO,QAAQ;AAAA,MACjB;AAAA,IACF,CAAC;AAGD,UAAM,UAAU,KAAK,cAAc,KAAK,OAAO,UAAU,MAAM,KAAK;AACpE,UAAM,WAAW,KAAK,cAAc,KAAK,OAAO,UAAU,MAAM,MAAM;AACtE,UAAM,QAAQ,KAAK,cAAc,KAAK,OAAO,UAAU,MAAM,GAAG;AAEhE,QAAI,WAAW,UAAU;AACvB,aAAO,OAAO;AAAA,QACZ;AAAA,MACF;AACA,aAAO,QAAQ;AAAA,IACjB;AACA,QAAI,YAAY,OAAO;AACrB,aAAO,OAAO;AAAA,QACZ;AAAA,MACF;AACA,aAAO,QAAQ;AAAA,IACjB;AAGA,UAAM,UAAU,KAAK,UAAU,KAAK,OAAO,UAAU,MAAM,QAAQ;AACnE,UAAM,iBAAiB,KAAK,sBAAsB;AAClD,QAAI,iBAAiB,KAAK,UAAU,gBAAgB;AAClD,aAAO,SAAS;AAAA,QACd,aAAa,KAAK,OAAO,UAAU,MAAM,QAAQ;AAAA,MACnD;AAAA,IACF;AAGA,QAAI,KAAK,OAAO,YAAY,uBAAuB,KAAK;AACtD,aAAO,SAAS;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAEA,QAAI,KAAK,OAAO,YAAY,kBAAkB,KAAO;AACnD,aAAO,SAAS,KAAK,gDAAgD;AAAA,IACvE;AAGA,QAAI,CAAC,KAAK,OAAO,SAAS;AACxB,aAAO,YAAY,KAAK,4CAA4C;AAAA,IACtE;AAEA,QACE,KAAK,QAAQ,SAAS,aAAa,UACnC,KAAK,OAAO,QAAQ,YAAY,SAAS,KACzC;AACA,aAAO,YAAY;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,UAA0B;AAC9C,UAAM,QAAQ,SAAS,MAAM,iBAAiB;AAC9C,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,QAAQ,SAAS,MAAM,CAAC,CAAC;AAC/B,UAAM,OAAO,MAAM,CAAC;AAEpB,UAAM,cAAsC;AAAA,MAC1C,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,IACL;AAEA,WAAO,SAAS,YAAY,IAAI,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKQ,UAAU,MAAsB;AACtC,UAAM,QAAQ,KAAK,MAAM,8BAA8B;AACvD,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,QAAQ,WAAW,MAAM,CAAC,CAAC;AACjC,UAAM,OAAO,MAAM,CAAC,GAAG,YAAY,KAAK;AAExC,UAAM,cAAsC;AAAA,MAC1C,GAAG;AAAA,MACH,IAAI;AAAA,MACJ,IAAI,OAAO;AAAA,MACX,IAAI,OAAO,OAAO;AAAA,MAClB,IAAI,OAAO,OAAO,OAAO;AAAA,IAC3B;AAEA,WAAO,SAAS,YAAY,IAAI,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKQ,wBAAgC;AAGtC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,UAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AACxC,QAAI,CAAC,GAAG,WAAW,GAAG,GAAG;AACvB,SAAG,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,IACvC;AAEA,UAAM,UAAU,KAAK,KAAK,KAAK,QAAQ;AAAA,MACrC,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,QAAQ;AAAA,IACV,CAAC;AAED,OAAG,cAAc,KAAK,YAAY,SAAS,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA,EAKA,YAA+B;AAC7B,WAAO,EAAE,GAAG,KAAK,OAAO;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,aAA8B;AACvC,UAAM,cAAc,EAAE,GAAG,iBAAiB,GAAG,KAAK,OAAO,SAAS;AAClE,QAAI,CAAC,YAAY,WAAW,GAAG;AAC7B,aAAO;AAAA,IACT;AAGA,SAAK,OAAO,UAAU;AACtB,SAAK,aAAa,KAAK,QAAQ,YAAY,WAAW,CAAC;AACvD,SAAK,aAAa;AAClB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,SAAwC;AACpD,SAAK,OAAO,QAAQ,UAAU;AAAA,MAC5B,GAAG,KAAK,OAAO,QAAQ;AAAA,MACvB,GAAG;AAAA,IACL;AACA,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAiB,QAAsC;AACrD,SAAK,OAAO,QAAQ,cAAc;AAAA,MAChC,GAAG,KAAK,OAAO,QAAQ;AAAA,MACvB,GAAG;AAAA,IACL;AACA,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAwB;AACtB,QAAI,KAAK,YAAa;AAEtB,QAAI,GAAG,WAAW,KAAK,UAAU,GAAG;AAClC,WAAK,cAAc,GAAG,MAAM,KAAK,YAAY,CAAC,cAAc;AAC1D,YAAI,cAAc,UAAU;AAC1B,gBAAM,YAAY,KAAK,WAAW;AAClC,gBAAM,aAAa,KAAK,SAAS;AAEjC,cAAI,WAAW,OAAO;AACpB,iBAAK,SAAS;AACd,iBAAK,aAAa;AAClB,oBAAQ,IAAI,wBAAwB;AAAA,UACtC,OAAO;AACL,oBAAQ;AAAA,cACN;AAAA,cACA,WAAW;AAAA,YACb;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAyB;AACvB,QAAI,KAAK,aAAa;AACpB,WAAK,YAAY,MAAM;AACvB,WAAK,cAAc;AAAA,IACrB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,UAAqD;AAC5D,SAAK,kBAAkB,KAAK,QAAQ;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKQ,eAAqB;AAC3B,UAAM,SAAS,KAAK,UAAU;AAC9B,SAAK,kBAAkB,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,eACE,MACA,mBAKQ;AACR,UAAM,YAAY,KAAK,OAAO,QAAQ,YAAY,IAAI,KAAK;AAC3D,UAAM,UAAU,KAAK,OAAO,QAAQ;AAEpC,QAAI,QAAQ,YAAY,QAAQ;AAEhC,QAAI,mBAAmB;AAErB,UAAI,kBAAkB,kBAAkB,QAAW;AACjD,cAAM,mBAAmB,KAAK;AAAA,UAC5B,kBAAkB,gBAAgB;AAAA,UAClC;AAAA,QACF;AACA,iBAAS,mBAAmB,QAAQ;AAAA,MACtC;AAGA,UAAI,kBAAkB,aAAa;AACjC,iBAAS,MAAM,QAAQ;AAAA,MACzB;AAGA,UAAI,kBAAkB,mBAAmB,QAAW;AAClD,cAAM,gBAAgB,KAAK;AAAA,UACzB,kBAAkB,iBAAiB;AAAA,UACnC;AAAA,QACF;AACA,iBAAS,gBAAgB,QAAQ;AAAA,MACnC;AAAA,IACF;AAEA,WAAO,KAAK,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,cAA6C;AAC3C,WAAO,EAAE,GAAG,iBAAiB,GAAG,KAAK,OAAO,SAAS;AAAA,EACvD;AACF;",
-  "names": []
+  "sourcesContent": ["/**\n * Configuration Manager for StackMemory\n * Handles loading, validation, and management of configuration\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as yaml from 'js-yaml';\nimport {\n  StackMemoryConfig,\n  ProfileConfig,\n  DEFAULT_CONFIG,\n  PRESET_PROFILES,\n  ScoringWeights,\n} from './types.js';\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  suggestions: string[];\n}\n\nexport class ConfigManager {\n  private static instance: ConfigManager | null = null;\n  private config: StackMemoryConfig;\n  private configPath: string;\n  private fileWatcher?: fs.FSWatcher;\n  private onChangeCallbacks: Array<(config: StackMemoryConfig) => void> = [];\n\n  constructor(configPath?: string) {\n    this.configPath =\n      configPath || path.join(process.cwd(), '.stackmemory', 'config.yaml');\n    this.config = this.loadConfig();\n  }\n\n  /**\n   * Get singleton instance of ConfigManager\n   */\n  public static getInstance(configPath?: string): ConfigManager {\n    if (!ConfigManager.instance) {\n      ConfigManager.instance = new ConfigManager(configPath);\n    }\n    return ConfigManager.instance;\n  }\n\n  /**\n   * Load configuration from file or use defaults\n   */\n  private loadConfig(): StackMemoryConfig {\n    try {\n      if (fs.existsSync(this.configPath)) {\n        const content = fs.readFileSync(this.configPath, 'utf-8');\n        const loaded = yaml.load(content) as Partial<StackMemoryConfig>;\n        return this.mergeWithDefaults(loaded);\n      }\n    } catch (error: unknown) {\n      console.warn(`Failed to load config from ${this.configPath}:`, error);\n    }\n    // Deep clone to prevent mutation of DEFAULT_CONFIG\n    return this.mergeWithDefaults({});\n  }\n\n  /**\n   * Merge loaded config with defaults\n   */\n  private mergeWithDefaults(\n    loaded: Partial<StackMemoryConfig>\n  ): StackMemoryConfig {\n    const config: StackMemoryConfig = {\n      version: loaded.version || DEFAULT_CONFIG.version,\n      profile: loaded.profile,\n      scoring: {\n        weights: {\n          ...DEFAULT_CONFIG.scoring.weights,\n          ...loaded.scoring?.weights,\n        },\n        tool_scores: {\n          ...DEFAULT_CONFIG.scoring.tool_scores,\n          ...loaded.scoring?.tool_scores,\n        },\n      },\n      retention: {\n        local: {\n          ...DEFAULT_CONFIG.retention.local,\n          ...loaded.retention?.local,\n        },\n        remote: {\n          ...DEFAULT_CONFIG.retention.remote,\n          ...loaded.retention?.remote,\n        },\n        generational_gc: {\n          ...DEFAULT_CONFIG.retention.generational_gc,\n          ...loaded.retention?.generational_gc,\n        },\n      },\n      performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },\n      profiles: { ...PRESET_PROFILES, ...loaded.profiles },\n    };\n\n    // Apply active profile if specified\n    if (config.profile && config.profiles?.[config.profile]) {\n      this.applyProfile(config, config.profiles[config.profile]);\n    }\n\n    return config;\n  }\n\n  /**\n   * Apply a profile to the configuration\n   */\n  private applyProfile(\n    config: StackMemoryConfig,\n    profile: ProfileConfig\n  ): void {\n    if (profile.scoring) {\n      if (profile.scoring.weights) {\n        config.scoring.weights = {\n          ...config.scoring.weights,\n          ...profile.scoring.weights,\n        };\n      }\n      if (profile.scoring.tool_scores) {\n        config.scoring.tool_scores = {\n          ...config.scoring.tool_scores,\n          ...profile.scoring.tool_scores,\n        };\n      }\n    }\n\n    if (profile.retention) {\n      if (profile.retention.local) {\n        config.retention.local = {\n          ...config.retention.local,\n          ...profile.retention.local,\n        };\n      }\n      if (profile.retention.remote) {\n        config.retention.remote = {\n          ...config.retention.remote,\n          ...profile.retention.remote,\n        };\n      }\n      if (profile.retention.generational_gc) {\n        config.retention.generational_gc = {\n          ...config.retention.generational_gc,\n          ...profile.retention.generational_gc,\n        };\n      }\n    }\n\n    if (profile.performance) {\n      config.performance = { ...config.performance, ...profile.performance };\n    }\n  }\n\n  /**\n   * Validate configuration\n   */\n  validate(): ValidationResult {\n    const result: ValidationResult = {\n      valid: true,\n      errors: [],\n      warnings: [],\n      suggestions: [],\n    };\n\n    // Validate weights sum to 1.0\n    const weights = this.config.scoring.weights;\n    const weightSum =\n      weights.base + weights.impact + weights.persistence + weights.reference;\n    if (Math.abs(weightSum - 1.0) > 0.001) {\n      result.errors.push(\n        `Weights must sum to 1.0 (current: ${weightSum.toFixed(3)})`\n      );\n      result.valid = false;\n    }\n\n    // Validate weight ranges\n    Object.entries(weights).forEach(([key, value]) => {\n      if (value < 0 || value > 1) {\n        result.errors.push(\n          `Weight ${key} must be between 0 and 1 (current: ${value})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate tool scores\n    Object.entries(this.config.scoring.tool_scores).forEach(([tool, score]) => {\n      if (score !== undefined && (score < 0 || score > 1)) {\n        result.errors.push(\n          `Tool score for ${tool} must be between 0 and 1 (current: ${score})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate retention periods are ordered\n    const youngMs = this.parseDuration(this.config.retention.local.young);\n    const matureMs = this.parseDuration(this.config.retention.local.mature);\n    const oldMs = this.parseDuration(this.config.retention.local.old);\n\n    if (youngMs >= matureMs) {\n      result.errors.push(\n        'Young retention period must be less than mature period'\n      );\n      result.valid = false;\n    }\n    if (matureMs >= oldMs) {\n      result.errors.push(\n        'Mature retention period must be less than old period'\n      );\n      result.valid = false;\n    }\n\n    // Validate max size\n    const maxSize = this.parseSize(this.config.retention.local.max_size);\n    const availableSpace = this.getAvailableDiskSpace();\n    if (availableSpace > 0 && maxSize > availableSpace) {\n      result.warnings.push(\n        `max_size (${this.config.retention.local.max_size}) exceeds available disk space`\n      );\n    }\n\n    // Performance warnings\n    if (this.config.performance.retrieval_timeout_ms < 100) {\n      result.warnings.push(\n        'retrieval_timeout_ms < 100ms may be too aggressive'\n      );\n    }\n\n    if (this.config.performance.max_stack_depth > 10000) {\n      result.warnings.push('max_stack_depth > 10000 may impact performance');\n    }\n\n    // Suggestions\n    if (!this.config.profile) {\n      result.suggestions.push('Consider using a profile for your use case');\n    }\n\n    if (\n      this.config?.scoring?.tool_scores?.search &&\n      this.config.scoring.tool_scores.search < 0.5\n    ) {\n      result.suggestions.push(\n        'Search tool score seems low - consider increasing for better discovery'\n      );\n    }\n\n    return result;\n  }\n\n  /**\n   * Parse duration string to milliseconds\n   */\n  private parseDuration(duration: string): number {\n    const match = duration.match(/^(\\d+)([hdwm])$/);\n    if (!match) return 0;\n\n    const value = parseInt(match[1]);\n    const unit = match[2];\n\n    const multipliers: Record<string, number> = {\n      h: 3600000, // hours\n      d: 86400000, // days\n      w: 604800000, // weeks\n      m: 2592000000, // months (30 days)\n    };\n\n    return value * (multipliers[unit] || 0);\n  }\n\n  /**\n   * Parse size string to bytes\n   */\n  private parseSize(size: string): number {\n    const match = size.match(/^(\\d+(?:\\.\\d+)?)([KMGT]B)?$/i);\n    if (!match) return 0;\n\n    const value = parseFloat(match[1]);\n    const unit = match[2]?.toUpperCase() || 'B';\n\n    const multipliers: Record<string, number> = {\n      B: 1,\n      KB: 1024,\n      MB: 1024 * 1024,\n      GB: 1024 * 1024 * 1024,\n      TB: 1024 * 1024 * 1024 * 1024,\n    };\n\n    return value * (multipliers[unit] || 1);\n  }\n\n  /**\n   * Get available disk space (simplified)\n   */\n  private getAvailableDiskSpace(): number {\n    // This would need platform-specific implementation\n    // For now, return 0 to skip validation\n    return 0;\n  }\n\n  /**\n   * Save configuration to file\n   */\n  save(): void {\n    const dir = path.dirname(this.configPath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n\n    const content = yaml.dump(this.config, {\n      indent: 2,\n      lineWidth: 120,\n      noRefs: true,\n    });\n\n    fs.writeFileSync(this.configPath, content, 'utf-8');\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): StackMemoryConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * Get a specific configuration value by path\n   * Example: config.get('project.id') returns config.project.id\n   */\n  get(path: string): any {\n    const keys = path.split('.');\n    let value: any = this.config;\n    \n    for (const key of keys) {\n      if (value && typeof value === 'object' && key in value) {\n        value = value[key];\n      } else {\n        return undefined;\n      }\n    }\n    \n    return value;\n  }\n\n  /**\n   * Set active profile\n   */\n  setProfile(profileName: string): boolean {\n    const allProfiles = { ...PRESET_PROFILES, ...this.config.profiles };\n    if (!allProfiles[profileName]) {\n      return false;\n    }\n\n    // Apply the profile to current config\n    this.config.profile = profileName;\n    this.applyProfile(this.config, allProfiles[profileName]);\n    this.notifyChange();\n    return true;\n  }\n\n  /**\n   * Update weights\n   */\n  updateWeights(weights: Partial<ScoringWeights>): void {\n    this.config.scoring.weights = {\n      ...this.config.scoring.weights,\n      ...weights,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Update tool scores\n   */\n  updateToolScores(scores: Record<string, number>): void {\n    this.config.scoring.tool_scores = {\n      ...this.config.scoring.tool_scores,\n      ...scores,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Enable hot reload\n   */\n  enableHotReload(): void {\n    if (this.fileWatcher) return;\n\n    if (fs.existsSync(this.configPath)) {\n      this.fileWatcher = fs.watch(this.configPath, (eventType) => {\n        if (eventType === 'change') {\n          const newConfig = this.loadConfig();\n          const validation = this.validate();\n\n          if (validation.valid) {\n            this.config = newConfig;\n            this.notifyChange();\n            console.log('Configuration reloaded');\n          } else {\n            console.error(\n              'Invalid configuration, keeping previous:',\n              validation.errors\n            );\n          }\n        }\n      });\n    }\n  }\n\n  /**\n   * Disable hot reload\n   */\n  disableHotReload(): void {\n    if (this.fileWatcher) {\n      this.fileWatcher.close();\n      this.fileWatcher = undefined;\n    }\n  }\n\n  /**\n   * Register change callback\n   */\n  onChange(callback: (config: StackMemoryConfig) => void): void {\n    this.onChangeCallbacks.push(callback);\n  }\n\n  /**\n   * Notify all change callbacks\n   */\n  private notifyChange(): void {\n    const config = this.getConfig();\n    this.onChangeCallbacks.forEach((cb) => cb(config));\n  }\n\n  /**\n   * Calculate importance score for a tool\n   */\n  calculateScore(\n    tool: string,\n    additionalFactors?: {\n      filesAffected?: number;\n      isPermanent?: boolean;\n      referenceCount?: number;\n    }\n  ): number {\n    const baseScore = this.config.scoring.tool_scores[tool] || 0.5;\n    const weights = this.config.scoring.weights;\n\n    let score = baseScore * weights.base;\n\n    if (additionalFactors) {\n      // Impact multiplier (files affected)\n      if (additionalFactors.filesAffected !== undefined) {\n        const impactMultiplier = Math.min(\n          additionalFactors.filesAffected / 10,\n          1\n        );\n        score += impactMultiplier * weights.impact;\n      }\n\n      // Persistence bonus\n      if (additionalFactors.isPermanent) {\n        score += 0.2 * weights.persistence;\n      }\n\n      // Reference count\n      if (additionalFactors.referenceCount !== undefined) {\n        const refMultiplier = Math.min(\n          additionalFactors.referenceCount / 100,\n          1\n        );\n        score += refMultiplier * weights.reference;\n      }\n    }\n\n    return Math.min(Math.max(score, 0), 1); // Clamp to [0, 1]\n  }\n\n  /**\n   * Get available profiles\n   */\n  getProfiles(): Record<string, ProfileConfig> {\n    return { ...PRESET_PROFILES, ...this.config.profiles };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["path"]
 }

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

@@ -374,7 +374,7 @@ class FrameHandoffManager {
       requestId,
       recipientId: "requester",
       // TODO: Get actual requester from handoff metadata
-      title: "\u{1F504} Changes Requested for Handoff",
+      title: "Changes Requested for Handoff",
       message: `${approval.reviewerId} has requested changes: ${approval.feedback || "See detailed suggestions"}`,
       actionRequired: true,
       expiresAt: new Date(Date.now() + 48 * 60 * 60 * 1e3),
@@ -412,7 +412,7 @@ class FrameHandoffManager {
       requestId,
       recipientId: "all",
       // Will be distributed to all stakeholders
-      title: "\u2705 Handoff Completed Successfully",
+      title: "Handoff Completed Successfully",
       message: `Frame transfer completed: ${result.mergedFrames.length} frames transferred${result.conflictFrames.length > 0 ? `, ${result.conflictFrames.length} conflicts resolved` : ""}`,
       actionRequired: false,
       createdAt: /* @__PURE__ */ new Date()
@@ -456,7 +456,7 @@ class FrameHandoffManager {
       requestId,
       recipientId: "all",
       // Will be distributed to all stakeholders
-      title: "\u274C Handoff Cancelled",
+      title: "Handoff Cancelled",
       message: `Handoff request has been cancelled. Reason: ${reason}`,
       actionRequired: false,
       createdAt: /* @__PURE__ */ new Date()
@@ -637,7 +637,7 @@ class FrameHandoffManager {
       type: "request",
       requestId,
       recipientId: "all",
-      title: "\u{1F4CA} Handoff Progress Update",
+      title: "Handoff Progress Update",
       message: `Status: ${progress.status} | Step: ${progress.currentStep} | Progress: ${progress.transferredFrames}/${progress.totalFrames} frames`,
       actionRequired: false,
       createdAt: /* @__PURE__ */ new Date()

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

@@ -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: '\uD83D\uDD04 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: '\u2705 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: '\u274C 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: '\uD83D\uDCCA 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-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"],
   "mappings": "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",
   "names": []
 }

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

@@ -8,6 +8,8 @@ import {
 } from "../errors/index.js";
 import { sessionManager, FrameQueryMode } from "../session/index.js";
 import { contextBridge } from "./context-bridge.js";
+const MAX_FRAME_DEPTH = 100;
+const DEFAULT_MAX_DEPTH = 100;
 function getEnv(key, defaultValue) {
   const value = process.env[key];
   if (value === void 0) {
@@ -27,6 +29,7 @@ class FrameManager {
   activeStack = [];
   // Stack of active frame IDs
   queryMode = FrameQueryMode.PROJECT_ACTIVE;
+  maxFrameDepth = DEFAULT_MAX_DEPTH;
   constructor(db, projectId, runIdOrOptions) {
     this.db = db;
     this.projectId = projectId;
@@ -37,6 +40,7 @@ class FrameManager {
     } else if (runIdOrOptions) {
       runId = runIdOrOptions.runId;
       skipContextBridge = runIdOrOptions.skipContextBridge || false;
+      this.maxFrameDepth = runIdOrOptions.maxFrameDepth || DEFAULT_MAX_DEPTH;
     }
     const session = sessionManager.getCurrentSession();
     if (session) {
@@ -258,6 +262,34 @@ class FrameManager {
     const frameId = uuidv4();
     const parentFrameId = options.parentFrameId || this.getCurrentFrameId();
     const depth = parentFrameId ? this.getFrameDepth(parentFrameId) + 1 : 0;
+    if (depth > this.maxFrameDepth) {
+      throw new FrameError(
+        `Maximum frame depth exceeded: ${depth} > ${this.maxFrameDepth}`,
+        ErrorCode.FRAME_STACK_OVERFLOW,
+        {
+          currentDepth: depth,
+          maxDepth: this.maxFrameDepth,
+          frameId,
+          parentFrameId,
+          frameName: options.name
+        }
+      );
+    }
+    if (parentFrameId) {
+      const cycle = this.detectCycle(frameId, parentFrameId);
+      if (cycle) {
+        throw new FrameError(
+          `Circular reference detected in frame hierarchy`,
+          ErrorCode.FRAME_CYCLE_DETECTED,
+          {
+            frameId,
+            parentFrameId,
+            cycle,
+            frameName: options.name
+          }
+        );
+      }
+    }
     const frame = {
       frame_id: frameId,
       run_id: this.currentRunId,
@@ -815,6 +847,113 @@ Activity: ${eventCount} events, ${structured.tool_calls_count} tool calls`;
     const artifacts = this.getFrameEvents(frameId).filter((e) => e.event_type === "artifact").map((e) => e.payload.ref).filter(Boolean);
     return artifacts;
   }
+  /**
+   * Detect if setting a parent frame would create a cycle in the frame hierarchy.
+   * Returns the cycle path if detected, or null if no cycle.
+   * @param childFrameId - The frame that would be the child
+   * @param parentFrameId - The proposed parent frame
+   * @returns Array of frame IDs forming the cycle, or null if no cycle
+   */
+  detectCycle(childFrameId, parentFrameId) {
+    const visited = /* @__PURE__ */ new Set();
+    const path = [];
+    let currentId = parentFrameId;
+    while (currentId) {
+      if (visited.has(currentId)) {
+        const cycleStart = path.indexOf(currentId);
+        return path.slice(cycleStart).concat(currentId);
+      }
+      if (currentId === childFrameId) {
+        return path.concat([currentId, childFrameId]);
+      }
+      visited.add(currentId);
+      path.push(currentId);
+      const frame = this.getFrame(currentId);
+      if (!frame) {
+        break;
+      }
+      currentId = frame.parent_frame_id;
+      if (path.length > this.maxFrameDepth) {
+        throw new FrameError(
+          `Frame hierarchy traversal exceeded maximum depth during cycle detection`,
+          ErrorCode.FRAME_STACK_OVERFLOW,
+          {
+            depth: path.length,
+            maxDepth: this.maxFrameDepth,
+            path
+          }
+        );
+      }
+    }
+    return null;
+  }
+  /**
+   * Update parent frame of an existing frame (with cycle detection)
+   * @param frameId - The frame to update
+   * @param newParentFrameId - The new parent frame ID
+   */
+  updateParentFrame(frameId, newParentFrameId) {
+    const frame = this.getFrame(frameId);
+    if (!frame) {
+      throw new FrameError(
+        `Frame not found: ${frameId}`,
+        ErrorCode.FRAME_NOT_FOUND,
+        { frameId }
+      );
+    }
+    if (newParentFrameId) {
+      const cycle = this.detectCycle(frameId, newParentFrameId);
+      if (cycle) {
+        throw new FrameError(
+          `Cannot set parent: would create circular reference`,
+          ErrorCode.FRAME_CYCLE_DETECTED,
+          {
+            frameId,
+            newParentFrameId,
+            cycle,
+            currentParentId: frame.parent_frame_id
+          }
+        );
+      }
+      const newParentFrame = this.getFrame(newParentFrameId);
+      if (newParentFrame) {
+        const newDepth = newParentFrame.depth + 1;
+        if (newDepth > this.maxFrameDepth) {
+          throw new FrameError(
+            `Cannot set parent: would exceed maximum frame depth`,
+            ErrorCode.FRAME_STACK_OVERFLOW,
+            {
+              frameId,
+              newParentFrameId,
+              newDepth,
+              maxDepth: this.maxFrameDepth
+            }
+          );
+        }
+      }
+    }
+    try {
+      this.db.prepare(
+        `UPDATE frames SET parent_frame_id = ? WHERE frame_id = ?`
+      ).run(newParentFrameId, frameId);
+      logger.info("Updated parent frame", {
+        frameId,
+        oldParentId: frame.parent_frame_id,
+        newParentId: newParentFrameId
+      });
+    } catch (error) {
+      throw new DatabaseError(
+        `Failed to update parent frame`,
+        ErrorCode.DB_UPDATE_FAILED,
+        {
+          frameId,
+          newParentFrameId,
+          operation: "updateParentFrame"
+        },
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
 }
 export {
   FrameManager