@moda-ai/cli 1.13.9 → 1.13.11

package/README.md

@@ -58,9 +58,6 @@ 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
 
-moda loops                                       # Currently-active loop detections
-moda loop <detection_id>                         # One loop detail (signature + blast radius)
-
 # Prompt management
 moda prompts init                                # Create .moda/prompts.yml
 moda prompts status                              # Read-only local prompt status
@@ -75,7 +72,6 @@ All commands output JSON. Pipe to `jq` for filtering:
 ```bash
 moda overview | jq '.frustrations'
 moda frustrations | jq '.frustrations[].primary_cause'
-moda loops | jq '.loops | sort_by(-.cycle_visits) | .[0:5] | .[].loop_signature_human'
 ```
 
 ## Prompt Management

package/dist/agent-schemas.js

@@ -224,7 +224,7 @@ const productionEvidenceRefSchema = {
         id: { type: 'string' },
         kind: {
             type: 'string',
-            enum: ['data_api', 'tool_failure', 'frustration', 'loop', 'run', 'harness', 'ask'],
+            enum: ['data_api', 'tool_failure', 'frustration', 'run', 'harness', 'ask'],
         },
         label: { type: 'string' },
         endpoint: { type: 'string' },
@@ -284,7 +284,6 @@ const productionFindingSchema = {
             type: 'string',
             enum: [
                 'tool_failure',
-                'loop',
                 'frustration',
                 'partial_run',
                 'prompt_regression',

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { z } from 'zod';
 import { validateConfig, VERSION, resolveApiKey } from './config.js';
 import { callDataAPI, ApiError, getApiRequestCount, resetApiRequestCount, } from './api-client.js';
-import { OverviewSchema, ClustersSchema, ClusterConversationsSchema, ConversationsSchema, SearchSchema, WorldStateSchema, ContextSchema, AuditSchema, FrustrationsSchema, ToolFailuresSchema, ToolFailureDetailSchema, LoopsSchema, LoopDetailSchema, } from './schemas.js';
+import { OverviewSchema, ClustersSchema, ClusterConversationsSchema, ConversationsSchema, SearchSchema, WorldStateSchema, ContextSchema, AuditSchema, FrustrationsSchema, ToolFailuresSchema, ToolFailureDetailSchema, } from './schemas.js';
 import { withFrustrationAnchors, withToolFailureAnchors, embeddedWindowSize, asRecord, asString, asNumber } from './transforms.js';
 import { runPromptsCommand } from './prompts.js';
 // Coding-agent capture (shadow workspace / Shadow Spark / trace hooks) is temporarily
@@ -171,9 +171,6 @@ Commands:
   tool-failures                    Get tool failure overview
   tool-failure-detail <tool_name>  Get per-tool failure detail
 
-  loops                            Currently-active loop detections
-  loop <detection_id>              Single loop detail
-
   Prompt management:
   prompts init                     Create .moda/prompts.yml
   prompts status                   Show local prompt changes
@@ -306,8 +303,6 @@ Examples:
   moda context <conversation_id> --window=3
   moda audit <conversation_id|trace_id>
   moda audit <trace_id> --kind=trace --json
-  moda loops --limit=10
-  moda loop 12345678-1234-1234-1234-1234567890ab
   moda prompts status
   moda prompts sync
   moda prompts promote support.triage --label=prod --version=pver_abc123
@@ -617,27 +612,6 @@ export async function runCommand(command, positional, flags, positionals = posit
             await printWithOptionalWindows(withToolFailureAnchors(data), 'examples', params.include_window === true, params.window ?? 1, context.output);
             break;
         }
-        case 'loops': {
-            const args = flagsToArgs(flags);
-            const params = LoopsSchema.parse(args);
-            const query = new URLSearchParams();
-            if (params.limit)
-                query.set('limit', params.limit.toString());
-            const queryString = query.toString() ? `?${query.toString()}` : '';
-            const data = await callDataAPI(`/loops/active${queryString}`);
-            context.output.writeData(data);
-            break;
-        }
-        case 'loop': {
-            if (!positional) {
-                throw new CliInputError('<detection_id> is required', 'Usage: moda loop <detection_id>');
-            }
-            const args = flagsToArgs(flags, 'detection_id', positional);
-            const params = LoopDetailSchema.parse(args);
-            const data = await callDataAPI(`/loops/${params.detection_id}`);
-            context.output.writeData(data);
-            break;
-        }
         default:
             throw new CliInputError(`Unknown command '${command}'`, 'Run "moda --help" for usage information.');
     }
@@ -1044,18 +1018,6 @@ export const commandRegistry = createCommandRegistry([
         examples: ['moda tool-failure-detail search --include-window'],
         ...dataApiDefaults,
     }),
-    legacyCommand({
-        name: 'loops',
-        description: 'List currently-active loop detections',
-        examples: ['moda loops --limit=10'],
-        ...dataApiDefaults,
-    }),
-    legacyCommand({
-        name: 'loop',
-        description: 'Get a single loop detection',
-        examples: ['moda loop 12345678-1234-1234-1234-1234567890ab'],
-        ...dataApiDefaults,
-    }),
     legacyCommand({
         name: 'prompts',
         description: 'Manage prompt versions and labels',

package/dist/harness-artifact-bodies.js

@@ -214,10 +214,18 @@ function hydrateArtifactBody(artifact, rootDir) {
     }
     const evidenceLine = firstEvidenceLineNumber(artifact.evidence);
     const evidencePath = firstEvidencePath(artifact);
-    if (evidencePath && evidenceLine !== undefined) {
+    if (evidencePath) {
         const text = readRepoRelativeText(rootDir, evidencePath);
         if (text !== undefined) {
-            return extractSnippetAroundLine(text, evidenceLine, artifact.type === 'tool' ? 30 : 80);
+            if (evidenceLine !== undefined) {
+                return extractSnippetAroundLine(text, evidenceLine, artifact.type === 'tool' ? 30 : 80);
+            }
+            // No line number (common for agent/hosted analyst citations): fall back to
+            // the whole evidence file so the body is still captured in full.
+            if (artifact.type === 'prompt' || isDedicatedToolFilePath(evidencePath))
+                return text;
+            if (artifact.type === 'tool')
+                return extractToolBodyFromText(text, artifact.name) ?? text;
         }
     }
     return undefined;

package/dist/harness-remote.js

@@ -97,15 +97,34 @@ export async function runRemoteHarnessAnalyst(options) {
     });
     writeHumanProgress(context, `Moda Analyst (remote): analysis run ${runId} accepted; waiting for results...`);
     const final = await pollRemoteAnalyze({ ingestUrl, apiKey, runId, context });
-    if (final.status !== 'completed' || !final.report) {
-        const detail = final.status === 'failed'
-            ? `Remote harness analysis failed: ${final.error ?? 'unknown error'}.`
-            : `Remote harness analysis did not finish before the timeout (last status: ${final.status}).`;
-        throw new CliInputError(detail, [
-            `Retry \`moda harness analyze --remote\`${runId ? ` (run ${runId})` : ''}.`,
-            'Or run `moda harness analyze --analyst=local-scan` to analyze locally.',
-            'Increase MODA_HARNESS_REMOTE_TIMEOUT_MS if large repos need longer.',
-        ].join('\n'));
+    // A run that returned no report at all is a hard failure (timeout, or the
+    // hosted agent crashed before producing anything) — nothing to recover.
+    if (!final.report) {
+        throw remoteAnalyzeHardFailure(final, runId);
+    }
+    // A `failed` run only qualifies for client-side recovery when the server tells
+    // us the failure was its own REPORT VALIDATION (it produced a report but the
+    // report-contract check failed). That is the one class the client can recover:
+    // the uploaded snapshot is truncated/sampled, so the hosted analyst commonly
+    // leaves prompt/tool `body` (or citation lines) empty, and the client — which
+    // has the full local repo — can backfill those source-dependent gaps and
+    // re-validate. Any other `failed` run (a crashed/aborted agent, which carries
+    // an `error` string and no structured validation verdict) stays a hard failure
+    // even if a partial report leaked through, so we never write or sync a report
+    // from a hosted run the server aborted for a reason the client cannot repair.
+    if (final.status === 'failed' && !serverFailedReportValidation(final)) {
+        throw remoteAnalyzeHardFailure(final, runId);
+    }
+    // The hosted analyst returned a report that failed SERVER-side validation —
+    // most often because it enumerated prompt/tool artifacts but left their `body`
+    // empty, or because the uploaded snapshot was truncated so the server never
+    // saw the source. The client has the full local repo, so `repairExternalAnalystReport`
+    // backfills those bodies from disk here and we re-validate locally before
+    // deciding the outcome (a report that stays invalid after repair still exits 1
+    // and is never synced). This lets `--remote` succeed even when the server
+    // could not complete the report.
+    if (final.status === 'failed') {
+        writeHumanProgress(context, 'Moda Analyst (remote): server validation incomplete; completing artifact bodies from local source...');
     }
     let report = repairExternalAnalystReport(normalizeHarnessReport(final.report), rootDir);
     if (snapshot.truncated) {
@@ -145,6 +164,33 @@ export async function runRemoteHarnessAnalyst(options) {
     });
     return { exitCode: validation.status === 'pass' ? 0 : 1 };
 }
+/** Build the terminal error for a remote run that cannot be recovered client-side. */
+function remoteAnalyzeHardFailure(final, runId) {
+    const detail = final.status === 'failed'
+        ? `Remote harness analysis failed: ${final.error ?? 'unknown error'}.`
+        : `Remote harness analysis did not finish before the timeout (last status: ${final.status}).`;
+    return new CliInputError(detail, [
+        `Retry \`moda harness analyze --remote\`${runId ? ` (run ${runId})` : ''}.`,
+        'Or run `moda harness analyze --analyst=local-scan` to analyze locally.',
+        'Increase MODA_HARNESS_REMOTE_TIMEOUT_MS if large repos need longer.',
+    ].join('\n'));
+}
+/**
+ * True when a `failed` hosted run failed specifically because its own report
+ * validation failed — the only server failure the client can recover. The hosted
+ * service attaches a structured validation verdict (`{ status: 'fail', ... }`)
+ * only when it produced a report that failed the report-contract check
+ * (`apps/moda-harness-analyze` server.ts); an operational failure (crashed agent)
+ * reports an `error` string with no validation object. Gating recovery on this
+ * verdict keeps crashed/aborted runs as hard failures, and the mandatory
+ * client-side re-validation still rejects any report that stays invalid after
+ * body/citation repair.
+ */
+function serverFailedReportValidation(final) {
+    const { validation } = final;
+    return typeof validation === 'object' && validation !== null && !Array.isArray(validation)
+        && validation.status === 'fail';
+}
 /** Map CLI flags to the optional server-side analyze options in the wire contract. */
 function buildRemoteAnalyzeOptions(flags) {
     const options = {};

package/dist/harness.js

@@ -730,6 +730,10 @@ function parseHarnessReportCandidate(candidate) {
 export function repairExternalAnalystReport(report, rootDir) {
     const normalized = normalizeHarnessReport(report);
     repairCitationLines(normalized, rootDir);
+    // Agent/hosted analysts reliably enumerate prompt/tool artifacts but often omit
+    // the verbatim `body`. Backfill it from source the same way local-scan does so
+    // external reports satisfy the prompt/tool body requirement.
+    hydratePromptAndToolBodies(normalized.graph, rootDir);
     repairReportSummaryCounts(normalized);
     return normalized;
 }

package/dist/production-intelligence.d.ts

@@ -5,10 +5,10 @@ declare const INVESTIGATION_SCHEMA_VERSION = "production_investigation.v0.1";
 declare const OVERVIEW_SCHEMA_VERSION = "production_overview.v0.1";
 declare const ASK_SCHEMA_VERSION = "production_ask.v0.1";
 type Severity = 'critical' | 'high' | 'medium' | 'low' | 'info';
-type FindingKind = 'tool_failure' | 'loop' | 'frustration' | 'prompt_regression' | 'skill_gap' | 'insufficient_data';
+type FindingKind = 'tool_failure' | 'frustration' | 'prompt_regression' | 'skill_gap' | 'insufficient_data';
 export interface ProductionEvidenceRef {
     id: string;
-    kind: 'data_api' | 'tool_failure' | 'frustration' | 'loop' | 'harness' | 'ask';
+    kind: 'data_api' | 'tool_failure' | 'frustration' | 'harness' | 'ask';
     label: string;
     endpoint?: string;
     conversationId?: string;
@@ -54,7 +54,6 @@ export interface ProductionInvestigation {
     scope: {
         conversationId?: string;
         toolName?: string;
-        loopId?: string;
         question?: string;
     };
     summary: {
@@ -137,7 +136,6 @@ export declare function investigateProduction(options: {
     cwd: string;
     conversationId?: string;
     toolName?: string;
-    loopId?: string;
     question?: string;
     failureOnly?: boolean;
 }): Promise<ProductionInvestigation>;

package/dist/production-intelligence.js

@@ -66,7 +66,6 @@ export async function runProductionCommand(context) {
             cwd: context.cwd,
             conversationId: context.flags.conversation,
             toolName: context.flags.tool,
-            loopId: context.flags.loop,
         });
         writeInvestigation(context, investigation);
         return { exitCode: 0 };
@@ -127,16 +126,12 @@ export async function investigateProduction(options) {
         ? `/tool-failures/${encodeURIComponent(options.toolName)}?days_back=${options.daysBack}&limit=5`
         : `/tool-failures?days_back=${options.daysBack}`;
     const frustrationsEndpoint = `/frustrations?days_back=${options.daysBack}&limit=5`;
-    const loopsEndpoint = options.loopId
-        ? `/loops/${encodeURIComponent(options.loopId)}`
-        : '/loops/active?limit=20';
-    const [overview, tools, frustrations, loops] = await Promise.all([
+    const [overview, tools, frustrations] = await Promise.all([
         safeData(overviewEndpoint),
         safeData(toolEndpoint),
         safeData(frustrationsEndpoint),
-        safeData(loopsEndpoint),
     ]);
-    for (const [key, result] of Object.entries({ overview, tools, frustrations, loops })) {
+    for (const [key, result] of Object.entries({ overview, tools, frustrations })) {
         sourceStatus[key] = result.status;
         if (result.warning)
             warnings.push(result.warning);
@@ -147,10 +142,6 @@ export async function investigateProduction(options) {
     findings.push(...toolFailureFindings(tools.data, options.daysBack, hints, evidenceRefs, options.toolName));
     if (!options.failureOnly) {
         findings.push(...frustrationFindings(frustrations.data, options.daysBack, evidenceRefs));
-        findings.push(...loopFindings(loops.data, evidenceRefs, options.loopId));
-    }
-    else {
-        findings.push(...loopFindings(loops.data, evidenceRefs, options.loopId));
     }
     if (findings.length === 0) {
         findings.push(insufficientDataFinding(overview.data, evidenceRefs));
@@ -165,7 +156,6 @@ export async function investigateProduction(options) {
         scope: {
             ...(options.conversationId ? { conversationId: options.conversationId } : {}),
             ...(options.toolName ? { toolName: options.toolName } : {}),
-            ...(options.loopId ? { loopId: options.loopId } : {}),
             ...(options.question ? { question: options.question } : {}),
         },
         summary: summarizeInvestigation(boundedFindings),
@@ -444,44 +434,6 @@ function frustrationFindings(data, daysBack, evidenceRefs) {
                 }],
         }];
 }
-function loopFindings(data, evidenceRefs, scopedLoopId) {
-    const rows = loopRows(data);
-    return rows.flatMap((loop) => {
-        const id = loop.id || scopedLoopId;
-        if (!id)
-            return [];
-        const evidenceId = `loop:${id}`;
-        evidenceRefs.push({
-            id: evidenceId,
-            kind: 'loop',
-            label: loop.signature || `${loop.type || 'Loop'} detected`,
-            endpoint: `/loops/${id}`,
-            detectionId: id,
-            conversationId: loop.conversationId,
-            value: loop.raw,
-        });
-        return [{
-                id: `finding_loop_${slug(id)}`,
-                kind: 'loop',
-                title: loop.signature || `${loop.type || 'Loop'} detected`,
-                severity: loop.blastRadius >= 5 ? 'high' : 'medium',
-                confidence: 'high',
-                impactScore: 84 + Math.min(loop.blastRadius, 10),
-                rankReason: `Active loop detection${loop.blastRadius ? ` with blast radius ${loop.blastRadius}` : ''}.`,
-                summary: loop.rootCause || 'The agent appears to repeat work or retry a failing path.',
-                evidenceRefIds: [evidenceId],
-                likelyLocations: [unknownLocation('prompt', 'Loops often come from retry policy, stop conditions, or tool handling.')],
-                recommendedActions: [{
-                        id: `action_loop_${slug(id)}`,
-                        title: 'Inspect loop detail.',
-                        rationale: 'Loop detail includes signature, cycle length, and root-cause hypothesis.',
-                        command: `moda loop ${id}`,
-                        mutability: 'read',
-                        requiresApproval: false,
-                    }],
-            }];
-    });
-}
 function insufficientDataFinding(overview, evidenceRefs) {
     const evidenceId = 'overview:data';
     if (!evidenceRefs.some((ref) => ref.id === evidenceId)) {
@@ -1060,28 +1012,6 @@ function toolRows(data, scopedTool) {
             }];
     });
 }
-function loopRows(data) {
-    const record = asRecord(data);
-    const rows = Array.isArray(record?.loops)
-        ? record.loops
-        : asRecord(record)
-            ? [record]
-            : [];
-    return rows.flatMap((item) => {
-        const row = asRecord(item);
-        if (!row)
-            return [];
-        return [{
-                id: asString(row.detection_id) ?? '',
-                type: asString(row.loop_type) ?? undefined,
-                signature: asString(row.loop_signature_human) ?? undefined,
-                blastRadius: numberValue(row.blast_radius),
-                conversationId: asString(row.conversation_id) ?? undefined,
-                rootCause: asString(row.root_cause_hypothesis) ?? undefined,
-                raw: row,
-            }];
-    }).filter((loop) => loop.id);
-}
 function firstQuote(row) {
     const quotes = Array.isArray(row?.user_quotes) ? row.user_quotes : [];
     const first = asRecord(quotes[0]);
@@ -1335,7 +1265,6 @@ function evidenceKind(value) {
     if (value === 'data_api' ||
         value === 'tool_failure' ||
         value === 'frustration' ||
-        value === 'loop' ||
         value === 'harness' ||
         value === 'ask')
         return value;
@@ -1355,8 +1284,6 @@ function purposeForCommand(command) {
         return 'Inspect tool failure examples and conversation anchors.';
     if (command.startsWith('moda context'))
         return 'Read the relevant conversation window.';
-    if (command.startsWith('moda loop'))
-        return 'Inspect loop detection details.';
     if (command.startsWith('moda doctor'))
         return 'Validate Moda setup and data flow.';
     if (command.startsWith('moda overview'))

package/dist/schemas.d.ts

@@ -185,20 +185,4 @@ export declare const SearchSchema: z.ZodObject<{
     limit?: number | undefined;
     user_id?: string | undefined;
 }>;
-/** moda loops — currently active loop detections. */
-export declare const LoopsSchema: z.ZodObject<{
-    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-}, "strip", z.ZodTypeAny, {
-    limit?: number | undefined;
-}, {
-    limit?: number | undefined;
-}>;
-/** moda loop <detectionId> — single loop detection detail. */
-export declare const LoopDetailSchema: z.ZodObject<{
-    detection_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    detection_id: string;
-}, {
-    detection_id: string;
-}>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.js

@@ -92,12 +92,4 @@ export const SearchSchema = z.object({
     time_range: z.enum(TIME_RANGES).default('all').optional(),
     limit: z.number().min(1).max(100).default(20).optional(),
 });
-/** moda loops — currently active loop detections. */
-export const LoopsSchema = z.object({
-    limit: z.number().min(1).max(200).default(25).optional(),
-});
-/** moda loop <detectionId> — single loop detection detail. */
-export const LoopDetailSchema = z.object({
-    detection_id: z.string().uuid({ message: 'detection_id must be a UUID' }),
-});
 //# sourceMappingURL=schemas.js.map

package/dist/tui.js

@@ -298,7 +298,6 @@ function overviewSignals(record) {
         ['Frustrations', valueAt(record, ['frustrations', 'total']) ?? record.frustrations],
         ['Runs', valueAt(record, ['runs', 'total']) ?? record.runs],
         ['Workflows', valueAt(record, ['workflows', 'total']) ?? record.workflows],
-        ['Loops', valueAt(record, ['loops', 'active']) ?? valueAt(record, ['loops', 'total']) ?? record.loops],
     ];
     return candidates
         .map(([label, value]) => [label, metricText(value)])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.13.9",
+  "version": "1.13.11",
   "description": "CLI for Moda - AI agent analytics and observability",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-07-08T05:27:07.614Z",
-  "cli_version": "1.13.9",
+  "bundled_at": "2026-07-08T07:05:48.702Z",
+  "cli_version": "1.13.11",
   "skills": [
     {
       "id": "integration-node-anthropic",

package/skills/moda-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: moda-cli
 version: 2.1.0
-description: Query Moda's AI agent conversation analytics and manage code-first prompt versions from the terminal — semantic/keyword/hybrid message search, overview KPIs, topic clusters, message context, user frustration detections, tool failures, active loop detections, and moda prompts status/sync/promote. Use when the user asks about moda, modaflows, conversation analytics, prompt management, user frustrations, agent observability, tool failure debugging, wants to find conversations or tool calls about a topic, or wants to investigate how their AI agent is performing.
+description: Query Moda's AI agent conversation analytics and manage code-first prompt versions from the terminal — semantic/keyword/hybrid message search, overview KPIs, topic clusters, message context, user frustration detections, tool failures, and moda prompts status/sync/promote. Use when the user asks about moda, modaflows, conversation analytics, prompt management, user frustrations, agent observability, tool failure debugging, wants to find conversations or tool calls about a topic, or wants to investigate how their AI agent is performing.
 ---
 
 # Moda CLI
@@ -475,7 +475,7 @@ Data API fallback. Abbreviated envelope:
 ```
 
 `moda investigate` also accepts scoping flags (`--tool`, `--run`,
-`--conversation`, `--loop`) to focus the ranking on one signal.
+`--conversation`) to focus the ranking on one signal.
 
 ### 3. Browse topic clusters
 
@@ -578,21 +578,7 @@ Pass `--include-window` to attach a `window` field per row with the message
 slice centered on the anchor. `--window=N` (1–5, default `1`) is the
 half-width; `--window=1` ⇒ 3 messages total (anchor ± 1).
 
-### 7. Active loop investigation
-
-```bash
-moda loops                                      # everything currently stuck
-moda loops --limit=10
-moda loop <detection_id>                        # one loop signature in detail
-```
-
-Loops are detected in real time by the conversation worker (tier 0/1) and
-the analytics container (tier 2). A row with `cycle_visits=378` means the
-agent re-ran the same action 378 times. Use the `loop_signature_human`
-field to recognize cross-conversation patterns (one tool definition bug
-will produce identical signatures across many users).
-
-### 8. Prompt management
+### 7. Prompt management
 
 Use these only when working on the code-first prompt registry.
 
@@ -762,8 +748,6 @@ npx: `npx -p @moda-ai/cli moda <command>`.
 | `moda frustrations` | User frustration detections with evidence |
 | `moda tool-failures` | Tool failure overview |
 | `moda tool-failure-detail <tool_name>` | Per-tool failure breakdown + examples |
-| `moda loops` | Currently-active loop detections |
-| `moda loop <detection_id>` | One loop signature with blast radius |
 | `moda prompts status` | Read-only local prompt status |
 | `moda prompts diff` | Read-only local prompt diff/status |
 | `moda prompts sync` | Upload changed prompt versions and update lockfile |