@llm-dev-ops/agentics-cli 2.5.4 → 2.6.0

package/dist/pipeline/phase1-verdict.js

@@ -0,0 +1,186 @@
+/**
+ * ADR-PIPELINE-089 §2 — Phase 1 Health Gate.
+ *
+ * Classifies the outcome of `executeNaturalLanguageRoute` (Phase 1) into
+ * one of three verdicts:
+ *
+ *   - 'failed'   — auto-chain must be skipped; user sees the specific cause.
+ *   - 'degraded' — auto-chain proceeds, but we warn loudly about what is
+ *                  missing so the user can judge the output.
+ *   - 'healthy'  — all inputs intact; auto-chain proceeds silently.
+ *
+ * Inputs:
+ *   - invocations: the per-agent dispatch results (from RouteResult)
+ *   - degradations: the list drained from the degradation sink (tag
+ *                   survival, consensus, sector-classifier, local
+ *                   fallbacks, etc.)
+ *   - artifactFiles: the list of files the artifact generator wrote
+ *
+ * The verdict is computed structurally — no stderr parsing, no global
+ * state. Same inputs always produce the same verdict.
+ */
+import { classifyFailure } from '../errors/transient.js';
+// ============================================================================
+// Classifier
+// ============================================================================
+const DEGRADED_MAX_AGENT_ERROR_RATIO = 0.5; // >50% agent errors → failed
+const HEALTHY_REQUIRES_ZERO_DEGRADATIONS = true;
+/**
+ * Compute the Phase 1 verdict from structural dispatch results plus the
+ * drained degradation list.
+ *
+ * @param invocations Per-agent invocation results (as `multi.result.invocations`)
+ * @param degradations Collected degradation entries for this trace
+ * @param artifactFiles Files the artifact generator produced on disk
+ */
+export function computePhase1Verdict(invocations, degradations, artifactFiles) {
+    const simInvocation = invocations.find(i => i.intent.domain === 'simulator' && i.intent.agent === 'enterprise');
+    const simStatus = classifySimulator(simInvocation);
+    const agentInvocations = invocations.filter(i => !(i.intent.domain === 'simulator' && i.intent.agent === 'enterprise'));
+    const erroredAgents = agentInvocations.filter(i => isErrorResult(i.result)).length;
+    const totalAgents = agentInvocations.length;
+    const succeededAgents = totalAgents - erroredAgents;
+    const agentErrorRatio = totalAgents === 0 ? 0 : erroredAgents / totalAgents;
+    const degSnapshot = degradations.slice();
+    const stats = {
+        totalAgents,
+        succeededAgents,
+        erroredAgents,
+        artifactCount: artifactFiles.length,
+        simulatorStatus: simStatus,
+    };
+    // ── failed cases ────────────────────────────────────────────────────────
+    if (simStatus === 'failed-terminal' || simStatus === 'failed-unknown') {
+        return {
+            verdict: 'failed',
+            degradations: [
+                ...degSnapshot,
+                {
+                    code: 'simulator-terminal',
+                    message: extractErrorMessage(simInvocation?.result) ??
+                        'Enterprise simulation failed with a non-retryable error',
+                    phase: 1,
+                    source: 'simulator/enterprise',
+                },
+            ],
+            reason: `Enterprise simulation failed terminally: ${extractErrorMessage(simInvocation?.result) ?? 'unknown error'}`,
+            stats,
+        };
+    }
+    if (simStatus === 'failed-transient') {
+        // Retry loop already gave up. Treat as failed for gating purposes but
+        // tag the degradation distinctly so the user knows a re-run is likely
+        // to succeed.
+        return {
+            verdict: 'failed',
+            degradations: [
+                ...degSnapshot,
+                {
+                    code: 'simulator-transient',
+                    message: extractErrorMessage(simInvocation?.result) ??
+                        'Enterprise simulation exhausted retries on transient errors',
+                    phase: 1,
+                    source: 'simulator/enterprise',
+                },
+            ],
+            reason: `Enterprise simulation exhausted retries: ${extractErrorMessage(simInvocation?.result) ?? 'transient errors'} — re-run recommended`,
+            stats,
+        };
+    }
+    if (artifactFiles.length === 0) {
+        return {
+            verdict: 'failed',
+            degradations: [
+                ...degSnapshot,
+                {
+                    code: 'artifact-missing',
+                    message: 'Phase 1 artifact generator produced zero files',
+                    phase: 1,
+                    source: 'artifact-generator',
+                },
+            ],
+            reason: 'Phase 1 produced no artifacts on disk',
+            stats,
+        };
+    }
+    if (agentErrorRatio > DEGRADED_MAX_AGENT_ERROR_RATIO) {
+        return {
+            verdict: 'failed',
+            degradations: degSnapshot,
+            reason: `${erroredAgents} of ${totalAgents} graph-routed agents errored (>${Math.round(DEGRADED_MAX_AGENT_ERROR_RATIO * 100)}% threshold)`,
+            stats,
+        };
+    }
+    // ── degraded cases ──────────────────────────────────────────────────────
+    if (erroredAgents > 0 || degSnapshot.length > 0) {
+        return {
+            verdict: 'degraded',
+            degradations: degSnapshot,
+            reason: buildDegradedReason(erroredAgents, totalAgents, degSnapshot),
+            stats,
+        };
+    }
+    // ── healthy ────────────────────────────────────────────────────────────
+    if (HEALTHY_REQUIRES_ZERO_DEGRADATIONS && degSnapshot.length > 0) {
+        // Defensive: theoretically unreachable given the branch above, but keep
+        // the invariant visible.
+        return {
+            verdict: 'degraded',
+            degradations: degSnapshot,
+            reason: buildDegradedReason(0, totalAgents, degSnapshot),
+            stats,
+        };
+    }
+    return {
+        verdict: 'healthy',
+        degradations: [],
+        reason: `${succeededAgents}/${totalAgents} agents succeeded, ${artifactFiles.length} artifacts written`,
+        stats,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function classifySimulator(inv) {
+    if (!inv)
+        return 'not-invoked';
+    if (!isErrorResult(inv.result))
+        return 'succeeded';
+    const msg = extractErrorMessage(inv.result) ?? '';
+    const kind = classifyFailure(msg);
+    if (kind === 'terminal')
+        return 'failed-terminal';
+    if (kind === 'transient')
+        return 'failed-transient';
+    return 'failed-unknown';
+}
+function isErrorResult(r) {
+    return typeof r === 'object' && r !== null && 'error' in r;
+}
+function extractErrorMessage(r) {
+    if (typeof r !== 'object' || r === null)
+        return undefined;
+    const err = r.error;
+    if (typeof err === 'string')
+        return err;
+    if (typeof err === 'object' && err !== null && 'message' in err &&
+        typeof err.message === 'string') {
+        return err.message;
+    }
+    return undefined;
+}
+function buildDegradedReason(erroredAgents, totalAgents, degradations) {
+    const parts = [];
+    if (erroredAgents > 0) {
+        parts.push(`${erroredAgents} of ${totalAgents} agents errored`);
+    }
+    const codeCounts = new Map();
+    for (const d of degradations) {
+        codeCounts.set(d.code, (codeCounts.get(d.code) ?? 0) + 1);
+    }
+    for (const [code, count] of codeCounts) {
+        parts.push(count > 1 ? `${code} × ${count}` : code);
+    }
+    return parts.length > 0 ? parts.join('; ') : 'one or more degradations recorded';
+}
+//# sourceMappingURL=phase1-verdict.js.map

package/dist/pipeline/phase1-verdict.js.map

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

package/dist/pipeline/phase2-preflight.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ADR-PIPELINE-089 §5 — Phase 2 preflight.
+ *
+ * Before Phase 2 dispatches its ~7 platform agents in parallel, probe
+ * each backend's health endpoint with a short timeout. Cloud Run services
+ * that are already failing health checks get marked `skipped-unhealthy`
+ * instead of being called, which saves 60-120s per dead backend — the
+ * dominant wall-time sink in the observed 2026-04-22 reproduction.
+ *
+ * If a majority (≥ PREFLIGHT_ABORT_THRESHOLD) of backends fail, the
+ * caller should skip Phase 2 entirely and set status.json's
+ * phase2_preflight.verdict = 'abort'. The user sees a clean "skipped:
+ * N of M backends unhealthy" line from `agentics status` instead of
+ * watching a mystery 10-minute "in progress" pause.
+ */
+export interface PreflightAgentRef {
+    /** Logical domain/agent pair as used by the invoker. */
+    domain: string;
+    agent: string;
+    /** Service endpoint key (from src/config/endpoints.ts). */
+    service: string;
+}
+export interface PreflightResult {
+    probed: number;
+    healthy: string[];
+    unhealthy: string[];
+    skipped: string[];
+    durationMs: number;
+    verdict: 'healthy' | 'partial' | 'abort';
+}
+/**
+ * Runs a parallel health probe for each unique service backing the
+ * supplied agents. Returns which services responded, which timed out, and
+ * which agents should be skipped.
+ *
+ * Probes are cached per-process for 60 seconds keyed by service URL to
+ * avoid amplification when multiple phases call the same backend during
+ * one pipeline run. Callers can pass a traceId to scope the cache;
+ * omitting it uses a global bucket (fine for a single CLI invocation).
+ */
+export declare function runPhase2Preflight(agents: readonly PreflightAgentRef[], _traceId?: string): Promise<PreflightResult>;
+/** Test helper — clear the probe cache. */
+export declare function __resetPreflightCacheForTests(): void;
+//# sourceMappingURL=phase2-preflight.d.ts.map

package/dist/pipeline/phase2-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase2-preflight.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase2-preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C;AAOD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAoC1B;AAuDD,2CAA2C;AAC3C,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/pipeline/phase2-preflight.js

@@ -0,0 +1,120 @@
+/**
+ * ADR-PIPELINE-089 §5 — Phase 2 preflight.
+ *
+ * Before Phase 2 dispatches its ~7 platform agents in parallel, probe
+ * each backend's health endpoint with a short timeout. Cloud Run services
+ * that are already failing health checks get marked `skipped-unhealthy`
+ * instead of being called, which saves 60-120s per dead backend — the
+ * dominant wall-time sink in the observed 2026-04-22 reproduction.
+ *
+ * If a majority (≥ PREFLIGHT_ABORT_THRESHOLD) of backends fail, the
+ * caller should skip Phase 2 entirely and set status.json's
+ * phase2_preflight.verdict = 'abort'. The user sees a clean "skipped:
+ * N of M backends unhealthy" line from `agentics status` instead of
+ * watching a mystery 10-minute "in progress" pause.
+ */
+import { loadEndpointConfig, DEFAULT_ENDPOINTS } from '../config/endpoints.js';
+/** Tunable — the ADR calls for 3s; overridable via env for cold starts. */
+const PROBE_TIMEOUT_MS = Number(process.env['AGENTICS_PREFLIGHT_TIMEOUT_MS'] ?? 3000);
+/** ≥ this fraction of backends unhealthy → abort Phase 2. 4/7 ≈ 0.57. */
+const PREFLIGHT_ABORT_THRESHOLD = 4 / 7;
+/**
+ * Runs a parallel health probe for each unique service backing the
+ * supplied agents. Returns which services responded, which timed out, and
+ * which agents should be skipped.
+ *
+ * Probes are cached per-process for 60 seconds keyed by service URL to
+ * avoid amplification when multiple phases call the same backend during
+ * one pipeline run. Callers can pass a traceId to scope the cache;
+ * omitting it uses a global bucket (fine for a single CLI invocation).
+ */
+export async function runPhase2Preflight(agents, _traceId) {
+    const start = Date.now();
+    const uniqueServices = Array.from(new Set(agents.map(a => a.service)));
+    const healthyServices = [];
+    const unhealthyServices = [];
+    await Promise.all(uniqueServices.map(async (service) => {
+        const ok = await probeService(service);
+        if (ok)
+            healthyServices.push(service);
+        else
+            unhealthyServices.push(service);
+    }));
+    const unhealthySet = new Set(unhealthyServices);
+    const skipped = agents
+        .filter(a => unhealthySet.has(a.service))
+        .map(a => `${a.domain}/${a.agent}`);
+    const totalServices = uniqueServices.length;
+    const unhealthyRatio = totalServices === 0 ? 0 : unhealthyServices.length / totalServices;
+    let verdict;
+    if (unhealthyServices.length === 0)
+        verdict = 'healthy';
+    else if (unhealthyRatio >= PREFLIGHT_ABORT_THRESHOLD)
+        verdict = 'abort';
+    else
+        verdict = 'partial';
+    return {
+        probed: uniqueServices.length,
+        healthy: healthyServices,
+        unhealthy: unhealthyServices,
+        skipped,
+        durationMs: Date.now() - start,
+        verdict,
+    };
+}
+// ============================================================================
+// Probe
+// ============================================================================
+const probeCache = new Map();
+const PROBE_CACHE_TTL_MS = 60_000;
+async function probeService(service) {
+    const now = Date.now();
+    const cached = probeCache.get(service);
+    if (cached && cached.expires > now)
+        return cached.ok;
+    let baseUrl;
+    try {
+        // Service name is runtime-derived (`${domain}-agents`). Validate it
+        // against the registered endpoint keys so we can't silently probe a
+        // typo — unknown names fall through to the unhealthy path.
+        if (!(service in DEFAULT_ENDPOINTS)) {
+            probeCache.set(service, { ok: false, expires: now + PROBE_CACHE_TTL_MS });
+            return false;
+        }
+        const cfg = loadEndpointConfig(service);
+        baseUrl = cfg.baseUrl;
+    }
+    catch {
+        probeCache.set(service, { ok: false, expires: now + PROBE_CACHE_TTL_MS });
+        return false;
+    }
+    const url = baseUrl.replace(/\/$/, '') + '/v1/health';
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), PROBE_TIMEOUT_MS);
+    try {
+        // Any response that isn't a network/timeout failure counts as "alive."
+        // A 404 from /v1/health means the service is up but doesn't implement
+        // the endpoint — which is fine for our purposes (ruvvector-service
+        // actually returns a structured 404 here).
+        const resp = await fetch(url, {
+            method: 'GET',
+            signal: controller.signal,
+            headers: { accept: 'application/json' },
+        });
+        const ok = resp.status < 500; // 5xx = backend is failing
+        probeCache.set(service, { ok, expires: now + PROBE_CACHE_TTL_MS });
+        return ok;
+    }
+    catch {
+        probeCache.set(service, { ok: false, expires: now + PROBE_CACHE_TTL_MS });
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Test helper — clear the probe cache. */
+export function __resetPreflightCacheForTests() {
+    probeCache.clear();
+}
+//# sourceMappingURL=phase2-preflight.js.map

package/dist/pipeline/phase2-preflight.js.map

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

package/dist/pipeline/swarm-orchestrator.d.ts.map

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

package/dist/pipeline/swarm-orchestrator.js

@@ -2166,11 +2166,42 @@ export async function dispatchPhaseAgents(phaseConfig, traceId, runDir, scenario
             allServices.push(svc);
         }
     }
-    if (allServices.length > 0) {
-        const serviceNames = allServices.map(s => `${s.domain}/${s.agent}`);
-        console.error(`  [AGENTICS] Dispatching ${allServices.length} platform agents: ${serviceNames.join(', ')}`);
+    // ── 3a. ADR-PIPELINE-089 §5: Phase 2 preflight ──
+    // Before dispatching, probe each unique backend's /v1/health with a
+    // short timeout. Skip agents whose backend is failing so we don't burn
+    // 60-120s per dead Cloud Run service. If a majority fail, abort Phase 2
+    // entirely — downstream artifacts built on no-op responses are worse
+    // than no artifacts at all. Write the preflight result into status.json
+    // so `agentics status` can surface it.
+    let dispatchServices = allServices;
+    if (phaseConfig.phase === 2 && allServices.length > 0) {
+        const { runPhase2Preflight } = await import('./phase2-preflight.js');
+        const preflightRefs = allServices.map(s => ({
+            domain: s.domain,
+            agent: s.agent,
+            service: `${s.domain}-agents`,
+        }));
+        const preflight = await runPhase2Preflight(preflightRefs, traceId);
+        console.error(`  [PREFLIGHT] ${preflight.healthy.length}/${preflight.probed} backends healthy ` +
+            `in ${preflight.durationMs}ms (verdict: ${preflight.verdict})`);
+        if (preflight.unhealthy.length > 0) {
+            console.error(`  [PREFLIGHT] Unhealthy: ${preflight.unhealthy.join(', ')}`);
+            console.error(`  [PREFLIGHT] Skipping ${preflight.skipped.length} agents bound to unhealthy backends`);
+        }
+        // Persist preflight outcome to status.json for `agentics status` consumers.
+        await writePhase2PreflightToStatus(traceId, preflight);
+        if (preflight.verdict === 'abort') {
+            console.error('  [PREFLIGHT] ≥4/7 backends unhealthy — aborting Phase 2 dispatch cleanly');
+            return agenticsResults; // empty — caller handles missing content
+        }
+        const skippedSet = new Set(preflight.skipped);
+        dispatchServices = allServices.filter(s => !skippedSet.has(`${s.domain}/${s.agent}`));
+    }
+    if (dispatchServices.length > 0) {
+        const serviceNames = dispatchServices.map(s => `${s.domain}/${s.agent}`);
+        console.error(`  [AGENTICS] Dispatching ${dispatchServices.length} platform agents: ${serviceNames.join(', ')}`);
         const prompt = buildPhasePrompt(phaseConfig, scenarioQuery, runDir);
-        const results = await dispatchAgenticsServices(allServices, prompt, traceId);
+        const results = await dispatchAgenticsServices(dispatchServices, prompt, traceId);
         for (const r of results) {
             agenticsResults.push(r);
             const resp = r.response;
@@ -2190,7 +2221,7 @@ export async function dispatchPhaseAgents(phaseConfig, traceId, runDir, scenario
             return resp && resp['_fallback'] === true;
         }).length;
         const cloudCount = results.length - fallbackCount;
-        console.error(`  [AGENTICS] ${results.length}/${allServices.length} agents responded for Phase ${phaseConfig.phase} (${cloudCount} cloud, ${fallbackCount} local fallback)`);
+        console.error(`  [AGENTICS] ${results.length}/${dispatchServices.length} agents responded for Phase ${phaseConfig.phase} (${cloudCount} cloud, ${fallbackCount} local fallback)`);
         if (results.length === 0) {
             console.error(`  [AGENTICS] WARNING: No agents responded — costops/analytics output will be missing`);
         }
@@ -2200,6 +2231,37 @@ export async function dispatchPhaseAgents(phaseConfig, traceId, runDir, scenario
     }
     return agenticsResults;
 }
+/**
+ * ADR-PIPELINE-089 §6: patch status.json with the Phase 2 preflight
+ * outcome so `agentics status` and the `agentics-status` MCP tool can
+ * surface "skipped 5 unhealthy backends" instead of "Phase 2 running for
+ * 7 minutes." Best-effort — status.json may not exist for shell-mode
+ * runs, and that is the expected code path (no MCP fast-return detach).
+ */
+async function writePhase2PreflightToStatus(traceId, preflight) {
+    try {
+        const fsMod = await import('node:fs');
+        const pathMod = await import('node:path');
+        const os = await import('node:os');
+        const statusPath = pathMod.join(os.homedir(), '.agentics', 'runs', traceId, 'status.json');
+        if (!fsMod.existsSync(statusPath))
+            return;
+        const current = JSON.parse(fsMod.readFileSync(statusPath, 'utf-8'));
+        current['phase2_preflight'] = {
+            probed: preflight.probed,
+            healthy: preflight.healthy,
+            unhealthy: preflight.unhealthy,
+            skipped: preflight.skipped,
+            duration_ms: preflight.durationMs,
+            verdict: preflight.verdict,
+            probed_at: new Date().toISOString(),
+        };
+        const tmp = statusPath + '.tmp';
+        fsMod.writeFileSync(tmp, JSON.stringify(current, null, 2), { encoding: 'utf-8', mode: 0o600 });
+        fsMod.renameSync(tmp, statusPath);
+    }
+    catch { /* non-fatal */ }
+}
 /**
  * Store phase artifacts in swarm memory for cross-phase coordination.
  */