@moda-ai/cli 1.55.31 → 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/cli.js

@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.55.31",
+  "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-17T00:31:13.506Z",
-  "cli_version": "1.55.31",
+  "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 |
 | --- | --- | --- | --- |