@moda-ai/cli 1.55.41 → 1.55.43

package/dist/{cli-f1jfrqgf.js → cli-9a0a3v13.js}

@@ -36,8 +36,20 @@ var daysBackFlag = (fallback) => {
 var ISO_BOUND_MESSAGE = "must be an ISO 8601 date (2026-10-07) or datetime (2026-10-07T14:30:00Z)";
 var ISO_BOUND = /^\d{4}-\d{2}-\d{2}(?:[Tt ]\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:[Zz]|[+-]\d{2}:?\d{2})?)?$/;
 var isoBoundFlag = () => z.string().trim().regex(ISO_BOUND, ISO_BOUND_MESSAGE).optional();
+var COHORT_REF = /^(all|builtin:[a-z_]{1,64}|[a-z_]{1,64}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/;
+var COHORT_REF_MESSAGE = "must be builtin:<key> or a saved cohort id (see moda cohorts list)";
+var cohortFlag = (description) => z.string().regex(COHORT_REF, COHORT_REF_MESSAGE).optional().describe(description);
+var CLUSTER_COHORT_TIME_RANGES = ["all", "3d", "7d", "30d"];
+var TREND_UNITS = ["conversation", "segment", "turn"];
+var compareFlag = () => boolFlag().describe("Add summary.compare: the dashboard KPI tiles and rate for this window against the previous window of equal length");
 var OverviewSchema = z.object({
-  days_back: daysBackFlag(7)
+  days_back: daysBackFlag(7),
+  compare: boolFlag().describe("Add trends: overview KPIs, per-unit rates and each detector family, against the previous window of equal length"),
+  series: boolFlag().describe("Add trends.series: [bucket, value] per hour (windows up to 2 days) or per day"),
+  since: isoBoundFlag().describe("Trends window start (ISO date or datetime, UTC unless an offset is given); the previous window is the same span before it"),
+  until: isoBoundFlag().describe("Trends window end, inclusive (default now); needs --since"),
+  agent_name: z.string().trim().min(1).max(200).optional().describe("Scope the trends overview KPIs to one sub-agent (the Analytics agent selector; names are in trends.agent.options)"),
+  unit: z.enum(TREND_UNITS).optional().describe("Denominator of trends.rates (default conversation)")
 });
 var ClustersSchema = z.object({
   parent_id: z.string().optional().describe("List the children of this cluster node"),
@@ -45,7 +57,8 @@ var ClustersSchema = z.object({
   search: z.string().min(2).max(200).optional().describe("Find clusters by name or meaning"),
   node_id: z.string().min(1).max(512).optional().describe("Resolve one cluster node by id (deep link)"),
   mode: z.enum(["fuzzy", "semantic", "hybrid"]).optional().describe("Cluster search mode (server default hybrid)"),
-  limit: z.number().int().min(1).max(50).optional().describe("Maximum clusters to return (with --search/--node-id)")
+  limit: z.number().int().min(1).max(50).optional().describe("Maximum clusters to return (with --search/--node-id)"),
+  cohort: cohortFlag("Only the clusters this cohort's users reach, with its segment counts (builtin:<key> or a saved cohort id); --time-range all|3d|7d|30d")
 });
 var ClusterConversationsSchema = z.object({
   node_id: z.string().describe("Cluster node id (from moda clusters)"),
@@ -64,6 +77,7 @@ var ConversationsSchema = z.object({
   outcome: z.enum(["any", "positive", "negative"]).default("any").optional().describe("Filter by trace outcome (trajectory + frustration)"),
   include_world_state: boolFlag().describe("Attach each result's world-state summary"),
   sort: z.enum(["recent", "longest", "slowest"]).optional().describe("recent = newest activity, longest = most messages, slowest = longest span"),
+  cohort: cohortFlag("Only traces of this cohort's current members (builtin:<key> or a saved cohort id)"),
   limit: z.number().int().min(1).max(100).default(20).optional().describe("Maximum traces to return"),
   offset: z.number().int().min(0).default(0).optional().describe("Number of traces to skip")
 });
@@ -124,18 +138,20 @@ var emotionTraceFilters = {
   trajectory: z.enum(EMOTION_TRAJECTORIES).optional().describe("How the emotion moved over the trace; needs --group-by=trace"),
   signal: emotionSignalsFlag(),
   sort: z.enum(EMOTION_TRACE_SORTS).optional().describe("Trace order (default score); needs --group-by=trace"),
-  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc); needs --group-by=trace")
+  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc); needs --group-by=trace"),
+  cohort: cohortFlag("Only traces of this cohort's members, summary included (builtin:<key> or a saved cohort id); implies --group-by=trace")
 };
 var TRACE_GRAIN_FLAGS = {
-  emotions: ["search", "status", "elicitor", "trajectory", "signal", "sort", "order"],
-  frustrations: ["search", "status", "elicitor", "trajectory", "signal", "sort", "order"],
-  hallucinations: ["search", "status", "rule", "source", "sort", "order"]
+  emotions: ["search", "status", "elicitor", "trajectory", "signal", "sort", "order", "cohort"],
+  frustrations: ["search", "status", "elicitor", "trajectory", "signal", "sort", "order", "cohort"],
+  hallucinations: ["search", "status", "rule", "source", "sort", "order", "cohort"]
 };
 var MAX_CONVERSATION_IDS_FILTER = 50;
 var conversationIdsFlag = () => z.string().min(1).max(MAX_CONVERSATION_IDS_FILTER * 257).optional().describe(`Scope everything to several trace IDs, comma-separated (up to ${MAX_CONVERSATION_IDS_FILTER}; or --ids-from)`);
 var idsFromFilterFlag = () => z.string().min(1).optional().describe(`Read the trace IDs to scope to from a file, or - for stdin, one per line (up to ${MAX_CONVERSATION_IDS_FILTER})`);
 var FrustrationsSchema = z.object({
   days_back: daysBackFlag(7),
+  compare: compareFlag(),
   limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
   offset: z.number().int().min(0).default(0).optional().describe("Number of detections to skip"),
   include_window: boolFlag().describe("Attach the surrounding messages to each detection (agent output omits them by default)"),
@@ -147,14 +163,15 @@ var FrustrationsSchema = z.object({
   ids_from: idsFromFilterFlag()
 });
 var ToolFailuresSchema = z.object({
-  days_back: daysBackFlag(7)
+  days_back: daysBackFlag(7),
+  cohort: cohortFlag("The dashboard Tool Failures leaderboard for this cohort's traces (builtin:<key> or a saved cohort id)"),
+  compare: compareFlag()
 });
 var PROBLEM_LIST_VIEWS = ["auto", "book", "dream"];
 var BOOK_PROBLEM_SORTS = ["rank", "users", "signals", "problems"];
 var DREAM_PROBLEM_SORTS = ["severity", "users", "silent"];
 var PROBLEMS_MAX_LIMIT = 200;
 var PROBLEMS_DEFAULT_LIMIT = 10;
-var COHORT_REF = /^(all|builtin:[a-z_]{1,64}|[a-z_]{1,64}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/;
 var ProblemsSchema = z.object({
   view: z.enum(PROBLEM_LIST_VIEWS).default("auto").optional().describe("auto: what the dashboard shows (the dream grouping when published, else the Book); book or dream to force one"),
   days_back: daysBackFlag().describe("Whole days to look back (Book default 30; the dream view defaults to its run window)"),
@@ -163,7 +180,7 @@ var ProblemsSchema = z.object({
   list_version: z.string().regex(/^[0-9a-f]{1,64}$/, "must be the list_version of a previous page").optional().describe("list_version of the first page, passed with every later --offset"),
   sort: z.string().regex(/^(rank|severity|users|signals|problems|silent|signal:[a-z_]{1,64})$/, "must be rank, severity, users, silent (dream), signals, problems or signal:<family> (Book)").optional().describe("Order: rank (default), users; dream: severity, silent; Book: signals, problems, signal:<family>"),
   dir: z.enum(["desc", "asc"]).optional().describe("Sort direction (default desc)"),
-  cohort: z.string().regex(COHORT_REF, "must be builtin:<key> or a saved cohort id").optional().describe("Only the Problems this cohort hit (builtin:<key> or a saved cohort id), with its counts")
+  cohort: cohortFlag("Only the Problems this cohort hit (builtin:<key> or a saved cohort id), with its counts")
 });
 var REMAINDER_FAMILIES = [
   "tool_failure",
@@ -220,7 +237,8 @@ var ProblemSchema = z.object({
   door: z.enum(PROBLEM_DOORS).optional().describe("With --traces: only this attribution door"),
   view: z.enum(["book", "dream"]).optional().describe("dream: the dream view of the problem (definition, severity, incidents with verdicts); default the dossier"),
   offset: z.number().int().min(0).max(1e4).optional().describe("With --view=dream: first incident to return"),
-  days_back: daysBackFlag().describe("With --view=dream: whole days to count (default the dream run window)")
+  days_back: daysBackFlag().describe("With --view=dream: whole days to count (default the dream run window). With --trend: days of history (default 30)"),
+  trend: boolFlag().describe("Incidents and users per day, and the window against the previous window of equal length")
 });
 var PROBLEM_FEEDBACK_ACTIONS = [
   "mark_fixed",
@@ -248,7 +266,8 @@ var SignalSchema = z.object({
   detections: boolFlag().describe("List recent hits instead of the summary"),
   days_back: daysBackFlag(),
   limit: z.number().int().min(1).max(20).optional().describe("Hits page size (server default 10)"),
-  offset: z.number().int().min(0).max(1e4).optional().describe("Number of hits to skip")
+  offset: z.number().int().min(0).max(1e4).optional().describe("Number of hits to skip"),
+  cohort: cohortFlag("Only hits on traces of this cohort's members (builtin:<key> or a saved cohort id); with --detections")
 });
 var SIGNAL_LABELS = ["fits", "does_not_fit"];
 var SignalLabelSchema = z.object({
@@ -318,6 +337,7 @@ var EMOTION_FAMILIES = [
 ];
 var EmotionsSchema = z.object({
   days_back: daysBackFlag(7),
+  compare: compareFlag(),
   limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
   offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   family: z.enum(EMOTION_FAMILIES).optional().describe("Only this family in the detections list (summary covers all)"),
@@ -330,6 +350,7 @@ var EmotionsSchema = z.object({
 });
 var HallucinationsSchema = z.object({
   days_back: daysBackFlag(7),
+  compare: compareFlag(),
   limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
   offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   conversation_id: z.string().max(200).optional().describe("Scope summary and list to one trace ID"),
@@ -342,7 +363,8 @@ var HallucinationsSchema = z.object({
   rule: z.string().trim().min(1).max(200).optional().describe("One rule_id from summary.rule_breakdown; scopes the summary too; needs --group-by=trace"),
   source: z.enum(HALLUCINATION_SOURCES).optional().describe("Only detections from this source; needs --group-by=trace"),
   sort: z.enum(HALLUCINATION_TRACE_SORTS).optional().describe("Trace order (default contradicted_count); needs --group-by=trace"),
-  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc); needs --group-by=trace")
+  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc); needs --group-by=trace"),
+  cohort: cohortFlag("Only traces of this cohort's members, summary included (builtin:<key> or a saved cohort id); implies --group-by=trace")
 });
 var LAZINESS_FAMILIES = [
   "omission_comment",
@@ -367,6 +389,7 @@ var LAZINESS_FAMILIES = [
 ];
 var LazinessSchema = z.object({
   days_back: daysBackFlag(7),
+  compare: compareFlag(),
   limit: z.number().int().min(1).max(50).default(10).optional().describe("Maximum detections to return"),
   offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   conversation_id: z.string().max(200).optional().describe("One trace's detections"),
@@ -377,7 +400,8 @@ var LazinessSchema = z.object({
   search: z.string().trim().min(1).max(200).optional().describe("Trace ID substring"),
   status: z.enum(["all", "strong"]).optional().describe("all (default), or strong: traces with a high-confidence detection"),
   sort: z.enum(LAZINESS_TRACE_SORTS).optional().describe("Trace order (default detections_count)"),
-  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc)")
+  order: z.enum(SORT_ORDERS).optional().describe("Sort direction (default desc)"),
+  cohort: cohortFlag("Only traces of this cohort's members (builtin:<key> or a saved cohort id); not with --conversation-id")
 });
 var StepScoresSchema = z.object({
   conversation_id: z.string().min(1).describe("Trace ID")
@@ -489,7 +513,7 @@ var UsersSchema = z.object({
   page_size: z.number().int().min(1).optional().describe("Users per page"),
   limit: z.number().int().min(1).optional().describe("Alias of --page-size"),
   search: z.string().optional().describe("Match user id or name"),
-  cohort: z.enum(USER_COHORTS).optional().describe("Only users in this cohort"),
+  cohort: cohortFlag(`Only users in this cohort: builtin:<key>, a saved cohort id, or a built-in key (${USER_COHORTS.filter((key) => key !== "all").join(", ")})`),
   sort: z.enum(USER_SORTS).optional().describe("Sort field"),
   order: z.enum(["asc", "desc"]).optional().describe("Sort order"),
   health_status: z.string().optional().describe(`Comma-separated health states (${USER_HEALTH.join(", ")})`),
@@ -510,6 +534,52 @@ var ProblemReopenSchema = z.object({
   reason: z.string().max(500).optional().describe("Why it is being reopened"),
   dry_run: boolFlag().describe("Print the request and send nothing")
 });
+var COHORT_COLORS = ["neutral", "blue", "green", "amber", "red", "violet"];
+var COHORT_COMPARE_DAYS = ["7", "30", "90"];
+var cohortTenant = () => z.string().optional().describe("Tenant to read; must match the API key's tenant");
+var cohortRef = (description) => z.string().regex(COHORT_REF, COHORT_REF_MESSAGE).describe(description);
+var cohortDefinitionFlags = {
+  definition: z.string().optional().describe("Cohort definition (DSL v1) as inline JSON; see moda cohorts fields"),
+  file: z.string().optional().describe("JSON file with the definition, or a body with a definition key")
+};
+var CohortsListSchema = z.object({
+  include_archived: boolFlag().describe("Also list archived saved cohorts"),
+  tenant_id: cohortTenant()
+});
+var CohortGetSchema = z.object({
+  ref: cohortRef("builtin:<key> or a saved cohort id"),
+  tenant_id: cohortTenant()
+});
+var CohortFieldsSchema = z.object({
+  tenant_id: cohortTenant()
+});
+var CohortPreviewSchema = z.object({
+  ...cohortDefinitionFlags,
+  tenant_id: cohortTenant()
+});
+var CohortCompareSchema = z.object({
+  a: cohortRef("First cohort: builtin:<key> or a saved cohort id"),
+  b: cohortRef("Second cohort: builtin:<key> or a saved cohort id"),
+  days: z.enum(COHORT_COMPARE_DAYS).optional().describe("Window for top topics and failure mix (server default 30)"),
+  tenant_id: cohortTenant()
+});
+var cohortFieldFlags = {
+  name: z.string().max(120).optional().describe("Cohort name"),
+  description: z.string().max(2000).optional().describe("Cohort description"),
+  ...cohortDefinitionFlags,
+  pinned: boolFlag().describe("Pin the cohort on the Users page"),
+  color: z.enum(COHORT_COLORS).optional().describe("Pill color")
+};
+var CohortCreateSchema = z.object({
+  ...cohortFieldFlags,
+  tenant_id: cohortTenant()
+});
+var CohortUpdateSchema = z.object({
+  id: z.string().regex(UUID_RE, "must be a saved cohort id (UUID); built-in cohorts cannot be edited").describe("Saved cohort id"),
+  ...cohortFieldFlags,
+  note: z.string().max(500).optional().describe("Why it changed (kept with the revision)"),
+  tenant_id: cohortTenant()
+});
 
 // ../../packages/database/src/agent-feedback.ts
 var FEEDBACK_CATEGORIES = [
@@ -716,7 +786,18 @@ var COMMAND_FLAG_SPECS = {
     positionals: [{ name: "note", key: "note", required: true, variadic: true, alsoFlag: true }]
   },
   users: { schema: UsersSchema, handParsed: true },
-  user: { schema: UserSchema, handParsed: true, positionals: [{ name: "user_id", key: "user_id", required: true }] }
+  user: { schema: UserSchema, handParsed: true, positionals: [{ name: "user_id", key: "user_id", required: true }] },
+  "cohort-list": { schema: CohortsListSchema, handParsed: true },
+  "cohort-get": { schema: CohortGetSchema, handParsed: true, positionals: [{ name: "ref", key: "ref", required: true }] },
+  "cohort-fields": { schema: CohortFieldsSchema, handParsed: true },
+  "cohort-preview": { schema: CohortPreviewSchema, handParsed: true },
+  "cohort-compare": {
+    schema: CohortCompareSchema,
+    handParsed: true,
+    positionals: [{ name: "cohort_a", key: "a", required: true }, { name: "cohort_b", key: "b", required: true }]
+  },
+  "cohort-create": { schema: CohortCreateSchema, extra: DRY_RUN, handParsed: true },
+  "cohort-update": { schema: CohortUpdateSchema, extra: DRY_RUN, handParsed: true, positionals: [{ name: "cohort_id", key: "id", required: true }] }
 };
 function flagSpecFor(command) {
   return Object.hasOwn(COMMAND_FLAG_SPECS, command) ? COMMAND_FLAG_SPECS[command] : undefined;
@@ -1063,6 +1144,14 @@ function oneOf(name, value, allowed) {
   }
   return value;
 }
+function cohortRefFlag(value) {
+  if (value === undefined)
+    return;
+  if (!COHORT_REF.test(value)) {
+    throw new CliInputError(`--cohort must be builtin:<key> or a saved cohort id (got '${value}').`, "List the refs with `moda cohorts list`.");
+  }
+  return value;
+}
 function csv(value) {
   if (value === undefined)
     return;
@@ -1116,7 +1205,7 @@ async function runUsersCommand(context) {
     page: flags.page,
     pageSize: flags["page-size"] ?? flags.limit,
     search: flags.search,
-    cohort: oneOf("cohort", flags.cohort, USER_COHORTS),
+    cohort: cohortRefFlag(flags.cohort),
     sortBy: oneOf("sort", flags.sort, USER_SORTS),
     sortOrder: oneOf("order", flags.order, ["asc", "desc"]),
     healthStatus: csv(flags["health-status"])?.map((value) => oneOf("health-status", value, HEALTH)).join(","),
@@ -1146,6 +1235,134 @@ async function runUserCommand(context) {
   await send(context, "control", "GET", `/tenants/${encodeURIComponent(tenantId)}/users/${encodeURIComponent(userId)}${suffix}`);
   return { exitCode: 0 };
 }
+var COHORT_DEFINITION_HINT = 'A definition is {"version":1,"window":"24h|7d|30d|90d","where":{...}}; `moda cohorts fields` lists the fields and operators.';
+function cohortsBase(context) {
+  return `/tenants/${encodeURIComponent(requireTenant(context))}/cohorts`;
+}
+function cohortRefArg(value, what, usage) {
+  if (!value)
+    throw new CliInputError(`${what} is required.`, `Usage: ${usage}`);
+  if (!COHORT_REF.test(value)) {
+    throw new CliInputError(`${what} must be builtin:<key> or a saved cohort id (got '${value}').`, "List the refs with `moda cohorts list`.");
+  }
+  return value;
+}
+function cohortBodyInput(flags, cwd) {
+  const fromFile = readBodyFile(flags, cwd);
+  const body = Object.keys(fromFile).length === 0 ? {} : ("definition" in fromFile) ? fromFile : { definition: fromFile };
+  if (flags.definition !== undefined) {
+    let parsed;
+    try {
+      parsed = JSON.parse(flags.definition);
+    } catch (error) {
+      throw new CliInputError(`--definition is not valid JSON: ${error instanceof Error ? error.message : String(error)}`, COHORT_DEFINITION_HINT);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+      throw new CliInputError("--definition must be a JSON object.", COHORT_DEFINITION_HINT);
+    body.definition = parsed;
+  }
+  if (body.definition !== undefined && (!body.definition || typeof body.definition !== "object" || Array.isArray(body.definition))) {
+    throw new CliInputError("The cohort definition must be a JSON object.", COHORT_DEFINITION_HINT);
+  }
+  return body;
+}
+function cohortFieldBody(flags, cwd) {
+  const pinned = flags.pinned === undefined ? undefined : oneOf("pinned", flags.pinned, ["true", "false", "1", "0", "yes", "no"]);
+  return {
+    ...cohortBodyInput(flags, cwd),
+    ...compact({
+      name: flags.name,
+      description: flags.description,
+      pinned: pinned === undefined ? undefined : ["true", "1", "yes"].includes(pinned),
+      color: oneOf("color", flags.color, COHORT_COLORS)
+    })
+  };
+}
+var COHORT_COMMANDS = {
+  "cohort-list": { path: "cohorts list", usage: "moda cohorts list [--include-archived]" },
+  "cohort-get": { path: "cohorts get", usage: "moda cohorts get <ref>" },
+  "cohort-fields": { path: "cohorts fields", usage: "moda cohorts fields" },
+  "cohort-preview": { path: "cohorts preview", usage: "moda cohorts preview --file=<path> | --definition=<json>" },
+  "cohort-compare": { path: "cohorts compare", usage: "moda cohorts compare <cohort_a> <cohort_b> [--days=7|30|90]" },
+  "cohort-create": { path: "cohorts create", usage: "moda cohorts create --name=NAME --file=<path>|--definition=<json> [--description --pinned --color] [--dry-run]" },
+  "cohort-update": { path: "cohorts update", usage: "moda cohorts update <cohort_id> [--name --description --file|--definition --pinned --color --note] [--dry-run]" }
+};
+async function runCohortCommand(context) {
+  const flags = context.flags;
+  const command = COHORT_COMMANDS[context.command];
+  if (!command)
+    throw new CliInputError(`Unknown cohorts command '${context.command}'.`, "Run 'moda cohorts --help'.");
+  const spec = flagSpecFor(context.command);
+  assertFlags(command.path, flags, spec ? specFlagNames(spec) : []);
+  assertPositionals(command.path, context.positionals, spec?.positionals?.length ?? 0, command.usage);
+  const [first, second] = context.positionals;
+  switch (context.command) {
+    case "cohort-list": {
+      requireKey(context);
+      const archived = flags["include-archived"];
+      const query = archived !== undefined && archived !== "false" && archived !== "0" ? "?includeArchived=1" : "";
+      await send(context, "control", "GET", `${cohortsBase(context)}${query}`);
+      return { exitCode: 0 };
+    }
+    case "cohort-get": {
+      const ref = cohortRefArg(first, "<ref>", "moda cohorts get <ref>");
+      requireKey(context);
+      await send(context, "control", "GET", `${cohortsBase(context)}/${encodeURIComponent(ref)}`);
+      return { exitCode: 0 };
+    }
+    case "cohort-fields": {
+      requireKey(context);
+      await send(context, "control", "GET", `${cohortsBase(context)}/fields`);
+      return { exitCode: 0 };
+    }
+    case "cohort-preview": {
+      const { definition } = cohortBodyInput(flags, context.cwd);
+      if (definition === undefined)
+        throw new CliInputError("Pass the definition with --file=<path> or --definition=<json>.", COHORT_DEFINITION_HINT);
+      requireKey(context);
+      const data = await callControlAPI(`${cohortsBase(context)}/preview`, { method: "POST", body: JSON.stringify({ definition }) }, profileOptions(context));
+      context.output.writeData(data ?? {});
+      return { exitCode: 0 };
+    }
+    case "cohort-compare": {
+      const usage = "moda cohorts compare <cohort_a> <cohort_b> [--days=7|30|90]";
+      const a = cohortRefArg(first, "<cohort_a>", usage);
+      const b = cohortRefArg(second, "<cohort_b>", usage);
+      const days = oneOf("days", flags.days, COHORT_COMPARE_DAYS);
+      requireKey(context);
+      const query = new URLSearchParams(compact({ a, b, days }));
+      await send(context, "control", "GET", `${cohortsBase(context)}/compare?${query.toString()}`);
+      return { exitCode: 0 };
+    }
+    case "cohort-create": {
+      const body = cohortFieldBody(flags, context.cwd);
+      const missing = ["name", "definition"].filter((field) => body[field] === undefined);
+      if (missing.length > 0) {
+        throw new CliInputError(`Missing ${missing.join(" and ")} for cohorts create, so nothing was sent.`, `Pass --name and --file=<definition.json> (or --definition=<json>). ${COHORT_DEFINITION_HINT} Check the members first with \`moda cohorts preview\`.`);
+      }
+      requireKey(context);
+      await send(context, "control", "POST", cohortsBase(context), body);
+      return { exitCode: 0 };
+    }
+    case "cohort-update": {
+      const usage = "moda cohorts update <cohort_id> [--name --description --file|--definition --pinned --color --note] [--dry-run]";
+      if (!first)
+        throw new CliInputError("<cohort_id> is required.", `Usage: ${usage}`);
+      if (!UUID_RE2.test(first)) {
+        throw new CliInputError(`<cohort_id> must be a saved cohort id (UUID), got '${first}'. Built-in cohorts cannot be edited.`, "List saved cohorts with `moda cohorts list`.");
+      }
+      const body = { ...cohortFieldBody(flags, context.cwd), ...compact({ note: flags.note }) };
+      if (Object.keys(body).filter((key) => key !== "note").length === 0) {
+        throw new CliInputError("Nothing to update, so nothing was sent: pass at least one of --name, --description, --file/--definition, --pinned or --color.", `Usage: ${usage}`);
+      }
+      requireKey(context);
+      await send(context, "control", "PATCH", `${cohortsBase(context)}/${encodeURIComponent(first)}`, body);
+      return { exitCode: 0 };
+    }
+    default:
+      throw new CliInputError(`Unknown cohorts command '${context.command}'.`, "Run 'moda cohorts --help'.");
+  }
+}
 async function runProblemReopenCommand(context) {
   assertFlags("problem-reopen", context.flags, specFlagNames(COMMAND_FLAG_SPECS["problem-reopen"]));
   assertPositionals("problem-reopen", context.positionals, 1, "moda problems reopen <problem_id> [--reason=TEXT]");
@@ -1447,4 +1664,4 @@ function unknownSignalsSubcommandError(sub, args = []) {
   ${SIGNAL_USAGE}`);
 }
 
-export { TRACE_GRAIN_FLAGS, MAX_CONVERSATION_IDS_FILTER, BOOK_PROBLEM_SORTS, DREAM_PROBLEM_SORTS, PROBLEMS_MAX_LIMIT, PROBLEMS_DEFAULT_LIMIT, ProblemsRemainderSchema, UUID_RE, ProblemImpactSchema, PROBLEM_FEEDBACK_ACTIONS, ProblemFeedbackSchema, ProblemLinearFileSchema, SignalLabelSchema, DETECTION_VERDICTS, DetectionReviewSchema, FALSE_POSITIVE_KINDS, FalsePositiveSchema, EMOTION_FAMILIES, LAZINESS_FAMILIES, StepScoresSchema, AuditSchema, TraceFindingsSchema, FEEDBACK_USAGE, isFeedbackRefFlag, buildFeedbackRequest, writeDryRun, COMMAND_FLAG_SPECS, flagSpecFor, kebabFlag, schemaShape, describeField, specFlagKeys, specFlagNames, describeSpecFlags, closestMatches, usageLine, renderFlagHelp, subcommandHelpFlags, manifestFlagFields, requireTenant, assertFlags, assertPositionals, runUsersCommand, runUserCommand, runProblemReopenCommand, runSignalsManagementCommand, SIGNALS_MANAGEMENT_SUBCOMMANDS, unknownSignalsSubcommandError };
+export { CLUSTER_COHORT_TIME_RANGES, TRACE_GRAIN_FLAGS, MAX_CONVERSATION_IDS_FILTER, BOOK_PROBLEM_SORTS, DREAM_PROBLEM_SORTS, PROBLEMS_MAX_LIMIT, PROBLEMS_DEFAULT_LIMIT, ProblemsRemainderSchema, UUID_RE, ProblemImpactSchema, PROBLEM_FEEDBACK_ACTIONS, ProblemFeedbackSchema, ProblemLinearFileSchema, SignalLabelSchema, DETECTION_VERDICTS, DetectionReviewSchema, FALSE_POSITIVE_KINDS, FalsePositiveSchema, EMOTION_FAMILIES, LAZINESS_FAMILIES, StepScoresSchema, AuditSchema, TraceFindingsSchema, FEEDBACK_USAGE, isFeedbackRefFlag, buildFeedbackRequest, writeDryRun, COMMAND_FLAG_SPECS, flagSpecFor, kebabFlag, schemaShape, describeField, specFlagKeys, specFlagNames, describeSpecFlags, closestMatches, usageLine, renderFlagHelp, subcommandHelpFlags, manifestFlagFields, requireTenant, assertFlags, assertPositionals, runUsersCommand, runUserCommand, runCohortCommand, runProblemReopenCommand, runSignalsManagementCommand, SIGNALS_MANAGEMENT_SUBCOMMANDS, unknownSignalsSubcommandError };

package/dist/cli-e0kbye4s.js

@@ -0,0 +1,39 @@
+// src/boolean-words.ts
+var BOOLEAN_TRUE_WORDS = new Set(["true", "yes", "1", "on"]);
+var BOOLEAN_FALSE_WORDS = new Set(["false", "no", "0", "off"]);
+function parseBooleanFlagValue(value) {
+  if (typeof value === "boolean")
+    return value;
+  if (typeof value === "number")
+    return value === 1 ? true : value === 0 ? false : undefined;
+  if (typeof value !== "string")
+    return;
+  const text = value.trim().toLowerCase();
+  if (BOOLEAN_TRUE_WORDS.has(text))
+    return true;
+  if (BOOLEAN_FALSE_WORDS.has(text))
+    return false;
+  return;
+}
+function flagValue(flags, name) {
+  return flags[name] ?? flags[name.replace(/-/g, "_")];
+}
+function withoutFlag(flags, name) {
+  const snake = name.replace(/-/g, "_");
+  return Object.fromEntries(Object.entries(flags).filter(([key]) => key !== name && key !== snake));
+}
+function optOutFlagSet(flags, name, strict = true) {
+  const raw = flagValue(flags, name);
+  if (raw === undefined)
+    return false;
+  const value = parseBooleanFlagValue(raw);
+  return strict ? value === true : value !== false;
+}
+function envSwitchedOff(value) {
+  return parseBooleanFlagValue(value) === false;
+}
+function envOptOutSet(value) {
+  return value !== undefined && value.trim() !== "" && parseBooleanFlagValue(value) !== false;
+}
+
+export { parseBooleanFlagValue, withoutFlag, optOutFlagSet, envSwitchedOff, envOptOutSet };

package/dist/{cli-ypqwcf9n.js → cli-fpd1pfvt.js}

@@ -4,7 +4,7 @@ import {
   parsePromptFileForAb,
   readPromptLock,
   runPromptSync
-} from "./cli-4tg0hkbz.js";
+} from "./cli-k5drmy8r.js";
 import {
   DEFAULT_POLL_INTERVAL_MS,
   DEFAULT_WAIT_TIMEOUT_MS,
@@ -12,7 +12,7 @@ import {
 } from "./cli-daqkdnm1.js";
 import {
   UUID_RE
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   callControlAPI,
   callDataAPI

package/dist/{cli-a8nxbtpk.js → cli-h62j4jn7.js}

@@ -4,7 +4,7 @@ import {
 } from "./cli-pmzh2qjy.js";
 import {
   inspectPromptManifest
-} from "./cli-4tg0hkbz.js";
+} from "./cli-k5drmy8r.js";
 import {
   readHarnessSyncState,
   renderDoctorHuman,
@@ -376,7 +376,7 @@ async function harnessCurrentCheck(cwd, manifestPath, manifestExists, tenantId)
     };
   }
   try {
-    const { scanHarness } = await import("./harness-72ejenza.js");
+    const { scanHarness } = await import("./harness-1rn1hqzz.js");
     const current = scanHarness({
       rootDir: cwd,
       scannerVersion: "doctor",

package/dist/{cli-4tg0hkbz.js → cli-k5drmy8r.js}

@@ -4,11 +4,11 @@ import {
 } from "./cli-mm48br00.js";
 import {
   createCommandContext
-} from "./cli-xddtv3yn.js";
+} from "./cli-5fhqfx04.js";
 import {
   assertFlags,
   assertPositionals
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   callControlAPI
 } from "./cli-0xc5htv7.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-gmd10n5d.js")).runPromptAb(flags, profileOptions, context);
+      return (await import("./prompts-ab-ws66335h.js")).runPromptAb(flags, profileOptions, context);
     case "propose":
-      await (await import("./prompts-propose-q626zmm4.js")).runPromptPropose(positionals, flags, profileOptions, context);
+      await (await import("./prompts-propose-a9m0p9nr.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-72ejenza.js");
+    const { analyzeHarnessPrompts } = await import("./harness-1rn1hqzz.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-3987hhqz.js");
+  const { checkPromptAttribution } = await import("./prompt-attribution-hc6mcvee.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-72ejenza.js");
+    const { analyzeHarnessPrompts } = await import("./harness-1rn1hqzz.js");
     const result = await analyzeHarnessPrompts({
       rootDir: root,
       existing: manifest.sources,

package/dist/{cli-azage7s0.js → cli-s1w5phms.js}

@@ -44,12 +44,12 @@ import {
 import {
   createCommandContext,
   stringOption
-} from "./cli-xddtv3yn.js";
+} from "./cli-5fhqfx04.js";
 import {
   assertFlags,
   assertPositionals,
   requireTenant
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   ApiError,
   callControlAPI
@@ -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-2qc4gg2w.js");
+        const { runGithubActionsAnalyze } = await import("./harness-github-actions-m95qvgbs.js");
         const result = await runGithubActionsAnalyze(rootDir, {
           writeReport: (report2) => {
             const normalized = normalizeHarnessReport(report2);

package/dist/{cli-7bn406mt.js → cli-stfpr2ct.js}

@@ -13,12 +13,12 @@ import {
 } from "./cli-hcwdz9sd.js";
 import {
   createCommandContext
-} from "./cli-xddtv3yn.js";
+} from "./cli-5fhqfx04.js";
 import {
   assertFlags,
   assertPositionals,
   writeDryRun
-} from "./cli-f1jfrqgf.js";
+} from "./cli-9a0a3v13.js";
 import {
   callControlAPI
 } from "./cli-0xc5htv7.js";