@moda-ai/cli 1.50.0 → 1.52.0

package/dist/{cli-xrs02c0t.js → cli-ac3p2byq.js}

@@ -534,9 +534,11 @@ function writeSecretJsonFile(path, value) {
 // src/errors.ts
 class CliInputError extends Error {
   usage;
-  constructor(message, usage) {
+  reason;
+  constructor(message, usage, reason) {
     super(message);
     this.usage = usage;
+    this.reason = reason;
     this.name = "CliInputError";
   }
 }

package/dist/{cli-jqfm8dp4.js → cli-ha40mgy1.js}

@@ -13,7 +13,7 @@ import {
   resolvePromptSource,
   safePromptEvidencePath,
   scanHarness
-} from "./cli-x0x0n35w.js";
+} from "./cli-he2wb4hd.js";
 import {
   SKILL_SOURCE_HARNESS,
   SKILL_SOURCE_INTEGRATION_BUNDLED,
@@ -26,7 +26,7 @@ import {
 import {
   isAuthSessionValid,
   loadAuthSession
-} from "./cli-7kbzqact.js";
+} from "./cli-kxwm7y62.js";
 import {
   CliInputError,
   EXIT_ERROR,
@@ -45,7 +45,7 @@ import {
   resolveTenantId,
   secretFilePathFromRef,
   validateConfig
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import {
   __commonJS,
   __require,
@@ -6711,7 +6711,7 @@ async function runPromptSyncExclusive(flags, profileOptions, options) {
   const analyzedDefinitions = new Map;
   if (flags["no-analyze"] !== "true") {
     options.onProgress?.("Analyzing prompt sources before sync.");
-    const { analyzeHarnessPrompts } = await import("./harness-7gr0xbtc.js");
+    const { analyzeHarnessPrompts } = await import("./harness-s13wvdxt.js");
     const result = await analyzeHarnessPrompts({
       rootDir: process.cwd(),
       existing: established.flatMap((prompt) => prompt.sourceDefinition ? [prompt.sourceDefinition.source] : []),

package/dist/{cli-x0x0n35w.js → cli-he2wb4hd.js}

@@ -25,7 +25,7 @@ import {
   resolveTenantId,
   shouldInventoryFile,
   stringOption
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import {
   __commonJS,
   __require,
@@ -184857,7 +184857,7 @@ async function runHarnessCommand(context) {
         throw new CliInputError("Focused remote prompt analysis is not supported yet.", "Use local --analyst=claude|codex|cursor|local-scan, or drop --concern for a full remote report.");
       }
       if (context.flags["github-actions"] === "true") {
-        const { runGithubActionsAnalyze } = await import("./harness-github-actions-q9kewzb6.js");
+        const { runGithubActionsAnalyze } = await import("./harness-github-actions-gbty3k66.js");
         const result = await runGithubActionsAnalyze(rootDir, {
           writeReport: (report2) => {
             const normalized = normalizeHarnessReport(report2);

package/dist/{cli-7kbzqact.js → cli-kxwm7y62.js}

@@ -7,7 +7,7 @@ import {
   saveProfileConfig,
   secretFilePathFromRef,
   writeSecretJsonFile
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import {
   __require
 } from "./cli-0v6na3yp.js";

package/dist/{cli-h4k23fb0.js → cli-sq6g0tk5.js}

@@ -1,7 +1,7 @@
 import {
   authFetch,
   getCachedLoginContext
-} from "./cli-7kbzqact.js";
+} from "./cli-kxwm7y62.js";
 import {
   CliAccessError,
   CliInputError,
@@ -15,7 +15,7 @@ import {
   resolveTenantIdFromActiveProfile,
   saveCliConfig,
   writeSecretJsonFile
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 
 // src/init/tenant.ts
 import { randomUUID } from "node:crypto";

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   runPromptsCommand,
   runSkillsCommand,
   runStatusCommand
-} from "./cli-jqfm8dp4.js";
+} from "./cli-ha40mgy1.js";
 import {
   ApiError,
   HARNESS_REPORT_APPROVAL_PATH,
@@ -37,7 +37,7 @@ import {
   terminalStyles,
   unknownSignalsSubcommandError,
   validateHarnessReport
-} from "./cli-x0x0n35w.js";
+} from "./cli-he2wb4hd.js";
 import"./cli-ssfq84k5.js";
 import {
   authFetch,
@@ -46,7 +46,7 @@ import {
   loadAuthSession,
   login,
   revokeCliSessionToken
-} from "./cli-7kbzqact.js";
+} from "./cli-kxwm7y62.js";
 import {
   AGENT_ERROR_CODES,
   CliAccessError,
@@ -97,7 +97,7 @@ import {
   validateConfig,
   wasOutputCancelled,
   writeSecretJsonFile
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import {
   __require
 } from "./cli-0v6na3yp.js";
@@ -150,11 +150,20 @@ var WorldStateSchema = z.object({
   format: z.enum(["frames", "fold-inputs"]).optional(),
   message_count: z.number().min(1).max(1e6).optional()
 });
+var lenientBoolFlag = () => z.preprocess((val) => {
+  const text = String(val).toLowerCase();
+  if (["true", "1", "yes", "on"].includes(text))
+    return true;
+  if (["false", "0", "no", "off"].includes(text))
+    return false;
+  return val;
+}, z.boolean()).optional();
 var ContextSchema = z.object({
-  conversation_id: z.string(),
-  msg_index: z.number().min(0).optional(),
+  conversation_id: z.string().min(1),
+  msg_index: z.number().int().min(0).optional(),
   window: z.number().int().min(0).optional(),
-  all: boolFlag(),
+  metadata_only: lenientBoolFlag(),
+  all: lenientBoolFlag(),
   from: z.number().int().min(0).optional(),
   max_messages: z.number().int().min(1).max(5000).optional()
 });
@@ -3534,6 +3543,11 @@ function stripTelemetryFlag(flags) {
 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);
+  return cleaned ? cleaned : undefined;
+}
 function sanitizedFlagNames(flags) {
   return Object.keys(stripTelemetryFlag(flags)).sort();
 }
@@ -3541,6 +3555,7 @@ async function sendCliUsageTelemetry(input) {
   if (!input.apiKey || isTelemetryDisabled(input.flags)) {
     return;
   }
+  const validationReason = sanitizeValidationReason(input.validationReason);
   const controller = new AbortController;
   const timeout = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
   if (typeof timeout.unref === "function") {
@@ -3558,6 +3573,7 @@ async function sendCliUsageTelemetry(input) {
         command: input.command.slice(0, 64),
         status: input.status,
         error_type: input.errorType,
+        ...validationReason ? { validation_reason: validationReason } : {},
         exit_code: input.exitCode,
         duration_ms: Math.max(0, Math.round(input.durationMs)),
         api_request_count: Math.max(0, Math.round(input.apiRequestCount)),
@@ -6663,7 +6679,7 @@ function frustrationFindings(data, daysBack, evidenceRefs) {
       id: "action_frustration_window",
       title: "Read the frustration window.",
       rationale: "The user quote and nearby turns reveal what confused or blocked the user.",
-      command: conversationId ? `moda context ${conversationId}${anchorIndex !== null ? ` --msg-index=${anchorIndex}` : ""} --window=3` : `moda frustrations --days-back=${daysBack} --include-window`,
+      command: conversationId ? `moda context ${shellWord(conversationId)}${anchorIndex !== null ? ` --msg-index=${anchorIndex}` : ""} --window=3` : `moda frustrations --days-back=${daysBack} --include-window`,
       mutability: "read",
       requiresApproval: false
     }]
@@ -7750,7 +7766,7 @@ function parseArgs(argv) {
     if (!endOfOptions && arg === "--" && command !== "") {
       endOfOptions = true;
     } else if (!endOfOptions && arg.startsWith("--")) {
-      i = parseFlag(args, i, flags, command === "", bareFlags);
+      i = parseFlag(args, i, flags, command === "", bareFlags, command);
     } else if (!endOfOptions && command !== "" && /^-[A-Za-z]/.test(arg)) {
       shortFlags.push(arg);
     } else if (command === "") {
@@ -7790,7 +7806,10 @@ var GLOBAL_BOOLEAN_FLAGS = new Set([
   "tui",
   "no-tui"
 ]);
-function parseFlag(args, index, flags, beforeCommand, bareFlags) {
+var COMMAND_BOOLEAN_FLAGS = {
+  context: new Set(["all", "metadata-only"])
+};
+function parseFlag(args, index, flags, beforeCommand, bareFlags, command = "") {
   const set = (key2, value, bare) => {
     flags[key2] = value;
     const at = bareFlags.indexOf(key2);
@@ -7811,6 +7830,10 @@ function parseFlag(args, index, flags, beforeCommand, bareFlags) {
     set(key, "true", true);
     return index;
   }
+  if (!beforeCommand && COMMAND_BOOLEAN_FLAGS[command]?.has(key.replace(/_/g, "-")) && next !== "true" && next !== "false") {
+    set(key, "true", true);
+    return index;
+  }
   if (next !== undefined && !next.startsWith("--")) {
     set(key, next, false);
     return index + 1;
@@ -7903,7 +7926,7 @@ Commands:
   traces --sort=longest            Sort traces: recent (default), longest, slowest
   search "<query>"                 Search trace messages (keyword/semantic/hybrid)
   world-state <conversation_id>    Get a trace's world state (slots/threads/events)
-  context <conversation_id>        Get windowed trace context
+  context <conversation_id>        Get windowed trace context (--metadata-only: summary + counts only)
   context <conversation_id> --all  Whole transcript in order (first 500; --from=N --max-messages=N to continue)
   audit <conversation_id|trace_id> Raw span audit (spans, hierarchy, orphans, duplicates)
   frustrations                     Frustration detections (same data as emotions --family=frustration)
@@ -8736,7 +8759,7 @@ function parseCommandFlags(schema, args, command, options = {}) {
   ]);
   const unknown = Object.keys(args).filter((key) => !known.has(key));
   if (unknown.includes("dry_run")) {
-    throw new CliInputError(`'moda ${command}' has no dry-run mode, so nothing was sent.`, `Remove --dry-run to run it for real. Commands with a real dry-run: sync, registry push, harness sync/delete, prompts sync/decide, skills sync/policy, signals <write subcommands>, problem-reopen.`);
+    throw new CliInputError(`'moda ${command}' has no dry-run mode, so nothing was sent.`, `Remove --dry-run to run it for real. Commands with a real dry-run: sync, registry push, harness sync/delete, prompts sync/decide, skills sync/policy, signals <write subcommands>, problem-reopen.`, "unsupported_dry_run");
   }
   if (unknown.length > 0) {
     const flagKeys = schemaKeys.filter((key) => key !== options.positionalKey);
@@ -8751,7 +8774,7 @@ function parseCommandFlags(schema, args, command, options = {}) {
       return close ? `Did you mean --${close.candidate.replace(/_/g, "-")}?` : "";
     }).filter(Boolean);
     const names = unknown.map((key) => `--${key.replace(/_/g, "-")}`).join(", ");
-    throw new CliInputError(`Unknown flag${unknown.length > 1 ? "s" : ""} ${names} for 'moda ${command}'.`, [...hints, `Valid flags: ${valid.join(", ") || "(none)"}. Run 'moda ${command} --help'.`].join(" "));
+    throw new CliInputError(`Unknown flag${unknown.length > 1 ? "s" : ""} ${names} for 'moda ${command}'.`, [...hints, `Valid flags: ${valid.join(", ") || "(none)"}. Run 'moda ${command} --help'.`].join(" "), `unknown_flag:${unknown[0].replace(/_/g, "-")}`);
   }
   return schema.parse(args);
 }
@@ -8941,7 +8964,7 @@ function assertHandParsedFlags(command, flags, positionals) {
   } catch (error) {
     if (command !== "feedback" || !(error instanceof CliInputError))
       throw error;
-    throw new CliInputError(/nothing was sent/i.test(error.message) ? error.message : `${error.message} Nothing was sent.`, `${error.usage ?? ""} Id flags (--<name>-id=ID) are attached as refs; put other detail in the note. ${FEEDBACK_USAGE}`.trim());
+    throw new CliInputError(/nothing was sent/i.test(error.message) ? error.message : `${error.message} Nothing was sent.`, `${error.usage ?? ""} Id flags (--<name>-id=ID) are attached as refs; put other detail in the note. ${FEEDBACK_USAGE}`.trim(), error.reason);
   }
 }
 var PROFILE_MANAGING_COMMANDS = new Set(["profiles", "auth", "init", "provision", "status", "config", "keys", "manifest", "agent", "doctor"]);
@@ -8975,6 +8998,66 @@ function processingDisabledWarning(data, family) {
     `${family === "emotion" ? "Emotion" : "Frustration"} analysis is disabled for this tenant (${setting} = false), ` + "so zero results do NOT mean users are not frustrated. Enable it in Settings → Account → Signal processing; " + "only traces ingested after enabling are analyzed."
   ];
 }
+var CONTEXT_USAGE = "Usage: moda context <conversation_id> [--msg-index=N] [--window=0-5 | --metadata-only]";
+var CONTEXT_ALL_USAGE = "Usage: moda context <conversation_id> --all [--from=N] [--max-messages=N]";
+var CONTEXT_MAX_WINDOW = 5;
+var EMPTY_ANCHOR_VALUES = new Set(["", "null", "undefined", "none"]);
+function parseContextRequest(positional, rawFlags) {
+  const flags = {};
+  const flagIds = [];
+  for (const [rawKey, value] of Object.entries(rawFlags)) {
+    const key = rawKey.replace(/_/g, "-");
+    if (key === "conversation-id") {
+      if (value !== "true")
+        flagIds.push(value);
+    } else if (flags[key] !== undefined && flags[key] !== value) {
+      throw new CliInputError(`Got two different values for --${key} (both spellings were passed), so nothing was read.`, CONTEXT_USAGE, "flag_conflict");
+    } else {
+      flags[key] = value;
+    }
+  }
+  const flagId = flagIds[0];
+  const warnings = [];
+  if (new Set([...positional !== undefined ? [positional] : [], ...flagIds]).size > 1) {
+    throw new CliInputError("Got two different trace ids (from the positional and --conversation-id), so nothing was read.", CONTEXT_USAGE, "flag_conflict");
+  }
+  const conversationId = positional ?? flagId;
+  if (!conversationId) {
+    throw new CliInputError("<conversation_id> is required", CONTEXT_USAGE, "missing_positional");
+  }
+  const msgIndex = flags["msg-index"];
+  if (msgIndex !== undefined && EMPTY_ANCHOR_VALUES.has(msgIndex.trim().toLowerCase())) {
+    delete flags["msg-index"];
+    warnings.push(`--msg-index had no value (${JSON.stringify(msgIndex)}), so the window is centered on the middle of the trace. ` + "Trace-level search hits have no message_index; pass one only when the hit has it.");
+  }
+  const args = { ...flagsToArgs(flags), conversation_id: conversationId };
+  const params = parseCommandFlags(ContextSchema, args, "context", { positionalKey: "conversation_id" });
+  if (params.metadata_only === true && params.window !== undefined) {
+    throw new CliInputError("--metadata-only reads no messages, so it cannot be combined with --window; drop --window.", CONTEXT_USAGE, "flag_conflict");
+  }
+  if (params.all === true) {
+    if (params.msg_index !== undefined || flags.window !== undefined || params.metadata_only === true) {
+      throw new CliInputError("--all reads the whole trace; drop --msg-index/--window/--metadata-only.", CONTEXT_ALL_USAGE, "flag_conflict");
+    }
+  } else if (params.from !== undefined || params.max_messages !== undefined) {
+    throw new CliInputError("--from and --max-messages page the whole trace and need --all.", CONTEXT_ALL_USAGE, "flag_conflict");
+  }
+  return { params, warnings };
+}
+async function readContextMetadataOnly(contextPath, query2) {
+  try {
+    return await callDataAPI(`${contextPath}?${query2.toString()}`);
+  } catch (error) {
+    if (!(error instanceof ApiError) || error.statusCode !== 400 || !/metadata_only/.test(error.message))
+      throw error;
+    const legacy = new URLSearchParams(query2);
+    legacy.delete("metadata_only");
+    legacy.set("window", "0");
+    const data = asRecord(await callDataAPI(`${contextPath}?${legacy.toString()}`)) ?? {};
+    const ctx = asRecord(data.context) ?? {};
+    return { ...data, metadata_only: true, context: { ...ctx, messages: [] } };
+  }
+}
 var FULL_TRANSCRIPT_DEFAULT_MAX_MESSAGES = 500;
 var CONTEXT_RANGE_PAGE_SIZE = 200;
 var LEGACY_WINDOW_MAX_MESSAGES = 100;
@@ -9001,7 +9084,6 @@ function pageMessages(page) {
   const messages = asRecord(page.context)?.messages ?? page.messages;
   return (Array.isArray(messages) ? messages : []).map((m) => asRecord(m) ?? {});
 }
-var CONTEXT_MAX_WINDOW = 5;
 var CONTEXT_ALL_MAX_MESSAGES = 5000;
 async function readFullTranscript(conversationId, opts = {}) {
   const start = opts.from ?? 0;
@@ -9360,40 +9442,37 @@ async function runCommand(command, positional, flags, positionals = positional ?
       break;
     }
     case "context": {
-      if (!positional) {
-        throw new CliInputError("<conversation_id> is required", "Usage: moda context <conversation_id> [--msg-index=N] [--window=N]");
-      }
-      const args = flagsToArgs(flags, "conversation_id", positional);
-      const params = parseCommandFlags(ContextSchema, args, command, { positionalKey: "conversation_id" });
+      const { params, warnings: inputWarnings } = parseContextRequest(positional, flags);
       if (params.all === true) {
-        if (params.msg_index !== undefined || flags.window !== undefined) {
-          throw new CliInputError("--all reads the whole trace; drop --msg-index/--window.", "Usage: moda context <conversation_id> --all [--from=N] [--max-messages=N]");
-        }
         const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
         const full = await readFullTranscript(params.conversation_id, {
           from: params.from,
           maxMessages: params.max_messages,
           fits: agentMode ? (page) => agentEnvelopeFits(command, page.data, { warnings: page.warnings, nextCommands: page.nextCommands }) : undefined
         });
+        const fullWarnings = [...inputWarnings, ...full.warnings];
         context.output.writeData(full.data, {
-          ...full.warnings.length > 0 ? { warnings: full.warnings } : {},
+          ...fullWarnings.length > 0 ? { warnings: fullWarnings } : {},
           ...full.nextCommands.length > 0 ? { nextCommands: full.nextCommands } : {}
         });
         break;
       }
-      if (params.from !== undefined || params.max_messages !== undefined) {
-        throw new CliInputError("--from and --max-messages page the whole trace and need --all.", "Usage: moda context <conversation_id> --all [--from=N] [--max-messages=N]");
-      }
       const query2 = new URLSearchParams;
       if (params.msg_index !== undefined)
         query2.set("msg_index", params.msg_index.toString());
+      if (params.metadata_only === true)
+        query2.set("metadata_only", "1");
       const window = params.window === undefined ? undefined : Math.min(params.window, CONTEXT_MAX_WINDOW);
       if (window !== undefined)
         query2.set("window", window.toString());
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
-      const data = await callDataAPI(`/conversations/${params.conversation_id}/context${queryString}`);
+      const contextPath = `/conversations/${encodeURIComponent(params.conversation_id)}/context`;
+      const data = params.metadata_only === true ? await readContextMetadataOnly(contextPath, query2) : await callDataAPI(`${contextPath}${queryString}`);
       const ctxRecord = asRecord(data) ?? {};
-      const warnings = notFoundWarning("trace", params.conversation_id, asNumber(ctxRecord.total_messages) === 0);
+      const warnings = [
+        ...inputWarnings,
+        ...notFoundWarning("trace", params.conversation_id, asNumber(ctxRecord.total_messages) === 0)
+      ];
       const nextCommands = [];
       if (params.window !== undefined && params.window > CONTEXT_MAX_WINDOW) {
         const center = asNumber(asRecord(ctxRecord.context)?.center_index) ?? params.msg_index ?? 0;
@@ -10147,7 +10226,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result",
     handler: async (context) => {
-      const { runInit } = await import("./index-z0jpjcsm.js");
+      const { runInit } = await import("./index-pykaaezb.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -10188,7 +10267,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-qkazpt0c.js");
+      const { runProvision } = await import("./provision-d1dfj6as.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -10652,6 +10731,7 @@ var commandRegistry = createCommandRegistry([
     examples: [
       "moda context <conversation_id> --window=3",
       "moda context <conversation_id> --msg-index=40 --window=0",
+      "moda context <conversation_id> --metadata-only   # summary + total_messages, no messages",
       "moda context <conversation_id> --all",
       "moda context <conversation_id> --all --from=500 --max-messages=500"
     ],
@@ -11062,7 +11142,15 @@ var commandRegistry = createCommandRegistry([
   }
 ]);
 function classifyCliError(error) {
-  if (error instanceof z2.ZodError || error instanceof CliInputError || error instanceof CliInputRequiredError || error instanceof CliAuthError || error instanceof CliAccessError) {
+  if (error instanceof CliAuthError)
+    return "auth_error";
+  if (error instanceof CliAccessError)
+    return "access_error";
+  if (error instanceof ApiError && error.statusCode === 401)
+    return "auth_error";
+  if (error instanceof ApiError && error.statusCode === 403)
+    return "access_error";
+  if (error instanceof z2.ZodError || error instanceof CliInputError || error instanceof CliInputRequiredError) {
     return "validation_error";
   }
   if (error instanceof ApiError || isApiLikeError(error)) {
@@ -11073,6 +11161,21 @@ function classifyCliError(error) {
   }
   return "unknown_error";
 }
+function cliValidationReason(error) {
+  if (error instanceof z2.ZodError) {
+    const issue = error.issues[0];
+    if (!issue)
+      return "zod";
+    const path = issue.path.join(".") || "_";
+    return issue.code === "invalid_enum_value" ? `bad_enum:${path}` : `zod:${path}:${issue.code}`;
+  }
+  if (error instanceof CliInputRequiredError)
+    return "input_required";
+  if (error instanceof CliInputError) {
+    return error.reason ?? (/^<[^>]+> is required/.test(error.message) ? "missing_positional" : "input_error");
+  }
+  return;
+}
 function printCliError(error) {
   if (error instanceof CliInputError) {
     safeWriteStderr(`Error: ${error.message}
@@ -11256,6 +11359,7 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
           flags: commandFlags,
           status: "error",
           errorType: classifyCliError(error),
+          validationReason: cliValidationReason(error),
           exitCode: exitCodeForError(error),
           durationMs: Date.now() - startedAt,
           apiRequestCount: getApiRequestCount(),
@@ -11316,6 +11420,7 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
         flags: commandFlags,
         status: "error",
         errorType: classifyCliError(error),
+        validationReason: cliValidationReason(error),
         exitCode: exitCodeForError(error),
         durationMs: Date.now() - startedAt,
         apiRequestCount: getApiRequestCount(),
@@ -11383,6 +11488,7 @@ export {
   runCommand,
   resolveTailSignal,
   printCliError,
+  parseContextRequest,
   parseCommandFlags,
   parseArgs,
   initFlagsForContext,
@@ -11391,6 +11497,7 @@ export {
   detectCallerAgent,
   describeLinearLink,
   commandRegistry,
+  cliValidationReason,
   classifyCliError,
   capProblemsBlocks,
   buildResumeCommand,
@@ -11398,5 +11505,6 @@ export {
   TAIL_LIMITS,
   LEGACY_WINDOW_MAX_MESSAGES,
   FULL_TRANSCRIPT_DEFAULT_MAX_MESSAGES,
-  CliInputError
+  CliInputError,
+  CONTEXT_MAX_WINDOW
 };

package/dist/{harness-github-actions-q9kewzb6.js → harness-github-actions-gbty3k66.js}

@@ -1,7 +1,7 @@
 import {
   buildSourceSnapshot
-} from "./cli-x0x0n35w.js";
-import"./cli-xrs02c0t.js";
+} from "./cli-he2wb4hd.js";
+import"./cli-ac3p2byq.js";
 import"./cli-0v6na3yp.js";
 
 // src/harness-github-actions.ts

package/dist/{harness-7gr0xbtc.js → harness-s13wvdxt.js}

@@ -42,8 +42,8 @@ import {
   writeHarnessAnalyzeResult,
   writeHarnessArtifacts,
   writeHumanProgress
-} from "./cli-x0x0n35w.js";
-import"./cli-xrs02c0t.js";
+} from "./cli-he2wb4hd.js";
+import"./cli-ac3p2byq.js";
 import"./cli-0v6na3yp.js";
 export {
   writeHumanProgress,

package/dist/{index-z0jpjcsm.js → index-pykaaezb.js}

@@ -3,7 +3,7 @@ import {
   initPrompts,
   runPromptSync,
   runSkillSync
-} from "./cli-jqfm8dp4.js";
+} from "./cli-ha40mgy1.js";
 import {
   codingAgentDisplayName,
   describeCodingAgentEvent,
@@ -22,7 +22,7 @@ import {
   runHarnessCommand,
   startRemoteAnalyze,
   stripAnsi
-} from "./cli-x0x0n35w.js";
+} from "./cli-he2wb4hd.js";
 import {
   bundledSkillsDir,
   installIntegrationSkill,
@@ -34,14 +34,14 @@ import {
 } from "./cli-ssfq84k5.js";
 import {
   selectTenantAndCreateKey
-} from "./cli-h4k23fb0.js";
+} from "./cli-sq6g0tk5.js";
 import {
   ConnectCodeError,
   connectWithCode,
   loadAuthSession,
   loadToken,
   login
-} from "./cli-7kbzqact.js";
+} from "./cli-kxwm7y62.js";
 import {
   CliAuthError,
   CliInputError,
@@ -49,7 +49,7 @@ import {
   createCommandContext,
   resolveIngestUrl,
   resolveModaBaseUrl
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import"./cli-0v6na3yp.js";
 
 // src/init/index.ts

package/dist/prompt-source-mcp.js

@@ -5,8 +5,8 @@ import {
   inspectCodeSelectors,
   inspectPythonSelectors,
   safePromptEvidencePath
-} from "./cli-x0x0n35w.js";
-import"./cli-xrs02c0t.js";
+} from "./cli-he2wb4hd.js";
+import"./cli-ac3p2byq.js";
 import {
   __commonJS,
   __toESM

package/dist/{provision-qkazpt0c.js → provision-d1dfj6as.js}

@@ -1,15 +1,15 @@
 import {
   selectTenantAndCreateKey
-} from "./cli-h4k23fb0.js";
+} from "./cli-sq6g0tk5.js";
 import {
   loadAuthSession
-} from "./cli-7kbzqact.js";
+} from "./cli-kxwm7y62.js";
 import {
   CliAuthError,
   resolveIngestUrl,
   resolveModaBaseUrl,
   stringOption
-} from "./cli-xrs02c0t.js";
+} from "./cli-ac3p2byq.js";
 import"./cli-0v6na3yp.js";
 
 // src/provision.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.50.0",
+  "version": "1.52.0",
   "description": "CLI for Moda - AI agent analytics and observability",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-10-10T14:07:17.742Z",
-  "cli_version": "1.50.0",
+  "bundled_at": "2026-10-12T06:24:12.441Z",
+  "cli_version": "1.52.0",
   "skills": [
     {
       "id": "integration-cloudflare-think",

package/skills/moda-cli/SKILL.md

@@ -458,6 +458,8 @@ fail instead of being clamped.
 time window. On `context`, `--window=0` returns only the anchor message (plus
 `total_messages`), and a value above 5 is clamped to 5 with a warning that
 prints the `--all --from --max-messages` command for a wider slice.
+`--metadata-only` returns only the summary and `total_messages`, with no
+messages.
 
 ### Schema introspection
 
@@ -546,11 +548,13 @@ compare scores across modes.
 Hand the anchors straight to `moda context`:
 
 ```bash
-# Find, then read the exact turn
-hit=$(moda search "double charge" --limit=1 | jq -r '.results[0]')
+# Find, then read the exact turn. --json prints the bare payload; piped output
+# without it is the agent envelope, where results sit under .data.results.
+hit=$(moda search "double charge" --limit=1 --json | jq -c '.results[0] // empty')
 cid=$(echo "$hit" | jq -r '.conversation_id')
-idx=$(echo "$hit" | jq -r '.message_index')
-moda context "$cid" --msg-index="$idx"
+# Trace-level fallback hits (match_grain: "trace") have no message_index.
+idx=$(echo "$hit" | jq -r '.message_index // empty')
+moda context "$cid" ${idx:+--msg-index="$idx"}
 ```
 
 ### 2. Overview (start here for health questions)
@@ -647,6 +651,7 @@ moda context <conversation_id>                # default window around middle
 moda context <conversation_id> --msg-index=5  # center on message 5
 moda context <conversation_id> --window=3     # 3 messages each side (max 5)
 moda context <conversation_id> --msg-index=40 --window=0  # just message 40 + total_messages
+moda context <conversation_id> --metadata-only  # summary + total_messages, no messages
 moda context <conversation_id> --all          # whole trace in order, first 500 messages
 moda context <conversation_id> --all --from=500 --max-messages=500  # continue (max 5000)
 ```
@@ -1128,16 +1133,17 @@ and archiving an active custom signal (pause it, or delete a draft).
 
 ```bash
 # Semantic: find the moment a user expressed an intent, in their own words
-moda search "user wants to cancel subscription" --mode=semantic --limit=5 \
+moda search "user wants to cancel subscription" --mode=semantic --limit=5 --json \
   | jq -r '.results[] | "\(.conversation_id) @\(.message_index)  \(.snippet)"'
 
 # Keyword: locate every tool call/result mentioning an exact identifier
 moda search "stripe.refunds.create" --mode=keyword --limit=10
 
-# Search, then open the top hit at the exact turn
-moda search "rate limit exceeded" --limit=1 \
-  | jq -r '.results[0] | "\(.conversation_id) \(.message_index)"' \
-  | xargs -n2 sh -c 'moda context "$0" --msg-index="$1"'
+# Search, then open the top message-level hit at the exact turn (skips
+# trace-level fallback hits, which have no message_index)
+moda search "rate limit exceeded" --limit=5 --json \
+  | jq -r 'first(.results[] | select(.message_index != null)) | "\(.conversation_id) \(.message_index)"' \
+  | xargs -r -n2 sh -c 'moda context "$0" --msg-index="$1"'
 ```
 
 ### Daily health check