@moda-ai/cli 1.55.41 → 1.55.43

package/dist/cli.js

@@ -6,34 +6,41 @@ import {
   asNumber,
   asRecord,
   asString,
+  assertCompareScope,
   collectBatchTargets,
   compactProblemDossier,
   contextTarget,
   embeddedWindowSize,
   frustrationsFromEmotions,
+  loadFamilyCompare,
   mapWithConcurrency,
   parseBatchTarget,
   parseTargetLines,
+  problemTrendSummary,
   readIdsFrom,
   shapeToolCatalogDetail,
   toolCatalogGetCommand,
   toolFailureExamplesCommand,
   trimToolFailureConversations,
   withFrustrationAnchors,
+  withSummaryCompare,
   withToolFailureAnchors,
   withoutDetectionWindows
-} from "./cli-gt3yq1y5.js";
+} from "./cli-5y9tj6cb.js";
+import {
+  createCommandContext
+} from "./cli-5fhqfx04.js";
 import {
-  createCommandContext,
   envOptOutSet,
   envSwitchedOff,
   optOutFlagSet,
   parseBooleanFlagValue,
   withoutFlag
-} from "./cli-xddtv3yn.js";
+} from "./cli-e0kbye4s.js";
 import {
   AuditSchema,
   BOOK_PROBLEM_SORTS,
+  CLUSTER_COHORT_TIME_RANGES,
   COMMAND_FLAG_SPECS,
   DETECTION_VERDICTS,
   DREAM_PROBLEM_SORTS,
@@ -68,6 +75,7 @@ import {
   kebabFlag,
   manifestFlagFields,
   renderFlagHelp,
+  runCohortCommand,
   runProblemReopenCommand,
   runSignalsManagementCommand,
   runUserCommand,
@@ -79,7 +87,7 @@ import {
   unknownSignalsSubcommandError,
   usageLine,
   writeDryRun
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   ApiError,
   callControlAPI,
@@ -1355,7 +1363,7 @@ var CANONICAL_LEAVES = [
     args: "<problem_id>",
     handler: "problem",
     summary: "One Problem: dossier, its --evidence/--reports/--traces/--feedback pages, or --view=dream",
-    examples: ["moda problems get <problem_id>", "moda problems get <problem_id> --view=dream", "moda problems get <problem_id> --evidence --limit=10", "moda problems get <problem_id> --traces --family=tool_failure"]
+    examples: ["moda problems get <problem_id>", "moda problems get <problem_id> --view=dream", "moda problems get <problem_id> --evidence --limit=10", "moda problems get <problem_id> --traces --family=tool_failure", "moda problems get <problem_id> --trend --days-back=14"]
   },
   {
     noun: "problems",
@@ -1423,7 +1431,8 @@ var CANONICAL_LEAVES = [
       "moda detections list --family=frustration --limit=10",
       "moda detections list --family=emotion:confusion --days-back=14",
       "moda detections list --family=hallucination --kind=contradicted",
-      "moda detections list --family=custom_signal --signal-id=<signal_id>"
+      "moda detections list --family=custom_signal --signal-id=<signal_id>",
+      "moda detections list --family=frustration --compare --days-back=7"
     ]
   },
   {
@@ -1453,6 +1462,69 @@ var CANONICAL_LEAVES = [
     summary: "One tool: calls, recorded schema and payload fields, usage over time, top failure categories",
     examples: ["moda tools get <tool_name>", "moda tools get <tool_name> --days-back=30 --full"]
   },
+  {
+    noun: "cohorts",
+    verb: "list",
+    path: "cohorts list",
+    args: "",
+    handler: "cohort-list",
+    summary: "Built-in and saved user cohorts with their refs and definitions (the dashboard Users page)",
+    examples: ["moda cohorts list", "moda cohorts list --include-archived"]
+  },
+  {
+    noun: "cohorts",
+    verb: "get",
+    path: "cohorts get",
+    args: "<ref>",
+    handler: "cohort-get",
+    summary: "One cohort: name, definition and revision (ref: builtin:<key> or a saved cohort id)",
+    examples: ["moda cohorts get builtin:power_users", "moda cohorts get <cohort_id>"]
+  },
+  {
+    noun: "cohorts",
+    verb: "fields",
+    path: "cohorts fields",
+    args: "",
+    handler: "cohort-fields",
+    summary: "The fields and operators a cohort definition can use",
+    examples: ["moda cohorts fields"]
+  },
+  {
+    noun: "cohorts",
+    verb: "preview",
+    path: "cohorts preview",
+    args: "",
+    handler: "cohort-preview",
+    summary: "Member count and a sample of users for an unsaved definition",
+    examples: ["moda cohorts preview --file=cohort.json", `moda cohorts preview --definition='{"version":1,"window":"30d","where":{"field":"tool_failure_count","op":"gte","value":3}}'`]
+  },
+  {
+    noun: "cohorts",
+    verb: "compare",
+    path: "cohorts compare",
+    args: "<cohort_a> <cohort_b>",
+    handler: "cohort-compare",
+    summary: "Two cohorts side by side: size, health, top topics and failure mix",
+    examples: ["moda cohorts compare builtin:new_this_week builtin:power_users --days=30"]
+  },
+  {
+    noun: "cohorts",
+    verb: "create",
+    path: "cohorts create",
+    args: "",
+    handler: "cohort-create",
+    summary: "Save a cohort from a definition (write; --dry-run prints the request)",
+    examples: ['moda cohorts create --name="Enterprise" --file=cohort.json --dry-run']
+  },
+  {
+    noun: "cohorts",
+    verb: "update",
+    path: "cohorts update",
+    args: "<cohort_id>",
+    handler: "cohort-update",
+    summary: "Edit a saved cohort: name, definition, description, pin, color (write; --dry-run)",
+    examples: ['moda cohorts update <cohort_id> --file=cohort.json --note="exclude trials" --dry-run']
+  },
   {
     noun: "review",
     verb: "",
@@ -1486,12 +1558,13 @@ var CANONICAL_LEAVES = [
     examples: ["moda skills push --dry-run", "moda skills push"]
   }
 ];
-var CANONICAL_NOUNS = ["traces", "problems", "detections", "tools", "review", "reviews", "skills"];
+var CANONICAL_NOUNS = ["traces", "problems", "detections", "tools", "cohorts", "review", "reviews", "skills"];
 var NOUN_SUMMARIES = {
   traces: "Traces (agent runs): list, search, read, findings, world state, raw spans",
   problems: "Problems ranked by root cause, their evidence, impact and lifecycle",
   detections: "Detections of every family, and the tool failure leaderboard",
   tools: "The Tool catalog: every tool with calls and success rate, and one tool's schema, usage and failure categories",
+  cohorts: "User cohorts: list, read, preview and compare them, and save or edit one; scope lists with --cohort",
   review: "Mark a detection a false positive, correct, or clear the mark",
   reviews: "List false-positive marks and detection reviews",
   skills: "Generate, pull, push, and install agent skills"
@@ -3175,31 +3248,31 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-ysm9ra72.js")).runPromptsCommand(...args);
+  return (await import("./prompts-xe5bgbx8.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
-  return (await import("./skills-x6yszxxn.js")).runSkillsCommand(...args);
+  return (await import("./skills-vveagdwe.js")).runSkillsCommand(...args);
 }
 async function runFixCommand(...args) {
-  return (await import("./fix-0r974yge.js")).runFixCommand(...args);
+  return (await import("./fix-7aajsdbf.js")).runFixCommand(...args);
 }
 async function runFixesCommand(...args) {
-  return (await import("./fix-0r974yge.js")).runFixesCommand(...args);
+  return (await import("./fix-7aajsdbf.js")).runFixesCommand(...args);
 }
 async function runHarnessCommand(...args) {
-  return (await import("./harness-72ejenza.js")).runHarnessCommand(...args);
+  return (await import("./harness-1rn1hqzz.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-trjzvam9.js")).runSyncCommand(...args);
+  return (await import("./sync-yy3fgnxe.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
-  return (await import("./registry-7xz09ry0.js")).runRegistryCommand(...args);
+  return (await import("./registry-j2dsfh6v.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-p8sp6cbk.js")).runDoctorCommand(...args);
+  return (await import("./doctor-wrgajgev.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-p8sp6cbk.js")).runStatusCommand(...args);
+  return (await import("./doctor-wrgajgev.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
   return (await import("./profile-commands-se9947c1.js")).runAuthCommand(...args);
@@ -3211,10 +3284,10 @@ async function runProfilesCommand(...args) {
   return (await import("./profile-commands-se9947c1.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-ck6y31n2.js")).runAgentCommand(...args);
+  return (await import("./agent-x1gwrrvd.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
-  return (await import("./production-intelligence-e5vsc6cw.js")).runProductionCommand(...args);
+  return (await import("./production-intelligence-7jvfdz6b.js")).runProductionCommand(...args);
 }
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -3515,6 +3588,7 @@ Production data:
   clusters                         Browse or search topic clusters
   cluster-traces <node_id>         List traces in a cluster
   users / user <user_id>           End users with health and activity (the dashboard Users page)
+  cohorts list|get|compare         User cohorts; --cohort=<ref> scopes problems, traces, detections, clusters
   tail                             Live-tail new traces/detections as NDJSON (one line per item)
 
 Traces, Problems, detections, tools and review (moda <noun> --help lists the verbs):
@@ -4858,10 +4932,7 @@ async function runProblemsList(flags, context, command) {
     ...listVersionWarning(params, listVersion),
     ...truncated ? [`--limit=${limit} also capped ${Object.entries(truncated).map(([block, count]) => `${block} (${count} more)`).join(", ")}; raise --limit (max ${PROBLEMS_MAX_LIMIT}) or open dashboard_url for the rest.`] : []
   ];
-  context.output.writeData(withLink, {
-    ...warnings.length > 0 ? { warnings } : {},
-    ...nextCommands.length > 0 ? { nextCommands } : {}
-  });
+  context.output.writeData(withLink, withCohortScope(params.cohort, payload, { warnings, nextCommands }));
 }
 function writeDreamProblemsList(context, params, dream, page) {
   const problems = Array.isArray(dream.problems) ? dream.problems : [];
@@ -4903,7 +4974,7 @@ function writeDreamProblemsList(context, params, dream, page) {
     ...!page.daysGiven && windowHours !== undefined ? [`Counts cover the dream run's window (${windowHours} hours), the dashboard's default range; pass --days-back to choose another.`] : [],
     ...listVersionWarning(params, listVersion)
   ];
-  context.output.writeData(data, { warnings, ...nextCommands.length > 0 ? { nextCommands } : {} });
+  context.output.writeData(data, { warnings, ...withCohortScope(params.cohort, dream, { warnings, nextCommands }) });
 }
 var DREAM_INCIDENTS_DEFAULT_LIMIT = 3;
 async function runDreamProblem(params, context, command) {
@@ -5008,6 +5079,27 @@ function setTraceFilters(query2, params, keys) {
       query2.set(key, String(value));
   }
 }
+function cohortScope(cohort, data) {
+  if (!cohort || cohort === "all")
+    return { warnings: [] };
+  if (asString(asRecord(data)?.cohort) !== cohort) {
+    return {
+      warnings: [`--cohort=${cohort} was sent, but the response does not confirm the cohort scope, so these results may cover every user.`]
+    };
+  }
+  return { line: `Scoped to cohort ${cohort}: only its members' traces count (moda cohorts get ${shellArg(cohort)} shows who is in it).`, warnings: [] };
+}
+function withCohortScope(cohort, data, options = {}) {
+  const scope = cohortScope(cohort, data);
+  const summary = [options.summary, scope.line].filter(Boolean).join(" ");
+  const warnings = [...options.warnings ?? [], ...scope.warnings];
+  const merged = {
+    ...summary ? { summary } : {},
+    ...warnings.length > 0 ? { warnings } : {},
+    ...options.nextCommands && options.nextCommands.length > 0 ? { nextCommands: options.nextCommands } : {}
+  };
+  return Object.keys(merged).length > 0 ? merged : undefined;
+}
 function countingSummary(data) {
   const record = asRecord(data);
   const counting = asString(record?.counting);
@@ -5702,8 +5794,11 @@ async function runCommand(command, positional, flags, positionals = positional ?
     case "clusters": {
       const args = flagsToArgs(flags);
       const params = parseSpecFlags("clusters", args, command);
+      if (params.cohort && params.cohort !== "all" && params.time_range && !CLUSTER_COHORT_TIME_RANGES.includes(params.time_range)) {
+        throw new CliInputError(`--cohort reads the Topics tree windows, so --time-range must be ${CLUSTER_COHORT_TIME_RANGES.join(", ")} (got ${params.time_range}). Nothing was sent.`);
+      }
       if (params.search !== undefined || params.node_id !== undefined) {
-        rejectInapplicableFlags(command, params, ["parent_id", "time_range"], "to a cluster search (--search/--node-id); they page the cluster hierarchy");
+        rejectInapplicableFlags(command, params, params.cohort ? ["parent_id"] : ["parent_id", "time_range"], "to a cluster search (--search/--node-id); they page the cluster hierarchy");
         const query3 = new URLSearchParams;
         if (params.search !== undefined)
           query3.set("q", params.search);
@@ -5713,11 +5808,15 @@ async function runCommand(command, positional, flags, positionals = positional ?
           query3.set("mode", params.mode);
         if (params.limit)
           query3.set("limit", params.limit.toString());
+        if (params.cohort)
+          query3.set("cohort", params.cohort);
+        if (params.cohort && params.time_range)
+          query3.set("time_range", params.time_range);
         const data2 = await callDataAPI(`/task-clusters/search?${query3.toString()}`);
         const record = asRecord(data2) ?? {};
         const matches = Array.isArray(record.matches) ? record.matches : [];
-        const warnings = params.node_id !== undefined && matches.length === 0 ? [`No cluster matched node id "${params.node_id}" for this search. ${NOT_FOUND_HINTS.cluster}`] : [];
-        context.output.writeData(data2, warnings.length > 0 ? { warnings } : undefined);
+        const warnings = params.node_id !== undefined && matches.length === 0 ? [`No cluster matched node id "${params.node_id}" for this search${params.cohort ? " within the cohort" : ""}. ${NOT_FOUND_HINTS.cluster}`] : [];
+        context.output.writeData(data2, withCohortScope(params.cohort, data2, { warnings }));
         break;
       }
       rejectInapplicableFlags(command, params, ["mode", "limit"], "without --search or --node-id; they shape a cluster search");
@@ -5726,9 +5825,11 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("parent_id", params.parent_id);
       if (params.time_range)
         query2.set("time_range", params.time_range);
+      if (params.cohort)
+        query2.set("cohort", params.cohort);
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/clusters${queryString}`);
-      context.output.writeData(data);
+      context.output.writeData(data, withCohortScope(params.cohort, data));
       break;
     }
     case "cluster-traces":
@@ -5775,6 +5876,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("outcome", params.outcome);
       if (params.sort)
         query2.set("sort_by", params.sort);
+      if (params.cohort)
+        query2.set("cohort", params.cohort);
       if (params.limit)
         query2.set("limit", params.limit.toString());
       if (params.offset !== undefined)
@@ -5800,7 +5903,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
         }
       }
       searchWarnings.push(...traceStateWarnings(data));
-      const writeOptions = searchWarnings.length > 0 ? { warnings: searchWarnings } : undefined;
+      const writeOptions = withCohortScope(params.cohort, raw, { warnings: searchWarnings });
       if (params.include_world_state === true) {
         const enriched = asRecord(data) ?? {};
         const list = Array.isArray(enriched.conversations) ? enriched.conversations : [];
@@ -5962,6 +6065,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
     case "frustrations": {
       const args = flagsToArgs(flags);
       const params = parseSpecFlags("frustrations", args, command);
+      const compare = params.compare === true ? await loadFamilyCompare("frustrations", params) : undefined;
       const query2 = new URLSearchParams;
       if (params.days_back)
         query2.set("days_back", params.days_back.toString());
@@ -5972,10 +6076,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
       if (readsPerTrace("frustrations", params, ["user_id", "conversation_id", "conversation_ids", "ids_from", "include_window"])) {
         query2.set("family", "frustration");
         setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.frustrations);
-        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const data2 = withSummaryCompare(await callDataAPI(`/emotions?${query2.toString()}`), compare);
         const warnings = processingDisabledWarning(data2, "frustration");
-        const summary = countingSummary(data2);
-        context.output.writeData(data2, { ...summary ? { summary } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        context.output.writeData(data2, withCohortScope(params.cohort, data2, { summary: countingSummary(data2), warnings }));
         break;
       }
       if (params.user_id)
@@ -5991,22 +6094,33 @@ async function runCommand(command, positional, flags, positionals = positional ?
       if (agentMode && !includeWindow)
         query2.set("include_context", "0");
       const data = frustrationsFromEmotions(await callDataAPI(`/emotions?${query2.toString()}`));
-      const anchored = withFrustrationAnchors(data);
+      const anchored = withSummaryCompare(withFrustrationAnchors(data), compare);
       await printWithOptionalWindows(agentMode && !includeWindow ? withoutDetectionWindows(anchored, "frustrations", "conversation") : anchored, "frustrations", includeWindow, params.window ?? 1, context.output, processingDisabledWarning(data, "frustration"), agentMode && includeWindow ? (payload) => withoutRepeatedFrustrationWindow(payload) : undefined, [], countingSummary(data));
       break;
     }
     case "tool-failures": {
       const args = flagsToArgs(flags);
       const params = parseSpecFlags("tool-failures", args, command);
-      const queryString = params.days_back ? `?days_back=${params.days_back}` : "";
-      const data = await callDataAPI(`/tool-failures${queryString}`);
+      const tfQuery = new URLSearchParams;
+      if (params.days_back)
+        tfQuery.set("days_back", String(params.days_back));
+      if (params.cohort)
+        tfQuery.set("cohort", params.cohort);
+      const queryString = tfQuery.toString() ? `?${tfQuery.toString()}` : "";
+      if (params.compare === true)
+        assertCompareScope("tool-failures", params);
+      const [listed, compare] = await Promise.all([
+        callDataAPI(`/tool-failures${queryString}`),
+        params.compare === true ? loadFamilyCompare("tool-failures", params) : Promise.resolve(undefined)
+      ]);
+      const data = withSummaryCompare(listed, compare);
       const daysBack = params.days_back ?? 7;
       const failing = (Array.isArray(asRecord(data)?.tools) ? asRecord(data).tools : []).map((row) => asString(asRecord(row)?.tool_name)).filter((name) => Boolean(name)).slice(0, TOOL_FAILURE_CATALOG_LINKS);
       const nextCommands = failing.flatMap((name, index) => [
         ...index === 0 ? [{ command: toolFailureExamplesCommand(name, daysBack), purpose: `Read failure examples of ${name}, the tool with the most failures.`, mutability: "read", requires_approval: false }] : [],
         { command: toolCatalogGetCommand(name, daysBack), purpose: `Calls, recorded schema, usage over time and failure categories of ${name}.`, mutability: "read", requires_approval: false }
       ]);
-      context.output.writeData(data, nextCommands.length > 0 ? { nextCommands } : undefined);
+      context.output.writeData(data, withCohortScope(params.cohort, data, { nextCommands }));
       break;
     }
     case "tool-catalog": {
@@ -6205,11 +6319,21 @@ async function runCommand(command, positional, flags, positionals = positional ?
       }
       const args = flagsToArgs(flags, "id", positional);
       const params = parseSpecFlags("problem", args, command);
+      if (params.trend === true) {
+        rejectInapplicableFlags(command, params, ["evidence", "reports", "traces", "conversations", "feedback", "full", "limit", "cursor", "family", "door", "view", "offset"], "with --trend; it reads the Problem's per-day history (only --days-back applies)");
+        const query3 = params.days_back ? `?days_back=${params.days_back}` : "";
+        const data2 = await callDataAPI(`/problems/${encodeURIComponent(params.id)}/history${query3}`);
+        context.output.writeData(data2, {
+          summary: problemTrendSummary(data2),
+          nextCommands: [{ command: `moda problems get ${shellArg(params.id)}`, purpose: "Open the Problem dossier.", mutability: "read", requires_approval: false }]
+        });
+        break;
+      }
       if (params.view === "dream") {
         await runDreamProblem(params, context, command);
         break;
       }
-      rejectInapplicableFlags(command, params, ["offset", "days_back"], "without --view=dream; the dossier pages page with --limit and --cursor");
+      rejectInapplicableFlags(command, params, ["offset", "days_back"], "without --view=dream or --trend; the dossier pages page with --limit and --cursor");
       const traceView = params.traces === true || params.conversations === true;
       const views = ["evidence", "reports", "conversations", "feedback"].filter((view2) => view2 === "conversations" ? traceView : params[view2] === true);
       if (views.length > 1) {
@@ -6403,7 +6527,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
       const params = parseSpecFlags("signal", args, command);
       const id = encodeURIComponent(params.id);
       if (params.detections !== true) {
-        rejectInapplicableFlags(command, params, ["days_back", "limit", "offset"], "to the signal summary; they page its hits (--detections)");
+        rejectInapplicableFlags(command, params, ["days_back", "limit", "offset", "cohort"], "to the signal summary; they page its hits (--detections)");
         const data2 = await callDataAPI(`/custom-signals/${id}`);
         context.output.writeData(data2);
         break;
@@ -6415,10 +6539,12 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("limit", params.limit.toString());
       if (params.offset !== undefined)
         query2.set("offset", params.offset.toString());
+      if (params.cohort)
+        query2.set("cohort", params.cohort);
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/custom-signals/${id}/detections${queryString}`);
       const warnings = customSignalProcessingWarning(data, "detections");
-      context.output.writeData(data, warnings.length > 0 ? { warnings } : undefined);
+      context.output.writeData(data, withCohortScope(params.cohort, data, { warnings }));
       break;
     }
     case "trace-signals": {
@@ -6636,6 +6762,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
     case "emotions": {
       const args = flagsToArgs(flags);
       const params = parseSpecFlags("emotions", args, command);
+      const compare = params.compare === true ? await loadFamilyCompare("emotions", params) : undefined;
       const query2 = new URLSearchParams;
       if (params.days_back)
         query2.set("days_back", params.days_back.toString());
@@ -6647,10 +6774,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("family", params.family);
       if (readsPerTrace("emotions", params, ["user_id", "conversation_id", "conversation_ids", "ids_from", "include_window"])) {
         setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.emotions);
-        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const data2 = withSummaryCompare(await callDataAPI(`/emotions?${query2.toString()}`), compare);
         const warnings = processingDisabledWarning(data2, "emotion");
-        const summary2 = countingSummary(data2);
-        context.output.writeData(data2, { ...summary2 ? { summary: summary2 } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        context.output.writeData(data2, withCohortScope(params.cohort, data2, { summary: countingSummary(data2), warnings }));
         break;
       }
       if (params.user_id)
@@ -6664,7 +6790,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
       if (agentMode && params.include_window !== true)
         query2.set("include_context", "0");
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
-      const raw = await callDataAPI(`/emotions${queryString}`);
+      const raw = withSummaryCompare(await callDataAPI(`/emotions${queryString}`), compare);
       const processingWarnings = processingDisabledWarning(raw, "emotion");
       const record = asRecord(raw);
       const data = agentMode && params.include_window !== true && record ? withoutDetectionWindows(record, "detections", "conversation_context") : raw;
@@ -6690,8 +6816,10 @@ async function runCommand(command, positional, flags, positionals = positional ?
       if (params.family)
         query2.set("family", params.family);
       if (params.conversation_id) {
-        rejectInapplicableFlags(command, params, ["search", "status", "sort", "order"], "to one trace's detections (--conversation-id); they filter and order the trace list");
+        rejectInapplicableFlags(command, params, ["search", "status", "sort", "order", "cohort"], "to one trace's detections (--conversation-id); they filter and order the trace list");
       }
+      if (params.cohort)
+        query2.set("cohort", params.cohort);
       if (params.search)
         query2.set("search", params.search);
       if (params.status)
@@ -6701,9 +6829,14 @@ async function runCommand(command, positional, flags, positionals = positional ?
       if (params.order)
         query2.set("order", params.order);
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
-      const data = await callDataAPI(`/laziness${queryString}`);
-      const summary = countingSummary(data);
-      context.output.writeData(data, summary ? { summary } : undefined);
+      if (params.compare === true)
+        assertCompareScope("laziness", params);
+      const [listed, compare] = await Promise.all([
+        callDataAPI(`/laziness${queryString}`),
+        params.compare === true ? loadFamilyCompare("laziness", params) : Promise.resolve(undefined)
+      ]);
+      const data = withSummaryCompare(listed, compare);
+      context.output.writeData(data, withCohortScope(params.cohort, data, { summary: countingSummary(data) }));
       break;
     }
     case "hallucinations": {
@@ -6728,9 +6861,14 @@ async function runCommand(command, positional, flags, positionals = positional ?
           query2.set("kind", params.kind);
       }
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
-      const data = await callDataAPI(`/hallucinations${queryString}`);
-      const summary = countingSummary(data);
-      context.output.writeData(data, summary ? { summary } : undefined);
+      if (params.compare === true)
+        assertCompareScope("hallucinations", params);
+      const [listed, compare] = await Promise.all([
+        callDataAPI(`/hallucinations${queryString}`),
+        params.compare === true ? loadFamilyCompare("hallucinations", params) : Promise.resolve(undefined)
+      ]);
+      const data = withSummaryCompare(listed, compare);
+      context.output.writeData(data, withCohortScope(params.cohort, data, { summary: countingSummary(data) }));
       break;
     }
     case "step-scores": {
@@ -6919,7 +7057,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-w7v472w4.js");
+      const { runInit } = await import("./index-svfzq5rb.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -6969,7 +7107,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-cya5rpxa.js");
+      const { runProvision } = await import("./provision-a9kkfvp7.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -7233,6 +7371,40 @@ var commandRegistry = createCommandRegistry([
     telemetry: "result-and-error",
     handler: runUserCommand
   },
+  {
+    name: "cohorts",
+    description: NOUN_SUMMARIES.cohorts,
+    examples: [...leavesOf("cohorts").flatMap((leaf) => leaf.examples.slice(0, 1))],
+    subcommands: treeSubcommandHelp("cohorts"),
+    auth: "api-key",
+    outputModes: ["human", "json", "agent"],
+    mutability: "write",
+    validateConfigBeforeRun: false,
+    resetApiRequestCountBeforeRun: false,
+    telemetry: "result-and-error",
+    handler: canonicalNounHandler
+  },
+  ...[
+    ["cohort-list", "Built-in and saved user cohorts", "read"],
+    ["cohort-get", "One cohort: name, definition and revision", "read"],
+    ["cohort-fields", "The fields and operators a cohort definition can use", "read"],
+    ["cohort-preview", "Member count and sample users for an unsaved definition", "read"],
+    ["cohort-compare", "Two cohorts side by side: size, health, top topics, failure mix", "read"],
+    ["cohort-create", "Save a cohort from a definition", "write"],
+    ["cohort-update", "Edit a saved cohort", "write"]
+  ].map(([name, description, mutability]) => ({
+    name,
+    description,
+    examples: [...CANONICAL_LEAVES.find((leaf) => leaf.handler === name)?.examples ?? []],
+    hidden: true,
+    auth: "api-key",
+    outputModes: ["human", "json", "agent"],
+    mutability,
+    validateConfigBeforeRun: false,
+    resetApiRequestCountBeforeRun: false,
+    telemetry: "result-and-error",
+    handler: runCohortCommand
+  })),
   {
     name: "replays",
     description: "Read replay results: sets, run history, per-seed verdicts, and playout transcripts",
@@ -7349,7 +7521,7 @@ var commandRegistry = createCommandRegistry([
   legacyCommand({
     name: "overview",
     description: "Harness health briefing from production data",
-    examples: ["moda overview --days-back=30", "moda --agent overview"],
+    examples: ["moda overview --days-back=30", "moda --agent overview", "moda overview --compare --since=2026-10-17T14:00:00Z   # after a deploy against the same span before it", "moda overview --series --days-back=14"],
     ...dataApiDefaults
   }),
   legacyCommand({

package/dist/{doctor-p8sp6cbk.js → doctor-wrgajgev.js}

@@ -3,13 +3,14 @@ import {
   promptsDiscoveredCheck,
   runDoctorCommand,
   runStatusCommand
-} from "./cli-a8nxbtpk.js";
+} from "./cli-h62j4jn7.js";
 import"./cli-pmzh2qjy.js";
-import"./cli-4tg0hkbz.js";
+import"./cli-k5drmy8r.js";
 import"./cli-mm48br00.js";
 import"./cli-xq45etg1.js";
-import"./cli-xddtv3yn.js";
-import"./cli-f1jfrqgf.js";
+import"./cli-5fhqfx04.js";
+import"./cli-e0kbye4s.js";
+import"./cli-9a0a3v13.js";
 import"./cli-0xc5htv7.js";
 import"./cli-t0pb7qbs.js";
 import"./cli-k4tqwah4.js";

package/dist/{fix-0r974yge.js → fix-7aajsdbf.js}

@@ -5,7 +5,7 @@ import {
 } from "./cli-daqkdnm1.js";
 import {
   assertFlags
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   callControlAPI
 } from "./cli-0xc5htv7.js";

package/dist/{harness-72ejenza.js → harness-1rn1hqzz.js}

@@ -40,15 +40,16 @@ import {
   writeHarnessAnalyzeResult,
   writeHarnessArtifacts,
   writeHumanProgress
-} from "./cli-azage7s0.js";
+} from "./cli-s1w5phms.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import {
   HARNESS_ANALYZE_CONCERNS
 } from "./cli-cesds766.js";
 import"./cli-qpq84eee.js";
-import"./cli-xddtv3yn.js";
-import"./cli-f1jfrqgf.js";
+import"./cli-5fhqfx04.js";
+import"./cli-e0kbye4s.js";
+import"./cli-9a0a3v13.js";
 import"./cli-0xc5htv7.js";
 import"./cli-t0pb7qbs.js";
 import"./cli-k4tqwah4.js";

package/dist/{harness-github-actions-2qc4gg2w.js → harness-github-actions-m95qvgbs.js}

@@ -1,12 +1,13 @@
 import {
   buildSourceSnapshot
-} from "./cli-azage7s0.js";
+} from "./cli-s1w5phms.js";
 import"./cli-xq45etg1.js";
 import"./cli-97fnztpy.js";
 import"./cli-cesds766.js";
 import"./cli-qpq84eee.js";
-import"./cli-xddtv3yn.js";
-import"./cli-f1jfrqgf.js";
+import"./cli-5fhqfx04.js";
+import"./cli-e0kbye4s.js";
+import"./cli-9a0a3v13.js";
 import"./cli-0xc5htv7.js";
 import {
   recordApiRequest