@stackmemoryai/stackmemory 0.1.0 → 0.2.0

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

@@ -0,0 +1,387 @@
+/**
+ * StackMemory Frame Manager - Call Stack Implementation
+ * Manages nested frames representing the call stack of work
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from './logger.js';
+import { StackMemoryError, ErrorCode } from './error-handler.js';
+export class FrameManager {
+    db;
+    currentRunId;
+    projectId;
+    activeStack = []; // Stack of active frame IDs
+    constructor(db, projectId, runId) {
+        this.db = db;
+        this.projectId = projectId;
+        this.currentRunId = runId || uuidv4();
+        this.initializeSchema();
+        this.loadActiveStack();
+    }
+    initializeSchema() {
+        // Enhanced frames table matching architecture
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS frames (
+        frame_id TEXT PRIMARY KEY,
+        run_id TEXT NOT NULL,
+        project_id TEXT NOT NULL,
+        parent_frame_id TEXT REFERENCES frames(frame_id),
+        depth INTEGER NOT NULL DEFAULT 0,
+        type TEXT NOT NULL,
+        name TEXT NOT NULL,
+        state TEXT DEFAULT 'active',
+        inputs TEXT DEFAULT '{}',
+        outputs TEXT DEFAULT '{}',
+        digest_text TEXT,
+        digest_json TEXT DEFAULT '{}',
+        created_at INTEGER DEFAULT (unixepoch()),
+        closed_at INTEGER
+      );
+
+      CREATE TABLE IF NOT EXISTS events (
+        event_id TEXT PRIMARY KEY,
+        run_id TEXT NOT NULL,
+        frame_id TEXT NOT NULL,
+        seq INTEGER NOT NULL,
+        event_type TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        ts INTEGER DEFAULT (unixepoch()),
+        FOREIGN KEY(frame_id) REFERENCES frames(frame_id)
+      );
+
+      CREATE TABLE IF NOT EXISTS anchors (
+        anchor_id TEXT PRIMARY KEY,
+        frame_id TEXT NOT NULL,
+        project_id TEXT NOT NULL,
+        type TEXT NOT NULL,
+        text TEXT NOT NULL,
+        priority INTEGER DEFAULT 0,
+        created_at INTEGER DEFAULT (unixepoch()),
+        metadata TEXT DEFAULT '{}',
+        FOREIGN KEY(frame_id) REFERENCES frames(frame_id)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_frames_run ON frames(run_id);
+      CREATE INDEX IF NOT EXISTS idx_frames_parent ON frames(parent_frame_id);
+      CREATE INDEX IF NOT EXISTS idx_frames_state ON frames(state);
+      CREATE INDEX IF NOT EXISTS idx_events_frame ON events(frame_id);
+      CREATE INDEX IF NOT EXISTS idx_events_seq ON events(frame_id, seq);
+      CREATE INDEX IF NOT EXISTS idx_anchors_frame ON anchors(frame_id);
+    `);
+    }
+    loadActiveStack() {
+        // Load currently active frames for this run
+        const activeFrames = this.db
+            .prepare(`
+      SELECT frame_id, parent_frame_id, depth
+      FROM frames
+      WHERE run_id = ? AND state = 'active'
+      ORDER BY depth ASC
+    `)
+            .all(this.currentRunId);
+        // Rebuild stack order
+        this.activeStack = this.buildStackOrder(activeFrames);
+        logger.info('Loaded active stack', {
+            runId: this.currentRunId,
+            stackDepth: this.activeStack.length,
+            activeFrames: this.activeStack,
+        });
+    }
+    buildStackOrder(frames) {
+        const stack = [];
+        // Find root frame (no parent)
+        const rootFrame = frames.find((f) => !f.parent_frame_id);
+        if (!rootFrame)
+            return [];
+        // Build stack by following parent-child relationships
+        let currentFrame = rootFrame;
+        stack.push(currentFrame.frame_id);
+        while (currentFrame) {
+            const childFrame = frames.find((f) => f.parent_frame_id === currentFrame.frame_id);
+            if (!childFrame)
+                break;
+            stack.push(childFrame.frame_id);
+            currentFrame = childFrame;
+        }
+        return stack;
+    }
+    /**
+     * Create a new frame and push to stack
+     */
+    createFrame(options) {
+        const frameId = uuidv4();
+        const parentFrameId = options.parentFrameId || this.getCurrentFrameId();
+        const depth = parentFrameId ? this.getFrameDepth(parentFrameId) + 1 : 0;
+        const frame = {
+            frame_id: frameId,
+            run_id: this.currentRunId,
+            project_id: this.projectId,
+            parent_frame_id: parentFrameId,
+            depth,
+            type: options.type,
+            name: options.name,
+            state: 'active',
+            inputs: options.inputs || {},
+            created_at: Math.floor(Date.now() / 1000),
+        };
+        this.db
+            .prepare(`
+      INSERT INTO frames (
+        frame_id, run_id, project_id, parent_frame_id, depth, type, name, state, inputs, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `)
+            .run(frame.frame_id, frame.run_id, frame.project_id, frame.parent_frame_id, frame.depth, frame.type, frame.name, frame.state, JSON.stringify(frame.inputs), frame.created_at);
+        // Push to active stack
+        this.activeStack.push(frameId);
+        logger.info('Created frame', {
+            frameId,
+            type: options.type,
+            name: options.name,
+            depth,
+            parentFrameId,
+            stackDepth: this.activeStack.length,
+        });
+        return frameId;
+    }
+    /**
+     * Close the current frame and generate digest
+     */
+    closeFrame(frameId, outputs) {
+        const targetFrameId = frameId || this.getCurrentFrameId();
+        if (!targetFrameId) {
+            throw new StackMemoryError(ErrorCode.OPERATION_FAILED, 'No active frame to close');
+        }
+        // Get frame details
+        const frame = this.getFrame(targetFrameId);
+        if (!frame) {
+            throw new StackMemoryError(ErrorCode.OPERATION_FAILED, `Frame not found: ${targetFrameId}`);
+        }
+        if (frame.state === 'closed') {
+            logger.warn('Attempted to close already closed frame', {
+                frameId: targetFrameId,
+            });
+            return;
+        }
+        // Generate digest before closing
+        const digest = this.generateDigest(targetFrameId);
+        const finalOutputs = { ...outputs, ...digest.structured };
+        // Update frame to closed state
+        this.db
+            .prepare(`
+      UPDATE frames
+      SET state = 'closed',
+          outputs = ?,
+          digest_text = ?,
+          digest_json = ?,
+          closed_at = unixepoch()
+      WHERE frame_id = ?
+    `)
+            .run(JSON.stringify(finalOutputs), digest.text, JSON.stringify(digest.structured), targetFrameId);
+        // Remove from active stack
+        this.activeStack = this.activeStack.filter((id) => id !== targetFrameId);
+        // Close all child frames recursively
+        this.closeChildFrames(targetFrameId);
+        logger.info('Closed frame', {
+            frameId: targetFrameId,
+            name: frame.name,
+            duration: Math.floor(Date.now() / 1000) - frame.created_at,
+            digestLength: digest.text.length,
+            stackDepth: this.activeStack.length,
+        });
+    }
+    closeChildFrames(parentFrameId) {
+        const children = this.db
+            .prepare(`
+      SELECT frame_id FROM frames
+      WHERE parent_frame_id = ? AND state = 'active'
+    `)
+            .all(parentFrameId);
+        children.forEach((child) => {
+            this.closeFrame(child.frame_id);
+        });
+    }
+    /**
+     * Generate digest for a frame
+     */
+    generateDigest(frameId) {
+        const frame = this.getFrame(frameId);
+        const events = this.getFrameEvents(frameId);
+        const anchors = this.getFrameAnchors(frameId);
+        if (!frame) {
+            throw new StackMemoryError(ErrorCode.OPERATION_FAILED, `Cannot generate digest: frame not found ${frameId}`);
+        }
+        // Extract key information
+        const decisions = anchors.filter((a) => a.type === 'DECISION');
+        const constraints = anchors.filter((a) => a.type === 'CONSTRAINT');
+        const risks = anchors.filter((a) => a.type === 'RISK');
+        const toolCalls = events.filter((e) => e.event_type === 'tool_call');
+        const artifacts = events.filter((e) => e.event_type === 'artifact');
+        // Generate structured digest
+        const structured = {
+            result: frame.name,
+            decisions: decisions.map((d) => ({ id: d.anchor_id, text: d.text })),
+            constraints: constraints.map((c) => ({ id: c.anchor_id, text: c.text })),
+            risks: risks.map((r) => ({ id: r.anchor_id, text: r.text })),
+            artifacts: artifacts.map((a) => ({
+                kind: a.payload.kind || 'unknown',
+                ref: a.payload.ref,
+            })),
+            tool_calls_count: toolCalls.length,
+            duration_seconds: frame.closed_at
+                ? frame.closed_at - frame.created_at
+                : 0,
+        };
+        // Generate text summary
+        const text = this.generateDigestText(frame, structured, events.length);
+        return { text, structured };
+    }
+    generateDigestText(frame, structured, eventCount) {
+        let summary = `Completed: ${frame.name}\n`;
+        if (structured.decisions.length > 0) {
+            summary += `\nDecisions made:\n${structured.decisions.map((d) => `- ${d.text}`).join('\n')}`;
+        }
+        if (structured.constraints.length > 0) {
+            summary += `\nConstraints established:\n${structured.constraints.map((c) => `- ${c.text}`).join('\n')}`;
+        }
+        if (structured.risks.length > 0) {
+            summary += `\nRisks identified:\n${structured.risks.map((r) => `- ${r.text}`).join('\n')}`;
+        }
+        summary += `\nActivity: ${eventCount} events, ${structured.tool_calls_count} tool calls`;
+        if (structured.duration_seconds > 0) {
+            summary += `, ${Math.floor(structured.duration_seconds / 60)}m ${structured.duration_seconds % 60}s duration`;
+        }
+        return summary;
+    }
+    /**
+     * Add event to current frame
+     */
+    addEvent(eventType, payload, frameId) {
+        const targetFrameId = frameId || this.getCurrentFrameId();
+        if (!targetFrameId) {
+            throw new StackMemoryError(ErrorCode.OPERATION_FAILED, 'No active frame for event');
+        }
+        const eventId = uuidv4();
+        const seq = this.getNextEventSequence(targetFrameId);
+        this.db
+            .prepare(`
+      INSERT INTO events (event_id, run_id, frame_id, seq, event_type, payload)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `)
+            .run(eventId, this.currentRunId, targetFrameId, seq, eventType, JSON.stringify(payload));
+        return eventId;
+    }
+    /**
+     * Add anchor to frame
+     */
+    addAnchor(type, text, priority = 0, metadata = {}, frameId) {
+        const targetFrameId = frameId || this.getCurrentFrameId();
+        if (!targetFrameId) {
+            throw new StackMemoryError(ErrorCode.OPERATION_FAILED, 'No active frame for anchor');
+        }
+        const anchorId = uuidv4();
+        this.db
+            .prepare(`
+      INSERT INTO anchors (anchor_id, frame_id, project_id, type, text, priority, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `)
+            .run(anchorId, targetFrameId, this.projectId, type, text, priority, JSON.stringify(metadata));
+        return anchorId;
+    }
+    /**
+     * Get hot stack context for current active frames
+     */
+    getHotStackContext(maxEvents = 20) {
+        return this.activeStack
+            .map((frameId) => {
+            const frame = this.getFrame(frameId);
+            if (!frame)
+                return null;
+            return {
+                frameId,
+                header: {
+                    goal: frame.name,
+                    constraints: this.extractConstraints(frame.inputs),
+                    definitions: frame.inputs.definitions,
+                },
+                anchors: this.getFrameAnchors(frameId),
+                recentEvents: this.getFrameEvents(frameId, maxEvents),
+                activeArtifacts: this.getActiveArtifacts(frameId),
+            };
+        })
+            .filter(Boolean);
+    }
+    /**
+     * Get active frame path (root to current)
+     */
+    getActiveFramePath() {
+        return this.activeStack
+            .map((frameId) => this.getFrame(frameId))
+            .filter(Boolean);
+    }
+    // Utility methods
+    getCurrentFrameId() {
+        return this.activeStack[this.activeStack.length - 1];
+    }
+    getStackDepth() {
+        return this.activeStack.length;
+    }
+    getFrameDepth(frameId) {
+        const frame = this.getFrame(frameId);
+        return frame?.depth || 0;
+    }
+    getFrame(frameId) {
+        const row = this.db
+            .prepare(`
+      SELECT * FROM frames WHERE frame_id = ?
+    `)
+            .get(frameId);
+        if (!row)
+            return undefined;
+        return {
+            ...row,
+            inputs: JSON.parse(row.inputs || '{}'),
+            outputs: JSON.parse(row.outputs || '{}'),
+            digest_json: JSON.parse(row.digest_json || '{}'),
+        };
+    }
+    getFrameEvents(frameId, limit) {
+        const query = limit
+            ? `SELECT * FROM events WHERE frame_id = ? ORDER BY seq DESC LIMIT ?`
+            : `SELECT * FROM events WHERE frame_id = ? ORDER BY seq ASC`;
+        const params = limit ? [frameId, limit] : [frameId];
+        const rows = this.db.prepare(query).all(...params);
+        return rows.map((row) => ({
+            ...row,
+            payload: JSON.parse(row.payload),
+        }));
+    }
+    getFrameAnchors(frameId) {
+        const rows = this.db
+            .prepare(`
+      SELECT * FROM anchors WHERE frame_id = ? ORDER BY priority DESC, created_at ASC
+    `)
+            .all(frameId);
+        return rows.map((row) => ({
+            ...row,
+            metadata: JSON.parse(row.metadata || '{}'),
+        }));
+    }
+    getNextEventSequence(frameId) {
+        const result = this.db
+            .prepare(`
+      SELECT MAX(seq) as max_seq FROM events WHERE frame_id = ?
+    `)
+            .get(frameId);
+        return (result.max_seq || 0) + 1;
+    }
+    extractConstraints(inputs) {
+        return inputs.constraints;
+    }
+    getActiveArtifacts(frameId) {
+        const artifacts = this.getFrameEvents(frameId)
+            .filter((e) => e.event_type === 'artifact')
+            .map((e) => e.payload.ref)
+            .filter(Boolean);
+        return artifacts;
+    }
+}
+//# sourceMappingURL=frame-manager.js.map

package/dist/src/core/frame-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-manager.js","sourceRoot":"","sources":["../../../src/core/frame-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/core/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Structured logging utility for StackMemory CLI
+ */
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+export declare class Logger {
+    private static instance;
+    private logLevel;
+    private logFile?;
+    private constructor();
+    static getInstance(): Logger;
+    private ensureLogDirectory;
+    private writeLog;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAUD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,OAAO;IA0BP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,QAAQ;IAgChB,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAUP,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAQhE;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/src/core/logger.js

@@ -0,0 +1,121 @@
+/**
+ * Structured logging utility for StackMemory CLI
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    static instance;
+    logLevel = LogLevel.INFO;
+    logFile;
+    constructor() {
+        // Set log level from environment
+        const envLevel = process.env.STACKMEMORY_LOG_LEVEL?.toUpperCase();
+        switch (envLevel) {
+            case 'ERROR':
+                this.logLevel = LogLevel.ERROR;
+                break;
+            case 'WARN':
+                this.logLevel = LogLevel.WARN;
+                break;
+            case 'DEBUG':
+                this.logLevel = LogLevel.DEBUG;
+                break;
+            default:
+                this.logLevel = LogLevel.INFO;
+        }
+        // Set up log file if in debug mode or if specified
+        if (this.logLevel === LogLevel.DEBUG || process.env.STACKMEMORY_LOG_FILE) {
+            this.logFile =
+                process.env.STACKMEMORY_LOG_FILE ||
+                    path.join(process.env.HOME || '.', '.stackmemory', 'logs', 'cli.log');
+            this.ensureLogDirectory();
+        }
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    ensureLogDirectory() {
+        if (this.logFile) {
+            const logDir = path.dirname(this.logFile);
+            if (!fs.existsSync(logDir)) {
+                fs.mkdirSync(logDir, { recursive: true });
+            }
+        }
+    }
+    writeLog(entry) {
+        const logLine = JSON.stringify(entry) + '\n';
+        // Always write to file if configured
+        if (this.logFile) {
+            try {
+                fs.appendFileSync(this.logFile, logLine);
+            }
+            catch {
+                // Silent failure to prevent recursive logging
+            }
+        }
+        // Console output based on level
+        if (entry.level <= this.logLevel) {
+            const levelNames = ['ERROR', 'WARN', 'INFO', 'DEBUG'];
+            const levelName = levelNames[entry.level] || 'UNKNOWN';
+            const consoleMessage = `[${entry.timestamp}] ${levelName}: ${entry.message}`;
+            if (entry.level === LogLevel.ERROR) {
+                console.error(consoleMessage);
+                if (entry.error) {
+                    console.error(entry.error.stack);
+                }
+            }
+            else if (entry.level === LogLevel.WARN) {
+                console.warn(consoleMessage);
+            }
+            else {
+                console.log(consoleMessage);
+            }
+        }
+    }
+    error(message, error, context) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.ERROR,
+            message,
+            context,
+            error,
+        });
+    }
+    warn(message, context) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.WARN,
+            message,
+            context,
+        });
+    }
+    info(message, context) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            message,
+            context,
+        });
+    }
+    debug(message, context) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.DEBUG,
+            message,
+            context,
+        });
+    }
+}
+// Export singleton instance
+export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map

package/dist/src/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/core/logger.ts"],"names":[],"mappings":"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"}

package/dist/src/core/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/src/core/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../../src/core/logger.test.ts"],"names":[],"mappings":""}

package/dist/src/core/logger.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { logger, LogLevel } from './logger.js';
+describe('Logger', () => {
+    let consoleSpy;
+    beforeEach(() => {
+        consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleSpy.mockRestore();
+    });
+    it('should have logger instance', () => {
+        expect(logger).toBeDefined();
+    });
+    it('should log info messages', () => {
+        logger.info('test message');
+        expect(consoleSpy).toHaveBeenCalled();
+    });
+    it('should have working methods', () => {
+        expect(typeof logger.debug).toBe('function');
+        expect(typeof logger.info).toBe('function');
+        expect(typeof logger.warn).toBe('function');
+        expect(typeof logger.error).toBe('function');
+    });
+    it('should have log levels defined', () => {
+        expect(LogLevel.DEBUG).toBe(3);
+        expect(LogLevel.INFO).toBe(2);
+        expect(LogLevel.WARN).toBe(1);
+        expect(LogLevel.ERROR).toBe(0);
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/src/core/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../../src/core/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,UAAuC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/index.d.ts

@@ -2,10 +2,10 @@
  * StackMemory - Lossless memory runtime for AI coding tools
  * Main entry point for the StackMemory package
  */
-export { FrameManager, type FrameType, type FrameState } from './frame-manager.js';
-export { logger, Logger, LogLevel } from './logger.js';
-export { StackMemoryError, ErrorCode, ErrorHandler } from './error-handler.js';
-export { default as LocalStackMemoryMCP } from './mcp-server.js';
+export { FrameManager, type FrameType, type FrameState, } from './core/frame-manager.js';
+export { logger, Logger, LogLevel } from './core/logger.js';
+export { StackMemoryError, ErrorCode, ErrorHandler, } from './core/error-handler.js';
+export { default as LocalStackMemoryMCP } from './mcp/mcp-server.js';
 export interface StackMemoryConfig {
     projectRoot?: string;
     dbPath?: string;

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGrE,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/index.js

@@ -2,8 +2,8 @@
  * StackMemory - Lossless memory runtime for AI coding tools
  * Main entry point for the StackMemory package
  */
-export { FrameManager } from './frame-manager.js';
-export { logger, Logger, LogLevel } from './logger.js';
-export { StackMemoryError, ErrorCode, ErrorHandler } from './error-handler.js';
-export { default as LocalStackMemoryMCP } from './mcp-server.js';
+export { FrameManager, } from './core/frame-manager.js';
+export { logger, Logger, LogLevel } from './core/logger.js';
+export { StackMemoryError, ErrorCode, ErrorHandler, } from './core/error-handler.js';
+export { default as LocalStackMemoryMCP } from './mcp/mcp-server.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAmC,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,GAGb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}