@stackmemoryai/stackmemory 0.5.58 → 0.5.59

package/dist/src/core/monitoring/session-monitor.js

@@ -0,0 +1,300 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { EventEmitter } from "events";
+import { ClearSurvival } from "../session/clear-survival.js";
+import { HandoffGenerator } from "../session/handoff-generator.js";
+import * as fs from "fs/promises";
+import * as path from "path";
+class SessionMonitor extends EventEmitter {
+  config;
+  clearSurvival;
+  handoffGenerator;
+  frameManager;
+  dbManager;
+  monitorInterval;
+  lastActivityTime;
+  isMonitoring = false;
+  projectRoot;
+  // Track context state to avoid duplicate saves
+  lastContextCheck = { tokens: 0, percentage: 0 };
+  constructor(frameManager, dbManager, projectRoot, config) {
+    super();
+    this.frameManager = frameManager;
+    this.dbManager = dbManager;
+    this.projectRoot = projectRoot;
+    this.lastActivityTime = /* @__PURE__ */ new Date();
+    this.config = {
+      contextWarningThreshold: 0.6,
+      contextCriticalThreshold: 0.7,
+      contextAutoSaveThreshold: 0.85,
+      idleTimeoutMinutes: 5,
+      sessionEndHandoff: true,
+      checkIntervalSeconds: 30,
+      autoSaveLedger: true,
+      autoGenerateHandoff: true,
+      autoCompactOnThreshold: false,
+      ...config
+    };
+    this.clearSurvival = new ClearSurvival(
+      frameManager,
+      dbManager,
+      new HandoffGenerator(frameManager, dbManager, projectRoot),
+      projectRoot
+    );
+    this.handoffGenerator = new HandoffGenerator(
+      frameManager,
+      dbManager,
+      projectRoot
+    );
+  }
+  /**
+   * Start monitoring session
+   */
+  async start() {
+    if (this.isMonitoring) return;
+    this.isMonitoring = true;
+    this.lastActivityTime = /* @__PURE__ */ new Date();
+    this.monitorInterval = setInterval(
+      () => this.checkSession(),
+      this.config.checkIntervalSeconds * 1e3
+    );
+    this.registerExitHandlers();
+    this.emit("monitor:started");
+    console.log("\u{1F50D} Session monitor started");
+  }
+  /**
+   * Stop monitoring
+   */
+  async stop() {
+    if (!this.isMonitoring) return;
+    this.isMonitoring = false;
+    if (this.monitorInterval) {
+      clearInterval(this.monitorInterval);
+      this.monitorInterval = void 0;
+    }
+    if (this.config.sessionEndHandoff) {
+      await this.generateHandoff("session_end");
+    }
+    this.emit("monitor:stopped");
+    console.log("\u{1F6D1} Session monitor stopped");
+  }
+  /**
+   * Main monitoring check
+   */
+  async checkSession() {
+    try {
+      await this.checkContextUsage();
+      await this.checkIdleTimeout();
+      await this.checkCustomTriggers();
+    } catch (error) {
+      console.error("Monitor check failed:", error);
+      this.emit("monitor:error", error);
+    }
+  }
+  /**
+   * Check context usage and trigger actions
+   */
+  async checkContextUsage() {
+    const currentTokens = await this.estimateTokens();
+    const maxTokens = 1e5;
+    const percentage = currentTokens / maxTokens;
+    this.lastContextCheck = {
+      tokens: currentTokens,
+      percentage,
+      savedAt: this.lastContextCheck.savedAt
+    };
+    this.emit("context:usage", {
+      tokens: currentTokens,
+      maxTokens,
+      percentage,
+      status: this.getContextStatus(percentage)
+    });
+    if (percentage >= this.config.contextAutoSaveThreshold) {
+      await this.handleCriticalContext();
+    } else if (percentage >= this.config.contextCriticalThreshold) {
+      await this.handleHighContext();
+    } else if (percentage >= this.config.contextWarningThreshold) {
+      this.handleWarningContext();
+    }
+  }
+  /**
+   * Handle critical context (>85%)
+   */
+  async handleCriticalContext() {
+    if (this.lastContextCheck.savedAt) {
+      const minsSinceLastSave = (Date.now() - this.lastContextCheck.savedAt.getTime()) / 6e4;
+      if (minsSinceLastSave < 5) return;
+    }
+    console.log("\u{1F534} Critical context usage - auto-saving ledger");
+    if (this.config.autoSaveLedger) {
+      const ledger = await this.clearSurvival.saveContinuityLedger();
+      this.lastContextCheck.savedAt = /* @__PURE__ */ new Date();
+      this.emit("context:ledger_saved", {
+        compression: ledger.compression_ratio,
+        frames: ledger.active_frame_stack.length,
+        tasks: ledger.active_tasks.length
+      });
+      console.log("\u{1F4A1} Ledger saved. Run /clear to reset context");
+      if (this.config.autoCompactOnThreshold) {
+        this.emit("context:suggest_clear");
+      }
+    }
+  }
+  /**
+   * Handle high context (70-85%)
+   */
+  async handleHighContext() {
+    console.log("\u26A0\uFE0F High context usage - consider saving ledger");
+    this.emit("context:high", {
+      percentage: this.lastContextCheck.percentage,
+      suggestion: "Run: stackmemory clear --save"
+    });
+  }
+  /**
+   * Handle warning context (60-70%)
+   */
+  handleWarningContext() {
+    this.emit("context:warning", {
+      percentage: this.lastContextCheck.percentage
+    });
+  }
+  /**
+   * Check for idle timeout
+   */
+  async checkIdleTimeout() {
+    const idleMinutes = (Date.now() - this.lastActivityTime.getTime()) / 6e4;
+    if (idleMinutes >= this.config.idleTimeoutMinutes) {
+      if (this.config.autoGenerateHandoff) {
+        await this.generateHandoff("idle_timeout");
+      }
+    }
+  }
+  /**
+   * Generate handoff document
+   */
+  async generateHandoff(trigger) {
+    try {
+      const sessionId = await this.dbManager.getCurrentSessionId();
+      const handoff = await this.handoffGenerator.generateHandoff(sessionId);
+      this.emit("handoff:generated", {
+        trigger,
+        sessionDuration: handoff.session_duration_minutes,
+        tasksActive: handoff.active_tasks.filter(
+          (t) => t.status !== "completed"
+        ).length
+      });
+      console.log(`\u{1F4CB} Handoff generated (trigger: ${trigger})`);
+    } catch (error) {
+      console.error("Failed to generate handoff:", error);
+    }
+  }
+  /**
+   * Register process exit handlers
+   */
+  registerExitHandlers() {
+    const exitHandler = async (signal) => {
+      console.log(`
+\u{1F4E6} Received ${signal}, saving session state...`);
+      try {
+        if (this.lastContextCheck.percentage > 0.3) {
+          await this.clearSurvival.saveContinuityLedger();
+          console.log("\u2705 Continuity ledger saved");
+        }
+        if (this.config.sessionEndHandoff) {
+          await this.generateHandoff("process_exit");
+          console.log("\u2705 Handoff document generated");
+        }
+      } catch (error) {
+        console.error("Error during exit handling:", error);
+      } finally {
+        process.exit(0);
+      }
+    };
+    process.once("SIGINT", () => exitHandler("SIGINT"));
+    process.once("SIGTERM", () => exitHandler("SIGTERM"));
+    process.once("beforeExit", () => exitHandler("beforeExit"));
+  }
+  /**
+   * Update last activity time
+   */
+  updateActivity() {
+    this.lastActivityTime = /* @__PURE__ */ new Date();
+  }
+  /**
+   * Check custom triggers (extensible)
+   */
+  async checkCustomTriggers() {
+    const hooksDir = path.join(this.projectRoot, ".stackmemory", "hooks");
+    try {
+      await fs.access(hooksDir);
+      const hooks = await fs.readdir(hooksDir);
+      for (const hook of hooks) {
+        if (hook.startsWith("monitor_") && hook.endsWith(".js")) {
+          try {
+            const hookPath = path.join(hooksDir, hook);
+            const hookModule = await import(hookPath);
+            if (hookModule.check) {
+              const shouldTrigger = await hookModule.check({
+                contextPercentage: this.lastContextCheck.percentage,
+                idleMinutes: (Date.now() - this.lastActivityTime.getTime()) / 6e4,
+                frameCount: (await this.frameManager.getStack()).frames.length
+              });
+              if (shouldTrigger && hookModule.action) {
+                await hookModule.action({
+                  clearSurvival: this.clearSurvival,
+                  handoffGenerator: this.handoffGenerator,
+                  frameManager: this.frameManager
+                });
+              }
+            }
+          } catch (error) {
+            console.error(`Hook ${hook} failed:`, error);
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  /**
+   * Estimate current token usage
+   */
+  async estimateTokens() {
+    const sessionId = await this.dbManager.getCurrentSessionId();
+    const frames = await this.dbManager.getRecentFrames(sessionId, 100);
+    const traces = await this.dbManager.getRecentTraces(sessionId, 100);
+    return frames.length * 200 + traces.length * 100;
+  }
+  /**
+   * Get context status based on percentage
+   */
+  getContextStatus(percentage) {
+    if (percentage >= this.config.contextAutoSaveThreshold) return "critical";
+    if (percentage >= this.config.contextCriticalThreshold) return "high";
+    if (percentage >= this.config.contextWarningThreshold) return "warning";
+    return "ok";
+  }
+  /**
+   * Get current monitor status
+   */
+  getStatus() {
+    return {
+      isMonitoring: this.isMonitoring,
+      lastActivity: this.lastActivityTime,
+      contextUsage: this.lastContextCheck,
+      config: this.config
+    };
+  }
+  /**
+   * Update configuration
+   */
+  updateConfig(config) {
+    this.config = { ...this.config, ...config };
+    this.emit("config:updated", this.config);
+  }
+}
+export {
+  SessionMonitor
+};
+//# sourceMappingURL=session-monitor.js.map

package/dist/src/core/monitoring/session-monitor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/monitoring/session-monitor.ts"],
+  "sourcesContent": ["/**\n * Session Monitor for StackMemory\n * Automatically triggers features based on session events\n */\n\nimport { EventEmitter } from 'events';\nimport { ClearSurvival } from '../session/clear-survival.js';\nimport { HandoffGenerator } from '../session/handoff-generator.js';\nimport { FrameManager } from '../context/index.js';\nimport { DatabaseManager } from '../storage/database-manager.js';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\n\nexport interface MonitorConfig {\n  // Context thresholds\n  contextWarningThreshold: number; // Default 0.6 (60%)\n  contextCriticalThreshold: number; // Default 0.7 (70%)\n  contextAutoSaveThreshold: number; // Default 0.85 (85%)\n\n  // Handoff triggers\n  idleTimeoutMinutes: number; // Default 5 minutes\n  sessionEndHandoff: boolean; // Default true\n\n  // Monitoring intervals\n  checkIntervalSeconds: number; // Default 30 seconds\n\n  // Auto actions\n  autoSaveLedger: boolean; // Default true\n  autoGenerateHandoff: boolean; // Default true\n  autoCompactOnThreshold: boolean; // Default false\n}\n\nexport class SessionMonitor extends EventEmitter {\n  private config: MonitorConfig;\n  private clearSurvival: ClearSurvival;\n  private handoffGenerator: HandoffGenerator;\n  private frameManager: FrameManager;\n  private dbManager: DatabaseManager;\n  private monitorInterval?: NodeJS.Timeout;\n  private lastActivityTime: Date;\n  private isMonitoring: boolean = false;\n  private projectRoot: string;\n\n  // Track context state to avoid duplicate saves\n  private lastContextCheck: {\n    tokens: number;\n    percentage: number;\n    savedAt?: Date;\n  } = { tokens: 0, percentage: 0 };\n\n  constructor(\n    frameManager: FrameManager,\n    dbManager: DatabaseManager,\n    projectRoot: string,\n    config?: Partial<MonitorConfig>\n  ) {\n    super();\n\n    this.frameManager = frameManager;\n    this.dbManager = dbManager;\n    this.projectRoot = projectRoot;\n    this.lastActivityTime = new Date();\n\n    // Initialize config with defaults\n    this.config = {\n      contextWarningThreshold: 0.6,\n      contextCriticalThreshold: 0.7,\n      contextAutoSaveThreshold: 0.85,\n      idleTimeoutMinutes: 5,\n      sessionEndHandoff: true,\n      checkIntervalSeconds: 30,\n      autoSaveLedger: true,\n      autoGenerateHandoff: true,\n      autoCompactOnThreshold: false,\n      ...config,\n    };\n\n    // Initialize components\n    this.clearSurvival = new ClearSurvival(\n      frameManager,\n      dbManager,\n      new HandoffGenerator(frameManager, dbManager, projectRoot),\n      projectRoot\n    );\n\n    this.handoffGenerator = new HandoffGenerator(\n      frameManager,\n      dbManager,\n      projectRoot\n    );\n  }\n\n  /**\n   * Start monitoring session\n   */\n  async start(): Promise<void> {\n    if (this.isMonitoring) return;\n\n    this.isMonitoring = true;\n    this.lastActivityTime = new Date();\n\n    // Start monitoring loop\n    this.monitorInterval = setInterval(\n      () => this.checkSession(),\n      this.config.checkIntervalSeconds * 1000\n    );\n\n    // Register exit handlers\n    this.registerExitHandlers();\n\n    this.emit('monitor:started');\n    console.log('\uD83D\uDD0D Session monitor started');\n  }\n\n  /**\n   * Stop monitoring\n   */\n  async stop(): Promise<void> {\n    if (!this.isMonitoring) return;\n\n    this.isMonitoring = false;\n\n    if (this.monitorInterval) {\n      clearInterval(this.monitorInterval);\n      this.monitorInterval = undefined;\n    }\n\n    // Generate final handoff if configured\n    if (this.config.sessionEndHandoff) {\n      await this.generateHandoff('session_end');\n    }\n\n    this.emit('monitor:stopped');\n    console.log('\uD83D\uDED1 Session monitor stopped');\n  }\n\n  /**\n   * Main monitoring check\n   */\n  private async checkSession(): Promise<void> {\n    try {\n      // Check context usage\n      await this.checkContextUsage();\n\n      // Check for idle timeout\n      await this.checkIdleTimeout();\n\n      // Check for other triggers\n      await this.checkCustomTriggers();\n    } catch (error: unknown) {\n      console.error('Monitor check failed:', error);\n      this.emit('monitor:error', error);\n    }\n  }\n\n  /**\n   * Check context usage and trigger actions\n   */\n  private async checkContextUsage(): Promise<void> {\n    const currentTokens = await this.estimateTokens();\n    const maxTokens = 100000; // Claude's approximate limit\n    const percentage = currentTokens / maxTokens;\n\n    // Store for comparison\n    this.lastContextCheck = {\n      tokens: currentTokens,\n      percentage,\n      savedAt: this.lastContextCheck.savedAt,\n    };\n\n    // Emit usage update\n    this.emit('context:usage', {\n      tokens: currentTokens,\n      maxTokens,\n      percentage,\n      status: this.getContextStatus(percentage),\n    });\n\n    // Check thresholds and take action\n    if (percentage >= this.config.contextAutoSaveThreshold) {\n      await this.handleCriticalContext();\n    } else if (percentage >= this.config.contextCriticalThreshold) {\n      await this.handleHighContext();\n    } else if (percentage >= this.config.contextWarningThreshold) {\n      this.handleWarningContext();\n    }\n  }\n\n  /**\n   * Handle critical context (>85%)\n   */\n  private async handleCriticalContext(): Promise<void> {\n    // Avoid duplicate saves within 5 minutes\n    if (this.lastContextCheck.savedAt) {\n      const minsSinceLastSave =\n        (Date.now() - this.lastContextCheck.savedAt.getTime()) / 60000;\n      if (minsSinceLastSave < 5) return;\n    }\n\n    console.log('\uD83D\uDD34 Critical context usage - auto-saving ledger');\n\n    if (this.config.autoSaveLedger) {\n      const ledger = await this.clearSurvival.saveContinuityLedger();\n      this.lastContextCheck.savedAt = new Date();\n\n      this.emit('context:ledger_saved', {\n        compression: ledger.compression_ratio,\n        frames: ledger.active_frame_stack.length,\n        tasks: ledger.active_tasks.length,\n      });\n\n      // Suggest clear\n      console.log('\uD83D\uDCA1 Ledger saved. Run /clear to reset context');\n\n      if (this.config.autoCompactOnThreshold) {\n        // This would trigger actual compaction\n        // For now, just emit event for external handling\n        this.emit('context:suggest_clear');\n      }\n    }\n  }\n\n  /**\n   * Handle high context (70-85%)\n   */\n  private async handleHighContext(): Promise<void> {\n    console.log('\u26A0\uFE0F High context usage - consider saving ledger');\n\n    this.emit('context:high', {\n      percentage: this.lastContextCheck.percentage,\n      suggestion: 'Run: stackmemory clear --save',\n    });\n  }\n\n  /**\n   * Handle warning context (60-70%)\n   */\n  private handleWarningContext(): void {\n    this.emit('context:warning', {\n      percentage: this.lastContextCheck.percentage,\n    });\n  }\n\n  /**\n   * Check for idle timeout\n   */\n  private async checkIdleTimeout(): Promise<void> {\n    const idleMinutes = (Date.now() - this.lastActivityTime.getTime()) / 60000;\n\n    if (idleMinutes >= this.config.idleTimeoutMinutes) {\n      if (this.config.autoGenerateHandoff) {\n        await this.generateHandoff('idle_timeout');\n      }\n    }\n  }\n\n  /**\n   * Generate handoff document\n   */\n  private async generateHandoff(trigger: string): Promise<void> {\n    try {\n      const sessionId = await this.dbManager.getCurrentSessionId();\n      const handoff = await this.handoffGenerator.generateHandoff(sessionId);\n\n      this.emit('handoff:generated', {\n        trigger,\n        sessionDuration: handoff.session_duration_minutes,\n        tasksActive: handoff.active_tasks.filter(\n          (t) => t.status !== 'completed'\n        ).length,\n      });\n\n      console.log(`\uD83D\uDCCB Handoff generated (trigger: ${trigger})`);\n    } catch (error: unknown) {\n      console.error('Failed to generate handoff:', error);\n    }\n  }\n\n  /**\n   * Register process exit handlers\n   */\n  private registerExitHandlers(): void {\n    const exitHandler = async (signal: string) => {\n      console.log(`\\n\uD83D\uDCE6 Received ${signal}, saving session state...`);\n\n      try {\n        // Save ledger if context is significant\n        if (this.lastContextCheck.percentage > 0.3) {\n          await this.clearSurvival.saveContinuityLedger();\n          console.log('\u2705 Continuity ledger saved');\n        }\n\n        // Generate handoff\n        if (this.config.sessionEndHandoff) {\n          await this.generateHandoff('process_exit');\n          console.log('\u2705 Handoff document generated');\n        }\n      } catch (error: unknown) {\n        console.error('Error during exit handling:', error);\n      } finally {\n        process.exit(0);\n      }\n    };\n\n    // Handle various exit signals\n    process.once('SIGINT', () => exitHandler('SIGINT'));\n    process.once('SIGTERM', () => exitHandler('SIGTERM'));\n    process.once('beforeExit', () => exitHandler('beforeExit'));\n  }\n\n  /**\n   * Update last activity time\n   */\n  updateActivity(): void {\n    this.lastActivityTime = new Date();\n  }\n\n  /**\n   * Check custom triggers (extensible)\n   */\n  private async checkCustomTriggers(): Promise<void> {\n    // Load custom triggers from hooks directory\n    const hooksDir = path.join(this.projectRoot, '.stackmemory', 'hooks');\n\n    try {\n      await fs.access(hooksDir);\n      const hooks = await fs.readdir(hooksDir);\n\n      for (const hook of hooks) {\n        if (hook.startsWith('monitor_') && hook.endsWith('.js')) {\n          try {\n            const hookPath = path.join(hooksDir, hook);\n            const hookModule = await import(hookPath);\n\n            if (hookModule.check) {\n              const shouldTrigger = await hookModule.check({\n                contextPercentage: this.lastContextCheck.percentage,\n                idleMinutes:\n                  (Date.now() - this.lastActivityTime.getTime()) / 60000,\n                frameCount: (await this.frameManager.getStack()).frames.length,\n              });\n\n              if (shouldTrigger && hookModule.action) {\n                await hookModule.action({\n                  clearSurvival: this.clearSurvival,\n                  handoffGenerator: this.handoffGenerator,\n                  frameManager: this.frameManager,\n                });\n              }\n            }\n          } catch (error: unknown) {\n            console.error(`Hook ${hook} failed:`, error);\n          }\n        }\n      }\n    } catch {\n      // No hooks directory\n    }\n  }\n\n  /**\n   * Estimate current token usage\n   */\n  private async estimateTokens(): Promise<number> {\n    const sessionId = await this.dbManager.getCurrentSessionId();\n    const frames = await this.dbManager.getRecentFrames(sessionId, 100);\n    const traces = await this.dbManager.getRecentTraces(sessionId, 100);\n\n    // Rough estimation\n    return frames.length * 200 + traces.length * 100;\n  }\n\n  /**\n   * Get context status based on percentage\n   */\n  private getContextStatus(percentage: number): string {\n    if (percentage >= this.config.contextAutoSaveThreshold) return 'critical';\n    if (percentage >= this.config.contextCriticalThreshold) return 'high';\n    if (percentage >= this.config.contextWarningThreshold) return 'warning';\n    return 'ok';\n  }\n\n  /**\n   * Get current monitor status\n   */\n  getStatus(): {\n    isMonitoring: boolean;\n    lastActivity: Date;\n    contextUsage: typeof this.lastContextCheck;\n    config: MonitorConfig;\n  } {\n    return {\n      isMonitoring: this.isMonitoring,\n      lastActivity: this.lastActivityTime,\n      contextUsage: this.lastContextCheck,\n      config: this.config,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<MonitorConfig>): void {\n    this.config = { ...this.config, ...config };\n    this.emit('config:updated', this.config);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/performance/context-cache.js

@@ -0,0 +1,273 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { EventEmitter } from "events";
+import { logger } from "../monitoring/logger.js";
+class ContextCache extends EventEmitter {
+  cache = /* @__PURE__ */ new Map();
+  accessOrder = [];
+  options;
+  stats;
+  currentSize = 0;
+  constructor(options = {}) {
+    super();
+    this.options = {
+      maxSize: options.maxSize || 100 * 1024 * 1024,
+      // 100MB default
+      maxItems: options.maxItems || 1e4,
+      defaultTTL: options.defaultTTL || 36e5,
+      // 1 hour default
+      enableStats: options.enableStats ?? true,
+      onEvict: options.onEvict || (() => {
+      })
+    };
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      evictions: 0,
+      size: 0,
+      itemCount: 0,
+      hitRate: 0,
+      avgAccessTime: 0
+    };
+  }
+  /**
+   * Get item from cache
+   */
+  get(key) {
+    const startTime = Date.now();
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+      this.delete(key);
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    entry.hits++;
+    entry.lastAccessed = Date.now();
+    this.updateAccessOrder(key);
+    this.stats.hits++;
+    this.updateHitRate();
+    this.updateAvgAccessTime(Date.now() - startTime);
+    return entry.value;
+  }
+  /**
+   * Set item in cache
+   */
+  set(key, value, options = {}) {
+    const size = options.size || this.estimateSize(value);
+    const ttl = options.ttl ?? this.options.defaultTTL;
+    if (this.cache.size >= this.options.maxItems || this.currentSize + size > this.options.maxSize) {
+      this.evict(size);
+    }
+    if (this.cache.has(key)) {
+      this.delete(key);
+    }
+    const entry = {
+      value,
+      size,
+      hits: 0,
+      createdAt: Date.now(),
+      lastAccessed: Date.now(),
+      ttl
+    };
+    this.cache.set(key, entry);
+    this.accessOrder.push(key);
+    this.currentSize += size;
+    this.stats.size = this.currentSize;
+    this.stats.itemCount = this.cache.size;
+    this.emit("set", key, value);
+  }
+  /**
+   * Delete item from cache
+   */
+  delete(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    this.cache.delete(key);
+    this.currentSize -= entry.size;
+    this.accessOrder = this.accessOrder.filter((k) => k !== key);
+    this.stats.size = this.currentSize;
+    this.stats.itemCount = this.cache.size;
+    this.emit("delete", key);
+    return true;
+  }
+  /**
+   * Clear entire cache
+   */
+  clear() {
+    const oldSize = this.cache.size;
+    this.cache.clear();
+    this.accessOrder = [];
+    this.currentSize = 0;
+    this.stats.size = 0;
+    this.stats.itemCount = 0;
+    this.stats.evictions += oldSize;
+    this.emit("clear");
+  }
+  /**
+   * Check if key exists and is valid
+   */
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+      this.delete(key);
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Get cache statistics
+   */
+  getStats() {
+    return { ...this.stats };
+  }
+  /**
+   * Get cache size info
+   */
+  getSize() {
+    return {
+      bytes: this.currentSize,
+      items: this.cache.size,
+      utilization: this.currentSize / this.options.maxSize
+    };
+  }
+  /**
+   * Preload multiple items
+   */
+  preload(entries) {
+    const startTime = Date.now();
+    for (const entry of entries) {
+      this.set(entry.key, entry.value, {
+        ttl: entry.ttl,
+        size: entry.size
+      });
+    }
+    logger.debug("Cache preload complete", {
+      items: entries.length,
+      duration: Date.now() - startTime,
+      cacheSize: this.currentSize
+    });
+  }
+  /**
+   * Get multiple items efficiently
+   */
+  getMany(keys) {
+    const results = /* @__PURE__ */ new Map();
+    for (const key of keys) {
+      const value = this.get(key);
+      if (value !== void 0) {
+        results.set(key, value);
+      }
+    }
+    return results;
+  }
+  /**
+   * Warm cache with computed values
+   */
+  async warmUp(keys, compute, options = {}) {
+    const { parallel = true } = options;
+    if (parallel) {
+      const promises = keys.map(async (key) => {
+        if (!this.has(key)) {
+          const value = await compute(key);
+          this.set(key, value, { ttl: options.ttl });
+        }
+      });
+      await Promise.all(promises);
+    } else {
+      for (const key of keys) {
+        if (!this.has(key)) {
+          const value = await compute(key);
+          this.set(key, value, { ttl: options.ttl });
+        }
+      }
+    }
+  }
+  /**
+   * Get or compute value
+   */
+  async getOrCompute(key, compute, options = {}) {
+    const cached = this.get(key);
+    if (cached !== void 0) {
+      return cached;
+    }
+    const value = await compute();
+    this.set(key, value, options);
+    return value;
+  }
+  // Private methods
+  evict(requiredSize) {
+    const startEvictions = this.stats.evictions;
+    while ((this.cache.size >= this.options.maxItems || this.currentSize + requiredSize > this.options.maxSize) && this.accessOrder.length > 0) {
+      const keyToEvict = this.accessOrder.shift();
+      const entry = this.cache.get(keyToEvict);
+      if (entry) {
+        this.cache.delete(keyToEvict);
+        this.currentSize -= entry.size;
+        this.stats.evictions++;
+        this.options.onEvict(keyToEvict, entry);
+        this.emit("evict", keyToEvict, entry);
+      }
+    }
+    if (this.stats.evictions > startEvictions) {
+      logger.debug("Cache eviction", {
+        evicted: this.stats.evictions - startEvictions,
+        currentSize: this.currentSize,
+        requiredSize
+      });
+    }
+  }
+  updateAccessOrder(key) {
+    const index = this.accessOrder.indexOf(key);
+    if (index > -1) {
+      this.accessOrder.splice(index, 1);
+    }
+    this.accessOrder.push(key);
+  }
+  estimateSize(value) {
+    if (typeof value === "string") {
+      return value.length * 2;
+    }
+    if (typeof value === "object" && value !== null) {
+      return JSON.stringify(value).length * 2;
+    }
+    return 8;
+  }
+  updateHitRate() {
+    const total = this.stats.hits + this.stats.misses;
+    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+  }
+  updateAvgAccessTime(time) {
+    const alpha = 0.1;
+    this.stats.avgAccessTime = this.stats.avgAccessTime * (1 - alpha) + time * alpha;
+  }
+  /**
+   * Cleanup expired entries periodically
+   */
+  startCleanup(intervalMs = 6e4) {
+    return setInterval(() => {
+      let cleaned = 0;
+      for (const [key, entry] of this.cache.entries()) {
+        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+          this.delete(key);
+          cleaned++;
+        }
+      }
+      if (cleaned > 0) {
+        logger.debug("Cache cleanup", { cleaned, remaining: this.cache.size });
+      }
+    }, intervalMs);
+  }
+}
+export {
+  ContextCache
+};
+//# sourceMappingURL=context-cache.js.map

package/dist/src/core/performance/context-cache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/performance/context-cache.ts"],
+  "sourcesContent": ["/**\n * High-Performance Context Cache\n * LRU cache with TTL for frequently accessed context data\n */\n\nimport { EventEmitter } from 'events';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface CacheEntry<T> {\n  value: T;\n  size: number;\n  hits: number;\n  createdAt: number;\n  lastAccessed: number;\n  ttl?: number;\n}\n\nexport interface CacheStats {\n  hits: number;\n  misses: number;\n  evictions: number;\n  size: number;\n  itemCount: number;\n  hitRate: number;\n  avgAccessTime: number;\n}\n\nexport interface CacheOptions {\n  maxSize?: number; // Max memory in bytes\n  maxItems?: number; // Max number of items\n  defaultTTL?: number; // Default TTL in ms\n  enableStats?: boolean;\n  onEvict?: (key: string, entry: CacheEntry<any>) => void;\n}\n\nexport class ContextCache<T = any> extends EventEmitter {\n  private cache = new Map<string, CacheEntry<T>>();\n  private accessOrder: string[] = [];\n  private options: Required<CacheOptions>;\n  private stats: CacheStats;\n  private currentSize = 0;\n\n  constructor(options: CacheOptions = {}) {\n    super();\n    this.options = {\n      maxSize: options.maxSize || 100 * 1024 * 1024, // 100MB default\n      maxItems: options.maxItems || 10000,\n      defaultTTL: options.defaultTTL || 3600000, // 1 hour default\n      enableStats: options.enableStats ?? true,\n      onEvict: options.onEvict || (() => {}),\n    };\n\n    this.stats = {\n      hits: 0,\n      misses: 0,\n      evictions: 0,\n      size: 0,\n      itemCount: 0,\n      hitRate: 0,\n      avgAccessTime: 0,\n    };\n  }\n\n  /**\n   * Get item from cache\n   */\n  get(key: string): T | undefined {\n    const startTime = Date.now();\n    const entry = this.cache.get(key);\n\n    if (!entry) {\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    // Check TTL\n    if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {\n      this.delete(key);\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    // Update access tracking\n    entry.hits++;\n    entry.lastAccessed = Date.now();\n    this.updateAccessOrder(key);\n\n    this.stats.hits++;\n    this.updateHitRate();\n    this.updateAvgAccessTime(Date.now() - startTime);\n\n    return entry.value;\n  }\n\n  /**\n   * Set item in cache\n   */\n  set(\n    key: string,\n    value: T,\n    options: { ttl?: number; size?: number } = {}\n  ): void {\n    const size = options.size || this.estimateSize(value);\n    const ttl = options.ttl ?? this.options.defaultTTL;\n\n    // Check if we need to evict\n    if (\n      this.cache.size >= this.options.maxItems ||\n      this.currentSize + size > this.options.maxSize\n    ) {\n      this.evict(size);\n    }\n\n    // Remove old entry if exists\n    if (this.cache.has(key)) {\n      this.delete(key);\n    }\n\n    const entry: CacheEntry<T> = {\n      value,\n      size,\n      hits: 0,\n      createdAt: Date.now(),\n      lastAccessed: Date.now(),\n      ttl,\n    };\n\n    this.cache.set(key, entry);\n    this.accessOrder.push(key);\n    this.currentSize += size;\n    this.stats.size = this.currentSize;\n    this.stats.itemCount = this.cache.size;\n\n    this.emit('set', key, value);\n  }\n\n  /**\n   * Delete item from cache\n   */\n  delete(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    this.cache.delete(key);\n    this.currentSize -= entry.size;\n    this.accessOrder = this.accessOrder.filter((k: any) => k !== key);\n\n    this.stats.size = this.currentSize;\n    this.stats.itemCount = this.cache.size;\n\n    this.emit('delete', key);\n    return true;\n  }\n\n  /**\n   * Clear entire cache\n   */\n  clear(): void {\n    const oldSize = this.cache.size;\n    this.cache.clear();\n    this.accessOrder = [];\n    this.currentSize = 0;\n\n    this.stats.size = 0;\n    this.stats.itemCount = 0;\n    this.stats.evictions += oldSize;\n\n    this.emit('clear');\n  }\n\n  /**\n   * Check if key exists and is valid\n   */\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    // Check TTL\n    if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {\n      this.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats(): CacheStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Get cache size info\n   */\n  getSize(): { bytes: number; items: number; utilization: number } {\n    return {\n      bytes: this.currentSize,\n      items: this.cache.size,\n      utilization: this.currentSize / this.options.maxSize,\n    };\n  }\n\n  /**\n   * Preload multiple items\n   */\n  preload(\n    entries: Array<{ key: string; value: T; ttl?: number; size?: number }>\n  ): void {\n    const startTime = Date.now();\n\n    for (const entry of entries) {\n      this.set(entry.key, entry.value, {\n        ttl: entry.ttl,\n        size: entry.size,\n      });\n    }\n\n    logger.debug('Cache preload complete', {\n      items: entries.length,\n      duration: Date.now() - startTime,\n      cacheSize: this.currentSize,\n    });\n  }\n\n  /**\n   * Get multiple items efficiently\n   */\n  getMany(keys: string[]): Map<string, T> {\n    const results = new Map<string, T>();\n\n    for (const key of keys) {\n      const value = this.get(key);\n      if (value !== undefined) {\n        results.set(key, value);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Warm cache with computed values\n   */\n  async warmUp(\n    keys: string[],\n    compute: (key: string) => Promise<T>,\n    options: { ttl?: number; parallel?: boolean } = {}\n  ): Promise<void> {\n    const { parallel = true } = options;\n\n    if (parallel) {\n      const promises = keys.map(async (key) => {\n        if (!this.has(key)) {\n          const value = await compute(key);\n          this.set(key, value, { ttl: options.ttl });\n        }\n      });\n      await Promise.all(promises);\n    } else {\n      for (const key of keys) {\n        if (!this.has(key)) {\n          const value = await compute(key);\n          this.set(key, value, { ttl: options.ttl });\n        }\n      }\n    }\n  }\n\n  /**\n   * Get or compute value\n   */\n  async getOrCompute(\n    key: string,\n    compute: () => Promise<T>,\n    options: { ttl?: number; size?: number } = {}\n  ): Promise<T> {\n    const cached = this.get(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const value = await compute();\n    this.set(key, value, options);\n    return value;\n  }\n\n  // Private methods\n\n  private evict(requiredSize: number): void {\n    const startEvictions = this.stats.evictions;\n\n    // LRU eviction\n    while (\n      (this.cache.size >= this.options.maxItems ||\n        this.currentSize + requiredSize > this.options.maxSize) &&\n      this.accessOrder.length > 0\n    ) {\n      const keyToEvict = this.accessOrder.shift()!;\n      const entry = this.cache.get(keyToEvict);\n\n      if (entry) {\n        this.cache.delete(keyToEvict);\n        this.currentSize -= entry.size;\n        this.stats.evictions++;\n        this.options.onEvict(keyToEvict, entry);\n        this.emit('evict', keyToEvict, entry);\n      }\n    }\n\n    if (this.stats.evictions > startEvictions) {\n      logger.debug('Cache eviction', {\n        evicted: this.stats.evictions - startEvictions,\n        currentSize: this.currentSize,\n        requiredSize,\n      });\n    }\n  }\n\n  private updateAccessOrder(key: string): void {\n    const index = this.accessOrder.indexOf(key);\n    if (index > -1) {\n      this.accessOrder.splice(index, 1);\n    }\n    this.accessOrder.push(key);\n  }\n\n  private estimateSize(value: T): number {\n    // Simple size estimation - can be overridden for specific types\n    if (typeof value === 'string') {\n      return value.length * 2; // UTF-16\n    }\n    if (typeof value === 'object' && value !== null) {\n      return JSON.stringify(value).length * 2;\n    }\n    return 8; // Default for primitives\n  }\n\n  private updateHitRate(): void {\n    const total = this.stats.hits + this.stats.misses;\n    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;\n  }\n\n  private updateAvgAccessTime(time: number): void {\n    const alpha = 0.1; // Exponential moving average factor\n    this.stats.avgAccessTime =\n      this.stats.avgAccessTime * (1 - alpha) + time * alpha;\n  }\n\n  /**\n   * Cleanup expired entries periodically\n   */\n  startCleanup(intervalMs: number = 60000): NodeJS.Timeout {\n    return setInterval(() => {\n      let cleaned = 0;\n      for (const [key, entry] of this.cache.entries()) {\n        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {\n          this.delete(key);\n          cleaned++;\n        }\n      }\n      if (cleaned > 0) {\n        logger.debug('Cache cleanup', { cleaned, remaining: this.cache.size });\n      }\n    }, intervalMs);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/performance/index.js

@@ -0,0 +1,11 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { PerformanceMonitor } from "./monitor.js";
+import { PerformanceBenchmark } from "./performance-benchmark.js";
+export {
+  PerformanceBenchmark,
+  PerformanceMonitor
+};
+//# sourceMappingURL=index.js.map

package/dist/src/core/performance/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/performance/index.ts"],
+  "sourcesContent": ["export { PerformanceMonitor } from './monitor.js';\nexport { PerformanceBenchmark } from './performance-benchmark.js';\n"],
+  "mappings": ";;;;AAAA,SAAS,0BAA0B;AACnC,SAAS,4BAA4B;",
+  "names": []
+}