@stackmemoryai/stackmemory 0.3.8 → 0.3.10

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

@@ -7,6 +7,8 @@ import {
   ErrorCode
 } from "../errors/index.js";
 import { FrameQueryMode } from "../session/index.js";
+const MAX_FRAME_DEPTH = 100;
+const DEFAULT_MAX_DEPTH = 100;
 import { FrameDatabase } from "./frame-database.js";
 import { FrameStack } from "./frame-stack.js";
 import { FrameDigestGenerator } from "./frame-digest.js";
@@ -19,6 +21,7 @@ class RefactoredFrameManager {
   projectId;
   queryMode = FrameQueryMode.PROJECT_ACTIVE;
   config;
+  maxFrameDepth = DEFAULT_MAX_DEPTH;
   constructor(db, projectId, config) {
     this.projectId = projectId;
     this.config = {
@@ -27,6 +30,7 @@ class RefactoredFrameManager {
       sessionId: config?.sessionId || uuidv4(),
       maxStackDepth: config?.maxStackDepth || 50
     };
+    this.maxFrameDepth = config?.maxStackDepth || DEFAULT_MAX_DEPTH;
     this.currentRunId = this.config.runId;
     this.sessionId = this.config.sessionId;
     this.frameDb = new FrameDatabase(db);
@@ -96,7 +100,37 @@ class RefactoredFrameManager {
       );
     }
     const resolvedParentId = frameOptions.parentFrameId || this.frameStack.getCurrentFrameId();
-    const depth = resolvedParentId ? this.frameStack.getFrameStackDepth(resolvedParentId) + 1 : 0;
+    let depth = 0;
+    if (resolvedParentId) {
+      const parentFrame = this.frameDb.getFrame(resolvedParentId);
+      depth = parentFrame ? parentFrame.depth + 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,
+          frameName: frameOptions.name,
+          parentFrameId: resolvedParentId
+        }
+      );
+    }
+    if (resolvedParentId) {
+      const cycle = this.detectCycle(uuidv4(), resolvedParentId);
+      if (cycle) {
+        throw new FrameError(
+          `Circular reference detected in frame hierarchy`,
+          ErrorCode.FRAME_CYCLE_DETECTED,
+          {
+            parentFrameId: resolvedParentId,
+            cycle,
+            frameName: frameOptions.name
+          }
+        );
+      }
+    }
     const frameId = uuidv4();
     const frame = {
       frame_id: frameId,
@@ -375,6 +409,151 @@ class RefactoredFrameManager {
     }
     return constraints;
   }
+  /**
+   * 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.frameDb.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 (null to make it a root frame)
+   */
+  updateParentFrame(frameId, newParentFrameId) {
+    const frame = this.frameDb.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.frameDb.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
+            }
+          );
+        }
+      }
+    }
+    this.frameDb.updateFrame(frameId, {
+      parent_frame_id: newParentFrameId
+    });
+    logger.info("Updated parent frame", {
+      frameId,
+      oldParentId: frame.parent_frame_id,
+      newParentId: newParentFrameId
+    });
+  }
+  /**
+   * Validate the entire frame hierarchy for cycles and depth violations
+   * @returns Validation result with any detected issues
+   */
+  validateFrameHierarchy() {
+    const errors = [];
+    const warnings = [];
+    const allFrames = this.frameDb.getFramesByProject(this.projectId);
+    for (const frame of allFrames) {
+      if (frame.depth > this.maxFrameDepth) {
+        errors.push(
+          `Frame ${frame.frame_id} exceeds max depth: ${frame.depth} > ${this.maxFrameDepth}`
+        );
+      }
+      if (frame.depth > this.maxFrameDepth * 0.8) {
+        warnings.push(
+          `Frame ${frame.frame_id} is deep in hierarchy: ${frame.depth}/${this.maxFrameDepth}`
+        );
+      }
+    }
+    const rootFrames = allFrames.filter((f) => !f.parent_frame_id);
+    const visited = /* @__PURE__ */ new Set();
+    const visiting = /* @__PURE__ */ new Set();
+    const checkForCycle = (frameId) => {
+      if (visiting.has(frameId)) {
+        errors.push(`Cycle detected involving frame ${frameId}`);
+        return true;
+      }
+      if (visited.has(frameId)) {
+        return false;
+      }
+      visiting.add(frameId);
+      const children = allFrames.filter((f) => f.parent_frame_id === frameId);
+      for (const child of children) {
+        if (checkForCycle(child.frame_id)) {
+          return true;
+        }
+      }
+      visiting.delete(frameId);
+      visited.add(frameId);
+      return false;
+    };
+    for (const root of rootFrames) {
+      checkForCycle(root.frame_id);
+    }
+    return {
+      isValid: errors.length === 0,
+      errors,
+      warnings
+    };
+  }
 }
 import {
   Frame as Frame2,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/context/refactored-frame-manager.ts"],
-  "sourcesContent": ["/**\n * Refactored Frame Manager - Modular Implementation\n * Main orchestrator that uses focused modules for frame management\n */\n\nimport Database from 'better-sqlite3';\nimport { v4 as uuidv4 } from 'uuid';\nimport { logger } from '../monitoring/logger.js';\nimport { trace } from '../trace/index.js';\nimport {\n  FrameError,\n  SystemError,\n  ErrorCode,\n  wrapError,\n  createErrorHandler,\n} from '../errors/index.js';\nimport { retry, withTimeout } from '../errors/recovery.js';\nimport { sessionManager, FrameQueryMode } from '../session/index.js';\n\n// Import refactored modules\nimport {\n  Frame,\n  FrameContext,\n  Anchor,\n  Event,\n  FrameType,\n  FrameState,\n  FrameCreationOptions,\n  FrameManagerConfig,\n  DigestResult,\n} from './frame-types.js';\nimport { FrameDatabase } from './frame-database.js';\nimport { FrameStack } from './frame-stack.js';\nimport { FrameDigestGenerator } from './frame-digest.js';\n\nexport class RefactoredFrameManager {\n  private frameDb: FrameDatabase;\n  private frameStack: FrameStack;\n  private digestGenerator: FrameDigestGenerator;\n\n  private currentRunId: string;\n  private sessionId: string;\n  private projectId: string;\n  private queryMode: FrameQueryMode = FrameQueryMode.PROJECT_ACTIVE;\n  private config: FrameManagerConfig;\n\n  constructor(\n    db: Database.Database,\n    projectId: string,\n    config?: Partial<FrameManagerConfig>\n  ) {\n    this.projectId = projectId;\n    this.config = {\n      projectId,\n      runId: config?.runId || uuidv4(),\n      sessionId: config?.sessionId || uuidv4(),\n      maxStackDepth: config?.maxStackDepth || 50,\n    };\n\n    this.currentRunId = this.config.runId!;\n    this.sessionId = this.config.sessionId!;\n\n    // Initialize modules\n    this.frameDb = new FrameDatabase(db);\n    this.frameStack = new FrameStack(\n      this.frameDb,\n      projectId,\n      this.currentRunId\n    );\n    this.digestGenerator = new FrameDigestGenerator(this.frameDb);\n\n    // Initialize database schema\n    this.frameDb.initSchema();\n\n    logger.info('RefactoredFrameManager initialized', {\n      projectId: this.projectId,\n      runId: this.currentRunId,\n      sessionId: this.sessionId,\n    });\n  }\n\n  /**\n   * Initialize the frame manager\n   */\n  async initialize(): Promise<void> {\n    try {\n      await this.frameStack.initialize();\n\n      logger.info('Frame manager initialization completed', {\n        stackDepth: this.frameStack.getDepth(),\n      });\n    } catch (error: unknown) {\n      throw new SystemError(\n        'Failed to initialize frame manager',\n        ErrorCode.SYSTEM_INIT_FAILED,\n        { projectId: this.projectId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Create a new frame\n   */\n  createFrame(options: FrameCreationOptions): string;\n  createFrame(\n    type: FrameType,\n    name: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string;\n  createFrame(\n    typeOrOptions: FrameType | FrameCreationOptions,\n    name?: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.createFrame',\n      { typeOrOptions, name },\n      () => this._createFrame(typeOrOptions, name, inputs, parentFrameId)\n    );\n  }\n\n  private _createFrame(\n    typeOrOptions: FrameType | FrameCreationOptions,\n    name?: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string {\n    let frameOptions: FrameCreationOptions;\n\n    // Handle both function signatures\n    if (typeof typeOrOptions === 'string') {\n      frameOptions = {\n        type: typeOrOptions,\n        name: name!,\n        inputs: inputs || {},\n        parentFrameId,\n      };\n    } else {\n      frameOptions = typeOrOptions;\n    }\n\n    // Validate inputs\n    if (!frameOptions.name || frameOptions.name.trim().length === 0) {\n      throw new FrameError(\n        'Frame name is required',\n        ErrorCode.FRAME_INVALID_INPUT,\n        { frameOptions }\n      );\n    }\n\n    // Check stack depth limit\n    if (this.frameStack.getDepth() >= this.config.maxStackDepth!) {\n      throw new FrameError(\n        `Maximum stack depth reached: ${this.config.maxStackDepth}`,\n        ErrorCode.FRAME_STACK_OVERFLOW,\n        { currentDepth: this.frameStack.getDepth() }\n      );\n    }\n\n    // Determine parent frame\n    const resolvedParentId =\n      frameOptions.parentFrameId || this.frameStack.getCurrentFrameId();\n    const depth = resolvedParentId\n      ? this.frameStack.getFrameStackDepth(resolvedParentId) + 1\n      : 0;\n\n    // Create frame data\n    const frameId = uuidv4();\n    const frame: Omit<Frame, 'created_at' | 'closed_at'> = {\n      frame_id: frameId,\n      run_id: this.currentRunId,\n      project_id: this.projectId,\n      parent_frame_id: resolvedParentId,\n      depth,\n      type: frameOptions.type,\n      name: frameOptions.name,\n      state: 'active',\n      inputs: frameOptions.inputs || {},\n      outputs: {},\n      digest_json: {},\n    };\n\n    // Insert into database\n    const createdFrame = this.frameDb.insertFrame(frame);\n\n    // Add to stack\n    this.frameStack.pushFrame(frameId);\n\n    logger.info('Created frame', {\n      frameId,\n      name: frameOptions.name,\n      type: frameOptions.type,\n      parentFrameId: resolvedParentId,\n      stackDepth: this.frameStack.getDepth(),\n    });\n\n    return frameId;\n  }\n\n  /**\n   * Close a frame and generate digest\n   */\n  closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    trace.traceSync(\n      'function',\n      'FrameManager.closeFrame',\n      { frameId, outputs },\n      () => this._closeFrame(frameId, outputs)\n    );\n  }\n\n  private _closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame to close',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          operation: 'closeFrame',\n          stackDepth: this.frameStack.getDepth(),\n        }\n      );\n    }\n\n    // Get frame details\n    const frame = this.frameDb.getFrame(targetFrameId);\n    if (!frame) {\n      throw new FrameError(\n        `Frame not found: ${targetFrameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        {\n          frameId: targetFrameId,\n          operation: 'closeFrame',\n          runId: this.currentRunId,\n        }\n      );\n    }\n\n    if (frame.state === 'closed') {\n      logger.warn('Attempted to close already closed frame', {\n        frameId: targetFrameId,\n      });\n      return;\n    }\n\n    // Generate digest before closing\n    const digest = this.digestGenerator.generateDigest(targetFrameId);\n    const finalOutputs = { ...outputs, ...digest.structured };\n\n    // Update frame to closed state\n    this.frameDb.updateFrame(targetFrameId, {\n      state: 'closed',\n      outputs: finalOutputs,\n      digest_text: digest.text,\n      digest_json: digest.structured,\n      closed_at: Math.floor(Date.now() / 1000),\n    });\n\n    // Remove from stack (this will also remove any child frames)\n    this.frameStack.popFrame(targetFrameId);\n\n    // Close all child frames recursively\n    this.closeChildFrames(targetFrameId);\n\n    logger.info('Closed frame', {\n      frameId: targetFrameId,\n      name: frame.name,\n      duration: Math.floor(Date.now() / 1000) - frame.created_at,\n      digestLength: digest.text.length,\n      stackDepth: this.frameStack.getDepth(),\n    });\n  }\n\n  /**\n   * Add an event to the current frame\n   */\n  addEvent(\n    eventType: Event['event_type'],\n    payload: Record<string, any>,\n    frameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.addEvent',\n      { eventType, frameId },\n      () => this._addEvent(eventType, payload, frameId)\n    );\n  }\n\n  private _addEvent(\n    eventType: Event['event_type'],\n    payload: Record<string, any>,\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for event',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          eventType,\n          operation: 'addEvent',\n        }\n      );\n    }\n\n    const eventId = uuidv4();\n    const sequence = this.frameDb.getNextEventSequence(targetFrameId);\n\n    const event: Omit<Event, 'ts'> = {\n      event_id: eventId,\n      frame_id: targetFrameId,\n      run_id: this.currentRunId,\n      seq: sequence,\n      event_type: eventType,\n      payload,\n    };\n\n    const createdEvent = this.frameDb.insertEvent(event);\n\n    logger.debug('Added event', {\n      eventId,\n      frameId: targetFrameId,\n      eventType,\n      sequence,\n    });\n\n    return eventId;\n  }\n\n  /**\n   * Add an anchor (important fact) to current frame\n   */\n  addAnchor(\n    type: Anchor['type'],\n    text: string,\n    priority: number = 5,\n    metadata: Record<string, any> = {},\n    frameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.addAnchor',\n      { type, frameId },\n      () => this._addAnchor(type, text, priority, metadata, frameId)\n    );\n  }\n\n  private _addAnchor(\n    type: Anchor['type'],\n    text: string,\n    priority: number,\n    metadata: Record<string, any>,\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for anchor',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          anchorType: type,\n          operation: 'addAnchor',\n        }\n      );\n    }\n\n    const anchorId = uuidv4();\n    const anchor: Omit<Anchor, 'created_at'> = {\n      anchor_id: anchorId,\n      frame_id: targetFrameId,\n      type,\n      text,\n      priority,\n      metadata,\n    };\n\n    const createdAnchor = this.frameDb.insertAnchor(anchor);\n\n    logger.debug('Added anchor', {\n      anchorId,\n      frameId: targetFrameId,\n      type,\n      priority,\n    });\n\n    return anchorId;\n  }\n\n  /**\n   * Get hot stack context\n   */\n  getHotStackContext(maxEvents: number = 20): FrameContext[] {\n    return this.frameStack.getHotStackContext(maxEvents);\n  }\n\n  /**\n   * Get active frame path (root to current)\n   */\n  getActiveFramePath(): Frame[] {\n    return this.frameStack.getStackFrames();\n  }\n\n  /**\n   * Get current frame ID\n   */\n  getCurrentFrameId(): string | undefined {\n    return this.frameStack.getCurrentFrameId();\n  }\n\n  /**\n   * Get stack depth\n   */\n  getStackDepth(): number {\n    return this.frameStack.getDepth();\n  }\n\n  /**\n   * Get frame by ID\n   */\n  getFrame(frameId: string): Frame | undefined {\n    return this.frameDb.getFrame(frameId);\n  }\n\n  /**\n   * Get frame events\n   */\n  getFrameEvents(frameId: string, limit?: number): Event[] {\n    return this.frameDb.getFrameEvents(frameId, limit);\n  }\n\n  /**\n   * Get frame anchors\n   */\n  getFrameAnchors(frameId: string): Anchor[] {\n    return this.frameDb.getFrameAnchors(frameId);\n  }\n\n  /**\n   * Generate digest for a frame\n   */\n  generateDigest(frameId: string): DigestResult {\n    return this.digestGenerator.generateDigest(frameId);\n  }\n\n  /**\n   * Validate stack consistency\n   */\n  validateStack(): { isValid: boolean; errors: string[] } {\n    return this.frameStack.validateStack();\n  }\n\n  /**\n   * Get database statistics\n   */\n  getStatistics(): Record<string, number> {\n    return this.frameDb.getStatistics();\n  }\n\n  /**\n   * Close all child frames recursively\n   */\n  private closeChildFrames(parentFrameId: string): void {\n    try {\n      const activeFrames = this.frameDb.getFramesByProject(\n        this.projectId,\n        'active'\n      );\n      const childFrames = activeFrames.filter(\n        (f: any) => f.parent_frame_id === parentFrameId\n      );\n\n      for (const childFrame of childFrames) {\n        if (this.frameStack.isFrameActive(childFrame.frame_id)) {\n          this.closeFrame(childFrame.frame_id);\n        }\n      }\n    } catch (error: unknown) {\n      logger.warn('Failed to close child frames', { parentFrameId, error });\n    }\n  }\n\n  /**\n   * Extract active artifacts from frame events\n   */\n  getActiveArtifacts(frameId: string): string[] {\n    const events = this.frameDb.getFrameEvents(frameId);\n    const artifacts: string[] = [];\n\n    for (const event of events) {\n      if (event.event_type === 'artifact' && event.payload.path) {\n        artifacts.push(event.payload.path);\n      }\n    }\n\n    return [...new Set(artifacts)];\n  }\n\n  /**\n   * Extract constraints from frame inputs\n   */\n  extractConstraints(inputs: Record<string, any>): string[] {\n    const constraints: string[] = [];\n\n    if (inputs.constraints && Array.isArray(inputs.constraints)) {\n      constraints.push(...inputs.constraints);\n    }\n\n    if (inputs.requirements && Array.isArray(inputs.requirements)) {\n      constraints.push(...inputs.requirements);\n    }\n\n    if (inputs.limitations && Array.isArray(inputs.limitations)) {\n      constraints.push(...inputs.limitations);\n    }\n\n    return constraints;\n  }\n}\n\n// Re-export types for compatibility\nexport {\n  Frame,\n  FrameContext,\n  Anchor,\n  Event,\n  FrameType,\n  FrameState,\n  FrameCreationOptions,\n  FrameManagerConfig,\n  DigestResult,\n} from './frame-types.js';\n"],
-  "mappings": "AAMA,SAAS,MAAM,cAAc;AAC7B,SAAS,cAAc;AACvB,SAAS,aAAa;AACtB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAyB,sBAAsB;AAc/C,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,4BAA4B;AAE9B,MAAM,uBAAuB;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAA4B,eAAe;AAAA,EAC3C;AAAA,EAER,YACE,IACA,WACA,QACA;AACA,SAAK,YAAY;AACjB,SAAK,SAAS;AAAA,MACZ;AAAA,MACA,OAAO,QAAQ,SAAS,OAAO;AAAA,MAC/B,WAAW,QAAQ,aAAa,OAAO;AAAA,MACvC,eAAe,QAAQ,iBAAiB;AAAA,IAC1C;AAEA,SAAK,eAAe,KAAK,OAAO;AAChC,SAAK,YAAY,KAAK,OAAO;AAG7B,SAAK,UAAU,IAAI,cAAc,EAAE;AACnC,SAAK,aAAa,IAAI;AAAA,MACpB,KAAK;AAAA,MACL;AAAA,MACA,KAAK;AAAA,IACP;AACA,SAAK,kBAAkB,IAAI,qBAAqB,KAAK,OAAO;AAG5D,SAAK,QAAQ,WAAW;AAExB,WAAO,KAAK,sCAAsC;AAAA,MAChD,WAAW,KAAK;AAAA,MAChB,OAAO,KAAK;AAAA,MACZ,WAAW,KAAK;AAAA,IAClB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAA4B;AAChC,QAAI;AACF,YAAM,KAAK,WAAW,WAAW;AAEjC,aAAO,KAAK,0CAA0C;AAAA,QACpD,YAAY,KAAK,WAAW,SAAS;AAAA,MACvC,CAAC;AAAA,IACH,SAAS,OAAgB;AACvB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,UAAU;AAAA,QACV,EAAE,WAAW,KAAK,UAAU;AAAA,QAC5B,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AAAA,EAYA,YACE,eACA,MACA,QACA,eACQ;AACR,WAAO,MAAM;AAAA,MACX;AAAA,MACA;AAAA,MACA,EAAE,eAAe,KAAK;AAAA,MACtB,MAAM,KAAK,aAAa,eAAe,MAAM,QAAQ,aAAa;AAAA,IACpE;AAAA,EACF;AAAA,EAEQ,aACN,eACA,MACA,QACA,eACQ;AACR,QAAI;AAGJ,QAAI,OAAO,kBAAkB,UAAU;AACrC,qBAAe;AAAA,QACb,MAAM;AAAA,QACN;AAAA,QACA,QAAQ,UAAU,CAAC;AAAA,QACnB;AAAA,MACF;AAAA,IACF,OAAO;AACL,qBAAe;AAAA,IACjB;AAGA,QAAI,CAAC,aAAa,QAAQ,aAAa,KAAK,KAAK,EAAE,WAAW,GAAG;AAC/D,YAAM,IAAI;AAAA,QACR;AAAA,QACA,UAAU;AAAA,QACV,EAAE,aAAa;AAAA,MACjB;AAAA,IACF;AAGA,QAAI,KAAK,WAAW,SAAS,KAAK,KAAK,OAAO,eAAgB;AAC5D,YAAM,IAAI;AAAA,QACR,gCAAgC,KAAK,OAAO,aAAa;AAAA,QACzD,UAAU;AAAA,QACV,EAAE,cAAc,KAAK,WAAW,SAAS,EAAE;AAAA,MAC7C;AAAA,IACF;AAGA,UAAM,mBACJ,aAAa,iBAAiB,KAAK,WAAW,kBAAkB;AAClE,UAAM,QAAQ,mBACV,KAAK,WAAW,mBAAmB,gBAAgB,IAAI,IACvD;AAGJ,UAAM,UAAU,OAAO;AACvB,UAAM,QAAiD;AAAA,MACrD,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,MACb,YAAY,KAAK;AAAA,MACjB,iBAAiB;AAAA,MACjB;AAAA,MACA,MAAM,aAAa;AAAA,MACnB,MAAM,aAAa;AAAA,MACnB,OAAO;AAAA,MACP,QAAQ,aAAa,UAAU,CAAC;AAAA,MAChC,SAAS,CAAC;AAAA,MACV,aAAa,CAAC;AAAA,IAChB;AAGA,UAAM,eAAe,KAAK,QAAQ,YAAY,KAAK;AAGnD,SAAK,WAAW,UAAU,OAAO;AAEjC,WAAO,KAAK,iBAAiB;AAAA,MAC3B;AAAA,MACA,MAAM,aAAa;AAAA,MACnB,MAAM,aAAa;AAAA,MACnB,eAAe;AAAA,MACf,YAAY,KAAK,WAAW,SAAS;AAAA,IACvC,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,SAAkB,SAAqC;AAChE,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,EAAE,SAAS,QAAQ;AAAA,MACnB,MAAM,KAAK,YAAY,SAAS,OAAO;AAAA,IACzC;AAAA,EACF;AAAA,EAEQ,YAAY,SAAkB,SAAqC;AACzE,UAAM,gBAAgB,WAAW,KAAK,WAAW,kBAAkB;AACnE,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,UAAU;AAAA,QACV;AAAA,UACE,WAAW;AAAA,UACX,YAAY,KAAK,WAAW,SAAS;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAGA,UAAM,QAAQ,KAAK,QAAQ,SAAS,aAAa;AACjD,QAAI,CAAC,OAAO;AACV,YAAM,IAAI;AAAA,QACR,oBAAoB,aAAa;AAAA,QACjC,UAAU;AAAA,QACV;AAAA,UACE,SAAS;AAAA,UACT,WAAW;AAAA,UACX,OAAO,KAAK;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAEA,QAAI,MAAM,UAAU,UAAU;AAC5B,aAAO,KAAK,2CAA2C;AAAA,QACrD,SAAS;AAAA,MACX,CAAC;AACD;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,gBAAgB,eAAe,aAAa;AAChE,UAAM,eAAe,EAAE,GAAG,SAAS,GAAG,OAAO,WAAW;AAGxD,SAAK,QAAQ,YAAY,eAAe;AAAA,MACtC,OAAO;AAAA,MACP,SAAS;AAAA,MACT,aAAa,OAAO;AAAA,MACpB,aAAa,OAAO;AAAA,MACpB,WAAW,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAAA,IACzC,CAAC;AAGD,SAAK,WAAW,SAAS,aAAa;AAGtC,SAAK,iBAAiB,aAAa;AAEnC,WAAO,KAAK,gBAAgB;AAAA,MAC1B,SAAS;AAAA,MACT,MAAM,MAAM;AAAA,MACZ,UAAU,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,IAAI,MAAM;AAAA,MAChD,cAAc,OAAO,KAAK;AAAA,MAC1B,YAAY,KAAK,WAAW,SAAS;AAAA,IACvC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,SACE,WACA,SACA,SACQ;AACR,WAAO,MAAM;AAAA,MACX;AAAA,MACA;AAAA,MACA,EAAE,WAAW,QAAQ;AAAA,MACrB,MAAM,KAAK,UAAU,WAAW,SAAS,OAAO;AAAA,IAClD;AAAA,EACF;AAAA,EAEQ,UACN,WACA,SACA,SACQ;AACR,UAAM,gBAAgB,WAAW,KAAK,WAAW,kBAAkB;AACnE,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,UAAU;AAAA,QACV;AAAA,UACE;AAAA,UACA,WAAW;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UAAU,OAAO;AACvB,UAAM,WAAW,KAAK,QAAQ,qBAAqB,aAAa;AAEhE,UAAM,QAA2B;AAAA,MAC/B,UAAU;AAAA,MACV,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,MACb,KAAK;AAAA,MACL,YAAY;AAAA,MACZ;AAAA,IACF;AAEA,UAAM,eAAe,KAAK,QAAQ,YAAY,KAAK;AAEnD,WAAO,MAAM,eAAe;AAAA,MAC1B;AAAA,MACA,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,UACE,MACA,MACA,WAAmB,GACnB,WAAgC,CAAC,GACjC,SACQ;AACR,WAAO,MAAM;AAAA,MACX;AAAA,MACA;AAAA,MACA,EAAE,MAAM,QAAQ;AAAA,MAChB,MAAM,KAAK,WAAW,MAAM,MAAM,UAAU,UAAU,OAAO;AAAA,IAC/D;AAAA,EACF;AAAA,EAEQ,WACN,MACA,MACA,UACA,UACA,SACQ;AACR,UAAM,gBAAgB,WAAW,KAAK,WAAW,kBAAkB;AACnE,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,UAAU;AAAA,QACV;AAAA,UACE,YAAY;AAAA,UACZ,WAAW;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,UAAM,WAAW,OAAO;AACxB,UAAM,SAAqC;AAAA,MACzC,WAAW;AAAA,MACX,UAAU;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,gBAAgB,KAAK,QAAQ,aAAa,MAAM;AAEtD,WAAO,MAAM,gBAAgB;AAAA,MAC3B;AAAA,MACA,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,YAAoB,IAAoB;AACzD,WAAO,KAAK,WAAW,mBAAmB,SAAS;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKA,qBAA8B;AAC5B,WAAO,KAAK,WAAW,eAAe;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAwC;AACtC,WAAO,KAAK,WAAW,kBAAkB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwB;AACtB,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,SAAoC;AAC3C,WAAO,KAAK,QAAQ,SAAS,OAAO;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,SAAiB,OAAyB;AACvD,WAAO,KAAK,QAAQ,eAAe,SAAS,KAAK;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,SAA2B;AACzC,WAAO,KAAK,QAAQ,gBAAgB,OAAO;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,SAA+B;AAC5C,WAAO,KAAK,gBAAgB,eAAe,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwD;AACtD,WAAO,KAAK,WAAW,cAAc;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwC;AACtC,WAAO,KAAK,QAAQ,cAAc;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKQ,iBAAiB,eAA6B;AACpD,QAAI;AACF,YAAM,eAAe,KAAK,QAAQ;AAAA,QAChC,KAAK;AAAA,QACL;AAAA,MACF;AACA,YAAM,cAAc,aAAa;AAAA,QAC/B,CAAC,MAAW,EAAE,oBAAoB;AAAA,MACpC;AAEA,iBAAW,cAAc,aAAa;AACpC,YAAI,KAAK,WAAW,cAAc,WAAW,QAAQ,GAAG;AACtD,eAAK,WAAW,WAAW,QAAQ;AAAA,QACrC;AAAA,MACF;AAAA,IACF,SAAS,OAAgB;AACvB,aAAO,KAAK,gCAAgC,EAAE,eAAe,MAAM,CAAC;AAAA,IACtE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,SAA2B;AAC5C,UAAM,SAAS,KAAK,QAAQ,eAAe,OAAO;AAClD,UAAM,YAAsB,CAAC;AAE7B,eAAW,SAAS,QAAQ;AAC1B,UAAI,MAAM,eAAe,cAAc,MAAM,QAAQ,MAAM;AACzD,kBAAU,KAAK,MAAM,QAAQ,IAAI;AAAA,MACnC;AAAA,IACF;AAEA,WAAO,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,QAAuC;AACxD,UAAM,cAAwB,CAAC;AAE/B,QAAI,OAAO,eAAe,MAAM,QAAQ,OAAO,WAAW,GAAG;AAC3D,kBAAY,KAAK,GAAG,OAAO,WAAW;AAAA,IACxC;AAEA,QAAI,OAAO,gBAAgB,MAAM,QAAQ,OAAO,YAAY,GAAG;AAC7D,kBAAY,KAAK,GAAG,OAAO,YAAY;AAAA,IACzC;AAEA,QAAI,OAAO,eAAe,MAAM,QAAQ,OAAO,WAAW,GAAG;AAC3D,kBAAY,KAAK,GAAG,OAAO,WAAW;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AACF;AAGA;AAAA,EACE,SAAAA;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC;AAAA,EACA,aAAAC;AAAA,EACA,cAAAC;AAAA,EACA,wBAAAC;AAAA,EACA,sBAAAC;AAAA,EACA,gBAAAC;AAAA,OACK;",
+  "sourcesContent": ["/**\n * Refactored Frame Manager - Modular Implementation\n * Main orchestrator that uses focused modules for frame management\n */\n\nimport Database from 'better-sqlite3';\nimport { v4 as uuidv4 } from 'uuid';\nimport { logger } from '../monitoring/logger.js';\nimport { trace } from '../trace/index.js';\nimport {\n  FrameError,\n  SystemError,\n  ErrorCode,\n  wrapError,\n  createErrorHandler,\n} from '../errors/index.js';\nimport { retry, withTimeout } from '../errors/recovery.js';\nimport { sessionManager, FrameQueryMode } from '../session/index.js';\n\n// Constants for frame validation\nconst MAX_FRAME_DEPTH = 100; // Maximum allowed frame depth\nconst DEFAULT_MAX_DEPTH = 100; // Default if not configured\n\n// Import refactored modules\nimport {\n  Frame,\n  FrameContext,\n  Anchor,\n  Event,\n  FrameType,\n  FrameState,\n  FrameCreationOptions,\n  FrameManagerConfig,\n  DigestResult,\n} from './frame-types.js';\nimport { FrameDatabase } from './frame-database.js';\nimport { FrameStack } from './frame-stack.js';\nimport { FrameDigestGenerator } from './frame-digest.js';\n\nexport class RefactoredFrameManager {\n  private frameDb: FrameDatabase;\n  private frameStack: FrameStack;\n  private digestGenerator: FrameDigestGenerator;\n\n  private currentRunId: string;\n  private sessionId: string;\n  private projectId: string;\n  private queryMode: FrameQueryMode = FrameQueryMode.PROJECT_ACTIVE;\n  private config: FrameManagerConfig;\n  private maxFrameDepth: number = DEFAULT_MAX_DEPTH;\n\n  constructor(\n    db: Database.Database,\n    projectId: string,\n    config?: Partial<FrameManagerConfig>\n  ) {\n    this.projectId = projectId;\n    this.config = {\n      projectId,\n      runId: config?.runId || uuidv4(),\n      sessionId: config?.sessionId || uuidv4(),\n      maxStackDepth: config?.maxStackDepth || 50,\n    };\n    \n    // Set max frame depth from config if provided\n    this.maxFrameDepth = config?.maxStackDepth || DEFAULT_MAX_DEPTH;\n\n    this.currentRunId = this.config.runId!;\n    this.sessionId = this.config.sessionId!;\n\n    // Initialize modules\n    this.frameDb = new FrameDatabase(db);\n    this.frameStack = new FrameStack(\n      this.frameDb,\n      projectId,\n      this.currentRunId\n    );\n    this.digestGenerator = new FrameDigestGenerator(this.frameDb);\n\n    // Initialize database schema\n    this.frameDb.initSchema();\n\n    logger.info('RefactoredFrameManager initialized', {\n      projectId: this.projectId,\n      runId: this.currentRunId,\n      sessionId: this.sessionId,\n    });\n  }\n\n  /**\n   * Initialize the frame manager\n   */\n  async initialize(): Promise<void> {\n    try {\n      await this.frameStack.initialize();\n\n      logger.info('Frame manager initialization completed', {\n        stackDepth: this.frameStack.getDepth(),\n      });\n    } catch (error: unknown) {\n      throw new SystemError(\n        'Failed to initialize frame manager',\n        ErrorCode.SYSTEM_INIT_FAILED,\n        { projectId: this.projectId },\n        error instanceof Error ? error : undefined\n      );\n    }\n  }\n\n  /**\n   * Create a new frame\n   */\n  createFrame(options: FrameCreationOptions): string;\n  createFrame(\n    type: FrameType,\n    name: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string;\n  createFrame(\n    typeOrOptions: FrameType | FrameCreationOptions,\n    name?: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.createFrame',\n      { typeOrOptions, name },\n      () => this._createFrame(typeOrOptions, name, inputs, parentFrameId)\n    );\n  }\n\n  private _createFrame(\n    typeOrOptions: FrameType | FrameCreationOptions,\n    name?: string,\n    inputs?: Record<string, any>,\n    parentFrameId?: string\n  ): string {\n    let frameOptions: FrameCreationOptions;\n\n    // Handle both function signatures\n    if (typeof typeOrOptions === 'string') {\n      frameOptions = {\n        type: typeOrOptions,\n        name: name!,\n        inputs: inputs || {},\n        parentFrameId,\n      };\n    } else {\n      frameOptions = typeOrOptions;\n    }\n\n    // Validate inputs\n    if (!frameOptions.name || frameOptions.name.trim().length === 0) {\n      throw new FrameError(\n        'Frame name is required',\n        ErrorCode.FRAME_INVALID_INPUT,\n        { frameOptions }\n      );\n    }\n\n    // Check stack depth limit\n    if (this.frameStack.getDepth() >= this.config.maxStackDepth!) {\n      throw new FrameError(\n        `Maximum stack depth reached: ${this.config.maxStackDepth}`,\n        ErrorCode.FRAME_STACK_OVERFLOW,\n        { currentDepth: this.frameStack.getDepth() }\n      );\n    }\n\n    // Determine parent frame\n    const resolvedParentId =\n      frameOptions.parentFrameId || this.frameStack.getCurrentFrameId();\n    \n    // Get depth from parent frame, not from stack position\n    let depth = 0;\n    if (resolvedParentId) {\n      const parentFrame = this.frameDb.getFrame(resolvedParentId);\n      depth = parentFrame ? parentFrame.depth + 1 : 0;\n    }\n\n    // Check for depth limit\n    if (depth > this.maxFrameDepth) {\n      throw new FrameError(\n        `Maximum frame depth exceeded: ${depth} > ${this.maxFrameDepth}`,\n        ErrorCode.FRAME_STACK_OVERFLOW,\n        {\n          currentDepth: depth,\n          maxDepth: this.maxFrameDepth,\n          frameName: frameOptions.name,\n          parentFrameId: resolvedParentId,\n        }\n      );\n    }\n\n    // Check for circular reference before creating frame\n    if (resolvedParentId) {\n      const cycle = this.detectCycle(uuidv4(), resolvedParentId);\n      if (cycle) {\n        throw new FrameError(\n          `Circular reference detected in frame hierarchy`,\n          ErrorCode.FRAME_CYCLE_DETECTED,\n          {\n            parentFrameId: resolvedParentId,\n            cycle,\n            frameName: frameOptions.name,\n          }\n        );\n      }\n    }\n\n    // Create frame data\n    const frameId = uuidv4();\n    const frame: Omit<Frame, 'created_at' | 'closed_at'> = {\n      frame_id: frameId,\n      run_id: this.currentRunId,\n      project_id: this.projectId,\n      parent_frame_id: resolvedParentId,\n      depth,\n      type: frameOptions.type,\n      name: frameOptions.name,\n      state: 'active',\n      inputs: frameOptions.inputs || {},\n      outputs: {},\n      digest_json: {},\n    };\n\n    // Insert into database\n    const createdFrame = this.frameDb.insertFrame(frame);\n\n    // Add to stack\n    this.frameStack.pushFrame(frameId);\n\n    logger.info('Created frame', {\n      frameId,\n      name: frameOptions.name,\n      type: frameOptions.type,\n      parentFrameId: resolvedParentId,\n      stackDepth: this.frameStack.getDepth(),\n    });\n\n    return frameId;\n  }\n\n  /**\n   * Close a frame and generate digest\n   */\n  closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    trace.traceSync(\n      'function',\n      'FrameManager.closeFrame',\n      { frameId, outputs },\n      () => this._closeFrame(frameId, outputs)\n    );\n  }\n\n  private _closeFrame(frameId?: string, outputs?: Record<string, any>): void {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame to close',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          operation: 'closeFrame',\n          stackDepth: this.frameStack.getDepth(),\n        }\n      );\n    }\n\n    // Get frame details\n    const frame = this.frameDb.getFrame(targetFrameId);\n    if (!frame) {\n      throw new FrameError(\n        `Frame not found: ${targetFrameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        {\n          frameId: targetFrameId,\n          operation: 'closeFrame',\n          runId: this.currentRunId,\n        }\n      );\n    }\n\n    if (frame.state === 'closed') {\n      logger.warn('Attempted to close already closed frame', {\n        frameId: targetFrameId,\n      });\n      return;\n    }\n\n    // Generate digest before closing\n    const digest = this.digestGenerator.generateDigest(targetFrameId);\n    const finalOutputs = { ...outputs, ...digest.structured };\n\n    // Update frame to closed state\n    this.frameDb.updateFrame(targetFrameId, {\n      state: 'closed',\n      outputs: finalOutputs,\n      digest_text: digest.text,\n      digest_json: digest.structured,\n      closed_at: Math.floor(Date.now() / 1000),\n    });\n\n    // Remove from stack (this will also remove any child frames)\n    this.frameStack.popFrame(targetFrameId);\n\n    // Close all child frames recursively\n    this.closeChildFrames(targetFrameId);\n\n    logger.info('Closed frame', {\n      frameId: targetFrameId,\n      name: frame.name,\n      duration: Math.floor(Date.now() / 1000) - frame.created_at,\n      digestLength: digest.text.length,\n      stackDepth: this.frameStack.getDepth(),\n    });\n  }\n\n  /**\n   * Add an event to the current frame\n   */\n  addEvent(\n    eventType: Event['event_type'],\n    payload: Record<string, any>,\n    frameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.addEvent',\n      { eventType, frameId },\n      () => this._addEvent(eventType, payload, frameId)\n    );\n  }\n\n  private _addEvent(\n    eventType: Event['event_type'],\n    payload: Record<string, any>,\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for event',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          eventType,\n          operation: 'addEvent',\n        }\n      );\n    }\n\n    const eventId = uuidv4();\n    const sequence = this.frameDb.getNextEventSequence(targetFrameId);\n\n    const event: Omit<Event, 'ts'> = {\n      event_id: eventId,\n      frame_id: targetFrameId,\n      run_id: this.currentRunId,\n      seq: sequence,\n      event_type: eventType,\n      payload,\n    };\n\n    const createdEvent = this.frameDb.insertEvent(event);\n\n    logger.debug('Added event', {\n      eventId,\n      frameId: targetFrameId,\n      eventType,\n      sequence,\n    });\n\n    return eventId;\n  }\n\n  /**\n   * Add an anchor (important fact) to current frame\n   */\n  addAnchor(\n    type: Anchor['type'],\n    text: string,\n    priority: number = 5,\n    metadata: Record<string, any> = {},\n    frameId?: string\n  ): string {\n    return trace.traceSync(\n      'function',\n      'FrameManager.addAnchor',\n      { type, frameId },\n      () => this._addAnchor(type, text, priority, metadata, frameId)\n    );\n  }\n\n  private _addAnchor(\n    type: Anchor['type'],\n    text: string,\n    priority: number,\n    metadata: Record<string, any>,\n    frameId?: string\n  ): string {\n    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();\n    if (!targetFrameId) {\n      throw new FrameError(\n        'No active frame for anchor',\n        ErrorCode.FRAME_INVALID_STATE,\n        {\n          anchorType: type,\n          operation: 'addAnchor',\n        }\n      );\n    }\n\n    const anchorId = uuidv4();\n    const anchor: Omit<Anchor, 'created_at'> = {\n      anchor_id: anchorId,\n      frame_id: targetFrameId,\n      type,\n      text,\n      priority,\n      metadata,\n    };\n\n    const createdAnchor = this.frameDb.insertAnchor(anchor);\n\n    logger.debug('Added anchor', {\n      anchorId,\n      frameId: targetFrameId,\n      type,\n      priority,\n    });\n\n    return anchorId;\n  }\n\n  /**\n   * Get hot stack context\n   */\n  getHotStackContext(maxEvents: number = 20): FrameContext[] {\n    return this.frameStack.getHotStackContext(maxEvents);\n  }\n\n  /**\n   * Get active frame path (root to current)\n   */\n  getActiveFramePath(): Frame[] {\n    return this.frameStack.getStackFrames();\n  }\n\n  /**\n   * Get current frame ID\n   */\n  getCurrentFrameId(): string | undefined {\n    return this.frameStack.getCurrentFrameId();\n  }\n\n  /**\n   * Get stack depth\n   */\n  getStackDepth(): number {\n    return this.frameStack.getDepth();\n  }\n\n  /**\n   * Get frame by ID\n   */\n  getFrame(frameId: string): Frame | undefined {\n    return this.frameDb.getFrame(frameId);\n  }\n\n  /**\n   * Get frame events\n   */\n  getFrameEvents(frameId: string, limit?: number): Event[] {\n    return this.frameDb.getFrameEvents(frameId, limit);\n  }\n\n  /**\n   * Get frame anchors\n   */\n  getFrameAnchors(frameId: string): Anchor[] {\n    return this.frameDb.getFrameAnchors(frameId);\n  }\n\n  /**\n   * Generate digest for a frame\n   */\n  generateDigest(frameId: string): DigestResult {\n    return this.digestGenerator.generateDigest(frameId);\n  }\n\n  /**\n   * Validate stack consistency\n   */\n  validateStack(): { isValid: boolean; errors: string[] } {\n    return this.frameStack.validateStack();\n  }\n\n  /**\n   * Get database statistics\n   */\n  getStatistics(): Record<string, number> {\n    return this.frameDb.getStatistics();\n  }\n\n  /**\n   * Close all child frames recursively\n   */\n  private closeChildFrames(parentFrameId: string): void {\n    try {\n      const activeFrames = this.frameDb.getFramesByProject(\n        this.projectId,\n        'active'\n      );\n      const childFrames = activeFrames.filter(\n        (f: any) => f.parent_frame_id === parentFrameId\n      );\n\n      for (const childFrame of childFrames) {\n        if (this.frameStack.isFrameActive(childFrame.frame_id)) {\n          this.closeFrame(childFrame.frame_id);\n        }\n      }\n    } catch (error: unknown) {\n      logger.warn('Failed to close child frames', { parentFrameId, error });\n    }\n  }\n\n  /**\n   * Extract active artifacts from frame events\n   */\n  getActiveArtifacts(frameId: string): string[] {\n    const events = this.frameDb.getFrameEvents(frameId);\n    const artifacts: string[] = [];\n\n    for (const event of events) {\n      if (event.event_type === 'artifact' && event.payload.path) {\n        artifacts.push(event.payload.path);\n      }\n    }\n\n    return [...new Set(artifacts)];\n  }\n\n  /**\n   * Extract constraints from frame inputs\n   */\n  extractConstraints(inputs: Record<string, any>): string[] {\n    const constraints: string[] = [];\n\n    if (inputs.constraints && Array.isArray(inputs.constraints)) {\n      constraints.push(...inputs.constraints);\n    }\n\n    if (inputs.requirements && Array.isArray(inputs.requirements)) {\n      constraints.push(...inputs.requirements);\n    }\n\n    if (inputs.limitations && Array.isArray(inputs.limitations)) {\n      constraints.push(...inputs.limitations);\n    }\n\n    return constraints;\n  }\n\n  /**\n   * Detect if setting a parent frame would create a cycle in the frame hierarchy.\n   * Returns the cycle path if detected, or null if no cycle.\n   * @param childFrameId - The frame that would be the child\n   * @param parentFrameId - The proposed parent frame\n   * @returns Array of frame IDs forming the cycle, or null if no cycle\n   */\n  private detectCycle(\n    childFrameId: string,\n    parentFrameId: string\n  ): string[] | null {\n    const visited = new Set<string>();\n    const path: string[] = [];\n\n    // Start from the proposed parent and traverse up the hierarchy\n    let currentId: string | undefined = parentFrameId;\n    \n    while (currentId) {\n      // If we've seen this frame before, we have a cycle\n      if (visited.has(currentId)) {\n        // Build the cycle path\n        const cycleStart = path.indexOf(currentId);\n        return path.slice(cycleStart).concat(currentId);\n      }\n\n      // If the current frame is the child we're trying to add, it's a cycle\n      if (currentId === childFrameId) {\n        return path.concat([currentId, childFrameId]);\n      }\n\n      visited.add(currentId);\n      path.push(currentId);\n\n      // Move to the parent of current frame\n      const frame = this.frameDb.getFrame(currentId);\n      if (!frame) {\n        // Frame not found, no cycle possible through this path\n        break;\n      }\n      currentId = frame.parent_frame_id;\n\n      // Safety check: if we've traversed too many levels, something is wrong\n      if (path.length > this.maxFrameDepth) {\n        throw new FrameError(\n          `Frame hierarchy traversal exceeded maximum depth during cycle detection`,\n          ErrorCode.FRAME_STACK_OVERFLOW,\n          {\n            depth: path.length,\n            maxDepth: this.maxFrameDepth,\n            path,\n          }\n        );\n      }\n    }\n\n    return null; // No cycle detected\n  }\n\n  /**\n   * Update parent frame of an existing frame (with cycle detection)\n   * @param frameId - The frame to update\n   * @param newParentFrameId - The new parent frame ID (null to make it a root frame)\n   */\n  public updateParentFrame(frameId: string, newParentFrameId: string | null): void {\n    // Check if frame exists\n    const frame = this.frameDb.getFrame(frameId);\n    if (!frame) {\n      throw new FrameError(\n        `Frame not found: ${frameId}`,\n        ErrorCode.FRAME_NOT_FOUND,\n        { frameId }\n      );\n    }\n\n    // If setting a parent, check for cycles\n    if (newParentFrameId) {\n      const cycle = this.detectCycle(frameId, newParentFrameId);\n      if (cycle) {\n        throw new FrameError(\n          `Cannot set parent: would create circular reference`,\n          ErrorCode.FRAME_CYCLE_DETECTED,\n          {\n            frameId,\n            newParentFrameId,\n            cycle,\n            currentParentId: frame.parent_frame_id,\n          }\n        );\n      }\n\n      // Check depth after parent change\n      const newParentFrame = this.frameDb.getFrame(newParentFrameId);\n      if (newParentFrame) {\n        const newDepth = newParentFrame.depth + 1;\n        if (newDepth > this.maxFrameDepth) {\n          throw new FrameError(\n            `Cannot set parent: would exceed maximum frame depth`,\n            ErrorCode.FRAME_STACK_OVERFLOW,\n            {\n              frameId,\n              newParentFrameId,\n              newDepth,\n              maxDepth: this.maxFrameDepth,\n            }\n          );\n        }\n      }\n    }\n\n    // Update the frame's parent (this would need to be implemented in FrameDatabase)\n    this.frameDb.updateFrame(frameId, {\n      parent_frame_id: newParentFrameId,\n    });\n\n    logger.info('Updated parent frame', {\n      frameId,\n      oldParentId: frame.parent_frame_id,\n      newParentId: newParentFrameId,\n    });\n  }\n\n  /**\n   * Validate the entire frame hierarchy for cycles and depth violations\n   * @returns Validation result with any detected issues\n   */\n  public validateFrameHierarchy(): {\n    isValid: boolean;\n    errors: string[];\n    warnings: string[];\n  } {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n    const allFrames = this.frameDb.getFramesByProject(this.projectId);\n    \n    // Check each frame for depth violations\n    for (const frame of allFrames) {\n      if (frame.depth > this.maxFrameDepth) {\n        errors.push(\n          `Frame ${frame.frame_id} exceeds max depth: ${frame.depth} > ${this.maxFrameDepth}`\n        );\n      }\n      \n      // Warn about deep frames approaching the limit\n      if (frame.depth > this.maxFrameDepth * 0.8) {\n        warnings.push(\n          `Frame ${frame.frame_id} is deep in hierarchy: ${frame.depth}/${this.maxFrameDepth}`\n        );\n      }\n    }\n    \n    // Check for cycles by traversing from each root\n    const rootFrames = allFrames.filter(f => !f.parent_frame_id);\n    const visited = new Set<string>();\n    const visiting = new Set<string>();\n    \n    const checkForCycle = (frameId: string): boolean => {\n      if (visiting.has(frameId)) {\n        errors.push(`Cycle detected involving frame ${frameId}`);\n        return true;\n      }\n      \n      if (visited.has(frameId)) {\n        return false;\n      }\n      \n      visiting.add(frameId);\n      \n      // Check all children\n      const children = allFrames.filter(f => f.parent_frame_id === frameId);\n      for (const child of children) {\n        if (checkForCycle(child.frame_id)) {\n          return true;\n        }\n      }\n      \n      visiting.delete(frameId);\n      visited.add(frameId);\n      return false;\n    };\n    \n    // Check from each root\n    for (const root of rootFrames) {\n      checkForCycle(root.frame_id);\n    }\n    \n    return {\n      isValid: errors.length === 0,\n      errors,\n      warnings,\n    };\n  }\n}\n\n// Re-export types for compatibility\nexport {\n  Frame,\n  FrameContext,\n  Anchor,\n  Event,\n  FrameType,\n  FrameState,\n  FrameCreationOptions,\n  FrameManagerConfig,\n  DigestResult,\n} from './frame-types.js';\n"],
+  "mappings": "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",
   "names": ["Frame", "FrameContext", "Anchor", "Event", "FrameType", "FrameState", "FrameCreationOptions", "FrameManagerConfig", "DigestResult"]
 }

package/dist/core/execution/parallel-executor.js

@@ -0,0 +1,254 @@
+import { EventEmitter } from "events";
+import { logger } from "../monitoring/logger.js";
+class ParallelExecutor extends EventEmitter {
+  maxConcurrency;
+  queueSize;
+  defaultTimeout;
+  defaultRetries;
+  rateLimitPerMinute;
+  activeCount = 0;
+  queue = [];
+  rateLimitTokens;
+  lastRateLimitReset;
+  // Metrics
+  totalExecuted = 0;
+  totalSucceeded = 0;
+  totalFailed = 0;
+  totalDuration = 0;
+  constructor(maxConcurrency = 5, options = {}) {
+    super();
+    this.maxConcurrency = maxConcurrency;
+    this.queueSize = options.queueSize || 100;
+    this.defaultTimeout = options.defaultTimeout || 3e5;
+    this.defaultRetries = options.defaultRetries || 3;
+    this.rateLimitPerMinute = options.rateLimitPerMinute || 60;
+    this.rateLimitTokens = this.rateLimitPerMinute;
+    this.lastRateLimitReset = Date.now();
+    logger.info("Parallel Executor initialized", {
+      maxConcurrency,
+      queueSize: this.queueSize,
+      rateLimitPerMinute: this.rateLimitPerMinute
+    });
+  }
+  /**
+   * Execute multiple tasks in parallel
+   */
+  async executeParallel(items, executor, options) {
+    const results = [];
+    const batchSize = options?.batchSize || this.maxConcurrency;
+    const delayBetweenBatches = options?.delayBetweenBatches || 0;
+    for (let i = 0; i < items.length; i += batchSize) {
+      const batch = items.slice(i, i + batchSize);
+      const batchPromises = batch.map(
+        (item, index) => this.executeWithTracking(
+          `parallel-${i + index}`,
+          () => executor(item, i + index)
+        )
+      );
+      const batchResults = await Promise.allSettled(batchPromises);
+      batchResults.forEach((result, index) => {
+        if (result.status === "fulfilled") {
+          results.push(result.value);
+        } else {
+          results.push({
+            taskId: `parallel-${i + index}`,
+            success: false,
+            error: result.reason,
+            duration: 0,
+            attempts: 1
+          });
+        }
+      });
+      if (delayBetweenBatches > 0 && i + batchSize < items.length) {
+        await this.delay(delayBetweenBatches);
+      }
+      logger.debug("Batch completed", {
+        batchNumber: Math.floor(i / batchSize) + 1,
+        totalBatches: Math.ceil(items.length / batchSize),
+        successRate: results.filter((r) => r.success).length / results.length
+      });
+    }
+    return results;
+  }
+  /**
+   * Execute a single task with tracking and retries
+   */
+  async executeWithTracking(taskId, executor, options) {
+    const timeout = options?.timeout || this.defaultTimeout;
+    const maxRetries = options?.retries || this.defaultRetries;
+    let attempts = 0;
+    let lastError;
+    const startTime = Date.now();
+    while (attempts < maxRetries) {
+      attempts++;
+      try {
+        await this.checkRateLimit();
+        await this.waitForSlot();
+        this.activeCount++;
+        this.emit("task-start", { taskId, attempt: attempts });
+        const result = await this.executeWithTimeout(executor, timeout);
+        this.totalSucceeded++;
+        this.emit("task-success", { taskId, attempts });
+        return {
+          taskId,
+          success: true,
+          result,
+          duration: Date.now() - startTime,
+          attempts
+        };
+      } catch (error) {
+        lastError = error;
+        logger.warn(`Task failed (attempt ${attempts}/${maxRetries})`, {
+          taskId,
+          error: lastError.message
+        });
+        this.emit("task-retry", { taskId, attempt: attempts, error: lastError });
+        if (attempts < maxRetries) {
+          await this.delay(Math.pow(2, attempts) * 1e3);
+        }
+      } finally {
+        this.activeCount--;
+        this.totalExecuted++;
+        this.totalDuration += Date.now() - startTime;
+      }
+    }
+    this.totalFailed++;
+    this.emit("task-failed", { taskId, attempts, error: lastError });
+    return {
+      taskId,
+      success: false,
+      error: lastError,
+      duration: Date.now() - startTime,
+      attempts
+    };
+  }
+  /**
+   * Execute task with timeout
+   */
+  async executeWithTimeout(executor, timeout) {
+    return Promise.race([
+      executor(),
+      new Promise(
+        (_, reject) => setTimeout(() => reject(new Error("Task timeout")), timeout)
+      )
+    ]);
+  }
+  /**
+   * Check and enforce rate limiting
+   */
+  async checkRateLimit() {
+    const now = Date.now();
+    const timeSinceReset = now - this.lastRateLimitReset;
+    if (timeSinceReset >= 6e4) {
+      this.rateLimitTokens = this.rateLimitPerMinute;
+      this.lastRateLimitReset = now;
+    }
+    if (this.rateLimitTokens <= 0) {
+      const waitTime = 6e4 - timeSinceReset;
+      logger.debug(`Rate limit reached, waiting ${waitTime}ms`);
+      await this.delay(waitTime);
+      this.rateLimitTokens = this.rateLimitPerMinute;
+      this.lastRateLimitReset = Date.now();
+    }
+    this.rateLimitTokens--;
+  }
+  /**
+   * Wait for an available execution slot
+   */
+  async waitForSlot() {
+    while (this.activeCount >= this.maxConcurrency) {
+      await this.delay(100);
+    }
+  }
+  /**
+   * Queue a task for execution
+   */
+  async queueTask(task) {
+    if (this.queue.length >= this.queueSize) {
+      throw new Error("Execution queue is full");
+    }
+    return new Promise((resolve) => {
+      this.queue.push({
+        ...task,
+        execute: async () => {
+          const result = await task.execute();
+          resolve({
+            taskId: task.id,
+            success: true,
+            result,
+            duration: 0,
+            attempts: 1
+          });
+          return result;
+        }
+      });
+      this.processQueue();
+    });
+  }
+  /**
+   * Process queued tasks
+   */
+  async processQueue() {
+    if (this.activeCount >= this.maxConcurrency || this.queue.length === 0) {
+      return;
+    }
+    this.queue.sort((a, b) => (b.priority || 0) - (a.priority || 0));
+    const task = this.queue.shift();
+    if (task) {
+      this.executeWithTracking(task.id, task.execute, {
+        timeout: task.timeout,
+        retries: task.retries
+      }).then(() => {
+        this.processQueue();
+      });
+    }
+  }
+  /**
+   * Utility delay function
+   */
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  /**
+   * Get execution metrics
+   */
+  getMetrics() {
+    return {
+      activeCount: this.activeCount,
+      queueLength: this.queue.length,
+      totalExecuted: this.totalExecuted,
+      totalSucceeded: this.totalSucceeded,
+      totalFailed: this.totalFailed,
+      successRate: this.totalExecuted > 0 ? this.totalSucceeded / this.totalExecuted : 0,
+      averageDuration: this.totalExecuted > 0 ? this.totalDuration / this.totalExecuted : 0,
+      rateLimitTokens: this.rateLimitTokens
+    };
+  }
+  /**
+   * Reset all metrics
+   */
+  resetMetrics() {
+    this.totalExecuted = 0;
+    this.totalSucceeded = 0;
+    this.totalFailed = 0;
+    this.totalDuration = 0;
+  }
+  /**
+   * Gracefully shutdown executor
+   */
+  async shutdown() {
+    logger.info("Shutting down Parallel Executor", {
+      activeCount: this.activeCount,
+      queueLength: this.queue.length
+    });
+    this.queue = [];
+    while (this.activeCount > 0) {
+      await this.delay(100);
+    }
+    logger.info("Parallel Executor shutdown complete");
+  }
+}
+export {
+  ParallelExecutor
+};
+//# sourceMappingURL=parallel-executor.js.map

package/dist/core/execution/parallel-executor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/execution/parallel-executor.ts"],
+  "sourcesContent": ["/**\n * Parallel Execution Engine for RLM\n * \n * Manages concurrent execution of multiple Claude API calls\n * with rate limiting, resource pooling, and failure recovery\n */\n\nimport { EventEmitter } from 'events';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface ExecutionTask<T> {\n  id: string;\n  execute: () => Promise<T>;\n  priority?: number;\n  timeout?: number;\n  retries?: number;\n}\n\nexport interface ExecutionResult<T> {\n  taskId: string;\n  success: boolean;\n  result?: T;\n  error?: Error;\n  duration: number;\n  attempts: number;\n}\n\nexport interface ParallelExecutorOptions {\n  maxConcurrency?: number;\n  queueSize?: number;\n  defaultTimeout?: number;\n  defaultRetries?: number;\n  rateLimitPerMinute?: number;\n}\n\n/**\n * Parallel Executor for managing concurrent operations\n */\nexport class ParallelExecutor extends EventEmitter {\n  private maxConcurrency: number;\n  private queueSize: number;\n  private defaultTimeout: number;\n  private defaultRetries: number;\n  private rateLimitPerMinute: number;\n  \n  private activeCount: number = 0;\n  private queue: ExecutionTask<any>[] = [];\n  private rateLimitTokens: number;\n  private lastRateLimitReset: number;\n  \n  // Metrics\n  private totalExecuted: number = 0;\n  private totalSucceeded: number = 0;\n  private totalFailed: number = 0;\n  private totalDuration: number = 0;\n\n  constructor(maxConcurrency: number = 5, options: ParallelExecutorOptions = {}) {\n    super();\n    \n    this.maxConcurrency = maxConcurrency;\n    this.queueSize = options.queueSize || 100;\n    this.defaultTimeout = options.defaultTimeout || 300000; // 5 minutes\n    this.defaultRetries = options.defaultRetries || 3;\n    this.rateLimitPerMinute = options.rateLimitPerMinute || 60;\n    \n    this.rateLimitTokens = this.rateLimitPerMinute;\n    this.lastRateLimitReset = Date.now();\n    \n    logger.info('Parallel Executor initialized', {\n      maxConcurrency,\n      queueSize: this.queueSize,\n      rateLimitPerMinute: this.rateLimitPerMinute,\n    });\n  }\n  \n  /**\n   * Execute multiple tasks in parallel\n   */\n  async executeParallel<T>(\n    items: T[],\n    executor: (item: T, index: number) => Promise<void>,\n    options?: {\n      batchSize?: number;\n      delayBetweenBatches?: number;\n    }\n  ): Promise<ExecutionResult<void>[]> {\n    const results: ExecutionResult<void>[] = [];\n    const batchSize = options?.batchSize || this.maxConcurrency;\n    const delayBetweenBatches = options?.delayBetweenBatches || 0;\n    \n    // Process items in batches\n    for (let i = 0; i < items.length; i += batchSize) {\n      const batch = items.slice(i, i + batchSize);\n      const batchPromises = batch.map((item, index) => \n        this.executeWithTracking(\n          `parallel-${i + index}`,\n          () => executor(item, i + index)\n        )\n      );\n      \n      const batchResults = await Promise.allSettled(batchPromises);\n      \n      // Convert to ExecutionResult format\n      batchResults.forEach((result, index) => {\n        if (result.status === 'fulfilled') {\n          results.push(result.value);\n        } else {\n          results.push({\n            taskId: `parallel-${i + index}`,\n            success: false,\n            error: result.reason,\n            duration: 0,\n            attempts: 1,\n          });\n        }\n      });\n      \n      // Delay between batches if specified\n      if (delayBetweenBatches > 0 && i + batchSize < items.length) {\n        await this.delay(delayBetweenBatches);\n      }\n      \n      // Log batch progress\n      logger.debug('Batch completed', {\n        batchNumber: Math.floor(i / batchSize) + 1,\n        totalBatches: Math.ceil(items.length / batchSize),\n        successRate: results.filter(r => r.success).length / results.length,\n      });\n    }\n    \n    return results;\n  }\n  \n  /**\n   * Execute a single task with tracking and retries\n   */\n  async executeWithTracking<T>(\n    taskId: string,\n    executor: () => Promise<T>,\n    options?: {\n      timeout?: number;\n      retries?: number;\n    }\n  ): Promise<ExecutionResult<T>> {\n    const timeout = options?.timeout || this.defaultTimeout;\n    const maxRetries = options?.retries || this.defaultRetries;\n    \n    let attempts = 0;\n    let lastError: Error | undefined;\n    const startTime = Date.now();\n    \n    while (attempts < maxRetries) {\n      attempts++;\n      \n      try {\n        // Check rate limit\n        await this.checkRateLimit();\n        \n        // Wait for available slot\n        await this.waitForSlot();\n        \n        this.activeCount++;\n        this.emit('task-start', { taskId, attempt: attempts });\n        \n        // Execute with timeout\n        const result = await this.executeWithTimeout(executor, timeout);\n        \n        // Success\n        this.totalSucceeded++;\n        this.emit('task-success', { taskId, attempts });\n        \n        return {\n          taskId,\n          success: true,\n          result,\n          duration: Date.now() - startTime,\n          attempts,\n        };\n        \n      } catch (error) {\n        lastError = error as Error;\n        \n        logger.warn(`Task failed (attempt ${attempts}/${maxRetries})`, {\n          taskId,\n          error: lastError.message,\n        });\n        \n        this.emit('task-retry', { taskId, attempt: attempts, error: lastError });\n        \n        // Exponential backoff for retries\n        if (attempts < maxRetries) {\n          await this.delay(Math.pow(2, attempts) * 1000);\n        }\n        \n      } finally {\n        this.activeCount--;\n        this.totalExecuted++;\n        this.totalDuration += Date.now() - startTime;\n      }\n    }\n    \n    // All retries exhausted\n    this.totalFailed++;\n    this.emit('task-failed', { taskId, attempts, error: lastError });\n    \n    return {\n      taskId,\n      success: false,\n      error: lastError,\n      duration: Date.now() - startTime,\n      attempts,\n    };\n  }\n  \n  /**\n   * Execute task with timeout\n   */\n  private async executeWithTimeout<T>(\n    executor: () => Promise<T>,\n    timeout: number\n  ): Promise<T> {\n    return Promise.race([\n      executor(),\n      new Promise<T>((_, reject) => \n        setTimeout(() => reject(new Error('Task timeout')), timeout)\n      ),\n    ]);\n  }\n  \n  /**\n   * Check and enforce rate limiting\n   */\n  private async checkRateLimit(): Promise<void> {\n    const now = Date.now();\n    const timeSinceReset = now - this.lastRateLimitReset;\n    \n    // Reset tokens if a minute has passed\n    if (timeSinceReset >= 60000) {\n      this.rateLimitTokens = this.rateLimitPerMinute;\n      this.lastRateLimitReset = now;\n    }\n    \n    // Wait if no tokens available\n    if (this.rateLimitTokens <= 0) {\n      const waitTime = 60000 - timeSinceReset;\n      logger.debug(`Rate limit reached, waiting ${waitTime}ms`);\n      await this.delay(waitTime);\n      \n      // Reset after waiting\n      this.rateLimitTokens = this.rateLimitPerMinute;\n      this.lastRateLimitReset = Date.now();\n    }\n    \n    this.rateLimitTokens--;\n  }\n  \n  /**\n   * Wait for an available execution slot\n   */\n  private async waitForSlot(): Promise<void> {\n    while (this.activeCount >= this.maxConcurrency) {\n      await this.delay(100); // Check every 100ms\n    }\n  }\n  \n  /**\n   * Queue a task for execution\n   */\n  async queueTask<T>(task: ExecutionTask<T>): Promise<ExecutionResult<T>> {\n    if (this.queue.length >= this.queueSize) {\n      throw new Error('Execution queue is full');\n    }\n    \n    return new Promise((resolve) => {\n      this.queue.push({\n        ...task,\n        execute: async () => {\n          const result = await task.execute();\n          resolve({\n            taskId: task.id,\n            success: true,\n            result,\n            duration: 0,\n            attempts: 1,\n          });\n          return result;\n        },\n      });\n      \n      this.processQueue();\n    });\n  }\n  \n  /**\n   * Process queued tasks\n   */\n  private async processQueue(): Promise<void> {\n    if (this.activeCount >= this.maxConcurrency || this.queue.length === 0) {\n      return;\n    }\n    \n    // Sort by priority (higher first)\n    this.queue.sort((a, b) => (b.priority || 0) - (a.priority || 0));\n    \n    const task = this.queue.shift();\n    if (task) {\n      this.executeWithTracking(task.id, task.execute, {\n        timeout: task.timeout,\n        retries: task.retries,\n      }).then(() => {\n        this.processQueue(); // Process next task\n      });\n    }\n  }\n  \n  /**\n   * Utility delay function\n   */\n  private delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n  \n  /**\n   * Get execution metrics\n   */\n  getMetrics() {\n    return {\n      activeCount: this.activeCount,\n      queueLength: this.queue.length,\n      totalExecuted: this.totalExecuted,\n      totalSucceeded: this.totalSucceeded,\n      totalFailed: this.totalFailed,\n      successRate: this.totalExecuted > 0 ? this.totalSucceeded / this.totalExecuted : 0,\n      averageDuration: this.totalExecuted > 0 ? this.totalDuration / this.totalExecuted : 0,\n      rateLimitTokens: this.rateLimitTokens,\n    };\n  }\n  \n  /**\n   * Reset all metrics\n   */\n  resetMetrics(): void {\n    this.totalExecuted = 0;\n    this.totalSucceeded = 0;\n    this.totalFailed = 0;\n    this.totalDuration = 0;\n  }\n  \n  /**\n   * Gracefully shutdown executor\n   */\n  async shutdown(): Promise<void> {\n    logger.info('Shutting down Parallel Executor', {\n      activeCount: this.activeCount,\n      queueLength: this.queue.length,\n    });\n    \n    // Clear queue\n    this.queue = [];\n    \n    // Wait for active tasks to complete\n    while (this.activeCount > 0) {\n      await this.delay(100);\n    }\n    \n    logger.info('Parallel Executor shutdown complete');\n  }\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/utils/update-checker.js

@@ -1,4 +1,4 @@
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -59,7 +59,7 @@ class UpdateChecker {
   static async fetchLatestVersion() {
     try {
       const fetchVersion = async () => {
-        const output = execSync(`npm view ${this.PACKAGE_NAME} version`, {
+        const output = execFileSync("npm", ["view", this.PACKAGE_NAME, "version"], {
           encoding: "utf-8",
           stdio: ["pipe", "pipe", "ignore"],
           timeout: 5e3