@stackmemoryai/stackmemory 0.2.8 → 0.3.0

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

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

package/dist/core/trace/index.js

@@ -0,0 +1,158 @@
+import {
+  trace,
+  TraceContext,
+  Trace,
+  TraceClass,
+  TraceCritical
+} from "./debug-trace.js";
+import {
+  wrapCommand,
+  wrapProgram,
+  traceStep,
+  traceQuery,
+  traceAPI
+} from "./cli-trace-wrapper.js";
+import {
+  createTracedDatabase,
+  wrapDatabase,
+  getQueryStatistics,
+  createTracedTransaction
+} from "./db-trace-wrapper.js";
+import {
+  TraceLinearAPI,
+  createTracedFetch,
+  wrapGraphQLClient
+} from "./linear-api-wrapper.js";
+function initializeTracing() {
+  const config = {
+    // Main control
+    DEBUG_TRACE: process.env.DEBUG_TRACE === "true",
+    STACKMEMORY_DEBUG: process.env.STACKMEMORY_DEBUG === "true",
+    // Output control
+    TRACE_OUTPUT: process.env.TRACE_OUTPUT || "console",
+    // console|file|both
+    TRACE_VERBOSITY: process.env.TRACE_VERBOSITY || "full",
+    // full|errors|summary
+    // Content control
+    TRACE_PARAMS: process.env.TRACE_PARAMS !== "false",
+    // Include parameters
+    TRACE_RESULTS: process.env.TRACE_RESULTS !== "false",
+    // Include results
+    TRACE_MASK_SENSITIVE: process.env.TRACE_MASK_SENSITIVE !== "false",
+    // Mask sensitive data
+    // Performance
+    TRACE_PERF_THRESHOLD: parseInt(process.env.TRACE_PERF_THRESHOLD || "100"),
+    // ms
+    TRACE_MEMORY: process.env.TRACE_MEMORY === "true",
+    // Track memory usage
+    TRACE_MAX_DEPTH: parseInt(process.env.TRACE_MAX_DEPTH || "20"),
+    // Max call depth
+    // Database specific
+    TRACE_DB: process.env.TRACE_DB === "true",
+    // Enable database tracing
+    TRACE_DB_SLOW: parseInt(process.env.TRACE_DB_SLOW || "100"),
+    // Slow query threshold
+    // API specific
+    TRACE_API: process.env.TRACE_API === "true",
+    // Enable API tracing
+    TRACE_API_SLOW: parseInt(process.env.TRACE_API_SLOW || "1000")
+    // Slow API threshold
+  };
+  if (config.DEBUG_TRACE || config.STACKMEMORY_DEBUG) {
+    console.log("\u{1F50D} Trace Configuration:", {
+      enabled: true,
+      output: config.TRACE_OUTPUT,
+      verbosity: config.TRACE_VERBOSITY,
+      includeParams: config.TRACE_PARAMS,
+      includeResults: config.TRACE_RESULTS,
+      maskSensitive: config.TRACE_MASK_SENSITIVE,
+      performanceThreshold: config.TRACE_PERF_THRESHOLD,
+      captureMemory: config.TRACE_MEMORY,
+      maxDepth: config.TRACE_MAX_DEPTH,
+      database: {
+        enabled: config.TRACE_DB,
+        slowThreshold: config.TRACE_DB_SLOW
+      },
+      api: {
+        enabled: config.TRACE_API,
+        slowThreshold: config.TRACE_API_SLOW
+      }
+    });
+  }
+}
+function withTracing(fn, options) {
+  const originalEnv = process.env.DEBUG_TRACE;
+  try {
+    process.env.DEBUG_TRACE = "true";
+    if (options) {
+      if (options.output) process.env.TRACE_OUTPUT = options.output;
+      if (options.verbosity) process.env.TRACE_VERBOSITY = options.verbosity;
+      if (options.includeParams !== void 0) {
+        process.env.TRACE_PARAMS = String(options.includeParams);
+      }
+      if (options.includeResults !== void 0) {
+        process.env.TRACE_RESULTS = String(options.includeResults);
+      }
+      if (options.performanceThreshold !== void 0) {
+        process.env.TRACE_PERF_THRESHOLD = String(options.performanceThreshold);
+      }
+    }
+    return fn();
+  } finally {
+    if (originalEnv === void 0) {
+      delete process.env.DEBUG_TRACE;
+    } else {
+      process.env.DEBUG_TRACE = originalEnv;
+    }
+  }
+}
+const enableTracing = () => {
+  process.env.DEBUG_TRACE = "true";
+  console.log("\u2705 Tracing enabled");
+};
+const disableTracing = () => {
+  delete process.env.DEBUG_TRACE;
+  console.log("\u274C Tracing disabled");
+};
+const enableVerboseTracing = () => {
+  process.env.DEBUG_TRACE = "true";
+  process.env.TRACE_VERBOSITY = "full";
+  process.env.TRACE_PARAMS = "true";
+  process.env.TRACE_RESULTS = "true";
+  process.env.TRACE_MEMORY = "true";
+  console.log("\u2705 Verbose tracing enabled");
+};
+const enableMinimalTracing = () => {
+  process.env.DEBUG_TRACE = "true";
+  process.env.TRACE_VERBOSITY = "summary";
+  process.env.TRACE_PARAMS = "false";
+  process.env.TRACE_RESULTS = "false";
+  process.env.TRACE_MEMORY = "false";
+  console.log("\u2705 Minimal tracing enabled");
+};
+export {
+  Trace,
+  TraceClass,
+  TraceContext,
+  TraceCritical,
+  TraceLinearAPI,
+  createTracedDatabase,
+  createTracedFetch,
+  createTracedTransaction,
+  disableTracing,
+  enableMinimalTracing,
+  enableTracing,
+  enableVerboseTracing,
+  getQueryStatistics,
+  initializeTracing,
+  trace,
+  traceAPI,
+  traceQuery,
+  traceStep,
+  withTracing,
+  wrapCommand,
+  wrapDatabase,
+  wrapGraphQLClient,
+  wrapProgram
+};
+//# sourceMappingURL=index.js.map

package/dist/core/trace/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/trace/index.ts"],
+  "sourcesContent": ["/**\n * Trace Module Export\n * Central export for all tracing functionality\n */\n\nimport type { TraceConfig } from './debug-trace.js';\n\nexport {\n  trace,\n  TraceContext,\n  Trace,\n  TraceClass,\n  TraceCritical,\n  type TraceConfig,\n} from './debug-trace.js';\n\nexport {\n  wrapCommand,\n  wrapProgram,\n  traceStep,\n  traceQuery,\n  traceAPI,\n} from './cli-trace-wrapper.js';\n\nexport {\n  createTracedDatabase,\n  wrapDatabase,\n  getQueryStatistics,\n  createTracedTransaction,\n} from './db-trace-wrapper.js';\n\nexport {\n  TraceLinearAPI,\n  createTracedFetch,\n  wrapGraphQLClient,\n} from './linear-api-wrapper.js';\n\n/**\n * Initialize tracing based on environment configuration\n */\nexport function initializeTracing(): void {\n  const config = {\n    // Main control\n    DEBUG_TRACE: process.env.DEBUG_TRACE === 'true',\n    STACKMEMORY_DEBUG: process.env.STACKMEMORY_DEBUG === 'true',\n    \n    // Output control\n    TRACE_OUTPUT: process.env.TRACE_OUTPUT || 'console', // console|file|both\n    TRACE_VERBOSITY: process.env.TRACE_VERBOSITY || 'full', // full|errors|summary\n    \n    // Content control\n    TRACE_PARAMS: process.env.TRACE_PARAMS !== 'false', // Include parameters\n    TRACE_RESULTS: process.env.TRACE_RESULTS !== 'false', // Include results\n    TRACE_MASK_SENSITIVE: process.env.TRACE_MASK_SENSITIVE !== 'false', // Mask sensitive data\n    \n    // Performance\n    TRACE_PERF_THRESHOLD: parseInt(process.env.TRACE_PERF_THRESHOLD || '100'), // ms\n    TRACE_MEMORY: process.env.TRACE_MEMORY === 'true', // Track memory usage\n    TRACE_MAX_DEPTH: parseInt(process.env.TRACE_MAX_DEPTH || '20'), // Max call depth\n    \n    // Database specific\n    TRACE_DB: process.env.TRACE_DB === 'true', // Enable database tracing\n    TRACE_DB_SLOW: parseInt(process.env.TRACE_DB_SLOW || '100'), // Slow query threshold\n    \n    // API specific\n    TRACE_API: process.env.TRACE_API === 'true', // Enable API tracing\n    TRACE_API_SLOW: parseInt(process.env.TRACE_API_SLOW || '1000'), // Slow API threshold\n  };\n  \n  // Log configuration if debugging is enabled\n  if (config.DEBUG_TRACE || config.STACKMEMORY_DEBUG) {\n    console.log('\uD83D\uDD0D Trace Configuration:', {\n      enabled: true,\n      output: config.TRACE_OUTPUT,\n      verbosity: config.TRACE_VERBOSITY,\n      includeParams: config.TRACE_PARAMS,\n      includeResults: config.TRACE_RESULTS,\n      maskSensitive: config.TRACE_MASK_SENSITIVE,\n      performanceThreshold: config.TRACE_PERF_THRESHOLD,\n      captureMemory: config.TRACE_MEMORY,\n      maxDepth: config.TRACE_MAX_DEPTH,\n      database: {\n        enabled: config.TRACE_DB,\n        slowThreshold: config.TRACE_DB_SLOW,\n      },\n      api: {\n        enabled: config.TRACE_API,\n        slowThreshold: config.TRACE_API_SLOW,\n      },\n    });\n  }\n}\n\n/**\n * Helper to enable tracing for a specific scope\n */\nexport function withTracing<T>(\n  fn: () => T,\n  options?: Partial<TraceConfig>\n): T {\n  const originalEnv = process.env.DEBUG_TRACE;\n  \n  try {\n    // Temporarily enable tracing\n    process.env.DEBUG_TRACE = 'true';\n    \n    // Apply custom options if provided\n    if (options) {\n      if (options.output) process.env.TRACE_OUTPUT = options.output;\n      if (options.verbosity) process.env.TRACE_VERBOSITY = options.verbosity;\n      if (options.includeParams !== undefined) {\n        process.env.TRACE_PARAMS = String(options.includeParams);\n      }\n      if (options.includeResults !== undefined) {\n        process.env.TRACE_RESULTS = String(options.includeResults);\n      }\n      if (options.performanceThreshold !== undefined) {\n        process.env.TRACE_PERF_THRESHOLD = String(options.performanceThreshold);\n      }\n    }\n    \n    return fn();\n  } finally {\n    // Restore original environment\n    if (originalEnv === undefined) {\n      delete process.env.DEBUG_TRACE;\n    } else {\n      process.env.DEBUG_TRACE = originalEnv;\n    }\n  }\n}\n\n/**\n * Quick enable/disable functions for debugging\n */\nexport const enableTracing = () => {\n  process.env.DEBUG_TRACE = 'true';\n  console.log('\u2705 Tracing enabled');\n};\n\nexport const disableTracing = () => {\n  delete process.env.DEBUG_TRACE;\n  console.log('\u274C Tracing disabled');\n};\n\nexport const enableVerboseTracing = () => {\n  process.env.DEBUG_TRACE = 'true';\n  process.env.TRACE_VERBOSITY = 'full';\n  process.env.TRACE_PARAMS = 'true';\n  process.env.TRACE_RESULTS = 'true';\n  process.env.TRACE_MEMORY = 'true';\n  console.log('\u2705 Verbose tracing enabled');\n};\n\nexport const enableMinimalTracing = () => {\n  process.env.DEBUG_TRACE = 'true';\n  process.env.TRACE_VERBOSITY = 'summary';\n  process.env.TRACE_PARAMS = 'false';\n  process.env.TRACE_RESULTS = 'false';\n  process.env.TRACE_MEMORY = 'false';\n  console.log('\u2705 Minimal tracing enabled');\n};"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/trace/linear-api-wrapper.js

@@ -0,0 +1,169 @@
+import { trace } from "./debug-trace.js";
+import { logger } from "../monitoring/logger.js";
+function TraceLinearAPI(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}`;
+      const context = extractAPIContext(propertyKey, args);
+      return trace.traceAsync("api", methodName, context, async () => {
+        const startTime = Date.now();
+        try {
+          logger.debug(`Linear API Call: ${methodName}`, context);
+          const result = await originalMethod.apply(this, args);
+          const duration = Date.now() - startTime;
+          logger.info(`Linear API Success: ${methodName}`, {
+            duration,
+            resultType: Array.isArray(result) ? `array[${result.length}]` : typeof result,
+            hasData: result != null
+          });
+          if (duration > 1e3) {
+            logger.warn(`Slow Linear API call: ${methodName} took ${duration}ms`, {
+              ...context,
+              duration
+            });
+          }
+          return result;
+        } catch (error) {
+          const duration = Date.now() - startTime;
+          logger.error(`Linear API Failed: ${methodName}`, error, {
+            ...context,
+            duration,
+            errorCode: error.code,
+            statusCode: error.statusCode,
+            graphQLErrors: error.errors
+          });
+          if (error.message?.includes("rate limit")) {
+            logger.warn("Rate limit hit - consider implementing backoff", {
+              method: methodName,
+              suggestion: "Implement exponential backoff or request queuing"
+            });
+          } else if (error.message?.includes("network")) {
+            logger.warn("Network error - check connectivity", {
+              method: methodName,
+              suggestion: "Verify API endpoint and network connectivity"
+            });
+          } else if (error.message?.includes("unauthorized")) {
+            logger.warn("Authorization error - check API key", {
+              method: methodName,
+              suggestion: "Verify LINEAR_API_KEY is set and valid"
+            });
+          }
+          throw error;
+        }
+      });
+    };
+  } else {
+    descriptor.value = function(...args) {
+      const className = target.constructor.name;
+      const methodName = `${className}.${propertyKey}`;
+      const context = extractAPIContext(propertyKey, args);
+      return trace.traceSync("api", methodName, context, () => {
+        return originalMethod.apply(this, args);
+      });
+    };
+  }
+  return descriptor;
+}
+function extractAPIContext(methodName, args) {
+  const context = {};
+  if (methodName === "createIssue" && args[0]) {
+    context.title = args[0].title;
+    context.teamId = args[0].teamId;
+    context.priority = args[0].priority;
+  } else if (methodName === "updateIssue" && args[0]) {
+    context.issueId = args[0];
+    context.updates = Object.keys(args[1] || {});
+  } else if (methodName === "getIssue") {
+    context.issueId = args[0];
+  } else if (methodName === "getIssues" && args[0]) {
+    context.filter = args[0];
+  } else if (methodName === "graphql") {
+    const query = args[0];
+    if (query) {
+      const match = query.match(/(?:query|mutation)\s+(\w+)/);
+      context.operation = match ? match[1] : "unknown";
+      context.queryLength = query.length;
+      context.variables = args[1] ? Object.keys(args[1]) : [];
+    }
+  }
+  return context;
+}
+function createTracedFetch(baseFetch = fetch) {
+  return async function tracedFetch(input, init) {
+    const url = typeof input === "string" ? input : input.toString();
+    const method = init?.method || "GET";
+    const headers = init?.headers ? { ...init.headers } : {};
+    if (headers.Authorization) {
+      headers.Authorization = headers.Authorization.substring(0, 20) + "...[MASKED]";
+    }
+    const context = {
+      method,
+      url: url.length > 100 ? url.substring(0, 100) + "..." : url,
+      headers: Object.keys(headers),
+      bodySize: init?.body ? JSON.stringify(init.body).length : 0
+    };
+    return trace.api(method, url, context, async () => {
+      const startTime = Date.now();
+      try {
+        const response = await baseFetch(input, init);
+        const duration = Date.now() - startTime;
+        logger.debug(`HTTP ${method} ${response.status}`, {
+          url: url.substring(0, 100),
+          status: response.status,
+          duration,
+          headers: {
+            "content-type": response.headers.get("content-type"),
+            "x-ratelimit-remaining": response.headers.get("x-ratelimit-remaining"),
+            "x-ratelimit-reset": response.headers.get("x-ratelimit-reset")
+          }
+        });
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        if (remaining && parseInt(remaining) < 10) {
+          logger.warn(`Low rate limit remaining: ${remaining}`, {
+            url: url.substring(0, 100),
+            resetAt: response.headers.get("x-ratelimit-reset")
+          });
+        }
+        if (duration > 2e3) {
+          logger.warn(`Slow HTTP response: ${duration}ms`, {
+            method,
+            url: url.substring(0, 100),
+            status: response.status
+          });
+        }
+        return response;
+      } catch (error) {
+        const duration = Date.now() - startTime;
+        logger.error(`HTTP ${method} failed`, error, {
+          url: url.substring(0, 100),
+          duration,
+          errorType: error.constructor.name,
+          errno: error.errno,
+          code: error.code
+        });
+        throw error;
+      }
+    });
+  };
+}
+function wrapGraphQLClient(client) {
+  const prototype = Object.getPrototypeOf(client);
+  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;
+    TraceLinearAPI(prototype, propertyName, descriptor);
+    Object.defineProperty(prototype, propertyName, descriptor);
+  }
+  return client;
+}
+export {
+  TraceLinearAPI,
+  createTracedFetch,
+  wrapGraphQLClient
+};
+//# sourceMappingURL=linear-api-wrapper.js.map

package/dist/core/trace/linear-api-wrapper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/trace/linear-api-wrapper.ts"],
+  "sourcesContent": ["/**\n * Linear API Trace Wrapper\n * Wraps Linear API client with comprehensive tracing for debugging\n */\n\nimport { trace, Trace } from './debug-trace.js';\nimport { logger } from '../monitoring/logger.js';\n\n/**\n * Decorator to trace Linear API GraphQL calls\n */\nexport function TraceLinearAPI(\n  target: any,\n  propertyKey: string,\n  descriptor: PropertyDescriptor\n) {\n  const originalMethod = descriptor.value;\n  const isAsync = originalMethod.constructor.name === 'AsyncFunction';\n\n  if (isAsync) {\n    descriptor.value = async function (...args: any[]) {\n      const className = target.constructor.name;\n      const methodName = `${className}.${propertyKey}`;\n      \n      // Extract meaningful context from arguments\n      const context = extractAPIContext(propertyKey, args);\n      \n      return trace.traceAsync('api', methodName, context, async () => {\n        const startTime = Date.now();\n        \n        try {\n          // Log API call start\n          logger.debug(`Linear API Call: ${methodName}`, context);\n          \n          const result = await originalMethod.apply(this, args);\n          \n          const duration = Date.now() - startTime;\n          \n          // Log successful completion with timing\n          logger.info(`Linear API Success: ${methodName}`, {\n            duration,\n            resultType: Array.isArray(result) ? `array[${result.length}]` : typeof result,\n            hasData: result != null,\n          });\n          \n          // Warn about slow API calls\n          if (duration > 1000) {\n            logger.warn(`Slow Linear API call: ${methodName} took ${duration}ms`, {\n              ...context,\n              duration,\n            });\n          }\n          \n          return result;\n        } catch (error: any) {\n          const duration = Date.now() - startTime;\n          \n          // Enhanced error logging for API failures\n          logger.error(`Linear API Failed: ${methodName}`, error, {\n            ...context,\n            duration,\n            errorCode: error.code,\n            statusCode: error.statusCode,\n            graphQLErrors: error.errors,\n          });\n          \n          // Add debugging hints based on error type\n          if (error.message?.includes('rate limit')) {\n            logger.warn('Rate limit hit - consider implementing backoff', {\n              method: methodName,\n              suggestion: 'Implement exponential backoff or request queuing',\n            });\n          } else if (error.message?.includes('network')) {\n            logger.warn('Network error - check connectivity', {\n              method: methodName,\n              suggestion: 'Verify API endpoint and network connectivity',\n            });\n          } else if (error.message?.includes('unauthorized')) {\n            logger.warn('Authorization error - check API key', {\n              method: methodName,\n              suggestion: 'Verify LINEAR_API_KEY is set and valid',\n            });\n          }\n          \n          throw error;\n        }\n      });\n    };\n  } else {\n    descriptor.value = function (...args: any[]) {\n      const className = target.constructor.name;\n      const methodName = `${className}.${propertyKey}`;\n      const context = extractAPIContext(propertyKey, args);\n      \n      return trace.traceSync('api', methodName, context, () => {\n        return originalMethod.apply(this, args);\n      });\n    };\n  }\n\n  return descriptor;\n}\n\n/**\n * Extract meaningful context from API method arguments\n */\nfunction extractAPIContext(methodName: string, args: any[]): Record<string, any> {\n  const context: Record<string, any> = {};\n  \n  // Handle different Linear API methods\n  if (methodName === 'createIssue' && args[0]) {\n    context.title = args[0].title;\n    context.teamId = args[0].teamId;\n    context.priority = args[0].priority;\n  } else if (methodName === 'updateIssue' && args[0]) {\n    context.issueId = args[0];\n    context.updates = Object.keys(args[1] || {});\n  } else if (methodName === 'getIssue') {\n    context.issueId = args[0];\n  } else if (methodName === 'getIssues' && args[0]) {\n    context.filter = args[0];\n  } else if (methodName === 'graphql') {\n    // For raw GraphQL queries\n    const query = args[0];\n    if (query) {\n      // Extract operation name from query\n      const match = query.match(/(?:query|mutation)\\s+(\\w+)/);\n      context.operation = match ? match[1] : 'unknown';\n      context.queryLength = query.length;\n      context.variables = args[1] ? Object.keys(args[1]) : [];\n    }\n  }\n  \n  return context;\n}\n\n/**\n * Wrap fetch with tracing for HTTP-level debugging\n */\nexport function createTracedFetch(baseFetch = fetch): typeof fetch {\n  return async function tracedFetch(\n    input: string | URL | Request,\n    init?: RequestInit\n  ): Promise<Response> {\n    const url = typeof input === 'string' ? input : input.toString();\n    const method = init?.method || 'GET';\n    \n    // Mask sensitive headers\n    const headers: any = init?.headers ? { ...init.headers } : {};\n    if (headers.Authorization) {\n      headers.Authorization = headers.Authorization.substring(0, 20) + '...[MASKED]';\n    }\n    \n    const context = {\n      method,\n      url: url.length > 100 ? url.substring(0, 100) + '...' : url,\n      headers: Object.keys(headers),\n      bodySize: init?.body ? JSON.stringify(init.body).length : 0,\n    };\n    \n    return trace.api(method, url, context, async () => {\n      const startTime = Date.now();\n      \n      try {\n        const response = await baseFetch(input, init);\n        const duration = Date.now() - startTime;\n        \n        // Log response details\n        logger.debug(`HTTP ${method} ${response.status}`, {\n          url: url.substring(0, 100),\n          status: response.status,\n          duration,\n          headers: {\n            'content-type': response.headers.get('content-type'),\n            'x-ratelimit-remaining': response.headers.get('x-ratelimit-remaining'),\n            'x-ratelimit-reset': response.headers.get('x-ratelimit-reset'),\n          },\n        });\n        \n        // Warn about rate limiting\n        const remaining = response.headers.get('x-ratelimit-remaining');\n        if (remaining && parseInt(remaining) < 10) {\n          logger.warn(`Low rate limit remaining: ${remaining}`, {\n            url: url.substring(0, 100),\n            resetAt: response.headers.get('x-ratelimit-reset'),\n          });\n        }\n        \n        // Warn about slow responses\n        if (duration > 2000) {\n          logger.warn(`Slow HTTP response: ${duration}ms`, {\n            method,\n            url: url.substring(0, 100),\n            status: response.status,\n          });\n        }\n        \n        return response;\n      } catch (error: any) {\n        const duration = Date.now() - startTime;\n        \n        logger.error(`HTTP ${method} failed`, error, {\n          url: url.substring(0, 100),\n          duration,\n          errorType: error.constructor.name,\n          errno: error.errno,\n          code: error.code,\n        });\n        \n        throw error;\n      }\n    });\n  };\n}\n\n/**\n * Create a traced GraphQL client wrapper\n */\nexport function wrapGraphQLClient<T>(client: T): T {\n  const prototype = Object.getPrototypeOf(client);\n  const propertyNames = Object.getOwnPropertyNames(prototype);\n  \n  for (const propertyName of propertyNames) {\n    if (propertyName === 'constructor') continue;\n    \n    const descriptor = Object.getOwnPropertyDescriptor(prototype, propertyName);\n    if (!descriptor || typeof descriptor.value !== 'function') continue;\n    \n    // Apply tracing to all methods\n    TraceLinearAPI(prototype, propertyName, descriptor);\n    Object.defineProperty(prototype, propertyName, descriptor);\n  }\n  \n  return client;\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/trace/trace-demo.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+import {
+  trace,
+  enableVerboseTracing,
+  createTracedDatabase,
+  traceStep
+} from "./index.js";
+class ExampleService {
+  data = /* @__PURE__ */ new Map();
+  async fetchData(id) {
+    await this.delay(50);
+    if (id === "error") {
+      throw new Error("Simulated API error");
+    }
+    return { id, value: Math.random() };
+  }
+  async processData(data) {
+    return traceStep("Data validation", async () => {
+      await this.delay(20);
+      if (!data.id) {
+        throw new Error("Invalid data: missing ID");
+      }
+      return traceStep("Data transformation", async () => {
+        await this.delay(30);
+        return {
+          ...data,
+          processed: true,
+          timestamp: Date.now()
+        };
+      });
+    });
+  }
+  cacheData(key, value) {
+    trace.traceSync("function", "cacheData", { key, value }, () => {
+      this.data.set(key, value);
+    });
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+}
+async function databaseExample() {
+  return trace.step("Database operations example", async () => {
+    const db = createTracedDatabase(":memory:");
+    db.exec(`
+      CREATE TABLE users (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        email TEXT UNIQUE,
+        created_at INTEGER DEFAULT (strftime('%s', 'now'))
+      )
+    `);
+    const insert = db.prepare("INSERT INTO users (name, email) VALUES (?, ?)");
+    insert.run("Alice", "alice@example.com");
+    insert.run("Bob", "bob@example.com");
+    const select = db.prepare("SELECT * FROM users WHERE name = ?");
+    const user = select.get("Alice");
+    const complex = db.prepare(`
+      SELECT 
+        name,
+        COUNT(*) as count,
+        MAX(created_at) as latest
+      FROM users
+      GROUP BY name
+      HAVING COUNT(*) > 0
+    `);
+    const results = complex.all();
+    db.close();
+    return { user, results };
+  });
+}
+async function runDemo() {
+  console.log("\n" + "=".repeat(80));
+  console.log("STACKMEMORY DEBUG TRACE DEMO");
+  console.log("=".repeat(80) + "\n");
+  if (process.env.DEBUG_TRACE !== "true") {
+    console.log("\u{1F4DD} Enabling verbose tracing for this demo...\n");
+    enableVerboseTracing();
+  }
+  try {
+    await trace.command("demo:service", { example: "service" }, async () => {
+      const service = new ExampleService();
+      console.log("\n--- Example 1: Service Operations ---\n");
+      const data = await service.fetchData("test-1");
+      const processed = await service.processData(data);
+      service.cacheData("test-1", processed);
+      console.log("\u2705 Service operation completed\n");
+    });
+    await trace.command("demo:database", { example: "database" }, async () => {
+      console.log("\n--- Example 2: Database Operations ---\n");
+      const results = await databaseExample();
+      console.log("\u2705 Database operations completed");
+      console.log("   Found user:", results.user);
+      console.log("   Query results:", results.results);
+    });
+    await trace.command("demo:errors", { example: "errors" }, async () => {
+      console.log("\n--- Example 3: Error Handling ---\n");
+      const service = new ExampleService();
+      try {
+        await service.fetchData("error");
+      } catch (error) {
+        console.log("\u2705 Error properly traced and handled\n");
+      }
+    });
+    await trace.command("demo:performance", { example: "performance" }, async () => {
+      console.log("\n--- Example 4: Performance Tracking ---\n");
+      await trace.step("Slow operation", async () => {
+        await new Promise((resolve) => setTimeout(resolve, 150));
+      });
+      for (let i = 0; i < 3; i++) {
+        await trace.step(`Fast operation ${i + 1}`, async () => {
+          await new Promise((resolve) => setTimeout(resolve, 10));
+        });
+      }
+      console.log("\u2705 Performance tracking completed\n");
+    });
+  } catch (error) {
+    console.error("\u274C Demo failed:", error);
+  }
+  console.log("\n" + trace.getExecutionSummary());
+  const traces = trace.exportTraces();
+  console.log(`
+\u{1F4CA} Total traces collected: ${traces.length}`);
+  if (traces.length > 0) {
+    console.log("\n\u{1F4CD} Example trace entry:");
+    console.log(JSON.stringify(traces[0], null, 2));
+  }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runDemo().catch(console.error);
+}
+export {
+  runDemo
+};
+//# sourceMappingURL=trace-demo.js.map

package/dist/core/trace/trace-demo.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/trace/trace-demo.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Trace Demo - Shows how the debug tracing works\n * Run with: DEBUG_TRACE=true npx tsx src/core/trace/trace-demo.ts\n */\n\nimport { \n  trace, \n  Trace, \n  TraceClass,\n  enableVerboseTracing,\n  createTracedDatabase,\n  traceStep,\n} from './index.js';\nimport { logger } from '../monitoring/logger.js';\n\n// Example class with tracing\n// @TraceClass() - decorators not enabled in tsconfig\nclass ExampleService {\n  private data: Map<string, any> = new Map();\n\n  async fetchData(id: string): Promise<any> {\n    // Simulate API call\n    await this.delay(50);\n    \n    if (id === 'error') {\n      throw new Error('Simulated API error');\n    }\n    \n    return { id, value: Math.random() };\n  }\n\n  async processData(data: any): Promise<any> {\n    return traceStep('Data validation', async () => {\n      await this.delay(20);\n      \n      if (!data.id) {\n        throw new Error('Invalid data: missing ID');\n      }\n      \n      return traceStep('Data transformation', async () => {\n        await this.delay(30);\n        return {\n          ...data,\n          processed: true,\n          timestamp: Date.now(),\n        };\n      });\n    });\n  }\n\n  cacheData(key: string, value: any): void {\n    trace.traceSync('function', 'cacheData', { key, value }, () => {\n      this.data.set(key, value);\n    });\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n}\n\n// Example with database operations\nasync function databaseExample() {\n  return trace.step('Database operations example', async () => {\n    const db = createTracedDatabase(':memory:');\n    \n    // Create table\n    db.exec(`\n      CREATE TABLE users (\n        id INTEGER PRIMARY KEY,\n        name TEXT NOT NULL,\n        email TEXT UNIQUE,\n        created_at INTEGER DEFAULT (strftime('%s', 'now'))\n      )\n    `);\n    \n    // Insert data\n    const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');\n    insert.run('Alice', 'alice@example.com');\n    insert.run('Bob', 'bob@example.com');\n    \n    // Query data\n    const select = db.prepare('SELECT * FROM users WHERE name = ?');\n    const user = select.get('Alice');\n    \n    // Complex query (will trigger slow query warning if threshold is low)\n    const complex = db.prepare(`\n      SELECT \n        name,\n        COUNT(*) as count,\n        MAX(created_at) as latest\n      FROM users\n      GROUP BY name\n      HAVING COUNT(*) > 0\n    `);\n    const results = complex.all();\n    \n    db.close();\n    \n    return { user, results };\n  });\n}\n\n// Main demo function\nasync function runDemo() {\n  console.log('\\n' + '='.repeat(80));\n  console.log('STACKMEMORY DEBUG TRACE DEMO');\n  console.log('='.repeat(80) + '\\n');\n  \n  // Enable verbose tracing for the demo\n  if (process.env.DEBUG_TRACE !== 'true') {\n    console.log('\uD83D\uDCDD Enabling verbose tracing for this demo...\\n');\n    enableVerboseTracing();\n  }\n  \n  try {\n    // Example 1: Service operations\n    await trace.command('demo:service', { example: 'service' }, async () => {\n      const service = new ExampleService();\n      \n      console.log('\\n--- Example 1: Service Operations ---\\n');\n      \n      // Successful operation\n      const data = await service.fetchData('test-1');\n      const processed = await service.processData(data);\n      service.cacheData('test-1', processed);\n      \n      console.log('\u2705 Service operation completed\\n');\n    });\n    \n    // Example 2: Database operations\n    await trace.command('demo:database', { example: 'database' }, async () => {\n      console.log('\\n--- Example 2: Database Operations ---\\n');\n      \n      const results = await databaseExample();\n      \n      console.log('\u2705 Database operations completed');\n      console.log('   Found user:', results.user);\n      console.log('   Query results:', results.results);\n    });\n    \n    // Example 3: Error handling\n    await trace.command('demo:errors', { example: 'errors' }, async () => {\n      console.log('\\n--- Example 3: Error Handling ---\\n');\n      \n      const service = new ExampleService();\n      \n      try {\n        await service.fetchData('error');\n      } catch (error) {\n        console.log('\u2705 Error properly traced and handled\\n');\n      }\n    });\n    \n    // Example 4: Performance tracking\n    await trace.command('demo:performance', { example: 'performance' }, async () => {\n      console.log('\\n--- Example 4: Performance Tracking ---\\n');\n      \n      // Simulate slow operation\n      await trace.step('Slow operation', async () => {\n        await new Promise(resolve => setTimeout(resolve, 150));\n      });\n      \n      // Simulate fast operations\n      for (let i = 0; i < 3; i++) {\n        await trace.step(`Fast operation ${i + 1}`, async () => {\n          await new Promise(resolve => setTimeout(resolve, 10));\n        });\n      }\n      \n      console.log('\u2705 Performance tracking completed\\n');\n    });\n    \n  } catch (error) {\n    console.error('\u274C Demo failed:', error);\n  }\n  \n  // Show execution summary\n  console.log('\\n' + trace.getExecutionSummary());\n  \n  // Export traces for analysis\n  const traces = trace.exportTraces();\n  console.log(`\\n\uD83D\uDCCA Total traces collected: ${traces.length}`);\n  \n  // Show example trace entry\n  if (traces.length > 0) {\n    console.log('\\n\uD83D\uDCCD Example trace entry:');\n    console.log(JSON.stringify(traces[0], null, 2));\n  }\n}\n\n// Run the demo\nif (import.meta.url === `file://${process.argv[1]}`) {\n  runDemo().catch(console.error);\n}\n\nexport { runDemo };"],
+  "mappings": ";AAMA;AAAA,EACE;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,MAAM,eAAe;AAAA,EACX,OAAyB,oBAAI,IAAI;AAAA,EAEzC,MAAM,UAAU,IAA0B;AAExC,UAAM,KAAK,MAAM,EAAE;AAEnB,QAAI,OAAO,SAAS;AAClB,YAAM,IAAI,MAAM,qBAAqB;AAAA,IACvC;AAEA,WAAO,EAAE,IAAI,OAAO,KAAK,OAAO,EAAE;AAAA,EACpC;AAAA,EAEA,MAAM,YAAY,MAAyB;AACzC,WAAO,UAAU,mBAAmB,YAAY;AAC9C,YAAM,KAAK,MAAM,EAAE;AAEnB,UAAI,CAAC,KAAK,IAAI;AACZ,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AAEA,aAAO,UAAU,uBAAuB,YAAY;AAClD,cAAM,KAAK,MAAM,EAAE;AACnB,eAAO;AAAA,UACL,GAAG;AAAA,UACH,WAAW;AAAA,UACX,WAAW,KAAK,IAAI;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,UAAU,KAAa,OAAkB;AACvC,UAAM,UAAU,YAAY,aAAa,EAAE,KAAK,MAAM,GAAG,MAAM;AAC7D,WAAK,KAAK,IAAI,KAAK,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA,EAEQ,MAAM,IAA2B;AACvC,WAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AAAA,EACvD;AACF;AAGA,eAAe,kBAAkB;AAC/B,SAAO,MAAM,KAAK,+BAA+B,YAAY;AAC3D,UAAM,KAAK,qBAAqB,UAAU;AAG1C,OAAG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAOP;AAGD,UAAM,SAAS,GAAG,QAAQ,+CAA+C;AACzE,WAAO,IAAI,SAAS,mBAAmB;AACvC,WAAO,IAAI,OAAO,iBAAiB;AAGnC,UAAM,SAAS,GAAG,QAAQ,oCAAoC;AAC9D,UAAM,OAAO,OAAO,IAAI,OAAO;AAG/B,UAAM,UAAU,GAAG,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAQ1B;AACD,UAAM,UAAU,QAAQ,IAAI;AAE5B,OAAG,MAAM;AAET,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB,CAAC;AACH;AAGA,eAAe,UAAU;AACvB,UAAQ,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;AACjC,UAAQ,IAAI,8BAA8B;AAC1C,UAAQ,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI;AAGjC,MAAI,QAAQ,IAAI,gBAAgB,QAAQ;AACtC,YAAQ,IAAI,uDAAgD;AAC5D,yBAAqB;AAAA,EACvB;AAEA,MAAI;AAEF,UAAM,MAAM,QAAQ,gBAAgB,EAAE,SAAS,UAAU,GAAG,YAAY;AACtE,YAAM,UAAU,IAAI,eAAe;AAEnC,cAAQ,IAAI,2CAA2C;AAGvD,YAAM,OAAO,MAAM,QAAQ,UAAU,QAAQ;AAC7C,YAAM,YAAY,MAAM,QAAQ,YAAY,IAAI;AAChD,cAAQ,UAAU,UAAU,SAAS;AAErC,cAAQ,IAAI,sCAAiC;AAAA,IAC/C,CAAC;AAGD,UAAM,MAAM,QAAQ,iBAAiB,EAAE,SAAS,WAAW,GAAG,YAAY;AACxE,cAAQ,IAAI,4CAA4C;AAExD,YAAM,UAAU,MAAM,gBAAgB;AAEtC,cAAQ,IAAI,sCAAiC;AAC7C,cAAQ,IAAI,kBAAkB,QAAQ,IAAI;AAC1C,cAAQ,IAAI,qBAAqB,QAAQ,OAAO;AAAA,IAClD,CAAC;AAGD,UAAM,MAAM,QAAQ,eAAe,EAAE,SAAS,SAAS,GAAG,YAAY;AACpE,cAAQ,IAAI,uCAAuC;AAEnD,YAAM,UAAU,IAAI,eAAe;AAEnC,UAAI;AACF,cAAM,QAAQ,UAAU,OAAO;AAAA,MACjC,SAAS,OAAO;AACd,gBAAQ,IAAI,4CAAuC;AAAA,MACrD;AAAA,IACF,CAAC;AAGD,UAAM,MAAM,QAAQ,oBAAoB,EAAE,SAAS,cAAc,GAAG,YAAY;AAC9E,cAAQ,IAAI,6CAA6C;AAGzD,YAAM,MAAM,KAAK,kBAAkB,YAAY;AAC7C,cAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,GAAG,CAAC;AAAA,MACvD,CAAC;AAGD,eAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,cAAM,MAAM,KAAK,kBAAkB,IAAI,CAAC,IAAI,YAAY;AACtD,gBAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AAAA,QACtD,CAAC;AAAA,MACH;AAEA,cAAQ,IAAI,yCAAoC;AAAA,IAClD,CAAC;AAAA,EAEH,SAAS,OAAO;AACd,YAAQ,MAAM,uBAAkB,KAAK;AAAA,EACvC;AAGA,UAAQ,IAAI,OAAO,MAAM,oBAAoB,CAAC;AAG9C,QAAM,SAAS,MAAM,aAAa;AAClC,UAAQ,IAAI;AAAA,oCAAgC,OAAO,MAAM,EAAE;AAG3D,MAAI,OAAO,SAAS,GAAG;AACrB,YAAQ,IAAI,kCAA2B;AACvC,YAAQ,IAAI,KAAK,UAAU,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AAAA,EAChD;AACF;AAGA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,CAAC,CAAC,IAAI;AACnD,UAAQ,EAAE,MAAM,QAAQ,KAAK;AAC/B;",
+  "names": []
+}