deepline 0.1.0 → 0.1.2

package/dist/cli/index.js

@@ -192,7 +192,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.1.2";
 var SDK_API_CONTRACT = "2026-04-plays-v1";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts
@@ -2488,7 +2488,7 @@ function registerOrgCommands(program) {
 
 // src/cli/commands/play.ts
 var import_node_crypto3 = require("crypto");
-var import_node_fs5 = require("fs");
+var import_node_fs6 = require("fs");
 var import_node_path8 = require("path");
 var import_commander = require("commander");
 
@@ -2496,6 +2496,7 @@ var import_commander = require("commander");
 var import_node_os5 = require("os");
 var import_node_path7 = require("path");
 var import_node_url = require("url");
+var import_node_fs5 = require("fs");
 
 // ../shared_libs/plays/bundling/index.ts
 var import_node_crypto = require("crypto");
@@ -2601,7 +2602,7 @@ function typecheckPlaySource(input, adapter) {
       ...input.importedPlayDependencies.map((dependency) => dependency.filePath)
     ])
   );
-  const sdkTypesPath = adapter.sdkEntryFile;
+  const sdkTypesPath = adapter.sdkTypesEntryFile ?? adapter.sdkEntryFile;
   const program = import_typescript.default.createProgram(rootNames, {
     target: import_typescript.default.ScriptTarget.ES2023,
     // SDK source uses fetch/RequestInit/URL and node-aware config helpers.
@@ -3700,24 +3701,24 @@ async function discoverPackagedLocalFiles(entryFile) {
 // src/plays/bundle-play-file.ts
 var import_meta2 = {};
 var PLAY_BUNDLE_CACHE_VERSION2 = 24;
-var SDK_SOURCE_ROOT = (0, import_node_path7.resolve)((0, import_node_path7.dirname)((0, import_node_url.fileURLToPath)(import_meta2.url)), "..");
-var PROJECT_ROOT = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "..", "..");
-var SDK_PACKAGE_JSON = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "..", "package.json");
-var SDK_ENTRY_FILE = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "index.ts");
-var SDK_WORKERS_ENTRY_FILE = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "worker-play-entry.ts");
-var WORKERS_HARNESS_ENTRY_FILE = (0, import_node_path7.resolve)(
-  PROJECT_ROOT,
-  "apps",
-  "play-runner-workers",
-  "src",
-  "entry.ts"
+var MODULE_DIR = (0, import_node_path7.dirname)((0, import_node_url.fileURLToPath)(import_meta2.url));
+var SDK_PACKAGE_ROOT = (0, import_node_path7.resolve)(MODULE_DIR, "..", "..");
+var SOURCE_REPO_ROOT = (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "..");
+var HAS_SOURCE_BUNDLING_SOURCES = (0, import_node_fs5.existsSync)(
+  (0, import_node_path7.resolve)(SOURCE_REPO_ROOT, "apps", "play-runner-workers", "src", "entry.ts")
 );
-var WORKERS_HARNESS_FILES_DIR = (0, import_node_path7.resolve)(
-  PROJECT_ROOT,
-  "apps",
-  "play-runner-workers",
-  "src"
+var PACKAGED_REPO_ROOT = (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "dist", "repo");
+var HAS_PACKAGED_BUNDLING_SOURCES = (0, import_node_fs5.existsSync)(
+  (0, import_node_path7.resolve)(PACKAGED_REPO_ROOT, "apps", "play-runner-workers", "src", "entry.ts")
 );
+var PROJECT_ROOT = HAS_SOURCE_BUNDLING_SOURCES ? SOURCE_REPO_ROOT : HAS_PACKAGED_BUNDLING_SOURCES ? PACKAGED_REPO_ROOT : (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "..");
+var SDK_SOURCE_ROOT = HAS_SOURCE_BUNDLING_SOURCES ? (0, import_node_path7.resolve)(SOURCE_REPO_ROOT, "sdk", "src") : HAS_PACKAGED_BUNDLING_SOURCES ? (0, import_node_path7.resolve)(PACKAGED_REPO_ROOT, "sdk", "src") : (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "src");
+var SDK_PACKAGE_JSON = (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "package.json");
+var SDK_ENTRY_FILE = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "index.ts");
+var SDK_TYPES_ENTRY_FILE = (0, import_node_path7.resolve)(SDK_PACKAGE_ROOT, "dist", "index.d.ts");
+var SDK_WORKERS_ENTRY_FILE = (0, import_node_path7.resolve)(SDK_SOURCE_ROOT, "worker-play-entry.ts");
+var WORKERS_HARNESS_ENTRY_FILE = (0, import_node_path7.resolve)(PROJECT_ROOT, "apps", "play-runner-workers", "src", "entry.ts");
+var WORKERS_HARNESS_FILES_DIR = (0, import_node_path7.resolve)(PROJECT_ROOT, "apps", "play-runner-workers", "src");
 var hasWarnedAboutNonDevelopmentBundling = false;
 function warnAboutNonDevelopmentBundling(filePath) {
   if (hasWarnedAboutNonDevelopmentBundling) {
@@ -3746,6 +3747,7 @@ function createSdkPlayBundlingAdapter() {
     sdkSourceRoot: SDK_SOURCE_ROOT,
     sdkPackageJson: SDK_PACKAGE_JSON,
     sdkEntryFile: SDK_ENTRY_FILE,
+    sdkTypesEntryFile: (0, import_node_fs5.existsSync)(SDK_TYPES_ENTRY_FILE) ? SDK_TYPES_ENTRY_FILE : SDK_ENTRY_FILE,
     sdkWorkersEntryFile: SDK_WORKERS_ENTRY_FILE,
     workersHarnessEntryFile: WORKERS_HARNESS_ENTRY_FILE,
     workersHarnessFilesDir: WORKERS_HARNESS_FILES_DIR,
@@ -3890,6 +3892,54 @@ function createCliProgress(enabled) {
   return progress;
 }
 
+// src/cli/trace.ts
+var cliTraceStartedAt = Date.now();
+function isTruthyEnv(value) {
+  return value === "1" || value === "true" || value === "yes";
+}
+function isCliTraceEnabled() {
+  return isTruthyEnv(process.env.DEEPLINE_CLI_TRACE);
+}
+function recordCliTrace(event) {
+  if (!isCliTraceEnabled()) {
+    return;
+  }
+  const now = Date.now();
+  const payload = {
+    ts: now,
+    source: "cli",
+    sinceStartMs: now - cliTraceStartedAt,
+    ...event
+  };
+  process.stderr.write(`[cli-trace] ${JSON.stringify(payload)}
+`);
+}
+async function traceCliSpan(phase, fields, run) {
+  if (!isCliTraceEnabled()) {
+    return run();
+  }
+  const startedAt = Date.now();
+  try {
+    const result = await run();
+    recordCliTrace({
+      phase,
+      ms: Date.now() - startedAt,
+      ok: true,
+      ...fields
+    });
+    return result;
+  } catch (error) {
+    recordCliTrace({
+      phase,
+      ms: Date.now() - startedAt,
+      ok: false,
+      error: error instanceof Error ? error.message : String(error),
+      ...fields
+    });
+    throw error;
+  }
+}
+
 // src/cli/commands/play.ts
 function parseReferencedPlayTarget(target) {
   const trimmed = target.trim();
@@ -3945,15 +3995,15 @@ function materializeRemotePlaySource(input) {
     return null;
   }
   const outputPath = input.outPath ?? defaultMaterializedPlayPath(input.playName);
-  if ((0, import_node_fs5.existsSync)(outputPath)) {
-    const existingSource = (0, import_node_fs5.readFileSync)(outputPath, "utf-8");
+  if ((0, import_node_fs6.existsSync)(outputPath)) {
+    const existingSource = (0, import_node_fs6.readFileSync)(outputPath, "utf-8");
     if (existingSource === input.sourceCode) {
       return { path: outputPath, status: "unchanged", created: false };
     }
-    (0, import_node_fs5.writeFileSync)(outputPath, input.sourceCode, "utf-8");
+    (0, import_node_fs6.writeFileSync)(outputPath, input.sourceCode, "utf-8");
     return { path: outputPath, status: "updated", created: false };
   }
-  (0, import_node_fs5.writeFileSync)(outputPath, input.sourceCode, "utf-8");
+  (0, import_node_fs6.writeFileSync)(outputPath, input.sourceCode, "utf-8");
   return { path: outputPath, status: "created", created: true };
 }
 function formatLoadedPlayMessage(materializedFile) {
@@ -3996,7 +4046,7 @@ function extractPlayName(code, filePath) {
   throw buildMissingDefinePlayError(filePath);
 }
 function isFileTarget(target) {
-  return (0, import_node_fs5.existsSync)((0, import_node_path8.resolve)(target));
+  return (0, import_node_fs6.existsSync)((0, import_node_path8.resolve)(target));
 }
 function looksLikeFilePath(target) {
   if (target.trim().toLowerCase().startsWith("prebuilt/")) {
@@ -4012,7 +4062,7 @@ function parsePositiveInteger2(value, flagName) {
   return parsed;
 }
 function parseJsonInput(raw) {
-  const source = raw.startsWith("@") ? (0, import_node_fs5.readFileSync)((0, import_node_path8.resolve)(raw.slice(1)), "utf-8") : raw;
+  const source = raw.startsWith("@") ? (0, import_node_fs6.readFileSync)((0, import_node_path8.resolve)(raw.slice(1)), "utf-8") : raw;
   const parsed = JSON.parse(source);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error("--input must be a JSON object.");
@@ -4020,7 +4070,7 @@ function parseJsonInput(raw) {
   return parsed;
 }
 function stageFile(logicalPath, absolutePath) {
-  const buffer = (0, import_node_fs5.readFileSync)(absolutePath);
+  const buffer = (0, import_node_fs6.readFileSync)(absolutePath);
   return {
     logicalPath,
     contentBase64: buffer.toString("base64"),
@@ -4031,7 +4081,7 @@ function stageFile(logicalPath, absolutePath) {
 }
 function normalizePlayPath(filePath) {
   try {
-    return import_node_fs5.realpathSync.native((0, import_node_path8.resolve)(filePath));
+    return import_node_fs6.realpathSync.native((0, import_node_path8.resolve)(filePath));
   } catch {
     return (0, import_node_path8.resolve)(filePath);
   }
@@ -4313,6 +4363,10 @@ function buildPlayDashboardUrl(baseUrl, playName) {
   const encodedPlayName = encodeURIComponent(playName);
   return `${trimmedBase}/dashboard/plays/${encodedPlayName}`;
 }
+function getDashboardUrlFromLiveEvent(event) {
+  const dashboardUrl = getEventPayload(event).dashboardUrl;
+  return typeof dashboardUrl === "string" && dashboardUrl.trim() ? dashboardUrl.trim() : null;
+}
 function printPlayLogLines(input) {
   for (const line of input.lines) {
     if (input.emitLogs) {
@@ -4423,18 +4477,33 @@ async function startAndWaitForPlayCompletionByStream(input) {
     },
     Math.max(1, input.waitTimeoutMs)
   );
+  recordCliTrace({
+    phase: "cli.start_stream_request",
+    playName: input.playName
+  });
   try {
+    let eventCount = 0;
     for await (const event of input.client.startPlayRunStream(input.request, {
       signal: controller.signal
     })) {
+      eventCount += 1;
+      if (eventCount === 1) {
+        recordCliTrace({
+          phase: "cli.start_stream_first_event",
+          ms: Date.now() - startedAt,
+          playName: input.playName,
+          eventType: event.type
+        });
+      }
       const eventRunId = getEventPayload(event).runId;
       if (typeof eventRunId === "string" && eventRunId && eventRunId !== "pending") {
         lastKnownWorkflowId = eventRunId;
       }
       const workflowId = lastKnownWorkflowId || "pending";
       if (workflowId !== "pending" && !emittedDashboardUrl) {
+        const dashboardUrl = getDashboardUrlFromLiveEvent(event) ?? buildPlayDashboardUrl(input.client.baseUrl, input.playName);
         input.progress.phase(
-          `loading play on ${buildPlayDashboardUrl(input.client.baseUrl, input.playName)}`
+          `loading play on ${dashboardUrl}`
         );
         emittedDashboardUrl = true;
       }
@@ -4459,6 +4528,14 @@ async function startAndWaitForPlayCompletionByStream(input) {
       });
       const finalStatus = getFinalStatusFromLiveEvent(event);
       if (finalStatus) {
+        recordCliTrace({
+          phase: "cli.start_stream_final_event",
+          ms: Date.now() - startedAt,
+          playName: input.playName,
+          runId: finalStatus.runId,
+          status: finalStatus.status,
+          eventCount
+        });
         return finalStatus;
       }
     }
@@ -5076,7 +5153,7 @@ async function handlePlayCheck(args) {
     return 1;
   }
   const absolutePlayPath = (0, import_node_path8.resolve)(options.target);
-  const sourceCode = (0, import_node_fs5.readFileSync)(absolutePlayPath, "utf-8");
+  const sourceCode = (0, import_node_fs6.readFileSync)(absolutePlayPath, "utf-8");
   let graph;
   try {
     graph = await collectBundledPlayGraph(absolutePlayPath);
@@ -5122,12 +5199,34 @@ async function handleFileBackedRun(options) {
   const client = new DeeplineClient();
   const progress = getActiveCliProgress() ?? createCliProgress(!options.jsonOutput);
   const absolutePlayPath = (0, import_node_path8.resolve)(options.target.path);
+  recordCliTrace({
+    phase: "cli.play_run_file_start",
+    playPath: absolutePlayPath,
+    watch: options.watch,
+    hasCsv: Boolean(options.csvPath),
+    force: options.force
+  });
   progress.phase("compiling play");
-  const sourceCode = (0, import_node_fs5.readFileSync)(absolutePlayPath, "utf-8");
+  const readSourceStartedAt = Date.now();
+  const sourceCode = (0, import_node_fs6.readFileSync)(absolutePlayPath, "utf-8");
+  recordCliTrace({
+    phase: "cli.read_play_source",
+    ms: Date.now() - readSourceStartedAt,
+    bytes: sourceCode.length,
+    playPath: absolutePlayPath
+  });
   let graph;
   try {
-    graph = await collectBundledPlayGraph(absolutePlayPath);
-    await compileBundledPlayGraphManifests(client, graph);
+    graph = await traceCliSpan(
+      "cli.bundle_play_graph",
+      { playPath: absolutePlayPath },
+      () => collectBundledPlayGraph(absolutePlayPath)
+    );
+    await traceCliSpan(
+      "cli.compile_play_manifest",
+      { playPath: absolutePlayPath, nodeCount: graph.nodes.size },
+      () => compileBundledPlayGraphManifests(client, graph)
+    );
     progress.phase("compiled play");
   } catch (error) {
     progress.fail();
@@ -5138,17 +5237,32 @@ async function handleFileBackedRun(options) {
   const playName = bundleResult.playName ?? extractPlayName(sourceCode, absolutePlayPath);
   try {
     progress.phase("publishing imported plays");
-    await publishImportedPlayDependencies(client, graph);
+    await traceCliSpan(
+      "cli.publish_imported_plays",
+      { playName, nodeCount: graph.nodes.size },
+      () => publishImportedPlayDependencies(client, graph)
+    );
   } catch (error) {
     progress.fail();
     console.error(error instanceof Error ? error.message : String(error));
     return 1;
   }
   const runtimeInput = options.input ? { ...options.input } : {};
+  const prepareFilesStartedAt = Date.now();
   const packagedFileUploads = bundleResult.packagedFiles.map(
     (file) => stageFile(file.logicalPath, file.absolutePath)
   );
   const inputFileUpload = options.csvPath ? stageFile((0, import_node_path8.basename)(options.csvPath), options.csvPath) : packagedFileUploads[0] ?? null;
+  if (options.csvPath && typeof runtimeInput.file !== "string" && typeof runtimeInput.csv !== "string") {
+    runtimeInput.file = (0, import_node_path8.basename)(options.csvPath);
+  }
+  recordCliTrace({
+    phase: "cli.prepare_input_files",
+    ms: Date.now() - prepareFilesStartedAt,
+    playName,
+    packagedFileCount: packagedFileUploads.length,
+    hasInputFile: Boolean(inputFileUpload)
+  });
   const startRequest = {
     name: playName,
     sourceCode: bundleResult.sourceCode,
@@ -5161,27 +5275,49 @@ async function handleFileBackedRun(options) {
   };
   if (options.watch) {
     progress.phase("starting run");
-    const finalStatus = await startAndWaitForPlayCompletionByStream({
-      client,
-      request: startRequest,
+    const finalStatus = await traceCliSpan(
+      "cli.start_and_watch",
+      { playName },
+      () => startAndWaitForPlayCompletionByStream({
+        client,
+        request: startRequest,
+        playName,
+        jsonOutput: options.jsonOutput,
+        emitLogs: options.emitLogs,
+        waitTimeoutMs: options.waitTimeoutMs,
+        progress
+      })
+    );
+    const exportStartedAt = Date.now();
+    const exportedPath = exportPlayStatusRows(finalStatus, options.outPath);
+    recordCliTrace({
+      phase: "cli.export_rows",
+      ms: Date.now() - exportStartedAt,
       playName,
-      jsonOutput: options.jsonOutput,
-      emitLogs: options.emitLogs,
-      waitTimeoutMs: options.waitTimeoutMs,
-      progress
+      exported: Boolean(exportedPath)
     });
-    const exportedPath = exportPlayStatusRows(finalStatus, options.outPath);
     if (finalStatus.status === "completed") {
       progress.complete();
     } else {
       progress.fail();
     }
+    recordCliTrace({
+      phase: "cli.write_play_result",
+      playName,
+      status: finalStatus.status,
+      runId: finalStatus.runId
+    });
     writePlayResult(finalStatus, options.jsonOutput, { exportedPath });
     return finalStatus.status === "completed" ? 0 : 1;
   }
   progress.phase("starting run");
-  const started = await client.startPlayRun(startRequest);
-  const dashboardUrl = buildPlayDashboardUrl(client.baseUrl, playName);
+  const started = await traceCliSpan(
+    "cli.start_run",
+    { playName },
+    () => client.startPlayRun(startRequest)
+  );
+  const fallbackDashboardUrl = buildPlayDashboardUrl(client.baseUrl, playName);
+  const dashboardUrl = started.dashboardUrl ?? fallbackDashboardUrl;
   progress.phase(`loading play on ${dashboardUrl}`);
   progress.complete();
   writeStartedPlayRun({
@@ -5189,7 +5325,7 @@ async function handleFileBackedRun(options) {
     playName,
     status: started.status,
     statusUrl: started.statusUrl,
-    dashboardUrl: started.dashboardUrl ?? dashboardUrl,
+    dashboardUrl,
     jsonOutput: options.jsonOutput
   });
   return 0;
@@ -5261,10 +5397,11 @@ async function handleNamedRun(options) {
   }
   progress.phase("starting run");
   const started = await client.startPlayRun(startRequest);
-  const dashboardUrl = buildPlayDashboardUrl(
+  const fallbackDashboardUrl = buildPlayDashboardUrl(
     client.baseUrl,
     options.target.name
   );
+  const dashboardUrl = started.dashboardUrl ?? fallbackDashboardUrl;
   progress.phase(`loading play on ${dashboardUrl}`);
   progress.complete();
   writeStartedPlayRun({
@@ -5272,7 +5409,7 @@ async function handleNamedRun(options) {
     playName: started.name ?? options.target.name,
     status: started.status,
     statusUrl: started.statusUrl,
-    dashboardUrl: started.dashboardUrl ?? dashboardUrl,
+    dashboardUrl,
     jsonOutput: options.jsonOutput
   });
   return 0;
@@ -5286,10 +5423,10 @@ async function handlePlayRun(args) {
     const resolved = (0, import_node_path8.resolve)(options.target.path);
     console.error(`File not found: ${resolved}`);
     const dir = (0, import_node_path8.dirname)(resolved);
-    if ((0, import_node_fs5.existsSync)(dir)) {
+    if ((0, import_node_fs6.existsSync)(dir)) {
       const base = (0, import_node_path8.basename)(resolved);
       try {
-        const siblings = (0, import_node_fs5.readdirSync)(dir).filter(
+        const siblings = (0, import_node_fs6.readdirSync)(dir).filter(
           (f) => f.includes(base.replace(/\.(play\.)?ts$/, "")) || f.endsWith(".play.ts")
         );
         if (siblings.length > 0) {
@@ -5499,7 +5636,7 @@ async function handlePlayGet(args) {
       outPath = (0, import_node_path8.resolve)(args[++index]);
     }
   }
-  const playName = isFileTarget(target) ? extractPlayName((0, import_node_fs5.readFileSync)((0, import_node_path8.resolve)(target), "utf-8"), (0, import_node_path8.resolve)(target)) : parseReferencedPlayTarget(target).playName;
+  const playName = isFileTarget(target) ? extractPlayName((0, import_node_fs6.readFileSync)((0, import_node_path8.resolve)(target), "utf-8"), (0, import_node_path8.resolve)(target)) : parseReferencedPlayTarget(target).playName;
   const detail = isFileTarget(target) ? await client.getPlay(playName) : await assertCanonicalNamedPlayReference(client, target);
   const resolvedSource = detail.play.workingRevision?.sourceCode ?? detail.play.liveRevision?.sourceCode ?? detail.play.currentRevision?.sourceCode ?? detail.play.sourceCode ?? "";
   const materializedFile = sourceOutput || outPath ? materializeRemotePlaySource({
@@ -6062,7 +6199,7 @@ Examples:
 }
 
 // src/tool-output.ts
-var import_node_fs6 = require("fs");
+var import_node_fs7 = require("fs");
 var import_node_os6 = require("os");
 var import_node_path9 = require("path");
 function isPlainObject(value) {
@@ -6140,13 +6277,13 @@ function tryConvertToList(payload, options) {
 }
 function ensureOutputDir() {
   const outputDir = (0, import_node_path9.join)((0, import_node_os6.homedir)(), ".local", "share", "deepline", "data");
-  (0, import_node_fs6.mkdirSync)(outputDir, { recursive: true });
+  (0, import_node_fs7.mkdirSync)(outputDir, { recursive: true });
   return outputDir;
 }
 function writeJsonOutputFile(payload, stem) {
   const outputDir = ensureOutputDir();
   const outputPath = (0, import_node_path9.join)(outputDir, `${stem}_${Date.now()}.json`);
-  (0, import_node_fs6.writeFileSync)(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  (0, import_node_fs7.writeFileSync)(outputPath, JSON.stringify(payload, null, 2), "utf-8");
   return outputPath;
 }
 function writeCsvOutputFile(rows, stem) {
@@ -6174,7 +6311,7 @@ function writeCsvOutputFile(rows, stem) {
   for (const row of rows) {
     lines.push(columns.map((column) => escapeCell(row[column])).join(","));
   }
-  (0, import_node_fs6.writeFileSync)(outputPath, `${lines.join("\n")}
+  (0, import_node_fs7.writeFileSync)(outputPath, `${lines.join("\n")}
 `, "utf-8");
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
@@ -6761,6 +6898,11 @@ function shouldPrintStartupPhase() {
   return (command === "play" || command === "plays") && subcommand === "run";
 }
 async function main() {
+  const mainStartedAt = Date.now();
+  recordCliTrace({
+    phase: "cli.main_start",
+    argv: process.argv.slice(2)
+  });
   const printStartupPhase = shouldPrintStartupPhase();
   const progress = printStartupPhase ? createCliProgress(true) : null;
   if (printStartupPhase) {
@@ -6790,7 +6932,12 @@ Output:
     if (printStartupPhase) {
       progress?.phase("checking sdk compatibility");
     }
-    await enforceSdkCompatibility(autoDetectBaseUrl().replace(/\/$/, ""));
+    const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
+    await traceCliSpan(
+      "cli.sdk_compatibility",
+      { baseUrl },
+      () => enforceSdkCompatibility(baseUrl)
+    );
   });
   registerAuthCommands(program);
   registerToolsCommands(program);
@@ -6818,7 +6965,18 @@ Output:
   });
   try {
     await program.parseAsync(process.argv);
+    recordCliTrace({
+      phase: "cli.main_total",
+      ms: Date.now() - mainStartedAt,
+      ok: true
+    });
   } catch (error) {
+    recordCliTrace({
+      phase: "cli.main_total",
+      ms: Date.now() - mainStartedAt,
+      ok: false,
+      error: error instanceof Error ? error.message : String(error)
+    });
     if (process.argv.includes("--json")) {
       printJsonError(error);
     } else if (error instanceof Error) {