@moda-ai/cli 1.55.23 → 1.55.25

package/dist/{doctor-snb87jvy.js → doctor-q21mr5ya.js}

@@ -3,16 +3,16 @@ import {
   promptsDiscoveredCheck,
   runDoctorCommand,
   runStatusCommand
-} from "./cli-z3g07t65.js";
-import"./cli-9g8vz4sv.js";
-import"./cli-s6tw1fje.js";
+} from "./cli-mebf5vtr.js";
+import"./cli-0wr3483h.js";
+import"./cli-m805msp6.js";
 import"./cli-mm48br00.js";
-import"./cli-4f6jkrnm.js";
+import"./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
-import"./cli-t3a6eknn.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
+import"./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 export {
   runStatusCommand,

package/dist/{fix-fr48gr0w.js → fix-0qdtdz5h.js}

@@ -2,17 +2,17 @@ import {
   DEFAULT_POLL_INTERVAL_MS,
   DEFAULT_WAIT_TIMEOUT_MS,
   fetchLatestRun
-} from "./cli-s6tw1fje.js";
+} from "./cli-m805msp6.js";
 import"./cli-mm48br00.js";
-import"./cli-4f6jkrnm.js";
+import"./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
+import"./cli-qvg26twp.js";
 import {
   assertFlags
-} from "./cli-cv3jt1ms.js";
+} from "./cli-dn91fb56.js";
 import {
   callControlAPI
-} from "./cli-wkmdw40s.js";
+} from "./cli-9btx12wp.js";
 import {
   CliInputError,
   EXIT_DEGRADED,
@@ -21,7 +21,7 @@ import {
   getModaPaths,
   resolveApiTenantId,
   validateConfig
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/fix.ts

package/dist/{harness-github-actions-cfkx9ty9.js → harness-github-actions-atc5bbkj.js}

@@ -1,13 +1,13 @@
 import {
   buildSourceSnapshot
-} from "./cli-4f6jkrnm.js";
+} from "./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
 import {
   recordApiRequest
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/harness-github-actions.ts

package/dist/{harness-m63b6s0k.js → harness-vzy7n7ea.js}

@@ -42,12 +42,12 @@ import {
   writeHarnessAnalyzeResult,
   writeHarnessArtifacts,
   writeHumanProgress
-} from "./cli-4f6jkrnm.js";
+} from "./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
-import"./cli-t3a6eknn.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
+import"./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 export {
   writeHumanProgress,

package/dist/{index-nsaph4as.js → index-4b1ybz51.js}

@@ -1,21 +1,21 @@
 import {
   selectTenantAndCreateKey
-} from "./cli-d2zews6c.js";
-import"./cli-4yarp5s1.js";
+} from "./cli-qycsmxev.js";
+import"./cli-9hc5bg2r.js";
 import {
   buildDoctorReport
-} from "./cli-z3g07t65.js";
+} from "./cli-mebf5vtr.js";
 import {
   ConnectCodeError,
   connectWithCode,
   loadAuthSession,
   loadToken,
   login
-} from "./cli-9g8vz4sv.js";
+} from "./cli-0wr3483h.js";
 import {
   initPrompts,
   runPromptSync
-} from "./cli-s6tw1fje.js";
+} from "./cli-m805msp6.js";
 import"./cli-mm48br00.js";
 import {
   canonicalText,
@@ -35,7 +35,7 @@ import {
   runCodingAgent,
   runHarnessCommand,
   startRemoteAnalyze
-} from "./cli-4f6jkrnm.js";
+} from "./cli-7xc585hc.js";
 import {
   stripAnsi
 } from "./cli-97fnztpy.js";
@@ -47,12 +47,12 @@ import {
 import {
   agentsMdProblem,
   runSkillSync
-} from "./cli-54zhv6cx.js";
+} from "./cli-m0045npe.js";
 import {
   createCommandContext
-} from "./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
+} from "./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
 import {
   CliAuthError,
   CliInputError,
@@ -60,7 +60,7 @@ import {
   recordApiRequest,
   resolveIngestUrl,
   resolveModaBaseUrl
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import {
   detectAgents,
   installRules,
@@ -269,7 +269,7 @@ function renderSdkIntegrationGuideContent() {
     "```",
     "",
     "Exact-trace confirmation: send one request through your app with a known trace ID,",
-    "then run `moda audit <that-id>` — you should see your llm span(s).",
+    "then run `moda traces spans <that-id>` — you should see your llm span(s).",
     ""
   ].join(`
 `);
@@ -2274,7 +2274,7 @@ function buildSetupPlan(options) {
       status: "planned",
       approved: true,
       files: [".claude/skills", ".cursor/rules"],
-      command: "moda skills sync"
+      command: "moda skills push"
     },
     {
       category: "sdk",
@@ -2300,7 +2300,7 @@ function buildSetupPlan(options) {
       status: options.configureAutosync ? "planned" : "manual",
       approved: options.configureAutosync,
       files: [".github/workflows/moda-autosync.yml"],
-      command: "moda prompts sync && moda skills sync",
+      command: "moda prompts sync && moda skills push",
       reason: options.configureAutosync ? undefined : "No autosync workflow is written until it is explicitly approved (--autosync)."
     },
     {
@@ -2359,7 +2359,7 @@ function applySdkIntegrationOutcome(setupPlan, outcome, deps) {
       break;
     }
     case "telemetry_not_observed":
-      laneBoard?.warn("sdk", `integration applied but the verification trace was not observed; check MODA_API_KEY at runtime, then moda audit ${verificationId}`);
+      laneBoard?.warn("sdk", `integration applied but the verification trace was not observed; check MODA_API_KEY at runtime, then moda traces spans ${verificationId}`);
       markManual(setupPlan, "sdk", outcome.detail ?? "Verification trace was not observed.");
       break;
     case "needs_human_input": {
@@ -2376,7 +2376,7 @@ function applySdkIntegrationOutcome(setupPlan, outcome, deps) {
         sdkAction.reason = outcome.detail ?? "Existing Moda integration verified.";
         break;
       }
-      const reason = outcome.verification ? "agent reports Moda is already integrated but the verification trace was not observed; " + `check MODA_API_KEY at runtime, then \`moda audit ${verificationId}\`` : "agent reports Moda is already integrated — not independently verified; " + "send a real request through your app with a trace ID (`conversation_id`) you choose, then run `moda audit` with that id";
+      const reason = outcome.verification ? "agent reports Moda is already integrated but the verification trace was not observed; " + `check MODA_API_KEY at runtime, then \`moda traces spans ${verificationId}\`` : "agent reports Moda is already integrated — not independently verified; " + "send a real request through your app with a trace ID (`conversation_id`) you choose, then run `moda traces spans` with that id";
       laneBoard?.warn("sdk", reason);
       markManual(setupPlan, "sdk", reason);
       break;
@@ -2480,7 +2480,7 @@ function writeAutosyncWorkflow(cwd = process.cwd()) {
     `      - name: Sync prompts to Moda`,
     `        run: ${GENERATED_WORKFLOW_NPX} prompts sync`,
     `      - name: Sync skills to Moda`,
-    `        run: ${GENERATED_WORKFLOW_NPX} skills sync`,
+    `        run: ${GENERATED_WORKFLOW_NPX} skills push`,
     ""
   ].join(`
 `)}`);

package/dist/{production-intelligence-fwjh572m.js → production-intelligence-c8e0xw3n.js}

@@ -10,7 +10,7 @@ import {
 import {
   callControlAPI,
   callDataAPI
-} from "./cli-wkmdw40s.js";
+} from "./cli-9btx12wp.js";
 import {
   CliAuthError,
   CliInputError,
@@ -28,7 +28,7 @@ import {
   resolveModaBaseUrl,
   safeWriteStderr,
   shellWord
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/production-intelligence.ts
@@ -523,10 +523,10 @@ async function investigateProduction(options) {
       warnings.push(result.warning);
   }
   if (options.toolName && tools.status === "ok" && toolRows(tools.data, options.toolName).every((row) => row.count <= 0)) {
-    warnings.push(`No failures found for tool "${options.toolName}" in the last ${options.daysBack} day(s) — the tool may have no failures in this window, or the name may not exist in this tenant. ` + "Run `moda tool-failures` to list tools with recorded failures, or widen --days-back.");
+    warnings.push(`No failures found for tool "${options.toolName}" in the last ${options.daysBack} day(s) — the tool may have no failures in this window, or the name may not exist in this tenant. ` + "Run `moda detections tools` to list tools with recorded failures, or widen --days-back.");
   }
   if (options.conversationId) {
-    warnings.push(`Scoped to trace ${options.conversationId} for frustration evidence only; overview and tool failures are tenant-wide. ` + `Open the trace itself with \`moda audit ${options.conversationId}\`.`);
+    warnings.push(`Scoped to trace ${options.conversationId} for frustration evidence only; overview and tool failures are tenant-wide. ` + `Open the trace itself with \`moda traces spans ${options.conversationId}\`.`);
   }
   const evidenceRefs = [];
   const findings = [];
@@ -792,7 +792,7 @@ function findingsFromOverview(overview, daysBack, hints, evidenceRefs) {
         id: "action_investigate_frustration",
         title: "Inspect frustration anchors.",
         rationale: "Frustration anchors show the user turn where the experience degraded.",
-        command: `moda frustrations --days-back=${daysBack} --include-window`,
+        command: `moda detections list --family=frustration --days-back=${daysBack} --include-window`,
         mutability: "read",
         requiresApproval: false
       }]
@@ -845,7 +845,7 @@ function toolFailureFindings(data, daysBack, hints, evidenceRefs, scopedTool) {
         id: `action_tool_detail_${slug(name)}`,
         title: `Inspect ${name} failure examples.`,
         rationale: "Examples include trace anchors and error subtypes.",
-        command: `moda tool-failure-detail ${name} --days-back=${daysBack} --include-window`,
+        command: `moda detections tools ${name} --days-back=${daysBack} --include-window`,
         mutability: "read",
         requiresApproval: false
       }]
@@ -891,7 +891,7 @@ function frustrationFindings(data, daysBack, evidenceRefs) {
       id: "action_frustration_window",
       title: "Read the frustration window.",
       rationale: "The user quote and nearby turns reveal what confused or blocked the user.",
-      command: conversationId ? `moda context ${shellWord(contextTarget(conversationId))}${anchorIndex !== null ? ` --msg-index=${anchorIndex}` : ""} --window=3` : `moda frustrations --days-back=${daysBack} --include-window`,
+      command: conversationId ? `moda traces get ${shellWord(contextTarget(conversationId))}${anchorIndex !== null ? ` --msg-index=${anchorIndex}` : ""} --window=3` : `moda detections list --family=frustration --days-back=${daysBack} --include-window`,
       mutability: "read",
       requiresApproval: false
     }]
@@ -956,7 +956,7 @@ function problemFindings(data, daysBack, evidenceRefs) {
         id: `action_problem_${slug(problem.id)}`,
         title: `Open the Problem dossier for ${problem.name}.`,
         rationale: "The dossier has the cause, evidence, affected traces and verification state.",
-        command: `moda problem ${problem.id}`,
+        command: `moda problems get ${problem.id}`,
         mutability: "read",
         requiresApproval: false
       }]
@@ -1778,13 +1778,13 @@ function slug(value) {
 function purposeForCommand(command) {
   if (command.startsWith("moda investigate"))
     return "Open the ranked production investigation.";
-  if (command.startsWith("moda tool-failure-detail"))
+  if (command.startsWith("moda detections tools"))
     return "Inspect tool failure examples and trace anchors.";
   if (command.startsWith("moda problems"))
     return "List the ranked Problems.";
-  if (command.startsWith("moda problem "))
+  if (command.startsWith("moda problems get "))
     return "Open the Problem dossier.";
-  if (command.startsWith("moda context"))
+  if (command.startsWith("moda traces get"))
     return "Read the relevant trace window.";
   if (command.startsWith("moda doctor"))
     return "Validate Moda setup and data flow.";

package/dist/{profile-commands-548ts402.js → profile-commands-6e2dgv72.js}

@@ -2,7 +2,7 @@ import {
   probeApiKey,
   redactApiKey,
   resolveApiKeyCredential
-} from "./cli-4yarp5s1.js";
+} from "./cli-9hc5bg2r.js";
 import {
   authFetch,
   clearAuthSession,
@@ -10,7 +10,7 @@ import {
   loadAuthSession,
   login,
   revokeCliSessionToken
-} from "./cli-9g8vz4sv.js";
+} from "./cli-0wr3483h.js";
 import {
   CliInputError,
   DEFAULT_INGEST_URL,
@@ -35,7 +35,7 @@ import {
   secretFilePathFromRef,
   setActiveProfile,
   upsertProfile
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/profile-commands.ts

package/dist/prompt-source-mcp.js

@@ -5,12 +5,12 @@ import {
   inspectCodeSelectors,
   inspectPythonSelectors,
   safePromptEvidencePath
-} from "./cli-4f6jkrnm.js";
+} from "./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
-import"./cli-t3a6eknn.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
+import"./cli-dve50x7p.js";
 import {
   __commonJS,
   __toESM

package/dist/{prompts-p66y7wep.js → prompts-3h5jcjrw.js}

@@ -11,16 +11,16 @@ import {
   runPromptSync,
   runPromptsCommand,
   writePromptSyncProgress
-} from "./cli-s6tw1fje.js";
+} from "./cli-m805msp6.js";
 import {
   promptSourceHashPayload
 } from "./cli-mm48br00.js";
-import"./cli-4f6jkrnm.js";
+import"./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
-import"./cli-t3a6eknn.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
+import"./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 export {
   writePromptSyncProgress,

package/dist/{provision-r9fhrvpw.js → provision-q86phh4a.js}

@@ -1,18 +1,18 @@
 import {
   selectTenantAndCreateKey
-} from "./cli-d2zews6c.js";
-import"./cli-4yarp5s1.js";
+} from "./cli-qycsmxev.js";
+import"./cli-9hc5bg2r.js";
 import {
   loadAuthSession
-} from "./cli-9g8vz4sv.js";
+} from "./cli-0wr3483h.js";
 import {
   stringOption
-} from "./cli-2cggp8ww.js";
+} from "./cli-qvg26twp.js";
 import {
   CliAuthError,
   resolveIngestUrl,
   resolveModaBaseUrl
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/provision.ts

package/dist/{registry-n7dsdxmg.js → registry-s2vdsfw8.js}

@@ -1,14 +1,14 @@
 import {
   assertFlags
-} from "./cli-cv3jt1ms.js";
+} from "./cli-dn91fb56.js";
 import {
   callControlAPI
-} from "./cli-wkmdw40s.js";
+} from "./cli-9btx12wp.js";
 import {
   CliInputError,
   explicitOutputMode,
   resolveApiKey
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-0v6na3yp.js";
 
 // src/registry.ts

package/dist/{skills-c17gg69y.js → skills-vq3njc8a.js}

@@ -3,11 +3,11 @@ import {
   pullSkills,
   runSkillSync,
   runSkillsCommand
-} from "./cli-54zhv6cx.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
-import"./cli-t3a6eknn.js";
+} from "./cli-m0045npe.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
+import"./cli-dve50x7p.js";
 import"./cli-8dtnwp9r.js";
 import"./cli-0v6na3yp.js";
 export {

package/dist/{sync-bne90xvj.js → sync-hq9dpqpr.js}

@@ -1,20 +1,20 @@
 import {
   runPromptsCommand
-} from "./cli-s6tw1fje.js";
+} from "./cli-m805msp6.js";
 import"./cli-mm48br00.js";
 import {
   runHarnessCommand
-} from "./cli-4f6jkrnm.js";
+} from "./cli-7xc585hc.js";
 import"./cli-97fnztpy.js";
 import {
   runSkillsCommand
-} from "./cli-54zhv6cx.js";
-import"./cli-2cggp8ww.js";
-import"./cli-cv3jt1ms.js";
-import"./cli-wkmdw40s.js";
+} from "./cli-m0045npe.js";
+import"./cli-qvg26twp.js";
+import"./cli-dn91fb56.js";
+import"./cli-9btx12wp.js";
 import {
   CliInputError
-} from "./cli-t3a6eknn.js";
+} from "./cli-dve50x7p.js";
 import"./cli-8dtnwp9r.js";
 import"./cli-0v6na3yp.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.55.23",
+  "version": "1.55.25",
   "description": "CLI for Moda: production monitoring and evals for AI agents.",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-10-15T12:38:17.947Z",
-  "cli_version": "1.55.23",
+  "bundled_at": "2026-10-15T20:30:38.730Z",
+  "cli_version": "1.55.25",
   "skills": [
     {
       "id": "integration-cloudflare-think",

package/skills/moda-cli/SKILL.md

@@ -1,16 +1,18 @@
 ---
 name: moda-cli
 version: 3.0.0
-description: Investigate a production AI agent with the Moda CLI (`moda`) - find where something happened in real traces (search, then context), check agent health, rank what to fix (investigate, problems), and dig into tool failures, user frustration, and hallucinations. Also prompt registry sync/promote, replays, custom signals, and false-positive marking. Use when the user mentions Moda, production traces or conversations of their agent, agent failures, or asks what to fix.
+description: Investigate a production AI agent with the Moda CLI (`moda`) - find where something happened in real traces (traces search, then traces get), check agent health, rank what to fix (investigate, problems), and dig into tool failures, user frustration, and hallucinations. Also prompt registry sync/promote, replays, custom signals, and false-positive marking. Use when the user mentions Moda, production traces or conversations of their agent, agent failures, or asks what to fix.
 ---
 
 # Moda CLI
 
 `moda` queries one Moda tenant's production analytics. A **trace** is one agent
 run: every message, tool call, and step sharing one `conversation_id` (older
-names: "conversation"; `moda conversations` is an alias of `moda traces`).
-Analytics commands are read-only. Detailed guides live in `references/`; read
-one only when the task needs it.
+names: "conversation"; `moda conversations` is an alias of `moda traces list`).
+Analytics commands are read-only. Commands are `moda <noun> <verb>` (`traces`,
+`problems`, `detections`, `review`); older names such as `moda context` still
+work but warn (`meta.deprecated`), so use the forms below. Detailed guides live
+in `references/`; read one only when the task needs it.
 
 ## Before the first command
 
@@ -23,7 +25,7 @@ one only when the task needs it.
 - Not installed: `npx -y -p @moda-ai/cli moda <command>`.
 - If a response carries `meta.update`, the installed CLI is out of date and
   may not match this guide; tell the user how to update.
-- Flags: `moda <command> --help` lists every flag the command accepts, with
+- Flags: `moda <noun> <verb> --help` lists every flag the command accepts, with
   types, ranges, and defaults. Each command rejects flags it does not take and
   the error lists the valid ones; read that list instead of guessing.
 
@@ -53,74 +55,77 @@ Details: `references/output-protocol.md`.
 
 | Goal | First command | Then |
 |---|---|---|
-| Where did X happen / traces about Y | `moda search "<words>"` (`--mode=keyword` for ids, error codes, exact strings; `--include-tool-io` for tool inputs/outputs) | `moda context <conversation_id> --msg-index=<message_index> --window=3` |
+| Where did X happen / traces about Y | `moda traces search "<words>"` (`--mode=keyword` for ids, error codes, exact strings; `--include-tool-io` for tool inputs/outputs) | `moda traces get <conversation_id> --msg-index=<message_index> --window=3` |
 | Search returned nothing | Read `.warnings` (degraded mode, reason). Try a shorter phrase, `--mode=keyword`, a wider `--time-range` | `moda traces --search="<words>"` |
 | Is the agent healthy? | `moda overview --days-back=7` | `moda investigate` |
-| What to fix first? | `moda investigate` or `moda problems` (free) | `moda problem <problem_id>`, then `--evidence` / `--traces` |
-| Why is tool T failing? | `moda tool-failures` | `moda tool-failure-detail <T>` (use each row's `anchor`) |
-| What frustrates users? | `moda frustrations --limit=10` | `moda context <anchor.conversation_id> --msg-index=<anchor.msg_index>` |
-| Other emotions, laziness, hallucinations | `moda emotions --family=<f>`, `moda laziness`, `moda hallucinations --kind=contradicted` | context on the row's anchor |
-| Read one whole trace | `moda context <id> --all` (pages of up to 500 messages) | `moda audit <id>` for raw spans |
-| Read several traces or turns | `moda context <id1>@<msg_index> <id2>@<msg_index> ...` (up to 25; or one per line via `--ids-from=-`) | Same for `moda audit <id1> <id2> ...` |
-| One user's experience | `moda users`, `moda user <user_id>` | `moda search "<words>" --user-id=<id>` |
+| What to fix first? | `moda investigate` or `moda problems` (free) | `moda problems get <problem_id>`, then `--evidence` / `--traces` |
+| Why is tool T failing? | `moda detections tools` | `moda detections tools <T>` (use each row's `anchor`) |
+| What frustrates users? | `moda detections list --family=frustration --limit=10` | `moda traces get <anchor.conversation_id> --msg-index=<anchor.msg_index>` |
+| Other emotions, laziness, hallucinations | `moda detections list --family=emotion:<f>`, `moda detections list --family=laziness`, `moda detections list --family=hallucination --kind=contradicted` | context on the row's anchor |
+| Read one whole trace | `moda traces get <id> --all` (pages of up to 500 messages) | `moda traces spans <id>` for raw spans |
+| Read several traces or turns | `moda traces get <id1>@<msg_index> <id2>@<msg_index> ...` (up to 25; or one per line via `--ids-from=-`) | Same for `moda traces spans <id1> <id2> ...` |
+| One user's experience | `moda users`, `moda user <user_id>` | `moda traces search "<words>" --user-id=<id>` |
 | Topic mix | `moda clusters` | `moda cluster-traces <node_id>` |
-| What the agent believed at a turn | `moda world-state <id> --snapshot --msg-index=<n>` | |
+| What the agent believed at a turn | `moda traces state <id> --snapshot --msg-index=<n>` | |
 | A synthesized answer | `moda ask "<question>"` only when the user asks: each call is a paid agent run (up to about 200k tokens) | Exit 3 means degraded |
-| A detection is wrong | `moda false-positive <kind> <target> --reason="..."` | `references/signals-and-false-positives.md` |
+| A detection is wrong | `moda review <kind> <target> --reason="..."` | `references/signals-and-false-positives.md` |
 | Moda data looks wrong or missing | `moda feedback "<what and why>" --conversation-id=<id>` | |
 | Prompts, replays, registry push | Only on explicit request | `references/prompts.md`, `references/replays-and-registry.md` |
 
 Time windows differ by command: `--days-back=N` (1-90) on overview,
 investigate, problems, and detection commands; `--time-range=1h|24h|3d|7d|30d|90d|all`
-on search, traces, and clusters. `moda <command> --help` shows which.
+on search, traces, and clusters. `moda <noun> <verb> --help` shows which.
 
 ## Fixing a Problem
 
 1. `moda investigate` or `moda problems` to pick one; note its `problem_id`.
-2. `moda problem <problem_id> --evidence` and open two or three anchors with
-   `moda context <id> --msg-index=<n>` before deciding on a cause.
+2. `moda problems get <problem_id> --evidence` and open two or three anchors with
+   `moda traces get <id> --msg-index=<n>` before deciding on a cause.
 3. Make the change in code; cite the problem id and trace ids in the commit or PR.
-4. After it ships, and only if the user agrees:
-   `moda problem-feedback <problem_id> --action=mark_fixed`.
+4. Test a prompt change on the Problem's failing traces (a paid replay, so ask
+   first; prompt changes only today):
+   `moda prompts ab --problem=<problem_id> --baseline=<prompt_key> --candidate=<edited file>`.
+5. After it ships, and only if the user agrees:
+   `moda problems feedback <problem_id> --action=mark_fixed`.
 More: `references/production-intelligence.md`.
 
 ## Rules
 
 - Read evidence before acting on a summary; quote trace ids and message
   indexes when you report.
-- Never run writes (`problem-feedback`, `false-positive`, `signal-label`,
+- Never run writes (`problems feedback`, `review`,
   `signals create|update|...`, `prompts sync|promote|ab`, `registry push`)
   unless the user asked. Use `--dry-run` where a command offers it.
 - An empty result in a window means "nothing in that window". Widen the window
   once before saying something never happened.
-- Batch reads instead of looping one id per call: `moda context` and
-  `moda audit` take up to 25 ids and report per-item results.
+- Batch reads instead of looping one id per call: `moda traces get` and
+  `moda traces spans` take up to 25 ids and report per-item results.
 - Do not load `moda manifest --json` or `moda --json-schemas` to learn the CLI
-  (about 20k and 11k tokens). Use `moda <command> --help`.
+  (about 20k and 11k tokens). Use `moda <noun> <verb> --help`.
 
 ## Recipes
 
 Find where something happened and read the turn:
 
 ```bash
-moda search "refund not processed" --limit=5 --json \
+moda traces search "refund not processed" --limit=5 --json \
   | jq -r 'first(.results[] | select(.message_index != null)) | "\(.conversation_id) \(.message_index)"' \
-  | while read id idx; do moda context "$id" --msg-index="$idx" --window=3; done
+  | while read id idx; do moda traces get "$id" --msg-index="$idx" --window=3; done
 ```
 
 Open the turn behind the top frustration:
 
 ```bash
-moda frustrations --limit=5 --json \
+moda detections list --family=frustration --limit=5 --json \
   | jq -r 'first(.frustrations[] | select(.anchor.msg_index != null)) | .anchor | "\(.conversation_id) \(.msg_index)"' \
-  | while read id idx; do moda context "$id" --msg-index="$idx" --window=2; done
+  | while read id idx; do moda traces get "$id" --msg-index="$idx" --window=2; done
 ```
 
 Which tool fails most, and an example:
 
 ```bash
-moda tool-failures --json | jq '.tools[] | {tool: .tool_name, failures: .failure_count}'
-moda tool-failure-detail <tool_name> --limit=3
+moda detections tools --json | jq '.tools[] | {tool: .tool_name, failures: .failure_count}'
+moda detections tools <tool_name> --limit=3
 ```
 
 ## References