@stackmemoryai/stackmemory 0.2.8 → 0.3.0

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

@@ -0,0 +1,393 @@
+import { v4 as uuidv4 } from "uuid";
+import { logger } from "../monitoring/logger.js";
+import { trace } from "../trace/index.js";
+import {
+  FrameError,
+  SystemError,
+  ErrorCode
+} from "../errors/index.js";
+import { FrameQueryMode } from "../session/index.js";
+import { FrameDatabase } from "./frame-database.js";
+import { FrameStack } from "./frame-stack.js";
+import { FrameDigestGenerator } from "./frame-digest.js";
+class RefactoredFrameManager {
+  frameDb;
+  frameStack;
+  digestGenerator;
+  currentRunId;
+  sessionId;
+  projectId;
+  queryMode = FrameQueryMode.PROJECT_ACTIVE;
+  config;
+  constructor(db, projectId, config) {
+    this.projectId = projectId;
+    this.config = {
+      projectId,
+      runId: config?.runId || uuidv4(),
+      sessionId: config?.sessionId || uuidv4(),
+      maxStackDepth: config?.maxStackDepth || 50
+    };
+    this.currentRunId = this.config.runId;
+    this.sessionId = this.config.sessionId;
+    this.frameDb = new FrameDatabase(db);
+    this.frameStack = new FrameStack(this.frameDb, projectId, this.currentRunId);
+    this.digestGenerator = new FrameDigestGenerator(this.frameDb);
+    this.frameDb.initSchema();
+    logger.info("RefactoredFrameManager initialized", {
+      projectId: this.projectId,
+      runId: this.currentRunId,
+      sessionId: this.sessionId
+    });
+  }
+  /**
+   * Initialize the frame manager
+   */
+  async initialize() {
+    try {
+      await this.frameStack.initialize();
+      logger.info("Frame manager initialization completed", {
+        stackDepth: this.frameStack.getDepth()
+      });
+    } catch (error) {
+      throw new SystemError(
+        "Failed to initialize frame manager",
+        ErrorCode.SYSTEM_INIT_FAILED,
+        { projectId: this.projectId },
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
+  createFrame(typeOrOptions, name, inputs, parentFrameId) {
+    return trace.traceSync(
+      "function",
+      "FrameManager.createFrame",
+      { typeOrOptions, name },
+      () => this._createFrame(typeOrOptions, name, inputs, parentFrameId)
+    );
+  }
+  _createFrame(typeOrOptions, name, inputs, parentFrameId) {
+    let frameOptions;
+    if (typeof typeOrOptions === "string") {
+      frameOptions = {
+        type: typeOrOptions,
+        name,
+        inputs: inputs || {},
+        parentFrameId
+      };
+    } else {
+      frameOptions = typeOrOptions;
+    }
+    if (!frameOptions.name || frameOptions.name.trim().length === 0) {
+      throw new FrameError(
+        "Frame name is required",
+        ErrorCode.FRAME_INVALID_INPUT,
+        { frameOptions }
+      );
+    }
+    if (this.frameStack.getDepth() >= this.config.maxStackDepth) {
+      throw new FrameError(
+        `Maximum stack depth reached: ${this.config.maxStackDepth}`,
+        ErrorCode.FRAME_STACK_OVERFLOW,
+        { currentDepth: this.frameStack.getDepth() }
+      );
+    }
+    const resolvedParentId = frameOptions.parentFrameId || this.frameStack.getCurrentFrameId();
+    const depth = resolvedParentId ? this.frameStack.getFrameStackDepth(resolvedParentId) + 1 : 0;
+    const frameId = uuidv4();
+    const frame = {
+      frame_id: frameId,
+      run_id: this.currentRunId,
+      project_id: this.projectId,
+      parent_frame_id: resolvedParentId,
+      depth,
+      type: frameOptions.type,
+      name: frameOptions.name,
+      state: "active",
+      inputs: frameOptions.inputs || {},
+      outputs: {},
+      digest_json: {}
+    };
+    const createdFrame = this.frameDb.insertFrame(frame);
+    this.frameStack.pushFrame(frameId);
+    logger.info("Created frame", {
+      frameId,
+      name: frameOptions.name,
+      type: frameOptions.type,
+      parentFrameId: resolvedParentId,
+      stackDepth: this.frameStack.getDepth()
+    });
+    return frameId;
+  }
+  /**
+   * Close a frame and generate digest
+   */
+  closeFrame(frameId, outputs) {
+    trace.traceSync(
+      "function",
+      "FrameManager.closeFrame",
+      { frameId, outputs },
+      () => this._closeFrame(frameId, outputs)
+    );
+  }
+  _closeFrame(frameId, outputs) {
+    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();
+    if (!targetFrameId) {
+      throw new FrameError(
+        "No active frame to close",
+        ErrorCode.FRAME_INVALID_STATE,
+        {
+          operation: "closeFrame",
+          stackDepth: this.frameStack.getDepth()
+        }
+      );
+    }
+    const frame = this.frameDb.getFrame(targetFrameId);
+    if (!frame) {
+      throw new FrameError(
+        `Frame not found: ${targetFrameId}`,
+        ErrorCode.FRAME_NOT_FOUND,
+        {
+          frameId: targetFrameId,
+          operation: "closeFrame",
+          runId: this.currentRunId
+        }
+      );
+    }
+    if (frame.state === "closed") {
+      logger.warn("Attempted to close already closed frame", {
+        frameId: targetFrameId
+      });
+      return;
+    }
+    const digest = this.digestGenerator.generateDigest(targetFrameId);
+    const finalOutputs = { ...outputs, ...digest.structured };
+    this.frameDb.updateFrame(targetFrameId, {
+      state: "closed",
+      outputs: finalOutputs,
+      digest_text: digest.text,
+      digest_json: digest.structured,
+      closed_at: Math.floor(Date.now() / 1e3)
+    });
+    this.frameStack.popFrame(targetFrameId);
+    this.closeChildFrames(targetFrameId);
+    logger.info("Closed frame", {
+      frameId: targetFrameId,
+      name: frame.name,
+      duration: Math.floor(Date.now() / 1e3) - frame.created_at,
+      digestLength: digest.text.length,
+      stackDepth: this.frameStack.getDepth()
+    });
+  }
+  /**
+   * Add an event to the current frame
+   */
+  addEvent(eventType, payload, frameId) {
+    return trace.traceSync(
+      "function",
+      "FrameManager.addEvent",
+      { eventType, frameId },
+      () => this._addEvent(eventType, payload, frameId)
+    );
+  }
+  _addEvent(eventType, payload, frameId) {
+    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();
+    if (!targetFrameId) {
+      throw new FrameError(
+        "No active frame for event",
+        ErrorCode.FRAME_INVALID_STATE,
+        {
+          eventType,
+          operation: "addEvent"
+        }
+      );
+    }
+    const eventId = uuidv4();
+    const sequence = this.frameDb.getNextEventSequence(targetFrameId);
+    const event = {
+      event_id: eventId,
+      frame_id: targetFrameId,
+      run_id: this.currentRunId,
+      seq: sequence,
+      event_type: eventType,
+      payload
+    };
+    const createdEvent = this.frameDb.insertEvent(event);
+    logger.debug("Added event", {
+      eventId,
+      frameId: targetFrameId,
+      eventType,
+      sequence
+    });
+    return eventId;
+  }
+  /**
+   * Add an anchor (important fact) to current frame
+   */
+  addAnchor(type, text, priority = 5, metadata = {}, frameId) {
+    return trace.traceSync(
+      "function",
+      "FrameManager.addAnchor",
+      { type, frameId },
+      () => this._addAnchor(type, text, priority, metadata, frameId)
+    );
+  }
+  _addAnchor(type, text, priority, metadata, frameId) {
+    const targetFrameId = frameId || this.frameStack.getCurrentFrameId();
+    if (!targetFrameId) {
+      throw new FrameError(
+        "No active frame for anchor",
+        ErrorCode.FRAME_INVALID_STATE,
+        {
+          anchorType: type,
+          operation: "addAnchor"
+        }
+      );
+    }
+    const anchorId = uuidv4();
+    const anchor = {
+      anchor_id: anchorId,
+      frame_id: targetFrameId,
+      type,
+      text,
+      priority,
+      metadata
+    };
+    const createdAnchor = this.frameDb.insertAnchor(anchor);
+    logger.debug("Added anchor", {
+      anchorId,
+      frameId: targetFrameId,
+      type,
+      priority
+    });
+    return anchorId;
+  }
+  /**
+   * Get hot stack context
+   */
+  getHotStackContext(maxEvents = 20) {
+    return this.frameStack.getHotStackContext(maxEvents);
+  }
+  /**
+   * Get active frame path (root to current)
+   */
+  getActiveFramePath() {
+    return this.frameStack.getStackFrames();
+  }
+  /**
+   * Get current frame ID
+   */
+  getCurrentFrameId() {
+    return this.frameStack.getCurrentFrameId();
+  }
+  /**
+   * Get stack depth
+   */
+  getStackDepth() {
+    return this.frameStack.getDepth();
+  }
+  /**
+   * Get frame by ID
+   */
+  getFrame(frameId) {
+    return this.frameDb.getFrame(frameId);
+  }
+  /**
+   * Get frame events
+   */
+  getFrameEvents(frameId, limit) {
+    return this.frameDb.getFrameEvents(frameId, limit);
+  }
+  /**
+   * Get frame anchors
+   */
+  getFrameAnchors(frameId) {
+    return this.frameDb.getFrameAnchors(frameId);
+  }
+  /**
+   * Generate digest for a frame
+   */
+  generateDigest(frameId) {
+    return this.digestGenerator.generateDigest(frameId);
+  }
+  /**
+   * Validate stack consistency
+   */
+  validateStack() {
+    return this.frameStack.validateStack();
+  }
+  /**
+   * Get database statistics
+   */
+  getStatistics() {
+    return this.frameDb.getStatistics();
+  }
+  /**
+   * Close all child frames recursively
+   */
+  closeChildFrames(parentFrameId) {
+    try {
+      const activeFrames = this.frameDb.getFramesByProject(this.projectId, "active");
+      const childFrames = activeFrames.filter((f) => f.parent_frame_id === parentFrameId);
+      for (const childFrame of childFrames) {
+        if (this.frameStack.isFrameActive(childFrame.frame_id)) {
+          this.closeFrame(childFrame.frame_id);
+        }
+      }
+    } catch (error) {
+      logger.warn("Failed to close child frames", { parentFrameId, error });
+    }
+  }
+  /**
+   * Extract active artifacts from frame events
+   */
+  getActiveArtifacts(frameId) {
+    const events = this.frameDb.getFrameEvents(frameId);
+    const artifacts = [];
+    for (const event of events) {
+      if (event.event_type === "artifact" && event.payload.path) {
+        artifacts.push(event.payload.path);
+      }
+    }
+    return [...new Set(artifacts)];
+  }
+  /**
+   * Extract constraints from frame inputs
+   */
+  extractConstraints(inputs) {
+    const constraints = [];
+    if (inputs.constraints && Array.isArray(inputs.constraints)) {
+      constraints.push(...inputs.constraints);
+    }
+    if (inputs.requirements && Array.isArray(inputs.requirements)) {
+      constraints.push(...inputs.requirements);
+    }
+    if (inputs.limitations && Array.isArray(inputs.limitations)) {
+      constraints.push(...inputs.limitations);
+    }
+    return constraints;
+  }
+}
+import {
+  Frame as Frame2,
+  FrameContext as FrameContext2,
+  Anchor as Anchor2,
+  Event as Event2,
+  FrameType as FrameType2,
+  FrameState as FrameState2,
+  FrameCreationOptions as FrameCreationOptions2,
+  FrameManagerConfig as FrameManagerConfig2,
+  DigestResult as DigestResult2
+} from "./frame-types.js";
+export {
+  Anchor2 as Anchor,
+  DigestResult2 as DigestResult,
+  Event2 as Event,
+  Frame2 as Frame,
+  FrameContext2 as FrameContext,
+  FrameCreationOptions2 as FrameCreationOptions,
+  FrameManagerConfig2 as FrameManagerConfig,
+  FrameState2 as FrameState,
+  FrameType2 as FrameType,
+  RefactoredFrameManager
+};
+//# sourceMappingURL=refactored-frame-manager.js.map

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

@@ -0,0 +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(db: Database.Database, projectId: string, config?: Partial<FrameManagerConfig>) {\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(this.frameDb, projectId, this.currentRunId);\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) {\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('function', 'FrameManager.createFrame', { 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 = 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('function', 'FrameManager.closeFrame', { 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('function', 'FrameManager.addEvent', { 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('function', 'FrameManager.addAnchor', { 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(this.projectId, 'active');\n      const childFrames = activeFrames.filter(f => f.parent_frame_id === parentFrameId);\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) {\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';"],
+  "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,YAAY,IAAuB,WAAmB,QAAsC;AAC1F,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,WAAW,KAAK,SAAS,WAAW,KAAK,YAAY;AAC3E,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,OAAO;AACd,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,MAAU;AAAA,MAAY;AAAA,MAA4B,EAAE,eAAe,KAAK;AAAA,MAAG,MACtF,KAAK,aAAa,eAAe,MAAM,QAAQ,aAAa;AAAA,IAC9D;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,mBAAmB,aAAa,iBAAiB,KAAK,WAAW,kBAAkB;AACzF,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,MAAU;AAAA,MAAY;AAAA,MAA2B,EAAE,SAAS,QAAQ;AAAA,MAAG,MAC3E,KAAK,YAAY,SAAS,OAAO;AAAA,IACnC;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,MAAU;AAAA,MAAY;AAAA,MAAyB,EAAE,WAAW,QAAQ;AAAA,MAAG,MAClF,KAAK,UAAU,WAAW,SAAS,OAAO;AAAA,IAC5C;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,MAAU;AAAA,MAAY;AAAA,MAA0B,EAAE,MAAM,QAAQ;AAAA,MAAG,MAC9E,KAAK,WAAW,MAAM,MAAM,UAAU,UAAU,OAAO;AAAA,IACzD;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,mBAAmB,KAAK,WAAW,QAAQ;AAC7E,YAAM,cAAc,aAAa,OAAO,OAAK,EAAE,oBAAoB,aAAa;AAEhF,iBAAW,cAAc,aAAa;AACpC,YAAI,KAAK,WAAW,cAAc,WAAW,QAAQ,GAAG;AACtD,eAAK,WAAW,WAAW,QAAQ;AAAA,QACrC;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,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;",
+  "names": ["Frame", "FrameContext", "Anchor", "Event", "FrameType", "FrameState", "FrameCreationOptions", "FrameManagerConfig", "DigestResult"]
+}