@llm-dev-ops/agentics-cli 2.7.26 → 2.7.28

package/dist/cli/ui/heartbeat.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ADR-PIPELINE-099 D3 + D4 — Process-wide pipeline heartbeat.
+ *
+ * Singleton that emits a continuous "still alive" signal for the entire
+ * `agentics ask` lifecycle, not just Phase 1. Replaces the per-call heartbeat
+ * inside `executeNaturalLanguageRoute` which died as soon as auto-chain
+ * took over Phases 2–7, leaving the user staring at a silent terminal for
+ * minutes at a stretch.
+ *
+ * Two render modes:
+ *
+ *  - **TTY** (`stderr.isTTY` and not opted out): a single status line is
+ *    repainted in place every 250ms at the cursor position using a four-frame
+ *    spinner (`◐ ◓ ◑ ◒`). The line shows the current phase, total elapsed
+ *    time, time-since-phase-entry, and the most recent activity hint set by
+ *    the pipeline. Other writers (`console.error`, `process.stderr.write`)
+ *    print above the status line via cursor save/restore.
+ *
+ *  - **Non-TTY** (CI, piped output, `AGENTICS_NO_HEARTBEAT=1`): the spinner
+ *    is suppressed; instead a plain `[agentics] ⏳ still working — Phase X
+ *    (MM:SS) — <activity>` line prints every 10 seconds, throttled to skip
+ *    any tick that happened within 9s of another stderr write.
+ *
+ * The singleton is crash-safe: `process.on('exit' | 'SIGINT' | 'SIGTERM')`
+ * handlers call `stop()` to clear the live status line so it doesn't leave a
+ * stale frame on the user's terminal after Ctrl-C.
+ *
+ * Usage:
+ *   ```ts
+ *   import { pipelineHeartbeat } from './cli/ui/heartbeat.js';
+ *   pipelineHeartbeat.start('agentics ask');
+ *   pipelineHeartbeat.setPhase('Phase 4 — ADRs + DDDs');
+ *   pipelineHeartbeat.setActivity('ruflo: writing adr-007');
+ *   // ... long-running work ...
+ *   pipelineHeartbeat.stop();
+ *   ```
+ */
+declare class PipelineHeartbeat {
+    private readonly started;
+    private phase;
+    private phaseStartedAt;
+    private activity;
+    private timer;
+    private mode;
+    private lastStderrWriteAt;
+    private exitHandlersInstalled;
+    /**
+     * Begin emitting heartbeat ticks. Idempotent — repeated `start()` calls
+     * with a different label update the label but do not restart the timer.
+     *
+     * Always uses plain-line mode (no stderr interception, no in-place
+     * cursor manipulation). The previous TTY-with-interceptor design risked
+     * swallowing other writers' output when the wrapped function chain
+     * misbehaved (observed in 2.7.27 — the user saw NO output for 6 min
+     * because the interceptor ate every console.error). Plain-line mode
+     * interleaves with other logs but is provably safe.
+     */
+    start(_label: string): void;
+    /**
+     * Update the current phase label. Emits an immediate `[agentics] ▶ <phase>`
+     * line to stderr so the user sees the boundary even before the next 10s
+     * tick. Resets the per-phase timer.
+     */
+    setPhase(phase: string): void;
+    /**
+     * Update the latest activity hint. Stored for the next 10s tick to print
+     * if no other writer beat it. Does NOT print on its own — that's what
+     * caused 2.7.27's silence.
+     */
+    setActivity(activity: string): void;
+    /** Stop the timer. */
+    stop(): void;
+    private tickPlain;
+    private installExitHandlers;
+}
+/** Process-wide singleton. */
+export declare const pipelineHeartbeat: PipelineHeartbeat;
+/**
+ * Bracket a phase with `[BEGIN]` / `[END]` log markers and update the
+ * heartbeat's phase label. Call at the top of each phase in auto-chain.
+ *
+ * Returns a `done()` closure that emits the matching `[END]` line when the
+ * phase finishes. Always pair `phaseBoundary` with its returned `done` to
+ * keep the trace greppable.
+ */
+export declare function phaseBoundary(phaseLabel: string, totalElapsedFromStart: number): () => void;
+export {};
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/cli/ui/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAYH,cAAM,iBAAiB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY7B;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAUZ,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,mBAAmB;CAQ5B;AAED,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,MAAM,IAAI,CAkB3F"}

package/dist/cli/ui/heartbeat.js

@@ -0,0 +1,158 @@
+/**
+ * ADR-PIPELINE-099 D3 + D4 — Process-wide pipeline heartbeat.
+ *
+ * Singleton that emits a continuous "still alive" signal for the entire
+ * `agentics ask` lifecycle, not just Phase 1. Replaces the per-call heartbeat
+ * inside `executeNaturalLanguageRoute` which died as soon as auto-chain
+ * took over Phases 2–7, leaving the user staring at a silent terminal for
+ * minutes at a stretch.
+ *
+ * Two render modes:
+ *
+ *  - **TTY** (`stderr.isTTY` and not opted out): a single status line is
+ *    repainted in place every 250ms at the cursor position using a four-frame
+ *    spinner (`◐ ◓ ◑ ◒`). The line shows the current phase, total elapsed
+ *    time, time-since-phase-entry, and the most recent activity hint set by
+ *    the pipeline. Other writers (`console.error`, `process.stderr.write`)
+ *    print above the status line via cursor save/restore.
+ *
+ *  - **Non-TTY** (CI, piped output, `AGENTICS_NO_HEARTBEAT=1`): the spinner
+ *    is suppressed; instead a plain `[agentics] ⏳ still working — Phase X
+ *    (MM:SS) — <activity>` line prints every 10 seconds, throttled to skip
+ *    any tick that happened within 9s of another stderr write.
+ *
+ * The singleton is crash-safe: `process.on('exit' | 'SIGINT' | 'SIGTERM')`
+ * handlers call `stop()` to clear the live status line so it doesn't leave a
+ * stale frame on the user's terminal after Ctrl-C.
+ *
+ * Usage:
+ *   ```ts
+ *   import { pipelineHeartbeat } from './cli/ui/heartbeat.js';
+ *   pipelineHeartbeat.start('agentics ask');
+ *   pipelineHeartbeat.setPhase('Phase 4 — ADRs + DDDs');
+ *   pipelineHeartbeat.setActivity('ruflo: writing adr-007');
+ *   // ... long-running work ...
+ *   pipelineHeartbeat.stop();
+ *   ```
+ */
+const PLAIN_TICK_MS = 10_000;
+const PLAIN_QUIET_THRESHOLD_MS = 9_000;
+function fmtElapsed(ms) {
+    const totalSec = Math.floor(ms / 1000);
+    const m = Math.floor(totalSec / 60);
+    const s = totalSec % 60;
+    return `${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
+}
+class PipelineHeartbeat {
+    started = Date.now();
+    phase = 'starting';
+    phaseStartedAt = Date.now();
+    activity = '';
+    timer = null;
+    mode = 'off';
+    lastStderrWriteAt = Date.now();
+    exitHandlersInstalled = false;
+    /**
+     * Begin emitting heartbeat ticks. Idempotent — repeated `start()` calls
+     * with a different label update the label but do not restart the timer.
+     *
+     * Always uses plain-line mode (no stderr interception, no in-place
+     * cursor manipulation). The previous TTY-with-interceptor design risked
+     * swallowing other writers' output when the wrapped function chain
+     * misbehaved (observed in 2.7.27 — the user saw NO output for 6 min
+     * because the interceptor ate every console.error). Plain-line mode
+     * interleaves with other logs but is provably safe.
+     */
+    start(_label) {
+        if (this.timer)
+            return;
+        if (process.env['AGENTICS_HEARTBEAT_OFF'] === '1')
+            return;
+        this.mode = 'plain';
+        this.installExitHandlers();
+        this.timer = setInterval(() => this.tickPlain(), PLAIN_TICK_MS);
+        this.timer.unref();
+    }
+    /**
+     * Update the current phase label. Emits an immediate `[agentics] ▶ <phase>`
+     * line to stderr so the user sees the boundary even before the next 10s
+     * tick. Resets the per-phase timer.
+     */
+    setPhase(phase) {
+        if (this.phase === phase)
+            return;
+        this.phase = phase;
+        this.phaseStartedAt = Date.now();
+        this.activity = '';
+        if (this.mode !== 'off') {
+            const elapsed = fmtElapsed(Date.now() - this.started);
+            process.stderr.write(`[agentics] ▶ ${phase}  ·  T+${elapsed}\n`);
+            this.lastStderrWriteAt = Date.now();
+        }
+    }
+    /**
+     * Update the latest activity hint. Stored for the next 10s tick to print
+     * if no other writer beat it. Does NOT print on its own — that's what
+     * caused 2.7.27's silence.
+     */
+    setActivity(activity) {
+        this.activity = activity;
+    }
+    /** Stop the timer. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.mode = 'off';
+    }
+    // ── Internal ─────────────────────────────────────────────────────────────
+    tickPlain() {
+        if (this.mode === 'off')
+            return;
+        // Skip if some other writer just printed something — the user already
+        // has a fresh signal that we're alive.
+        if (Date.now() - this.lastStderrWriteAt < PLAIN_QUIET_THRESHOLD_MS)
+            return;
+        const elapsed = fmtElapsed(Date.now() - this.started);
+        const phaseSegment = this.phase ? `${this.phase} (${fmtElapsed(Date.now() - this.phaseStartedAt)})` : '';
+        const activitySegment = this.activity ? ` — ${this.activity}` : '';
+        process.stderr.write(`[agentics] ⏳ still working — ${elapsed} — ${phaseSegment}${activitySegment}\n`);
+        this.lastStderrWriteAt = Date.now();
+    }
+    installExitHandlers() {
+        if (this.exitHandlersInstalled)
+            return;
+        this.exitHandlersInstalled = true;
+        const cleanup = () => this.stop();
+        process.on('exit', cleanup);
+        process.on('SIGINT', () => { cleanup(); process.exit(130); });
+        process.on('SIGTERM', () => { cleanup(); process.exit(143); });
+    }
+}
+/** Process-wide singleton. */
+export const pipelineHeartbeat = new PipelineHeartbeat();
+/**
+ * Bracket a phase with `[BEGIN]` / `[END]` log markers and update the
+ * heartbeat's phase label. Call at the top of each phase in auto-chain.
+ *
+ * Returns a `done()` closure that emits the matching `[END]` line when the
+ * phase finishes. Always pair `phaseBoundary` with its returned `done` to
+ * keep the trace greppable.
+ */
+export function phaseBoundary(phaseLabel, totalElapsedFromStart) {
+    const tStart = Date.now();
+    const t = fmtElapsed(totalElapsedFromStart);
+    pipelineHeartbeat.setPhase(phaseLabel);
+    // ANSI bold for the [BEGIN] marker so it stands out in scrollback.
+    process.stderr.write(`\n${'='.repeat(72)}\n` +
+        `  ▶ ${phaseLabel}                 [BEGIN]  T+${t}\n` +
+        `${'='.repeat(72)}\n`);
+    return () => {
+        const dur = fmtElapsed(Date.now() - tStart);
+        process.stderr.write(`${'='.repeat(72)}\n` +
+            `  ▼ ${phaseLabel}   ✓ completed (${dur})  [END]\n` +
+            `${'='.repeat(72)}\n\n`);
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/cli/ui/heartbeat.js.map

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

package/dist/commands/agents.d.ts.map

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

package/dist/commands/agents.js

@@ -17,6 +17,7 @@ import { execFileSync } from 'node:child_process';
 import { isTransientFailure, isTerminalFailure } from '../errors/transient.js';
 import { recordDegradation, drainDegradations } from '../observability/degradations.js';
 import { computePhase1Verdict } from '../pipeline/phase1-verdict.js';
+import { pipelineHeartbeat } from '../cli/ui/heartbeat.js';
 // ============================================================================
 // ADR-066: Copilot agents via claude --print (Claude Max — no API key needed)
 // ============================================================================
@@ -3779,26 +3780,14 @@ export async function executeNaturalLanguageRoute(query, options) {
     // the user sees the route is executing even if subsequent operations
     // (graph load, ruvector simulation, fleet dispatch) take a while.
     process.stderr.write(`[agentics] route entered — query="${query.slice(0, 100)}${query.length > 100 ? '…' : ''}" depth=${options.depth ?? 'lite'} trace=${correlationId.slice(0, 8)}\n`);
-    // Global 10-second heartbeat. Ticks until process exit (`unref()` keeps it
-    // from blocking termination). When any other code emits its own output the
-    // tick still fires but that's acceptable — better noisy than silent. The
-    // heartbeat suppresses itself via `lastOutputAt` if other writes have
-    // happened recently.
-    let lastOutputAt = Date.now();
-    const realStderrWrite = process.stderr.write.bind(process.stderr);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    process.stderr.write = (chunk, ...rest) => {
-        lastOutputAt = Date.now();
-        return realStderrWrite(chunk, ...rest);
-    };
-    const heartbeat = setInterval(() => {
-        if (Date.now() - lastOutputAt < 9_000)
-            return; // something else just wrote
-        const elapsedSec = Math.floor((Date.now() - start) / 1000);
-        realStderrWrite(`[agentics] ⏳ still working — ${elapsedSec}s elapsed\n`);
-        lastOutputAt = Date.now();
-    }, 10_000);
-    heartbeat.unref();
+    // ADR-PIPELINE-099 D3 — process-wide heartbeat. Survives across the
+    // executeNaturalLanguageRoute → executeAutoChain handoff (the previous
+    // per-call heartbeat died at the function boundary, leaving Phases 2–7
+    // silent for minutes at a time). Idempotent — auto-chain calls start()
+    // again with no effect. Stop happens at the end of executeAutoChain or
+    // via the singleton's exit handlers.
+    pipelineHeartbeat.start('agentics ask');
+    pipelineHeartbeat.setPhase('Phase 1 — Fleet Dispatch + Simulation');
     // ========================================================================
     // ADR-030: Capability Graph Routing
     //
@@ -3841,6 +3830,7 @@ export async function executeNaturalLanguageRoute(query, options) {
                 console.error(graphResult.routing.explanation);
                 // Run ruvector simulation first (same as full-fleet path, ADR-016)
                 console.error('  [RUVECTOR] Running simulation before graph-routed dispatch (ADR-016)...');
+                pipelineHeartbeat.setActivity(`ruvector: simulating ${graphResult.routing.totalAgents}-agent graph route`);
                 const simResult = await (async () => {
                     const MAX_RETRIES = 3;
                     let lastErr;
@@ -3879,8 +3869,21 @@ export async function executeNaturalLanguageRoute(query, options) {
                 const REPO_LOCAL_DOMAINS = new Set(['copilot']);
                 const prevLocalAgents = process.env['AGENTICS_LOCAL_AGENTS'];
                 console.error(`  Dispatching ${graphResult.agents.length} graph-routed agents...`);
+                pipelineHeartbeat.setActivity(`fleet: dispatching ${graphResult.agents.length} graph-routed agents`);
                 const agentPromises = [];
-                for (const ref of graphResult.agents) {
+                // ADR-PIPELINE-100 D2 — emit a `[FLEET-CALL]` line as each agent
+                // STARTS and a result line when each FINISHES. The fleet runs in
+                // parallel via Promise.allSettled, so without these lines the user
+                // sees nothing for 1-3 minutes between the dispatch banner and the
+                // aggregate result. Pre-2.7.27 builds had this same silence — it
+                // never went away by itself when the heartbeat singleton was added.
+                const fleetTotal = graphResult.agents.length;
+                let fleetStartedCount = 0;
+                let fleetFinishedCount = 0;
+                graphResult.agents.forEach((ref, idx) => {
+                    const agentStart = Date.now();
+                    fleetStartedCount++;
+                    process.stderr.write(`  [FLEET-CALL] [${String(idx + 1).padStart(3, ' ')}/${fleetTotal}] → ${ref.domain}/${ref.agent}\n`);
                     agentPromises.push((async () => {
                         try {
                             if (!REPO_LOCAL_DOMAINS.has(ref.domain)) {
@@ -3894,12 +3897,25 @@ export async function executeNaturalLanguageRoute(query, options) {
                             }
                             const payload = buildDomainPayload(ref.domain, ref.agent, query, correlationId);
                             const result = await executeAgentsInvokeCommand(ref.domain, ref.agent, payload, options);
-                            return { kind: 'agent', domain: ref.domain, agent: ref.agent, status: result.status ?? 200, response: result.response };
+                            const elapsed = ((Date.now() - agentStart) / 1000).toFixed(1);
+                            fleetFinishedCount++;
+                            const status = result.status ?? 200;
+                            const ok = status >= 200 && status < 300;
+                            process.stderr.write(`  [FLEET-CALL] [${String(idx + 1).padStart(3, ' ')}/${fleetTotal}] ${ok ? '✓' : '✗'} ${ref.domain}/${ref.agent} (${elapsed}s, ${fleetFinishedCount}/${fleetTotal} done)\n`);
+                            pipelineHeartbeat.setActivity(`fleet: ${fleetFinishedCount}/${fleetTotal} agents complete`);
+                            return { kind: 'agent', domain: ref.domain, agent: ref.agent, status, response: result.response };
                         }
                         catch (err) {
+                            fleetFinishedCount++;
+                            const elapsed = ((Date.now() - agentStart) / 1000).toFixed(1);
+                            const errMsg = err instanceof Error ? err.message.slice(0, 80) : String(err).slice(0, 80);
+                            process.stderr.write(`  [FLEET-CALL] [${String(idx + 1).padStart(3, ' ')}/${fleetTotal}] ✗ ${ref.domain}/${ref.agent} (${elapsed}s) — ${errMsg}\n`);
                             return { kind: 'agent', domain: ref.domain, agent: ref.agent, status: 502, response: { error: err instanceof Error ? err.message : String(err) } };
                         }
                     })());
+                });
+                if (fleetStartedCount > 0) {
+                    process.stderr.write(`  [FLEET-CALL] all ${fleetStartedCount} agents in flight — awaiting responses...\n`);
                 }
                 const allResults = await Promise.allSettled([Promise.resolve(simResult), ...agentPromises]);
                 const elapsed = Date.now() - start;
@@ -4189,6 +4205,7 @@ export async function executeNaturalLanguageRoute(query, options) {
             { domain: 'platform', agent: 'risk-score' },
         ];
         console.error(`Dispatching ${fleetAgents.length} agents across ALL 27 domains + ruvector simulation`);
+        pipelineHeartbeat.setActivity(`fleet: dispatching ${fleetAgents.length} agents across 27 domains`);
         // ========================================================================
         // ADR-016: Run ruvector simulation BEFORE fleet dispatch (sequential).
         //
@@ -4201,6 +4218,7 @@ export async function executeNaturalLanguageRoute(query, options) {
         // start the fleet. Adds ~5s latency but guarantees simulation success.
         // ========================================================================
         console.error('  [RUVECTOR] Running simulation before fleet dispatch (ADR-016)...');
+        pipelineHeartbeat.setActivity('ruvector: pre-fleet simulation');
         const simResult = await (async () => {
             const MAX_RETRIES = 3;
             let lastErr;
@@ -4247,12 +4265,24 @@ export async function executeNaturalLanguageRoute(query, options) {
         const WAVE_SIZE = 15;
         const WAVE_DELAY_MS = 2000;
         const agentPromises = [];
+        // ADR-PIPELINE-100 D2 — per-agent visibility for the full-fleet path.
+        // Without these per-call lines the user sees a "Wave N/M" banner then
+        // 1-3 minutes of silence per wave, then nothing until ALL waves
+        // finish. The user explicitly demanded "I should see them being
+        // called" — these are the lines that satisfy that.
+        const fleetTotal = fleetAgents.length;
+        let fleetFinishedCount = 0;
+        let agentDispatchIdx = 0;
         for (let i = 0; i < fleetAgents.length; i += WAVE_SIZE) {
             const wave = fleetAgents.slice(i, i + WAVE_SIZE);
             const waveNum = Math.floor(i / WAVE_SIZE) + 1;
             const totalWaves = Math.ceil(fleetAgents.length / WAVE_SIZE);
-            console.error(`  Wave ${waveNum}/${totalWaves}: ${wave.length} agents (${wave.map(a => `${a.domain}/${a.agent}`).slice(0, 3).join(', ')}${wave.length > 3 ? '...' : ''})`);
+            console.error(`  Wave ${waveNum}/${totalWaves}: dispatching ${wave.length} agents (${wave.map(a => `${a.domain}/${a.agent}`).slice(0, 3).join(', ')}${wave.length > 3 ? '...' : ''})`);
             for (const { domain, agent } of wave) {
+                agentDispatchIdx++;
+                const myIdx = agentDispatchIdx;
+                const agentStart = Date.now();
+                process.stderr.write(`  [FLEET-CALL] [${String(myIdx).padStart(3, ' ')}/${fleetTotal}] → ${domain}/${agent}\n`);
                 agentPromises.push((async () => {
                     try {
                         // Toggle repo-local per-agent: only copilot uses repo-local
@@ -4267,9 +4297,19 @@ export async function executeNaturalLanguageRoute(query, options) {
                         }
                         const payload = buildDomainPayload(domain, agent, query, correlationId);
                         const result = await executeAgentsInvokeCommand(domain, agent, payload, options);
-                        return { kind: 'agent', domain, agent, status: result.status ?? 200, response: result.response };
+                        fleetFinishedCount++;
+                        const elapsed = ((Date.now() - agentStart) / 1000).toFixed(1);
+                        const status = result.status ?? 200;
+                        const ok = status >= 200 && status < 300;
+                        process.stderr.write(`  [FLEET-CALL] [${String(myIdx).padStart(3, ' ')}/${fleetTotal}] ${ok ? '✓' : '✗'} ${domain}/${agent} (${elapsed}s, ${fleetFinishedCount}/${fleetTotal} done)\n`);
+                        pipelineHeartbeat.setActivity(`fleet: ${fleetFinishedCount}/${fleetTotal} agents complete`);
+                        return { kind: 'agent', domain, agent, status, response: result.response };
                     }
                     catch (err) {
+                        fleetFinishedCount++;
+                        const elapsed = ((Date.now() - agentStart) / 1000).toFixed(1);
+                        const errMsg = err instanceof Error ? err.message.slice(0, 80) : String(err).slice(0, 80);
+                        process.stderr.write(`  [FLEET-CALL] [${String(myIdx).padStart(3, ' ')}/${fleetTotal}] ✗ ${domain}/${agent} (${elapsed}s) — ${errMsg}\n`);
                         return { kind: 'agent', domain, agent, status: 502, response: { error: err instanceof Error ? err.message : String(err) } };
                     }
                 })());
@@ -4279,6 +4319,7 @@ export async function executeNaturalLanguageRoute(query, options) {
                 await new Promise(resolve => setTimeout(resolve, WAVE_DELAY_MS));
             }
         }
+        process.stderr.write(`  [FLEET-CALL] all ${fleetTotal} agents in flight — awaiting final responses...\n`);
         const allResults = await Promise.allSettled([Promise.resolve(simResult), ...agentPromises]);
         const elapsed = Date.now() - start;
         // Restore repo-local mode setting