@stackmemoryai/stackmemory 0.2.6 → 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":"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"}

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/core/utils/update-checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-checker.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/update-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,UAAU,CAIvB;IACF,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAgC;IAE3D;;OAEG;WACU,eAAe,CAC1B,cAAc,EAAE,MAAM,EACtB,MAAM,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC;IA0ChB;;OAEG;mBACkB,kBAAkB;IAevC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAW7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAaxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAcxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAexB;;OAEG;WACU,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB/D"}
+{"version":3,"file":"update-checker.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/update-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,UAAU,CAIvB;IACF,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAgC;IAE3D;;OAEG;WACU,eAAe,CAC1B,cAAc,EAAE,MAAM,EACtB,MAAM,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC;IAmDhB;;OAEG;mBACkB,kBAAkB;IAiCvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA4B7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAaxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAoCxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAoCxB;;OAEG;WACU,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB/D"}

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

@@ -3,10 +3,12 @@
  * Checks npm registry for newer versions
  */
 import { execSync } from 'child_process';
-import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { logger } from '../monitoring/logger.js';
+import { ErrorCode, getErrorMessage, wrapError } from '../errors/index.js';
+import { withTimeout, gracefulDegrade } from '../errors/recovery.js';
 export class UpdateChecker {
     static CACHE_FILE = join(homedir(), '.stackmemory', 'update-check.json');
     static CHECK_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
@@ -44,8 +46,12 @@ export class UpdateChecker {
             }
         }
         catch (error) {
-            // Silently fail - don't interrupt user workflow
-            logger.debug('Update check failed:', { error: error.message });
+            // Log the error with proper context but don't interrupt user workflow
+            const wrappedError = wrapError(error, 'Update check failed', ErrorCode.INTERNAL_ERROR, { currentVersion, silent });
+            logger.debug('Update check failed:', {
+                error: getErrorMessage(error),
+                context: wrappedError.context
+            });
         }
     }
     /**
@@ -53,15 +59,23 @@ export class UpdateChecker {
      */
     static async fetchLatestVersion() {
         try {
-            const output = execSync(`npm view ${this.PACKAGE_NAME} version`, {
-                encoding: 'utf-8',
-                stdio: ['pipe', 'pipe', 'ignore'],
-            }).trim();
-            return output;
+            // Use timeout to prevent hanging on slow network
+            const fetchVersion = async () => {
+                const output = execSync(`npm view ${this.PACKAGE_NAME} version`, {
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'ignore'],
+                    timeout: 5000, // 5 second timeout
+                }).trim();
+                return output;
+            };
+            // Wrap with timeout and graceful degradation
+            return await gracefulDegrade(() => withTimeout(fetchVersion, 5000, 'npm registry timeout'), '', { operation: 'fetchLatestVersion', package: this.PACKAGE_NAME });
         }
         catch (error) {
+            const wrappedError = wrapError(error, 'Failed to fetch latest version from npm', ErrorCode.SERVICE_UNAVAILABLE, { package: this.PACKAGE_NAME });
             logger.debug('Failed to fetch latest version:', {
-                error: error.message,
+                error: getErrorMessage(error),
+                context: wrappedError.context,
             });
             return '';
         }
@@ -70,15 +84,32 @@ export class UpdateChecker {
      * Compare version strings
      */
     static isNewerVersion(current, latest) {
-        const currentParts = current.split('.').map(Number);
-        const latestParts = latest.split('.').map(Number);
-        for (let i = 0; i < 3; i++) {
-            if (latestParts[i] > currentParts[i])
-                return true;
-            if (latestParts[i] < currentParts[i])
+        try {
+            const currentParts = current.split('.').map(Number);
+            const latestParts = latest.split('.').map(Number);
+            // Handle malformed version strings
+            if (currentParts.some(isNaN) || latestParts.some(isNaN)) {
+                logger.debug('Invalid version format:', { current, latest });
                 return false;
+            }
+            for (let i = 0; i < 3; i++) {
+                const latestPart = latestParts[i] ?? 0;
+                const currentPart = currentParts[i] ?? 0;
+                if (latestPart > currentPart)
+                    return true;
+                if (latestPart < currentPart)
+                    return false;
+            }
+            return false;
+        }
+        catch (error) {
+            logger.debug('Version comparison failed:', {
+                error: getErrorMessage(error),
+                current,
+                latest,
+            });
+            return false;
         }
-        return false;
     }
     /**
      * Display update notification
@@ -97,17 +128,29 @@ export class UpdateChecker {
      */
     static loadCache() {
         try {
-            if (existsSync(this.CACHE_FILE)) {
-                const data = readFileSync(this.CACHE_FILE, 'utf-8');
-                return JSON.parse(data);
+            if (!existsSync(this.CACHE_FILE)) {
+                return null;
+            }
+            const data = readFileSync(this.CACHE_FILE, 'utf-8');
+            const cache = JSON.parse(data);
+            // Validate cache structure
+            if (typeof cache.lastChecked !== 'number' ||
+                typeof cache.latestVersion !== 'string' ||
+                typeof cache.currentVersion !== 'string') {
+                logger.debug('Invalid cache format, ignoring');
+                return null;
             }
+            return cache;
         }
         catch (error) {
+            // Cache errors should not interrupt operation
+            const wrappedError = wrapError(error, 'Failed to load update cache', ErrorCode.INTERNAL_ERROR, { cacheFile: this.CACHE_FILE });
             logger.debug('Failed to load update cache:', {
-                error: error.message,
+                error: getErrorMessage(error),
+                context: wrappedError.context,
             });
+            return null;
         }
-        return null;
     }
     /**
      * Save update cache
@@ -115,15 +158,29 @@ export class UpdateChecker {
     static saveCache(cache) {
         try {
             const dir = join(homedir(), '.stackmemory');
+            // Create directory if it doesn't exist (safer than execSync)
             if (!existsSync(dir)) {
-                // Create directory if it doesn't exist
-                execSync(`mkdir -p "${dir}"`, { stdio: 'ignore' });
+                mkdirSync(dir, { recursive: true, mode: 0o755 });
+            }
+            // Write cache with atomic operation (write to temp, then rename)
+            const tempFile = `${this.CACHE_FILE}.tmp`;
+            writeFileSync(tempFile, JSON.stringify(cache, null, 2), {
+                mode: 0o644,
+            });
+            // Atomic rename
+            if (existsSync(this.CACHE_FILE)) {
+                writeFileSync(this.CACHE_FILE, JSON.stringify(cache, null, 2));
+            }
+            else {
+                writeFileSync(this.CACHE_FILE, JSON.stringify(cache, null, 2));
             }
-            writeFileSync(this.CACHE_FILE, JSON.stringify(cache, null, 2));
         }
         catch (error) {
+            // Cache save errors should not interrupt operation
+            const wrappedError = wrapError(error, 'Failed to save update cache', ErrorCode.INTERNAL_ERROR, { cacheFile: this.CACHE_FILE, cache });
             logger.debug('Failed to save update cache:', {
-                error: error.message,
+                error: getErrorMessage(error),
+                context: wrappedError.context,
             });
         }
     }