@moda-ai/cli 1.55.4 → 1.55.6

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   runPromptsCommand,
   runSkillsCommand,
   runStatusCommand
-} from "./cli-73v8mqh1.js";
+} from "./cli-grn40kvh.js";
 import"./cli-mm48br00.js";
 import {
   ApiError,
@@ -20,7 +20,6 @@ import {
   assertPositionals,
   callControlAPI,
   callDataAPI,
-  getApiRequestCount,
   graphForSync,
   hashHarnessReport,
   hashStableJson,
@@ -28,7 +27,6 @@ import {
   readHarnessReport,
   readHarnessSyncState,
   renderMarkdownForTerminal,
-  resetApiRequestCount,
   runHarnessCommand,
   runProblemReopenCommand,
   runSignalsManagementCommand,
@@ -41,7 +39,7 @@ import {
   terminalStyles,
   unknownSignalsSubcommandError,
   validateHarnessReport
-} from "./cli-9v0c1xe1.js";
+} from "./cli-gxmq4wmn.js";
 import"./cli-ssfq84k5.js";
 import {
   authFetch,
@@ -50,7 +48,7 @@ import {
   loadAuthSession,
   login,
   revokeCliSessionToken
-} from "./cli-t5v7mhvj.js";
+} from "./cli-tw8jj190.js";
 import {
   AGENT_ERROR_CODES,
   CliAccessError,
@@ -79,11 +77,15 @@ import {
   ensureSecretFilePermissions,
   explicitOutputMode,
   getActiveProfile,
+  getApiRequestCount,
   getModaDir,
   getModaPaths,
   isApiLikeError,
   isNetworkLikeError,
   loadProfileConfig,
+  parseBooleanFlagValue,
+  recordApiRequest,
+  resetApiRequestCount,
   resolveApiKey,
   resolveApiKeyFromActiveProfile,
   resolveApiTenantId,
@@ -101,7 +103,7 @@ import {
   validateConfig,
   wasOutputCancelled,
   writeSecretJsonFile
-} from "./cli-zp7a97sp.js";
+} from "./cli-mx9r1689.js";
 import {
   __require
 } from "./cli-0v6na3yp.js";
@@ -112,9 +114,21 @@ import { z as z2 } from "zod";
 
 // src/schemas.ts
 import { z } from "zod";
-var boolFlag = () => z.preprocess((val) => val === "true" ? true : val === "false" ? false : val, z.boolean()).optional();
+var boolFlag = () => 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 DAYS_BACK_MESSAGE = "must be a whole number from 1 to 90 (e.g. --days-back=7)";
+var daysBackFlag = (fallback) => {
+  const days = z.number({ invalid_type_error: DAYS_BACK_MESSAGE }).int(DAYS_BACK_MESSAGE).min(1, DAYS_BACK_MESSAGE).max(90, DAYS_BACK_MESSAGE);
+  return fallback === undefined ? days.optional() : days.default(fallback).optional();
+};
 var OverviewSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional()
+  days_back: daysBackFlag(7)
 });
 var ClustersSchema = z.object({
   parent_id: z.string().optional(),
@@ -154,25 +168,17 @@ 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().min(1),
   msg_index: z.number().int().min(0).optional(),
   window: z.number().int().min(0).optional(),
-  metadata_only: lenientBoolFlag(),
-  all: lenientBoolFlag(),
+  metadata_only: boolFlag(),
+  all: boolFlag(),
   from: z.number().int().min(0).optional(),
   max_messages: z.number().int().min(1).max(5000).optional()
 });
 var FrustrationsSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional(),
+  days_back: daysBackFlag(7),
   limit: z.number().min(1).max(20).default(10).optional(),
   offset: z.number().min(0).default(0).optional(),
   include_window: boolFlag(),
@@ -181,10 +187,10 @@ var FrustrationsSchema = z.object({
   conversation_id: z.string().min(1).max(256).optional()
 });
 var ToolFailuresSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional()
+  days_back: daysBackFlag(7)
 });
 var ProblemsSchema = z.object({
-  days_back: z.number().min(1).max(90).default(30).optional(),
+  days_back: daysBackFlag(30),
   limit: z.number().min(1).max(25).default(25).optional()
 });
 var REMAINDER_FAMILIES = [
@@ -197,7 +203,7 @@ var REMAINDER_FAMILIES = [
   "conversation_reader"
 ];
 var ProblemsRemainderSchema = z.object({
-  days_back: z.number().min(1).max(90).default(30).optional(),
+  days_back: daysBackFlag(30),
   limit: z.number().min(1).max(25).default(25).optional(),
   family: z.enum(REMAINDER_FAMILIES).optional(),
   cursor: z.string().min(1).max(4096).optional()
@@ -264,7 +270,7 @@ var ProblemLinearFileSchema = z.object({
 var SignalSchema = z.object({
   id: z.string().min(1).max(255),
   detections: boolFlag(),
-  days_back: z.number().min(1).max(90).optional(),
+  days_back: daysBackFlag(),
   limit: z.number().min(1).max(20).optional(),
   offset: z.number().min(0).max(1e4).optional()
 });
@@ -335,7 +341,7 @@ var EMOTION_FAMILIES = [
   "positive"
 ];
 var EmotionsSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional(),
+  days_back: daysBackFlag(7),
   limit: z.number().min(1).max(20).default(10).optional(),
   offset: z.number().min(0).max(1e4).optional(),
   family: z.enum(EMOTION_FAMILIES).optional(),
@@ -343,7 +349,7 @@ var EmotionsSchema = z.object({
   conversation_id: z.string().min(1).max(256).optional()
 });
 var HallucinationsSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional(),
+  days_back: daysBackFlag(7),
   limit: z.number().min(1).max(20).default(10).optional(),
   offset: z.number().min(0).max(1e4).optional(),
   conversation_id: z.string().max(200).optional(),
@@ -371,7 +377,7 @@ var LAZINESS_FAMILIES = [
   "data_regression"
 ];
 var LazinessSchema = z.object({
-  days_back: z.number().min(1).max(90).default(7).optional(),
+  days_back: daysBackFlag(7),
   limit: z.number().min(1).max(50).default(10).optional(),
   offset: z.number().min(0).max(1e4).optional(),
   conversation_id: z.string().max(200).optional(),
@@ -392,7 +398,7 @@ var TailSchema = z.object({
 var ToolFailureDetailSchema = z.object({
   tool_name: z.string(),
   subtype: z.string().optional(),
-  days_back: z.number().min(1).max(90).default(7).optional(),
+  days_back: daysBackFlag(7),
   limit: z.number().min(1).max(20).default(5).optional(),
   offset: z.number().min(0).default(0).optional(),
   include_window: boolFlag(),
@@ -819,8 +825,12 @@ async function runFixesCommand(context) {
       throw new CliInputError(`Unknown fixes subcommand '${context.positional}'`, FIX_USAGE);
   }
   const query = new URLSearchParams;
-  if (context.flags.status)
-    query.set("status", context.flags.status);
+  const status = (context.flags.status ?? "").trim().toUpperCase();
+  if (context.flags.status !== undefined && !status) {
+    throw new CliInputError("--status must name a fix status.", FIX_USAGE);
+  }
+  if (status)
+    query.set("status", status);
   if (context.flags.limit) {
     const limit = Number(context.flags.limit);
     if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
@@ -3465,6 +3475,8 @@ import { randomUUID } from "node:crypto";
 var TELEMETRY_TIMEOUT_MS = 500;
 var INVOCATION_ID = randomUUID();
 var TELEMETRY_FLAG = "no-telemetry";
+var MAX_TELEMETRY_DURATION_MS = 86400000;
+var MAX_TELEMETRY_API_REQUEST_COUNT = 1e6;
 var SEARCH_SURFACE_BY_COMMAND = {
   search: "message",
   conversations: "conversation",
@@ -3506,7 +3518,7 @@ function buildSearchAdoptionTelemetry(input) {
     adoption.search_mode_requested = SEARCH_MODES2.includes(requested) ? requested : "hybrid";
   }
   if (command === "context") {
-    adoption.used_msg_index = flags["msg-index"] !== undefined ? 1 : 0;
+    adoption.used_msg_index = flags["msg-index"] !== undefined || flags["message-index"] !== undefined ? 1 : 0;
   }
   if (recorded.search_mode_effective) {
     adoption.search_mode_effective = recorded.search_mode_effective;
@@ -3584,7 +3596,7 @@ async function sendCliUsageTelemetry(input) {
     timeout.unref();
   }
   try {
-    await fetch(`${resolveModaBaseUrl()}/api/v1/data/cli-usage`, {
+    await fetch(`${resolveModaBaseUrl({ profile: input.profile })}/api/v1/data/cli-usage`, {
       method: "POST",
       headers: {
         ...apiKeyHeaders(input.apiKey),
@@ -3597,8 +3609,8 @@ async function sendCliUsageTelemetry(input) {
         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)),
+        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,
@@ -4818,6 +4830,7 @@ function redactApiKey(key) {
 async function probeApiKey(key, options = {}) {
   let response;
   try {
+    recordApiRequest();
     response = await fetch(`${resolveModaBaseUrl(options)}/api/v1/data/overview`, {
       method: "GET",
       headers: apiKeyHeaders(key, options),
@@ -6161,6 +6174,7 @@ async function streamAsk(options) {
     const fetchImpl = options.fetchImpl ?? fetch;
     let response;
     try {
+      recordApiRequest();
       response = await fetchImpl(url, {
         method: "POST",
         headers: {
@@ -6220,7 +6234,7 @@ var ASK_SCHEMA_VERSION = "production_ask.v0.1";
 var INVESTIGATION_PROBLEM_LIMIT = 3;
 var INVESTIGATION_PROBLEM_SLOTS = INVESTIGATION_PROBLEM_LIMIT;
 async function runProductionCommand(context) {
-  const daysBack = daysBackFlag(context.flags);
+  const daysBack = daysBackFlag2(context.flags);
   if (context.command === "overview") {
     const briefing = await loadOverviewBriefing({ daysBack, cwd: context.cwd });
     if (context.flags.raw === "true") {
@@ -7555,7 +7569,7 @@ function numberValue(value) {
   }
   return 0;
 }
-function daysBackFlag(flags, fallback = 7) {
+function daysBackFlag2(flags, fallback = 7) {
   const raw = flags["days-back"];
   if (raw === undefined)
     return fallback;
@@ -7810,8 +7824,64 @@ function parseArgs(argv) {
     ...bareFlags.length > 0 ? { bareFlags } : {}
   };
 }
-var DRY_RUN_TRUE = new Set(["true", "yes", "1", "on"]);
-var DRY_RUN_FALSE = new Set(["false", "no", "0", "off"]);
+var RAW_BOOLEAN_FLAGS = new Set([
+  "dry-run",
+  "yes",
+  "live",
+  "local",
+  "watch",
+  "promote",
+  "no-promote",
+  "promote-on-win",
+  "undo",
+  "all",
+  "wait",
+  "no-wait",
+  "wait-for-completion",
+  "summary",
+  "list",
+  "save",
+  "sync",
+  "replay",
+  "no-replay",
+  "remote",
+  "no-remote",
+  "raw",
+  "pr",
+  "packet",
+  "transcript",
+  "gate",
+  "discover",
+  "experimental",
+  "force",
+  "force-reprocess",
+  "reprocess-segments",
+  "online",
+  "offline",
+  "progress",
+  "stream",
+  "no-stream",
+  "quiet",
+  "verbose",
+  "allow-untrack",
+  "github-actions",
+  "no-clustering",
+  "no-analyze",
+  "improve-candidates",
+  "hook-stdin",
+  "auto-generate",
+  "allow-no-agents",
+  "allow-any-model",
+  "json",
+  "human",
+  "prose",
+  "json-schemas",
+  "help",
+  "tui",
+  "no-tui",
+  "no-telemetry",
+  "no-update-check"
+]);
 var GLOBAL_BOOLEAN_FLAGS = new Set([
   "agent",
   "json",
@@ -7828,6 +7898,20 @@ var GLOBAL_BOOLEAN_FLAGS = new Set([
   "tui",
   "no-tui"
 ]);
+var BOOLEAN_WORDS = new Set(["true", "false", "yes", "no", "on", "off"]);
+var META_SWITCHES = new Set([
+  "json",
+  "human",
+  "prose",
+  "quiet",
+  "verbose",
+  "help",
+  "json-schemas",
+  "tui",
+  "no-tui",
+  "no-telemetry",
+  "no-update-check"
+]);
 var COMMAND_BOOLEAN_FLAGS = {
   context: new Set(["all", "metadata-only"])
 };
@@ -7852,7 +7936,15 @@ function parseFlag(args, index, flags, beforeCommand, bareFlags, command = "") {
     set(key, "true", true);
     return index;
   }
-  if (!beforeCommand && COMMAND_BOOLEAN_FLAGS[command]?.has(key.replace(/_/g, "-")) && next !== "true" && next !== "false") {
+  const switchName = key.replace(/_/g, "-");
+  if (META_SWITCHES.has(switchName)) {
+    set(key, "true", true);
+    return index;
+  }
+  const idFollows = COMMAND_BOOLEAN_FLAGS[command]?.has(switchName) === true;
+  const isSwitch = RAW_BOOLEAN_FLAGS.has(switchName) || idFollows;
+  const takesNext = BOOLEAN_WORDS.has(next?.toLowerCase() ?? "") || !idFollows && (next === "0" || next === "1");
+  if (!beforeCommand && isSwitch && !takesNext) {
     set(key, "true", true);
     return index;
   }
@@ -8022,11 +8114,11 @@ Options:
   --version                        Show version number
   --json-schemas                   Print JSON Schemas for the agent output contract
 
-Common flags:
-  --days-back=N                    Number of days to look back (1-90)
-  --limit=N                        Maximum results to return
-  --offset=N                       Number of results to skip
-  --time-range=RANGE               Time range filter (all|1h|3d|7d|24h|30d|90d)
+Common flags (a command rejects any it does not take; see 'moda <command> --help'):
+  --days-back=N                    Whole days to look back, 1-90 (overview, problems, emotions, laziness, tool-failures, ...)
+  --time-range=RANGE               Window for traces, search, clusters instead (all|1h|3d|7d|24h|30d|90d)
+  --limit=N                        Maximum results to return (users: alias of --page-size)
+  --offset=N                       Number of results to skip (paged lists)
   --profile=NAME                   Use a named local Moda profile
   --json                           Emit machine-readable JSON
   --agent                          Emit schema-versioned agent JSON
@@ -8313,7 +8405,7 @@ function printCommandHelp(definition) {
       lines.push(`  ${example}`);
     }
   }
-  lines.push("", "Run 'moda --help' for the full command list and common flags", "(--json, --agent, --profile, --days-back, --limit, --time-range, ...).");
+  lines.push("", "Run 'moda --help' for the full command list and the output flags every command", "takes (--json, --agent, --human, --profile). Window and paging flags (--days-back,", "--time-range, --limit, --offset) differ by command; an unsupported one is rejected.");
   console.log(lines.join(`
 `));
 }
@@ -8756,6 +8848,12 @@ var WINDOW_FLAG_HINTS = {
   days_back: "This command takes --time-range (e.g. --time-range=7d), not --days-back.",
   time_range: "This command takes --days-back=N (1-90), not --time-range."
 };
+var COMMAND_FLAG_HINTS = {
+  problems: {
+    family: "'moda problems' ranks every family together. To filter by family use 'moda problems remainder --family=<family>' " + "(signals no Problem explains yet) or 'moda problem <problem_id> --traces --family=<family>' (one Problem's traces).",
+    cursor: "'moda problems' has no cursor; 'moda problems remainder --cursor=<next_cursor>' pages the unexplained signals."
+  }
+};
 function editDistance(a, b) {
   const row = Array.from({ length: b.length + 1 }, (_, index) => index);
   for (let i = 1;i <= a.length; i++) {
@@ -8789,6 +8887,9 @@ function parseCommandFlags(schema, args, command, options = {}) {
     const flagKeys = schemaKeys.filter((key) => key !== options.positionalKey);
     const valid = flagKeys.map((key) => `--${key.replace(/_/g, "-")}`);
     const hints = unknown.map((key) => {
+      const commandHint = COMMAND_FLAG_HINTS[command]?.[key];
+      if (commandHint)
+        return commandHint;
       const windowAlternative = key === "days_back" ? "time_range" : key === "time_range" ? "days_back" : undefined;
       if (windowAlternative && WINDOW_FLAG_HINTS[key] && flagKeys.includes(windowAlternative))
         return WINDOW_FLAG_HINTS[key];
@@ -8816,6 +8917,30 @@ function shellArg(value) {
     return `"${value}"`;
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
+function semanticIndexCoverage(coverage) {
+  const ratio = asRecord(asRecord(coverage)?.semantic_index)?.coverage_ratio;
+  if (typeof ratio !== "number" || !Number.isFinite(ratio) || ratio < 0 || ratio > 1)
+    return;
+  return `${Number((ratio * 100).toFixed(1))}%`;
+}
+function searchDegradeWarning(reason, requestedMode, coverage) {
+  const lead = `Search degraded to keyword mode (${reason}):`;
+  const notComparable = "keyword scores are not comparable to semantic scores";
+  switch (reason) {
+    case "semantic_unavailable":
+      return `${lead} the requested ${requestedMode} ranking did not run, and ${notComparable}. Retry, or use --mode=keyword with exact identifiers.`;
+    case "semantic_index_empty":
+      return `${lead} the semantic index has no embeddings for this tenant in this time window, so the requested ${requestedMode} ranking cannot run and a retry will not help. ` + `The results are keyword matches (${notComparable}); use --mode=keyword with exact identifiers.`;
+    case "semantic_index_partial": {
+      const percent = semanticIndexCoverage(coverage);
+      return `${lead} the semantic index covers ${percent ? `only ${percent}` : "only part"} of the messages in this time window, so the requested ${requestedMode} ranking did not run and a retry will not help. ` + `The results are keyword matches (${notComparable}); use --mode=keyword with exact identifiers.`;
+    }
+    case "below_relevance_floor":
+      return `${lead} no semantic hit cleared the relevance floor, so the requested ${requestedMode} ranking returned nothing and these are keyword matches (${notComparable}). ` + "Rephrase the query, or use --mode=keyword with exact identifiers.";
+    default:
+      return `${lead} the requested ${requestedMode} ranking did not run, and ${notComparable}. Use --mode=keyword with exact identifiers.`;
+  }
+}
 function searchCoverageWarnings(coverage, timeRange) {
   const record = asRecord(coverage);
   if (!record)
@@ -9008,6 +9133,24 @@ function assertHandParsedFlags(command, flags, positionals) {
     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);
   }
 }
+function normalizeBooleanFlags(target) {
+  let error;
+  for (const [key, raw] of Object.entries(target)) {
+    const name = key.replace(/_/g, "-");
+    if (!RAW_BOOLEAN_FLAGS.has(name))
+      continue;
+    const value = parseBooleanFlagValue(raw);
+    if (value === undefined) {
+      error ??= new CliInputError(`--${name}=${raw} is not a yes/no value, so nothing was run.`, `--${name} is a switch: pass --${name}, or --${name}=true|false (also 1|0, yes|no, on|off).`, `bad_boolean:${name}`);
+      continue;
+    }
+    if (name === "dry-run" && !value)
+      delete target[key];
+    else
+      target[key] = value ? "true" : "false";
+  }
+  return error;
+}
 var PROFILE_MANAGING_COMMANDS = new Set(["profiles", "auth", "init", "provision", "status", "config", "keys", "manifest", "agent", "doctor"]);
 async function runProblemsRemainder(flags, context) {
   const params = parseCommandFlags(ProblemsRemainderSchema, flagsToArgs(flags), "problems remainder");
@@ -9039,15 +9182,17 @@ 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_USAGE = "Usage: moda context <conversation_id> [--msg-index=N (alias --message-index)] [--window=0-5 | --metadata-only]";
 var CONTEXT_ALL_USAGE = "Usage: moda context <conversation_id> --all [--from=N] [--max-messages=N]";
+var CONTEXT_FLAG_ALIASES = { "message-index": "msg-index" };
 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, "-");
+    const kebab = rawKey.replace(/_/g, "-");
+    const key = CONTEXT_FLAG_ALIASES[kebab] ?? kebab;
     if (key === "conversation-id") {
       if (value !== "true")
         flagIds.push(value);
@@ -9404,7 +9549,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
       const actualMode = asString(searchRecord.search_mode);
       const warnings = [];
       if (degradeReason && degradeReason !== "none") {
-        warnings.push(`Search degraded to keyword mode (${degradeReason}): the requested ${params.mode ?? "hybrid"} ranking did not run, and keyword scores are not comparable to semantic scores. Retry, or use --mode=keyword with exact identifiers.`);
+        warnings.push(searchDegradeWarning(degradeReason, params.mode ?? "hybrid", searchRecord.coverage));
       } else if (params.mode && actualMode && actualMode !== params.mode && params.mode !== "hybrid") {
         warnings.push(`Search ran in ${actualMode} mode instead of the requested ${params.mode} mode.`);
       }
@@ -10041,6 +10186,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         const kinds = { quote: "frustration_quote", tool: "tool_call", laziness: "laziness", hallucination: "hallucination", "custom-signal": "custom_signal" };
         const query2 = new URLSearchParams;
         if (flags.kind !== undefined) {
+          if (flags.kind === "problem" || flags.kind === "problem-detection") {
+            throw new CliInputError(`'moda false-positives' cannot list --kind=${flags.kind}: ${flags.kind === "problem" ? "a dismissed Problem is recorded as Problem feedback" : "a problem-detection false positive is recorded as a detection review on its Problem"}, not in the false-positive log this command reads. Nothing was sent.`, flags.kind === "problem" ? "Read it with 'moda problem <problem_id> --feedback'. --kind for this list takes " + Object.keys(kinds).join("|") + "." : "Read them per trace with 'moda detection-reviews <conversation_id>' or 'moda false-positives <conversation_id>'. --kind for this list takes " + Object.keys(kinds).join("|") + ".", "unsupported_kind");
+          }
           if (!kinds[flags.kind])
             throw new CliInputError(`--kind must be one of ${Object.keys(kinds).join("|")}`);
           query2.set("kind", kinds[flags.kind]);
@@ -10233,7 +10381,11 @@ function initAgentWriteOptions(result) {
       path: file,
       description: "Created or verified during Moda init."
     })),
-    warnings: manualActions.filter((action) => action.reason).map((action) => `${action.title}: ${action.reason}`)
+    warnings: [
+      ...manualActions.filter((action) => action.reason).map((action) => `${action.title}: ${action.reason}`),
+      ...result.promptSync?.status === "failed" ? [`Prompt sync failed: ${result.promptSync.error}. Retry with 'moda prompts sync'.`] : [],
+      ...result.skillSync?.status === "failed" ? [`Skill sync failed: ${result.skillSync.error}. Retry with 'moda skills sync'.`] : []
+    ]
   };
 }
 function initChangedFiles(setupPlan) {
@@ -10270,7 +10422,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result",
     handler: async (context) => {
-      const { runInit } = await import("./index-8vvznb36.js");
+      const { runInit } = await import("./index-6wxkhbk5.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -10311,7 +10463,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-2z73642d.js");
+      const { runProvision } = await import("./provision-parsn3xg.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -10556,7 +10708,8 @@ var commandRegistry = createCommandRegistry([
     description: "List end users with health, frustration and activity (the dashboard Users page)",
     examples: [
       "moda users --window=30d --sort=health_score --order=asc",
-      "moda users --cohort=frustrated --min-conversations=3"
+      "moda users --cohort=frustrated --min-conversations=3",
+      "moda users --limit=50   # --limit is an alias of --page-size"
     ],
     auth: "api-key",
     outputModes: ["human", "json", "agent"],
@@ -10774,7 +10927,7 @@ var commandRegistry = createCommandRegistry([
     description: "Get windowed trace context (messages around one turn), or the whole trace with --all",
     examples: [
       "moda context <conversation_id> --window=3",
-      "moda context <conversation_id> --msg-index=40 --window=0",
+      "moda context <conversation_id> --msg-index=40 --window=0   # --message-index is an alias",
       "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"
@@ -11195,6 +11348,15 @@ var commandRegistry = createCommandRegistry([
     })
   }
 ]);
+function apiErrorType(status) {
+  if (typeof status !== "number" || status < 400 || status >= 500)
+    return "api_error";
+  if (status === 404)
+    return "api_not_found";
+  if (status === 409)
+    return "api_conflict";
+  return "api_client_error";
+}
 function classifyCliError(error) {
   if (error instanceof CliAuthError)
     return "auth_error";
@@ -11208,7 +11370,7 @@ function classifyCliError(error) {
     return "validation_error";
   }
   if (error instanceof ApiError || isApiLikeError(error)) {
-    return "api_error";
+    return apiErrorType(error.statusCode);
   }
   if (isNetworkLikeError(error)) {
     return "network_error";
@@ -11249,7 +11411,7 @@ function printCliError(error) {
       return `  ${field}: ${e.message}`;
     });
     safeWriteStderr(`Validation error:
-${issues.join(`
+${[...new Set(issues)].join(`
 `)}
 `);
   } else if (error instanceof ApiError && error.readable) {
@@ -11307,6 +11469,7 @@ async function dispatchParsedCommand(parsed, startedAt = Date.now()) {
 }
 async function dispatchParsedCommandInner(parsed, startedAt) {
   const { command, flags } = parsed;
+  const switchError = normalizeBooleanFlags(flags);
   const commandFlags = stripUpdateCheckFlag(stripTelemetryFlag(flags));
   const telemetryDisabled = isTelemetryDisabled(flags);
   const updateCheckDisabled = isUpdateCheckDisabled(flags);
@@ -11337,11 +11500,38 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
     printHelp();
     return 1;
   }
-  const failEarly = (error) => {
+  const failEarly = (error, commandDefinition) => {
     const mode = resolveOutputMode(commandFlags, {
       isTTY: process.stdout.isTTY,
       env: process.env
     });
+    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;
+      sendCliUsageTelemetry({
+        apiKey: resolveApiKey({ profile: telemetryProfile }),
+        profile: telemetryProfile,
+        command: telemetryCommand2,
+        flags: commandFlags,
+        status: "error",
+        errorType: classifyCliError(error),
+        validationReason: cliValidationReason(error),
+        exitCode: 1,
+        durationMs: Date.now() - startedAt,
+        apiRequestCount: 0,
+        adoption: buildSearchAdoptionTelemetry({
+          command: telemetryCommand2,
+          positional: parsed.positional,
+          flags: commandFlags,
+          outputMode: mode,
+          recorded: {},
+          skillVersion: process.env.MODA_SKILL_VERSION,
+          subcommands: commandDefinition.subcommands?.map((subcommand2) => subcommand2.name)
+        })
+      });
+    }
     if (mode === "agent" || mode === "agent-stream" || mode === "json") {
       printAgentCliError(command, error, mode);
     } else {
@@ -11354,30 +11544,19 @@ async function dispatchParsedCommandInner(parsed, startedAt) {
     return failEarly(new CliInputError(`Unknown command '${command}'`, 'Run "moda --help" for usage information.'));
   }
   if (parsed.shortFlags?.length) {
-    return failEarly(new CliInputError(`Short options are not supported (${parsed.shortFlags.join(", ")}), so nothing was run.`, `Use the long form, e.g. --dry-run, --json, --quiet. See 'moda ${command} --help'.`));
-  }
-  for (const target of [flags, commandFlags]) {
-    const raw = target["dry-run"];
-    if (raw === undefined)
-      continue;
-    const value = raw.trim().toLowerCase();
-    if (DRY_RUN_TRUE.has(value))
-      target["dry-run"] = "true";
-    else if (DRY_RUN_FALSE.has(value))
-      delete target["dry-run"];
-    else {
-      return failEarly(new CliInputError(`--dry-run=${raw} is not a yes/no value, so nothing was run.`, "Pass --dry-run (or --dry-run=true) to preview, or omit it to run for real."));
-    }
+    return failEarly(new CliInputError(`Short options are not supported (${parsed.shortFlags.join(", ")}), so nothing was run.`, `Use the long form, e.g. --dry-run, --json, --quiet. See 'moda ${command} --help'.`, "short_flag"), definition);
   }
+  if (switchError)
+    return failEarly(switchError, definition);
   if (commandFlags.profile === "true" || commandFlags.profile === "") {
-    return failEarly(new CliInputError("--profile needs a value, e.g. --profile=prod.", "List profiles with 'moda profiles list'."));
+    return failEarly(new CliInputError("--profile needs a value, e.g. --profile=prod.", "List profiles with 'moda profiles list'.", "missing_value:profile"), definition);
   }
   const requestedProfile = commandFlags.profile ?? process.env.MODA_PROFILE?.trim();
   if (requestedProfile && !PROFILE_MANAGING_COMMANDS.has(definition.name)) {
     const known = Object.keys(loadProfileConfig({ env: process.env }).profiles);
     if (!known.includes(requestedProfile)) {
       const source = commandFlags.profile ? `--profile=${requestedProfile}` : `MODA_PROFILE=${requestedProfile}`;
-      return failEarly(new CliInputError(`Moda profile '${requestedProfile}' does not exist (from ${source}), so nothing was run.`, `Known profiles: ${known.join(", ")}. Create it with 'moda profiles create ${requestedProfile}' or fix the name.`));
+      return failEarly(new CliInputError(`Moda profile '${requestedProfile}' does not exist (from ${source}), so nothing was run.`, `Known profiles: ${known.join(", ")}. Create it with 'moda profiles create ${requestedProfile}' or fix the name.`, "unknown_profile"), definition);
     }
     if (commandFlags.profile)
       process.env.MODA_PROFILE = commandFlags.profile;
@@ -11539,6 +11718,7 @@ if (isMain) {
 export {
   telemetryCommandName,
   stripLoneSurrogates,
+  searchDegradeWarning,
   searchCoverageWarnings,
   runCommand,
   resolveTailSignal,
@@ -11546,6 +11726,7 @@ export {
   parseContextRequest,
   parseCommandFlags,
   parseArgs,
+  normalizeBooleanFlags,
   initFlagsForContext,
   flagsToArgs,
   dispatchParsedCommand,
@@ -11558,8 +11739,10 @@ export {
   buildResumeCommand,
   auditCapStatus,
   TAIL_LIMITS,
+  RAW_BOOLEAN_FLAGS,
   LEGACY_WINDOW_MAX_MESSAGES,
   FULL_TRANSCRIPT_DEFAULT_MAX_MESSAGES,
   CliInputError,
-  CONTEXT_MAX_WINDOW
+  CONTEXT_MAX_WINDOW,
+  CONTEXT_FLAG_ALIASES
 };