@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/server/telemetry-middleware.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/server/telemetry-middleware.ts"],
-  "sourcesContent": ["/**\n * OpenTelemetry middleware for Hono server\n * Instruments HTTP requests with spans and semantic attributes\n */\n\nimport type { Context, Next } from 'hono';\n\n// Conditional imports based on telemetry flag\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\n/**\n * Hono middleware that creates a span for each HTTP request\n * Captures HTTP semantic attributes according to OpenTelemetry conventions:\n * - http.method: HTTP request method\n * - http.route: HTTP route pattern\n * - http.status_code: HTTP response status code\n * - http.url: Full request URL\n * - http.user_agent: User agent string\n *\n * Also emits logs at request start and completion per SigNoz integration guide\n * for request lifecycle tracking.\n */\nexport async function telemetryMiddleware(c: Context, next: Next): Promise<void> {\n  if (!isTelemetryEnabled) {\n    return next();\n  }\n\n  // Dynamic import for tree-shaking\n  const { startSpan, endSpan, emitLog } = await import('../telemetry/index.js');\n  const { SeverityNumber } = await import('@opentelemetry/api-logs');\n\n  const method = c.req.method;\n  const path = c.req.path;\n  const route = c.req.routePath || path; // Use route pattern if available\n  const requestStartTime = Date.now();\n\n  // Create span for the HTTP request\n  const span = startSpan('http.server.request', {\n    'http.method': method,\n    'http.route': route,\n    'http.url': c.req.url,\n    'http.target': path,\n    'http.user_agent': c.req.header('user-agent') || '',\n    'http.scheme': new URL(c.req.url).protocol.replace(':', ''),\n  });\n\n  // Log request received (per SigNoz integration guide: request lifecycle logging)\n  await emitLog(SeverityNumber.INFO, 'Request received', {\n    'http.method': method,\n    'http.route': route,\n    'http.target': path,\n  });\n\n  try {\n    // Process the request\n    await next();\n\n    // Add response attributes after request is processed\n    if (span && 'setAttribute' in span) {\n      const statusCode = c.res.status;\n      const durationMs = Date.now() - requestStartTime;\n\n      (span as any).setAttribute('http.status_code', statusCode);\n      (span as any).setAttribute('http.duration_ms', durationMs);\n\n      // Set span status based on HTTP status code\n      if (statusCode >= 500) {\n        (span as any).setStatus({ code: 2, message: 'Server Error' }); // ERROR\n      } else if (statusCode >= 400) {\n        (span as any).setStatus({ code: 2, message: 'Client Error' }); // ERROR\n      } else {\n        (span as any).setStatus({ code: 1 }); // OK\n      }\n\n      // Log request completed (per SigNoz integration guide: request lifecycle logging)\n      await emitLog(\n        statusCode >= 400 ? SeverityNumber.ERROR : SeverityNumber.INFO,\n        'Request completed',\n        {\n          'http.method': method,\n          'http.route': route,\n          'http.target': path,\n          'http.status_code': statusCode,\n          'duration_ms': durationMs,\n        }\n      );\n    }\n  } catch (error) {\n    // Record exception in span\n    if (span && 'recordException' in span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message }); // ERROR\n    }\n    throw error;\n  } finally {\n    // End the span\n    endSpan(span);\n  }\n}\n"],
-  "mappings": "AASA,MAAM,qBAAgE;AActE,eAAsB,oBAAoB,GAAY,MAAU;AAE5D,SAAO,KAAI;AA6Bb,MAAI;AAKF,QAHA,MAAM,KAAI,GAGN,QAAQ,kBAAkB,MAAM;AAClC,YAAM,aAAa,EAAE,IAAI,QACnB,aAAa,KAAK,IAAG,IAAK;AAE/B,WAAa,aAAa,oBAAoB,UAAU,GACxD,KAAa,aAAa,oBAAoB,UAAU,GAGrD,cAAc,MACf,KAAa,UAAU,EAAE,MAAM,GAAG,SAAS,eAAc,CAAE,IACnD,cAAc,MACtB,KAAa,UAAU,EAAE,MAAM,GAAG,SAAS,eAAc,CAAE,IAE3D,KAAa,UAAU,EAAE,MAAM,EAAC,CAAE,GAIrC,MAAM,QACJ,cAAc,MAAM,eAAe,QAAQ,eAAe,MAC1D,qBACA;QACE,eAAe;QACf,cAAc;QACd,eAAe;QACf,oBAAoB;QACpB,aAAe;OAChB;IAEL;EACF,SAAS,OAAO;AAEd,UAAI,QAAQ,qBAAqB,SAC9B,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE,IAElE;EACR;AAEE,YAAQ,IAAI;EACd;AACF;",
+  "sourcesContent": ["/**\n * OpenTelemetry middleware for Hono server\n * Instruments HTTP requests with spans and semantic attributes\n */\n\nimport type { Context, Next } from \"hono\";\n\n// Conditional imports based on telemetry flag\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\n/**\n * Hono middleware that creates a span for each HTTP request\n * Captures HTTP semantic attributes according to OpenTelemetry conventions:\n * - http.method: HTTP request method\n * - http.route: HTTP route pattern\n * - http.status_code: HTTP response status code\n * - http.url: Full request URL\n * - http.user_agent: User agent string\n *\n * Also emits logs at request start and completion per SigNoz integration guide\n * for request lifecycle tracking.\n */\nexport async function telemetryMiddleware(c: Context, next: Next): Promise<void> {\n  const method = c.req.method;\n  const path = c.req.path;\n  const url = c.req.url;\n  const isDebug = process.env.DEBUG || process.env.VERBOSE;\n\n  // Log ALL incoming requests for debugging\n  if (isDebug) {\n    console.log(`[HTTP] ${method} ${path} (full URL: ${url})`);\n  }\n\n  if (!isTelemetryEnabled) {\n    if (isDebug) {\n      console.log(`[Telemetry] Skipping span creation - TELEMETRY_ENABLED is false`);\n    }\n    return next();\n  }\n\n  // Dynamic import for tree-shaking\n  const { startActiveSpan } = await import(\"../telemetry/index.js\");\n\n  const route = c.req.routePath || path; // Use route pattern if available\n\n  if (isDebug) {\n    console.log(`[Telemetry] Creating active span for http.server.request`);\n  }\n\n  // Use startActiveSpan for proper context propagation and automatic span management\n  return await startActiveSpan(\n    \"http.server.request\",\n    async (span) => {\n      const requestStartTime = Date.now();\n\n      // Set initial attributes\n      span.setAttributes({\n        \"http.method\": method,\n        \"http.route\": route,\n        \"http.url\": url,\n        \"http.target\": path,\n        \"http.user_agent\": c.req.header(\"user-agent\") || \"\",\n        \"http.scheme\": new URL(url).protocol.replace(\":\", \"\"),\n      });\n\n      if (isDebug) {\n        console.log(`[Telemetry] Active span created successfully`);\n      }\n\n      try {\n        // Process the request\n        await next();\n\n        // Add response attributes after request is processed\n        const statusCode = c.res.status;\n        const durationMs = Date.now() - requestStartTime;\n\n        span.setAttribute(\"http.status_code\", statusCode);\n        span.setAttribute(\"http.duration_ms\", durationMs);\n\n        // Set span status based on HTTP status code\n        if (statusCode >= 500) {\n          span.setStatus({ code: 2, message: \"Server Error\" }); // ERROR\n        } else if (statusCode >= 400) {\n          span.setStatus({ code: 2, message: \"Client Error\" }); // ERROR\n        } else {\n          span.setStatus({ code: 1 }); // OK\n        }\n      } catch (error) {\n        // Record exception in span\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: (error as Error).message }); // ERROR\n        throw error;\n      }\n      // Span is automatically ended when this async function completes\n    },\n    {\n      \"http.method\": method,\n      \"http.route\": route,\n    }\n  );\n}\n"],
+  "mappings": "AASA,MAAM,qBAAgE;AActE,eAAsB,oBAAoB,GAAY,MAAU;AAC9D,QAAM,SAAS,EAAE,IAAI,QACf,OAAO,EAAE,IAAI,MACb,MAAM,EAAE,IAAI,KACZ,UAAU,QAAQ,IAAI,SAAS,QAAQ,IAAI;AAGjD,SAAI,WACF,QAAQ,IAAI,UAAU,MAAM,IAAI,IAAI,eAAe,GAAG,GAAG,GAIrD,WACF,QAAQ,IAAI,iEAAiE,GAExE,KAAI;AAIb,QAAM,EAAE,gBAAe,IAAK,MAAM,OAAO,uBAAuB,GAE1D,QAAQ,EAAE,IAAI,aAAa;AAEjC,SAAI,WACF,QAAQ,IAAI,0DAA0D,GAIjE,MAAM,gBACX,uBACA,OAAO,SAAQ;AACb,UAAM,mBAAmB,KAAK,IAAG;AAGjC,SAAK,cAAc;MACjB,eAAe;MACf,cAAc;MACd,YAAY;MACZ,eAAe;MACf,mBAAmB,EAAE,IAAI,OAAO,YAAY,KAAK;MACjD,eAAe,IAAI,IAAI,GAAG,EAAE,SAAS,QAAQ,KAAK,EAAE;KACrD,GAEG,WACF,QAAQ,IAAI,8CAA8C;AAG5D,QAAI;AAEF,YAAM,KAAI;AAGV,YAAM,aAAa,EAAE,IAAI,QACnB,aAAa,KAAK,IAAG,IAAK;AAEhC,WAAK,aAAa,oBAAoB,UAAU,GAChD,KAAK,aAAa,oBAAoB,UAAU,GAG5C,cAAc,MAChB,KAAK,UAAU,EAAE,MAAM,GAAG,SAAS,eAAc,CAAE,IAC1C,cAAc,MACvB,KAAK,UAAU,EAAE,MAAM,GAAG,SAAS,eAAc,CAAE,IAEnD,KAAK,UAAU,EAAE,MAAM,EAAC,CAAE;IAE9B,SAAS,OAAO;AAEd,iBAAK,gBAAgB,KAAc,GACnC,KAAK,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE,GACvD;IACR;EAEF,GACA;IACE,eAAe;IACf,cAAc;GACf;AAEL;",
   "names": []
 }

package/dist/server-entry.js

@@ -0,0 +1,65 @@
+import { Model } from "./core/model.js";
+import { VisualizationServer } from "./server/server.js";
+import { getErrorMessage } from "./utils/errors.js";
+const port = parseInt(process.env.DR_VISUALIZE_PORT || "8080", 10), projectPath = process.env.DR_PROJECT_PATH || process.cwd(), authEnabled = process.env.DR_AUTH_ENABLED !== "false", authToken = process.env.DR_AUTH_TOKEN && process.env.DR_AUTH_TOKEN.length > 0 ? process.env.DR_AUTH_TOKEN : void 0, withDanger = process.env.DR_WITH_DANGER === "true", viewerPath = process.env.DR_VIEWER_PATH, isTelemetryEnabled = !1;
+let serverInstance = null, isShuttingDown = !1;
+async function main() {
+  try {
+    if (isTelemetryEnabled)
+      try {
+        const { initTelemetry } = await import("./telemetry/index.js");
+        await initTelemetry();
+        const { loadOTLPConfig } = await import("./telemetry/config.js"), otlpConfig = await loadOTLPConfig();
+        if (process.env.DEBUG || process.env.VERBOSE) {
+          console.log("[Telemetry] SDK initialized in server subprocess"), console.log(`[Telemetry] OTLP traces endpoint: ${otlpConfig.endpoint}`), console.log(`[Telemetry] OTLP logs endpoint: ${otlpConfig.logsEndpoint}`), console.log(`[Telemetry] Service name: ${otlpConfig.serviceName}`);
+          const isBun = typeof globalThis.Bun < "u";
+          console.log(isBun ? "[Telemetry] Runtime: Bun (using fetch-based OTLP exporter)" : "[Telemetry] Runtime: Node.js (using http-based OTLP exporter)");
+        }
+      } catch (error) {
+        console.error("[Telemetry] Failed to initialize telemetry:", error), console.error("[Telemetry] Server will continue without telemetry");
+      }
+    else (process.env.DEBUG || process.env.VERBOSE) && console.log("[Telemetry] TELEMETRY_ENABLED is false - telemetry disabled");
+    const model = await Model.load(projectPath, { lazyLoad: !1 }), server = new VisualizationServer(model, {
+      authEnabled,
+      authToken,
+      withDanger,
+      viewerPath
+    });
+    serverInstance = server, await server.start(port), authEnabled && console.log(`TOKEN:${server.getAuthToken()}`), setupShutdownHandlers();
+  } catch (error) {
+    const message = getErrorMessage(error);
+    console.error(`Error: ${message}`), error instanceof Error && console.error(`Stack: ${error.stack}`), await gracefulShutdown(1);
+  }
+}
+async function gracefulShutdown(exitCode = 0) {
+  if (!isShuttingDown) {
+    isShuttingDown = !0;
+    try {
+      if (serverInstance && (serverInstance.stop(), serverInstance = null), isTelemetryEnabled) {
+        console.log("[Telemetry] Shutting down telemetry and flushing spans...");
+        const { shutdownTelemetry } = await import("./telemetry/index.js");
+        await shutdownTelemetry(), console.log("[Telemetry] Telemetry shutdown complete");
+      } else
+        process.env.DEBUG && console.log("[Telemetry] Telemetry is disabled (TELEMETRY_ENABLED=false at build time)");
+    } catch (error) {
+      process.env.DEBUG && console.error("Error during shutdown:", error);
+    } finally {
+      process.exit(exitCode);
+    }
+  }
+}
+function setupShutdownHandlers() {
+  process.on("SIGINT", async () => {
+    console.log(`
+[SIGINT] Shutting down visualization server...`), await gracefulShutdown(0);
+  }), process.on("SIGTERM", async () => {
+    console.log(`
+[SIGTERM] Shutting down visualization server...`), await gracefulShutdown(0);
+  }), process.on("uncaughtException", async (error) => {
+    console.error("Uncaught exception:", error), await gracefulShutdown(1);
+  }), process.on("unhandledRejection", async (reason) => {
+    console.error("Unhandled rejection:", reason), await gracefulShutdown(1);
+  });
+}
+main();
+//# sourceMappingURL=server-entry.js.map

package/dist/server-entry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/server-entry.ts"],
+  "sourcesContent": ["/**\n * Visualization Server Entry Point\n * This is a Bun-specific entry point for running the visualization server\n * It receives configuration via environment variables and starts the server\n */\n\nimport { Model } from \"./core/model.js\";\nimport { VisualizationServer } from \"./server/server.js\";\nimport { getErrorMessage } from \"./utils/errors.js\";\n\n// Get configuration from environment variables\nconst port = parseInt(process.env.DR_VISUALIZE_PORT || \"8080\", 10);\nconst projectPath = process.env.DR_PROJECT_PATH || process.cwd();\nconst authEnabled = process.env.DR_AUTH_ENABLED !== \"false\";\n// Only pass authToken if it's a non-empty string, otherwise let server generate one\nconst authToken =\n  process.env.DR_AUTH_TOKEN && process.env.DR_AUTH_TOKEN.length > 0\n    ? process.env.DR_AUTH_TOKEN\n    : undefined;\nconst withDanger = process.env.DR_WITH_DANGER === \"true\";\nconst viewerPath = process.env.DR_VIEWER_PATH;\n\n// Conditional telemetry import based on compile-time flag\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\nlet serverInstance: VisualizationServer | null = null;\nlet isShuttingDown = false;\n\nasync function main() {\n  try {\n    // CRITICAL: Initialize telemetry SDK in subprocess\n    // Without this, no spans will be created or exported even though TELEMETRY_ENABLED=true\n    if (isTelemetryEnabled) {\n      try {\n        const { initTelemetry } = await import(\"./telemetry/index.js\");\n        await initTelemetry();\n\n        // Load and display actual OTLP configuration\n        const { loadOTLPConfig } = await import(\"./telemetry/config.js\");\n        const otlpConfig = await loadOTLPConfig();\n\n        if (process.env.DEBUG || process.env.VERBOSE) {\n          console.log(`[Telemetry] SDK initialized in server subprocess`);\n          console.log(`[Telemetry] OTLP traces endpoint: ${otlpConfig.endpoint}`);\n          console.log(`[Telemetry] OTLP logs endpoint: ${otlpConfig.logsEndpoint}`);\n          console.log(`[Telemetry] Service name: ${otlpConfig.serviceName}`);\n\n          // Runtime detection and compatibility info\n          const isBun = typeof (globalThis as any).Bun !== \"undefined\";\n          if (isBun) {\n            console.log(`[Telemetry] Runtime: Bun (using fetch-based OTLP exporter)`);\n          } else {\n            console.log(`[Telemetry] Runtime: Node.js (using http-based OTLP exporter)`);\n          }\n        }\n      } catch (error) {\n        // Log telemetry initialization errors but don't fail the server\n        console.error(\"[Telemetry] Failed to initialize telemetry:\", error);\n        console.error(\"[Telemetry] Server will continue without telemetry\");\n      }\n    } else if (process.env.DEBUG || process.env.VERBOSE) {\n      console.log(`[Telemetry] TELEMETRY_ENABLED is false - telemetry disabled`);\n    }\n\n    // Load model with full content\n    const model = await Model.load(projectPath, { lazyLoad: false });\n\n    // Create and start server\n    const server = new VisualizationServer(model, {\n      authEnabled,\n      authToken,\n      withDanger,\n      viewerPath,\n    });\n    serverInstance = server; // Store for signal handlers\n    await server.start(port);\n\n    // Output token for parent process to read\n    if (authEnabled) {\n      console.log(`TOKEN:${server.getAuthToken()}`);\n    }\n\n    // Setup graceful shutdown handlers\n    setupShutdownHandlers();\n  } catch (error) {\n    const message = getErrorMessage(error);\n    console.error(`Error: ${message}`);\n    if (error instanceof Error) {\n      console.error(`Stack: ${error.stack}`);\n    }\n    await gracefulShutdown(1);\n  }\n}\n\n/**\n * Gracefully shutdown the server and flush telemetry\n */\nasync function gracefulShutdown(exitCode: number = 0): Promise<void> {\n  if (isShuttingDown) {\n    return; // Prevent multiple shutdown attempts\n  }\n  isShuttingDown = true;\n\n  try {\n    // Stop the visualization server\n    if (serverInstance) {\n      serverInstance.stop();\n      serverInstance = null;\n    }\n\n    // Flush telemetry spans before exit\n    if (isTelemetryEnabled) {\n      console.log(\"[Telemetry] Shutting down telemetry and flushing spans...\");\n      const { shutdownTelemetry } = await import(\"./telemetry/index.js\");\n      await shutdownTelemetry();\n      console.log(\"[Telemetry] Telemetry shutdown complete\");\n    } else {\n      if (process.env.DEBUG) {\n        console.log(\"[Telemetry] Telemetry is disabled (TELEMETRY_ENABLED=false at build time)\");\n      }\n    }\n  } catch (error) {\n    // Don't block shutdown on errors\n    if (process.env.DEBUG) {\n      console.error(\"Error during shutdown:\", error);\n    }\n  } finally {\n    process.exit(exitCode);\n  }\n}\n\n/**\n * Setup handlers for graceful shutdown on signals\n */\nfunction setupShutdownHandlers(): void {\n  // Handle Ctrl-C (SIGINT)\n  process.on(\"SIGINT\", async () => {\n    console.log(\"\\n[SIGINT] Shutting down visualization server...\");\n    await gracefulShutdown(0);\n  });\n\n  // Handle termination signal (SIGTERM)\n  process.on(\"SIGTERM\", async () => {\n    console.log(\"\\n[SIGTERM] Shutting down visualization server...\");\n    await gracefulShutdown(0);\n  });\n\n  // Handle uncaught exceptions\n  process.on(\"uncaughtException\", async (error) => {\n    console.error(\"Uncaught exception:\", error);\n    await gracefulShutdown(1);\n  });\n\n  // Handle unhandled promise rejections\n  process.on(\"unhandledRejection\", async (reason) => {\n    console.error(\"Unhandled rejection:\", reason);\n    await gracefulShutdown(1);\n  });\n}\n\nmain();\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/telemetry/config.js

@@ -0,0 +1,89 @@
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { parse } from "yaml";
+import { join } from "node:path";
+const CONFIG_FILENAME = ".dr-config.yaml";
+async function loadOTLPConfig() {
+  const defaults = {
+    endpoint: "http://localhost:4318/v1/traces",
+    logsEndpoint: "http://localhost:4318/v1/logs",
+    serviceName: "dr-cli",
+    isExplicitlyConfigured: !1
+  };
+  let fileConfig = {};
+  const configPath = process.env.DR_CONFIG_PATH ?? join(homedir(), CONFIG_FILENAME);
+  if (existsSync(configPath))
+    try {
+      const content = await readFile(configPath, "utf-8");
+      fileConfig = parse(content);
+    } catch (error) {
+      if (error instanceof Error) {
+        const errorMsg = error.message;
+        errorMsg.includes("EACCES") || errorMsg.includes("permission denied") ? (process.stderr.write(`Error: Cannot read config file ${configPath} - permission denied
+`), process.stderr.write(`Suggestions:
+`), process.stderr.write(`  \u2022 Check file permissions with: ls -l ${configPath}
+`), process.stderr.write(`  \u2022 Ensure you have read access to the file
+`), process.stderr.write(`  \u2022 Try: chmod 644 ${configPath}
+`)) : errorMsg.includes("YAMLException") || error.name === "YAMLException" || errorMsg.includes("bad indentation") || errorMsg.includes("unexpected") ? (process.stderr.write(`Error: Invalid YAML syntax in ${configPath}
+`), process.stderr.write(`Details: ${errorMsg}
+`), process.stderr.write(`Suggestions:
+`), process.stderr.write(`  \u2022 Validate your YAML syntax at https://www.yamllint.com/
+`), process.stderr.write(`  \u2022 Check for proper indentation (use spaces, not tabs)
+`), process.stderr.write(`  \u2022 Verify colons have spaces after them
+`)) : (process.stderr.write(`Error: Failed to load config file ${configPath}
+`), process.stderr.write(`Details: ${errorMsg}
+`), process.stderr.write(`Suggestions:
+`), process.stderr.write(`  \u2022 Verify the file is valid UTF-8 encoded text
+`), process.stderr.write(`  \u2022 Check if the file system is accessible
+`), process.stderr.write(`  \u2022 Try recreating the file if it may be corrupted
+`)), process.stderr.write(`Using default OTLP configuration due to config file error
+`);
+      } else
+        process.stderr.write(`Warning: Failed to parse ${configPath}, using defaults
+`);
+    }
+  const otlp = fileConfig?.telemetry?.otlp, getEnvVar = (value) => value !== void 0 && value.trim().length > 0 ? value : void 0, getValidUrl = (url, fieldName = "URL") => {
+    if (!url)
+      return;
+    const trimmed = url.trim();
+    if (trimmed.length !== 0)
+      try {
+        const parsedUrl = new URL(trimmed);
+        if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+          const protocolMsg = parsedUrl.protocol === "" || parsedUrl.protocol === ":" ? "URL must include http:// or https:// scheme" : `Invalid protocol "${parsedUrl.protocol}" (expected http or https)`;
+          process.stderr.write(`Error: ${protocolMsg} in ${fieldName}
+`), process.stderr.write(`  Provided: ${trimmed}
+`), process.stderr.write(`  Expected: URL must start with http:// or https://
+`), process.stderr.write(`  Using fallback configuration for this field
+`);
+          return;
+        }
+        return trimmed;
+      } catch (error) {
+        process.stderr.write(`Error: Invalid URL in ${fieldName}: "${trimmed}"
+`), error instanceof Error && process.stderr.write(`  Reason: ${error.message}
+`), process.stderr.write(`Suggestions:
+`), process.stderr.write(`  \u2022 Ensure URL starts with http:// or https://
+`), process.stderr.write(`  \u2022 Check for typos in hostname
+`), process.stderr.write(`  \u2022 Verify port number if specified (e.g., :4318)
+`), process.stderr.write(`  \u2022 Example: http://localhost:4318/v1/traces
+`), process.stderr.write(`  Using fallback configuration for this field
+`);
+        return;
+      }
+  }, explicitEndpoint = getValidUrl(getEnvVar(process.env.DR_OTLP_ENDPOINT), "DR_OTLP_ENDPOINT") ?? getValidUrl(otlp?.endpoint, "telemetry.otlp.endpoint") ?? getValidUrl(getEnvVar(process.env.OTEL_EXPORTER_OTLP_ENDPOINT), "OTEL_EXPORTER_OTLP_ENDPOINT"), explicitLogsEndpoint = getValidUrl(getEnvVar(process.env.DR_OTLP_LOGS_ENDPOINT), "DR_OTLP_LOGS_ENDPOINT") ?? getValidUrl(otlp?.logs_endpoint, "telemetry.otlp.logs_endpoint") ?? getValidUrl(getEnvVar(process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT), "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT");
+  return {
+    endpoint: explicitEndpoint ?? defaults.endpoint,
+    logsEndpoint: explicitLogsEndpoint ?? defaults.logsEndpoint,
+    serviceName: getEnvVar(process.env.DR_OTLP_SERVICE_NAME) ?? otlp?.service_name ?? getEnvVar(process.env.OTEL_SERVICE_NAME) ?? defaults.serviceName,
+    // True only when at least one endpoint was explicitly provided. Without this,
+    // TELEMETRY_ENABLED=true (build-time) would try to connect to localhost:4318
+    // even when no collector is running, causing a hang at shutdown.
+    isExplicitlyConfigured: !!(explicitEndpoint || explicitLogsEndpoint)
+  };
+}
+export {
+  loadOTLPConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/telemetry/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/telemetry/config.ts"],
+  "sourcesContent": ["/**\n * OTLP Configuration Loader\n *\n * Loads and merges OTLP configuration from multiple sources with the following precedence:\n * 1. DR-specific env vars: DR_OTLP_ENDPOINT, DR_OTLP_LOGS_ENDPOINT, DR_OTLP_SERVICE_NAME (highest)\n * 2. ~/.dr-config.yaml file configuration\n * 3. Standard OTEL env vars: OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_LOGS_ENDPOINT,\n *    OTEL_SERVICE_NAME \u2014 treated as a low-priority fallback so that ambient OTEL env vars set\n *    by a parent process (e.g. Claude Code) do not silently override the DR config file.\n * 4. Hard-coded defaults (lowest priority)\n *\n * Why DR-specific env vars are highest: the standard OTEL_* vars are commonly set in developer\n * environments by other OTEL-instrumented tools (IDEs, shell profiles, CI). When dr runs as a\n * subprocess it inherits those vars and would silently misdirect spans. DR_OTLP_* vars are\n * unambiguously for dr and always win.\n *\n * Configuration file format (~/.dr-config.yaml):\n * ```yaml\n * telemetry:\n *   otlp:\n *     endpoint: 'http://localhost:4318/v1/traces'\n *     logs_endpoint: 'http://localhost:4318/v1/logs'\n *     service_name: 'dr-cli'\n * ```\n */\n\nimport { homedir } from \"node:os\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { parse } from \"yaml\";\nimport { join } from \"node:path\";\n\n/**\n * Configuration structure parsed from ~/.dr-config.yaml\n */\ninterface DRConfig {\n  telemetry?: {\n    otlp?: {\n      endpoint?: string;\n      logs_endpoint?: string;\n      service_name?: string;\n    };\n  };\n}\n\n/**\n * Resolved OTLP configuration with all required fields\n */\nexport interface OTLPConfig {\n  endpoint: string;\n  logsEndpoint: string;\n  serviceName: string;\n  /** True only when an endpoint was explicitly set via env var or config file. */\n  isExplicitlyConfigured: boolean;\n}\n\nconst CONFIG_FILENAME = \".dr-config.yaml\";\n\n/**\n * Load OTLP configuration from multiple sources.\n *\n * Configuration precedence (each field resolved independently):\n * 1. Environment variables (OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, OTEL_SERVICE_NAME)\n * 2. File configuration (~/.dr-config.yaml)\n * 3. Hard-coded defaults\n *\n * All endpoint URLs are validated. Invalid URLs are treated as not set and fall back to next priority.\n *\n * @returns Resolved OTLP configuration with all required fields\n *\n * @example\n * ```typescript\n * const config = await loadOTLPConfig();\n * console.log(config.endpoint); // 'http://localhost:4318/v1/traces' (or from env/file)\n * ```\n */\nexport async function loadOTLPConfig(): Promise<OTLPConfig> {\n  // Hard-coded defaults (Priority 3)\n  const defaults: OTLPConfig = {\n    endpoint: \"http://localhost:4318/v1/traces\",\n    logsEndpoint: \"http://localhost:4318/v1/logs\",\n    serviceName: \"dr-cli\",\n    isExplicitlyConfigured: false,\n  };\n\n  // Load file configuration (Priority 2)\n  let fileConfig: DRConfig = {};\n  // Support DR_CONFIG_PATH override for testing; default to ~/.dr-config.yaml\n  const configPath = process.env.DR_CONFIG_PATH ?? join(homedir(), CONFIG_FILENAME);\n\n  if (existsSync(configPath)) {\n    try {\n      const content = await readFile(configPath, \"utf-8\");\n      fileConfig = parse(content) as DRConfig;\n    } catch (error) {\n      // Provide specific error messages based on error type\n      if (error instanceof Error) {\n        const errorMsg = error.message;\n\n        // File permission errors\n        if (errorMsg.includes(\"EACCES\") || errorMsg.includes(\"permission denied\")) {\n          process.stderr.write(\n            `Error: Cannot read config file ${configPath} - permission denied\\n`\n          );\n          process.stderr.write(\"Suggestions:\\n\");\n          process.stderr.write(`  \u2022 Check file permissions with: ls -l ${configPath}\\n`);\n          process.stderr.write(\"  \u2022 Ensure you have read access to the file\\n\");\n          process.stderr.write(`  \u2022 Try: chmod 644 ${configPath}\\n`);\n        }\n        // YAML parse errors\n        else if (\n          errorMsg.includes(\"YAMLException\") ||\n          error.name === \"YAMLException\" ||\n          errorMsg.includes(\"bad indentation\") ||\n          errorMsg.includes(\"unexpected\")\n        ) {\n          process.stderr.write(`Error: Invalid YAML syntax in ${configPath}\\n`);\n          process.stderr.write(`Details: ${errorMsg}\\n`);\n          process.stderr.write(\"Suggestions:\\n\");\n          process.stderr.write(\"  \u2022 Validate your YAML syntax at https://www.yamllint.com/\\n\");\n          process.stderr.write(\"  \u2022 Check for proper indentation (use spaces, not tabs)\\n\");\n          process.stderr.write(\"  \u2022 Verify colons have spaces after them\\n\");\n        }\n        // File encoding or other I/O errors\n        else {\n          process.stderr.write(`Error: Failed to load config file ${configPath}\\n`);\n          process.stderr.write(`Details: ${errorMsg}\\n`);\n          process.stderr.write(\"Suggestions:\\n\");\n          process.stderr.write(\"  \u2022 Verify the file is valid UTF-8 encoded text\\n\");\n          process.stderr.write(\"  \u2022 Check if the file system is accessible\\n\");\n          process.stderr.write(\"  \u2022 Try recreating the file if it may be corrupted\\n\");\n        }\n        process.stderr.write(`Using default OTLP configuration due to config file error\\n`);\n      } else {\n        process.stderr.write(`Warning: Failed to parse ${configPath}, using defaults\\n`);\n      }\n    }\n  }\n\n  const otlp = fileConfig?.telemetry?.otlp;\n\n  // Helper to check if env var is effectively set (not empty after trim)\n  const getEnvVar = (value: string | undefined) => {\n    return value !== undefined && value.trim().length > 0 ? value : undefined;\n  };\n\n  // Helper to validate URL and return if valid, undefined if invalid\n  const getValidUrl = (url: string | undefined, fieldName: string = \"URL\") => {\n    if (!url) return undefined;\n    const trimmed = url.trim();\n    if (trimmed.length === 0) return undefined;\n\n    try {\n      const parsedUrl = new URL(trimmed);\n\n      // Only accept http and https protocols\n      if (parsedUrl.protocol !== \"http:\" && parsedUrl.protocol !== \"https:\") {\n        const protocolMsg =\n          parsedUrl.protocol === \"\" || parsedUrl.protocol === \":\"\n            ? \"URL must include http:// or https:// scheme\"\n            : `Invalid protocol \"${parsedUrl.protocol}\" (expected http or https)`;\n        process.stderr.write(`Error: ${protocolMsg} in ${fieldName}\\n`);\n        process.stderr.write(`  Provided: ${trimmed}\\n`);\n        process.stderr.write(`  Expected: URL must start with http:// or https://\\n`);\n        process.stderr.write(`  Using fallback configuration for this field\\n`);\n        return undefined;\n      }\n\n      return trimmed;\n    } catch (error) {\n      process.stderr.write(`Error: Invalid URL in ${fieldName}: \"${trimmed}\"\\n`);\n      if (error instanceof Error) {\n        process.stderr.write(`  Reason: ${error.message}\\n`);\n      }\n      process.stderr.write(\"Suggestions:\\n\");\n      process.stderr.write(\"  \u2022 Ensure URL starts with http:// or https://\\n\");\n      process.stderr.write(\"  \u2022 Check for typos in hostname\\n\");\n      process.stderr.write(\"  \u2022 Verify port number if specified (e.g., :4318)\\n\");\n      process.stderr.write(\"  \u2022 Example: http://localhost:4318/v1/traces\\n\");\n      process.stderr.write(`  Using fallback configuration for this field\\n`);\n      return undefined;\n    }\n  };\n\n  // Resolve each field using the 4-level precedence chain:\n  //   1. DR-specific env vars  (unambiguously for dr, never set by other tools)\n  //   2. ~/.dr-config.yaml     (explicit user config for dr)\n  //   3. Standard OTEL env vars (low-priority fallback; may be set by parent processes)\n  //   4. Hard-coded defaults\n  //\n  // Standard OTEL env vars are intentionally below the config file. When dr runs as a\n  // subprocess of another OTEL-instrumented tool (e.g. Claude Code), it inherits those\n  // env vars and would otherwise silently redirect spans to the wrong collector.\n  const explicitEndpoint =\n    getValidUrl(getEnvVar(process.env.DR_OTLP_ENDPOINT), \"DR_OTLP_ENDPOINT\") ??\n    getValidUrl(otlp?.endpoint, \"telemetry.otlp.endpoint\") ??\n    getValidUrl(getEnvVar(process.env.OTEL_EXPORTER_OTLP_ENDPOINT), \"OTEL_EXPORTER_OTLP_ENDPOINT\");\n\n  const explicitLogsEndpoint =\n    getValidUrl(getEnvVar(process.env.DR_OTLP_LOGS_ENDPOINT), \"DR_OTLP_LOGS_ENDPOINT\") ??\n    getValidUrl(otlp?.logs_endpoint, \"telemetry.otlp.logs_endpoint\") ??\n    getValidUrl(getEnvVar(process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT), \"OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\");\n\n  return {\n    endpoint: explicitEndpoint ?? defaults.endpoint,\n    logsEndpoint: explicitLogsEndpoint ?? defaults.logsEndpoint,\n    serviceName:\n      getEnvVar(process.env.DR_OTLP_SERVICE_NAME) ??\n      otlp?.service_name ??\n      getEnvVar(process.env.OTEL_SERVICE_NAME) ??\n      defaults.serviceName,\n    // True only when at least one endpoint was explicitly provided. Without this,\n    // TELEMETRY_ENABLED=true (build-time) would try to connect to localhost:4318\n    // even when no collector is running, causing a hang at shutdown.\n    isExplicitlyConfigured: !!(explicitEndpoint || explicitLogsEndpoint),\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/telemetry/console-interceptor.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/telemetry/console-interceptor.ts"],
-  "sourcesContent": ["/**\n * Console method interceptor for OpenTelemetry log emission.\n *\n * Wraps console.log, console.error, console.warn, and console.debug to emit\n * OpenTelemetry log records while preserving original console behavior.\n *\n * Log records inherit trace context from active spans and include stack traces\n * for errors. This module is only active when TELEMETRY_ENABLED is true.\n *\n * Pattern: All telemetry function calls must be directly guarded by\n * `if (TELEMETRY_ENABLED)` checks in calling code to enable tree-shaking\n * and zero-cost abstractions in production builds.\n */\n\n// Fallback for runtime environments where TELEMETRY_ENABLED is not defined by esbuild\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\n// Store original console methods before any wrapping\nconst originalConsole = {\n  log: console.log,\n  error: console.error,\n  warn: console.warn,\n  debug: console.debug,\n};\n\n/**\n * Format console arguments into a single string.\n * Converts objects to JSON representation for readability in logs.\n */\nfunction formatArgs(args: any[]): string {\n  return args\n    .map((arg) => {\n      if (typeof arg === 'object' && arg !== null) {\n        try {\n          return JSON.stringify(arg);\n        } catch {\n          return String(arg);\n        }\n      }\n      return String(arg);\n    })\n    .join(' ');\n}\n\n/**\n * Extract error stack trace and message from console arguments.\n * Returns attributes suitable for log record enrichment.\n */\nfunction extractStackTrace(args: any[]): Record<string, string> {\n  const errorArg = args.find((arg) => arg instanceof Error);\n  if (errorArg) {\n    return {\n      'error.message': errorArg.message,\n      'error.stack': errorArg.stack || '',\n    };\n  }\n  return {};\n}\n\n/**\n * Install console interceptor to emit OpenTelemetry log records.\n *\n * Maps console methods to OpenTelemetry severity levels:\n * - console.debug() \u2192 DEBUG\n * - console.log() \u2192 INFO\n * - console.warn() \u2192 WARN\n * - console.error() \u2192 ERROR\n *\n * Each log record includes the active trace and span identifiers\n * from the current OpenTelemetry context (if available).\n *\n * Original console behavior is preserved - all console output still appears.\n *\n * No-op when TELEMETRY_ENABLED is false.\n */\nexport async function installConsoleInterceptor(): Promise<void> {\n  if (!isTelemetryEnabled) return;\n\n  const [{ SeverityNumber }, { emitLog }] = await Promise.all([\n    import('@opentelemetry/api-logs'),\n    import('./index.js')\n  ]);\n\n  console.log = (...args: any[]): void => {\n    emitLog(SeverityNumber.INFO, formatArgs(args));\n    originalConsole.log.apply(console, args);\n  };\n\n  console.error = (...args: any[]): void => {\n    const attrs = extractStackTrace(args);\n    emitLog(SeverityNumber.ERROR, formatArgs(args), attrs);\n    originalConsole.error.apply(console, args);\n  };\n\n  console.warn = (...args: any[]): void => {\n    emitLog(SeverityNumber.WARN, formatArgs(args));\n    originalConsole.warn.apply(console, args);\n  };\n\n  console.debug = (...args: any[]): void => {\n    emitLog(SeverityNumber.DEBUG, formatArgs(args));\n    originalConsole.debug.apply(console, args);\n  };\n}\n\n/**\n * Uninstall console interceptor and restore original console methods.\n *\n * Useful for testing to prevent state pollution between tests.\n * Safe to call when telemetry is disabled (no-op).\n */\nexport function uninstallConsoleInterceptor(): void {\n  console.log = originalConsole.log;\n  console.error = originalConsole.error;\n  console.warn = originalConsole.warn;\n  console.debug = originalConsole.debug;\n}\n"],
+  "sourcesContent": ["/**\n * Console method interceptor for OpenTelemetry log emission.\n *\n * Wraps console.log, console.error, console.warn, and console.debug to emit\n * OpenTelemetry log records while preserving original console behavior.\n *\n * Log records inherit trace context from active spans and include stack traces\n * for errors. This module is only active when TELEMETRY_ENABLED is true.\n *\n * Pattern: All telemetry function calls must be directly guarded by\n * `if (TELEMETRY_ENABLED)` checks in calling code to enable tree-shaking\n * and zero-cost abstractions in production builds.\n */\n\n// Fallback for runtime environments where TELEMETRY_ENABLED is not defined by esbuild\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\n// Store original console methods before any wrapping\nconst originalConsole = {\n  log: console.log,\n  error: console.error,\n  warn: console.warn,\n  debug: console.debug,\n};\n\n/**\n * Format console arguments into a single string.\n * Converts objects to JSON representation for readability in logs.\n */\nfunction formatArgs(args: any[]): string {\n  return args\n    .map((arg) => {\n      if (typeof arg === \"object\" && arg !== null) {\n        try {\n          return JSON.stringify(arg);\n        } catch {\n          return String(arg);\n        }\n      }\n      return String(arg);\n    })\n    .join(\" \");\n}\n\n/**\n * Extract error stack trace and message from console arguments.\n * Returns attributes suitable for log record enrichment.\n */\nfunction extractStackTrace(args: any[]): Record<string, string> {\n  const errorArg = args.find((arg) => arg instanceof Error);\n  if (errorArg) {\n    return {\n      \"error.message\": errorArg.message,\n      \"error.stack\": errorArg.stack || \"\",\n    };\n  }\n  return {};\n}\n\n/**\n * Install console interceptor to emit OpenTelemetry log records.\n *\n * Maps console methods to OpenTelemetry severity levels:\n * - console.debug() \u2192 DEBUG\n * - console.log() \u2192 INFO\n * - console.warn() \u2192 WARN\n * - console.error() \u2192 ERROR\n *\n * Each log record includes the active trace and span identifiers\n * from the current OpenTelemetry context (if available).\n *\n * Original console behavior is preserved - all console output still appears.\n *\n * No-op when TELEMETRY_ENABLED is false.\n */\nexport async function installConsoleInterceptor(): Promise<void> {\n  if (!isTelemetryEnabled) return;\n\n  const [{ SeverityNumber }, { emitLog }] = await Promise.all([\n    import(\"@opentelemetry/api-logs\"),\n    import(\"./index.js\"),\n  ]);\n\n  console.log = (...args: any[]): void => {\n    emitLog(SeverityNumber.INFO, formatArgs(args));\n    originalConsole.log.apply(console, args);\n  };\n\n  console.error = (...args: any[]): void => {\n    const attrs = extractStackTrace(args);\n    emitLog(SeverityNumber.ERROR, formatArgs(args), attrs);\n    originalConsole.error.apply(console, args);\n  };\n\n  console.warn = (...args: any[]): void => {\n    emitLog(SeverityNumber.WARN, formatArgs(args));\n    originalConsole.warn.apply(console, args);\n  };\n\n  console.debug = (...args: any[]): void => {\n    emitLog(SeverityNumber.DEBUG, formatArgs(args));\n    originalConsole.debug.apply(console, args);\n  };\n}\n\n/**\n * Uninstall console interceptor and restore original console methods.\n *\n * Useful for testing to prevent state pollution between tests.\n * Safe to call when telemetry is disabled (no-op).\n */\nexport function uninstallConsoleInterceptor(): void {\n  console.log = originalConsole.log;\n  console.error = originalConsole.error;\n  console.warn = originalConsole.warn;\n  console.debug = originalConsole.debug;\n}\n"],
   "mappings": "AAgBA,MAAM,qBAAgE,IAGhE,kBAAkB;EACtB,KAAK,QAAQ;EACb,OAAO,QAAQ;EACf,MAAM,QAAQ;EACd,OAAO,QAAQ;;AAOjB,SAAS,WAAW,MAAW;AAC7B,SAAO,KACJ,IAAI,CAAC,QAAO;AACX,QAAI,OAAO,OAAQ,YAAY,QAAQ;AACrC,UAAI;AACF,eAAO,KAAK,UAAU,GAAG;MAC3B,QAAQ;AACN,eAAO,OAAO,GAAG;MACnB;AAEF,WAAO,OAAO,GAAG;EACnB,CAAC,EACA,KAAK,GAAG;AACb;AAMA,SAAS,kBAAkB,MAAW;AACpC,QAAM,WAAW,KAAK,KAAK,CAAC,QAAQ,eAAe,KAAK;AACxD,SAAI,WACK;IACL,iBAAiB,SAAS;IAC1B,eAAe,SAAS,SAAS;MAG9B,CAAA;AACT;AAkBA,eAAsB,4BAAyB;AA4B/C;AAQM,SAAU,8BAA2B;AACzC,UAAQ,MAAM,gBAAgB,KAC9B,QAAQ,QAAQ,gBAAgB,OAChC,QAAQ,OAAO,gBAAgB,MAC/B,QAAQ,QAAQ,gBAAgB;AAClC;",
   "names": []
 }

package/dist/telemetry/detect.js

@@ -0,0 +1,24 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { parse } from "yaml";
+import { join } from "node:path";
+import { homedir } from "node:os";
+function isTelemetryBuiltIn() {
+  return !1;
+}
+async function isTelemetryConfigured() {
+  const configPath = process.env.DR_CONFIG_PATH ?? join(homedir(), ".dr-config.yaml");
+  if (!existsSync(configPath))
+    return !1;
+  try {
+    const content = await readFile(configPath, "utf-8");
+    return !!parse(content)?.telemetry?.otlp?.endpoint;
+  } catch {
+    return !1;
+  }
+}
+export {
+  isTelemetryBuiltIn,
+  isTelemetryConfigured
+};
+//# sourceMappingURL=detect.js.map

package/dist/telemetry/detect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/telemetry/detect.ts"],
+  "sourcesContent": ["/**\n * Telemetry Detection\n *\n * Determines if the CLI was built with telemetry (OTLP sender) enabled\n * and if telemetry is configured via ~/.dr-config.yaml.\n * This is a build-time constant that gets dead-code eliminated in production builds.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { parse } from \"yaml\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\n// Declare TELEMETRY_ENABLED as a build-time constant (substituted by esbuild)\ndeclare const TELEMETRY_ENABLED: boolean;\n\n/**\n * Check if the CLI was built with telemetry enabled\n * @returns true if telemetry is enabled, false otherwise\n */\nexport function isTelemetryBuiltIn(): boolean {\n  return typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n}\n\n/**\n * Check if telemetry is configured via ~/.dr-config.yaml\n * @returns true if config file exists with telemetry.otlp section, false otherwise\n */\nexport async function isTelemetryConfigured(): Promise<boolean> {\n  const configPath = process.env.DR_CONFIG_PATH ?? join(homedir(), \".dr-config.yaml\");\n\n  if (!existsSync(configPath)) {\n    return false;\n  }\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const config = parse(content) as any;\n\n    // Check if config has telemetry.otlp.endpoint (minimum required)\n    return !!(config?.telemetry?.otlp?.endpoint);\n  } catch {\n    return false;\n  }\n}\n"],
+  "mappings": "AAQA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,aAAa;AACtB,SAAS,YAAY;AACrB,SAAS,eAAe;AASlB,SAAU,qBAAkB;AAChC,SAAkD;AACpD;AAMA,eAAsB,wBAAqB;AACzC,QAAM,aAAa,QAAQ,IAAI,kBAAkB,KAAK,QAAO,GAAI,iBAAiB;AAElF,MAAI,CAAC,WAAW,UAAU;AACxB,WAAO;AAGT,MAAI;AACF,UAAM,UAAU,MAAM,SAAS,YAAY,OAAO;AAIlD,WAAO,CAAC,CAHO,MAAM,OAAO,GAGV,WAAW,MAAM;EACrC,QAAQ;AACN,WAAO;EACT;AACF;",
+  "names": []
+}

package/dist/telemetry/fetch-otlp-exporter.js

@@ -0,0 +1,112 @@
+import { ExportResultCode } from "@opentelemetry/core";
+import { getErrorMessage } from "../utils/errors.js";
+class FetchOTLPExporter {
+  url;
+  debug;
+  timeoutMs;
+  constructor(config) {
+    this.url = config?.url || "http://localhost:4318/v1/traces", this.timeoutMs = config?.timeoutMillis ?? 1e4, this.debug = process.env.DR_TELEMETRY_DEBUG === "1" || process.env.DEBUG === "1" || process.env.VERBOSE === "1", this.debug && process.stderr.write(`[TELEMETRY] Fetch-based trace exporter initialized: ${this.url}
+`);
+  }
+  export(spans, resultCallback) {
+    this.debug && process.stderr.write(`[TELEMETRY] Exporting ${spans.length} span(s) to ${this.url}
+`);
+    const payload = this.convertSpansToOTLP(spans), controller = new AbortController(), timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+    fetch(this.url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(payload),
+      signal: controller.signal
+    }).then(async (response) => {
+      if (clearTimeout(timeoutId), response.ok)
+        this.debug && process.stderr.write(`[TELEMETRY] Export SUCCESS - ${spans.length} span(s) sent
+`), resultCallback({ code: ExportResultCode.SUCCESS });
+      else {
+        const errorText = await response.text();
+        this.debug && process.stderr.write(`[TELEMETRY] Export FAILED - HTTP ${response.status}: ${errorText}
+`), resultCallback({
+          code: ExportResultCode.FAILED,
+          error: new Error(`HTTP ${response.status}: ${errorText}`)
+        });
+      }
+    }).catch((error) => {
+      if (clearTimeout(timeoutId), this.debug) {
+        const errorMsg = getErrorMessage(error);
+        process.stderr.write(`[TELEMETRY] Export FAILED - ${errorMsg}
+`);
+      }
+      resultCallback({
+        code: ExportResultCode.FAILED,
+        error: error instanceof Error ? error : new Error(String(error))
+      });
+    });
+  }
+  async forceFlush() {
+  }
+  async shutdown() {
+  }
+  /**
+   * Convert OpenTelemetry spans to OTLP JSON format.
+   * Simplified version that covers the essential fields.
+   */
+  convertSpansToOTLP(spans) {
+    return {
+      resourceSpans: [
+        {
+          resource: {
+            attributes: this.convertAttributes(spans[0]?.resource?.attributes || {})
+          },
+          scopeSpans: [
+            {
+              scope: {
+                name: spans[0]?.instrumentationLibrary?.name || "unknown",
+                version: spans[0]?.instrumentationLibrary?.version || ""
+              },
+              spans: spans.map((span) => ({
+                traceId: span.spanContext().traceId,
+                spanId: span.spanContext().spanId,
+                parentSpanId: span.parentSpanId || void 0,
+                name: span.name,
+                kind: span.kind,
+                startTimeUnixNano: String(span.startTime[0] * 1e9 + span.startTime[1]),
+                endTimeUnixNano: String(span.endTime[0] * 1e9 + span.endTime[1]),
+                attributes: this.convertAttributes(span.attributes),
+                status: span.status,
+                events: span.events.map((event) => ({
+                  timeUnixNano: String(event.time[0] * 1e9 + event.time[1]),
+                  name: event.name,
+                  attributes: this.convertAttributes(event.attributes || {})
+                }))
+              }))
+            }
+          ]
+        }
+      ]
+    };
+  }
+  /**
+   * Convert attributes to OTLP format.
+   */
+  convertAttributes(attrs) {
+    return attrs ? Object.entries(attrs).map(([key, value]) => ({
+      key,
+      value: this.convertValue(value)
+    })) : [];
+  }
+  /**
+   * Convert attribute value to OTLP format.
+   */
+  convertValue(value) {
+    return typeof value == "string" ? { stringValue: value } : typeof value == "number" ? Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value } : typeof value == "boolean" ? { boolValue: value } : Array.isArray(value) ? {
+      arrayValue: {
+        values: value.map((v) => this.convertValue(v))
+      }
+    } : { stringValue: String(value) };
+  }
+}
+export {
+  FetchOTLPExporter
+};
+//# sourceMappingURL=fetch-otlp-exporter.js.map

package/dist/telemetry/fetch-otlp-exporter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/telemetry/fetch-otlp-exporter.ts"],
+  "sourcesContent": ["/**\n * Fetch-based OTLP exporter for Bun compatibility.\n * Uses native fetch API instead of Node.js http module.\n */\n\nimport type { SpanExporter, ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\nimport type { ExportResult } from \"@opentelemetry/core\";\nimport { ExportResultCode } from \"@opentelemetry/core\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * OTLP exporter using fetch API for Bun compatibility.\n * Bun's http module has compatibility issues with the standard OTLP exporter,\n * so we use fetch which is natively supported by Bun.\n */\nexport class FetchOTLPExporter implements SpanExporter {\n  private readonly url: string;\n  private readonly debug: boolean;\n  private readonly timeoutMs: number;\n\n  constructor(config?: { url?: string; timeoutMillis?: number }) {\n    this.url = config?.url || \"http://localhost:4318/v1/traces\";\n    this.timeoutMs = config?.timeoutMillis ?? 10000;\n    this.debug =\n      process.env.DR_TELEMETRY_DEBUG === \"1\" ||\n      process.env.DEBUG === \"1\" ||\n      process.env.VERBOSE === \"1\";\n\n    if (this.debug) {\n      process.stderr.write(`[TELEMETRY] Fetch-based trace exporter initialized: ${this.url}\\n`);\n    }\n  }\n\n  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {\n    if (this.debug) {\n      process.stderr.write(`[TELEMETRY] Exporting ${spans.length} span(s) to ${this.url}\\n`);\n    }\n\n    // Convert spans to OTLP JSON format\n    const payload = this.convertSpansToOTLP(spans);\n\n    // Use AbortController for timeout\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    fetch(this.url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(payload),\n      signal: controller.signal,\n    })\n      .then(async (response) => {\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (this.debug) {\n            process.stderr.write(`[TELEMETRY] Export SUCCESS - ${spans.length} span(s) sent\\n`);\n          }\n          resultCallback({ code: ExportResultCode.SUCCESS });\n        } else {\n          const errorText = await response.text();\n          if (this.debug) {\n            process.stderr.write(\n              `[TELEMETRY] Export FAILED - HTTP ${response.status}: ${errorText}\\n`\n            );\n          }\n          resultCallback({\n            code: ExportResultCode.FAILED,\n            error: new Error(`HTTP ${response.status}: ${errorText}`),\n          });\n        }\n      })\n      .catch((error) => {\n        clearTimeout(timeoutId);\n        if (this.debug) {\n          const errorMsg = getErrorMessage(error);\n          process.stderr.write(`[TELEMETRY] Export FAILED - ${errorMsg}\\n`);\n        }\n        resultCallback({\n          code: ExportResultCode.FAILED,\n          error: error instanceof Error ? error : new Error(String(error)),\n        });\n      });\n  }\n\n  async forceFlush(): Promise<void> {\n    // No-op for fetch-based exporter (no buffering)\n  }\n\n  async shutdown(): Promise<void> {\n    // No-op for fetch-based exporter (no persistent connections)\n  }\n\n  /**\n   * Convert OpenTelemetry spans to OTLP JSON format.\n   * Simplified version that covers the essential fields.\n   */\n  private convertSpansToOTLP(spans: ReadableSpan[]): any {\n    return {\n      resourceSpans: [\n        {\n          resource: {\n            attributes: this.convertAttributes(spans[0]?.resource?.attributes || {}),\n          },\n          scopeSpans: [\n            {\n              scope: {\n                name: spans[0]?.instrumentationLibrary?.name || \"unknown\",\n                version: spans[0]?.instrumentationLibrary?.version || \"\",\n              },\n              spans: spans.map((span) => ({\n                traceId: span.spanContext().traceId,\n                spanId: span.spanContext().spanId,\n                parentSpanId: span.parentSpanId || undefined,\n                name: span.name,\n                kind: span.kind,\n                startTimeUnixNano: String(span.startTime[0] * 1e9 + span.startTime[1]),\n                endTimeUnixNano: String(span.endTime[0] * 1e9 + span.endTime[1]),\n                attributes: this.convertAttributes(span.attributes),\n                status: span.status,\n                events: span.events.map((event) => ({\n                  timeUnixNano: String(event.time[0] * 1e9 + event.time[1]),\n                  name: event.name,\n                  attributes: this.convertAttributes(event.attributes || {}),\n                })),\n              })),\n            },\n          ],\n        },\n      ],\n    };\n  }\n\n  /**\n   * Convert attributes to OTLP format.\n   */\n  private convertAttributes(attrs: any): any[] {\n    if (!attrs) return [];\n    return Object.entries(attrs).map(([key, value]) => ({\n      key,\n      value: this.convertValue(value),\n    }));\n  }\n\n  /**\n   * Convert attribute value to OTLP format.\n   */\n  private convertValue(value: any): any {\n    if (typeof value === \"string\") {\n      return { stringValue: value };\n    } else if (typeof value === \"number\") {\n      if (Number.isInteger(value)) {\n        return { intValue: String(value) };\n      } else {\n        return { doubleValue: value };\n      }\n    } else if (typeof value === \"boolean\") {\n      return { boolValue: value };\n    } else if (Array.isArray(value)) {\n      return {\n        arrayValue: {\n          values: value.map((v) => this.convertValue(v)),\n        },\n      };\n    } else {\n      return { stringValue: String(value) };\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/telemetry/index.js

@@ -1,12 +1,88 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
 const isTelemetryEnabled = !1;
-let sdk = null, tracer = null, loggerProvider = null, logger = null, cachedContext = null, cachedTrace = null;
+let sdk = null, tracer = null, loggerProvider = null, logger = null, spanProcessor = null, cachedContext = null, cachedTrace = null;
 async function initTelemetry() {
+  if (isTelemetryEnabled) {
+    const { loadOTLPConfig } = await import("./config.js"), otlpConfig = await loadOTLPConfig();
+    if (!otlpConfig.isExplicitlyConfigured)
+      return;
+    const [{ NodeSDK }, { BatchSpanProcessor }, { SimpleLogRecordProcessor }, otelApi, { Resource }, { LoggerProvider }, { ResilientOTLPExporter }, { ResilientLogExporter }] = await Promise.all([
+      import("@opentelemetry/sdk-node"),
+      import("@opentelemetry/sdk-trace-base"),
+      import("@opentelemetry/sdk-logs"),
+      import("@opentelemetry/api"),
+      import("@opentelemetry/resources"),
+      import("@opentelemetry/sdk-logs"),
+      import("./resilient-exporter.js"),
+      import("./resilient-log-exporter.js")
+    ]), { trace, context } = otelApi;
+    cachedTrace = trace, cachedContext = context, process.env.DR_TELEMETRY_DEBUG && (process.stderr.write(`[TELEMETRY] Configuration loaded:
+`), process.stderr.write(`  - Traces endpoint: ${otlpConfig.endpoint}
+`), process.stderr.write(`  - Logs endpoint: ${otlpConfig.logsEndpoint}
+`), process.stderr.write(`  - Service name: ${otlpConfig.serviceName}
+`));
+    const cliVersion = "0.1.5";
+    let projectName = "unknown";
+    try {
+      const [{ readFileSync, existsSync }, { parse }] = await Promise.all([
+        import("fs"),
+        import("yaml")
+      ]), possiblePaths = [
+        `${process.cwd()}/documentation-robotics/model/manifest.yaml`,
+        `${process.cwd()}/model/manifest.yaml`
+      ];
+      for (const manifestPath of possiblePaths)
+        try {
+          if (existsSync(manifestPath)) {
+            const content = readFileSync(manifestPath, "utf-8");
+            projectName = parse(content).project?.name || "unknown";
+            break;
+          }
+        } catch {
+        }
+    } catch {
+    }
+    const resource = new Resource({
+      "service.name": otlpConfig.serviceName,
+      "service.version": cliVersion,
+      "dr.project.name": projectName
+    }), traceExporter = new ResilientOTLPExporter({
+      url: otlpConfig.endpoint,
+      timeoutMillis: 1e4
+      // 10s timeout for network requests (serialization + network latency)
+    });
+    spanProcessor = new BatchSpanProcessor(traceExporter, {
+      maxExportBatchSize: 32,
+      maxQueueSize: 64,
+      scheduledDelayMillis: 100,
+      // Short delay for CLI
+      exportTimeoutMillis: 5e3
+    });
+    const nodeSdk = new NodeSDK({
+      resource,
+      spanProcessor
+    });
+    nodeSdk.start(), sdk = nodeSdk, tracer = trace.getTracer("dr-cli", cliVersion), (process.env.DR_TELEMETRY_DEBUG || process.env.DEBUG || process.env.VERBOSE) && (process.stderr.write(`[TELEMETRY] SDK initialized successfully
+`), process.stderr.write(`[TELEMETRY] Tracer initialized: ${tracer !== null}
+`));
+    const logExporter = new ResilientLogExporter({
+      url: otlpConfig.logsEndpoint,
+      timeoutMillis: 1e4
+      // 10s timeout for network requests (serialization + network latency)
+    });
+    loggerProvider = new LoggerProvider({
+      resource
+    }), loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(logExporter)), logger = loggerProvider.getLogger("dr-cli", cliVersion);
+  }
 }
 function startSpan(name, attributes) {
-  return null;
+  return isTelemetryEnabled && tracer && cachedContext ? tracer.startSpan(name, { attributes }, cachedContext.active()) : ((process.env.DR_TELEMETRY_DEBUG || process.env.DEBUG || process.env.VERBOSE) && (isTelemetryEnabled ? tracer ? cachedContext || process.stderr.write(`[TELEMETRY] startSpan('${name}'): skipped - cachedContext is null
+`) : process.stderr.write(`[TELEMETRY] startSpan('${name}'): skipped - tracer is null (initTelemetry not called?)
+`) : process.stderr.write(`[TELEMETRY] startSpan('${name}'): skipped - isTelemetryEnabled=false
+`)), null);
 }
 async function startActiveSpan(name, fn, attributes) {
-  {
+  if (!isTelemetryEnabled || !tracer) {
     const noopSpan = {
       end: () => {
       },
@@ -38,15 +114,89 @@ async function startActiveSpan(name, fn, attributes) {
   });
 }
 function endSpan(span) {
+  isTelemetryEnabled && span && span.end();
+}
+function getActiveSpan() {
+  return isTelemetryEnabled && cachedTrace ? cachedTrace.getActiveSpan?.() ?? null : null;
 }
 function emitLog(severity, message, attributes) {
+  if (!isTelemetryEnabled || !logger || !cachedTrace)
+    return;
+  const context = cachedTrace.getActiveSpan()?.spanContext(), severityText = {
+    0: "UNSPECIFIED",
+    1: "TRACE",
+    2: "TRACE2",
+    3: "TRACE3",
+    4: "TRACE4",
+    5: "DEBUG",
+    6: "DEBUG2",
+    7: "DEBUG3",
+    8: "DEBUG4",
+    9: "INFO",
+    10: "INFO2",
+    11: "INFO3",
+    12: "INFO4",
+    13: "WARN",
+    14: "WARN2",
+    15: "WARN3",
+    16: "WARN4",
+    17: "ERROR",
+    18: "ERROR2",
+    19: "ERROR3",
+    20: "ERROR4",
+    21: "FATAL",
+    22: "FATAL2",
+    23: "FATAL3",
+    24: "FATAL4"
+  }[severity] || "UNSPECIFIED";
+  logger.emit({
+    severityNumber: severity,
+    severityText,
+    body: message,
+    attributes: {
+      ...attributes,
+      ...context && {
+        "trace.id": context.traceId,
+        "span.id": context.spanId
+      }
+    }
+  });
+}
+async function flushTelemetry() {
+  if (isTelemetryEnabled && spanProcessor)
+    try {
+      await spanProcessor.forceFlush();
+    } catch {
+    }
+}
+function setSpanAttribute(span, key, value) {
+  if (span && typeof span.setAttribute == "function")
+    try {
+      span.setAttribute(key, value);
+    } catch {
+    }
 }
 async function shutdownTelemetry() {
+  if (isTelemetryEnabled) {
+    try {
+      spanProcessor && await spanProcessor.forceFlush(), await sdk?.shutdown();
+    } catch {
+    }
+    try {
+      await loggerProvider?.shutdown();
+    } catch {
+    }
+  }
 }
 export {
+  SeverityNumber,
   emitLog,
   endSpan,
+  flushTelemetry,
+  getActiveSpan,
   initTelemetry,
+  isTelemetryEnabled,
+  setSpanAttribute,
   shutdownTelemetry,
   startActiveSpan,
   startSpan