@zhixuan92/multi-model-agent-core 4.0.2 → 4.0.4

package/dist/providers/runner-shell.js

@@ -1,18 +1,123 @@
+import { resolveRateCard, priceTokens } from '../bounded-execution/cost-compute.js';
 const DEFAULT_CAPABILITIES = {
     cache_control: false, thinking: false, vision: false, tool_use: true, streaming: false, other: [],
 };
+// Tool-name sets are centralized in `tool-name-sets.ts` so the
+// runner-shell + running-headline-sink can't drift. Note: this
+// runner's READ list is intentionally narrower than the central
+// READ_TOOL_NAMES — runner-shell tracks filesRead by extractable
+// path, and grep/glob/listFiles don't have a single "file" arg. The
+// central set is for the polling headline's read activity counter,
+// which counts every read-class tool call regardless of args.
+import { WRITE_TOOL_NAMES, SHELL_TOOL_NAMES } from './tool-name-sets.js';
+const READ_TOOL_NAMES = new Set(['readFile', 'read_file']);
+function extractPathFromToolInput(input) {
+    if (typeof input !== 'object' || input === null)
+        return undefined;
+    const obj = input;
+    for (const key of ['path', 'file_path', 'filePath']) {
+        const v = obj[key];
+        if (typeof v === 'string')
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Heuristic: does the given shell command write to the filesystem?
+ *
+ * Gap 11 fix (4.0.3+): the polling headline tracks file writes by tool
+ * name (writeFile/write_file/edit_file). Workers that bypass these and
+ * write via run_shell (cat >, sed -i, tee, etc.) used to show "0 write"
+ * for the entire run despite actively producing artifacts. This
+ * heuristic looks for common write patterns in the command string;
+ * false positives are acceptable (operator gets a slightly noisy count)
+ * but false negatives are not (the headline lies about progress).
+ *
+ * Patterns detected:
+ *   - Output redirects: `> file`, `>> file`, `&> file`, `>| file`
+ *   - Heredoc to file: `<<EOF > file`, `cat <<...> file`
+ *   - `sed -i` / `sed -i ''` (in-place edit)
+ *   - `awk -i inplace` / `gawk -i inplace`
+ *   - `tee file`, `tee -a file`
+ *   - `cp/mv/touch/install` (file creation/moves)
+ *   - `mkdir`, `rm`, `chmod`, `chown` (filesystem mutation)
+ *   - `git checkout/reset/restore/pull/merge` (modifies files)
+ *   - `python/node -c '... open(... "w") ...'` is NOT detected — too
+ *     ambiguous; keeps false-positive rate low.
+ */
+const SHELL_WRITE_PATTERNS = [
+    /[^&|>]>>?\s*[^&|>\s]/, // > file or >> file (excluding 2>&1, &> handled below)
+    /&>\s*[^&|>\s]/, // &> file
+    />\|\s*[^&|>\s]/, // >| file
+    /\bsed\s+(?:-[a-z]*i[a-z]*\b|--in-place\b)/i, // sed -i / sed --in-place
+    /\b(?:awk|gawk|nawk)\s+-i\s+inplace\b/i,
+    /\btee\b/,
+    /\b(?:cp|mv|touch|install|ln)\s+/,
+    /\bmkdir\s+/,
+    /\brm\s+/,
+    /\bchmod\s+/,
+    /\bchown\s+/,
+    /\bgit\s+(?:checkout|reset|restore|pull|merge|clean|stash|cherry-pick|rebase|apply)\b/,
+    /\bnpm\s+(?:install|i|ci|uninstall|update|run\s+build|run\s+test)\b/,
+    /\bpnpm\s+(?:install|add|remove|update|run)\b/,
+    /\byarn\s+(?:install|add|remove|upgrade)\b/,
+];
+export function shellCommandWritesFs(command) {
+    if (!command || command.length === 0)
+        return false;
+    for (const pattern of SHELL_WRITE_PATTERNS) {
+        if (pattern.test(command))
+            return true;
+    }
+    return false;
+}
+function extractShellCommand(input) {
+    if (typeof input !== 'object' || input === null)
+        return undefined;
+    const obj = input;
+    for (const key of ['command', 'cmd', 'shell']) {
+        const v = obj[key];
+        if (typeof v === 'string')
+            return v;
+        if (Array.isArray(v))
+            return v.join(' ');
+    }
+    return undefined;
+}
 export class RunnerShell {
     adapter;
-    constructor(adapter) {
+    defaultModel;
+    constructor(adapter, 
+    /** Default model id used for cost computation when input.model is absent.
+     *  Reviewer/annotator engines call shell.run() without setting input.model,
+     *  so without this default every reviewer-side stage would record costUSD=null. */
+    defaultModel) {
         this.adapter = adapter;
+        this.defaultModel = defaultModel;
     }
     async run(input) {
+        const startMs = Date.now();
+        const modelForCost = input.model ?? this.defaultModel;
         const ctx = { cwd: input.cwd, callCache: new Map() };
         const usage = { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 };
         const allToolCalls = [];
+        const filesRead = [];
+        const filesWritten = [];
+        let turns = 0;
         const history = [];
         let finalText = '';
         let stoppedByAdapter = false;
+        // Common fields stamped on every emitted bus event so VerboseLogChannel
+        // surfaces enough context for an operator to see which run a line belongs
+        // to without grepping back to the originating request.
+        const baseEventFields = {
+            ...(input.batchId !== undefined && { batchId: input.batchId }),
+            ...(input.taskIndex !== undefined && { taskIndex: input.taskIndex }),
+            ...(input.tier !== undefined && { tier: input.tier }),
+            ...(input.model !== undefined && { model: input.model }),
+            ...(input.stageLabel !== undefined && { stageLabel: input.stageLabel }),
+            providerType: this.adapter.providerType,
+        };
         for (let turn = 0; turn < input.maxTurns; turn++) {
             if (input.abortSignal?.aborted) {
                 return {
@@ -21,8 +126,28 @@ export class RunnerShell {
                     toolCalls: allToolCalls,
                     usage,
                     errorCode: 'aborted',
+                    turns,
+                    durationMs: Date.now() - startMs,
+                    filesRead,
+                    filesWritten,
+                    costUSD: computeCost(modelForCost, usage),
                 };
             }
+            // Three-event-per-turn lifecycle so verbose stderr surfaces every
+            // state change. `runner_turn_started` fires before the LLM call so
+            // operators see "now waiting on the model" in real time. After the
+            // adapter returns, `runner_response_received` carries the raw
+            // provider response shape (stop_reason + content-block tally). After
+            // local tool execution, `runner_turn_completed` carries per-tool
+            // counts (read vs write etc.) so operators can see what work the
+            // model is doing without grepping the JSONL log.
+            input.bus?.emit({
+                event: 'runner_turn_started',
+                ts: new Date().toISOString(),
+                ...baseEventFields,
+                turnIndex: turn,
+            });
+            turns++;
             const turnResult = await this.adapter.turn({
                 systemPrompt: input.systemPrompt,
                 userMessage: input.userMessage,
@@ -37,34 +162,131 @@ export class RunnerShell {
             usage.cachedReadTokens += turnResult.usage.cachedReadTokens;
             usage.cachedNonReadTokens += turnResult.usage.cachedNonReadTokens;
             finalText = turnResult.assistantText;
+            input.bus?.emit({
+                event: 'runner_response_received',
+                ts: new Date().toISOString(),
+                ...baseEventFields,
+                turnIndex: turn,
+                finishReason: turnResult.finishReason,
+                assistantTextLen: turnResult.assistantText.length,
+                toolCallCount: turnResult.toolCalls.length,
+                ...(turnResult.responseShape?.stopReason !== undefined && { stopReason: turnResult.responseShape.stopReason }),
+                ...(turnResult.responseShape?.contentBlocks !== undefined && { contentBlocks: turnResult.responseShape.contentBlocks }),
+                usage: turnResult.usage,
+            });
             const turnRecord = {
                 assistantText: turnResult.assistantText,
                 toolCalls: [],
             };
-            if (turnResult.toolCalls.length === 0) {
+            const willTerminate = turnResult.toolCalls.length === 0;
+            if (willTerminate) {
                 history.push(turnRecord);
                 stoppedByAdapter = true;
-                break;
             }
-            for (const call of turnResult.toolCalls) {
-                const def = input.toolDefinitions.find(d => d.name === call.name);
-                let result;
-                if (!def) {
-                    result = { error: `unknown tool: ${call.name}` };
-                }
-                else {
-                    try {
-                        result = await def.execute(call.input, ctx);
+            else {
+                for (const call of turnResult.toolCalls) {
+                    const def = input.toolDefinitions.find(d => d.name === call.name);
+                    let result;
+                    if (!def) {
+                        result = { error: `unknown tool: ${call.name}` };
+                    }
+                    else {
+                        try {
+                            result = await def.execute(call.input, ctx);
+                        }
+                        catch (err) {
+                            result = { error: `tool execution failed: ${err instanceof Error ? err.message : String(err)}` };
+                        }
                     }
-                    catch (err) {
-                        result = { error: `tool execution failed: ${err instanceof Error ? err.message : String(err)}` };
+                    const enriched = { name: call.name, input: call.input, result };
+                    allToolCalls.push(enriched);
+                    turnRecord.toolCalls.push(enriched);
+                    // Track file ops so the wire telemetry's filesReadCount /
+                    // filesWrittenCount aren't perpetually 0. Only count successful
+                    // calls (a tool that threw produced { error: ... } as result).
+                    const succeeded = !(typeof result === 'object' && result !== null && 'error' in result);
+                    if (succeeded) {
+                        const path = extractPathFromToolInput(call.input);
+                        if (READ_TOOL_NAMES.has(call.name) && path)
+                            filesRead.push(path);
+                        else if (WRITE_TOOL_NAMES.has(call.name) && path)
+                            filesWritten.push(path);
+                        else if (SHELL_TOOL_NAMES.has(call.name)) {
+                            // Gap 11 fix (4.0.3+): workers writing via run_shell
+                            // (cat >, sed -i, tee, etc.) used to show "0 write" in
+                            // polling for the entire run despite actively producing
+                            // artifacts. Detect common write patterns in the command
+                            // arg and attribute as a synthetic write entry tagged
+                            // `shell:` so callers can distinguish it from explicit
+                            // write_file calls. False positives acceptable; false
+                            // negatives are not — the headline must reflect reality.
+                            const command = extractShellCommand(call.input);
+                            if (command && shellCommandWritesFs(command)) {
+                                filesWritten.push(`shell:${command.slice(0, 80)}`);
+                            }
+                        }
                     }
                 }
-                const enriched = { name: call.name, input: call.input, result };
-                allToolCalls.push(enriched);
-                turnRecord.toolCalls.push(enriched);
+                history.push(turnRecord);
+            }
+            // Per-tool counts for THIS turn so operators see "5 readFile, 1 grep"
+            // instead of the bare "tool_call_count=6". The user can immediately
+            // tell read vs write activity without inspecting the JSONL log.
+            const toolCallsByName = {};
+            // Gap 11 (4.0.3+): also count shell calls that wrote to the
+            // filesystem so the headline reflects worker-produced artifacts
+            // even when the worker bypassed write_file/edit_file.
+            let shellWritesThisTurn = 0;
+            for (const tc of turnResult.toolCalls) {
+                toolCallsByName[tc.name] = (toolCallsByName[tc.name] ?? 0) + 1;
+                if (SHELL_TOOL_NAMES.has(tc.name)) {
+                    const cmd = extractShellCommand(tc.input);
+                    if (cmd && shellCommandWritesFs(cmd))
+                        shellWritesThisTurn += 1;
+                }
             }
-            history.push(turnRecord);
+            input.bus?.emit({
+                event: 'runner_turn_completed',
+                ts: new Date().toISOString(),
+                ...baseEventFields,
+                turnIndex: turn,
+                terminated: willTerminate,
+                toolCallCount: turnResult.toolCalls.length,
+                ...(turnResult.toolCalls.length > 0 && { toolCalls: toolCallsByName }),
+                ...(shellWritesThisTurn > 0 && { shellWrites: shellWritesThisTurn }),
+            });
+            if (willTerminate)
+                break;
+        }
+        // Empty-output regression guard (4.0.3). The 4.0.x runner-shell
+        // unconditionally reported `workerStatus: 'done'` whenever the adapter
+        // returned no tool calls — even when assistantText was empty. Combined
+        // with the anthropic-messages adapter's text-only extraction, a
+        // reasoning model that emitted thinking blocks with no text block (or
+        // any provider that returned end_turn with empty content) silently
+        // produced an "ok" RunResult carrying `output: ''`. The reviewer
+        // engine then approved that empty output and the audit/delegate
+        // looked successful while emitting nothing useful.
+        //
+        // 3.12.7's claude-agent-sdk owned the agent loop and didn't have this
+        // failure mode. This branch restores the missing check: stopping with
+        // empty narrative AND no tool calls is `incomplete`, surfaced as a
+        // structured error with errorCode `empty_output` so callers can tell
+        // the difference between "model finished cleanly" and "model returned
+        // nothing usable".
+        if (stoppedByAdapter && finalText.trim() === '' && allToolCalls.length === 0) {
+            return {
+                workerStatus: 'failed',
+                finalAssistantText: '',
+                toolCalls: allToolCalls,
+                usage,
+                errorCode: 'empty_output',
+                turns,
+                durationMs: Date.now() - startMs,
+                filesRead,
+                filesWritten,
+                costUSD: computeCost(modelForCost, usage),
+            };
         }
         return {
             workerStatus: stoppedByAdapter ? 'done' : 'blocked',
@@ -72,7 +294,18 @@ export class RunnerShell {
             toolCalls: allToolCalls,
             usage,
             ...(stoppedByAdapter ? {} : { errorCode: 'max_turns_exhausted' }),
+            turns,
+            durationMs: Date.now() - startMs,
+            filesRead,
+            filesWritten,
+            costUSD: computeCost(modelForCost, usage),
         };
     }
 }
+function computeCost(model, usage) {
+    const card = resolveRateCard(model ?? null);
+    if (!card)
+        return null;
+    return priceTokens(usage, card);
+}
 //# sourceMappingURL=runner-shell.js.map

package/dist/providers/runner-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner-shell.js","sourceRoot":"","sources":["../../src/providers/runner-shell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner-shell.js","sourceRoot":"","sources":["../../src/providers/runner-shell.ts"],"names":[],"mappings":"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"}

package/dist/providers/runner-types.d.ts

@@ -1,6 +1,7 @@
 import type { ContextBlockStore } from '../stores/context-block-tool.js';
 import type { AgentType, Effort, FormatConstraints, SandboxPolicy, TaskSpec, ToolMode } from '../types.js';
 import type { ResearchToolDefinition } from '../research/types.js';
+import type { EventEmitter } from '../events/event-emitter.js';
 export type RunStatus = 'ok' | 'incomplete' | 'timeout' | 'api_aborted' | 'api_error' | 'provider_transport_failure' | 'error' | 'brief_too_vague' | 'cost_exceeded' | 'unavailable';
 /** Canonical 4-field token-count shape. reasoningTokens are summed into
  *  outputTokens by each runner before emitting. totalTokens, cachedTokens,
@@ -16,7 +17,7 @@ export interface TokenUsage {
 export interface CostBreakdown {
     costUSD: number | null;
     /** Actual cost minus estimated parent cost. Negative = worker cheaper (savings). */
-    costDeltaVsParentUSD: number | null;
+    costDeltaVsMainUSD: number | null;
 }
 export interface TerminationReason {
     /** Why the task stopped. 'finished' means the worker returned normally — check
@@ -92,6 +93,24 @@ export interface RunOptions {
     cacheHints?: {
         cacheableSystemPrompt?: boolean;
     };
+    /** Bus for emitting per-turn / per-runner-call observability events. When
+     *  present, the runner-shell + adapter emit `runner_turn_started`,
+     *  `runner_turn_completed`, and `runner_response_received` events that the
+     *  server's VerboseLogChannel + LocalLogSink + TelemetrySink consume. */
+    bus?: EventEmitter;
+    /** Identifies the in-flight batch in emitted runner events. Plumbed
+     *  through delegateWithEscalation so consumers can correlate runner-shell
+     *  output back to the originating /audit, /delegate, etc. request. */
+    batchId?: string;
+    /** Identifies which task within a batch is running. Threaded through every
+     *  emitted event so per-task running-headline progress can be tracked when
+     *  a batch has multiple parallel tasks. */
+    taskIndex?: number;
+    /** Tier label (`'standard'` | `'complex'`) included in emitted events. */
+    tier?: string;
+    /** Lifecycle stage label (e.g. `'Implementing'`, `'Spec review'`). Forwarded
+     *  to the runner-shell so its emitted events carry the current stage. */
+    stageLabel?: string;
 }
 /** Runtime dependencies for `runTasks`. */
 export interface RunTasksRuntime {
@@ -163,7 +182,7 @@ export type ProgressEvent = {
         toolCalls: number;
     };
     costUSD: number | null;
-    costDeltaVsParentUSD: number | null;
+    costDeltaVsMainUSD: number | null;
     final: boolean;
     headline: string;
     /** Per-stage idle time (ms since last LLM/tool/text event in the current stage). */

package/dist/providers/runner-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner-types.d.ts","sourceRoot":"","sources":["../../src/providers/runner-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner-types.d.ts","sourceRoot":"","sources":["../../src/providers/runner-types.ts"],"names":[],"mappings":"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"}

package/dist/providers/tool-name-sets.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Single source of truth for tool-name → category sets.
+ *
+ * Two consumers historically maintained their own copies and drifted:
+ *   - `runner-shell.ts` tracks `filesRead` / `filesWritten` arrays based
+ *     on tool name → these flow into wire telemetry's
+ *     `filesReadCount` / `filesWrittenCount`.
+ *   - `running-headline-sink.ts` increments the polling headline's
+ *     `read` / `write` counts from per-turn `toolCalls` records.
+ *
+ * Pre-4.0.3 the sink had `WRITE_TOOLS = {writeFile, write_file}` while
+ * the runner had `WRITE_TOOL_NAMES = {writeFile, write_file, editFile,
+ * edit_file}`. A worker calling `edit_file` correctly bumped the
+ * runner's counter (so `filesWrittenCount` was right on the wire) but
+ * the polling headline reported "0 write" — drift. This module
+ * eliminates that risk: both consumers import from here.
+ */
+/** File-reading tools. Includes search/grep tools because they READ
+ *  file content even though they don't return whole files — the wire
+ *  attribution treats them uniformly as "read activity". */
+export declare const READ_TOOL_NAMES: ReadonlySet<string>;
+/** File-writing tools. Both `writeFile` (full overwrite) and
+ *  `editFile` (patch) modify the filesystem and count as writes. */
+export declare const WRITE_TOOL_NAMES: ReadonlySet<string>;
+/** Shell tools. Uncategorized for read/write attribution by name —
+ *  the runner-shell inspects the command argument via
+ *  `shellCommandWritesFs` (Gap 11) to attribute writes heuristically. */
+export declare const SHELL_TOOL_NAMES: ReadonlySet<string>;
+//# sourceMappingURL=tool-name-sets.d.ts.map

package/dist/providers/tool-name-sets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-sets.d.ts","sourceRoot":"","sources":["../../src/providers/tool-name-sets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;4DAE4D;AAC5D,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAK9C,CAAC;AAEH;oEACoE;AACpE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAG/C,CAAC;AAEH;;yEAEyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAI/C,CAAC"}

package/dist/providers/tool-name-sets.js

@@ -0,0 +1,41 @@
+/**
+ * Single source of truth for tool-name → category sets.
+ *
+ * Two consumers historically maintained their own copies and drifted:
+ *   - `runner-shell.ts` tracks `filesRead` / `filesWritten` arrays based
+ *     on tool name → these flow into wire telemetry's
+ *     `filesReadCount` / `filesWrittenCount`.
+ *   - `running-headline-sink.ts` increments the polling headline's
+ *     `read` / `write` counts from per-turn `toolCalls` records.
+ *
+ * Pre-4.0.3 the sink had `WRITE_TOOLS = {writeFile, write_file}` while
+ * the runner had `WRITE_TOOL_NAMES = {writeFile, write_file, editFile,
+ * edit_file}`. A worker calling `edit_file` correctly bumped the
+ * runner's counter (so `filesWrittenCount` was right on the wire) but
+ * the polling headline reported "0 write" — drift. This module
+ * eliminates that risk: both consumers import from here.
+ */
+/** File-reading tools. Includes search/grep tools because they READ
+ *  file content even though they don't return whole files — the wire
+ *  attribution treats them uniformly as "read activity". */
+export const READ_TOOL_NAMES = new Set([
+    'readFile', 'read_file',
+    'grep',
+    'glob',
+    'listFiles', 'list_files',
+]);
+/** File-writing tools. Both `writeFile` (full overwrite) and
+ *  `editFile` (patch) modify the filesystem and count as writes. */
+export const WRITE_TOOL_NAMES = new Set([
+    'writeFile', 'write_file',
+    'editFile', 'edit_file',
+]);
+/** Shell tools. Uncategorized for read/write attribution by name —
+ *  the runner-shell inspects the command argument via
+ *  `shellCommandWritesFs` (Gap 11) to attribute writes heuristically. */
+export const SHELL_TOOL_NAMES = new Set([
+    'runShell', 'run_shell',
+    'shell',
+    'bash',
+]);
+//# sourceMappingURL=tool-name-sets.js.map

package/dist/providers/tool-name-sets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-sets.js","sourceRoot":"","sources":["../../src/providers/tool-name-sets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;4DAE4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IAC1D,UAAU,EAAE,WAAW;IACvB,MAAM;IACN,MAAM;IACN,WAAW,EAAE,YAAY;CAC1B,CAAC,CAAC;AAEH;oEACoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,WAAW;CACxB,CAAC,CAAC;AAEH;;yEAEyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,UAAU,EAAE,WAAW;IACvB,OAAO;IACP,MAAM;CACP,CAAC,CAAC"}

package/dist/reporting/headline-composer.d.ts

@@ -1,8 +1,18 @@
+import type { RunResult, TaskSpec } from '../types.js';
+/**
+ * 4.0.3+: signature accepts optional `runResult` and `task` so composers
+ * can read fields the structured `report` doesn't carry (e.g.,
+ * `annotatedFindings` from runResult, `filePaths` from task).
+ * Backwards-compatible at runtime — composers that ignore both keep
+ * working.
+ */
 export interface HeadlineTemplate {
     compose(input: {
         taskBrief: string;
         report: unknown;
         status: string;
+        runResult?: RunResult;
+        task?: TaskSpec;
     }): string;
 }
 export declare class HeadlineComposer {
@@ -12,6 +22,8 @@ export declare class HeadlineComposer {
         taskBrief: string;
         report: unknown;
         status: string;
+        runResult?: RunResult;
+        task?: TaskSpec;
     }): string;
 }
 //# sourceMappingURL=headline-composer.d.ts.map

package/dist/reporting/headline-composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headline-composer.d.ts","sourceRoot":"","sources":["../../src/reporting/headline-composer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CAChF;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C,OAAO,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAG/E"}
+{"version":3,"file":"headline-composer.d.ts","sourceRoot":"","sources":["../../src/reporting/headline-composer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,KAAK,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,QAAQ,CAAC;KACjB,GAAG,MAAM,CAAC;CACZ;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C,OAAO,CAAC,KAAK,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,QAAQ,CAAC;KACjB,GAAG,MAAM;CAGX"}

package/dist/reporting/headline-composer.js.map

@@ -1 +1 @@
-{"version":3,"file":"headline-composer.js","sourceRoot":"","sources":["../../src/reporting/headline-composer.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAElD,OAAO,CAAC,KAA6D;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"headline-composer.js","sourceRoot":"","sources":["../../src/reporting/headline-composer.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAElD,OAAO,CAAC,KAMP;QACC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/reporting/headline-templates/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/reporting/headline-templates/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,eAAO,MAAM,qBAAqB,EAAE,gBAQnC,CAAC"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/reporting/headline-templates/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,eAAO,MAAM,qBAAqB,EAAE,gBA2CnC,CAAC"}

package/dist/reporting/headline-templates/audit.js

@@ -1,12 +1,41 @@
 import { isNotApplicable } from '../not-applicable.js';
+import { countHighOrCritical, parseNarrativeFindings } from '../severity.js';
 export const auditHeadlineTemplate = {
-    compose({ report, status }) {
-        if (!report || isNotApplicable(report))
-            return `[${status}] audit completed`;
+    compose({ report, status, runResult, task }) {
         const r = report;
-        const findings = Array.isArray(r.findings) ? r.findings : [];
-        const high = findings.filter(f => f?.severity === 'high').length;
-        return `[${status}] audit ${r.documentPath ?? ''}: ${findings.length} findings (${high} high)`;
+        const reportInapplicable = !r || isNotApplicable(r);
+        // Source priority for findings (4.0.3+):
+        //   1. Structured report's `findings` (rare — only when the worker
+        //      emitted proper JSON matching the audit reportSchema).
+        //   2. runResult.annotatedFindings (canonical narrative-path source
+        //      populated by the quality-chain handler when verdict='annotated').
+        //   3. NEW: parseNarrativeFindings(runResult.output) — recovers
+        //      findings directly from the implementer's `## Finding N:`
+        //      output when the annotator errored (parse failure, exhaustion).
+        //      Without this third fallback, audits where the annotator
+        //      failed report `0 findings (0 high)` even though the
+        //      implementer's narrative carried valid findings.
+        const reportFindings = !reportInapplicable && Array.isArray(r?.findings) ? r.findings : [];
+        const annotated = runResult?.annotatedFindings ?? [];
+        let findings = reportFindings.length > 0
+            ? reportFindings
+            : annotated;
+        if (findings.length === 0 && typeof runResult?.output === 'string') {
+            const narrative = parseNarrativeFindings(runResult.output);
+            if (narrative.length > 0)
+                findings = narrative;
+        }
+        if (findings.length === 0 && reportInapplicable) {
+            return `[${status}] audit completed`;
+        }
+        const high = countHighOrCritical(findings);
+        // Document path fallback (per round-2 audit F3): when we fall back
+        // to annotatedFindings, the structured report's documentPath is
+        // absent. Pull from the task's filePaths instead.
+        const path = (!reportInapplicable && typeof r?.documentPath === 'string' ? r.documentPath : '')
+            || task?.filePaths?.[0]
+            || '';
+        return `[${status}] audit ${path}: ${findings.length} findings (${high} high)`;
     },
 };
 //# sourceMappingURL=audit.js.map

package/dist/reporting/headline-templates/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/reporting/headline-templates/audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;QACxB,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,MAAM,mBAAmB,CAAC;QAC7E,MAAM,CAAC,GAAG,MAAqB,CAAC;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QACjE,OAAO,IAAI,MAAM,WAAW,CAAC,CAAC,YAAY,IAAI,EAAE,KAAK,QAAQ,CAAC,MAAM,cAAc,IAAI,QAAQ,CAAC;IACjG,CAAC;CACF,CAAC"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/reporting/headline-templates/audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE;QACzC,MAAM,CAAC,GAAG,MAAiD,CAAC;QAC5D,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;QAEpD,yCAAyC;QACzC,mEAAmE;QACnE,6DAA6D;QAC7D,oEAAoE;QACpE,yEAAyE;QACzE,gEAAgE;QAChE,gEAAgE;QAChE,sEAAsE;QACtE,+DAA+D;QAC/D,2DAA2D;QAC3D,uDAAuD;QACvD,MAAM,cAAc,GAAG,CAAC,kBAAkB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,SAAS,GAAG,SAAS,EAAE,iBAAiB,IAAI,EAAE,CAAC;QACrD,IAAI,QAAQ,GACV,cAAc,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAE,cAAgD;YACnD,CAAC,CAAE,SAA2C,CAAC;QACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,SAAS,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;YACnE,MAAM,SAAS,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,GAAG,SAAS,CAAC;QACjD,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,EAAE,CAAC;YAChD,OAAO,IAAI,MAAM,mBAAmB,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE3C,mEAAmE;QACnE,gEAAgE;QAChE,kDAAkD;QAClD,MAAM,IAAI,GACR,CAAC,CAAC,kBAAkB,IAAI,OAAO,CAAC,EAAE,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;eAC/E,IAA6C,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;eAC9D,EAAE,CAAC;QAER,OAAO,IAAI,MAAM,WAAW,IAAI,KAAK,QAAQ,CAAC,MAAM,cAAc,IAAI,QAAQ,CAAC;IACjF,CAAC;CACF,CAAC"}

package/dist/reporting/headline-templates/debug.d.ts

@@ -1,8 +1,27 @@
 import type { HeadlineTemplate } from '../headline-composer.js';
 /**
- * Compose a terminal headline for debug. Matches the composeTerminalHeadline
- * format that the legacy executor produced: "debug: 1/1 tasks complete".
- * Debug always dispatches exactly 1 task.
+ * Compose a terminal headline for debug.
+ *
+ * Tool sweep #4 rewrite: bring debug into the same shape as audit and
+ * review/verify so operator-facing logs stay consistent across tools:
+ *
+ *     [ok]    debug <path>: 3 findings (0 high)
+ *     [error] debug: 1 findings (1 high)
+ *     [ok]    debug completed
+ *
+ * Previously emitted "debug: 1/1 tasks complete" with no status prefix
+ * and no findings count — operator could not tell ok from error and
+ * had no signal about how many real findings landed.
+ *
+ * Source priority for findings (parallel to audit):
+ *   1. runResult.annotatedFindings (canonical — annotator's structured
+ *      output when verdict='annotated').
+ *   2. parseNarrativeFindings(runResult.output) — recovers `## Finding N:`
+ *      blocks from the implementer's narrative when the annotator errored.
+ *
+ * Note: debug's reportSchema.parse is intentionally a thrower (the tool
+ * doesn't emit a structured report), so `report` is always notApplicable
+ * here — there's no `report.findings` source to read.
  */
 export declare const debugHeadlineTemplate: HeadlineTemplate;
 //# sourceMappingURL=debug.d.ts.map