@llm-dev-ops/agentics-cli 2.7.12 → 2.7.14

package/dist/synthesis/simulation-renderers.js

@@ -380,7 +380,7 @@ function computeDomainAwareConfidence(query, originalProb) {
     const rounded = Math.round(score * 100) / 100;
     return Math.abs(rounded - originalProb) > 0.03 ? rounded : originalProb;
 }
-export function synthesizeFinancials(simData, platformResults, query) {
+export function synthesizeFinancials(simData, platformResults, query, runDir) {
     const fm = (safeGet(simData, 'financial_model') ?? safeGet(simData, 'cost_model') ?? safeGet(simData, 'financials'));
     // Collect from all possible agent sources — not just costops
     const financialFields = {};
@@ -405,6 +405,14 @@ export function synthesizeFinancials(simData, platformResults, query) {
     // contribute to D3 part 2's triangulation surface.
     const triangulationMap = {};
     resolveCanonicalClaims(platformResults, financialFields, financialSources, triangulationMap);
+    // ── Source 0.5: ADR-096 D3+ (2.7.13) — narrative extraction ────────────
+    // When platform/decision-memo or platform/executive-summary return
+    // narrative text rather than structured JSON, scan that text for explicit
+    // financial figures ($X investment, Y% ROI, etc.) and use them with
+    // src=domain/agent:extracted. Conservative regex — only catches anchored
+    // mentions, never invents values. Cheaper than an LLM call but bridges
+    // the gap when the agent narrative happens to include real numbers.
+    resolveNarrativeClaims(platformResults, financialFields, financialSources);
     // Source 1: simData direct fields
     for (const [key, ...aliases] of financialKeys) {
         if (!key)
@@ -463,6 +471,47 @@ export function synthesizeFinancials(simData, platformResults, query) {
             }
         }
     }
+    // ── Source 0.7: ADR-PIPELINE-096 D3++ (2.7.14) — unit-economics-derived ─
+    // When a unit-economics.json manifest exists for this run AND any of the
+    // headline metrics are still empty, derive them from the bottom-up sector
+    // baseline (sqft × $/sqft for CRE, rooms × $/orn for hospitality, etc.)
+    // via buildFinancialModelFromUnitEconomics. This unifies the methodology:
+    // savings AND investment AND NPV AND payback all trace to one model
+    // instead of having savings from sqft baseline but investment from
+    // per-employee. McKinsey/Accenture engagements would flag the methodology
+    // mismatch — this fixes it.
+    if (runDir) {
+        const manifestResult = loadUnitEconomics(runDir);
+        if (manifestResult.manifest) {
+            const m = buildFinancialModelFromUnitEconomics(manifestResult.manifest);
+            const sector = manifestResult.manifest.sector;
+            const sourceTag = `unit-economics:${sector}`;
+            if (!financialFields['budget']) {
+                financialFields['budget'] = m.budget;
+                financialSources['budget'] = sourceTag;
+            }
+            if (!financialFields['roi']) {
+                financialFields['roi'] = m.roi;
+                financialSources['roi'] = sourceTag;
+            }
+            if (!financialFields['npv']) {
+                financialFields['npv'] = m.npv;
+                financialSources['npv'] = sourceTag;
+            }
+            if (!financialFields['payback']) {
+                financialFields['payback'] = m.payback;
+                financialSources['payback'] = sourceTag;
+            }
+            if (!financialFields['revenue']) {
+                financialFields['revenue'] = m.revenue;
+                financialSources['revenue'] = sourceTag;
+            }
+            if (!financialFields['costSavings']) {
+                financialFields['costSavings'] = m.costSavings;
+                financialSources['costSavings'] = sourceTag;
+            }
+        }
+    }
     const hasRealData = !!(financialFields['budget'] || financialFields['roi'] || financialFields['npv'] || financialFields['payback'] || financialFields['revenue'] || financialFields['costSavings']);
     // Source 3: Estimate from query context when nothing else available
     if (!hasRealData) {
@@ -594,6 +643,76 @@ function resolveCanonicalClaims(platformResults, financialFields, financialSourc
     captureTriangulation('revenue', 'savings');
     captureTriangulation('costSavings', 'savings');
 }
+/**
+ * ADR-PIPELINE-096 D3+ (2.7.13) — Source 0.5: extract financial figures
+ * from agent narrative responses (platform/decision-memo,
+ * platform/executive-summary). Used when no canonical agent supplied a
+ * structured value but a narrative mention exists.
+ */
+function resolveNarrativeClaims(platformResults, financialFields, financialSources) {
+    // Collect narrative agents — currently platform/decision-memo and
+    // platform/executive-summary are the only two that return structured
+    // narrative blocks per the 2.7.10 calibration diagnostic.
+    const narrativeAgents = [];
+    for (const r of platformResults) {
+        if (r.status < 200 || r.status >= 300)
+            continue;
+        const agent = r;
+        if (agent.domain !== 'platform')
+            continue;
+        if (agent.agent !== 'decision-memo' && agent.agent !== 'executive-summary')
+            continue;
+        const sp = extractSignalPayload(r.response);
+        const data = sp.data ?? {};
+        // Concatenate the narrative-bearing fields. decision-memo has
+        // background, analysis, recommendation, risks; executive-summary has
+        // executive_summary, key_findings, recommendation. Catch all relevant.
+        const parts = [];
+        for (const k of ['executive_summary', 'background', 'analysis', 'recommendation', 'risks', 'key_findings', 'next_steps', 'options']) {
+            const v = data[k];
+            if (typeof v === 'string')
+                parts.push(v);
+            else if (Array.isArray(v))
+                parts.push(v.filter(x => typeof x === 'string').join(' '));
+        }
+        const narrative = parts.join(' ');
+        if (narrative.length > 20) {
+            narrativeAgents.push({ domain: agent.domain, agent: agent.agent, narrative });
+        }
+    }
+    if (narrativeAgents.length === 0)
+        return;
+    const extracted = agentClaimRegistry.extractFinancialClaimsFromNarrative(narrativeAgents);
+    // Map extracted claims onto financialFields keys based on the source suffix.
+    for (const claim of extracted) {
+        const value = typeof claim.value === 'string' ? claim.value : String(claim.value);
+        if (claim.source.endsWith(':extracted')) {
+            // Plain investment extraction
+            if (!financialFields['budget']) {
+                financialFields['budget'] = `${value} (${claim.methodology})`;
+                financialSources['budget'] = claim.source;
+            }
+        }
+        else if (claim.source.endsWith(':extracted-roi')) {
+            if (!financialFields['roi']) {
+                financialFields['roi'] = `${value} projected (${claim.methodology})`;
+                financialSources['roi'] = claim.source;
+            }
+        }
+        else if (claim.source.endsWith(':extracted-npv')) {
+            if (!financialFields['npv']) {
+                financialFields['npv'] = `${value} 5-year NPV (${claim.methodology})`;
+                financialSources['npv'] = claim.source;
+            }
+        }
+        else if (claim.source.endsWith(':extracted-payback')) {
+            if (!financialFields['payback']) {
+                financialFields['payback'] = `${value} (${claim.methodology})`;
+                financialSources['payback'] = claim.source;
+            }
+        }
+    }
+}
 /** Format a registry-resolved value into the renderer's expected string shape. */
 function formatClaimValue(key, value, methodology) {
     if (typeof value === 'string')
@@ -1663,7 +1782,7 @@ export async function synthesizeExecutiveDocument(skeleton, query, documentType,
 // ============================================================================
 // Executive Summary Renderer (ADR-PIPELINE-024: Pyramid Principle)
 // ============================================================================
-export function renderExecutiveSummary(query, simulationResult, platformResults) {
+export function renderExecutiveSummary(query, simulationResult, platformResults, runDir) {
     const now = new Date().toISOString();
     const simPayload = extractSignalPayload(simulationResult);
     const simData = simPayload.data ?? {};
@@ -1672,7 +1791,10 @@ export function renderExecutiveSummary(query, simulationResult, platformResults)
     const timeline = safeString(simData, 'timeline_estimate') || safeString(simData, 'timeline') || '12-18 weeks';
     const problemStatement = distillProblemStatement(query);
     const extracted = extractScenarioFromQuery(query);
-    const fin = synthesizeFinancials(simData, platformResults, query);
+    // ADR-PIPELINE-096 D3++ (2.7.14) — pass runDir so synthesizeFinancials
+    // can apply the unit-economics-derived bottom-up methodology when
+    // available. The same call now serves all three documents.
+    const fin = synthesizeFinancials(simData, platformResults, query, runDir);
     const risks = generateDomainRisks(query, extracted);
     const primarySystem = extracted.systems[0] ?? extractSystemFromQuery(query) ?? 'the enterprise platform';
     let recommendation = 'DEFER';
@@ -1786,21 +1908,33 @@ export function renderExecutiveSummary(query, simulationResult, platformResults)
     // carry scope=full-program.
     if (fin.hasData) {
         lines.push('## Financial Impact', '');
-        // ADR-PIPELINE-096 D3 calibration banner (2.7.11/2.7.12): when ALL
-        // sources are heuristic (no canonical agent supplied a value), surface
-        // the fallback explicitly. 2.7.12 attributes heuristic values as
-        // src=heuristic:... so the test below distinguishes "any agent
-        // attribution" from "heuristic attribution". Calibration diagnostic in
-        // agent-responses.json shows that the current Cloud Run fleet does not
-        // include a project-level financial agent — the costops/* domain is
-        // about AI/LLM cost ops, not enterprise project financials.
+        // ADR-PIPELINE-096 D3 calibration banner (2.7.11→2.7.14): banner shape
+        // depends on which source filled the cells:
+        //   • src=domain/agent      → canonical agent (no banner; just the data)
+        //   • src=unit-economics:X  → bottom-up sector model (no banner — this
+        //                             IS the canonical methodology when no
+        //                             project-level agent exists; tag this
+        //                             explicitly as the engagement methodology)
+        //   • src=heuristic:X       → per-employee fallback (banner with full
+        //                             remediation guidance)
         const allSources = [fin.sources?.budget, fin.sources?.roi, fin.sources?.npv, fin.sources?.payback, fin.sources?.revenue, fin.sources?.costSavings].filter(Boolean);
-        const hasAnyCanonicalSource = allSources.some(s => !s.startsWith('heuristic:'));
-        const allHeuristic = allSources.length > 0 && !hasAnyCanonicalSource;
-        if (allHeuristic || allSources.length === 0) {
-            lines.push('> **⚠️ Heuristic fallback in use.** No agent in the current fleet returned project-level financial figures. The numbers below are derived from the sector-baseline per-employee benchmark (ADR-PIPELINE-095) and are tagged `src=heuristic:...` for transparency. For consultancy-grade attribution, either provision a project-financial agent that returns `{investment, roi, npv, payback}` at predictable paths, or add an LLM-extraction layer over `platform/decision-memo`\'s narrative output (ADR-PIPELINE-096 task #24).');
+        const hasAnyAgentCanonical = allSources.some(s => !s.startsWith('heuristic:') && !s.startsWith('unit-economics:'));
+        const allUnitEconomics = allSources.length > 0 && allSources.every(s => s.startsWith('unit-economics:'));
+        const allHeuristic = allSources.length > 0 && allSources.every(s => s.startsWith('heuristic:'));
+        if (allHeuristic) {
+            lines.push('> **⚠️ Heuristic fallback in use.** No agent in the current fleet returned project-level financial figures, and unit-economics manifest was unavailable. The numbers below are derived from the sector-baseline per-employee benchmark (ADR-PIPELINE-095) and are tagged `src=heuristic:...` for transparency. For consultancy-grade attribution, either provision a project-financial agent that returns `{investment, roi, npv, payback}` at predictable paths, or add an LLM-extraction layer over `platform/decision-memo`\'s narrative output (ADR-PIPELINE-096 task #24).');
+            lines.push('');
+        }
+        else if (allUnitEconomics) {
+            lines.push('> **📊 Bottom-up sector methodology.** All headline figures derive from the unit-economics manifest (ADR-PIPELINE-066 §6 sector baseline) — savings AND investment AND NPV AND payback all trace to one model, McKinsey/Accenture-grade methodology consistency. Source attribution: `src=unit-economics:<sector>`.');
+            lines.push('');
+        }
+        else if (!hasAnyAgentCanonical && allSources.length > 0) {
+            // Mixed unit-econ + heuristic — partial bottom-up, partial fallback.
+            lines.push('> **📊 Mixed methodology.** Some figures are unit-economics-derived (sector bottom-up); others are heuristic per-employee fallback. Source attribution carried in each cell\'s `src=` tag.');
             lines.push('');
         }
+        // If hasAnyAgentCanonical: agents supplied at least one value — no banner needed (the data IS the deliverable).
         lines.push('| Metric | Value |', '|--------|-------|');
         // ADR-PIPELINE-096 D3 — pass `fin.sources?.X` to fcvTag so the rendered
         // cell carries `src=domain/agent` (canonical) or omits the attribute
@@ -1919,7 +2053,7 @@ export function renderExecutiveSummary(query, simulationResult, platformResults)
 // ============================================================================
 // Decision Memo Renderer
 // ============================================================================
-export function renderDecisionMemo(query, simulationResult, platformResults) {
+export function renderDecisionMemo(query, simulationResult, platformResults, runDir) {
     const now = new Date().toISOString();
     const lineage = extractSimulationLineage(simulationResult);
     const simPayload = extractSignalPayload(simulationResult);
@@ -1927,7 +2061,8 @@ export function renderDecisionMemo(query, simulationResult, platformResults) {
     const successProb = extractSuccessProbability(simData);
     const extracted = extractScenarioFromQuery(query);
     const problemStatement = distillProblemStatement(query);
-    const fin = synthesizeFinancials(simData, platformResults, query);
+    // ADR-PIPELINE-096 D3++ (2.7.14) — runDir threaded for unit-economics-derived methodology.
+    const fin = synthesizeFinancials(simData, platformResults, query, runDir);
     const risks = generateDomainRisks(query, extracted);
     const primarySystem = extracted.systems[0] ?? extractSystemFromQuery(query) ?? 'the enterprise platform';
     const plannerData = extractAgentData(platformResults, 'copilot', 'planner');