@moda-ai/cli 1.55.38 → 1.55.40

package/dist/cli.js

@@ -13,6 +13,8 @@ import {
   frustrationsFromEmotions,
   mapWithConcurrency,
   parseBatchTarget,
+  parseTargetLines,
+  readIdsFrom,
   shapeToolCatalogDetail,
   toolCatalogGetCommand,
   toolFailureExamplesCommand,
@@ -20,7 +22,7 @@ import {
   withFrustrationAnchors,
   withToolFailureAnchors,
   withoutDetectionWindows
-} from "./cli-n311b8g0.js";
+} from "./cli-gt3yq1y5.js";
 import {
   createCommandContext,
   envOptOutSet,
@@ -28,17 +30,22 @@ import {
   optOutFlagSet,
   parseBooleanFlagValue,
   withoutFlag
-} from "./cli-b7nyw498.js";
+} from "./cli-xddtv3yn.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,
+  MAX_CONVERSATION_IDS_FILTER,
+  PROBLEMS_DEFAULT_LIMIT,
+  PROBLEMS_MAX_LIMIT,
   PROBLEM_FEEDBACK_ACTIONS,
   ProblemFeedbackSchema,
   ProblemImpactSchema,
@@ -48,6 +55,7 @@ import {
   SignalLabelSchema,
   StepScoresSchema,
   TRACE_GRAIN_FLAGS,
+  TraceFindingsSchema,
   UUID_RE,
   assertFlags,
   assertPositionals,
@@ -71,12 +79,12 @@ import {
   unknownSignalsSubcommandError,
   usageLine,
   writeDryRun
-} from "./cli-xheg54qc.js";
+} from "./cli-f1jfrqgf.js";
 import {
   ApiError,
   callControlAPI,
   callDataAPI
-} from "./cli-3n040fp2.js";
+} from "./cli-0xc5htv7.js";
 import {
   AGENT_ERROR_CODES,
   EXIT_AUTH_REQUIRED,
@@ -113,7 +121,7 @@ import {
   shellArg,
   validateConfig,
   wasOutputCancelled
-} from "./cli-rcjhfts4.js";
+} from "./cli-t0pb7qbs.js";
 import {
   CliAccessError,
   CliAuthError,
@@ -136,6 +144,175 @@ import {
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { z } from "zod";
 
+// src/trace-findings.ts
+var FINDINGS_FAMILIES = ["emotion", "laziness", "hallucination", "tool_failure", "custom_signal"];
+var FINDINGS_DEFAULT_LIMIT = 3;
+var NEXT_COMMANDS_SINGLE = 8;
+var NEXT_COMMANDS_BATCH = 2;
+var TEXT_CHARS = 160;
+function familyState(entry) {
+  const count = asNumber(entry.count) ?? 0;
+  if (count > 0)
+    return "found";
+  const enabled = asRecord(entry.detector)?.enabled;
+  if (enabled === false || entry.processed === false)
+    return "not_run";
+  if (entry.processed === true)
+    return "none";
+  return "unknown";
+}
+function clip(value, max = TEXT_CHARS) {
+  const text = asString(value);
+  if (!text)
+    return;
+  return text.length <= max ? text : `${text.slice(0, max - 3)}...`;
+}
+function stripUndefined(row) {
+  return Object.fromEntries(Object.entries(row).filter(([, value]) => value !== undefined && value !== ""));
+}
+function compactRow(family, row) {
+  const msgIndex = asNumber(row.msg_index);
+  switch (family) {
+    case "emotion": {
+      const quote = asRecord(Array.isArray(row.user_quotes) ? row.user_quotes[0] : undefined);
+      return stripUndefined({
+        msg_index: msgIndex,
+        family: row.family,
+        polarity: row.polarity,
+        score: row.score,
+        trajectory: row.trajectory,
+        cause: clip(row.primary_cause),
+        quote: clip(quote?.quote)
+      });
+    }
+    case "laziness":
+      return stripUndefined({ msg_index: msgIndex, family: row.family, pattern: row.pattern_id, confidence: row.confidence, snippet: clip(row.snippet) });
+    case "hallucination":
+      return stripUndefined({ msg_index: msgIndex, rule: row.rule_id, confidence: row.confidence, claim: clip(row.offending_substring), evidence: clip(row.evidence_quote) });
+    case "tool_failure":
+      return stripUndefined({ msg_index: msgIndex, tool: row.tool_name, tool_use_id: row.tool_use_id, category: row.category, error: clip(row.error_message) });
+    case "custom_signal":
+      return stripUndefined({ msg_index: msgIndex, signal: row.signal_name, signal_id: row.signal_id, confidence: row.confidence, rationale: clip(row.rationale) });
+  }
+}
+function anchorCommand(conversationId, msgIndex) {
+  return `moda traces get ${shellArg(contextTarget(conversationId))} --msg-index=${msgIndex} --window=2`;
+}
+function compactFindings(raw, opts) {
+  const record = asRecord(raw) ?? {};
+  const conversationId = asString(record.conversation_id) ?? "";
+  const families = asRecord(record.families) ?? {};
+  const out = {};
+  const anchors = [];
+  const byFamily = {};
+  const states = {};
+  for (const family of FINDINGS_FAMILIES) {
+    const entry = asRecord(families[family]);
+    if (!entry)
+      continue;
+    const rows = (Array.isArray(entry.detections) ? entry.detections : []).map((row) => asRecord(row)).filter((row) => row !== null);
+    const count = asNumber(entry.count) ?? rows.length;
+    const state = familyState(entry);
+    const detector = asRecord(entry.detector) ?? {};
+    const top = rows.slice(0, opts.limit).map((row) => compactRow(family, row));
+    for (const row of top) {
+      const msgIndex = asNumber(row.msg_index);
+      if (msgIndex !== null)
+        anchors.push({ family, msgIndex, label: String(row.family ?? row.tool ?? row.signal ?? row.rule ?? family) });
+    }
+    byFamily[family] = count;
+    states[family] = state;
+    out[family] = stripUndefined({
+      state,
+      count,
+      ...opts.batch ? {} : { enabled: detector.enabled ?? null, processed: entry.processed ?? null },
+      ...family === "hallucination" && asNumber(entry.verified_claims) ? { verified_claims: entry.verified_claims } : {},
+      top: opts.batch && top.length === 0 ? undefined : top,
+      more: count > top.length ? count - top.length : undefined
+    });
+  }
+  const problemsBlock = asRecord(record.problems) ?? {};
+  const problemRows = (Array.isArray(problemsBlock.problems) ? problemsBlock.problems : []).map((row) => asRecord(row)).filter((row) => row !== null);
+  const problemCount = asNumber(problemsBlock.count) ?? problemRows.length;
+  const problems = stripUndefined({
+    count: problemCount,
+    processed: problemsBlock.processed ?? null,
+    top: problemRows.slice(0, opts.limit).map((row) => stripUndefined({
+      problem_id: row.problem_id,
+      title: clip(row.title),
+      attribution_count: row.attribution_count,
+      lifecycle: row.lifecycle ?? undefined,
+      in_book: row.in_book
+    })),
+    more: problemCount > Math.min(problemRows.length, opts.limit) ? problemCount - Math.min(problemRows.length, opts.limit) : undefined
+  });
+  const total = Object.values(byFamily).reduce((sum, value) => sum + value, 0);
+  const data = opts.batch ? { detections: total, families: out, problems } : {
+    conversation_id: conversationId,
+    window: "all",
+    summary: { detections: total, by_family: byFamily, problems: problemCount },
+    families: out,
+    problems
+  };
+  const nextCommands = [];
+  const seen = new Set;
+  for (const anchor of anchors) {
+    if (seen.has(anchor.msgIndex))
+      continue;
+    seen.add(anchor.msgIndex);
+    nextCommands.push({
+      command: anchorCommand(conversationId, anchor.msgIndex),
+      purpose: `Read message ${anchor.msgIndex} (${anchor.family}: ${anchor.label}) with 2 messages either side.`,
+      mutability: "read",
+      requires_approval: false
+    });
+    if (nextCommands.length >= (opts.batch ? NEXT_COMMANDS_BATCH : NEXT_COMMANDS_SINGLE))
+      break;
+  }
+  if (!opts.batch) {
+    const topProblem = asString(problemRows[0]?.problem_id);
+    if (topProblem) {
+      nextCommands.push({
+        command: `moda problems get ${shellArg(topProblem)}`,
+        purpose: "Open the Problem this trace is most evidence for.",
+        mutability: "read",
+        requires_approval: false
+      });
+    }
+  }
+  const notRun = FINDINGS_FAMILIES.filter((family) => states[family] === "not_run");
+  const unknown = FINDINGS_FAMILIES.filter((family) => states[family] === "unknown");
+  const found = FINDINGS_FAMILIES.filter((family) => states[family] === "found").map((family) => `${byFamily[family]} ${family}`);
+  const summary = `${conversationId}: ${total} detection${total === 1 ? "" : "s"}` + (found.length > 0 ? ` (${found.join(", ")})` : "") + `, evidence for ${problemCount} Problem${problemCount === 1 ? "" : "s"}. No time window.`;
+  const warnings = [];
+  if (notRun.length > 0) {
+    warnings.push(`Not run on this trace (detector off or not processed yet): ${notRun.join(", ")}. No detections there does not mean clean.`);
+  }
+  if (unknown.length > 0 && total === 0) {
+    warnings.push(`Nothing flagged, and ${unknown.join(", ")} record nothing for a clean trace, so whether they ran is not known.`);
+  }
+  return {
+    data,
+    options: {
+      summary,
+      ...warnings.length > 0 && !opts.batch ? { warnings } : {},
+      ...nextCommands.length > 0 ? { nextCommands } : {}
+    }
+  };
+}
+function batchNotRunWarning(results) {
+  const notRun = results.flatMap((result) => {
+    const families = asRecord(asRecord(result.data)?.families);
+    if (!result.ok || !families)
+      return [];
+    const names = FINDINGS_FAMILIES.filter((family) => asRecord(families[family])?.state === "not_run");
+    return names.length > 0 ? [`${result.target} (${names.join(", ")})`] : [];
+  });
+  if (notRun.length === 0)
+    return [];
+  return [`Families not run (detector off or trace not processed yet), so no detections there does not mean clean: ${notRun.join("; ")}.`];
+}
+
 // src/replays.ts
 var UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var PLAYOUT_ID_RE = /^[0-9a-f]{64}$/i;
@@ -1141,6 +1318,18 @@ var CANONICAL_LEAVES = [
     summary: "A trace's world state (slots, threads, events)",
     examples: ["moda traces state <conversation_id> --summary-only", "moda traces state <conversation_id> --snapshot --msg-index=12"]
   },
+  {
+    noun: "traces",
+    verb: "findings",
+    path: "traces findings",
+    args: "<conversation_id>...",
+    handler: "trace-findings",
+    summary: "Everything flagged on a trace (every detector family and its Problems), no time window; up to 25 ids per call",
+    examples: [
+      "moda traces findings <conversation_id>",
+      "moda traces findings <id1> <id2> <id3>   # batch: up to 25 ids (or --ids-from=-|<file>)"
+    ]
+  },
   {
     noun: "traces",
     verb: "spans",
@@ -1156,8 +1345,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",
@@ -1165,8 +1354,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",
@@ -1299,7 +1488,7 @@ var CANONICAL_LEAVES = [
 ];
 var CANONICAL_NOUNS = ["traces", "problems", "detections", "tools", "review", "reviews", "skills"];
 var NOUN_SUMMARIES = {
-  traces: "Traces (agent runs): list, search, read, world state, raw spans",
+  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",
@@ -1410,6 +1599,10 @@ function routeDetectionsList(leaf, rest, flags) {
     throw inputError(`'moda detections list' takes no arguments, but got '${rest.join(" ")}'.`, DETECTIONS_LIST_USAGE, "unexpected_positional");
   }
   const label = `detections list --family=${family}`;
+  const severalTraces = ["conversation-ids", "conversation_ids", "ids-from", "ids_from"].find((key) => flags[key] !== undefined);
+  if (severalTraces && (family === "custom_signal" || family === "tool_failure")) {
+    throw inputError(`--${severalTraces.replace(/_/g, "-")} is not available with --family=${family}. Read several traces' ${family === "custom_signal" ? "custom signal hits" : "tool failures"} with 'moda traces findings <id> <id> ...' (up to 25 ids).`, DETECTIONS_LIST_USAGE, `inapplicable_flag:${severalTraces.replace(/_/g, "-")}`, { field: `--${severalTraces.replace(/_/g, "-")}`, suggestedCommands: ["moda traces findings --help"] });
+  }
   if (family === "custom_signal") {
     const signalId = flags["signal-id"];
     const traceId = flags["conversation-id"];
@@ -2982,46 +3175,46 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-cwqn8a57.js")).runPromptsCommand(...args);
+  return (await import("./prompts-ysm9ra72.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
-  return (await import("./skills-btn9r48v.js")).runSkillsCommand(...args);
+  return (await import("./skills-x6yszxxn.js")).runSkillsCommand(...args);
 }
 async function runFixCommand(...args) {
-  return (await import("./fix-kvszavm1.js")).runFixCommand(...args);
+  return (await import("./fix-0r974yge.js")).runFixCommand(...args);
 }
 async function runFixesCommand(...args) {
-  return (await import("./fix-kvszavm1.js")).runFixesCommand(...args);
+  return (await import("./fix-0r974yge.js")).runFixesCommand(...args);
 }
 async function runHarnessCommand(...args) {
-  return (await import("./harness-qatnwxrz.js")).runHarnessCommand(...args);
+  return (await import("./harness-72ejenza.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-ye7nxeen.js")).runSyncCommand(...args);
+  return (await import("./sync-trjzvam9.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
-  return (await import("./registry-76sngjw6.js")).runRegistryCommand(...args);
+  return (await import("./registry-7xz09ry0.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-xq5bjvpq.js")).runDoctorCommand(...args);
+  return (await import("./doctor-p8sp6cbk.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-xq5bjvpq.js")).runStatusCommand(...args);
+  return (await import("./doctor-p8sp6cbk.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
-  return (await import("./profile-commands-skdxe17v.js")).runAuthCommand(...args);
+  return (await import("./profile-commands-se9947c1.js")).runAuthCommand(...args);
 }
 async function runConfigCommand(...args) {
-  return (await import("./profile-commands-skdxe17v.js")).runConfigCommand(...args);
+  return (await import("./profile-commands-se9947c1.js")).runConfigCommand(...args);
 }
 async function runProfilesCommand(...args) {
-  return (await import("./profile-commands-skdxe17v.js")).runProfilesCommand(...args);
+  return (await import("./profile-commands-se9947c1.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-9r58v0bc.js")).runAgentCommand(...args);
+  return (await import("./agent-ck6y31n2.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
-  return (await import("./production-intelligence-j55vaw6t.js")).runProductionCommand(...args);
+  return (await import("./production-intelligence-hs2sm8t5.js")).runProductionCommand(...args);
 }
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -4146,7 +4339,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 = {}) {
@@ -4447,7 +4640,7 @@ function rejectInapplicableFlags(command, params, keys, why) {
   const shown = canonicalCommandText(`moda ${command}`);
   throw new CliInputError(`${names.join(", ")} ${given.length > 1 ? "do" : "does"} not apply ${why}, so nothing was sent.`, `Drop ${names.join(", ")}, or pick the mode that uses ${given.length > 1 ? "them" : "it"}. See '${shown} --help'.`, `inapplicable_flag:${names[0].slice(2)}`, { field: names[0], suggestedCommands: [`${shown} --help`] });
 }
-var BATCH_POSITIONAL_COMMANDS = new Set(["context", "audit", "trace"]);
+var BATCH_POSITIONAL_COMMANDS = new Set(["context", "audit", "trace", "trace-findings"]);
 function assertPositionalArity(command, positionals) {
   const spec = flagSpecFor(command);
   const expected = spec?.positionals ?? [];
@@ -4521,6 +4714,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";
@@ -5152,6 +5599,79 @@ async function runContextBatch(command, positionals, flags, context) {
   });
   return writeBatchResult(command, context, targets, results, inputWarnings, rest);
 }
+var CONVERSATION_IDS_USAGE = `Usage: moda detections list --family=emotion|frustration|laziness|hallucination --conversation-ids=<id>,<id>,... | --ids-from=-|<file> (up to ${MAX_CONVERSATION_IDS_FILTER} ids)`;
+async function conversationIdsFilter(params, context) {
+  if (params.conversation_ids === undefined && params.ids_from === undefined)
+    return;
+  if (params.conversation_ids !== undefined && params.ids_from !== undefined) {
+    throw new CliInputError("Pass --conversation-ids or --ids-from, not both.", CONVERSATION_IDS_USAGE, "flag_conflict");
+  }
+  if (params.conversation_id !== undefined) {
+    throw new CliInputError("--conversation-id reads one trace and --conversation-ids/--ids-from several; pass one of them.", CONVERSATION_IDS_USAGE, "flag_conflict");
+  }
+  let ids;
+  if (params.ids_from !== undefined) {
+    ids = parseTargetLines(await readIdsFrom(params.ids_from, CONVERSATION_IDS_USAGE), false, CONVERSATION_IDS_USAGE).map((target) => target.id);
+  } else {
+    const text = params.conversation_ids.trim();
+    let parsed = undefined;
+    if (text.startsWith("[")) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        throw new CliInputError("--conversation-ids starts with [ but is not a JSON array of ids.", CONVERSATION_IDS_USAGE, "bad_value:conversation-ids");
+      }
+    }
+    ids = Array.isArray(parsed) ? parsed.map((id) => String(id).trim()) : text.split(",").map((id) => id.trim());
+  }
+  const unique = [...new Set(ids.filter((id) => id !== ""))];
+  if (unique.length === 0) {
+    throw new CliInputError("No trace ids: --conversation-ids/--ids-from gave none.", CONVERSATION_IDS_USAGE, "missing_value:conversation-ids");
+  }
+  if (unique.length > MAX_CONVERSATION_IDS_FILTER) {
+    throw new CliInputError(`Got ${unique.length} trace ids; the detection lists take at most ${MAX_CONVERSATION_IDS_FILTER} per call, so nothing was read. Split them into calls of ${MAX_CONVERSATION_IDS_FILTER} or fewer.`, CONVERSATION_IDS_USAGE, "batch_too_large");
+  }
+  const withComma = unique.find((id) => id.includes(","));
+  if (withComma !== undefined) {
+    throw new CliInputError(`Trace id ${JSON.stringify(withComma)} has a comma, which the several-trace filter cannot carry. Read it with --conversation-id instead.`, CONVERSATION_IDS_USAGE, "bad_value:conversation-ids");
+  }
+  if (params.ids_from !== undefined && context.invocation) {
+    for (const key of IDS_FROM_KEYS)
+      delete context.invocation.flags[key];
+    context.invocation.flags["conversation-ids"] = unique.join(",");
+  }
+  return unique;
+}
+var TRACE_FINDINGS_USAGE = `Usage: moda traces findings <conversation_id> [<conversation_id> ...] | --ids-from=-|<file> [--limit=N] (max ${BATCH_MAX_TARGETS} ids)`;
+async function runTraceFindings(command, positionals, flags, context) {
+  const { idsFrom, rest } = splitIdsFrom(flags);
+  if (positionals.length === 0 && idsFrom === undefined) {
+    throw new CliInputError("<conversation_id> is required", TRACE_FINDINGS_USAGE, "missing_positional");
+  }
+  const targets = await collectBatchTargets(positionals, idsFrom, { anchors: false, usage: TRACE_FINDINGS_USAGE, command });
+  const base = parseCommandFlags(TraceFindingsSchema, flagsToArgs(rest, "conversation_id", targets[0].id), command, { positionalKey: "conversation_id" });
+  const limit = base.limit ?? FINDINGS_DEFAULT_LIMIT;
+  const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
+  const full = context.output.mode === "json";
+  const batch = isBatchRead(positionals, flags);
+  const read = async (id, budget) => {
+    const raw = await callDataAPI(`/conversations/${encodeURIComponent(id)}/findings`);
+    if (full)
+      return { data: raw, options: {} };
+    let item = compactFindings(raw, { limit, batch });
+    for (let shown = limit - 1;budget && shown >= 0 && !budget.fits(item.data, item.options); shown -= 1) {
+      item = compactFindings(raw, { limit: shown, batch });
+    }
+    return item;
+  };
+  if (!batch) {
+    const item = await read(targets[0].id, agentMode ? { fits: (data, options) => agentEnvelopeFits(command, data, options), maxBytes: agentMaxOutputBytes() } : undefined);
+    context.output.writeData(item.data, item.options);
+    return 0;
+  }
+  const results = await readBatchTargets(targets, agentMode, (target, budget) => read(target.id, budget));
+  return writeBatchResult("traces findings", context, targets, results, full ? [] : batchNotRunWarning(results), rest);
+}
 async function runAuditBatch(command, positionals, flags, context) {
   const { idsFrom, rest } = splitIdsFrom(flags);
   if (rest.cursor !== undefined || Object.keys(rest).some((key) => key.replace(/_/g, "-") === "span-offset")) {
@@ -5423,6 +5943,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
       context.output.writeData(item.data, item.options);
       break;
     }
+    case "trace-findings":
+      return runTraceFindings(command, positionals, flags, context);
     case "audit":
     case "trace": {
       if (isBatchRead(positionals, flags))
@@ -5447,7 +5969,7 @@ 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"])) {
+      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()}`);
@@ -5460,6 +5982,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
         query2.set("conversation_id", params.conversation_id);
+      const frustrationIds = await conversationIdsFilter(params, context);
+      if (frustrationIds)
+        query2.set("conversation_ids", frustrationIds.join(","));
       query2.set("family", "frustration");
       const includeWindow = params.include_window === true;
       const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
@@ -5665,25 +6190,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": {
@@ -5696,6 +6205,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) {
@@ -6131,7 +6645,7 @@ 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"])) {
+      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 warnings = processingDisabledWarning(data2, "emotion");
@@ -6143,6 +6657,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
         query2.set("conversation_id", params.conversation_id);
+      const emotionIds = await conversationIdsFilter(params, context);
+      if (emotionIds)
+        query2.set("conversation_ids", emotionIds.join(","));
       const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
       if (agentMode && params.include_window !== true)
         query2.set("include_context", "0");
@@ -6167,6 +6684,9 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("offset", params.offset.toString());
       if (params.conversation_id)
         query2.set("conversation_id", params.conversation_id);
+      const lazinessIds = await conversationIdsFilter(params, context);
+      if (lazinessIds)
+        query2.set("conversation_ids", lazinessIds.join(","));
       if (params.family)
         query2.set("family", params.family);
       if (params.conversation_id) {
@@ -6196,11 +6716,14 @@ 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("hallucinations", params, ["conversation_id", "kind"])) {
+      if (readsPerTrace("hallucinations", params, ["conversation_id", "conversation_ids", "ids_from", "kind"])) {
         setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.hallucinations);
       } else {
         if (params.conversation_id)
           query2.set("conversation_id", params.conversation_id);
+        const hallucinationIds = await conversationIdsFilter(params, context);
+        if (hallucinationIds)
+          query2.set("conversation_ids", hallucinationIds.join(","));
         if (params.kind)
           query2.set("kind", params.kind);
       }
@@ -6396,7 +6919,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-y5jnz2t2.js");
+      const { runInit } = await import("./index-w7v472w4.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -6446,7 +6969,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-ghca9d54.js");
+      const { runProvision } = await import("./provision-cya5rpxa.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -6934,6 +7457,17 @@ var commandRegistry = createCommandRegistry([
     ],
     ...dataApiDefaults
   }),
+  legacyCommand({
+    name: "trace-findings",
+    description: "Everything flagged on a trace: every detector family with its message anchors, and the Problems it is evidence for (no time window)",
+    examples: [
+      "moda traces findings <conversation_id>",
+      "moda traces findings <conversation_id> --limit=10   # more rows per family (counts always cover all)",
+      "moda traces findings <id1> <id2> <id3>   # batch: up to 25 ids, one envelope (or --ids-from=-|<file>)"
+    ],
+    hidden: true,
+    ...dataApiDefaults
+  }),
   legacyCommand({
     name: "frustrations",
     description: "User frustration detections: the frustration family of `emotions` (same data as the dashboard), legacy field names",
@@ -6962,7 +7496,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
@@ -6984,14 +7518,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
   }),