@moda-ai/cli 1.55.37 → 1.55.39

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   withFrustrationAnchors,
   withToolFailureAnchors,
   withoutDetectionWindows
-} from "./cli-nqgyz74b.js";
+} from "./cli-1vqq24qh.js";
 import {
   createCommandContext,
   envOptOutSet,
@@ -28,17 +28,21 @@ import {
   optOutFlagSet,
   parseBooleanFlagValue,
   withoutFlag
-} from "./cli-4d92a450.js";
+} from "./cli-jkza0bj6.js";
 import {
   AuditSchema,
+  BOOK_PROBLEM_SORTS,
   COMMAND_FLAG_SPECS,
   DETECTION_VERDICTS,
+  DREAM_PROBLEM_SORTS,
   DetectionReviewSchema,
   EMOTION_FAMILIES,
   FALSE_POSITIVE_KINDS,
   FEEDBACK_USAGE,
   FalsePositiveSchema,
   LAZINESS_FAMILIES,
+  PROBLEMS_DEFAULT_LIMIT,
+  PROBLEMS_MAX_LIMIT,
   PROBLEM_FEEDBACK_ACTIONS,
   ProblemFeedbackSchema,
   ProblemImpactSchema,
@@ -47,6 +51,7 @@ import {
   SIGNALS_MANAGEMENT_SUBCOMMANDS,
   SignalLabelSchema,
   StepScoresSchema,
+  TRACE_GRAIN_FLAGS,
   UUID_RE,
   assertFlags,
   assertPositionals,
@@ -70,12 +75,12 @@ import {
   unknownSignalsSubcommandError,
   usageLine,
   writeDryRun
-} from "./cli-cdx6yd7m.js";
+} from "./cli-k9se46y4.js";
 import {
   ApiError,
   callControlAPI,
   callDataAPI
-} from "./cli-s72pph9c.js";
+} from "./cli-qzag917n.js";
 import {
   AGENT_ERROR_CODES,
   EXIT_AUTH_REQUIRED,
@@ -112,7 +117,7 @@ import {
   shellArg,
   validateConfig,
   wasOutputCancelled
-} from "./cli-wg6e2a1g.js";
+} from "./cli-wr6f0kyw.js";
 import {
   CliAccessError,
   CliAuthError,
@@ -1155,8 +1160,8 @@ var CANONICAL_LEAVES = [
     path: "problems list",
     args: "",
     handler: "problems",
-    summary: "Rank cross-signal Problems by root cause (what to fix first)",
-    examples: ["moda problems list", "moda problems list --days-back=7 --limit=10"]
+    summary: "The Problems the dashboard shows, ranked (the dream grouping when published, else the Book)",
+    examples: ["moda problems list", "moda problems list --sort=users --limit=20", "moda problems list --view=book --days-back=7 --offset=10 --list-version=<list_version>"]
   },
   {
     noun: "problems",
@@ -1164,8 +1169,8 @@ var CANONICAL_LEAVES = [
     path: "problems get",
     args: "<problem_id>",
     handler: "problem",
-    summary: "One Problem: dossier, or its --evidence/--reports/--traces/--feedback pages",
-    examples: ["moda problems get <problem_id>", "moda problems get <problem_id> --evidence --limit=10", "moda problems get <problem_id> --traces --family=tool_failure"]
+    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"]
   },
   {
     noun: "problems",
@@ -2981,46 +2986,46 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-90v9eg2k.js")).runPromptsCommand(...args);
+  return (await import("./prompts-p9hhxx0c.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
-  return (await import("./skills-z7w5x7jj.js")).runSkillsCommand(...args);
+  return (await import("./skills-rk2pmwx8.js")).runSkillsCommand(...args);
 }
 async function runFixCommand(...args) {
-  return (await import("./fix-667fyx00.js")).runFixCommand(...args);
+  return (await import("./fix-s3zkjt69.js")).runFixCommand(...args);
 }
 async function runFixesCommand(...args) {
-  return (await import("./fix-667fyx00.js")).runFixesCommand(...args);
+  return (await import("./fix-s3zkjt69.js")).runFixesCommand(...args);
 }
 async function runHarnessCommand(...args) {
-  return (await import("./harness-fb0083ap.js")).runHarnessCommand(...args);
+  return (await import("./harness-n4569wbm.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-r32tgpar.js")).runSyncCommand(...args);
+  return (await import("./sync-xxbfjcz5.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
-  return (await import("./registry-qvjyvbk8.js")).runRegistryCommand(...args);
+  return (await import("./registry-nq8qsqtv.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-w8z3wj1e.js")).runDoctorCommand(...args);
+  return (await import("./doctor-3v20hc26.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-w8z3wj1e.js")).runStatusCommand(...args);
+  return (await import("./doctor-3v20hc26.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
-  return (await import("./profile-commands-3hw4trwk.js")).runAuthCommand(...args);
+  return (await import("./profile-commands-7ck1tqfv.js")).runAuthCommand(...args);
 }
 async function runConfigCommand(...args) {
-  return (await import("./profile-commands-3hw4trwk.js")).runConfigCommand(...args);
+  return (await import("./profile-commands-7ck1tqfv.js")).runConfigCommand(...args);
 }
 async function runProfilesCommand(...args) {
-  return (await import("./profile-commands-3hw4trwk.js")).runProfilesCommand(...args);
+  return (await import("./profile-commands-7ck1tqfv.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-4pyeecf7.js")).runAgentCommand(...args);
+  return (await import("./agent-bhe95ae8.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
-  return (await import("./production-intelligence-v2wq2aqv.js")).runProductionCommand(...args);
+  return (await import("./production-intelligence-z2cad1hv.js")).runProductionCommand(...args);
 }
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -3675,7 +3680,7 @@ var TOOL_FAILURE_DETAIL_DEFAULT_LIMIT = 5;
 var TOOL_FAILURE_AGENT_SUBTYPES = 20;
 var TOOL_FAILURE_CATALOG_LINKS = 3;
 var TOOL_CATALOG_DEFAULT_LIMIT = 25;
-async function printWithOptionalWindows(enriched, listKey, includeWindow, windowSize, output, warnings, finalize, nextCommands = []) {
+async function printWithOptionalWindows(enriched, listKey, includeWindow, windowSize, output, warnings, finalize, nextCommands = [], summary) {
   const allWarnings = [...warnings ?? []];
   let data = enriched;
   if (includeWindow) {
@@ -3686,6 +3691,7 @@ async function printWithOptionalWindows(enriched, listKey, includeWindow, window
   if (finalize)
     data = finalize(data, allWarnings);
   const options = {
+    ...summary ? { summary } : {},
     ...allWarnings.length > 0 ? { warnings: allWarnings } : {},
     ...nextCommands.length > 0 ? { nextCommands } : {}
   };
@@ -4144,7 +4150,7 @@ var WINDOW_FLAG_HINTS = {
 var COMMAND_FLAG_HINTS = {
   problems: {
     family: "'moda problems' ranks every family together. To filter by family use 'moda problems unexplained --family=<family>' (signals no Problem explains yet) or 'moda problems get <problem_id> --traces --family=<family>' (one Problem's traces).",
-    cursor: "'moda problems' has no cursor; 'moda problems unexplained --cursor=<next_cursor>' pages the unexplained signals."
+    cursor: "'moda problems list' pages with --offset=<next_offset> --list-version=<list_version>; 'moda problems unexplained --cursor=<next_cursor>' pages the unexplained signals."
   }
 };
 function parseCommandFlags(schema, args, command, options = {}) {
@@ -4519,6 +4525,260 @@ async function runProblemsRemainder(flags, context) {
   const queryString = query2.toString() ? `?${query2.toString()}` : "";
   context.output.writeData(await callDataAPI(`/problems/remainder${queryString}`));
 }
+var isDreamOnlySort = (sort) => sort === "severity" || sort === "silent";
+var isBookOnlySort = (sort) => sort === "signals" || sort === "problems" || (sort?.startsWith("signal:") ?? false);
+function problemsListCommand(params, view, page, daysGiven) {
+  const parts = ["moda problems list", `--view=${view}`];
+  if (daysGiven && params.days_back !== undefined)
+    parts.push(`--days-back=${params.days_back}`);
+  parts.push(`--limit=${params.limit ?? PROBLEMS_DEFAULT_LIMIT}`);
+  if (params.sort)
+    parts.push(`--sort=${shellArg(params.sort)}`);
+  if (params.dir)
+    parts.push(`--dir=${params.dir}`);
+  if (params.cohort)
+    parts.push(`--cohort=${shellArg(params.cohort)}`);
+  parts.push(`--offset=${page.offset}`, `--list-version=${page.listVersion}`);
+  return parts.join(" ");
+}
+function listVersionWarning(params, served) {
+  if (!params.list_version || typeof served !== "string" || served === params.list_version)
+    return [];
+  return [
+    `The list changed since --list-version=${params.list_version} was read (this page is list_version=${served}). Offsets of the two lists do not line up: restart from the first page (drop --offset and --list-version).`
+  ];
+}
+function hierarchyForPage(payload) {
+  const hierarchy = asRecord(payload.hierarchy);
+  if (!hierarchy || !Array.isArray(hierarchy.macros))
+    return payload;
+  const shown = new Set([...Array.isArray(payload.problems) ? payload.problems : [], ...Array.isArray(payload.untrusted) ? payload.untrusted : []].map((row) => asRecord(row)?.problem_id).filter((id) => typeof id === "string"));
+  const macros = hierarchy.macros.map((macro) => {
+    const record = asRecord(macro);
+    if (!record || !Array.isArray(record.children))
+      return macro;
+    return { ...record, children: record.children.filter((id) => typeof id === "string" && shown.has(id)) };
+  });
+  return { ...payload, hierarchy: { ...hierarchy, macros, children_listed: "this page only; child_count is the full size" } };
+}
+async function runProblemsList(flags, context, command) {
+  const args = flagsToArgs(flags);
+  const params = parseSpecFlags("problems", args, command);
+  const view = params.view ?? "auto";
+  const daysGiven = args.days_back !== undefined;
+  const limit = params.limit ?? PROBLEMS_DEFAULT_LIMIT;
+  const offset = params.offset ?? 0;
+  if (view === "book" && isDreamOnlySort(params.sort)) {
+    throw new CliInputError(`--sort=${params.sort} orders the dream view; the Book sorts by ${BOOK_PROBLEM_SORTS.join(", ")} or signal:<family>.`);
+  }
+  if (view === "dream" && isBookOnlySort(params.sort)) {
+    throw new CliInputError(`--sort=${params.sort} orders the Book; the dream view sorts by rank, ${DREAM_PROBLEM_SORTS.join(", ")}.`);
+  }
+  if (params.list_version && params.offset === undefined) {
+    throw new CliInputError("--list-version pages a list: pass it with the --offset of the next page (next_offset).");
+  }
+  if (view !== "book") {
+    const query3 = new URLSearchParams;
+    if (daysGiven && params.days_back !== undefined)
+      query3.set("days_back", String(params.days_back));
+    if (params.cohort)
+      query3.set("cohort", params.cohort);
+    const bookOnly = isBookOnlySort(params.sort);
+    query3.set("limit", String(bookOnly ? 1 : limit));
+    if (!bookOnly) {
+      if (offset > 0)
+        query3.set("offset", String(offset));
+      if (params.list_version)
+        query3.set("list_version", params.list_version);
+      if (params.sort && params.sort !== "rank")
+        query3.set("sort", params.sort);
+      if (params.dir)
+        query3.set("dir", params.dir);
+    }
+    const dream = asRecord(await callDataAPI(`/problems/dream?${query3.toString()}`)) ?? {};
+    if (dream.available === true) {
+      if (bookOnly) {
+        throw new CliInputError(`This tenant's dashboard shows the dream grouping of its Problems, which --sort=${params.sort} does not order.`, `Use --sort=rank|${DREAM_PROBLEM_SORTS.join("|")} for the dream view, or --view=book --sort=${params.sort} for the Book's ranked list.`);
+      }
+      writeDreamProblemsList(context, params, dream, { offset, limit, daysGiven });
+      return;
+    }
+    if (view === "dream") {
+      context.output.writeData({ available: false, view: "dream", dashboard_url: `${MODA_BASE_URL}/dashboard/problems` }, {
+        warnings: ["This tenant has no dream grouping published; the dashboard shows the Book. List it with: moda problems list --view=book"],
+        nextCommands: [{ command: "moda problems list --view=book", purpose: "List the Book's ranked Problems (what the dashboard shows for this tenant).", mutability: "read", requires_approval: false }]
+      });
+      return;
+    }
+  }
+  if (isDreamOnlySort(params.sort)) {
+    throw new CliInputError(`This tenant has no dream grouping published, so its Problems are the Book's ranked list, which --sort=${params.sort} does not order.`, `Use --sort=${BOOK_PROBLEM_SORTS.join("|")} or signal:<family>.`);
+  }
+  const query2 = new URLSearchParams;
+  query2.set("days_back", String(params.days_back ?? 30));
+  query2.set("limit", String(limit));
+  if (offset > 0)
+    query2.set("offset", String(offset));
+  if (params.list_version)
+    query2.set("list_version", params.list_version);
+  if (params.sort)
+    query2.set("sort", params.sort);
+  if (params.dir)
+    query2.set("dir", params.dir);
+  if (params.cohort)
+    query2.set("cohort", params.cohort);
+  const data = await callDataAPI(`/problems?${query2.toString()}`);
+  const { payload: capped, truncated } = capProblemsBlocks(asRecord(data) ?? {}, limit);
+  const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
+  const payload = agentMode ? hierarchyForPage(capped) : capped;
+  const problems = Array.isArray(payload.problems) ? payload.problems : [];
+  const untrusted = Array.isArray(payload.untrusted) ? payload.untrusted : [];
+  const nextOffset = typeof payload.next_offset === "number" ? payload.next_offset : null;
+  const listVersion = typeof payload.list_version === "string" ? payload.list_version : undefined;
+  const withLink = {
+    view: "book",
+    ...payload,
+    pagination: {
+      offset,
+      limit,
+      returned: problems.length,
+      untrusted_returned: untrusted.length,
+      has_more: nextOffset !== null,
+      next_offset: nextOffset,
+      ...listVersion ? { list_version: listVersion } : {}
+    },
+    ...truncated ? { truncated } : {},
+    dashboard_url: `${MODA_BASE_URL}/dashboard/problems`
+  };
+  const nextCommands = [];
+  if (nextOffset !== null && listVersion) {
+    nextCommands.push({
+      command: problemsListCommand(params, "book", { offset: nextOffset, listVersion }, daysGiven),
+      purpose: `Read the next page of the Book (problems and untrusted from row ${nextOffset}).`,
+      mutability: "read",
+      requires_approval: false,
+      nextPage: true
+    });
+  }
+  const top = asRecord(problems[0]) ?? asRecord(untrusted[0]);
+  if (typeof top?.problem_id === "string") {
+    nextCommands.push({ command: `moda problems get ${shellArg(top.problem_id)}`, purpose: "Open the first Problem on this page.", mutability: "read", requires_approval: false });
+  }
+  const warnings = [
+    ...serverWarnings(payload),
+    ...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 } : {}
+  });
+}
+function writeDreamProblemsList(context, params, dream, page) {
+  const problems = Array.isArray(dream.problems) ? dream.problems : [];
+  const nextOffset = typeof dream.next_offset === "number" ? dream.next_offset : null;
+  const listVersion = typeof dream.list_version === "string" ? dream.list_version : undefined;
+  const run = asRecord(dream.run);
+  const { offset: _offset, limit: _limit, next_offset: _next, list_version: _version, ...rest } = dream;
+  const data = {
+    ...rest,
+    pagination: {
+      offset: page.offset,
+      limit: page.limit,
+      returned: problems.length,
+      total: asNumber(asRecord(dream.summary)?.problems) ?? null,
+      has_more: nextOffset !== null,
+      next_offset: nextOffset,
+      ...listVersion ? { list_version: listVersion } : {}
+    },
+    dashboard_url: `${MODA_BASE_URL}/dashboard/problems`
+  };
+  const nextCommands = [];
+  if (nextOffset !== null && listVersion) {
+    nextCommands.push({
+      command: problemsListCommand(params, "dream", { offset: nextOffset, listVersion }, page.daysGiven),
+      purpose: `Read the next page of the dream grouping (from row ${nextOffset}).`,
+      mutability: "read",
+      requires_approval: false,
+      nextPage: true
+    });
+  }
+  const top = asRecord(problems[0]);
+  if (typeof top?.problem_id === "string") {
+    const id = shellArg(top.problem_id);
+    nextCommands.push({ command: `moda problems get ${id} --view=dream`, purpose: "Open the first Problem as the dashboard shows it: definition, severity and its most serious incidents.", mutability: "read", requires_approval: false }, { command: `moda problems get ${id} --evidence`, purpose: "Page the evidence behind it (dream problem ids are Book ids).", mutability: "read", requires_approval: false });
+  }
+  const windowHours = asNumber(run?.window_hours);
+  const warnings = [
+    "This tenant's dashboard shows the dream grouping of its Problems, so this is that list, in the dashboard table's order. The Book's ranked list is --view=book.",
+    ...!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 } : {} });
+}
+var DREAM_INCIDENTS_DEFAULT_LIMIT = 3;
+async function runDreamProblem(params, context, command) {
+  const others = ["evidence", "reports", "traces", "conversations", "feedback", "full"].filter((key) => params[key] === true);
+  if (others.length > 0) {
+    throw new CliInputError(`--view=dream is its own page; it does not combine with ${others.map((key) => `--${key === "conversations" ? "traces" : key}`).join(", ")}.`, `Usage: moda problems get <problem_id> --view=dream [--limit=N] [--offset=N] [--days-back=N], or drop --view=dream for the dossier and its pages.`);
+  }
+  rejectInapplicableFlags(command, params, ["cursor", "family", "door"], "to --view=dream; it pages incidents with --limit and --offset");
+  if (!UUID_RE.test(params.id)) {
+    throw new CliInputError(`--view=dream requires a canonical problem UUID; got "${params.id}". Run \`moda problems list\` to list problem ids.`);
+  }
+  const limit = params.limit ?? DREAM_INCIDENTS_DEFAULT_LIMIT;
+  const offset = params.offset ?? 0;
+  const query2 = new URLSearchParams({ limit: String(limit) });
+  if (offset > 0)
+    query2.set("offset", String(offset));
+  if (params.days_back !== undefined)
+    query2.set("days_back", String(params.days_back));
+  const id = shellArg(params.id);
+  const data = asRecord(await callDataAPI(`/problems/dream/${encodeURIComponent(params.id)}?${query2.toString()}`).catch((error) => {
+    if (error instanceof ApiError && error.statusCode === 404) {
+      throwIfNotFound("problem", params.id, true, `Problem "${params.id}" is not in this tenant's dream grouping; read its dossier with: moda problems get ${id}`);
+    }
+    throw error;
+  })) ?? {};
+  if (data.available !== true) {
+    context.output.writeData({ available: false, view: "dream", problem_id: params.id }, {
+      warnings: [`This tenant has no dream grouping published; read the problem's dossier with: moda problems get ${id}`],
+      nextCommands: [{ command: `moda problems get ${id}`, purpose: "Read the dossier (what the dashboard shows for this tenant).", mutability: "read", requires_approval: false }]
+    });
+    return;
+  }
+  const incidents = Array.isArray(data.incidents) ? data.incidents : [];
+  const nextOffset = typeof data.next_offset === "number" ? data.next_offset : null;
+  const { offset: _offset, limit: _limit, next_offset: _next, ...rest } = data;
+  const nextCommands = [];
+  if (nextOffset !== null) {
+    const days = params.days_back !== undefined ? ` --days-back=${params.days_back}` : "";
+    nextCommands.push({
+      command: `moda problems get ${id} --view=dream --limit=${limit} --offset=${nextOffset}${days}`,
+      purpose: `Read the next incidents of this problem (from incident ${nextOffset}).`,
+      mutability: "read",
+      requires_approval: false,
+      nextPage: true
+    });
+  }
+  const first = asRecord(incidents[0]);
+  if (typeof first?.conversation_id === "string") {
+    nextCommands.push({ command: `moda traces get ${shellArg(first.conversation_id)}`, purpose: "Open the trace of its most serious incident.", mutability: "read", requires_approval: false });
+  }
+  nextCommands.push({ command: `moda problems get ${id} --evidence`, purpose: "Page the Book evidence behind the same problem (dream ids are Book ids).", mutability: "read", requires_approval: false });
+  context.output.writeData({
+    ...rest,
+    pagination: {
+      offset,
+      limit,
+      returned: incidents.length,
+      total: asNumber(data.incidents_total) ?? null,
+      has_more: nextOffset !== null,
+      next_offset: nextOffset
+    },
+    dashboard_url: `${MODA_BASE_URL}/dashboard/problems/${encodeURIComponent(params.id)}`
+  }, { nextCommands });
+}
 function processingDisabledWarning(data, family) {
   const processing = asRecord(asRecord(data)?.processing);
   const label = family === "emotion" ? "Emotion" : "Frustration";
@@ -4535,6 +4795,91 @@ function processingDisabledWarning(data, family) {
     `${family === "emotion" ? "Emotion" : "Frustration"} analysis is disabled for this tenant (${setting} = false), ` + "so zero results do NOT mean users are not frustrated. Enable it in Settings → Account → Signal processing; " + "only traces ingested after enabling are analyzed."
   ];
 }
+function readsPerTrace(command, params, perRowScopes) {
+  const filters = TRACE_GRAIN_FLAGS[command].filter((key) => params[key] !== undefined);
+  const grain = params.group_by;
+  if (grain !== undefined && grain !== "trace" && filters.length > 0) {
+    rejectInapplicableFlags(command, params, filters, `with --group-by=${grain}; they filter the per-trace list (--group-by=trace)`);
+  }
+  const perTrace = grain === "trace" || filters.length > 0;
+  if (perTrace) {
+    rejectInapplicableFlags(command, params, perRowScopes, "to the per-trace list (--group-by=trace, or a filter that implies it); drop --group-by and the trace filters to use them");
+  }
+  return perTrace;
+}
+function setTraceFilters(query2, params, keys) {
+  query2.set("group_by", "trace");
+  for (const key of keys) {
+    const value = params[key];
+    if (value === undefined)
+      continue;
+    if (key === "signal")
+      query2.set("signals", String(value).split(",").map((part) => part.trim()).join(","));
+    else
+      query2.set(key, String(value));
+  }
+}
+function countingSummary(data) {
+  const record = asRecord(data);
+  const counting = asString(record?.counting);
+  const total = asNumber(asRecord(record?.pagination)?.total);
+  if (!counting || total === null)
+    return;
+  switch (counting) {
+    case "per_trace":
+      return `${total} trace(s) match. Counting: per trace, as the dashboard counts (pagination.total = traces).`;
+    case "per_detection":
+      return `${total} detection(s) match. Counting: per detection (one row per trace and family), not per trace; add --group-by=trace for the dashboard's per-trace count.`;
+    case "per_message":
+      return `${total} message detection(s) match. Counting: per scored message, not per trace; add --group-by=trace for the dashboard's per-trace count.`;
+    default:
+      return;
+  }
+}
+function traceStateWarnings(data) {
+  const record = asRecord(data);
+  if (asString(record?.trace_state) === "unavailable") {
+    return ["Trace processing state could not be read, so processing_status is null on every row; do not read missing detections as clean."];
+  }
+  const rows = Array.isArray(record?.conversations) ? record.conversations.map(asRecord) : [];
+  const pending = rows.filter((row) => asString(row?.processing_status) === "pending").length;
+  const errored = rows.filter((row) => asString(row?.error_message)).length;
+  const warnings = [];
+  if (pending > 0) {
+    warnings.push(`${pending} of ${rows.length} trace(s) on this page are not fully processed yet (processing_status=pending), so their detections may be incomplete; missing detections do not mean they are clean.`);
+  }
+  if (errored > 0) {
+    warnings.push(`${errored} trace(s) on this page have a processing error (error_message); their detections may be missing.`);
+  }
+  return warnings;
+}
+function singleTraceStateWarnings(value) {
+  const traceState = asRecord(value);
+  const warnings = [];
+  if (asString(traceState?.processing_status) === "pending") {
+    warnings.push("This trace is not fully processed yet (trace_state.processing_status=pending), so its detections may be incomplete; missing detections do not mean it is clean.");
+  }
+  if (asString(traceState?.error_message)) {
+    warnings.push("This trace has a processing error (trace_state.error_message); its detections may be missing.");
+  }
+  return warnings;
+}
+function customSignalProcessingWarning(data, rows) {
+  const record = asRecord(data);
+  const processing = asRecord(record?.processing);
+  const list = record?.[rows];
+  if (!processing || !Array.isArray(list) || list.length > 0)
+    return [];
+  if (processing.enabled === false) {
+    return [
+      "Custom-signal judging is disabled for this tenant (signals.custom_signals = false), so no hits does NOT mean the traces are clean. " + "Enable it in Settings → Account → Signal processing; only conversations judged after enabling get hits."
+    ];
+  }
+  if (processing.enabled === null) {
+    return ["Could not confirm whether custom-signal judging is enabled for this tenant, so treat no hits with caution."];
+  }
+  return [];
+}
 var CONTEXT_USAGE = "Usage: moda traces get <conversation_id> [--msg-index=N (alias --message-index)] [--window=0-5 | --metadata-only]";
 var CONTEXT_ALL_USAGE = "Usage: moda traces get <conversation_id> --all [--from=N] [--max-messages=N]";
 var CONTEXT_BATCH_USAGE = `Usage: moda traces get <id>[@msg_index] <id>[@msg_index] ... | --ids-from=-|<file> [--window=0-5 | --metadata-only | --all [--from=N] [--max-messages=N]] (max ${BATCH_MAX_TARGETS} targets)`;
@@ -4640,6 +4985,7 @@ async function readFullTranscript(conversationId, opts = {}) {
   let total = 0;
   let summary = null;
   let ordering;
+  let traceState;
   let nextFrom = null;
   let cursor = start;
   let readBytes = 0;
@@ -4656,6 +5002,7 @@ async function readFullTranscript(conversationId, opts = {}) {
       total = asNumber(page.total_messages) ?? 0;
       summary = stripLoneSurrogates(page.summary ?? null);
       ordering = stripLoneSurrogates(asRecord(page.ordering) ?? undefined);
+      traceState = page.trace_state;
     }
     const batch = stripLoneSurrogates(pageMessages(page));
     messages.push(...batch);
@@ -4707,6 +5054,7 @@ async function readFullTranscript(conversationId, opts = {}) {
         next_from: next,
         summary,
         ...ordering ? { ordering } : {},
+        ...traceState !== undefined ? { trace_state: traceState } : {},
         messages: returned
       },
       warnings: out,
@@ -4728,7 +5076,7 @@ async function readContextItem(params, inputWarnings, budget) {
       fits: fits ? (page) => fits(page.data, { warnings: page.warnings, nextCommands: page.nextCommands }) : undefined,
       maxBytes: budget?.maxBytes
     });
-    const fullWarnings = [...inputWarnings, ...full.warnings];
+    const fullWarnings = [...inputWarnings, ...singleTraceStateWarnings(asRecord(full.data)?.trace_state), ...full.warnings];
     return {
       data: full.data,
       options: {
@@ -4750,7 +5098,7 @@ async function readContextItem(params, inputWarnings, budget) {
   const data = params.metadata_only === true ? await readContextMetadataOnly(contextPath, query2) : await callDataAPI(`${contextPath}${queryString}`);
   const ctxRecord = asRecord(data) ?? {};
   throwIfNotFound("trace", params.conversation_id, asNumber(ctxRecord.total_messages) === 0);
-  const warnings = [...inputWarnings];
+  const warnings = [...inputWarnings, ...singleTraceStateWarnings(ctxRecord.trace_state)];
   const nextCommands = [];
   if (params.window !== undefined && params.window > CONTEXT_MAX_WINDOW) {
     const center = asNumber(asRecord(ctxRecord.context)?.center_index) ?? params.msg_index ?? 0;
@@ -5189,6 +5537,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
           searchWarnings.push("--sort=slowest: no trace in this page has a known duration (synthetic timestamps), so the order is not by duration. Use --sort=longest (message count) instead.");
         }
       }
+      searchWarnings.push(...traceStateWarnings(data));
       const writeOptions = searchWarnings.length > 0 ? { warnings: searchWarnings } : undefined;
       if (params.include_world_state === true) {
         const enriched = asRecord(data) ?? {};
@@ -5356,6 +5705,15 @@ 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 (readsPerTrace("frustrations", params, ["user_id", "conversation_id", "include_window"])) {
+        query2.set("family", "frustration");
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.frustrations);
+        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const warnings = processingDisabledWarning(data2, "frustration");
+        const summary = countingSummary(data2);
+        context.output.writeData(data2, { ...summary ? { summary } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        break;
+      }
       if (params.user_id)
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
@@ -5367,7 +5725,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("include_context", "0");
       const data = frustrationsFromEmotions(await callDataAPI(`/emotions?${query2.toString()}`));
       const anchored = withFrustrationAnchors(data);
-      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);
+      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": {
@@ -5565,25 +5923,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         break;
       }
       if (positional) {
-        throw new CliInputError(`Unknown problems subcommand '${positional}'.`, "Usage: moda problems [--days-back=N] [--limit=N] | moda problems unexplained [--family=F] [--days-back=N] [--limit=N] [--cursor=TOKEN]. For one Problem use 'moda problems get <id>'.");
+        throw new CliInputError(`Unknown problems subcommand '${positional}'.`, "Usage: moda problems list [--view=auto|book|dream] [--days-back=N] [--limit=N] [--offset=N --list-version=V] [--sort=S] [--cohort=REF] | moda problems unexplained [--family=F] [--days-back=N] [--limit=N] [--cursor=TOKEN]. For one Problem use 'moda problems get <id>'.");
       }
-      const args = flagsToArgs(flags);
-      const params = parseSpecFlags("problems", args, command);
-      const query2 = new URLSearchParams;
-      if (params.days_back)
-        query2.set("days_back", params.days_back.toString());
-      if (params.limit)
-        query2.set("limit", params.limit.toString());
-      const queryString = query2.toString() ? `?${query2.toString()}` : "";
-      const data = await callDataAPI(`/problems${queryString}`);
-      const { payload, truncated } = capProblemsBlocks(asRecord(data) ?? {}, params.limit ?? 25);
-      const withLink = {
-        ...payload,
-        ...truncated ? { truncated } : {},
-        dashboard_url: `${MODA_BASE_URL}/dashboard/problems`
-      };
-      const warnings = [...serverWarnings(payload), ...truncated ? [`--limit=${params.limit ?? 25} also capped ${Object.entries(truncated).map(([block, count]) => `${block} (${count} more)`).join(", ")}; raise --limit (max 25) or open dashboard_url for the rest.`] : []];
-      context.output.writeData(withLink, warnings.length > 0 ? { warnings } : undefined);
+      await runProblemsList(flags, context, command);
       break;
     }
     case "problem": {
@@ -5596,6 +5938,11 @@ async function runCommand(command, positional, flags, positionals = positional ?
       }
       const args = flagsToArgs(flags, "id", positional);
       const params = parseSpecFlags("problem", args, command);
+      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");
       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) {
@@ -5803,7 +6150,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("offset", params.offset.toString());
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/custom-signals/${id}/detections${queryString}`);
-      context.output.writeData(data);
+      const warnings = customSignalProcessingWarning(data, "detections");
+      context.output.writeData(data, warnings.length > 0 ? { warnings } : undefined);
       break;
     }
     case "trace-signals": {
@@ -5811,7 +6159,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         throw new CliInputError("<conversation_id> is required", "Usage: moda detections list --family=custom_signal --conversation-id=<conversation_id>");
       }
       const data = await callDataAPI(`/conversations/${encodeURIComponent(positional)}/custom-signals`);
-      context.output.writeData(data);
+      const warnings = customSignalProcessingWarning(data, "detections");
+      context.output.writeData(data, warnings.length > 0 ? { warnings } : undefined);
       break;
     }
     case "signal-label": {
@@ -6029,6 +6378,14 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("offset", params.offset.toString());
       if (params.family)
         query2.set("family", params.family);
+      if (readsPerTrace("emotions", params, ["user_id", "conversation_id", "include_window"])) {
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.emotions);
+        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const warnings = processingDisabledWarning(data2, "emotion");
+        const summary2 = countingSummary(data2);
+        context.output.writeData(data2, { ...summary2 ? { summary: summary2 } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        break;
+      }
       if (params.user_id)
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
@@ -6041,7 +6398,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
       const processingWarnings = processingDisabledWarning(raw, "emotion");
       const record = asRecord(raw);
       const data = agentMode && params.include_window !== true && record ? withoutDetectionWindows(record, "detections", "conversation_context") : raw;
-      context.output.writeData(data, processingWarnings.length > 0 ? { warnings: processingWarnings } : undefined);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary || processingWarnings.length > 0 ? { ...summary ? { summary } : {}, ...processingWarnings.length > 0 ? { warnings: processingWarnings } : {} } : undefined);
       break;
     }
     case "laziness": {
@@ -6058,9 +6416,21 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("conversation_id", params.conversation_id);
       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");
+      }
+      if (params.search)
+        query2.set("search", params.search);
+      if (params.status)
+        query2.set("status", params.status);
+      if (params.sort)
+        query2.set("sort", params.sort);
+      if (params.order)
+        query2.set("order", params.order);
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/laziness${queryString}`);
-      context.output.writeData(data);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary ? { summary } : undefined);
       break;
     }
     case "hallucinations": {
@@ -6073,13 +6443,18 @@ 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.conversation_id)
-        query2.set("conversation_id", params.conversation_id);
-      if (params.kind)
-        query2.set("kind", params.kind);
+      if (readsPerTrace("hallucinations", params, ["conversation_id", "kind"])) {
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.hallucinations);
+      } else {
+        if (params.conversation_id)
+          query2.set("conversation_id", params.conversation_id);
+        if (params.kind)
+          query2.set("kind", params.kind);
+      }
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/hallucinations${queryString}`);
-      context.output.writeData(data);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary ? { summary } : undefined);
       break;
     }
     case "step-scores": {
@@ -6268,7 +6643,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-4w5szrnw.js");
+      const { runInit } = await import("./index-2qm3h7v2.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -6318,7 +6693,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-8c4s6vgg.js");
+      const { runProvision } = await import("./provision-x4wkyw60.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -6834,7 +7209,7 @@ var commandRegistry = createCommandRegistry([
   legacyCommand({
     name: "problems",
     description: "Rank cross-signal Problems by root cause (what to fix first)",
-    examples: ["moda problems list", "moda problems list --days-back=7 --limit=10", "moda problems get <problem_id> --evidence", "moda problems unexplained --family=emotion"],
+    examples: ["moda problems list", "moda problems list --view=book --sort=users --limit=20", "moda problems get <problem_id> --view=dream", "moda problems get <problem_id> --evidence", "moda problems unexplained --family=emotion"],
     subcommands: treeSubcommandHelp("problems"),
     defaultSubcommand: "list",
     ...dataApiDefaults
@@ -6856,14 +7231,15 @@ var commandRegistry = createCommandRegistry([
   }),
   legacyCommand({
     name: "problem",
-    description: "Open one Problem: dossier, or --evidence/--reports/--traces/--feedback pages (--conversations is a legacy alias of --traces)",
+    description: "Open one Problem: dossier, --evidence/--reports/--traces/--feedback pages (--conversations is a legacy alias of --traces), or --view=dream",
     examples: [
       "moda problems get <problem_id>",
       "moda problems get <problem_id> --full   # whole dossier (agent output defaults to a compact one)",
       "moda problems get <problem_id> --evidence --limit=10",
       "moda problems get <problem_id> --reports",
       "moda problems get <problem_id> --traces --family=tool_failure",
-      "moda problems get <problem_id> --feedback"
+      "moda problems get <problem_id> --feedback",
+      "moda problems get <problem_id> --view=dream --limit=3 --offset=3   # the dream page: definition, severity, incidents"
     ],
     ...dataApiDefaults
   }),