@llm-dev-ops/agentics-cli 2.7.42 → 2.8.0

package/dist/pipeline/phase7/field-mappers.js

@@ -0,0 +1,278 @@
+/**
+ * Phase 7 — Template-Family Field Mappers (ADR-PIPELINE-111 D4)
+ *
+ * The 87 deliverables collapse to 33 `templateId` families. Rather than a
+ * hand-coded projection per report (87×) or a single generic synthesizer
+ * (which produced undifferentiated prose), each family carries a small,
+ * data-only spec: what that document type is *for* and which agent outputs
+ * inform it. The LLM field-writer (`field-writer.ts`) consumes the spec to
+ * produce report-type-specific, grounded field values.
+ *
+ * This file is pure data + lookups — no I/O, no LLM calls, no template logic.
+ */
+/**
+ * Generic fallback used when a templateId has no explicit spec. Keeps the
+ * writer functional for any future template without a registry edit.
+ */
+export const GENERIC_FAMILY_SPEC = {
+    templateId: '__generic__',
+    label: 'Consulting Deliverable',
+    focus: 'Produce a clear, decision-grade consulting document. Fill each field with ' +
+        'specific, evidence-backed content derived from the run artifacts and agent ' +
+        'analysis. Be concrete and tied to the business context; never invent dollar ' +
+        'figures — reuse the figures already provided in the document.',
+    emphasizeAgents: ['platform', 'analytics-hub', 'copilot'],
+};
+const SPECS = [
+    {
+        templateId: 'executive-summary',
+        label: 'Executive Summary / Decision Memo',
+        focus: 'A board-level summary: the recommendation, the opportunity, key findings, ' +
+            'financial impact, risk profile, and recommended next steps. Lead with the ' +
+            'decision requested. Every claim ties to agent evidence; figures reuse the ' +
+            'provided fcv values.',
+        emphasizeAgents: ['platform/executive-summary', 'platform/decision-memo', 'analytics-hub/recommendation', 'platform/risk-score'],
+    },
+    {
+        templateId: 'recommendation-paper',
+        label: 'Recommendation Paper',
+        focus: 'A structured recommendation: the options considered, the chosen option and ' +
+            'why, expected outcomes, and the implementation ask. Make the rationale and ' +
+            'trade-offs explicit.',
+        emphasizeAgents: ['analytics-hub/recommendation', 'analytics-hub/consensus', 'platform/decision'],
+    },
+    {
+        templateId: 'board-deck',
+        label: 'Board / Steering Committee Deck',
+        focus: 'Slide-style talking points for a board: situation, complication, ' +
+            'recommendation, financials, risks, ask. Each field is a tight, presentable ' +
+            'bullet block, not prose paragraphs.',
+        emphasizeAgents: ['platform/executive-summary', 'platform/decision', 'analytics-hub/recommendation'],
+    },
+    {
+        templateId: 'scenario-analysis',
+        label: 'Scenario Analysis & Sensitivity',
+        focus: 'Scenario and sensitivity analysis: the variables driving outcomes, their ' +
+            'ranges, decision trees / sensitivity tables, and which assumptions are ' +
+            'load-bearing. Distinguish ranges from point estimates.',
+        emphasizeAgents: ['simulator/what-if', 'simulator/scenario', 'platform/risk-score'],
+    },
+    {
+        templateId: 'business-case-scenario',
+        label: 'Business Case (Base / Best / Worst)',
+        focus: 'A scenario-weighted business case: assumptions, the investment, the ' +
+            'expected benefits, and the net outcome for this scenario. Numbers are ' +
+            'derived views of the canonical figures — never new origins.',
+        emphasizeAgents: ['costops/roi', 'costops/forecast', 'simulator/scenario'],
+    },
+    {
+        templateId: 'financial-model',
+        label: 'Financial Model / ROI / Cost-Benefit / Unit Economics',
+        focus: 'A financial model view: cost-benefit breakdown, ROI / IRR / NPV / payback, ' +
+            'and unit economics. ALL monetary values come from the provided canonical ' +
+            'figures; show derivation, never invent. Narrate what the numbers mean.',
+        emphasizeAgents: ['costops/roi', 'costops/attribution', 'costops/forecast', 'costops/tradeoff'],
+    },
+    {
+        templateId: 'tco',
+        label: 'Total Cost of Ownership',
+        focus: 'A TCO analysis: cost categories over the horizon, one-time vs recurring, ' +
+            'and the cumulative total. Reuse canonical cost figures.',
+        emphasizeAgents: ['costops/attribution', 'costops/forecast'],
+    },
+    {
+        templateId: 'value-capture',
+        label: 'Value Capture / Benefits Realization',
+        focus: 'A value-capture plan: the benefit streams, how each is measured, owners, ' +
+            'and the realization timeline. Tie benefits to the canonical savings figures.',
+        emphasizeAgents: ['costops/roi', 'research-lab/metrics', 'observatory/slo'],
+    },
+    {
+        templateId: 'cost-reduction-plan',
+        label: 'Cost Reduction / Optimization Plan',
+        focus: 'A cost-optimization plan: where cost is today, the optimization levers, the ' +
+            'expected savings per lever, and the sequencing.',
+        emphasizeAgents: ['costops/attribution', 'costops/tradeoff', 'auto-optimizer/token', 'auto-optimizer/model-select'],
+    },
+    {
+        templateId: 'strategy-doc',
+        label: 'Strategy Document',
+        focus: 'A strategy document for the specific strategy kind: the strategic context, ' +
+            'objectives, the chosen approach, and the execution implications. Be ' +
+            'specific to the strategy kind named in the title.',
+        emphasizeAgents: ['platform/decision', 'research-lab/hypothesis', 'analytics-hub/recommendation'],
+    },
+    {
+        templateId: 'transformation-blueprint',
+        label: 'Transformation / Roadmap Blueprint',
+        focus: 'A transformation roadmap: the target state, the phased path to it, ' +
+            'milestones with absolute dates, and dependencies. Anchor dates to the ' +
+            'pilot-start anchor in the roadmap artifact.',
+        emphasizeAgents: ['orchestrator/workflow', 'orchestrator/dependencies', 'platform/decision'],
+    },
+    {
+        templateId: 'operating-model-design',
+        label: 'Operating Model Design',
+        focus: 'A target operating model: capabilities, the org-and-process shape, ' +
+            'governance, and the operating rhythm.',
+        emphasizeAgents: ['orchestrator/workflow', 'governance-dashboard/oversight'],
+    },
+    {
+        templateId: 'capability-maturity',
+        label: 'Capability Maturity Assessment',
+        focus: 'A maturity assessment: the capability dimensions, current vs target level ' +
+            'per dimension, and the gaps to close.',
+        emphasizeAgents: ['observatory/health-check', 'research-lab/metrics'],
+    },
+    {
+        templateId: 'target-state-architecture',
+        label: 'Target-State / Integration Architecture',
+        focus: 'A target architecture: the component blueprint, integration points, and the ' +
+            'current→target delta. Ground in the integration assessment.',
+        emphasizeAgents: ['connector-hub/event-normalize', 'connector-hub/erp-surface', 'edge/tool-invoke'],
+    },
+    {
+        templateId: 'org-structure',
+        label: 'Org Structure / Workforce / Resource Plan',
+        focus: 'An org and resourcing plan: roles and reporting lines, the workforce/talent ' +
+            'needs, and the resource plan to staff the initiative.',
+        emphasizeAgents: ['orchestrator/scheduler', 'orchestrator/parallel'],
+    },
+    {
+        templateId: 'raci',
+        label: 'RACI Matrix',
+        focus: 'A RACI matrix: the key activities, and Responsible/Accountable/Consulted/' +
+            'Informed assignments per activity. Output a clean table.',
+        emphasizeAgents: ['orchestrator/workflow', 'governance-dashboard/oversight'],
+    },
+    {
+        templateId: 'process-maps',
+        label: 'Process Maps (L2–L5) / Service Delivery',
+        focus: 'Process maps: the end-to-end process steps at the requested level, hand-offs, ' +
+            'and the service-delivery model.',
+        emphasizeAgents: ['orchestrator/workflow', 'orchestrator/state-machine'],
+    },
+    {
+        templateId: 'performance-dashboard',
+        label: 'KPI / OKR / Performance Dashboard / Scorecards',
+        focus: 'A performance measurement design: the KPIs/OKRs, their definitions and ' +
+            'targets, the SLA/KPI thresholds, and the dashboard/scorecard layout.',
+        emphasizeAgents: ['observatory/slo', 'observatory/telemetry', 'research-lab/metrics'],
+    },
+    {
+        templateId: 'vendor-strategy',
+        label: 'Vendor / Partner Strategy & Scorecards',
+        focus: 'A vendor/partner strategy: selection criteria, the evaluation scorecard, and ' +
+            'the partnering recommendation.',
+        emphasizeAgents: ['platform/decision', 'analytics-hub/recommendation'],
+    },
+    {
+        templateId: 'platform-selection',
+        label: 'Platform Selection / Build-vs-Buy / ML Eval',
+        focus: 'A platform/option evaluation: the options, the weighted scoring against ' +
+            'criteria, build-vs-buy-vs-partner, and the selection with rationale.',
+        emphasizeAgents: ['inference-gateway/route', 'test-bench/compare', 'platform/decision'],
+    },
+    {
+        templateId: 'data-strategy',
+        label: 'Data Strategy & Data Model',
+        focus: 'A data strategy: the data domains, the target data model, governance, and ' +
+            'the data quality / lineage approach.',
+        emphasizeAgents: ['memory-graph/knowledge-graph', 'memory-graph/lineage', 'connector-hub/database-query'],
+    },
+    {
+        templateId: 'risk-register',
+        label: 'Risk Register / Mitigation / Cyber Risk',
+        focus: 'A risk register: enumerated risks with likelihood × impact, scoring, the ' +
+            'mitigation plan and owner per risk. Output a structured risk table.',
+        emphasizeAgents: ['platform/risk-score', 'sentinel/anomaly', 'shield/safety-boundary'],
+    },
+    {
+        templateId: 'regulatory-impact',
+        label: 'Regulatory / Compliance / Audit / Responsible-AI',
+        focus: 'A compliance assessment: the applicable obligations, the impact, the control ' +
+            'framework, audit-readiness, and any responsible-AI considerations.',
+        emphasizeAgents: ['governance-dashboard/audit', 'policy-engine/enforce', 'shield/pii', 'data-vault/access-control'],
+    },
+    {
+        templateId: 'research-report',
+        label: 'Market Research / Segmentation / VoC / Benchmarking / SWOT-RCA',
+        focus: 'A research report for the specific research kind: the method, the findings, ' +
+            'the segments/competitors/benchmarks/SWOT as applicable, and the implications.',
+        emphasizeAgents: ['research-lab/hypothesis', 'research-lab/metrics', 'analytics-hub/recommendation'],
+    },
+    {
+        templateId: 'internal-diagnostic',
+        label: 'Internal Diagnostic Assessment',
+        focus: 'An internal diagnostic: current-state health across dimensions, the issues ' +
+            'found, and the prioritised gaps.',
+        emphasizeAgents: ['observatory/health-check', 'observatory/failures', 'sentinel/rca'],
+    },
+    {
+        templateId: 'program-charter',
+        label: 'Program Charter',
+        focus: 'A program charter: objectives, scope, governance, stakeholders, and success ' +
+            'criteria.',
+        emphasizeAgents: ['orchestrator/workflow', 'governance-dashboard/oversight'],
+    },
+    {
+        templateId: 'pmo-framework',
+        label: 'PMO / Milestone / Dependency / Budget / Comms',
+        focus: 'A program-management artifact: the PMO operating framework, milestones with ' +
+            'dates, the dependency map, budget plan, or communication plan as the slug ' +
+            'indicates.',
+        emphasizeAgents: ['orchestrator/scheduler', 'orchestrator/dependencies', 'incident-manager/hitl'],
+    },
+    {
+        templateId: 'implementation-roadmap',
+        label: 'Implementation Roadmap / Backlog / Delivery',
+        focus: 'An implementation plan: the roadmap, the initiative backlog/WBS, and the ' +
+            'delivery sequencing with dependencies.',
+        emphasizeAgents: ['orchestrator/workflow', 'orchestrator/dependencies', 'orchestrator/parallel'],
+    },
+    {
+        templateId: 'deployment-plan',
+        label: 'Delivery / Release / Pilot / Deployment / Hypercare',
+        focus: 'A delivery/deployment artifact: the release plan, pilot/MVP definition, ' +
+            'deployment steps, and hypercare/support as the slug indicates.',
+        emphasizeAgents: ['edge/failover', 'edge/circuit-breaker', 'incident-manager/escalation'],
+    },
+    {
+        templateId: 'testing-strategy',
+        label: 'Testing Strategy',
+        focus: 'A testing strategy: the test levels, coverage targets, environments, and the ' +
+            'quality gates.',
+        emphasizeAgents: ['test-bench/benchmark', 'test-bench/regression', 'test-bench/quality'],
+    },
+    {
+        templateId: 'continuous-improvement',
+        label: 'Continuous Improvement / Post-Implementation Review',
+        focus: 'A continuous-improvement artifact: the improvement loop, the metrics ' +
+            'reviewed, lessons learned, and the post-implementation review findings.',
+        emphasizeAgents: ['observatory/usage-patterns', 'research-lab/metrics', 'auto-optimizer/self-optimize'],
+    },
+    {
+        templateId: 'rfp-response',
+        label: 'RFP/RFQ/RFI Response / Commercial Model',
+        focus: 'A commercial response: the requirement responses, the commercial/pricing ' +
+            'model, and the contracting position.',
+        emphasizeAgents: ['costops/tradeoff', 'platform/decision'],
+    },
+    {
+        templateId: 'digital-twin',
+        label: 'Digital Twin / Experimentation Framework',
+        focus: 'A digital-twin / experimentation artifact: the model of the system, the ' +
+            'experiments to run, and the metrics that decide them.',
+        emphasizeAgents: ['simulator/what-if', 'simulator/scenario', 'research-lab/hypothesis'],
+    },
+];
+const BY_TEMPLATE_ID = new Map(SPECS.map((s) => [s.templateId, s]));
+/** Resolve the family spec for a templateId, falling back to the generic spec. */
+export function getFamilySpec(templateId) {
+    return BY_TEMPLATE_ID.get(templateId) ?? GENERIC_FAMILY_SPEC;
+}
+/** All explicitly-registered template families (excludes the generic fallback). */
+export function registeredFamilyIds() {
+    return [...BY_TEMPLATE_ID.keys()];
+}
+//# sourceMappingURL=field-mappers.js.map

package/dist/pipeline/phase7/field-mappers.js.map

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

package/dist/pipeline/phase7/field-writer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Phase 7 — LLM Field Writer (ADR-PIPELINE-111 D2/D4)
+ *
+ * Given the placeholders a template still needs, the grounded agent outputs,
+ * and the family spec, produce a JSON `Record<placeholder,string>` of values.
+ *
+ * Channel policy (ADR-PIPELINE-098 / 110): Claude Code Max only — the local
+ * `claude --print` binary. NEVER the billed Anthropic API. If the binary is
+ * unavailable the writer returns `{}` and the caller degrades to the
+ * deterministic render (skeleton), exactly like `synthesizeExecutiveDocument`.
+ *
+ * Coherence (ADR-PIPELINE-111 D5): the prompt forbids inventing dollar figures
+ * and a post-parse guard drops any returned value that introduces a `$` amount
+ * not already present in the provided figures — financial values stay owned by
+ * `unit-economics.json`.
+ */
+import type { FamilySpec } from './field-mappers.js';
+export interface FieldWriterInput {
+    readonly slug: string;
+    readonly templateId: string;
+    readonly family: FamilySpec;
+    /** Placeholder keys the writer should fill (already-filled keys excluded). */
+    readonly placeholders: ReadonlyArray<string>;
+    /** The user's business context for the run. */
+    readonly scenarioQuery: string;
+    /** Grounded structured outputs from the row's sourceAgents (D3). */
+    readonly agentEvidence: string;
+    /** Deterministic fields already resolved (artifact/slug/reserved) — context. */
+    readonly knownFields: Readonly<Record<string, string>>;
+    /** Canonical financial figures the writer MAY cite verbatim (never alter). */
+    readonly canonicalFigures: string;
+    /** Trace id for degradation logging. */
+    readonly traceId?: string;
+}
+/**
+ * Produce field values for the requested placeholders. Returns `{}` on any
+ * failure (no binary, timeout, unparseable output) — never throws.
+ */
+export declare function writeFieldsViaLLM(input: FieldWriterInput): Promise<Record<string, string>>;
+/** Build the family-scoped, JSON-returning prompt. */
+export declare function buildFieldWriterPrompt(input: FieldWriterInput): string;
+/**
+ * Extract the first balanced top-level JSON object from arbitrary LLM text
+ * (handles ```json fences and leading/trailing prose).
+ */
+export declare function extractJsonObject(text: string): Record<string, unknown> | null;
+/**
+ * Keep only requested keys with non-empty string values, and drop any value
+ * that introduces a dollar figure not present in the canonical figures
+ * (ADR-111 D5 — financials stay owned by unit-economics.json).
+ */
+export declare function sanitizeFields(parsed: Record<string, unknown>, input: FieldWriterInput): Record<string, string>;
+//# sourceMappingURL=field-writer.d.ts.map

package/dist/pipeline/phase7/field-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-writer.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase7/field-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA4BjC;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAoCtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiC9E;AAKD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,gBAAgB,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxB"}

package/dist/pipeline/phase7/field-writer.js

@@ -0,0 +1,178 @@
+/**
+ * Phase 7 — LLM Field Writer (ADR-PIPELINE-111 D2/D4)
+ *
+ * Given the placeholders a template still needs, the grounded agent outputs,
+ * and the family spec, produce a JSON `Record<placeholder,string>` of values.
+ *
+ * Channel policy (ADR-PIPELINE-098 / 110): Claude Code Max only — the local
+ * `claude --print` binary. NEVER the billed Anthropic API. If the binary is
+ * unavailable the writer returns `{}` and the caller degrades to the
+ * deterministic render (skeleton), exactly like `synthesizeExecutiveDocument`.
+ *
+ * Coherence (ADR-PIPELINE-111 D5): the prompt forbids inventing dollar figures
+ * and a post-parse guard drops any returned value that introduces a `$` amount
+ * not already present in the provided figures — financial values stay owned by
+ * `unit-economics.json`.
+ */
+const PROMPT_TIMEOUT_MS = 90_000;
+const MAX_EVIDENCE = 6000;
+const MAX_CONTEXT = 2500;
+/**
+ * Produce field values for the requested placeholders. Returns `{}` on any
+ * failure (no binary, timeout, unparseable output) — never throws.
+ */
+export async function writeFieldsViaLLM(input) {
+    if (input.placeholders.length === 0)
+        return {};
+    const prompt = buildFieldWriterPrompt(input);
+    try {
+        const { execSync } = await import('node:child_process');
+        const { writeFileSync, unlinkSync } = await import('node:fs');
+        const claudeBin = process.env['AGENTICS_CLAUDE_BIN'] || 'claude';
+        const tmpFile = `/tmp/agentics-p7-fields-${input.slug}-${Date.now()}.txt`;
+        writeFileSync(tmpFile, prompt, 'utf-8');
+        try {
+            const raw = execSync(`${claudeBin} --print < "${tmpFile}"`, {
+                encoding: 'utf-8',
+                timeout: PROMPT_TIMEOUT_MS,
+                maxBuffer: 2_000_000,
+                shell: '/bin/sh',
+            });
+            const parsed = extractJsonObject(raw);
+            if (!parsed)
+                return {};
+            return sanitizeFields(parsed, input);
+        }
+        finally {
+            try {
+                unlinkSync(tmpFile);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    catch {
+        // Binary unavailable / timeout / non-zero exit — caller degrades.
+        return {};
+    }
+}
+/** Build the family-scoped, JSON-returning prompt. */
+export function buildFieldWriterPrompt(input) {
+    const placeholderList = input.placeholders.map((p) => `  - ${p}`).join('\n');
+    const known = Object.entries(input.knownFields)
+        .filter(([, v]) => typeof v === 'string' && v.trim().length > 0)
+        .slice(0, 20)
+        .map(([k, v]) => `  ${k}: ${truncate(v, 200)}`)
+        .join('\n');
+    return [
+        `You are a senior management-consulting writer producing the "${input.family.label}" deliverable (slug: ${input.slug}).`,
+        '',
+        `DOCUMENT PURPOSE:\n${input.family.focus}`,
+        '',
+        `BUSINESS CONTEXT (for understanding — do not echo verbatim):\n${truncate(input.scenarioQuery, MAX_CONTEXT)}`,
+        '',
+        input.agentEvidence.trim()
+            ? `AGENT ANALYSIS (your evidence — use these findings, do not contradict them):\n${truncate(input.agentEvidence, MAX_EVIDENCE)}`
+            : 'AGENT ANALYSIS: (none available — derive from business context and known fields)',
+        '',
+        input.canonicalFigures.trim()
+            ? `CANONICAL FINANCIAL FIGURES (the ONLY dollar amounts you may use — cite verbatim, never alter or invent):\n${truncate(input.canonicalFigures, 1500)}`
+            : '',
+        '',
+        known ? `ALREADY-FILLED FIELDS (for consistency — do not restate):\n${known}` : '',
+        '',
+        'TASK: Return a single JSON object whose keys are EXACTLY the field names below and whose values are the Markdown content for each field. Each value must be specific to this document type and grounded in the agent analysis and business context.',
+        '',
+        `FIELDS TO FILL:\n${placeholderList}`,
+        '',
+        'RULES:',
+        '- Output ONLY the JSON object. No prose, no markdown fences, no commentary.',
+        '- Keys must be exactly the field names listed (omit a key only if you genuinely cannot produce content for it).',
+        '- Values are Markdown strings (may contain lists, short tables, bold). Keep each focused and decision-grade.',
+        '- NEVER invent dollar figures. Use ONLY the canonical figures provided above; if a field needs money you do not have, describe it qualitatively.',
+        '- Be concrete and specific to the business context — no generic filler.',
+    ].filter((l) => l !== '').join('\n');
+}
+/**
+ * Extract the first balanced top-level JSON object from arbitrary LLM text
+ * (handles ```json fences and leading/trailing prose).
+ */
+export function extractJsonObject(text) {
+    if (typeof text !== 'string')
+        return null;
+    const fence = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidate = fence ? fence[1] : text;
+    const start = candidate.indexOf('{');
+    if (start < 0)
+        return null;
+    let depth = 0;
+    let inStr = false;
+    let esc = false;
+    for (let i = start; i < candidate.length; i++) {
+        const ch = candidate[i];
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (ch === '\\')
+                esc = true;
+            else if (ch === '"')
+                inStr = false;
+            continue;
+        }
+        if (ch === '"')
+            inStr = true;
+        else if (ch === '{')
+            depth++;
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0) {
+                const slice = candidate.slice(start, i + 1);
+                try {
+                    const obj = JSON.parse(slice);
+                    return obj && typeof obj === 'object' && !Array.isArray(obj) ? obj : null;
+                }
+                catch {
+                    return null;
+                }
+            }
+        }
+    }
+    return null;
+}
+/** Detects a `$<number>` money token (e.g. $340K, $8.5M, $1,200). */
+const MONEY_RE = /\$\s?\d[\d,.]*\s?[KkMmBb]?/g;
+/**
+ * Keep only requested keys with non-empty string values, and drop any value
+ * that introduces a dollar figure not present in the canonical figures
+ * (ADR-111 D5 — financials stay owned by unit-economics.json).
+ */
+export function sanitizeFields(parsed, input) {
+    const allowed = new Set(input.placeholders);
+    const canonicalMoney = new Set((input.canonicalFigures.match(MONEY_RE) ?? []).map(normalizeMoney));
+    const out = {};
+    for (const [k, v] of Object.entries(parsed)) {
+        if (!allowed.has(k))
+            continue;
+        if (typeof v !== 'string')
+            continue;
+        const value = v.trim();
+        if (value.length === 0)
+            continue;
+        const introduced = (value.match(MONEY_RE) ?? []).map(normalizeMoney);
+        const invents = introduced.some((m) => !canonicalMoney.has(m));
+        if (invents)
+            continue; // drop fields that fabricate dollar figures
+        out[k] = value;
+    }
+    return out;
+}
+function normalizeMoney(s) {
+    // Strip whitespace, uppercase the magnitude suffix, and trim any trailing
+    // punctuation the greedy `[\d,.]*` may have captured (e.g. "$1,200." → "$1,200").
+    return s.replace(/\s/g, '').replace(/[.,]+$/, '').toUpperCase();
+}
+function truncate(s, max) {
+    if (typeof s !== 'string')
+        return '';
+    return s.length > max ? `${s.slice(0, max)}…` : s;
+}
+//# sourceMappingURL=field-writer.js.map

package/dist/pipeline/phase7/field-writer.js.map

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

package/dist/pipeline/phase7/writer-agent.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Phase 7 — Writer-Agent Field Contract & Agent-Sourced Generation
+ * (ADR-PIPELINE-111 D1, D2, D3, D8)
+ *
+ * Closes the ADR-098 "Q-future" hole: the Ruflo writer fan-out returned only
+ * metadata (`RufloPhaseResult`), so its result was discarded (`void rufloResult`)
+ * and every deliverable fell back to shared local extraction. This module
+ * produces a real, per-deliverable field map by:
+ *
+ *   1. Invoking the row's `sourceAgents` through the repo-backed dispatch
+ *      (`executeAgentsInvokeCommand`, lazy-imported to avoid a load-time cycle),
+ *      cached per run (D3).
+ *   2. Resolving each template placeholder by precedence — agent > artifact >
+ *      slug > llm > _TBD_ — with financial/structural fields reserved so they
+ *      always come from `unit-economics.json` (D2/D5).
+ *   3. Filling remaining gaps with the family-scoped LLM field-writer (D4),
+ *      grounded on the agent evidence.
+ *
+ * Never throws. Agent / LLM failures degrade gracefully (D8); the caller turns
+ * an empty/under-filled result into the existing skeleton.
+ */
+import type { DeliverableSpec } from './deliverables-registry.js';
+export type FieldProvenance = 'agent' | 'artifact' | 'slug' | 'llm';
+export interface AgentCallRecord {
+    /** `domain/agent` reference. */
+    readonly ref: string;
+    readonly status: number;
+    readonly tier?: string;
+}
+export interface WriterResult {
+    readonly slug: string;
+    readonly templateId: string;
+    /** Resolved placeholder → value (non-reserved fields the writer produced). */
+    readonly fields: Record<string, string>;
+    /** Per-field source for the values in `fields`. */
+    readonly field_provenance: Record<string, FieldProvenance>;
+    /** Placeholders left unfilled after all tiers (will render as `_TBD_`). */
+    readonly unfilled: string[];
+    /** Agents actually invoked this row and their status (D7). */
+    readonly agents_called: AgentCallRecord[];
+}
+export interface WriterContext {
+    readonly scenarioQuery: string;
+    readonly runDir: string;
+    readonly traceId: string;
+    /** Deterministic fields from run-artifact extraction (artifact tier). */
+    readonly artifactFields: Readonly<Record<string, string>>;
+    /** Deterministic fields derived from the slug (slug tier). */
+    readonly slugFields: Readonly<Record<string, string>>;
+    /**
+     * Reserved fields that ALWAYS win (financial fcv values, title, date,
+     * consensusBanner, fcvBlock, attribution). Never overridden by agent/LLM —
+     * this is the D5 coherence guarantee. Keys present here are excluded from
+     * agent/LLM filling.
+     */
+    readonly reservedFields: Readonly<Record<string, string>>;
+    /** Canonical financial figures the LLM may cite verbatim (the fcv block). */
+    readonly canonicalFigures: string;
+    /** D3 toggle — false skips agent dispatch (AGENTICS_PHASE7_NO_AGENTS=1). */
+    readonly enableAgents: boolean;
+    /** D4 toggle — false skips the LLM field-writer (AGENTICS_PHASE7_NO_LLM=1). */
+    readonly enableLLM: boolean;
+}
+/** Cached agent output for the current run, keyed by `domain/agent`. */
+export interface CachedAgentOutput {
+    readonly status: number;
+    readonly tier?: string;
+    readonly data: unknown;
+}
+export type AgentOutputCache = Map<string, CachedAgentOutput>;
+/** Signature of the dispatch function (injectable for tests). */
+export type AgentDispatch = (domain: string, agent: string, payload: Record<string, unknown>) => Promise<{
+    status: number;
+    tier?: string;
+    data: unknown;
+}>;
+/**
+ * Generate the field map for one deliverable. Pure orchestration over the
+ * three tiers; the renderer remains the single place that turns fields into
+ * Markdown (determinism preserved).
+ */
+export declare function generateDeliverableFields(spec: DeliverableSpec, templateBody: string, ctx: WriterContext, agentCache: AgentOutputCache, dispatch?: AgentDispatch): Promise<WriterResult>;
+//# sourceMappingURL=writer-agent.d.ts.map

package/dist/pipeline/phase7/writer-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-agent.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase7/writer-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3D,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,eAAe,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AACD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE9D,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE/D;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC,CAsFvB"}