@stackmemoryai/stackmemory 0.2.9 → 0.3.0

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

@@ -0,0 +1,402 @@
+/**
+ * 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.
+ */
+import { performance } from 'perf_hooks';
+import { logger } from '../monitoring/logger.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+export class TraceContext {
+    static instance;
+    config;
+    currentTrace = null;
+    traceStack = [];
+    allTraces = [];
+    outputFile;
+    startTime = Date.now();
+    sensitivePatterns = [
+        /api[_-]?key/i,
+        /token/i,
+        /secret/i,
+        /password/i,
+        /bearer/i,
+        /authorization/i,
+        /client[_-]?id/i,
+        /client[_-]?secret/i,
+    ];
+    constructor() {
+        this.config = this.loadConfig();
+        if (this.config.output === 'file' || this.config.output === 'both') {
+            this.initializeOutputFile();
+        }
+    }
+    static getInstance() {
+        if (!TraceContext.instance) {
+            TraceContext.instance = new TraceContext();
+        }
+        return TraceContext.instance;
+    }
+    loadConfig() {
+        return {
+            enabled: process.env.DEBUG_TRACE === 'true' || process.env.STACKMEMORY_DEBUG === 'true',
+            verbosity: process.env.TRACE_VERBOSITY || 'full',
+            output: process.env.TRACE_OUTPUT || 'console',
+            includeParams: process.env.TRACE_PARAMS !== 'false',
+            includeResults: process.env.TRACE_RESULTS !== 'false',
+            maskSensitive: process.env.TRACE_MASK_SENSITIVE !== 'false',
+            performanceThreshold: parseInt(process.env.TRACE_PERF_THRESHOLD || '100'),
+            maxDepth: parseInt(process.env.TRACE_MAX_DEPTH || '20'),
+            captureMemory: process.env.TRACE_MEMORY === 'true',
+        };
+    }
+    initializeOutputFile() {
+        const traceDir = path.join(process.env.HOME || '.', '.stackmemory', 'traces');
+        if (!fs.existsSync(traceDir)) {
+            fs.mkdirSync(traceDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        this.outputFile = path.join(traceDir, `trace-${timestamp}.jsonl`);
+    }
+    maskSensitiveData(obj) {
+        if (!this.config.maskSensitive)
+            return obj;
+        if (typeof obj !== 'object' || obj === null)
+            return obj;
+        const masked = Array.isArray(obj) ? [...obj] : { ...obj };
+        for (const key in masked) {
+            if (typeof key === 'string') {
+                // Check if key matches sensitive patterns
+                const isSensitive = this.sensitivePatterns.some(pattern => pattern.test(key));
+                if (isSensitive) {
+                    masked[key] = '[MASKED]';
+                }
+                else if (typeof masked[key] === 'object') {
+                    masked[key] = this.maskSensitiveData(masked[key]);
+                }
+                else if (typeof masked[key] === 'string' && masked[key].length > 20) {
+                    // Check if value looks like a token/key
+                    if (/^[a-zA-Z0-9_-]{20,}$/.test(masked[key])) {
+                        masked[key] = masked[key].substring(0, 8) + '...[MASKED]';
+                    }
+                }
+            }
+        }
+        return masked;
+    }
+    captureMemory() {
+        if (!this.config.captureMemory)
+            return undefined;
+        return process.memoryUsage();
+    }
+    formatDuration(ms) {
+        if (ms < 1000)
+            return `${ms.toFixed(0)}ms`;
+        if (ms < 60000)
+            return `${(ms / 1000).toFixed(2)}s`;
+        return `${(ms / 60000).toFixed(2)}m`;
+    }
+    formatMemory(bytes) {
+        const mb = bytes / 1024 / 1024;
+        return `${mb.toFixed(2)}MB`;
+    }
+    getIndent(depth) {
+        return '  '.repeat(depth);
+    }
+    formatTraceEntry(entry, includeChildren = true) {
+        const indent = this.getIndent(entry.depth);
+        const duration = entry.duration ? ` [${this.formatDuration(entry.duration)}]` : '';
+        const memory = entry.memory?.delta
+            ? ` (Δmem: ${this.formatMemory(entry.memory.delta.heapUsed)})`
+            : '';
+        let output = `${indent}→ [${entry.type.toUpperCase()}:${entry.id.substring(0, 8)}] ${entry.name}${duration}${memory}`;
+        if (entry.error) {
+            output += `\n${indent}  ✗ ERROR: ${entry.error.message || entry.error}`;
+            if (entry.error.stack && this.config.verbosity === 'full') {
+                output += `\n${indent}    Stack: ${entry.error.stack.split('\n')[1]?.trim()}`;
+            }
+        }
+        if (this.config.includeParams && entry.params && Object.keys(entry.params).length > 0) {
+            const maskedParams = this.maskSensitiveData(entry.params);
+            output += `\n${indent}  ▸ Params: ${JSON.stringify(maskedParams, null, 2).replace(/\n/g, '\n' + indent + '    ')}`;
+        }
+        if (this.config.includeResults && entry.result !== undefined && !entry.error) {
+            const maskedResult = this.maskSensitiveData(entry.result);
+            const resultStr = JSON.stringify(maskedResult, null, 2);
+            if (resultStr.length < 200) {
+                output += `\n${indent}  ◂ Result: ${resultStr.replace(/\n/g, '\n' + indent + '    ')}`;
+            }
+            else {
+                output += `\n${indent}  ◂ Result: [${typeof maskedResult}] ${resultStr.substring(0, 100)}...`;
+            }
+        }
+        if (entry.duration && entry.duration > this.config.performanceThreshold) {
+            output += `\n${indent}  ⚠ SLOW: Exceeded ${this.config.performanceThreshold}ms threshold`;
+        }
+        if (includeChildren && entry.children.length > 0) {
+            for (const child of entry.children) {
+                output += '\n' + this.formatTraceEntry(child, true);
+            }
+        }
+        if (entry.endTime && entry.depth > 0) {
+            output += `\n${indent}← [${entry.type.toUpperCase()}:${entry.id.substring(0, 8)}] completed`;
+        }
+        return output;
+    }
+    outputTrace(entry) {
+        if (!this.config.enabled)
+            return;
+        const formatted = this.formatTraceEntry(entry, false);
+        if (this.config.output === 'console' || this.config.output === 'both') {
+            console.log(formatted);
+        }
+        if ((this.config.output === 'file' || this.config.output === 'both') && this.outputFile) {
+            const jsonLine = JSON.stringify({
+                ...entry,
+                formatted,
+                timestamp: new Date().toISOString(),
+            }) + '\n';
+            fs.appendFileSync(this.outputFile, jsonLine);
+        }
+    }
+    startTrace(type, name, params, metadata) {
+        if (!this.config.enabled)
+            return '';
+        const id = uuidv4();
+        const parentId = this.currentTrace?.id;
+        const depth = this.traceStack.length;
+        if (depth > this.config.maxDepth) {
+            return id; // Prevent infinite recursion
+        }
+        const entry = {
+            id,
+            parentId,
+            type,
+            name,
+            startTime: performance.now(),
+            depth,
+            params: this.config.includeParams ? params : undefined,
+            metadata,
+            children: [],
+            memory: this.captureMemory() ? { before: this.captureMemory() } : undefined,
+        };
+        if (this.currentTrace) {
+            this.currentTrace.children.push(entry);
+        }
+        else {
+            this.allTraces.push(entry);
+        }
+        this.traceStack.push(entry);
+        this.currentTrace = entry;
+        this.outputTrace(entry);
+        return id;
+    }
+    endTrace(id, result, error) {
+        if (!this.config.enabled)
+            return;
+        const index = this.traceStack.findIndex(t => t.id === id);
+        if (index === -1)
+            return;
+        const entry = this.traceStack[index];
+        entry.endTime = performance.now();
+        entry.duration = entry.endTime - entry.startTime;
+        entry.result = this.config.includeResults && !error ? result : undefined;
+        entry.error = error;
+        if (entry.memory?.before) {
+            entry.memory.after = this.captureMemory();
+            if (entry.memory.after) {
+                entry.memory.delta = {
+                    rss: entry.memory.after.rss - entry.memory.before.rss,
+                    heapUsed: entry.memory.after.heapUsed - entry.memory.before.heapUsed,
+                };
+            }
+        }
+        this.outputTrace(entry);
+        // Remove from stack and update current
+        this.traceStack.splice(index);
+        this.currentTrace = this.traceStack[this.traceStack.length - 1] || null;
+    }
+    async traceAsync(type, name, params, fn) {
+        const id = this.startTrace(type, name, params);
+        try {
+            const result = await fn();
+            this.endTrace(id, result);
+            return result;
+        }
+        catch (error) {
+            this.endTrace(id, undefined, error);
+            throw error;
+        }
+    }
+    traceSync(type, name, params, fn) {
+        const id = this.startTrace(type, name, params);
+        try {
+            const result = fn();
+            this.endTrace(id, result);
+            return result;
+        }
+        catch (error) {
+            this.endTrace(id, undefined, error);
+            throw error;
+        }
+    }
+    async command(name, options, fn) {
+        return this.traceAsync('command', name, options, fn);
+    }
+    async step(name, fn) {
+        return this.traceAsync('step', name, undefined, fn);
+    }
+    async query(sql, params, fn) {
+        return this.traceAsync('query', sql.substring(0, 50), params, fn);
+    }
+    async api(method, url, body, fn) {
+        return this.traceAsync('api', `${method} ${url}`, { body }, fn);
+    }
+    getExecutionSummary() {
+        if (!this.config.enabled)
+            return 'Tracing disabled';
+        const totalDuration = Date.now() - this.startTime;
+        const errorCount = this.countErrors(this.allTraces);
+        const slowCount = this.countSlowOperations(this.allTraces);
+        let summary = `\n${'='.repeat(80)}\n`;
+        summary += `EXECUTION SUMMARY\n`;
+        summary += `${'='.repeat(80)}\n`;
+        summary += `Total Duration: ${this.formatDuration(totalDuration)}\n`;
+        summary += `Total Operations: ${this.countOperations(this.allTraces)}\n`;
+        summary += `Errors: ${errorCount}\n`;
+        summary += `Slow Operations (>${this.config.performanceThreshold}ms): ${slowCount}\n`;
+        if (this.config.captureMemory) {
+            const memUsage = process.memoryUsage();
+            summary += `Final Memory: RSS=${this.formatMemory(memUsage.rss)}, Heap=${this.formatMemory(memUsage.heapUsed)}\n`;
+        }
+        if (this.outputFile) {
+            summary += `Trace Log: ${this.outputFile}\n`;
+        }
+        summary += `${'='.repeat(80)}`;
+        return summary;
+    }
+    countOperations(traces) {
+        let count = traces.length;
+        for (const trace of traces) {
+            count += this.countOperations(trace.children);
+        }
+        return count;
+    }
+    countErrors(traces) {
+        let count = 0;
+        for (const trace of traces) {
+            if (trace.error)
+                count++;
+            count += this.countErrors(trace.children);
+        }
+        return count;
+    }
+    countSlowOperations(traces) {
+        let count = 0;
+        for (const trace of traces) {
+            if (trace.duration && trace.duration > this.config.performanceThreshold)
+                count++;
+            count += this.countSlowOperations(trace.children);
+        }
+        return count;
+    }
+    getLastError() {
+        const findLastError = (traces) => {
+            for (let i = traces.length - 1; i >= 0; i--) {
+                const trace = traces[i];
+                if (trace.error)
+                    return trace;
+                const childError = findLastError(trace.children);
+                if (childError)
+                    return childError;
+            }
+            return null;
+        };
+        return findLastError(this.allTraces);
+    }
+    exportTraces() {
+        return this.allTraces;
+    }
+    reset() {
+        this.currentTrace = null;
+        this.traceStack = [];
+        this.allTraces = [];
+        this.startTime = Date.now();
+    }
+}
+// Singleton instance
+export const trace = TraceContext.getInstance();
+// Decorator for tracing class methods
+export function Trace(type = 'function') {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const isAsync = originalMethod.constructor.name === 'AsyncFunction';
+        if (isAsync) {
+            descriptor.value = async function (...args) {
+                const className = target.constructor.name;
+                const methodName = `${className}.${propertyKey}`;
+                return trace.traceAsync(type, methodName, args, async () => {
+                    return originalMethod.apply(this, args);
+                });
+            };
+        }
+        else {
+            descriptor.value = function (...args) {
+                const className = target.constructor.name;
+                const methodName = `${className}.${propertyKey}`;
+                return trace.traceSync(type, methodName, args, () => {
+                    return originalMethod.apply(this, args);
+                });
+            };
+        }
+        return descriptor;
+    };
+}
+// Decorator for tracing entire classes
+export function TraceClass(type = 'function') {
+    return function (constructor) {
+        const prototype = constructor.prototype;
+        const propertyNames = Object.getOwnPropertyNames(prototype);
+        for (const propertyName of propertyNames) {
+            if (propertyName === 'constructor')
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(prototype, propertyName);
+            if (!descriptor || typeof descriptor.value !== 'function')
+                continue;
+            Trace(type)(prototype, propertyName, descriptor);
+            Object.defineProperty(prototype, propertyName, descriptor);
+        }
+        return constructor;
+    };
+}
+// Helper for critical operations
+export function TraceCritical(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function (...args) {
+        const className = target.constructor.name;
+        const methodName = `${className}.${propertyKey} [CRITICAL]`;
+        // Store context before execution
+        const contextBefore = {
+            memory: process.memoryUsage(),
+            timestamp: new Date().toISOString(),
+            args: trace['maskSensitiveData'](args),
+        };
+        try {
+            return await trace.traceAsync('function', methodName, contextBefore, async () => {
+                return originalMethod.apply(this, args);
+            });
+        }
+        catch (error) {
+            // Enhanced error logging for critical operations
+            logger.error(`Critical operation failed: ${methodName}`, error, {
+                context: contextBefore,
+                stack: error.stack,
+            });
+            throw error;
+        }
+    };
+    return descriptor;
+}
+//# sourceMappingURL=debug-trace.js.map

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

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

package/dist/src/core/trace/error-test.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Error Test - Trigger and debug errors with tracing
+ */
+export {};
+//# sourceMappingURL=error-test.d.ts.map

package/dist/src/core/trace/error-test.d.ts.map

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

package/dist/src/core/trace/error-test.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * Error Test - Trigger and debug errors with tracing
+ */
+import { trace } from './index.js';
+import { FrameManager } from '../context/frame-manager.js';
+import { PebblesTaskStore } from '../../features/tasks/pebbles-task-store.js';
+import Database from 'better-sqlite3';
+async function runErrorTest() {
+    console.log('💥 Starting error test with tracing...\n');
+    // Enable verbose tracing
+    process.env.DEBUG_TRACE = 'true';
+    process.env.TRACE_VERBOSITY = 'full';
+    process.env.TRACE_PARAMS = 'true';
+    await trace.command('error-test', {}, async () => {
+        // Test 1: Frame Manager error - closing non-existent frame
+        await trace.step('Frame Manager Error Test', async () => {
+            const db = new Database(':memory:');
+            const fm = new FrameManager(db, 'test-project');
+            // Create a frame
+            const frameId = fm.createFrame({
+                type: 'task',
+                name: 'Test Frame',
+                inputs: { test: true }
+            });
+            console.log(`Created frame: ${frameId}`);
+            // Try to close a non-existent frame (ERROR!)
+            try {
+                fm.closeFrame('non-existent-frame-id');
+            }
+            catch (error) {
+                console.log('✅ Caught expected error:', error.message);
+                console.log('   Error code:', error.code);
+                // Get the error trace
+                const lastError = trace.getLastError();
+                if (lastError) {
+                    console.log('\n📍 Error trace details:');
+                    console.log(`   Operation: ${lastError.name}`);
+                    console.log(`   Call depth: ${lastError.depth}`);
+                    console.log(`   Parameters:`, lastError.params);
+                }
+            }
+            db.close();
+        });
+        // Test 2: Task Store error - invalid status transition
+        await trace.step('Task Store Error Test', async () => {
+            const db = new Database(':memory:');
+            const taskStore = new PebblesTaskStore('/tmp/error-test', db);
+            // Create a task
+            const taskId = taskStore.createTask({
+                title: 'Error Test Task',
+                frameId: 'test-frame'
+            });
+            // Complete the task
+            taskStore.updateTaskStatus(taskId, 'completed');
+            // Try to change completed task to pending (ERROR!)
+            try {
+                taskStore.updateTaskStatus(taskId, 'pending');
+            }
+            catch (error) {
+                console.log('\n✅ Caught expected error:', error.message);
+                console.log('   Error code:', error.code);
+                // Get the error context from trace
+                const lastError = trace.getLastError();
+                if (lastError) {
+                    console.log('\n📍 Error occurred at:');
+                    console.log(`   Function: ${lastError.name}`);
+                    console.log(`   Depth: ${lastError.depth}`);
+                    console.log(`   Parameters:`, JSON.stringify(lastError.params, null, 2));
+                    console.log(`   Error:`, lastError.error);
+                    // This is the key info for debugging!
+                    console.log('\n🔑 ESCAPE CODE FRAGMENT:');
+                    console.log(`   Call stack depth at error: ${lastError.depth}`);
+                }
+            }
+            db.close();
+        });
+        // Test 3: Database error - constraint violation
+        await trace.step('Database Error Test', async () => {
+            const db = new Database(':memory:');
+            db.exec(`
+        CREATE TABLE users (
+          id INTEGER PRIMARY KEY,
+          email TEXT UNIQUE NOT NULL
+        )
+      `);
+            const insert = db.prepare('INSERT INTO users (email) VALUES (?)');
+            insert.run('test@example.com');
+            // Try to insert duplicate email (ERROR!)
+            try {
+                insert.run('test@example.com');
+            }
+            catch (error) {
+                console.log('\n✅ Caught expected database error:', error.message);
+                const lastError = trace.getLastError();
+                if (lastError) {
+                    console.log('\n📍 Database error trace:');
+                    console.log(`   Query: ${lastError.name}`);
+                    console.log(`   Stack depth: ${lastError.depth}`);
+                }
+            }
+            db.close();
+        });
+    });
+    // Show execution summary
+    const summary = trace.getExecutionSummary();
+    console.log('\n' + summary);
+    // Export traces for analysis
+    const traces = trace.exportTraces();
+    const errors = countErrors(traces);
+    console.log(`\n🎯 Total errors caught and traced: ${errors}`);
+    console.log('✨ All errors were properly handled with full context!');
+}
+function countErrors(traces) {
+    let count = 0;
+    function traverse(trace) {
+        if (trace.error)
+            count++;
+        if (trace.children) {
+            trace.children.forEach(traverse);
+        }
+    }
+    traces.forEach(traverse);
+    return count;
+}
+// Run the test
+runErrorTest().catch(console.error);
+//# sourceMappingURL=error-test.js.map

package/dist/src/core/trace/error-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-test.js","sourceRoot":"","sources":["../../../../src/core/trace/error-test.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAwB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,KAAK,UAAU,YAAY;IACzB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAExD,yBAAyB;IACzB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC;IAElC,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/C,2DAA2D;QAC3D,MAAM,KAAK,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YAEhD,iBAAiB;YACjB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC;gBAC7B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;aACvB,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAEzC,6CAA6C;YAC7C,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1C,sBAAsB;gBACtB,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvC,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;oBACzC,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC/C,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;oBACjD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAED,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,uDAAuD;QACvD,MAAM,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAE9D,gBAAgB;YAChB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC;gBAClC,KAAK,EAAE,iBAAiB;gBACxB,OAAO,EAAE,YAAY;aACtB,CAAC,CAAC;YAEH,oBAAoB;YACpB,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAEhD,mDAAmD;YACnD,IAAI,CAAC;gBACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1C,mCAAmC;gBACnC,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvC,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;oBACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC5C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBACzE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;oBAE1C,sCAAsC;oBACtC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YAED,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;YAEpC,EAAE,CAAC,IAAI,CAAC;;;;;OAKP,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;YAClE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAE/B,yCAAyC;YACzC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAElE,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvC,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3C,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YAED,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,EAAE,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IAE5B,6BAA6B;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,MAAa;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,SAAS,QAAQ,CAAC,KAAU;QAC1B,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,eAAe;AACf,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Trace Module Export
+ * Central export for all tracing functionality
+ */
+import type { TraceConfig } from './debug-trace.js';
+export { trace, TraceContext, Trace, TraceClass, TraceCritical, type TraceConfig, } from './debug-trace.js';
+export { wrapCommand, wrapProgram, traceStep, traceQuery, traceAPI, } from './cli-trace-wrapper.js';
+export { createTracedDatabase, wrapDatabase, getQueryStatistics, createTracedTransaction, } from './db-trace-wrapper.js';
+export { TraceLinearAPI, createTracedFetch, wrapGraphQLClient, } from './linear-api-wrapper.js';
+/**
+ * Initialize tracing based on environment configuration
+ */
+export declare function initializeTracing(): void;
+/**
+ * Helper to enable tracing for a specific scope
+ */
+export declare function withTracing<T>(fn: () => T, options?: Partial<TraceConfig>): T;
+/**
+ * Quick enable/disable functions for debugging
+ */
+export declare const enableTracing: () => void;
+export declare const disableTracing: () => void;
+export declare const enableVerboseTracing: () => void;
+export declare const enableMinimalTracing: () => void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EACL,KAAK,EACL,YAAY,EACZ,KAAK,EACL,UAAU,EACV,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAmDxC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC7B,CAAC,CA+BH;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,YAGzB,CAAC;AAEF,eAAO,MAAM,cAAc,YAG1B,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAOhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAOhC,CAAC"}