@moda-ai/cli 1.24.0 → 1.26.0

package/README.md

@@ -34,49 +34,87 @@ Get your API key from [moda.dev/settings](https://moda.dev/settings).
 
 ## Usage
 
+Find things by meaning, then drill in:
+
 ```bash
-moda overview                                    # Dashboard overview
-moda overview --days-back=30                     # Last 30 days
+moda search "user wants a refund" --mode=semantic  # Semantic/keyword/hybrid message search
+moda search "stripe.charges.create" --mode=keyword # Exact identifiers, incl. tool calls
+moda search "checkout" --include-tool-io           # Search tool inputs/outputs too
+moda context <conversation_id> --msg-index=5       # Read the exact turn
+moda audit <conversation_id|trace_id>              # Raw span/trace audit
+```
 
-moda clusters                                    # Browse topic clusters
-moda clusters --parent-id=node-abc               # Drill into a category
+Production intelligence:
 
-moda cluster-conversations <node_id>             # Conversations in a cluster
+```bash
+moda overview --days-back=30                     # Health briefing (KPIs, clusters, activity)
+moda ask "what should I fix first?"              # Grounded answer with evidence
+moda investigate                                 # Ranked issues worth fixing
+moda problems                                    # Cross-signal Problems by root cause
+moda problem <problem_id>                        # One Problem: full dossier
+moda problem <problem_id> --evidence             #   ...attribution evidence (keyset paged)
+moda problem <problem_id> --reports              #   ...investigation reports
+moda problem <problem_id> --conversations        #   ...affected conversations
+moda problem-feedback <problem_id> --action=mark_fixed   # Close the loop from the terminal
+```
 
-moda conversations --search="error"              # Search conversations
-moda conversations --time-range=24h              # Filter by time
-moda conversations --environment=production      # Filter by environment
+Signals:
 
-moda context <conversation_id>                   # Get conversation context
-moda context <conversation_id> --msg-index=5     # Center on message 5
+```bash
+moda emotions --family=confusion                 # Multi-family emotion detections
+moda hallucinations --kind=contradicted          # Grounding: contradicted/verified outputs
+moda frustrations --include-window --window=1    # Legacy single-family frustration view
+moda tool-failures                               # Tool failure overview
+moda tool-failure-detail <tool_name> --include-window
+moda step-scores <conversation_id>               # Graph-PRM per-step reward curves
+```
 
-moda frustrations                                # User frustration detections
-moda frustrations --days-back=14 --limit=20
-moda frustrations --include-window --window=1    # Attach 3-message slice per row
+Conversations, clusters, memory:
 
-moda tool-failures                               # Tool failure overview
-moda tool-failure-detail <tool_name>             # Per-tool failure detail
-moda tool-failure-detail <tool_name> --include-window --window=1
+```bash
+moda conversations --search="error" --environment=production
+moda clusters                                    # Walk the topic hierarchy
+moda clusters --search="billing disputes"        # Find a cluster by meaning
+moda world-state <conversation_id>               # Agent memory (slots/threads/events)
+moda world-state <id> --snapshot --msg-index=42  # What the agent believed at turn 42
+moda world-state <id> --replay --message-count=50  # State evolution frame by frame
+```
 
-moda feedback "cluster label looks wrong"        # Help us improve: flag wrong/missing data
-moda feedback "..." --category=missing_data --conversation-id=<id>
+Live tail (one JSON line per new item — `tail -f` for your agent):
 
-# Prompt management
+```bash
+moda tail                                        # New conversations, every 15s
+moda tail --signal=all --interval=30             # Conversations + emotion detections
+```
+
+Prompt management:
+
+```bash
 moda prompts init                                # Create .moda/prompts.yml
 moda prompts status                              # Read-only local prompt status
-moda prompts diff                                # Read-only local prompt diff/status
 moda prompts sync                                # Upload changed prompt versions
-moda prompts sync --watch                        # Sync when local prompt hashes change
 moda prompts promote support.triage --label=prod --version=pver_abc123
 ```
 
-All commands output JSON. Pipe to `jq` for filtering:
+Feedback:
 
 ```bash
-moda overview | jq '.frustrations'
-moda frustrations | jq '.frustrations[].primary_cause'
+moda feedback "cluster label looks wrong" --category=bad_cluster_label
 ```
 
+Output adapts to where it runs: piped/CI/agent environments get schema-versioned
+JSON (`moda.agent.v1`), an interactive terminal gets human prose. Force a mode
+with `--json`, `--agent`, or `--human`. In JSON modes, pipe to `jq`:
+
+```bash
+moda overview | jq '.data.metrics'
+moda frustrations | jq '.data.frustrations[].primary_cause'
+```
+
+Every command supports `moda <command> --help` for scoped usage, and
+`moda manifest --json` describes the full machine protocol (commands, exit
+codes, event schema) for agents.
+
 ## Prompt Management
 
 Prompt management is code-first. Keep prompts in `prompts/**/*.prompt.md` or

package/dist/{cli-vc7zddj1.js → cli-59yacef3.js}

@@ -1301,6 +1301,19 @@ function createAgentEvent(command, event, state) {
   };
   return redactDeep(stamped);
 }
+function formatValidationMessage(error) {
+  const issues = error.issues;
+  if (error.name !== "ZodError" || !Array.isArray(issues) || issues.length === 0) {
+    return error.message;
+  }
+  const parts = issues.map((issue) => {
+    const record = issue;
+    const path = Array.isArray(record.path) && record.path.length > 0 ? record.path.join(".") : "input";
+    const message = typeof record.message === "string" ? record.message : "is invalid";
+    return `${path}: ${message}`;
+  });
+  return `Validation error — ${parts.join("; ")}`;
+}
 function errorToAgentError(error) {
   if (error instanceof CliInputRequiredError) {
     return {
@@ -1344,7 +1357,7 @@ function errorToAgentError(error) {
     if (error instanceof CliInputError || error.name === "ZodError") {
       return {
         code: "input_error",
-        message: error.message,
+        message: formatValidationMessage(error),
         cause: "usage" in error && typeof error.usage === "string" ? error.usage : undefined,
         suggested_commands: "usage" in error && typeof error.usage === "string" ? extractSuggestedCommands(error.usage) : undefined,
         blocking: true

package/dist/{cli-8s69sg7f.js → cli-9xw5bq1j.js}

@@ -8,7 +8,7 @@ import {
   saveProfileConfig,
   secretFilePathFromRef,
   writeSecretJsonFile
-} from "./cli-vc7zddj1.js";
+} from "./cli-59yacef3.js";
 
 // src/auth-storage.ts
 import { existsSync, readFileSync, rmSync } from "node:fs";

package/dist/{cli-f2f0twjw.js → cli-g931ntph.js}

@@ -23,7 +23,7 @@ import {
   resolveTenantId,
   shouldInventoryFile,
   stringOption
-} from "./cli-vc7zddj1.js";
+} from "./cli-59yacef3.js";
 
 // src/api-client.ts
 var REQUEST_TIMEOUT_MS = 30000;
@@ -3314,6 +3314,17 @@ async function runHarnessCommand(context) {
       return { exitCode: 0 };
     }
     case "analyze": {
+      const cliAnalyzeEnabled = context.flags["experimental"] === "true" || process.env.MODA_HARNESS_ANALYZE_CLI === "1";
+      if (!cliAnalyzeEnabled) {
+        context.output.writeData({
+          schema: "harness_analyze_disabled.v0.1",
+          status: "disabled",
+          reason: "cli_analyze_gated",
+          message: "Harness analysis now runs automatically via the Moda GitHub App — connect your repo in the Moda dashboard (Settings → Integrations). To run the experimental CLI analyze anyway, pass --experimental or set MODA_HARNESS_ANALYZE_CLI=1."
+        });
+        writeHumanProgress(context, "moda harness analyze is disabled: connect the Moda GitHub App (Settings → Integrations) for automatic analysis, or pass --experimental to run the CLI analyze.");
+        return { exitCode: 1 };
+      }
       await approveScanIfNeeded(scanPlan, {
         context,
         message: "Run Moda Analyst to investigate this project and produce a cited harness report?",
@@ -3327,7 +3338,7 @@ async function runHarnessCommand(context) {
         elapsed_ms: Date.now() - context.startedAt
       });
       if (context.flags["github-actions"] === "true") {
-        const { runGithubActionsAnalyze } = await import("./harness-github-actions-ar3sfmqq.js");
+        const { runGithubActionsAnalyze } = await import("./harness-github-actions-ct8fwzdr.js");
         const result = await runGithubActionsAnalyze(rootDir, {
           writeReport: (report2) => {
             const normalized = normalizeHarnessReport(report2);

package/dist/{cli-tdttb4cv.js → cli-pq6rte0w.js}

@@ -1,7 +1,7 @@
 import {
   authFetch,
   getCachedLoginContext
-} from "./cli-8s69sg7f.js";
+} from "./cli-9xw5bq1j.js";
 import {
   CliAccessError,
   CliInputError,
@@ -15,7 +15,7 @@ import {
   resolveTenantIdFromActiveProfile,
   saveCliConfig,
   writeSecretJsonFile
-} from "./cli-vc7zddj1.js";
+} from "./cli-59yacef3.js";
 
 // src/init/tenant.ts
 import { randomUUID } from "node:crypto";

package/dist/{cli-0t9z27pc.js → cli-xf5nx5hc.js}

@@ -11,11 +11,11 @@ import {
   renderStatusHuman,
   scanHarness,
   validateHarnessReport
-} from "./cli-f2f0twjw.js";
+} from "./cli-g931ntph.js";
 import {
   isAuthSessionValid,
   loadAuthSession
-} from "./cli-8s69sg7f.js";
+} from "./cli-9xw5bq1j.js";
 import {
   CliInputError,
   createCommandContext,
@@ -31,7 +31,7 @@ import {
   resolveTenantId,
   secretFilePathFromRef,
   validateConfig
-} from "./cli-vc7zddj1.js";
+} from "./cli-59yacef3.js";
 
 // src/prompts.ts
 import { execFileSync } from "node:child_process";
@@ -2397,7 +2397,7 @@ function harnessReportStateCheck(cwd) {
       severity: "warning",
       evidence: [{ label: "path", value: HARNESS_REPORT_PATH }],
       remediation: "Run a Moda Analyst pass so the harness graph has cited evidence before cloud sync.",
-      nextCommand: "moda harness analyze --summary"
+      nextCommand: "moda harness analyze --experimental --summary"
     };
   }
   try {
@@ -2421,7 +2421,7 @@ function harnessReportStateCheck(cwd) {
           { label: "errors", value: validation.errors.slice(0, 3).join(" | ") || "validation failed" }
         ],
         remediation: "Regenerate or fix the harness report before approving or syncing.",
-        nextCommand: "moda harness analyze --summary"
+        nextCommand: "moda harness analyze --experimental --summary"
       };
     }
     const approval = readHarnessReportApproval(cwd);
@@ -2476,7 +2476,7 @@ function harnessReportStateCheck(cwd) {
         { label: "error", value: err instanceof Error ? err.message : String(err) }
       ],
       remediation: "Regenerate the harness report.",
-      nextCommand: "moda harness analyze --summary"
+      nextCommand: "moda harness analyze --experimental --summary"
     };
   }
 }