@stackmemoryai/stackmemory 0.2.7 → 0.2.8

package/dist/src/core/trace/trace-store.js

@@ -0,0 +1,323 @@
+/**
+ * Trace Store - Database persistence for traces
+ */
+import { TraceType, } from './types.js';
+import { logger } from '../monitoring/logger.js';
+export class TraceStore {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.initializeSchema();
+    }
+    /**
+     * Initialize database schema for traces
+     */
+    initializeSchema() {
+        // Check if frames table exists (it may not in all contexts)
+        const hasFramesTable = this.db
+            .prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name='frames'
+    `)
+            .get();
+        // Create traces table with optional foreign key
+        if (hasFramesTable) {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS traces (
+          id TEXT PRIMARY KEY,
+          type TEXT NOT NULL,
+          score REAL NOT NULL,
+          summary TEXT NOT NULL,
+          start_time INTEGER NOT NULL,
+          end_time INTEGER NOT NULL,
+          frame_id TEXT,
+          user_id TEXT,
+          files_modified TEXT,
+          errors_encountered TEXT,
+          decisions_recorded TEXT,
+          causal_chain INTEGER,
+          compressed_data TEXT,
+          created_at INTEGER DEFAULT (unixepoch()),
+          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE SET NULL
+        )
+      `);
+        }
+        else {
+            // Create without foreign key constraint
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS traces (
+          id TEXT PRIMARY KEY,
+          type TEXT NOT NULL,
+          score REAL NOT NULL,
+          summary TEXT NOT NULL,
+          start_time INTEGER NOT NULL,
+          end_time INTEGER NOT NULL,
+          frame_id TEXT,
+          user_id TEXT,
+          files_modified TEXT,
+          errors_encountered TEXT,
+          decisions_recorded TEXT,
+          causal_chain INTEGER,
+          compressed_data TEXT,
+          created_at INTEGER DEFAULT (unixepoch())
+        )
+      `);
+        }
+        // Create tool_calls table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS tool_calls (
+        id TEXT PRIMARY KEY,
+        trace_id TEXT NOT NULL,
+        tool TEXT NOT NULL,
+        arguments TEXT,
+        timestamp INTEGER NOT NULL,
+        result TEXT,
+        error TEXT,
+        files_affected TEXT,
+        duration INTEGER,
+        sequence_number INTEGER NOT NULL,
+        FOREIGN KEY (trace_id) REFERENCES traces(id) ON DELETE CASCADE
+      )
+    `);
+        // Create indexes
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_traces_type ON traces(type);
+      CREATE INDEX IF NOT EXISTS idx_traces_frame_id ON traces(frame_id);
+      CREATE INDEX IF NOT EXISTS idx_traces_start_time ON traces(start_time);
+      CREATE INDEX IF NOT EXISTS idx_traces_score ON traces(score);
+      CREATE INDEX IF NOT EXISTS idx_tool_calls_trace_id ON tool_calls(trace_id);
+      CREATE INDEX IF NOT EXISTS idx_tool_calls_timestamp ON tool_calls(timestamp);
+    `);
+    }
+    /**
+     * Save a trace to the database
+     */
+    saveTrace(trace) {
+        const traceStmt = this.db.prepare(`
+      INSERT OR REPLACE INTO traces (
+        id, type, score, summary, start_time, end_time,
+        frame_id, user_id, files_modified, errors_encountered,
+        decisions_recorded, causal_chain, compressed_data
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const toolCallStmt = this.db.prepare(`
+      INSERT OR REPLACE INTO tool_calls (
+        id, trace_id, tool, arguments, timestamp, result,
+        error, files_affected, duration, sequence_number
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        try {
+            this.db.transaction(() => {
+                // Save trace
+                traceStmt.run(trace.id, trace.type, trace.score, trace.summary, trace.metadata.startTime, trace.metadata.endTime, trace.metadata.frameId || null, trace.metadata.userId || null, JSON.stringify(trace.metadata.filesModified), JSON.stringify(trace.metadata.errorsEncountered), JSON.stringify(trace.metadata.decisionsRecorded), trace.metadata.causalChain ? 1 : 0, trace.compressed ? JSON.stringify(trace.compressed) : null);
+                // Save tool calls
+                trace.tools.forEach((tool, index) => {
+                    toolCallStmt.run(tool.id, trace.id, tool.tool, tool.arguments ? JSON.stringify(tool.arguments) : null, tool.timestamp, tool.result ? JSON.stringify(tool.result) : null, tool.error || null, tool.filesAffected ? JSON.stringify(tool.filesAffected) : null, tool.duration || null, index);
+                });
+            })();
+            logger.debug(`Saved trace ${trace.id} with ${trace.tools.length} tool calls`);
+        }
+        catch (error) {
+            logger.error(`Failed to save trace ${trace.id}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Load a trace by ID
+     */
+    getTrace(id) {
+        const traceRow = this.db
+            .prepare(`
+      SELECT * FROM traces WHERE id = ?
+    `)
+            .get(id);
+        if (!traceRow) {
+            return null;
+        }
+        const toolRows = this.db
+            .prepare(`
+      SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+    `)
+            .all(id);
+        return this.rowsToTrace(traceRow, toolRows);
+    }
+    /**
+     * Load all traces
+     */
+    getAllTraces() {
+        const traceRows = this.db
+            .prepare(`
+      SELECT * FROM traces ORDER BY start_time DESC
+    `)
+            .all();
+        return traceRows.map((traceRow) => {
+            const toolRows = this.db
+                .prepare(`
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `)
+                .all(traceRow.id);
+            return this.rowsToTrace(traceRow, toolRows);
+        });
+    }
+    /**
+     * Load traces by type
+     */
+    getTracesByType(type) {
+        const traceRows = this.db
+            .prepare(`
+      SELECT * FROM traces WHERE type = ? ORDER BY start_time DESC
+    `)
+            .all(type);
+        return traceRows.map((traceRow) => {
+            const toolRows = this.db
+                .prepare(`
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `)
+                .all(traceRow.id);
+            return this.rowsToTrace(traceRow, toolRows);
+        });
+    }
+    /**
+     * Load traces by frame
+     */
+    getTracesByFrame(frameId) {
+        const traceRows = this.db
+            .prepare(`
+      SELECT * FROM traces WHERE frame_id = ? ORDER BY start_time DESC
+    `)
+            .all(frameId);
+        return traceRows.map((traceRow) => {
+            const toolRows = this.db
+                .prepare(`
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `)
+                .all(traceRow.id);
+            return this.rowsToTrace(traceRow, toolRows);
+        });
+    }
+    /**
+     * Load high-importance traces
+     */
+    getHighImportanceTraces(minScore = 0.7) {
+        const traceRows = this.db
+            .prepare(`
+      SELECT * FROM traces WHERE score >= ? ORDER BY score DESC, start_time DESC
+    `)
+            .all(minScore);
+        return traceRows.map((traceRow) => {
+            const toolRows = this.db
+                .prepare(`
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `)
+                .all(traceRow.id);
+            return this.rowsToTrace(traceRow, toolRows);
+        });
+    }
+    /**
+     * Load error traces
+     */
+    getErrorTraces() {
+        const traceRows = this.db
+            .prepare(`
+      SELECT * FROM traces 
+      WHERE type = ? OR errors_encountered != '[]'
+      ORDER BY start_time DESC
+    `)
+            .all(TraceType.ERROR_RECOVERY);
+        return traceRows.map((traceRow) => {
+            const toolRows = this.db
+                .prepare(`
+        SELECT * FROM tool_calls WHERE trace_id = ? ORDER BY sequence_number
+      `)
+                .all(traceRow.id);
+            return this.rowsToTrace(traceRow, toolRows);
+        });
+    }
+    /**
+     * Get trace statistics
+     */
+    getStatistics() {
+        const stats = this.db
+            .prepare(`
+      SELECT 
+        COUNT(*) as total,
+        AVG(score) as avg_score,
+        AVG((
+          SELECT COUNT(*) FROM tool_calls WHERE trace_id = traces.id
+        )) as avg_length,
+        SUM(CASE WHEN type = ? OR errors_encountered != '[]' THEN 1 ELSE 0 END) * 100.0 / COUNT(*) as error_rate
+      FROM traces
+    `)
+            .get(TraceType.ERROR_RECOVERY);
+        const typeStats = this.db
+            .prepare(`
+      SELECT type, COUNT(*) as count
+      FROM traces
+      GROUP BY type
+    `)
+            .all();
+        const tracesByType = {};
+        typeStats.forEach((row) => {
+            tracesByType[row.type] = row.count;
+        });
+        return {
+            totalTraces: stats.total || 0,
+            tracesByType,
+            averageScore: stats.avg_score || 0,
+            averageLength: stats.avg_length || 0,
+            errorRate: stats.error_rate || 0,
+        };
+    }
+    /**
+     * Delete old traces
+     */
+    deleteOldTraces(olderThanMs) {
+        const cutoff = Date.now() - olderThanMs;
+        const result = this.db
+            .prepare(`
+      DELETE FROM traces WHERE start_time < ?
+    `)
+            .run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Convert database rows to Trace object
+     */
+    rowsToTrace(traceRow, toolRows) {
+        const tools = toolRows.map((row) => ({
+            id: row.id,
+            tool: row.tool,
+            arguments: row.arguments ? JSON.parse(row.arguments) : undefined,
+            timestamp: row.timestamp,
+            result: row.result ? JSON.parse(row.result) : undefined,
+            error: row.error || undefined,
+            filesAffected: row.files_affected
+                ? JSON.parse(row.files_affected)
+                : undefined,
+            duration: row.duration || undefined,
+        }));
+        const metadata = {
+            startTime: traceRow.start_time,
+            endTime: traceRow.end_time,
+            frameId: traceRow.frame_id || undefined,
+            userId: traceRow.user_id || undefined,
+            filesModified: JSON.parse(traceRow.files_modified || '[]'),
+            errorsEncountered: JSON.parse(traceRow.errors_encountered || '[]'),
+            decisionsRecorded: JSON.parse(traceRow.decisions_recorded || '[]'),
+            causalChain: traceRow.causal_chain === 1,
+        };
+        const trace = {
+            id: traceRow.id,
+            type: traceRow.type,
+            tools,
+            score: traceRow.score,
+            summary: traceRow.summary,
+            metadata,
+        };
+        if (traceRow.compressed_data) {
+            trace.compressed = JSON.parse(traceRow.compressed_data);
+        }
+        return trace;
+    }
+}
+//# sourceMappingURL=trace-store.js.map

package/dist/src/core/trace/trace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.js","sourceRoot":"","sources":["../../../../src/core/trace/trace-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,SAAS,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,OAAO,UAAU;IACb,EAAE,CAAoB;IAE9B,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,4DAA4D;QAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE;aAC3B,OAAO,CACN;;;KAGH,CACE;aACA,GAAG,EAAE,CAAC;QAET,gDAAgD;QAChD,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;OAkBZ,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;OAiBZ,CAAC,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;KAcZ,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAY;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;KAMjC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;KAKpC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBACvB,aAAa;gBACb,SAAS,CAAC,GAAG,CACX,KAAK,CAAC,EAAE,EACR,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,CAAC,SAAS,EACxB,KAAK,CAAC,QAAQ,CAAC,OAAO,EACtB,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,EAC9B,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,EAC7B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAC5C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAChD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAChD,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAClC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAC3D,CAAC;gBAEF,kBAAkB;gBAClB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;oBAClC,YAAY,CAAC,GAAG,CACd,IAAI,CAAC,EAAE,EACP,KAAK,CAAC,EAAE,EACR,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EACtD,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAChD,IAAI,CAAC,KAAK,IAAI,IAAI,EAClB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAC9D,IAAI,CAAC,QAAQ,IAAI,IAAI,EACrB,KAAK,CACN,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;YAEL,MAAM,CAAC,KAAK,CACV,eAAe,KAAK,CAAC,EAAE,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,aAAa,CAChE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,EAAE,GAAG,EAAE,KAAc,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;aACrB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,EAAE,CAAQ,CAAC;QAElB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;aACrB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,EAAE,CAAU,CAAC;QAEpB,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,EAAW,CAAC;QAElB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN;;OAEH,CACE;iBACA,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAU,CAAC;YAE7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAe;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,IAAI,CAAU,CAAC;QAEtB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN;;OAEH,CACE;iBACA,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAU,CAAC;YAE7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAe;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,OAAO,CAAU,CAAC;QAEzB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN;;OAEH,CACE;iBACA,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAU,CAAC;YAE7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,WAAmB,GAAG;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,QAAQ,CAAU,CAAC;QAE1B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN;;OAEH,CACE;iBACA,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAU,CAAC;YAE7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;;;KAIH,CACE;aACA,GAAG,CAAC,SAAS,CAAC,cAAc,CAAU,CAAC;QAE1C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN;;OAEH,CACE;iBACA,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAU,CAAC;YAE7B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa;QAOX,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE;aAClB,OAAO,CACN;;;;;;;;;KASH,CACE;aACA,GAAG,CAAC,SAAS,CAAC,cAAc,CAAQ,CAAC;QAExC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN;;;;KAIH,CACE;aACA,GAAG,EAAW,CAAC;QAElB,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACxB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;YAC7B,YAAY;YACZ,YAAY,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;YAClC,aAAa,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,WAAmB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,OAAO,CACN;;KAEH,CACE;aACA,GAAG,CAAC,MAAM,CAAC,CAAC;QAEf,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,QAAa,EAAE,QAAe;QAChD,MAAM,KAAK,GAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAChE,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;YAC7B,aAAa,EAAE,GAAG,CAAC,cAAc;gBAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC;gBAChC,CAAC,CAAC,SAAS;YACb,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;SACpC,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAkB;YAC9B,SAAS,EAAE,QAAQ,CAAC,UAAU;YAC9B,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,OAAO,EAAE,QAAQ,CAAC,QAAQ,IAAI,SAAS;YACvC,MAAM,EAAE,QAAQ,CAAC,OAAO,IAAI,SAAS;YACrC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC;YAC1D,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,IAAI,IAAI,CAAC;YAClE,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,IAAI,IAAI,CAAC;YAClE,WAAW,EAAE,QAAQ,CAAC,YAAY,KAAK,CAAC;SACzC,CAAC;QAEF,MAAM,KAAK,GAAU;YACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ,CAAC,IAAiB;YAChC,KAAK;YACL,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ;SACT,CAAC;QAEF,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/core/trace/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Types for Trace Detection and Bundling System
+ */
+export interface ToolCall {
+    id: string;
+    tool: string;
+    arguments?: Record<string, any>;
+    timestamp: number;
+    result?: any;
+    error?: string;
+    filesAffected?: string[];
+    duration?: number;
+}
+export interface Trace {
+    id: string;
+    type: TraceType;
+    tools: ToolCall[];
+    score: number;
+    summary: string;
+    compressed?: CompressedTrace;
+    metadata: TraceMetadata;
+}
+export interface CompressedTrace {
+    pattern: string;
+    summary: string;
+    score: number;
+    toolCount: number;
+    duration: number;
+    timestamp: number;
+}
+export interface TraceMetadata {
+    startTime: number;
+    endTime: number;
+    frameId?: string;
+    userId?: string;
+    filesModified: string[];
+    errorsEncountered: string[];
+    decisionsRecorded: string[];
+    causalChain: boolean;
+}
+export declare enum TraceType {
+    SEARCH_DRIVEN = "search_driven",
+    ERROR_RECOVERY = "error_recovery",
+    FEATURE_IMPLEMENTATION = "feature_implementation",
+    REFACTORING = "refactoring",
+    TESTING = "testing",
+    EXPLORATION = "exploration",
+    DEBUGGING = "debugging",
+    DOCUMENTATION = "documentation",
+    BUILD_DEPLOY = "build_deploy",
+    UNKNOWN = "unknown"
+}
+export interface TraceBoundaryConfig {
+    timeProximityMs: number;
+    sameDirThreshold: boolean;
+    causalRelationship: boolean;
+    maxTraceSize: number;
+    compressionThreshold: number;
+}
+export declare const DEFAULT_TRACE_CONFIG: TraceBoundaryConfig;
+export interface TracePattern {
+    pattern: RegExp | string[];
+    type: TraceType;
+    description: string;
+}
+export declare const TRACE_PATTERNS: TracePattern[];
+export interface TraceScoringFactors {
+    toolScores: number[];
+    hasDecisions: boolean;
+    hasErrors: boolean;
+    filesModifiedCount: number;
+    isPermanent: boolean;
+    referenceCount: number;
+}
+export declare enum CompressionStrategy {
+    SUMMARY_ONLY = "summary_only",// Keep only summary and score
+    PATTERN_BASED = "pattern_based",// Keep pattern and outcome
+    SELECTIVE = "selective",// Keep high-score tools only
+    FULL_COMPRESSION = "full_compression"
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/trace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,oBAAoB,EAAE,mBAMlC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,eAAO,MAAM,cAAc,EAAE,YAAY,EAoCxC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,oBAAY,mBAAmB;IAC7B,YAAY,iBAAiB,CAAE,8BAA8B;IAC7D,aAAa,kBAAkB,CAAE,2BAA2B;IAC5D,SAAS,cAAc,CAAE,6BAA6B;IACtD,gBAAgB,qBAAqB;CACtC"}

package/dist/src/core/trace/types.js

@@ -0,0 +1,70 @@
+/**
+ * Types for Trace Detection and Bundling System
+ */
+export var TraceType;
+(function (TraceType) {
+    TraceType["SEARCH_DRIVEN"] = "search_driven";
+    TraceType["ERROR_RECOVERY"] = "error_recovery";
+    TraceType["FEATURE_IMPLEMENTATION"] = "feature_implementation";
+    TraceType["REFACTORING"] = "refactoring";
+    TraceType["TESTING"] = "testing";
+    TraceType["EXPLORATION"] = "exploration";
+    TraceType["DEBUGGING"] = "debugging";
+    TraceType["DOCUMENTATION"] = "documentation";
+    TraceType["BUILD_DEPLOY"] = "build_deploy";
+    TraceType["UNKNOWN"] = "unknown";
+})(TraceType || (TraceType = {}));
+export const DEFAULT_TRACE_CONFIG = {
+    timeProximityMs: 30000, // 30 seconds
+    sameDirThreshold: true,
+    causalRelationship: true,
+    maxTraceSize: 50,
+    compressionThreshold: 24, // Compress after 24 hours
+};
+// Common patterns for trace type detection
+export const TRACE_PATTERNS = [
+    {
+        pattern: ['search', 'grep', 'read', 'edit'],
+        type: TraceType.SEARCH_DRIVEN,
+        description: 'Search-driven code modification',
+    },
+    {
+        pattern: ['bash', 'error', 'edit', 'bash'],
+        type: TraceType.ERROR_RECOVERY,
+        description: 'Error recovery sequence',
+    },
+    {
+        pattern: ['write', 'edit', 'test'],
+        type: TraceType.FEATURE_IMPLEMENTATION,
+        description: 'New feature implementation',
+    },
+    {
+        pattern: ['read', 'edit', 'edit', 'test'],
+        type: TraceType.REFACTORING,
+        description: 'Code refactoring',
+    },
+    {
+        pattern: ['test', 'bash', 'test'],
+        type: TraceType.TESTING,
+        description: 'Test execution and validation',
+    },
+    {
+        pattern: ['grep', 'search', 'read'],
+        type: TraceType.EXPLORATION,
+        description: 'Codebase exploration',
+    },
+    {
+        pattern: ['bash', 'build', 'deploy'],
+        type: TraceType.BUILD_DEPLOY,
+        description: 'Build and deployment',
+    },
+];
+// Trace compression strategies
+export var CompressionStrategy;
+(function (CompressionStrategy) {
+    CompressionStrategy["SUMMARY_ONLY"] = "summary_only";
+    CompressionStrategy["PATTERN_BASED"] = "pattern_based";
+    CompressionStrategy["SELECTIVE"] = "selective";
+    CompressionStrategy["FULL_COMPRESSION"] = "full_compression";
+})(CompressionStrategy || (CompressionStrategy = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/core/trace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/trace/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2CH,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,8DAAiD,CAAA;IACjD,wCAA2B,CAAA;IAC3B,gCAAmB,CAAA;IACnB,wCAA2B,CAAA;IAC3B,oCAAuB,CAAA;IACvB,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,gCAAmB,CAAA;AACrB,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB;AAUD,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,eAAe,EAAE,KAAK,EAAE,aAAa;IACrC,gBAAgB,EAAE,IAAI;IACtB,kBAAkB,EAAE,IAAI;IACxB,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,EAAE,EAAE,0BAA0B;CACrD,CAAC;AAQF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC3C,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,WAAW,EAAE,iCAAiC;KAC/C;IACD;QACE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;QAC1C,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;QAClC,IAAI,EAAE,SAAS,CAAC,sBAAsB;QACtC,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACzC,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;QACnC,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,WAAW,EAAE,sBAAsB;KACpC;IACD;QACE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;QACpC,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,WAAW,EAAE,sBAAsB;KACpC;CACF,CAAC;AAWF,+BAA+B;AAC/B,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,oDAA6B,CAAA;IAC7B,sDAA+B,CAAA;IAC/B,8CAAuB,CAAA;IACvB,4DAAqC,CAAA;AACvC,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B"}

package/dist/src/integrations/linear/sync-manager.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Linear Sync Manager
+ * Handles periodic and event-based synchronization with Linear
+ */
+import { EventEmitter } from 'events';
+import { SyncConfig, SyncResult } from './sync.js';
+import { PebblesTaskStore } from '../../features/tasks/pebbles-task-store.js';
+import { LinearAuthManager } from './auth.js';
+export interface SyncManagerConfig extends SyncConfig {
+    autoSyncInterval?: number;
+    syncOnTaskChange?: boolean;
+    syncOnSessionStart?: boolean;
+    syncOnSessionEnd?: boolean;
+    debounceInterval?: number;
+}
+export declare class LinearSyncManager extends EventEmitter {
+    private syncEngine;
+    private syncTimer?;
+    private pendingSyncTimer?;
+    private config;
+    private lastSyncTime;
+    private syncInProgress;
+    private taskStore;
+    constructor(taskStore: PebblesTaskStore, authManager: LinearAuthManager, config: SyncManagerConfig, projectRoot?: string);
+    /**
+     * Setup event listeners for automatic sync triggers
+     */
+    private setupEventListeners;
+    /**
+     * Setup periodic sync timer
+     */
+    private setupPeriodicSync;
+    /**
+     * Schedule a debounced sync to avoid too frequent syncs
+     */
+    private scheduleDebouncedSync;
+    /**
+     * Perform a sync operation
+     */
+    performSync(trigger: 'manual' | 'periodic' | 'task-change' | 'session-start' | 'session-end'): Promise<SyncResult>;
+    /**
+     * Sync on session start
+     */
+    syncOnStart(): Promise<SyncResult | null>;
+    /**
+     * Sync on session end
+     */
+    syncOnEnd(): Promise<SyncResult | null>;
+    /**
+     * Update sync configuration
+     */
+    updateConfig(newConfig: Partial<SyncManagerConfig>): void;
+    /**
+     * Get sync status
+     */
+    getStatus(): {
+        enabled: boolean;
+        syncInProgress: boolean;
+        lastSyncTime: number;
+        nextSyncTime: number | null;
+        config: SyncManagerConfig;
+    };
+    /**
+     * Stop all sync activities
+     */
+    stop(): void;
+    /**
+     * Force an immediate sync
+     */
+    forceSync(): Promise<SyncResult>;
+}
+/**
+ * Default sync manager configuration
+ */
+export declare const DEFAULT_SYNC_MANAGER_CONFIG: SyncManagerConfig;
+//# sourceMappingURL=sync-manager.d.ts.map

package/dist/src/integrations/linear/sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/linear/sync-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAoB,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,SAAS,CAAmB;gBAGlC,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,MAAM;IAwBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACG,WAAW,CACf,OAAO,EACH,QAAQ,GACR,UAAU,GACV,aAAa,GACb,eAAe,GACf,aAAa,GAChB,OAAO,CAAC,UAAU,CAAC;IA8EtB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAO/C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAO7C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAazD;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE,iBAAiB,CAAC;KAC3B;IAeD;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;CAGvC;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAUzC,CAAC"}