@moda-ai/cli 1.55.30 → 1.55.32

package/README.md

@@ -143,7 +143,9 @@ Flag aliases: `moda context --message-index=N` = `--msg-index=N`, and
 `moda users --limit=N` = `--page-size=N`. Each command rejects a flag it does
 not take, and time windows differ by command: `--days-back=N` (a whole number,
 1-90) on the overview, Problem and detection commands, `--time-range` on
-`traces`, `search` and `clusters`. Boolean flags accept `true`/`false`, `1`/`0`,
+`traces`, `search` and `clusters`. The other window spelling is rewritten when
+it names the same span (`--days-back=7` is `--time-range=7d`, `--time-range=30d`
+is `--days-back=30`); one with no exact match fails. Boolean flags accept `true`/`false`, `1`/`0`,
 `yes`/`no` and `on`/`off`.
 
 Prompt management:

package/dist/{agent-wjkgt137.js → agent-e4k17rzy.js}

@@ -1,8 +1,8 @@
 import {
   buildDoctorReport
-} from "./cli-2eqh3150.js";
+} from "./cli-a03st7e3.js";
 import"./cli-9bgnvth2.js";
-import"./cli-6ycf2aj5.js";
+import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import {
   readHarnessSyncState
@@ -94,7 +94,7 @@ async function buildAgentContext(context) {
   const graph = readHarnessGraphIfPresent(context.cwd);
   const reportState = readHarnessReportState(context.cwd);
   const syncState = readHarnessSyncState(context.cwd);
-  const harness = graph ? await import("./harness-8rbsmg8y.js") : undefined;
+  const harness = graph ? await import("./harness-6vwehf47.js") : undefined;
   const topFindings = doctor.checks.filter((check) => check.status === "fail" || check.status === "warning").slice(0, 12).map(checkToFinding);
   const evidenceRefs = [
     ...doctor.checks.map(checkToEvidenceRef),

package/dist/{cli-2eqh3150.js → cli-a03st7e3.js}

@@ -4,7 +4,7 @@ import {
 } from "./cli-9bgnvth2.js";
 import {
   inspectPromptManifest
-} from "./cli-6ycf2aj5.js";
+} from "./cli-zgj5bakm.js";
 import {
   readHarnessSyncState,
   renderDoctorHuman,
@@ -376,7 +376,7 @@ async function harnessCurrentCheck(cwd, manifestPath, manifestExists, tenantId)
     };
   }
   try {
-    const { scanHarness } = await import("./harness-8rbsmg8y.js");
+    const { scanHarness } = await import("./harness-6vwehf47.js");
     const current = scanHarness({
       rootDir: cwd,
       scannerVersion: "doctor",

package/dist/{cli-5b4tz5vj.js → cli-n1d52cww.js}

@@ -9,7 +9,7 @@ import {
   parsePromptFileForAb,
   readPromptLock,
   runPromptSync
-} from "./cli-6ycf2aj5.js";
+} from "./cli-zgj5bakm.js";
 import {
   UUID_RE
 } from "./cli-n2hng3gv.js";

package/dist/{cli-37r94bmk.js → cli-x9cwat4a.js}

@@ -14048,7 +14048,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-jwfvzf5x.js");
+        const { runGithubActionsAnalyze } = await import("./harness-github-actions-6gdrpn4m.js");
         const result = await runGithubActionsAnalyze(rootDir, {
           writeReport: (report2) => {
             const normalized = normalizeHarnessReport(report2);

package/dist/{cli-6ycf2aj5.js → cli-zgj5bakm.js}

@@ -5725,9 +5725,9 @@ async function runPromptsCommand(input, legacyFlags, legacyProfileOptions) {
       await promotePrompt(positionals, flags, profileOptions, context);
       break;
     case "ab":
-      return (await import("./prompts-ab-98pqf06s.js")).runPromptAb(flags, profileOptions, context);
+      return (await import("./prompts-ab-qed3ra5e.js")).runPromptAb(flags, profileOptions, context);
     case "propose":
-      await (await import("./prompts-propose-md1k1ax8.js")).runPromptPropose(positionals, flags, profileOptions, context);
+      await (await import("./prompts-propose-y5r68pcw.js")).runPromptPropose(positionals, flags, profileOptions, context);
       break;
     case "list":
     case "show":
@@ -5830,7 +5830,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-8rbsmg8y.js");
+    const { analyzeHarnessPrompts } = await import("./harness-6vwehf47.js");
     const result = await analyzeHarnessPrompts({
       rootDir: process.cwd(),
       existing: established.flatMap((prompt) => prompt.sourceDefinition ? [prompt.sourceDefinition.source] : []),
@@ -5858,7 +5858,7 @@ async function runPromptSyncExclusive(flags, profileOptions, options) {
   const mergedSources = mergePromptSources(manifest.sources, extraSources);
   const manifestUpdate = stableJson(mergedSources) === stableJson(mergePromptSources(manifest.sources, [])) ? undefined : $stringify({ version: 2, prompt_paths: manifest.promptPaths, sources: mergedSources });
   const prompts = await discoverPrompts(extraSources);
-  const { checkPromptAttribution } = await import("./prompt-attribution-gypvn8z9.js");
+  const { checkPromptAttribution } = await import("./prompt-attribution-t0eq8gn8.js");
   const attribution = checkPromptAttribution(process.cwd(), prompts.map((prompt) => prompt.key));
   const brokenAttribution = attribution.references.filter((reference) => reference.status === "missing");
   if (brokenAttribution.length) {
@@ -6164,7 +6164,7 @@ async function migratePromptManifest(options = {}) {
   let addedSources = [];
   let pendingSources = [];
   if (options.discover) {
-    const { analyzeHarnessPrompts } = await import("./harness-8rbsmg8y.js");
+    const { analyzeHarnessPrompts } = await import("./harness-6vwehf47.js");
     const result = await analyzeHarnessPrompts({
       rootDir: root,
       existing: manifest.sources,

package/dist/cli.js

@@ -2959,7 +2959,7 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-3qr24vd6.js")).runPromptsCommand(...args);
+  return (await import("./prompts-kswdk3ft.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
   return (await import("./skills-j8865009.js")).runSkillsCommand(...args);
@@ -2971,19 +2971,19 @@ async function runFixesCommand(...args) {
   return (await import("./fix-w5z02wt4.js")).runFixesCommand(...args);
 }
 async function runHarnessCommand(...args) {
-  return (await import("./harness-8rbsmg8y.js")).runHarnessCommand(...args);
+  return (await import("./harness-6vwehf47.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-q9raqnk4.js")).runSyncCommand(...args);
+  return (await import("./sync-5e8t28t7.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
   return (await import("./registry-ctnn8e26.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-2hd9rq68.js")).runDoctorCommand(...args);
+  return (await import("./doctor-hnzte896.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-2hd9rq68.js")).runStatusCommand(...args);
+  return (await import("./doctor-hnzte896.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
   return (await import("./profile-commands-h8evz9x0.js")).runAuthCommand(...args);
@@ -2995,10 +2995,10 @@ async function runProfilesCommand(...args) {
   return (await import("./profile-commands-h8evz9x0.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-wjkgt137.js")).runAgentCommand(...args);
+  return (await import("./agent-e4k17rzy.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
-  return (await import("./production-intelligence-wvsgjxth.js")).runProductionCommand(...args);
+  return (await import("./production-intelligence-7wb1djy2.js")).runProductionCommand(...args);
 }
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -6143,7 +6143,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-ecsjv99z.js");
+      const { runInit } = await import("./index-6atgddwt.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -7352,6 +7352,56 @@ function assertRoutedFlags(route, flags) {
   const args = Object.fromEntries(Object.keys(flags).filter((flag) => !aliases.has(flag.replace(/_/g, "-"))).map((flag) => [flag.replace(/-/g, "_"), true]));
   parseCommandFlags(shape.passthrough(), args, route.label, route.flagAliases ? { flagAliases: route.flagAliases } : {});
 }
+var DAYS_TO_TIME_RANGE = { 1: "24h", 3: "3d", 7: "7d", 30: "30d", 90: "90d" };
+function timeRangeAsDays(value) {
+  if (value === "24h")
+    return 1;
+  const match = /^(\d+)d$/.exec(value.trim());
+  const days = match ? Number(match[1]) : NaN;
+  return Number.isInteger(days) && days >= 1 && days <= 90 ? days : undefined;
+}
+function daysBackAcceptsAll(handler) {
+  return specsOf(handler).some((spec) => {
+    return schemaShape(spec.schema).days_back?.safeParse("all").success === true;
+  });
+}
+function foldWindowFlag(handler, route, ...targets) {
+  const flags = targets[0];
+  const accepted = new Set([
+    ...specsOf(handler).flatMap((spec) => specFlagNames(spec)),
+    ...route?.allowedFlags ?? []
+  ]);
+  const takesDays = accepted.has("days-back");
+  const takesRange = accepted.has("time-range");
+  if (takesDays === takesRange)
+    return;
+  const [from, to] = takesRange ? ["days-back", "time-range"] : ["time-range", "days-back"];
+  const raw = flags[from];
+  if (raw === undefined || raw === "true" || raw.trim() === "")
+    return;
+  const shown = canonicalCommandText(`moda ${route?.leaf.path ?? handler}`);
+  if (flags[to] !== undefined) {
+    throw new CliInputError(`Pass one time window: --${to} or --${from}, not both.`, `'${shown}' takes --${to}. See '${shown} --help'.`, `conflicting_window:${from}`, { field: `--${from}`, suggestedCommands: [`${shown} --help`] });
+  }
+  let value;
+  if (takesRange) {
+    value = /^\d+$/.test(raw.trim()) ? DAYS_TO_TIME_RANGE[Number(raw.trim())] : undefined;
+  } else if (raw.trim() === "all" && daysBackAcceptsAll(handler)) {
+    value = "all";
+  } else {
+    const days = timeRangeAsDays(raw);
+    value = days === undefined ? undefined : String(days);
+  }
+  if (value === undefined) {
+    const allowed = takesRange ? Object.values(DAYS_TO_TIME_RANGE).map((range) => `--time-range=${range}`) : ["--days-back=N (1-90)"];
+    throw new CliInputError(`--${from}=${raw} has no exact --${to} equivalent for '${shown}', so nothing was run.`, takesRange ? `'${shown}' takes --time-range=1h|24h|3d|7d|30d|90d|all; --days-back maps only to 1, 3, 7, 30 or 90 days.` : `'${shown}' takes --days-back=N (1-90); --time-range maps only to 24h or a whole number of days up to 90d.`, `unknown_flag:${from}`, { field: `--${from}`, allowed, suggestedCommands: [`${shown} --help`] });
+  }
+  for (const target of new Set(targets)) {
+    delete target[from];
+    target[to] = value;
+  }
+  return from;
+}
 var EMPTY_VALUE_ALLOWED = {
   context: new Set(["msg-index", "message-index"])
 };
@@ -7416,6 +7466,8 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
   canonicalizeFlagKeys(flags, typedParsed.bareFlags);
   const switchError = normalizeBooleanFlags(flags);
   const typedFlags = stripUpdateCheckFlag(stripTelemetryFlag(flags));
+  const reportedFlags = { ...typedFlags };
+  let foldedWindowFlag;
   const telemetryDisabled = isTelemetryDisabled(flags);
   if (telemetryDisabled)
     discardSpoolOnEnvOptOut();
@@ -7506,7 +7558,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
       apiKey: input.apiKey ?? resolveApiKey({ profile: telemetryProfile }),
       profile: telemetryProfile,
       command: identity2?.command ?? handlerTelemetry,
-      flags: typedFlags,
+      flags: reportedFlags,
       status: input.status,
       ...input.error !== undefined ? { errorType: classifyCliError(input.error), validationReason: cliValidationReason(input.error) } : {},
       exitCode: input.exitCode,
@@ -7514,7 +7566,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
       apiRequestCount: input.apiRequestCount,
       adoption,
       ...identity2?.legacyAlias ? { legacyAlias: identity2.legacyAlias } : {},
-      acceptedFlags: telemetryAcceptedFlags(definition2, route),
+      acceptedFlags: new Set([...telemetryAcceptedFlags(definition2, route), ...foldedWindowFlag ? [foldedWindowFlag] : []]),
       knownFlags: telemetryKnownFlags()
     });
   };
@@ -7556,6 +7608,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
   if (switchError)
     return failEarly(switchError, definition, identity);
   try {
+    foldedWindowFlag = foldWindowFlag(route?.handler ?? definition.name, route, typedFlags, commandFlags);
     if (route)
       assertRoutedFlags(route, typedFlags);
     assertFlagValues(definition.name, parsed.positionals, typedFlags, typedParsed.bareFlags, route);

package/dist/{doctor-2hd9rq68.js → doctor-hnzte896.js}

@@ -3,9 +3,9 @@ import {
   promptsDiscoveredCheck,
   runDoctorCommand,
   runStatusCommand
-} from "./cli-2eqh3150.js";
+} from "./cli-a03st7e3.js";
 import"./cli-9bgnvth2.js";
-import"./cli-6ycf2aj5.js";
+import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import"./cli-xq45etg1.js";
 import"./cli-dr6x0zv7.js";

package/dist/{harness-8rbsmg8y.js → harness-6vwehf47.js}

@@ -40,10 +40,8 @@ import {
   writeHarnessAnalyzeResult,
   writeHarnessArtifacts,
   writeHumanProgress
-} from "./cli-37r94bmk.js";
-import {
-  readHarnessSyncState
-} from "./cli-xq45etg1.js";
+} from "./cli-x9cwat4a.js";
+import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import {
   HARNESS_ANALYZE_CONCERNS
@@ -76,7 +74,6 @@ export {
   renderExternalHarnessAnalystPrompt,
   renderAnalystSeedLines,
   renderAnalystCandidateLines,
-  readHarnessSyncState,
   promptNameFromPath,
   numericEnvAllowZero,
   numericEnv,

package/dist/{harness-github-actions-jwfvzf5x.js → harness-github-actions-6gdrpn4m.js}

@@ -1,6 +1,6 @@
 import {
   buildSourceSnapshot
-} from "./cli-37r94bmk.js";
+} from "./cli-x9cwat4a.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import"./cli-cesds766.js";

package/dist/{index-ecsjv99z.js → index-6atgddwt.js}

@@ -1,6 +1,6 @@
 import {
   buildDoctorReport
-} from "./cli-2eqh3150.js";
+} from "./cli-a03st7e3.js";
 import {
   selectTenantAndCreateKey
 } from "./cli-9bgk5jeh.js";
@@ -29,7 +29,7 @@ import {
 import {
   initPrompts,
   runPromptSync
-} from "./cli-6ycf2aj5.js";
+} from "./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import {
   codingAgentDisplayName,
@@ -43,7 +43,7 @@ import {
   runCodingAgent,
   runHarnessCommand,
   startRemoteAnalyze
-} from "./cli-37r94bmk.js";
+} from "./cli-x9cwat4a.js";
 import {
   canonicalText,
   renderInitBanner,

package/dist/{production-intelligence-wvsgjxth.js → production-intelligence-7wb1djy2.js}

@@ -42,7 +42,6 @@ import { join } from "node:path";
 // src/ask-stream.ts
 class AskStreamError extends Error {
   elapsedMs;
-  toolEvents;
   accepted;
   constructor(message) {
     super(message);
@@ -169,7 +168,6 @@ class AskStreamCollector {
   terminal = false;
   lastPhase;
   toolNames = new Map;
-  toolEvents = 0;
   events = 0;
   constructor(onProgress = () => {}) {
     this.onProgress = onProgress;
@@ -201,7 +199,6 @@ class AskStreamCollector {
         break;
       }
       case "tool_start": {
-        this.toolEvents += 1;
         const tool = event.tool;
         const id = typeof tool?.id === "string" ? tool.id : "";
         const name = stripAnsi(typeof tool?.tool === "string" ? tool.tool : "tool");
@@ -212,7 +209,6 @@ class AskStreamCollector {
         break;
       }
       case "tool_end": {
-        this.toolEvents += 1;
         const id = typeof event.id === "string" ? event.id : "";
         const name = this.toolNames.get(id) ?? "tool";
         this.onProgress(`• ${name} — ${toolEndDetail(event)}`);
@@ -250,9 +246,6 @@ class AskStreamCollector {
   get eventCount() {
     return this.events;
   }
-  get toolEventCount() {
-    return this.toolEvents;
-  }
   finish() {
     if (!this.terminal) {
       throw new AskStreamError("stream ended before a terminal done/error event");
@@ -392,8 +385,6 @@ async function streamAsk(options) {
     if (error instanceof AskStreamError) {
       if (error.elapsedMs === undefined)
         error.elapsedMs = Date.now() - startedAt;
-      if (error.toolEvents === undefined)
-        error.toolEvents = collector.toolEventCount;
       if (error.accepted === undefined)
         error.accepted = accepted || collector.eventCount > 0;
     }

package/dist/{prompt-attribution-gypvn8z9.js → prompt-attribution-t0eq8gn8.js}

@@ -1,7 +1,7 @@
 import {
   inventoryFiles,
   safePromptEvidencePath
-} from "./cli-37r94bmk.js";
+} from "./cli-x9cwat4a.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import"./cli-cesds766.js";

package/dist/prompt-source-mcp.js

@@ -3,7 +3,7 @@ import {
   checkPromptMapping,
   discoverHarnessPromptSources,
   safePromptEvidencePath
-} from "./cli-37r94bmk.js";
+} from "./cli-x9cwat4a.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import"./cli-cesds766.js";

package/dist/{prompts-ab-98pqf06s.js → prompts-ab-qed3ra5e.js}

@@ -23,13 +23,9 @@ import {
   runPromptAb,
   selectProblemCases,
   waitLabel
-} from "./cli-5b4tz5vj.js";
-import {
-  DEFAULT_POLL_INTERVAL_MS,
-  DEFAULT_WAIT_TIMEOUT_MS,
-  fetchLatestRun
-} from "./cli-yz8xcpyk.js";
-import"./cli-6ycf2aj5.js";
+} from "./cli-n1d52cww.js";
+import"./cli-yz8xcpyk.js";
+import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import"./cli-dr6x0zv7.js";
 import"./cli-n2hng3gv.js";
@@ -51,7 +47,6 @@ export {
   formatVerdict,
   fetchReplaySetCases,
   fetchProblemCases,
-  fetchLatestRun,
   enqueueAndPollComparison,
   describeProblemCases,
   describePlayouts,
@@ -64,7 +59,5 @@ export {
   PLAYOUT_CONFIRM_THRESHOLD,
   MAX_REPLAY_TRACES,
   MAX_AUTO_GENERATE_CASES,
-  DEFAULT_WAIT_TIMEOUT_MS,
-  DEFAULT_PROBLEM_MAX_CASES,
-  DEFAULT_POLL_INTERVAL_MS
+  DEFAULT_PROBLEM_MAX_CASES
 };

package/dist/{prompts-3qr24vd6.js → prompts-kswdk3ft.js}

@@ -11,7 +11,7 @@ import {
   runPromptSync,
   runPromptsCommand,
   writePromptSyncProgress
-} from "./cli-6ycf2aj5.js";
+} from "./cli-zgj5bakm.js";
 import {
   promptSourceHashPayload
 } from "./cli-mm48br00.js";

package/dist/{prompts-propose-md1k1ax8.js → prompts-propose-y5r68pcw.js}

@@ -7,9 +7,9 @@ import {
   formatVerdict,
   rerunWithYes,
   resolvePromptArmSpec
-} from "./cli-5b4tz5vj.js";
+} from "./cli-n1d52cww.js";
 import"./cli-yz8xcpyk.js";
-import"./cli-6ycf2aj5.js";
+import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import"./cli-dr6x0zv7.js";
 import"./cli-n2hng3gv.js";

package/dist/{sync-q9raqnk4.js → sync-5e8t28t7.js}

@@ -4,11 +4,11 @@ import {
 import"./cli-8dtnwp9r.js";
 import {
   runPromptsCommand
-} from "./cli-6ycf2aj5.js";
+} from "./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import {
   runHarnessCommand
-} from "./cli-37r94bmk.js";
+} from "./cli-x9cwat4a.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import"./cli-cesds766.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.55.30",
+  "version": "1.55.32",
   "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-16T22:40:38.104Z",
-  "cli_version": "1.55.30",
+  "bundled_at": "2026-10-17T02:32:13.042Z",
+  "cli_version": "1.55.32",
   "skills": [
     {
       "id": "integration-cloudflare-think",

package/skills/moda-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: moda-cli
-version: 3.0.0
+version: 3.0.1
 description: Investigate a production AI agent with the Moda CLI (`moda`) - find where something happened in real traces (traces search, then traces get), check agent health, rank what to fix (investigate, problems), and dig into tool failures, user frustration, and hallucinations. Also prompt registry sync/promote, replays, custom signals, and false-positive marking. Use when the user mentions Moda, production traces or conversations of their agent, agent failures, or asks what to fix.
 ---
 
@@ -74,7 +74,9 @@ Details: `references/output-protocol.md`.
 
 Time windows differ by command: `--days-back=N` (1-90) on overview,
 investigate, problems, and detection commands; `--time-range=1h|24h|3d|7d|30d|90d|all`
-on search, traces, and clusters. `moda <noun> <verb> --help` shows which.
+on search, traces, and clusters. The other spelling works when it names the
+same span (`--days-back=7` is `--time-range=7d`); anything else fails and
+names the closest values. `moda <noun> <verb> --help` shows which.
 
 ## Fixing a Problem
 

package/skills/moda-cli/references/output-protocol.md

@@ -237,8 +237,12 @@ Treat an answer as degraded if **any** of these hold:
 
 #### Time-window flags by command
 
-A command rejects the window flag it doesn't take, and out-of-range values
-fail instead of being clamped.
+A command takes one window flag. The other spelling is rewritten when it names
+the same span: `--days-back=1|3|7|30|90` is `--time-range=24h|3d|7d|30d|90d`,
+and `--time-range=24h` or `Nd` (up to 90d) is `--days-back`. A value with no
+exact match (`--days-back=14` on `traces search`, `--time-range=all` or `1h`
+on a detection command) fails, as does passing both. Out-of-range values fail
+instead of being clamped.
 
 | Flag | Commands | Allowed values | Default |
 | --- | --- | --- | --- |