@probelabs/visor 0.1.107 → 0.1.112

package/dist/sdk/{chunk-OOZITMRU.mjs → chunk-3OMWVM6J.mjs}

@@ -42,6 +42,16 @@ async function initializeTracer(sessionId, checkName) {
         enableConsole: false
       });
       const tracer = new SimpleAppTracer(telemetry, sessionId);
+      if (typeof tracer.recordEvent !== "function") {
+        tracer.recordEvent = (name, attributes) => {
+          try {
+            if (telemetry.record) {
+              telemetry.record({ event: name, ...attributes });
+            }
+          } catch {
+          }
+        };
+      }
       console.error(`\u{1F4CA} Simple tracing enabled, will save to: ${traceFilePath}`);
       if (process.env.GITHUB_ACTIONS) {
         console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);
@@ -69,4 +79,4 @@ export {
   initializeTracer,
   init_tracer_init
 };
-//# sourceMappingURL=chunk-OOZITMRU.mjs.map
+//# sourceMappingURL=chunk-3OMWVM6J.mjs.map

package/dist/sdk/{chunk-OOZITMRU.mjs.map → chunk-3OMWVM6J.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/tracer-init.ts"],"sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\n\n/**\n * Safely initialize a tracer for ProbeAgent with proper path sanitization\n * Uses SimpleTelemetry for lightweight tracing\n * This prevents path traversal vulnerabilities by sanitizing the checkName\n */\ntype ProbeModule =\n  | {\n      SimpleTelemetry?: new (opts: {\n        enableFile: boolean;\n        filePath: string;\n        enableConsole?: boolean;\n      }) => unknown;\n      SimpleAppTracer?: new (telemetry: unknown, sessionId: string) => unknown;\n    }\n  | undefined;\n\nexport async function initializeTracer(\n  sessionId: string,\n  checkName?: string\n): Promise<{ tracer: unknown; telemetryConfig: unknown; filePath: string } | null> {\n  try {\n    // Load Probe lib in a way that works in both ESM and CJS bundles\n    let ProbeLib: ProbeModule;\n    try {\n      ProbeLib = (await import('@probelabs/probe')) as ProbeModule;\n    } catch {\n      try {\n        // Fallback to CJS require if available\n\n        ProbeLib = require('@probelabs/probe') as ProbeModule;\n      } catch {\n        ProbeLib = {} as unknown as ProbeModule;\n      }\n    }\n\n    // Use SimpleTelemetry (probe no longer exports full OpenTelemetry classes)\n    const SimpleTelemetry = ProbeLib?.SimpleTelemetry;\n    const SimpleAppTracer = ProbeLib?.SimpleAppTracer;\n    if (SimpleTelemetry && SimpleAppTracer) {\n      // SECURITY: Sanitize checkName to prevent path traversal attacks\n      const sanitizedCheckName = checkName ? path.basename(checkName) : 'check';\n\n      // Create trace file path in debug-artifacts directory\n      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n      const traceDir = process.env.GITHUB_WORKSPACE\n        ? path.join(process.env.GITHUB_WORKSPACE, 'debug-artifacts')\n        : path.join(process.cwd(), 'debug-artifacts');\n\n      // Create traces directory if it doesn't exist\n      if (!fs.existsSync(traceDir)) {\n        fs.mkdirSync(traceDir, { recursive: true });\n      }\n\n      // SECURITY: Use path.join to safely construct the path\n      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);\n\n      // SECURITY: Verify the resolved path is within the intended directory\n      const resolvedTracePath = path.resolve(traceFilePath);\n      const resolvedTraceDir = path.resolve(traceDir);\n      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {\n        console.error(\n          `⚠️ Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`\n        );\n        return null;\n      }\n\n      // Initialize simple telemetry\n      const telemetry = new SimpleTelemetry({\n        enableFile: true,\n        filePath: traceFilePath,\n        enableConsole: false,\n      });\n\n      const tracer = new SimpleAppTracer(telemetry, sessionId);\n\n      console.error(`📊 Simple tracing enabled, will save to: ${traceFilePath}`);\n\n      // If in GitHub Actions, log the path for artifact upload\n      if (process.env.GITHUB_ACTIONS) {\n        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);\n        console.log(`::set-output name=trace-path::${traceFilePath}`);\n      }\n\n      // Return with SimpleTelemetry\n      return {\n        tracer,\n        telemetryConfig: telemetry,\n        filePath: traceFilePath,\n      };\n    }\n\n    console.error('⚠️ Telemetry classes not available in ProbeAgent, skipping tracing');\n    return null;\n  } catch (error) {\n    console.error('⚠️ Warning: Failed to initialize tracing:', error);\n    return null;\n  }\n}\n"],"mappings":";;;;;;AAAA,YAAY,UAAU;AACtB,YAAY,QAAQ;AAkBpB,eAAsB,iBACpB,WACA,WACiF;AACjF,MAAI;AAEF,QAAI;AACJ,QAAI;AACF,iBAAY,MAAM,OAAO,kBAAkB;AAAA,IAC7C,QAAQ;AACN,UAAI;AAGF,mBAAW,UAAQ,kBAAkB;AAAA,MACvC,QAAQ;AACN,mBAAW,CAAC;AAAA,MACd;AAAA,IACF;AAGA,UAAM,kBAAkB,UAAU;AAClC,UAAM,kBAAkB,UAAU;AAClC,QAAI,mBAAmB,iBAAiB;AAEtC,YAAM,qBAAqB,YAAiB,cAAS,SAAS,IAAI;AAGlE,YAAM,aAAY,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,SAAS,GAAG;AAC/D,YAAM,WAAW,QAAQ,IAAI,mBACpB,UAAK,QAAQ,IAAI,kBAAkB,iBAAiB,IACpD,UAAK,QAAQ,IAAI,GAAG,iBAAiB;AAG9C,UAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,QAAG,aAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MAC5C;AAGA,YAAM,gBAAqB,UAAK,UAAU,SAAS,kBAAkB,IAAI,SAAS,QAAQ;AAG1F,YAAM,oBAAyB,aAAQ,aAAa;AACpD,YAAM,mBAAwB,aAAQ,QAAQ;AAC9C,UAAI,CAAC,kBAAkB,WAAW,gBAAgB,GAAG;AACnD,gBAAQ;AAAA,UACN,yEAA+D,SAAS,oBAAoB,iBAAiB;AAAA,QAC/G;AACA,eAAO;AAAA,MACT;AAGA,YAAM,YAAY,IAAI,gBAAgB;AAAA,QACpC,YAAY;AAAA,QACZ,UAAU;AAAA,QACV,eAAe;AAAA,MACjB,CAAC;AAED,YAAM,SAAS,IAAI,gBAAgB,WAAW,SAAS;AAEvD,cAAQ,MAAM,mDAA4C,aAAa,EAAE;AAGzE,UAAI,QAAQ,IAAI,gBAAgB;AAC9B,gBAAQ,IAAI,mDAAmD,aAAa,EAAE;AAC9E,gBAAQ,IAAI,iCAAiC,aAAa,EAAE;AAAA,MAC9D;AAGA,aAAO;AAAA,QACL;AAAA,QACA,iBAAiB;AAAA,QACjB,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,YAAQ,MAAM,8EAAoE;AAClF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,uDAA6C,KAAK;AAChE,WAAO;AAAA,EACT;AACF;AApGA;AAAA;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/utils/tracer-init.ts"],"sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\n\n/**\n * Safely initialize a tracer for ProbeAgent with proper path sanitization\n * Uses SimpleTelemetry for lightweight tracing\n * This prevents path traversal vulnerabilities by sanitizing the checkName\n */\ntype ProbeModule =\n  | {\n      SimpleTelemetry?: new (opts: {\n        enableFile: boolean;\n        filePath: string;\n        enableConsole?: boolean;\n      }) => unknown;\n      SimpleAppTracer?: new (telemetry: unknown, sessionId: string) => unknown;\n    }\n  | undefined;\n\nexport async function initializeTracer(\n  sessionId: string,\n  checkName?: string\n): Promise<{ tracer: unknown; telemetryConfig: unknown; filePath: string } | null> {\n  try {\n    // Load Probe lib in a way that works in both ESM and CJS bundles\n    let ProbeLib: ProbeModule;\n    try {\n      ProbeLib = (await import('@probelabs/probe')) as ProbeModule;\n    } catch {\n      try {\n        // Fallback to CJS require if available\n\n        ProbeLib = require('@probelabs/probe') as ProbeModule;\n      } catch {\n        ProbeLib = {} as unknown as ProbeModule;\n      }\n    }\n\n    // Use SimpleTelemetry (probe no longer exports full OpenTelemetry classes)\n    const SimpleTelemetry = ProbeLib?.SimpleTelemetry;\n    const SimpleAppTracer = ProbeLib?.SimpleAppTracer;\n    if (SimpleTelemetry && SimpleAppTracer) {\n      // SECURITY: Sanitize checkName to prevent path traversal attacks\n      const sanitizedCheckName = checkName ? path.basename(checkName) : 'check';\n\n      // Create trace file path in debug-artifacts directory\n      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n      const traceDir = process.env.GITHUB_WORKSPACE\n        ? path.join(process.env.GITHUB_WORKSPACE, 'debug-artifacts')\n        : path.join(process.cwd(), 'debug-artifacts');\n\n      // Create traces directory if it doesn't exist\n      if (!fs.existsSync(traceDir)) {\n        fs.mkdirSync(traceDir, { recursive: true });\n      }\n\n      // SECURITY: Use path.join to safely construct the path\n      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);\n\n      // SECURITY: Verify the resolved path is within the intended directory\n      const resolvedTracePath = path.resolve(traceFilePath);\n      const resolvedTraceDir = path.resolve(traceDir);\n      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {\n        console.error(\n          `⚠️ Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`\n        );\n        return null;\n      }\n\n      // Initialize simple telemetry\n      const telemetry = new SimpleTelemetry({\n        enableFile: true,\n        filePath: traceFilePath,\n        enableConsole: false,\n      });\n\n      const tracer = new SimpleAppTracer(telemetry, sessionId);\n\n      // WORKAROUND: Add missing recordEvent method for completionPrompt feature (probe #321)\n      // SimpleAppTracer doesn't have recordEvent but completionPrompt requires it\n      if (typeof (tracer as any).recordEvent !== 'function') {\n        (tracer as any).recordEvent = (name: string, attributes?: Record<string, unknown>) => {\n          // Log completion events to telemetry for debugging\n          try {\n            if ((telemetry as any).record) {\n              (telemetry as any).record({ event: name, ...attributes });\n            }\n          } catch {\n            // Best-effort only\n          }\n        };\n      }\n\n      console.error(`📊 Simple tracing enabled, will save to: ${traceFilePath}`);\n\n      // If in GitHub Actions, log the path for artifact upload\n      if (process.env.GITHUB_ACTIONS) {\n        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);\n        console.log(`::set-output name=trace-path::${traceFilePath}`);\n      }\n\n      // Return with SimpleTelemetry\n      return {\n        tracer,\n        telemetryConfig: telemetry,\n        filePath: traceFilePath,\n      };\n    }\n\n    console.error('⚠️ Telemetry classes not available in ProbeAgent, skipping tracing');\n    return null;\n  } catch (error) {\n    console.error('⚠️ Warning: Failed to initialize tracing:', error);\n    return null;\n  }\n}\n"],"mappings":";;;;;;AAAA,YAAY,UAAU;AACtB,YAAY,QAAQ;AAkBpB,eAAsB,iBACpB,WACA,WACiF;AACjF,MAAI;AAEF,QAAI;AACJ,QAAI;AACF,iBAAY,MAAM,OAAO,kBAAkB;AAAA,IAC7C,QAAQ;AACN,UAAI;AAGF,mBAAW,UAAQ,kBAAkB;AAAA,MACvC,QAAQ;AACN,mBAAW,CAAC;AAAA,MACd;AAAA,IACF;AAGA,UAAM,kBAAkB,UAAU;AAClC,UAAM,kBAAkB,UAAU;AAClC,QAAI,mBAAmB,iBAAiB;AAEtC,YAAM,qBAAqB,YAAiB,cAAS,SAAS,IAAI;AAGlE,YAAM,aAAY,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,SAAS,GAAG;AAC/D,YAAM,WAAW,QAAQ,IAAI,mBACpB,UAAK,QAAQ,IAAI,kBAAkB,iBAAiB,IACpD,UAAK,QAAQ,IAAI,GAAG,iBAAiB;AAG9C,UAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,QAAG,aAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MAC5C;AAGA,YAAM,gBAAqB,UAAK,UAAU,SAAS,kBAAkB,IAAI,SAAS,QAAQ;AAG1F,YAAM,oBAAyB,aAAQ,aAAa;AACpD,YAAM,mBAAwB,aAAQ,QAAQ;AAC9C,UAAI,CAAC,kBAAkB,WAAW,gBAAgB,GAAG;AACnD,gBAAQ;AAAA,UACN,yEAA+D,SAAS,oBAAoB,iBAAiB;AAAA,QAC/G;AACA,eAAO;AAAA,MACT;AAGA,YAAM,YAAY,IAAI,gBAAgB;AAAA,QACpC,YAAY;AAAA,QACZ,UAAU;AAAA,QACV,eAAe;AAAA,MACjB,CAAC;AAED,YAAM,SAAS,IAAI,gBAAgB,WAAW,SAAS;AAIvD,UAAI,OAAQ,OAAe,gBAAgB,YAAY;AACrD,QAAC,OAAe,cAAc,CAAC,MAAc,eAAyC;AAEpF,cAAI;AACF,gBAAK,UAAkB,QAAQ;AAC7B,cAAC,UAAkB,OAAO,EAAE,OAAO,MAAM,GAAG,WAAW,CAAC;AAAA,YAC1D;AAAA,UACF,QAAQ;AAAA,UAER;AAAA,QACF;AAAA,MACF;AAEA,cAAQ,MAAM,mDAA4C,aAAa,EAAE;AAGzE,UAAI,QAAQ,IAAI,gBAAgB;AAC9B,gBAAQ,IAAI,mDAAmD,aAAa,EAAE;AAC9E,gBAAQ,IAAI,iCAAiC,aAAa,EAAE;AAAA,MAC9D;AAGA,aAAO;AAAA,QACL;AAAA,QACA,iBAAiB;AAAA,QACjB,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,YAAQ,MAAM,8EAAoE;AAClF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,uDAA6C,KAAK;AAChE,WAAO;AAAA,EACT;AACF;AAnHA;AAAA;AAAA;AAAA;","names":[]}

package/dist/sdk/{chunk-37ZSCMFC.mjs → chunk-7UK3NIIT.mjs}

@@ -1,7 +1,7 @@
 import {
   init_logger,
   logger
-} from "./chunk-VMPLF6FT.mjs";
+} from "./chunk-AGIZJ4UZ.mjs";
 import {
   __esm,
   __export
@@ -479,4 +479,4 @@ export {
   memory_store_exports,
   init_memory_store
 };
-//# sourceMappingURL=chunk-37ZSCMFC.mjs.map
+//# sourceMappingURL=chunk-7UK3NIIT.mjs.map

package/dist/sdk/{chunk-VMPLF6FT.mjs → chunk-AGIZJ4UZ.mjs}

@@ -1,3 +1,8 @@
+import {
+  context,
+  init_lazy_otel,
+  trace
+} from "./chunk-YSN4G6CI.mjs";
 import {
   __esm,
   __export
@@ -44,6 +49,7 @@ var Logger, logger;
 var init_logger = __esm({
   "src/logger.ts"() {
     "use strict";
+    init_lazy_otel();
     Logger = class {
       level = "info";
       isJsonLike = false;
@@ -79,16 +85,56 @@ var init_logger = __esm({
         }
         return true;
       }
+      getTraceSuffix(msg) {
+        if (!msg) return "";
+        if (msg.includes("trace_id=") || msg.includes("trace_id:")) return "";
+        try {
+          const span = trace.getSpan(context.active()) || trace.getActiveSpan();
+          const ctx = span?.spanContext?.();
+          if (!ctx?.traceId) return "";
+          return ` [trace_id=${ctx.traceId} span_id=${ctx.spanId}]`;
+        } catch {
+          return "";
+        }
+      }
       write(msg, level) {
         try {
+          const suffix = this.getTraceSuffix(msg);
+          const decoratedMsg = suffix ? `${msg}${suffix}` : msg;
           if (this.showTimestamps) {
             const ts = (/* @__PURE__ */ new Date()).toISOString();
             const lvl = level ? level : void 0;
-            const prefix = lvl ? `[${ts}] [${lvl}]` : `[${ts}]`;
-            process.stderr.write(`${prefix} ${msg}
+            let tsToken = `[${ts}]`;
+            let lvlToken = lvl ? `[${lvl}]` : "";
+            if (this.isTTY && !this.isJsonLike) {
+              const reset = "\x1B[0m";
+              const dim = "\x1B[2m";
+              const colours = {
+                silent: "",
+                error: "\x1B[31m",
+                // red
+                warn: "\x1B[33m",
+                // yellow
+                info: "\x1B[36m",
+                // cyan
+                verbose: "\x1B[35m",
+                // magenta
+                debug: "\x1B[90m"
+                // bright black / gray
+              };
+              tsToken = `${dim}${tsToken}${reset}`;
+              if (lvl) {
+                const colour = colours[lvl] || "";
+                if (colour) {
+                  lvlToken = `${colour}${lvlToken}${reset}`;
+                }
+              }
+            }
+            const prefix = lvl ? `${tsToken} ${lvlToken}` : tsToken;
+            process.stderr.write(`${prefix} ${decoratedMsg}
 `);
           } else {
-            process.stderr.write(msg + "\n");
+            process.stderr.write(decoratedMsg + "\n");
           }
         } catch {
         }
@@ -124,4 +170,4 @@ export {
   logger_exports,
   init_logger
 };
-//# sourceMappingURL=chunk-VMPLF6FT.mjs.map
+//# sourceMappingURL=chunk-AGIZJ4UZ.mjs.map

package/dist/sdk/chunk-AGIZJ4UZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger.ts"],"sourcesContent":["/*\n * Centralized logger for Visor CLI and Action modes.\n * - Respects output format (suppresses info in JSON/SARIF unless debug)\n * - Supports levels: silent < error < warn < info < verbose < debug\n * - Routes logs to stderr to keep stdout clean for machine-readable output\n */\nimport { context as otContext, trace } from './telemetry/lazy-otel';\n\nexport type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'verbose' | 'debug';\n\nfunction levelToNumber(level: LogLevel): number {\n  switch (level) {\n    case 'silent':\n      return 0;\n    case 'error':\n      return 10;\n    case 'warn':\n      return 20;\n    case 'info':\n      return 30;\n    case 'verbose':\n      return 40;\n    case 'debug':\n      return 50;\n  }\n}\n\nclass Logger {\n  private level: LogLevel = 'info';\n  private isJsonLike: boolean = false;\n  private isTTY: boolean = typeof process !== 'undefined' ? !!process.stderr.isTTY : false;\n  private showTimestamps: boolean = true; // default: always show timestamps\n\n  configure(\n    opts: {\n      outputFormat?: string;\n      level?: LogLevel;\n      debug?: boolean;\n      verbose?: boolean;\n      quiet?: boolean;\n    } = {}\n  ): void {\n    // Determine base level\n    let lvl: LogLevel = 'info';\n\n    if (opts.debug || process.env.VISOR_DEBUG === 'true') {\n      lvl = 'debug';\n    } else if (opts.verbose || process.env.VISOR_LOG_LEVEL === 'verbose') {\n      lvl = 'verbose';\n    } else if (opts.quiet || process.env.VISOR_LOG_LEVEL === 'quiet') {\n      lvl = 'warn';\n    } else if (opts.level) {\n      lvl = opts.level;\n    } else if (process.env.VISOR_LOG_LEVEL) {\n      const envLvl = process.env.VISOR_LOG_LEVEL as LogLevel;\n      if (['silent', 'error', 'warn', 'info', 'verbose', 'debug'].includes(envLvl)) {\n        lvl = envLvl as LogLevel;\n      }\n    }\n\n    this.level = lvl;\n    const output = opts.outputFormat || process.env.VISOR_OUTPUT_FORMAT || 'table';\n    // In JSON/SARIF we suppress non-error logs unless explicitly verbose/debug\n    this.isJsonLike = output === 'json' || output === 'sarif';\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    const desired = levelToNumber(level);\n    const current = levelToNumber(this.level);\n    if (desired > current) return false;\n    if (\n      this.isJsonLike &&\n      desired < levelToNumber('error') &&\n      this.level !== 'debug' &&\n      this.level !== 'verbose'\n    ) {\n      // In JSON/SARIF, hide info/warn unless explicitly verbose/debug\n      return false;\n    }\n    return true;\n  }\n\n  private getTraceSuffix(msg: string): string {\n    if (!msg) return '';\n    if (msg.includes('trace_id=') || msg.includes('trace_id:')) return '';\n    try {\n      const span = trace.getSpan(otContext.active()) || trace.getActiveSpan();\n      const ctx = span?.spanContext?.();\n      if (!ctx?.traceId) return '';\n      return ` [trace_id=${ctx.traceId} span_id=${ctx.spanId}]`;\n    } catch {\n      return '';\n    }\n  }\n\n  private write(msg: string, level?: LogLevel): void {\n    // Always route to stderr to keep stdout clean for results\n    try {\n      const suffix = this.getTraceSuffix(msg);\n      const decoratedMsg = suffix ? `${msg}${suffix}` : msg;\n      if (this.showTimestamps) {\n        const ts = new Date().toISOString();\n        const lvl = level ? level : undefined;\n\n        let tsToken = `[${ts}]`;\n        let lvlToken = lvl ? `[${lvl}]` : '';\n\n        // Add simple ANSI colour when running in a TTY and not emitting\n        // JSON/SARIF. Colours are intentionally minimal and only applied\n        // to the prefix markers, not the full line.\n        if (this.isTTY && !this.isJsonLike) {\n          const reset = '\\x1b[0m';\n          const dim = '\\x1b[2m';\n          const colours: Record<LogLevel, string> = {\n            silent: '',\n            error: '\\x1b[31m', // red\n            warn: '\\x1b[33m', // yellow\n            info: '\\x1b[36m', // cyan\n            verbose: '\\x1b[35m', // magenta\n            debug: '\\x1b[90m', // bright black / gray\n          };\n\n          tsToken = `${dim}${tsToken}${reset}`;\n\n          if (lvl) {\n            const colour = colours[lvl] || '';\n            if (colour) {\n              lvlToken = `${colour}${lvlToken}${reset}`;\n            }\n          }\n        }\n\n        const prefix = lvl ? `${tsToken} ${lvlToken}` : tsToken;\n        process.stderr.write(`${prefix} ${decoratedMsg}\\n`);\n      } else {\n        process.stderr.write(decoratedMsg + '\\n');\n      }\n    } catch {\n      // Ignore write errors\n    }\n  }\n\n  info(msg: string): void {\n    if (this.shouldLog('info')) this.write(msg, 'info');\n  }\n\n  warn(msg: string): void {\n    if (this.shouldLog('warn')) this.write(msg, 'warn');\n  }\n\n  error(msg: string): void {\n    if (this.shouldLog('error')) this.write(msg, 'error');\n  }\n\n  verbose(msg: string): void {\n    if (this.shouldLog('verbose')) this.write(msg, 'verbose');\n  }\n\n  debug(msg: string): void {\n    if (this.shouldLog('debug')) this.write(msg, 'debug');\n  }\n\n  step(msg: string): void {\n    // High-level phase indicator\n    if (this.shouldLog('info')) this.write(`▶ ${msg}`, 'info');\n  }\n\n  success(msg: string): void {\n    if (this.shouldLog('info')) this.write(`✔ ${msg}`, 'info');\n  }\n}\n\n// Singleton instance\nexport const logger = new Logger();\n\n// Helper to configure from CLI options in a single place\nexport function configureLoggerFromCli(options: {\n  output?: string;\n  debug?: boolean;\n  verbose?: boolean;\n  quiet?: boolean;\n}): void {\n  logger.configure({\n    outputFormat: options.output,\n    debug: options.debug,\n    verbose: options.verbose,\n    quiet: options.quiet,\n  });\n\n  // Expose output format and debug to process env for modules that need to gate\n  // stdout emissions without plumbing the value through every call site.\n  try {\n    if (options.output) process.env.VISOR_OUTPUT_FORMAT = String(options.output);\n    if (typeof options.debug === 'boolean') {\n      process.env.VISOR_DEBUG = options.debug ? 'true' : 'false';\n    }\n  } catch {\n    // ignore\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/sdk/{chunk-IEO6CFLG.mjs → chunk-AIVFBIS4.mjs}

@@ -1,18 +1,24 @@
 import {
   FailureConditionEvaluator,
+  init_failure_condition_evaluator
+} from "./chunk-SIWNBRTK.mjs";
+import {
   compileAndRun,
   createSecureSandbox,
-  init_failure_condition_evaluator,
   init_sandbox
-} from "./chunk-OZJ263FM.mjs";
+} from "./chunk-BOVFH3LI.mjs";
+import {
+  addEvent,
+  init_trace_helpers
+} from "./chunk-ZYAUYXSW.mjs";
 import {
   MemoryStore,
   init_memory_store
-} from "./chunk-37ZSCMFC.mjs";
+} from "./chunk-7UK3NIIT.mjs";
 import {
   init_logger,
   logger
-} from "./chunk-VMPLF6FT.mjs";
+} from "./chunk-AGIZJ4UZ.mjs";
 import {
   __esm,
   __export,
@@ -204,6 +210,23 @@ function createMemoryHelpers() {
     }
   };
 }
+function formatScopeLabel(scope) {
+  if (!scope || scope.length === 0) return "";
+  return scope.map((item) => `${item.check}:${item.index}`).join("|");
+}
+function recordRoutingEvent(args) {
+  const attrs = {
+    check_id: args.checkId,
+    trigger: args.trigger,
+    action: args.action
+  };
+  if (args.target) attrs.target = args.target;
+  if (args.source) attrs.source = args.source;
+  const scopeLabel = formatScopeLabel(args.scope);
+  if (scopeLabel) attrs.scope = scopeLabel;
+  if (args.gotoEvent) attrs.goto_event = args.gotoEvent;
+  addEvent("visor.routing", attrs);
+}
 async function handleRouting(context, state, transition, emitEvent, routingContext) {
   const { checkId, scope, result, checkConfig, success } = routingContext;
   logger.info(`[Routing] Evaluating routing for check: ${checkId}, success: ${success}`);
@@ -266,6 +289,14 @@ async function processOnFinish(checkId, scope, result, checkConfig, context, sta
           const itemScope = [
             { check: checkId, index: itemIndex }
           ];
+          recordRoutingEvent({
+            checkId,
+            trigger: "on_finish",
+            action: "run",
+            target: targetCheck,
+            source: "run",
+            scope: itemScope
+          });
           emitEvent({
             type: "ForwardRunRequested",
             target: targetCheck,
@@ -276,6 +307,14 @@ async function processOnFinish(checkId, scope, result, checkConfig, context, sta
         }
       } else {
         state.routingLoopCount++;
+        recordRoutingEvent({
+          checkId,
+          trigger: "on_finish",
+          action: "run",
+          target: targetCheck,
+          source: "run",
+          scope: []
+        });
         emitEvent({
           type: "ForwardRunRequested",
           target: targetCheck,
@@ -312,6 +351,14 @@ async function processOnFinish(checkId, scope, result, checkConfig, context, sta
         logger.info(`[Routing] on_finish.run_js: scheduling ${targetCheck}`);
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_finish",
+        action: "run",
+        target: targetCheck,
+        source: "run_js",
+        scope
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: targetCheck,
@@ -344,6 +391,15 @@ async function processOnFinish(checkId, scope, result, checkConfig, context, sta
         return;
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_finish",
+        action: "goto",
+        target: finishTransTarget.to,
+        source: "transitions",
+        scope,
+        gotoEvent: finishTransTarget.goto_event
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: finishTransTarget.to,
@@ -380,6 +436,14 @@ async function processOnFinish(checkId, scope, result, checkConfig, context, sta
       logger.info(`[Routing] on_finish.goto: ${gotoTarget}`);
     }
     state.routingLoopCount++;
+    recordRoutingEvent({
+      checkId,
+      trigger: "on_finish",
+      action: "goto",
+      target: gotoTarget,
+      source: onFinish.goto_js ? "goto_js" : "goto",
+      scope
+    });
     emitEvent({
       type: "ForwardRunRequested",
       target: gotoTarget,
@@ -528,6 +592,14 @@ async function processOnSuccess(checkId, scope, result, checkConfig, context, st
           const itemScope = [
             { check: checkId, index: itemIndex }
           ];
+          recordRoutingEvent({
+            checkId,
+            trigger: "on_success",
+            action: "run",
+            target: targetCheck,
+            source: "run",
+            scope: itemScope
+          });
           emitEvent({
             type: "ForwardRunRequested",
             target: targetCheck,
@@ -537,6 +609,14 @@ async function processOnSuccess(checkId, scope, result, checkConfig, context, st
         }
       } else {
         state.routingLoopCount++;
+        recordRoutingEvent({
+          checkId,
+          trigger: "on_success",
+          action: "run",
+          target: targetCheck,
+          source: "run",
+          scope
+        });
         emitEvent({
           type: "ForwardRunRequested",
           target: targetCheck,
@@ -572,6 +652,14 @@ async function processOnSuccess(checkId, scope, result, checkConfig, context, st
         logger.info(`[Routing] on_success.run_js: scheduling ${targetCheck}`);
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_success",
+        action: "run",
+        target: targetCheck,
+        source: "run_js",
+        scope
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: targetCheck,
@@ -603,6 +691,15 @@ async function processOnSuccess(checkId, scope, result, checkConfig, context, st
         return;
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_success",
+        action: "goto",
+        target: successTransTarget.to,
+        source: "transitions",
+        scope,
+        gotoEvent: successTransTarget.goto_event
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: successTransTarget.to,
@@ -640,6 +737,15 @@ async function processOnSuccess(checkId, scope, result, checkConfig, context, st
       logger.info(`[Routing] on_success.goto: ${gotoTarget}`);
     }
     state.routingLoopCount++;
+    recordRoutingEvent({
+      checkId,
+      trigger: "on_success",
+      action: "goto",
+      target: gotoTarget,
+      source: onSuccess.goto_js ? "goto_js" : "goto",
+      scope,
+      gotoEvent: onSuccess.goto_event
+    });
     emitEvent({
       type: "ForwardRunRequested",
       target: gotoTarget,
@@ -692,6 +798,14 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
           const itemScope = [
             { check: checkId, index: itemIndex }
           ];
+          recordRoutingEvent({
+            checkId,
+            trigger: "on_fail",
+            action: "run",
+            target: targetCheck,
+            source: "run",
+            scope: itemScope
+          });
           emitEvent({
             type: "ForwardRunRequested",
             target: targetCheck,
@@ -701,6 +815,14 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
         }
       } else {
         state.routingLoopCount++;
+        recordRoutingEvent({
+          checkId,
+          trigger: "on_fail",
+          action: "run",
+          target: targetCheck,
+          source: "run",
+          scope
+        });
         emitEvent({
           type: "ForwardRunRequested",
           target: targetCheck,
@@ -736,6 +858,14 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
         logger.info(`[Routing] on_fail.run_js: scheduling ${targetCheck}`);
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_fail",
+        action: "run",
+        target: targetCheck,
+        source: "run_js",
+        scope
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: targetCheck,
@@ -767,6 +897,13 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
         if (used >= max) return;
         attemptsMap.set(key, used + 1);
         state.routingLoopCount++;
+        recordRoutingEvent({
+          checkId,
+          trigger: "on_fail",
+          action: "retry",
+          source: "retry",
+          scope: sc || []
+        });
         emitEvent({
           type: "ForwardRunRequested",
           target: checkId,
@@ -812,6 +949,15 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
         return;
       }
       state.routingLoopCount++;
+      recordRoutingEvent({
+        checkId,
+        trigger: "on_fail",
+        action: "goto",
+        target: failTransTarget.to,
+        source: "transitions",
+        scope,
+        gotoEvent: failTransTarget.goto_event
+      });
       emitEvent({
         type: "ForwardRunRequested",
         target: failTransTarget.to,
@@ -849,6 +995,15 @@ async function processOnFail(checkId, scope, result, checkConfig, context, state
       logger.info(`[Routing] on_fail.goto: ${gotoTarget}`);
     }
     state.routingLoopCount++;
+    recordRoutingEvent({
+      checkId,
+      trigger: "on_fail",
+      action: "goto",
+      target: gotoTarget,
+      source: onFail.goto_js ? "goto_js" : "goto",
+      scope,
+      gotoEvent: onFail.goto_event
+    });
     emitEvent({
       type: "ForwardRunRequested",
       target: gotoTarget,
@@ -1195,6 +1350,7 @@ var DEFAULT_MAX_LOOPS;
 var init_routing = __esm({
   "src/state-machine/states/routing.ts"() {
     init_logger();
+    init_trace_helpers();
     init_failure_condition_evaluator();
     init_sandbox();
     init_memory_store();
@@ -1212,4 +1368,4 @@ export {
   evaluateTransitions,
   init_routing
 };
-//# sourceMappingURL=chunk-IEO6CFLG.mjs.map
+//# sourceMappingURL=chunk-AIVFBIS4.mjs.map