@llm-dev-ops/agentics-cli 2.7.3 → 2.7.5

package/dist/synthesis/agent-claim-registry.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ADR-PIPELINE-096 D3 — Agent-Claim Registry.
+ *
+ * Maps the four headline financial metrics that the executive summary,
+ * decision memo, and financial analysis render onto specific agents and
+ * response paths. The renderer consults this registry FIRST when synthesising
+ * a number; if the canonical agent returned a value, that value is the source
+ * of truth and the rendered cell carries `src=<agent>`. If the registry has no
+ * winner, the renderer falls through to `unit-economics.json`, then to the
+ * per-employee heuristic from ADR-095.
+ *
+ * The registry is intentionally NARROW — it covers only the four metrics that
+ * appear in every CXO-facing document. Adding a new metric is a one-line
+ * change here plus a renderer hook; we are explicit about which numbers carry
+ * source attribution and which do not.
+ */
+/**
+ * The four headline metrics that get source attribution. Lined up with the
+ * fcv-tag `kind=` values from ADR-PIPELINE-073 (financial-claim-extractor).
+ */
+export type ClaimKind = 'investment' | 'roi' | 'npv' | 'payback' | 'savings';
+/**
+ * One entry maps a metric to a specific agent and a response-path
+ * (dot-delimited). Multiple entries per kind are allowed and ranked by
+ * priority — the first agent that returned a value wins.
+ */
+export interface ClaimMapping {
+    /** The metric this mapping resolves. */
+    readonly kind: ClaimKind;
+    /** Domain identifier — e.g. `costops`, `simulator`, `platform`. */
+    readonly domain: string;
+    /** Agent identifier within the domain — e.g. `forecast`, `roi`, `scenario`. */
+    readonly agent: string;
+    /** Dot-delimited path inside the agent's response object. Supports `.` and array `[0]` notation. */
+    readonly response_path: string;
+    /** Lower numbers are tried first. Stable, declarative priority. */
+    readonly priority: number;
+    /** Optional human-readable methodology string used in the rendered cell. */
+    readonly methodology?: string;
+}
+/**
+ * Canonical mapping table. Adding a new agent that returns one of the four
+ * metrics is a single-line append here. The renderer never hardcodes
+ * agent/path knowledge; everything flows through this table.
+ */
+export declare const AGENT_CLAIM_REGISTRY: ReadonlyArray<ClaimMapping>;
+/** Minimal shape we need from any agent invocation result. */
+export interface AgentResultLike {
+    readonly domain: string;
+    readonly agent: string;
+    readonly status: number;
+    readonly response: unknown;
+}
+/** A claim that has been resolved against the registry. */
+export interface ResolvedClaim {
+    /** Raw value from the agent (number or string — caller decides format). */
+    readonly value: number | string;
+    /** Source attribution for the rendered `src=` attribute. */
+    readonly source: string;
+    /** Methodology string for the cell text. */
+    readonly methodology: string;
+    /** Which agent produced this value. */
+    readonly domain: string;
+    readonly agent: string;
+}
+/**
+ * Look up the highest-priority agent that returned a value for `kind`.
+ * Returns `null` when no registered agent succeeded with a non-null value at
+ * the response path. Caller decides whether to fall through to
+ * unit-economics.json or to the per-employee heuristic.
+ */
+export declare function resolveClaim(kind: ClaimKind, results: ReadonlyArray<AgentResultLike>): ResolvedClaim | null;
+/**
+ * Resolve ALL agents that returned a value for `kind`. Used by D3 part 2's
+ * triangulation surface to detect agreement / divergence across multiple
+ * sources for the same metric.
+ */
+export declare function resolveAllClaims(kind: ClaimKind, results: ReadonlyArray<AgentResultLike>): ResolvedClaim[];
+/**
+ * Walk a dot-delimited path inside a response object. Supports nested objects
+ * and array indices via `[N]` notation. Returns `null` for any miss.
+ *
+ * Example: `data.dcf.npv_5yr_usd` → result.data.dcf.npv_5yr_usd
+ * Example: `data.scenarios[0].npv` → result.data.scenarios[0].npv
+ */
+export declare function readResponsePath(response: unknown, path: string): unknown;
+//# sourceMappingURL=agent-claim-registry.d.ts.map

package/dist/synthesis/agent-claim-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-claim-registry.d.ts","sourceRoot":"","sources":["../../src/synthesis/agent-claim-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,YAAY,CA8F5D,CAAC;AAMF,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GACtC,aAAa,GAAG,IAAI,CAgCtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GACtC,aAAa,EAAE,CA8BjB;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqCzE"}

package/dist/synthesis/agent-claim-registry.js

@@ -0,0 +1,257 @@
+/**
+ * ADR-PIPELINE-096 D3 — Agent-Claim Registry.
+ *
+ * Maps the four headline financial metrics that the executive summary,
+ * decision memo, and financial analysis render onto specific agents and
+ * response paths. The renderer consults this registry FIRST when synthesising
+ * a number; if the canonical agent returned a value, that value is the source
+ * of truth and the rendered cell carries `src=<agent>`. If the registry has no
+ * winner, the renderer falls through to `unit-economics.json`, then to the
+ * per-employee heuristic from ADR-095.
+ *
+ * The registry is intentionally NARROW — it covers only the four metrics that
+ * appear in every CXO-facing document. Adding a new metric is a one-line
+ * change here plus a renderer hook; we are explicit about which numbers carry
+ * source attribution and which do not.
+ */
+// ---------------------------------------------------------------------------
+// Registry (declarative — the single place mappings live)
+// ---------------------------------------------------------------------------
+/**
+ * Canonical mapping table. Adding a new agent that returns one of the four
+ * metrics is a single-line append here. The renderer never hardcodes
+ * agent/path knowledge; everything flows through this table.
+ */
+export const AGENT_CLAIM_REGISTRY = [
+    // ── Investment (Total Investment / Total Cost) ─────────────────────────────
+    {
+        kind: 'investment',
+        domain: 'costops',
+        agent: 'forecast',
+        response_path: 'data.investment.total_usd',
+        priority: 10,
+        methodology: 'costops/forecast: total program investment forecast',
+    },
+    {
+        kind: 'investment',
+        domain: 'costops',
+        agent: 'budget',
+        response_path: 'data.allocated_budget.usd',
+        priority: 20,
+        methodology: 'costops/budget: allocated budget envelope',
+    },
+    {
+        kind: 'investment',
+        domain: 'costops',
+        agent: 'attribution',
+        response_path: 'data.total_cost.usd',
+        priority: 30,
+        methodology: 'costops/attribution: cost attribution rollup',
+    },
+    // ── ROI (Expected ROI / Return on Investment) ──────────────────────────────
+    {
+        kind: 'roi',
+        domain: 'costops',
+        agent: 'roi',
+        response_path: 'data.roi_pct',
+        priority: 10,
+        methodology: 'costops/roi: program ROI calculation',
+    },
+    {
+        kind: 'roi',
+        domain: 'costops',
+        agent: 'tradeoff',
+        response_path: 'data.roi_pct',
+        priority: 20,
+        methodology: 'costops/tradeoff: ROI under cost-quality tradeoff',
+    },
+    // ── NPV (5-year NPV) ───────────────────────────────────────────────────────
+    {
+        kind: 'npv',
+        domain: 'simulator',
+        agent: 'scenario',
+        response_path: 'data.dcf.npv_5yr_usd',
+        priority: 10,
+        methodology: 'simulator/scenario: 5-year DCF, scenario midpoint',
+    },
+    {
+        kind: 'npv',
+        domain: 'costops',
+        agent: 'forecast',
+        response_path: 'data.npv.five_year_usd',
+        priority: 20,
+        methodology: 'costops/forecast: 5-year NPV from forecast',
+    },
+    // ── Payback (Payback Period) ───────────────────────────────────────────────
+    {
+        kind: 'payback',
+        domain: 'costops',
+        agent: 'budget',
+        response_path: 'data.payback_months',
+        priority: 10,
+        methodology: 'costops/budget: payback period',
+    },
+    {
+        kind: 'payback',
+        domain: 'costops',
+        agent: 'forecast',
+        response_path: 'data.payback_months',
+        priority: 20,
+        methodology: 'costops/forecast: payback from cumulative cashflow',
+    },
+    // ── Savings (Annual Efficiency Gain / Revenue Impact) ──────────────────────
+    {
+        kind: 'savings',
+        domain: 'costops',
+        agent: 'roi',
+        response_path: 'data.annual_savings_usd',
+        priority: 10,
+        methodology: 'costops/roi: annual savings from ROI calc',
+    },
+    {
+        kind: 'savings',
+        domain: 'costops',
+        agent: 'attribution',
+        response_path: 'data.annual_savings.usd',
+        priority: 20,
+        methodology: 'costops/attribution: annual savings',
+    },
+];
+/**
+ * Look up the highest-priority agent that returned a value for `kind`.
+ * Returns `null` when no registered agent succeeded with a non-null value at
+ * the response path. Caller decides whether to fall through to
+ * unit-economics.json or to the per-employee heuristic.
+ */
+export function resolveClaim(kind, results) {
+    // Filter mappings to this kind, sorted by priority (lower wins).
+    const candidates = AGENT_CLAIM_REGISTRY
+        .filter(m => m.kind === kind)
+        .slice()
+        .sort((a, b) => a.priority - b.priority);
+    // Index agent results by `domain/agent` for O(1) lookup.
+    const byKey = new Map();
+    for (const r of results) {
+        if (r.status >= 200 && r.status < 300) {
+            byKey.set(`${r.domain}/${r.agent}`, r);
+        }
+    }
+    for (const c of candidates) {
+        const result = byKey.get(`${c.domain}/${c.agent}`);
+        if (!result)
+            continue;
+        const value = readResponsePath(result.response, c.response_path);
+        if (value === null || value === undefined)
+            continue;
+        if (typeof value !== 'number' && typeof value !== 'string')
+            continue;
+        if (typeof value === 'string' && value.trim().length === 0)
+            continue;
+        return {
+            value,
+            source: `${c.domain}/${c.agent}`,
+            methodology: c.methodology ?? `${c.domain}/${c.agent}`,
+            domain: c.domain,
+            agent: c.agent,
+        };
+    }
+    return null;
+}
+/**
+ * Resolve ALL agents that returned a value for `kind`. Used by D3 part 2's
+ * triangulation surface to detect agreement / divergence across multiple
+ * sources for the same metric.
+ */
+export function resolveAllClaims(kind, results) {
+    const candidates = AGENT_CLAIM_REGISTRY
+        .filter(m => m.kind === kind)
+        .slice()
+        .sort((a, b) => a.priority - b.priority);
+    const byKey = new Map();
+    for (const r of results) {
+        if (r.status >= 200 && r.status < 300) {
+            byKey.set(`${r.domain}/${r.agent}`, r);
+        }
+    }
+    const out = [];
+    for (const c of candidates) {
+        const result = byKey.get(`${c.domain}/${c.agent}`);
+        if (!result)
+            continue;
+        const value = readResponsePath(result.response, c.response_path);
+        if (value === null || value === undefined)
+            continue;
+        if (typeof value !== 'number' && typeof value !== 'string')
+            continue;
+        if (typeof value === 'string' && value.trim().length === 0)
+            continue;
+        out.push({
+            value,
+            source: `${c.domain}/${c.agent}`,
+            methodology: c.methodology ?? `${c.domain}/${c.agent}`,
+            domain: c.domain,
+            agent: c.agent,
+        });
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Walk a dot-delimited path inside a response object. Supports nested objects
+ * and array indices via `[N]` notation. Returns `null` for any miss.
+ *
+ * Example: `data.dcf.npv_5yr_usd` → result.data.dcf.npv_5yr_usd
+ * Example: `data.scenarios[0].npv` → result.data.scenarios[0].npv
+ */
+export function readResponsePath(response, path) {
+    if (response === null || response === undefined)
+        return null;
+    // Tokenize the path on `.` and `[N]`.
+    const tokens = [];
+    let buf = '';
+    for (let i = 0; i < path.length; i++) {
+        const ch = path[i];
+        if (ch === '.') {
+            if (buf)
+                tokens.push(buf);
+            buf = '';
+        }
+        else if (ch === '[') {
+            if (buf)
+                tokens.push(buf);
+            buf = '';
+            const close = path.indexOf(']', i);
+            if (close === -1)
+                return null;
+            const idx = parseInt(path.slice(i + 1, close), 10);
+            if (Number.isNaN(idx))
+                return null;
+            tokens.push(idx);
+            i = close;
+        }
+        else {
+            buf += ch;
+        }
+    }
+    if (buf)
+        tokens.push(buf);
+    let cur = response;
+    for (const tok of tokens) {
+        if (cur === null || cur === undefined)
+            return null;
+        if (typeof tok === 'number') {
+            if (!Array.isArray(cur))
+                return null;
+            cur = cur[tok];
+        }
+        else {
+            if (typeof cur !== 'object')
+                return null;
+            cur = cur[tok];
+        }
+    }
+    return cur ?? null;
+}
+//# sourceMappingURL=agent-claim-registry.js.map

package/dist/synthesis/agent-claim-registry.js.map

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

package/dist/synthesis/ask-artifact-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-artifact-writer.d.ts","sourceRoot":"","sources":["../../src/synthesis/ask-artifact-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAgB/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8mCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAmBjF;AAoED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA2E9D"}
+{"version":3,"file":"ask-artifact-writer.d.ts","sourceRoot":"","sources":["../../src/synthesis/ask-artifact-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAgB/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6rCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAmBjF;AAoED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA2E9D"}

package/dist/synthesis/ask-artifact-writer.js

@@ -65,9 +65,88 @@ function buildManifest(input) {
             status: a.succeeded ? 'success' : 'error',
         })),
         artifacts: [...baseArtifacts, ...engArtifacts],
-        schema_version: '1.0.0',
+        // ADR-PIPELINE-096 D2 — runtime lineage block. Populated from the route
+        // result + a fresh Ruflo availability probe. Backwards-compatible: every
+        // existing consumer ignores the new top-level key per ADR-088. Surface
+        // points: `agentics status`, the `agentics-status` MCP tool, and
+        // `agent-fleet-report.md`.
+        runtime: buildRuntimeLineage(input, agents),
+        schema_version: '1.1.0',
     };
 }
+/**
+ * ADR-096 D2 — assemble the `runtime` block. Best-effort: if any sub-probe
+ * fails (Ruflo unreachable, etc.), the offending field is null/undefined and
+ * the rest still populates. Never throws.
+ */
+function buildRuntimeLineage(input, agents) {
+    // Ruflo availability — uses ADR-094's cached probe so this is a microsecond
+    // lookup after the first call, NOT a fresh subprocess.
+    let ruflo;
+    try {
+        // Dynamic require so this module stays loadable in environments where the
+        // ruflo-phase-executor's deps aren't installed (e.g. tests).
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const rufloMod = require('../pipeline/ruflo-phase-executor.js');
+        const probe = typeof rufloMod.checkRufloAvailable === 'function' ? rufloMod.checkRufloAvailable() : null;
+        if (probe && typeof probe === 'object') {
+            const p = probe;
+            ruflo = {
+                available: Boolean(p['available']),
+                version: typeof p['version'] === 'string' ? p['version'] : 'N/A',
+                binary: typeof p['binary'] === 'string' ? p['binary'] : '',
+                reason: typeof p['reason'] === 'string' ? p['reason'] : (p['available'] ? 'ok' : 'unknown'),
+            };
+        }
+        else {
+            ruflo = { available: false, version: 'N/A', binary: '', reason: 'probe-failed' };
+        }
+    }
+    catch {
+        ruflo = { available: false, version: 'N/A', binary: '', reason: 'probe-threw' };
+    }
+    // Ruvector / hyperbolic simulation — `simulator/enterprise` invocations
+    // and graph-routing calls (the simulation-tier branch of
+    // executeAgentsInvokeCommand) all flow through ruvector. We surface the
+    // count and the per-call latency that we already track in the route result.
+    const simulatorAgents = agents.filter(a => a.domain === 'simulator');
+    const ruvector = {
+        hyperbolic_simulations: simulatorAgents.map(a => ({
+            agent: `${a.domain}/${a.agent}`,
+            status: a.succeeded ? 'success' : 'error',
+        })),
+        embedding_lookups: 0, // populated by D2.1 follow-up when graph-router exposes a counter
+        graph_routing_invocations: input.routeResult.kind === 'multi' ? 1 : 0, // capability-graph route attempt; 0 on consultancy bypass
+    };
+    // Fleet metadata — depth + per-domain success/fail counts.
+    const byDomain = {};
+    for (const a of agents) {
+        const slot = byDomain[a.domain] ?? { dispatched: 0, succeeded: 0, failed: 0 };
+        slot.dispatched++;
+        if (a.succeeded)
+            slot.succeeded++;
+        else
+            slot.failed++;
+        byDomain[a.domain] = slot;
+    }
+    const dispatched = agents.length;
+    const succeeded = agents.filter(a => a.succeeded).length;
+    const failed = dispatched - succeeded;
+    // Depth is read from the route result (set by the caller via
+    // `executeNaturalLanguageRoute(query, { depth })`). Fallback heuristic when
+    // the value isn't carried through: 100+ agents is consultancy, 20+ is
+    // standard, otherwise lite.
+    const inferredDepth = dispatched >= 100 ? 'consultancy' : dispatched >= 20 ? 'standard' : 'lite';
+    const fleet = {
+        depth: inferredDepth,
+        dispatched,
+        succeeded,
+        failed,
+        by_domain: byDomain,
+        cloud_breaker: { tripped: false }, // populated by D2.2 when cloud-breaker state surfaces from agents.ts
+    };
+    return { ruflo, ruvector, fleet };
+}
 function buildResultsJson(input) {
     if (input.routeResult.kind === 'multi') {
         return {