@moda-ai/cli 1.55.15 → 1.55.16

package/dist/cli.js

@@ -684,10 +684,14 @@ async function runReplaysCommand(context) {
 }
 
 // src/telemetry.ts
+import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
-var TELEMETRY_TIMEOUT_MS = 500;
+var INLINE_TELEMETRY_TIMEOUT_MS = 500;
+var DETACHED_TELEMETRY_TIMEOUT_MS = 5000;
 var INVOCATION_ID = randomUUID();
 var TELEMETRY_FLAG = "no-telemetry";
+var TELEMETRY_REQUEST_ENV = "MODA_CLI_TELEMETRY_REQUEST";
+var TELEMETRY_TRANSPORT_ENV = "MODA_CLI_TELEMETRY_TRANSPORT";
 var MAX_TELEMETRY_DURATION_MS = 86400000;
 var MAX_TELEMETRY_API_REQUEST_COUNT = 1e6;
 var SEARCH_SURFACE_BY_COMMAND = {
@@ -715,6 +719,8 @@ function buildSearchAdoptionTelemetry(input) {
   };
   if (positional && input.subcommands?.includes(positional)) {
     adoption.subcommand = positional;
+  } else if (positional === undefined && input.defaultSubcommand) {
+    adoption.subcommand = input.defaultSubcommand;
   }
   let queryText;
   if (command === "search")
@@ -742,6 +748,8 @@ function buildSearchAdoptionTelemetry(input) {
   }
   if (recorded.has_more)
     adoption.has_more = recorded.has_more;
+  if (recorded.degrade_reason)
+    adoption.degrade_reason = recorded.degrade_reason;
   const skill = input.skillVersion?.trim();
   if (skill)
     adoption.skill_version = skill.slice(0, 64);
@@ -776,6 +784,9 @@ function serializeAdoption(adoption) {
     out.zero_result = adoption.zero_result;
   if (adoption.has_more)
     out.has_more = adoption.has_more;
+  const degradeReason = sanitizeReasonCode(adoption.degrade_reason, DEGRADE_REASON_MAX);
+  if (degradeReason)
+    out.degrade_reason = degradeReason;
   if (adoption.used_msg_index !== undefined) {
     out.used_msg_index = adoption.used_msg_index ? 1 : 0;
   }
@@ -791,52 +802,152 @@ function isTelemetryDisabled(flags) {
   return flags[TELEMETRY_FLAG] === "true" || process.env.MODA_CLI_TELEMETRY === "0" || process.env.DO_NOT_TRACK === "1";
 }
 var VALIDATION_REASON_MAX = 128;
-function sanitizeValidationReason(reason) {
-  const cleaned = reason?.replace(/[^A-Za-z0-9_.:-]/g, "_").slice(0, VALIDATION_REASON_MAX);
+var DEGRADE_REASON_MAX = 64;
+function sanitizeReasonCode(reason, max) {
+  const cleaned = reason?.replace(/[^A-Za-z0-9_.:-]/g, "_").slice(0, max);
   return cleaned ? cleaned : undefined;
 }
+function sanitizeValidationReason(reason) {
+  return sanitizeReasonCode(reason, VALIDATION_REASON_MAX);
+}
 function sanitizedFlagNames(flags) {
   return Object.keys(stripTelemetryFlag(flags)).sort();
 }
-async function sendCliUsageTelemetry(input) {
-  if (!input.apiKey || isTelemetryDisabled(input.flags)) {
-    return;
+var TELEMETRY_SENDER_SCRIPT = [
+  "try {",
+  `  const raw = process.env.${TELEMETRY_REQUEST_ENV};`,
+  `  delete process.env.${TELEMETRY_REQUEST_ENV};`,
+  "  const r = raw ? JSON.parse(raw) : null;",
+  "  if (r && typeof r.url === 'string' && typeof fetch === 'function') {",
+  "    const c = new AbortController();",
+  `    const t = setTimeout(() => c.abort(), ${DETACHED_TELEMETRY_TIMEOUT_MS});`,
+  "    fetch(r.url, { method: 'POST', headers: r.headers, body: r.body, signal: c.signal })",
+  "      .then((res) => (res.body && res.body.cancel ? res.body.cancel() : undefined))",
+  "      .catch(() => {})",
+  "      .finally(() => clearTimeout(t));",
+  "  }",
+  "} catch {}"
+].join(`
+`);
+var INSPECTOR_VALUE_OPTIONS = new Set(["--inspect-port", "--debug-port", "--inspect-publish-uid"]);
+function nodeOptionTokens(nodeOptions) {
+  const tokens = [];
+  let start = -1;
+  let quoted = false;
+  for (let i = 0;i < nodeOptions.length; i += 1) {
+    const ch = nodeOptions[i];
+    if (start === -1) {
+      if (/\s/.test(ch))
+        continue;
+      start = i;
+    }
+    if (quoted && ch === "\\") {
+      i += 1;
+    } else if (ch === '"') {
+      quoted = !quoted;
+    } else if (!quoted && /\s/.test(ch)) {
+      tokens.push(nodeOptions.slice(start, i));
+      start = -1;
+    }
   }
-  const validationReason = sanitizeValidationReason(input.validationReason);
+  if (start !== -1)
+    tokens.push(nodeOptions.slice(start));
+  return tokens;
+}
+function withoutInspectorOptions(nodeOptions) {
+  const tokens = nodeOptionTokens(nodeOptions);
+  const kept = [];
+  for (let i = 0;i < tokens.length; i += 1) {
+    const name = tokens[i].split("=")[0];
+    if (!name.startsWith("--inspect") && name !== "--debug-port") {
+      kept.push(tokens[i]);
+      continue;
+    }
+    if (INSPECTOR_VALUE_OPTIONS.has(tokens[i]) && tokens[i + 1] && !tokens[i + 1].startsWith("-"))
+      i += 1;
+  }
+  return kept.join(" ");
+}
+function spawnDetachedTelemetrySender(request, spawnImpl = spawn) {
+  try {
+    const env = { ...process.env, [TELEMETRY_REQUEST_ENV]: JSON.stringify(request) };
+    if (env.NODE_OPTIONS?.includes("--inspect")) {
+      const kept = withoutInspectorOptions(env.NODE_OPTIONS);
+      if (kept)
+        env.NODE_OPTIONS = kept;
+      else
+        delete env.NODE_OPTIONS;
+    }
+    const child = spawnImpl(process.execPath, ["-e", TELEMETRY_SENDER_SCRIPT], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+      env
+    });
+    child.on("error", () => {});
+    if (child.pid === undefined)
+      return false;
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function sendInline(request) {
   const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+  const timeout = setTimeout(() => controller.abort(), INLINE_TELEMETRY_TIMEOUT_MS);
   if (typeof timeout.unref === "function") {
     timeout.unref();
   }
   try {
-    await fetch(`${resolveModaBaseUrl({ profile: input.profile })}/api/v1/data/cli-usage`, {
+    await fetch(request.url, {
       method: "POST",
-      headers: {
-        ...apiKeyHeaders(input.apiKey),
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        invocation_id: INVOCATION_ID,
-        command: input.command.slice(0, 64),
-        status: input.status,
-        error_type: input.errorType,
-        ...validationReason ? { validation_reason: validationReason } : {},
-        exit_code: input.exitCode,
-        duration_ms: clampInt(input.durationMs, 0, MAX_TELEMETRY_DURATION_MS) ?? 0,
-        api_request_count: clampInt(input.apiRequestCount, 0, MAX_TELEMETRY_API_REQUEST_COUNT) ?? 0,
-        cli_version: VERSION,
-        node_version: process.versions.node,
-        platform: process.platform,
-        arch: process.arch,
-        flags_json: { names: sanitizedFlagNames(input.flags) },
-        ...serializeAdoption(input.adoption)
-      }),
+      headers: request.headers,
+      body: request.body,
       signal: controller.signal
     });
   } catch {} finally {
     clearTimeout(timeout);
   }
 }
+function buildCliUsageRequest(input) {
+  const validationReason = sanitizeValidationReason(input.validationReason);
+  return {
+    url: `${resolveModaBaseUrl({ profile: input.profile })}/api/v1/data/cli-usage`,
+    headers: {
+      ...apiKeyHeaders(input.apiKey),
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      invocation_id: INVOCATION_ID,
+      command: input.command.slice(0, 64),
+      status: input.status,
+      error_type: input.errorType,
+      ...validationReason ? { validation_reason: validationReason } : {},
+      exit_code: input.exitCode,
+      duration_ms: clampInt(input.durationMs, 0, MAX_TELEMETRY_DURATION_MS) ?? 0,
+      api_request_count: clampInt(input.apiRequestCount, 0, MAX_TELEMETRY_API_REQUEST_COUNT) ?? 0,
+      cli_version: VERSION,
+      node_version: process.versions.node,
+      platform: process.platform,
+      arch: process.arch,
+      flags_json: { names: sanitizedFlagNames(input.flags) },
+      ...serializeAdoption(input.adoption)
+    })
+  };
+}
+async function sendCliUsageTelemetry(input) {
+  try {
+    if (!input.apiKey || isTelemetryDisabled(input.flags)) {
+      return;
+    }
+    const request = buildCliUsageRequest({ ...input, apiKey: input.apiKey });
+    if (process.env[TELEMETRY_TRANSPORT_ENV] !== "inline" && spawnDetachedTelemetrySender(request)) {
+      return;
+    }
+    await sendInline(request);
+  } catch {}
+}
 
 // src/update-check.ts
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -2255,6 +2366,7 @@ var META_SWITCHES = new Set([
   "no-telemetry",
   "no-update-check"
 ]);
+var AGENT_VALUE_COMMANDS = new Set(["harness", "sync"]);
 var COMMAND_BOOLEAN_FLAGS = {
   context: new Set(["all", "metadata-only"])
 };
@@ -2280,7 +2392,7 @@ function parseFlag(args, index, flags, beforeCommand, bareFlags, command = "") {
     return index;
   }
   const switchName = key.replace(/_/g, "-");
-  if (META_SWITCHES.has(switchName)) {
+  if (META_SWITCHES.has(switchName) || switchName === "agent" && !AGENT_VALUE_COMMANDS.has(command)) {
     set(key, "true", true);
     return index;
   }
@@ -3123,7 +3235,8 @@ function recordSearchTelemetry(context, data) {
   context.recordTelemetry({
     search_mode_effective: SEARCH_MODES2.includes(effective) ? effective : undefined,
     result_count: results.length,
-    has_more: hasMore === true ? "yes" : hasMore === false ? "no" : "na"
+    has_more: hasMore === true ? "yes" : hasMore === false ? "no" : "na",
+    ...typeof record.degrade_reason === "string" && record.degrade_reason ? { degrade_reason: record.degrade_reason.slice(0, 64) } : {}
   });
 }
 function recordConversationsTelemetry(context, data) {
@@ -4879,6 +4992,13 @@ async function runCommand(command, positional, flags, positionals = positional ?
 function telemetryCommandName(definition) {
   return definition.telemetryCommand ?? definition.name;
 }
+var TELEMETRY_EXEMPT_COMMANDS = {};
+function telemetrySubcommandNames(definition) {
+  return [
+    ...definition.subcommands?.map((subcommand) => subcommand.name) ?? [],
+    ...definition.telemetrySubcommands ?? []
+  ];
+}
 var OFFLINE_PROMPTS_SUBCOMMANDS = new Set(["init", "status", "diff", "migrate"]);
 function legacyCommand(metadata) {
   return {
@@ -4973,7 +5093,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: true,
-    telemetry: "result",
+    telemetry: "result-and-error",
     handler: async (context) => {
       const { runInit } = await import("./index-ccdpy9ma.js");
       if (context.outputMode === "agent-stream") {
@@ -5031,7 +5151,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "read",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
     handler: async (context) => {
       const manifest = buildManifest(commandRegistry.all());
       if (context.outputMode === "human") {
@@ -5138,7 +5258,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
     handler: runAuthCommand
   },
   {
@@ -5150,7 +5270,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "read",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
     handler: runStatusCommand
   },
   {
@@ -5163,7 +5283,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "read",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
     handler: runDoctorCommand
   },
   {
@@ -5175,7 +5295,8 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    telemetrySubcommands: ["list", "use", "create", "doctor"],
     handler: runProfilesCommand
   },
   {
@@ -5187,7 +5308,8 @@ var commandRegistry = createCommandRegistry([
     mutability: "read",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    telemetrySubcommands: ["show"],
     handler: runConfigCommand
   },
   {
@@ -5210,7 +5332,8 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    defaultSubcommand: "scan",
     handler: runHarnessCommand
   },
   {
@@ -5226,7 +5349,9 @@ var commandRegistry = createCommandRegistry([
     mutability: "read",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    telemetrySubcommands: ["context", "next-action", "next-actions", "evidence", "investigate"],
+    defaultSubcommand: "context",
     handler: runAgentCommand
   },
   {
@@ -5242,7 +5367,9 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    telemetrySubcommands: ["harness", "prompts", "skills"],
+    defaultSubcommand: "harness",
     handler: runSyncCommand
   },
   {
@@ -5382,7 +5509,8 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "none",
+    telemetry: "result-and-error",
+    defaultSubcommand: "push",
     handler: runRegistryCommand
   },
   legacyCommand({
@@ -5520,6 +5648,7 @@ var commandRegistry = createCommandRegistry([
     description: "Rank cross-signal Problems by root cause (what to fix first)",
     examples: ["moda problems", "moda problems --days-back=7 --limit=10", "moda problems remainder --family=emotion"],
     subcommands: PROBLEMS_SUBCOMMAND_HELP,
+    defaultSubcommand: "list",
     ...dataApiDefaults
   }),
   legacyCommand({
@@ -5634,6 +5763,7 @@ var commandRegistry = createCommandRegistry([
       "moda signals activate <signal_id>"
     ],
     subcommands: SIGNALS_SUBCOMMAND_HELP,
+    defaultSubcommand: "list",
     ...dataApiDefaults,
     mutability: "write"
   }),
@@ -5821,7 +5951,8 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: (parsed) => !OFFLINE_PROMPTS_SUBCOMMANDS.has(parsed.positional ?? "status"),
     resetApiRequestCountBeforeRun: true,
-    telemetry: "result-and-error"
+    telemetry: "result-and-error",
+    defaultSubcommand: "status"
   }),
   {
     name: "skills",
@@ -5841,7 +5972,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "result",
+    telemetry: "result-and-error",
     handler: async (context) => ({
       exitCode: await runSkillsCommand(context)
     })
@@ -5861,9 +5992,10 @@ var commandRegistry = createCommandRegistry([
     outputModes: ["human", "json", "agent"],
     mutability: "write",
     subcommands: FIXES_SUBCOMMAND_HELP,
+    defaultSubcommand: "list",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "result",
+    telemetry: "result-and-error",
     handler: async (context) => ({
       exitCode: await runFixesCommand(context)
     })
@@ -5887,7 +6019,7 @@ var commandRegistry = createCommandRegistry([
     mutability: "write",
     validateConfigBeforeRun: false,
     resetApiRequestCountBeforeRun: false,
-    telemetry: "result",
+    telemetry: "result-and-error",
     handler: async (context) => ({
       exitCode: await runFixCommand(context)
     })
@@ -6003,6 +6135,12 @@ function printAgentCliError(command, error, mode = "agent") {
   });
   output.writeError(error);
 }
+function existingFlagProfile(flags) {
+  const name = flags.profile;
+  if (!name || name === "true")
+    return;
+  return Object.hasOwn(loadProfileConfig({ env: process.env }).profiles, name) ? name : undefined;
+}
 async function dispatchParsedCommand(parsed, startedAt = Date.now()) {
   const previousProfileEnv = process.env.MODA_PROFILE;
   try {
@@ -6055,8 +6193,7 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
     const telemetryOptOut = telemetryDisabled || flags["no-telemetry"] !== undefined && flags["no-telemetry"] !== "false";
     if (commandDefinition && !telemetryOptOut && commandDefinition.telemetry === "result-and-error") {
       const telemetryCommand2 = telemetryCommandName(commandDefinition);
-      const flagProfile = commandFlags.profile && commandFlags.profile !== "true" ? commandFlags.profile : undefined;
-      const telemetryProfile = flagProfile && Object.hasOwn(loadProfileConfig({ env: process.env }).profiles, flagProfile) ? flagProfile : undefined;
+      const telemetryProfile = existingFlagProfile(commandFlags);
       sendCliUsageTelemetry({
         apiKey: resolveApiKey({ profile: telemetryProfile }),
         profile: telemetryProfile,
@@ -6075,7 +6212,8 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
           outputMode: mode,
           recorded: {},
           skillVersion: process.env.MODA_SKILL_VERSION,
-          subcommands: commandDefinition.subcommands?.map((subcommand) => subcommand.name)
+          subcommands: telemetrySubcommandNames(commandDefinition),
+          defaultSubcommand: commandDefinition.defaultSubcommand
         })
       });
     }
@@ -6130,15 +6268,17 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
   });
   setActiveContext(context);
   const telemetryCommand = telemetryCommandName(definition);
-  const telemetrySubcommands = definition.subcommands?.map((subcommand) => subcommand.name);
+  const telemetrySubcommands = telemetrySubcommandNames(definition);
   const needsConfig = typeof definition.validateConfigBeforeRun === "function" ? definition.validateConfigBeforeRun(parsed) : definition.validateConfigBeforeRun;
   if (needsConfig) {
     try {
       validateConfig();
     } catch (error) {
       if (!telemetryDisabled && definition.telemetry === "result-and-error") {
+        const telemetryProfile = existingFlagProfile(commandFlags);
         sendCliUsageTelemetry({
-          apiKey: resolveApiKey(),
+          apiKey: resolveApiKey({ profile: telemetryProfile }),
+          profile: telemetryProfile,
           command: telemetryCommand,
           flags: commandFlags,
           status: "error",
@@ -6154,7 +6294,8 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
             outputMode: context.outputMode,
             recorded: context.getTelemetryMeta(),
             skillVersion: process.env.MODA_SKILL_VERSION,
-            subcommands: telemetrySubcommands
+            subcommands: telemetrySubcommands,
+            defaultSubcommand: definition.defaultSubcommand
           })
         });
       }
@@ -6172,8 +6313,10 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
   try {
     const result = await definition.handler(context);
     if (!telemetryDisabled && definition.telemetry !== "none") {
+      const telemetryProfile = existingFlagProfile(commandFlags);
       sendCliUsageTelemetry({
-        apiKey: result.apiKey ?? resolveApiKey(),
+        apiKey: result.apiKey ?? resolveApiKey({ profile: telemetryProfile }),
+        profile: telemetryProfile,
         command: telemetryCommand,
         flags: commandFlags,
         status: result.exitCode === 0 ? "success" : "error",
@@ -6187,7 +6330,8 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
           outputMode: context.outputMode,
           recorded: context.getTelemetryMeta(),
           skillVersion: process.env.MODA_SKILL_VERSION,
-          subcommands: telemetrySubcommands
+          subcommands: telemetrySubcommands,
+          defaultSubcommand: definition.defaultSubcommand
         })
       });
     }
@@ -6198,8 +6342,10 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
     return finishRun(context, { kind: "completed", exitCode: result.exitCode });
   } catch (error) {
     if (!telemetryDisabled && definition.telemetry === "result-and-error") {
+      const telemetryProfile = existingFlagProfile(commandFlags);
       sendCliUsageTelemetry({
-        apiKey: resolveApiKey(),
+        apiKey: resolveApiKey({ profile: telemetryProfile }),
+        profile: telemetryProfile,
         command: telemetryCommand,
         flags: commandFlags,
         status: "error",
@@ -6215,7 +6361,8 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
           outputMode: context.outputMode,
           recorded: context.getTelemetryMeta(),
           skillVersion: process.env.MODA_SKILL_VERSION,
-          subcommands: telemetrySubcommands
+          subcommands: telemetrySubcommands,
+          defaultSubcommand: definition.defaultSubcommand
         })
       });
     }
@@ -6267,6 +6414,7 @@ if (isMain) {
   });
 }
 export {
+  telemetrySubcommandNames,
   telemetryCommandName,
   stripLoneSurrogates,
   searchOutcomeWarnings,
@@ -6290,6 +6438,7 @@ export {
   capProblemsBlocks,
   buildResumeCommand,
   auditCapStatus,
+  TELEMETRY_EXEMPT_COMMANDS,
   TAIL_LIMITS,
   RAW_BOOLEAN_FLAGS,
   LEGACY_WINDOW_MAX_MESSAGES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.55.15",
+  "version": "1.55.16",
   "description": "CLI for Moda: production monitoring and evals for AI agents.",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-10-15T06:17:15.907Z",
-  "cli_version": "1.55.15",
+  "bundled_at": "2026-10-15T06:39:15.616Z",
+  "cli_version": "1.55.16",
   "skills": [
     {
       "id": "integration-cloudflare-think",