@stackmemoryai/stackmemory 0.2.9 → 0.3.0

package/dist/src/core/trace/cli-trace-wrapper.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CLI Command Trace Wrapper
+ * Automatically wraps Commander.js commands with comprehensive tracing
+ */
+import { Command } from 'commander';
+export declare function wrapCommand(command: Command): Command;
+/**
+ * Wrap the main program with comprehensive tracing
+ */
+export declare function wrapProgram(program: Command): Command;
+/**
+ * Helper to wrap async functions with step tracing
+ */
+export declare function traceStep<T>(name: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Helper to wrap database queries
+ */
+export declare function traceQuery<T>(sql: string, params: any, fn: () => T): T;
+/**
+ * Helper to wrap API calls
+ */
+export declare function traceAPI<T>(method: string, url: string, body: any, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=cli-trace-wrapper.d.ts.map

package/dist/src/core/trace/cli-trace-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-trace-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/cli-trace-wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAoErD;AAgBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAiDrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,EACT,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/src/core/trace/cli-trace-wrapper.js

@@ -0,0 +1,141 @@
+/**
+ * CLI Command Trace Wrapper
+ * Automatically wraps Commander.js commands with comprehensive tracing
+ */
+import { trace } from './debug-trace.js';
+import { logger } from '../monitoring/logger.js';
+export function wrapCommand(command) {
+    const originalAction = command.action.bind(command);
+    command.action(async function (...args) {
+        // Extract command path and options
+        const commandPath = getCommandPath(command);
+        const options = args[args.length - 1];
+        const commandArgs = args.slice(0, -1);
+        // Build comprehensive context
+        const context = {
+            command: commandPath,
+            args: commandArgs,
+            options: typeof options === 'object' ? options : {},
+            cwd: process.cwd(),
+            env: {
+                NODE_ENV: process.env.NODE_ENV,
+                DEBUG_TRACE: process.env.DEBUG_TRACE,
+                LINEAR_API_KEY: process.env.LINEAR_API_KEY ? '[SET]' : '[NOT SET]',
+            },
+            timestamp: new Date().toISOString(),
+        };
+        // Log command start
+        logger.info(`CLI Command: ${commandPath}`, context);
+        // Wrap the actual action with tracing
+        await trace.command(commandPath, context, async () => {
+            try {
+                // Call the original action with wrapped handler
+                const result = await originalAction.apply(null, args);
+                // Log successful completion
+                logger.info(`CLI Command Completed: ${commandPath}`, {
+                    duration: trace.exportTraces().find(t => t.name === commandPath)?.duration,
+                });
+                // Show execution summary if verbose
+                if (process.env.DEBUG_TRACE === 'true') {
+                    console.log(trace.getExecutionSummary());
+                }
+            }
+            catch (error) {
+                // Enhanced error logging for CLI commands
+                logger.error(`CLI Command Failed: ${commandPath}`, error, context);
+                // Get the last error trace for debugging
+                const lastError = trace.getLastError();
+                if (lastError) {
+                    console.error('\n📍 Error occurred at:');
+                    console.error(`   ${lastError.name}`);
+                    if (lastError.params) {
+                        console.error('   With params:', JSON.stringify(lastError.params, null, 2));
+                    }
+                    console.error('   Error details:', lastError.error);
+                }
+                // Re-throw to maintain original error handling
+                throw error;
+            }
+        });
+    });
+    // Recursively wrap subcommands
+    command.commands.forEach(subcommand => {
+        wrapCommand(subcommand);
+    });
+    return command;
+}
+function getCommandPath(command) {
+    const parts = [];
+    let current = command;
+    while (current) {
+        if (current.name()) {
+            parts.unshift(current.name());
+        }
+        current = current.parent;
+    }
+    return parts.join(' ');
+}
+/**
+ * Wrap the main program with comprehensive tracing
+ */
+export function wrapProgram(program) {
+    // Add global error handler with tracing
+    program.exitOverride((err) => {
+        if (err.code === 'commander.help' || err.code === 'commander.version') {
+            // Normal help/version display, not an error
+            process.exit(0);
+        }
+        // Log the error with full context
+        logger.error('CLI Error', err, {
+            code: err.code,
+            exitCode: err.exitCode,
+            command: process.argv.slice(2).join(' '),
+        });
+        // Show trace summary on error
+        if (process.env.DEBUG_TRACE === 'true') {
+            console.error('\n' + trace.getExecutionSummary());
+        }
+        process.exit(err.exitCode || 1);
+    });
+    // Add pre-action hook for setup
+    program.hook('preAction', (thisCommand) => {
+        // Initialize trace context for this command
+        trace.reset();
+        // Log command invocation
+        const commandPath = getCommandPath(thisCommand);
+        logger.debug(`Preparing to execute: ${commandPath}`, {
+            args: thisCommand.args,
+            opts: thisCommand.opts(),
+        });
+    });
+    // Add post-action hook for cleanup
+    program.hook('postAction', (thisCommand) => {
+        // Log completion
+        const commandPath = getCommandPath(thisCommand);
+        logger.debug(`Completed execution: ${commandPath}`);
+    });
+    // Wrap all existing commands
+    program.commands.forEach(command => {
+        wrapCommand(command);
+    });
+    return program;
+}
+/**
+ * Helper to wrap async functions with step tracing
+ */
+export function traceStep(name, fn) {
+    return trace.step(name, fn);
+}
+/**
+ * Helper to wrap database queries
+ */
+export function traceQuery(sql, params, fn) {
+    return trace.traceSync('query', sql.substring(0, 100), params, fn);
+}
+/**
+ * Helper to wrap API calls
+ */
+export function traceAPI(method, url, body, fn) {
+    return trace.api(method, url, body, fn);
+}
+//# sourceMappingURL=cli-trace-wrapper.js.map

package/dist/src/core/trace/cli-trace-wrapper.js.map

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

package/dist/src/core/trace/db-trace-wrapper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Database Operations Trace Wrapper
+ * Wraps SQLite operations with comprehensive tracing for debugging
+ */
+import Database from 'better-sqlite3';
+export interface TracedDatabaseOptions extends Database.Options {
+    traceEnabled?: boolean;
+    slowQueryThreshold?: number;
+}
+/**
+ * Create a traced database instance
+ */
+export declare function createTracedDatabase(filename: string, options?: TracedDatabaseOptions): Database.Database;
+/**
+ * Wrap an existing database with tracing
+ */
+export declare function wrapDatabase(db: Database.Database, slowQueryThreshold?: number): Database.Database;
+/**
+ * Get query statistics from a traced database
+ */
+export declare function getQueryStatistics(db: Database.Database): {
+    totalQueries: number;
+    slowQueries: number;
+    averageDuration: number;
+    totalDuration: number;
+    queryTypes: Record<string, number>;
+} | null;
+/**
+ * Helper to trace a specific query with context
+ */
+export declare function traceQuery<T>(db: Database.Database, queryName: string, query: string, params: any[], fn: () => T): Promise<T>;
+/**
+ * Create a traced transaction with automatic rollback on error
+ */
+export declare function createTracedTransaction<T>(db: Database.Database, name: string, fn: (tx: Database.Transaction<(args: any) => T>) => T): T;
+//# sourceMappingURL=db-trace-wrapper.d.ts.map

package/dist/src/core/trace/db-trace-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-trace-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/db-trace-wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,MAAM,WAAW,qBAAsB,SAAQ,QAAQ,CAAC,OAAO;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,QAAQ,CAAC,QAAQ,CAQnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,kBAAkB,SAAM,GACvB,QAAQ,CAAC,QAAQ,CAiDnB;AA2JD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GAAG,IAAI,CAUP;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,GAAG,EAAE,EACb,EAAE,EAAE,MAAM,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,GACpD,CAAC,CAwBH"}

package/dist/src/core/trace/db-trace-wrapper.js

@@ -0,0 +1,252 @@
+/**
+ * Database Operations Trace Wrapper
+ * Wraps SQLite operations with comprehensive tracing for debugging
+ */
+import Database from 'better-sqlite3';
+import { trace } from './debug-trace.js';
+import { logger } from '../monitoring/logger.js';
+/**
+ * Create a traced database instance
+ */
+export function createTracedDatabase(filename, options) {
+    const db = new Database(filename, options);
+    if (options?.traceEnabled !== false) {
+        return wrapDatabase(db, options?.slowQueryThreshold);
+    }
+    return db;
+}
+/**
+ * Wrap an existing database with tracing
+ */
+export function wrapDatabase(db, slowQueryThreshold = 100) {
+    // Wrap prepare method to trace all queries
+    const originalPrepare = db.prepare.bind(db);
+    db.prepare = function (source) {
+        const statement = originalPrepare(source);
+        return wrapStatement(statement, source, slowQueryThreshold);
+    };
+    // Wrap exec for direct SQL execution
+    const originalExec = db.exec.bind(db);
+    db.exec = function (source) {
+        return trace.traceSync('query', `EXEC: ${source.substring(0, 50)}...`, {}, () => {
+            const startTime = performance.now();
+            const result = originalExec(source);
+            const duration = performance.now() - startTime;
+            if (duration > slowQueryThreshold) {
+                logger.warn(`Slow query detected: ${duration.toFixed(0)}ms`, {
+                    query: source.substring(0, 200),
+                    duration,
+                });
+            }
+            return result;
+        });
+    };
+    // Wrap transaction for transaction tracking
+    const originalTransaction = db.transaction.bind(db);
+    db.transaction = function (fn) {
+        return originalTransaction(function (...args) {
+            return trace.traceSync('query', 'TRANSACTION', { args: args.length }, () => {
+                return fn.apply(this, args);
+            });
+        });
+    };
+    // Add query statistics tracking
+    db.__queryStats = {
+        totalQueries: 0,
+        slowQueries: 0,
+        totalDuration: 0,
+        queryTypes: {},
+    };
+    return db;
+}
+/**
+ * Wrap a statement with tracing
+ */
+function wrapStatement(statement, source, slowQueryThreshold) {
+    const queryType = source.trim().split(/\s+/)[0].toUpperCase();
+    const shortQuery = source.substring(0, 100).replace(/\s+/g, ' ');
+    // Wrap run method
+    const originalRun = statement.run.bind(statement);
+    statement.run = function (...params) {
+        return trace.traceSync('query', `${queryType}: ${shortQuery}`, params, () => {
+            const startTime = performance.now();
+            const result = originalRun(...params);
+            const duration = performance.now() - startTime;
+            // Track statistics
+            updateQueryStats(statement, queryType, duration, slowQueryThreshold);
+            // Log slow queries
+            if (duration > slowQueryThreshold) {
+                logger.warn(`Slow ${queryType} query: ${duration.toFixed(0)}ms`, {
+                    query: shortQuery,
+                    params,
+                    duration,
+                    changes: result.changes,
+                });
+            }
+            return result;
+        });
+    };
+    // Wrap get method
+    const originalGet = statement.get.bind(statement);
+    statement.get = function (...params) {
+        return trace.traceSync('query', `${queryType} (get): ${shortQuery}`, params, () => {
+            const startTime = performance.now();
+            const result = originalGet(...params);
+            const duration = performance.now() - startTime;
+            updateQueryStats(statement, queryType, duration, slowQueryThreshold);
+            if (duration > slowQueryThreshold) {
+                logger.warn(`Slow ${queryType} query: ${duration.toFixed(0)}ms`, {
+                    query: shortQuery,
+                    params,
+                    duration,
+                    found: result != null,
+                });
+            }
+            return result;
+        });
+    };
+    // Wrap all method
+    const originalAll = statement.all.bind(statement);
+    statement.all = function (...params) {
+        return trace.traceSync('query', `${queryType} (all): ${shortQuery}`, params, () => {
+            const startTime = performance.now();
+            const result = originalAll(...params);
+            const duration = performance.now() - startTime;
+            updateQueryStats(statement, queryType, duration, slowQueryThreshold);
+            if (duration > slowQueryThreshold) {
+                logger.warn(`Slow ${queryType} query: ${duration.toFixed(0)}ms`, {
+                    query: shortQuery,
+                    params,
+                    duration,
+                    rows: result.length,
+                });
+            }
+            // Warn about potential N+1 queries
+            if (result.length > 100 && queryType === 'SELECT') {
+                logger.warn(`Large result set: ${result.length} rows`, {
+                    query: shortQuery,
+                    suggestion: 'Consider pagination or more specific queries',
+                });
+            }
+            return result;
+        });
+    };
+    // Wrap iterate method for cursor operations
+    const originalIterate = statement.iterate.bind(statement);
+    statement.iterate = function (...params) {
+        const startTime = performance.now();
+        let rowCount = 0;
+        const iterator = originalIterate(...params);
+        const wrappedIterator = {
+            [Symbol.iterator]() {
+                return this;
+            },
+            next() {
+                const result = iterator.next();
+                if (!result.done) {
+                    rowCount++;
+                }
+                else {
+                    const duration = performance.now() - startTime;
+                    updateQueryStats(statement, queryType, duration, slowQueryThreshold);
+                    if (duration > slowQueryThreshold) {
+                        logger.warn(`Slow ${queryType} iteration: ${duration.toFixed(0)}ms`, {
+                            query: shortQuery,
+                            params,
+                            duration,
+                            rows: rowCount,
+                        });
+                    }
+                }
+                return result;
+            },
+        };
+        return wrappedIterator;
+    };
+    return statement;
+}
+/**
+ * Update query statistics
+ */
+function updateQueryStats(statement, queryType, duration, slowQueryThreshold) {
+    const db = statement.database;
+    if (db.__queryStats) {
+        db.__queryStats.totalQueries++;
+        db.__queryStats.totalDuration += duration;
+        if (duration > slowQueryThreshold) {
+            db.__queryStats.slowQueries++;
+        }
+        if (!db.__queryStats.queryTypes[queryType]) {
+            db.__queryStats.queryTypes[queryType] = 0;
+        }
+        db.__queryStats.queryTypes[queryType]++;
+    }
+}
+/**
+ * Get query statistics from a traced database
+ */
+export function getQueryStatistics(db) {
+    const stats = db.__queryStats;
+    if (!stats)
+        return null;
+    return {
+        ...stats,
+        averageDuration: stats.totalQueries > 0
+            ? stats.totalDuration / stats.totalQueries
+            : 0,
+    };
+}
+/**
+ * Helper to trace a specific query with context
+ */
+export async function traceQuery(db, queryName, query, params, fn) {
+    return trace.traceAsync('query', queryName, { query, params }, async () => {
+        try {
+            const result = fn();
+            // Log successful complex queries for debugging
+            if (query.includes('JOIN') || query.includes('GROUP BY')) {
+                logger.debug(`Complex query executed: ${queryName}`, {
+                    query: query.substring(0, 200),
+                    params,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            // Enhanced error logging for database errors
+            logger.error(`Database query failed: ${queryName}`, error, {
+                query,
+                params,
+                errorCode: error.code,
+            });
+            throw error;
+        }
+    });
+}
+/**
+ * Create a traced transaction with automatic rollback on error
+ */
+export function createTracedTransaction(db, name, fn) {
+    return trace.traceSync('query', `TRANSACTION: ${name}`, {}, () => {
+        const startTime = performance.now();
+        try {
+            const tx = db.transaction(fn);
+            const result = tx.deferred();
+            const duration = performance.now() - startTime;
+            logger.info(`Transaction completed: ${name}`, {
+                duration,
+                success: true,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            logger.error(`Transaction failed: ${name}`, error, {
+                duration,
+                success: false,
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=db-trace-wrapper.js.map

package/dist/src/core/trace/db-trace-wrapper.js.map

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

package/dist/src/core/trace/debug-trace.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Debug Trace Module - Comprehensive execution tracing for LLM debugging
+ *
+ * This module provides detailed execution tracing to help LLMs understand
+ * exactly what happened during code execution, making debugging much easier.
+ */
+export interface TraceConfig {
+    enabled: boolean;
+    verbosity: 'full' | 'errors' | 'summary';
+    output: 'console' | 'file' | 'both';
+    includeParams: boolean;
+    includeResults: boolean;
+    maskSensitive: boolean;
+    performanceThreshold: number;
+    maxDepth: number;
+    captureMemory: boolean;
+}
+interface TraceEntry {
+    id: string;
+    parentId?: string;
+    type: 'command' | 'function' | 'step' | 'query' | 'api' | 'error';
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    depth: number;
+    params?: any;
+    result?: any;
+    error?: any;
+    memory?: {
+        before: NodeJS.MemoryUsage;
+        after?: NodeJS.MemoryUsage;
+        delta?: {
+            rss: number;
+            heapUsed: number;
+        };
+    };
+    metadata?: Record<string, any>;
+    children: TraceEntry[];
+}
+export declare class TraceContext {
+    private static instance;
+    private config;
+    private currentTrace;
+    private traceStack;
+    private allTraces;
+    private outputFile?;
+    private startTime;
+    private sensitivePatterns;
+    private constructor();
+    static getInstance(): TraceContext;
+    private loadConfig;
+    private initializeOutputFile;
+    private maskSensitiveData;
+    private captureMemory;
+    private formatDuration;
+    private formatMemory;
+    private getIndent;
+    private formatTraceEntry;
+    private outputTrace;
+    startTrace(type: TraceEntry['type'], name: string, params?: any, metadata?: Record<string, any>): string;
+    endTrace(id: string, result?: any, error?: any): void;
+    traceAsync<T>(type: TraceEntry['type'], name: string, params: any, fn: () => Promise<T>): Promise<T>;
+    traceSync<T>(type: TraceEntry['type'], name: string, params: any, fn: () => T): T;
+    command<T>(name: string, options: any, fn: () => Promise<T>): Promise<T>;
+    step<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    query<T>(sql: string, params: any, fn: () => Promise<T>): Promise<T>;
+    api<T>(method: string, url: string, body: any, fn: () => Promise<T>): Promise<T>;
+    getExecutionSummary(): string;
+    private countOperations;
+    private countErrors;
+    private countSlowOperations;
+    getLastError(): TraceEntry | null;
+    exportTraces(): TraceEntry[];
+    reset(): void;
+}
+export declare const trace: TraceContext;
+export declare function Trace(type?: TraceEntry['type']): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function TraceClass(type?: TraceEntry['type']): <T extends {
+    new (...args: any[]): {};
+}>(constructor: T) => T;
+export declare function TraceCritical(target: any, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+export {};
+//# sourceMappingURL=debug-trace.d.ts.map

package/dist/src/core/trace/debug-trace.d.ts.map

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