@stackmemoryai/stackmemory 0.5.58 → 0.5.59

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

@@ -0,0 +1,417 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+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";
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) {
+    if (defaultValue !== void 0) return defaultValue;
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value;
+}
+function getOptionalEnv(key) {
+  return process.env[key];
+}
+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 = (/* @__PURE__ */ 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") {
+        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) {
+          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 void 0;
+    return process.memoryUsage();
+  }
+  formatDuration(ms) {
+    if (ms < 1e3) return `${ms.toFixed(0)}ms`;
+    if (ms < 6e4) return `${(ms / 1e3).toFixed(2)}s`;
+    return `${(ms / 6e4).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 ? ` (\u0394mem: ${this.formatMemory(entry.memory.delta.heapUsed)})` : "";
+    let output = `${indent}\u2192 [${entry.type.toUpperCase()}:${entry.id.substring(0, 8)}] ${entry.name}${duration}${memory}`;
+    if (entry.error) {
+      output += `
+${indent}  \u2717 ERROR: ${entry.error.message || entry.error}`;
+      if (entry.error.stack && this.config.verbosity === "full") {
+        output += `
+${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 += `
+${indent}  \u25B8 Params: ${JSON.stringify(maskedParams, null, 2).replace(/\n/g, "\n" + indent + "    ")}`;
+    }
+    if (this.config.includeResults && entry.result !== void 0 && !entry.error) {
+      const maskedResult = this.maskSensitiveData(entry.result);
+      const resultStr = JSON.stringify(maskedResult, null, 2);
+      if (resultStr.length < 200) {
+        output += `
+${indent}  \u25C2 Result: ${resultStr.replace(/\n/g, "\n" + indent + "    ")}`;
+      } else {
+        output += `
+${indent}  \u25C2 Result: [${typeof maskedResult}] ${resultStr.substring(0, 100)}...`;
+      }
+    }
+    if (entry.duration && entry.duration > this.config.performanceThreshold) {
+      output += `
+${indent}  WARNING: 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 += `
+${indent}\u2190 [${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: (/* @__PURE__ */ 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;
+    }
+    const entry = {
+      id,
+      parentId,
+      type,
+      name,
+      startTime: performance.now(),
+      depth,
+      params: this.config.includeParams ? params : void 0,
+      metadata,
+      children: [],
+      memory: this.captureMemory() ? { before: this.captureMemory() } : void 0
+    };
+    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 : void 0;
+    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);
+    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, void 0, 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, void 0, error);
+      throw error;
+    }
+  }
+  async command(name, options, fn) {
+    return this.traceAsync("command", name, options, fn);
+  }
+  async step(name, fn) {
+    return this.traceAsync("step", name, void 0, 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 = `
+${"=".repeat(80)}
+`;
+    summary += `EXECUTION SUMMARY
+`;
+    summary += `${"=".repeat(80)}
+`;
+    summary += `Total Duration: ${this.formatDuration(totalDuration)}
+`;
+    summary += `Total Operations: ${this.countOperations(this.allTraces)}
+`;
+    summary += `Errors: ${errorCount}
+`;
+    summary += `Slow Operations (>${this.config.performanceThreshold}ms): ${slowCount}
+`;
+    if (this.config.captureMemory) {
+      const memUsage = process.memoryUsage();
+      summary += `Final Memory: RSS=${this.formatMemory(memUsage.rss)}, Heap=${this.formatMemory(memUsage.heapUsed)}
+`;
+    }
+    if (this.outputFile) {
+      summary += `Trace Log: ${this.outputFile}
+`;
+    }
+    summary += `${"=".repeat(80)}`;
+    return summary;
+  }
+  countOperations(traces) {
+    let count = traces.length;
+    for (const trace2 of traces) {
+      count += this.countOperations(trace2.children);
+    }
+    return count;
+  }
+  countErrors(traces) {
+    let count = 0;
+    for (const trace2 of traces) {
+      if (trace2.error) count++;
+      count += this.countErrors(trace2.children);
+    }
+    return count;
+  }
+  countSlowOperations(traces) {
+    let count = 0;
+    for (const trace2 of traces) {
+      if (trace2.duration && trace2.duration > this.config.performanceThreshold)
+        count++;
+      count += this.countSlowOperations(trace2.children);
+    }
+    return count;
+  }
+  getLastError() {
+    const findLastError = (traces) => {
+      for (let i = traces.length - 1; i >= 0; i--) {
+        const trace2 = traces[i];
+        if (trace2.error) return trace2;
+        const childError = findLastError(trace2.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();
+  }
+}
+const trace = TraceContext.getInstance();
+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;
+  };
+}
+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;
+  };
+}
+function TraceCritical(target, propertyKey, descriptor) {
+  const originalMethod = descriptor.value;
+  descriptor.value = async function(...args) {
+    const className = target.constructor.name;
+    const methodName = `${className}.${propertyKey} [CRITICAL]`;
+    const contextBefore = {
+      memory: process.memoryUsage(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      args: trace["maskSensitiveData"](args)
+    };
+    try {
+      return await trace.traceAsync(
+        "function",
+        methodName,
+        contextBefore,
+        async () => {
+          return originalMethod.apply(this, args);
+        }
+      );
+    } catch (error) {
+      logger.error(`Critical operation failed: ${methodName}`, error, {
+        context: contextBefore,
+        stack: error.stack
+      });
+      throw error;
+    }
+  };
+  return descriptor;
+}
+export {
+  Trace,
+  TraceClass,
+  TraceContext,
+  TraceCritical,
+  trace
+};
+//# sourceMappingURL=debug-trace.js.map

package/dist/src/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// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\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:\n        process.env['DEBUG_TRACE'] === 'true' ||\n        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(\n        process.env['TRACE_PERF_THRESHOLD'] || '100'\n      ),\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(\n      process.env['HOME'] || '.',\n      '.stackmemory',\n      'traces'\n    );\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) =>\n          pattern.test(key)\n        );\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\n      ? ` [${this.formatDuration(entry.duration)}]`\n      : '';\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 (\n      this.config.includeParams &&\n      entry.params &&\n      Object.keys(entry.params).length > 0\n    ) {\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 (\n      this.config.includeResults &&\n      entry.result !== undefined &&\n      !entry.error\n    ) {\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}  WARNING: 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 (\n      (this.config.output === 'file' || this.config.output === 'both') &&\n      this.outputFile\n    ) {\n      const jsonLine =\n        JSON.stringify({\n          ...entry,\n          formatted,\n          timestamp: new Date().toISOString(),\n        }) + '\\n';\n      fs.appendFileSync(this.outputFile, jsonLine);\n    }\n  }\n\n  startTrace(\n    type: TraceEntry['type'],\n    name: string,\n    params?: any,\n    metadata?: Record<string, any>\n  ): 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()\n        ? { before: this.captureMemory()! }\n        : 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: unknown) {\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: unknown) {\n      this.endTrace(id, undefined, error);\n      throw error;\n    }\n  }\n\n  async command<T>(\n    name: string,\n    options: any,\n    fn: () => Promise<T>\n  ): 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>(\n    method: string,\n    url: string,\n    body: any,\n    fn: () => Promise<T>\n  ): 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)\n        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(\n        prototype,\n        propertyName\n      );\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(\n  target: any,\n  propertyKey: string,\n  descriptor: PropertyDescriptor\n) {\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(\n        'function',\n        methodName,\n        contextBefore,\n        async () => {\n          return originalMethod.apply(this, args);\n        }\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}\n"],
+  "mappings": "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",
+  "names": ["trace"]
+}

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

@@ -0,0 +1,109 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+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() {
+}
+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("Tracing enabled");
+};
+const disableTracing = () => {
+  delete process.env["DEBUG_TRACE"];
+  console.log("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("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/src/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 * Configuration is read directly from env vars by trace decorators\n */\nexport function initializeTracing(): void {\n  // No-op - trace config is read from env vars on demand\n}\n\n/**\n * Helper to enable tracing for a specific scope\n */\nexport function withTracing<T>(fn: () => T, options?: Partial<TraceConfig>): 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(\n          options.performanceThreshold\n        );\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('Tracing enabled');\n};\n\nexport const disableTracing = () => {\n  delete process.env['DEBUG_TRACE'];\n  console.log('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('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};\n"],
+  "mappings": ";;;;AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMA,SAAS,oBAA0B;AAE1C;AAKO,SAAS,YAAe,IAAa,SAAmC;AAC7E,QAAM,cAAc,QAAQ,IAAI,aAAa;AAE7C,MAAI;AAEF,YAAQ,IAAI,aAAa,IAAI;AAG7B,QAAI,SAAS;AACX,UAAI,QAAQ,OAAQ,SAAQ,IAAI,cAAc,IAAI,QAAQ;AAC1D,UAAI,QAAQ,UAAW,SAAQ,IAAI,iBAAiB,IAAI,QAAQ;AAChE,UAAI,QAAQ,kBAAkB,QAAW;AACvC,gBAAQ,IAAI,cAAc,IAAI,OAAO,QAAQ,aAAa;AAAA,MAC5D;AACA,UAAI,QAAQ,mBAAmB,QAAW;AACxC,gBAAQ,IAAI,eAAe,IAAI,OAAO,QAAQ,cAAc;AAAA,MAC9D;AACA,UAAI,QAAQ,yBAAyB,QAAW;AAC9C,gBAAQ,IAAI,sBAAsB,IAAI;AAAA,UACpC,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAEA,WAAO,GAAG;AAAA,EACZ,UAAE;AAEA,QAAI,gBAAgB,QAAW;AAC7B,aAAO,QAAQ,IAAI,aAAa;AAAA,IAClC,OAAO;AACL,cAAQ,IAAI,aAAa,IAAI;AAAA,IAC/B;AAAA,EACF;AACF;AAKO,MAAM,gBAAgB,MAAM;AACjC,UAAQ,IAAI,aAAa,IAAI;AAC7B,UAAQ,IAAI,iBAAiB;AAC/B;AAEO,MAAM,iBAAiB,MAAM;AAClC,SAAO,QAAQ,IAAI,aAAa;AAChC,UAAQ,IAAI,kBAAkB;AAChC;AAEO,MAAM,uBAAuB,MAAM;AACxC,UAAQ,IAAI,aAAa,IAAI;AAC7B,UAAQ,IAAI,iBAAiB,IAAI;AACjC,UAAQ,IAAI,cAAc,IAAI;AAC9B,UAAQ,IAAI,eAAe,IAAI;AAC/B,UAAQ,IAAI,cAAc,IAAI;AAC9B,UAAQ,IAAI,yBAAyB;AACvC;AAEO,MAAM,uBAAuB,MAAM;AACxC,UAAQ,IAAI,aAAa,IAAI;AAC7B,UAAQ,IAAI,iBAAiB,IAAI;AACjC,UAAQ,IAAI,cAAc,IAAI;AAC9B,UAAQ,IAAI,eAAe,IAAI;AAC/B,UAAQ,IAAI,cAAc,IAAI;AAC9B,UAAQ,IAAI,gCAA2B;AACzC;",
+  "names": []
+}