@llm-dev-ops/agentics-cli 2.7.17 → 2.7.19

package/dist/pipeline/phase7/coherence-gate.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ADR-PIPELINE-098 D8 — Coherence Gate.
+ *
+ * Post-render financial validator. Walks the deliverables directory, scans
+ * every emitted file for `<!-- fcv:kind=... -->` provenance tags, and
+ * compares the value that follows each tag against the canonical value held
+ * in `unit-economics.json` (per ADR-PIPELINE-066 — the single financial
+ * source of truth).
+ *
+ * Tolerance: ±5% by default. Range tokens like `$22.1M – $30.9M` pass when
+ * the canonical falls inside the range OR the range midpoint is within
+ * tolerance of the canonical.
+ *
+ * The gate is a pure reporter: it does NOT decide phase status. The Phase 7
+ * coordinator inspects the violation list and downgrades to `partial` when
+ * appropriate (per D8). Coherence violations are non-fatal.
+ *
+ * Implementation notes:
+ *  - File discovery is a manual recursive walk over `node:fs` — `fast-glob`
+ *    is not a project dependency and pulling one in just for this gate is
+ *    avoided.
+ *  - File read errors are non-fatal: the offending file is skipped (not
+ *    counted in `files_scanned`), but the gate continues.
+ *  - The unit-economics manifest schema is permissive: only the fields that
+ *    are actually present feed the canonical map. Kinds the manifest does
+ *    not carry are skipped silently rather than reported as violations
+ *    (the canonical value is unknown, not wrong).
+ */
+export type CoherenceKind = 'investment' | 'savings' | 'npv' | 'roi' | 'payback' | 'timeline';
+export interface CoherenceViolation {
+    readonly slug: string;
+    readonly section: number;
+    readonly kind: CoherenceKind;
+    readonly expected: string;
+    readonly got: string;
+    readonly delta_pct: number;
+    readonly path: string;
+}
+export interface CoherenceReport {
+    readonly violations: ReadonlyArray<CoherenceViolation>;
+    readonly files_scanned: number;
+    readonly fcv_tags_total: number;
+    readonly tolerance_pct: number;
+}
+export interface CoherenceGateOptions {
+    /** Default ±5%. Applied symmetrically around the canonical value. */
+    readonly tolerancePct?: number;
+}
+/**
+ * Parse a single dollar token like `$22.1M`, `$500K`, `$1,200,000`.
+ * Returns null on failure — callers decide whether absence is a violation.
+ */
+export declare function parseDollarToBase(s: string): number | null;
+/**
+ * Parse a duration token like `5 months`, `1.5 years`, `12-week` and
+ * normalize to months. Years/weeks are converted at standard ratios
+ * (1 yr = 12 mo, 1 wk = 12/52 mo ≈ 0.231 mo).
+ */
+export declare function parseDurationToMonths(s: string): number | null;
+/**
+ * Run the coherence gate over a deliverables directory.
+ *
+ * Walks `<deliverablesDir>` recursively, scans every `*.md` / `*.json` /
+ * `*.csv` for fcv tags, extracts the value following each tag, and compares
+ * against the canonical from `unitEconomicsPath`. Returns a report — never
+ * throws; all errors are absorbed (unreadable files are skipped, invalid
+ * JSON in unit-economics yields an empty canonical map and the gate emits
+ * zero violations).
+ */
+export declare function runCoherenceGate(deliverablesDir: string, unitEconomicsPath: string, options?: CoherenceGateOptions): Promise<CoherenceReport>;
+//# sourceMappingURL=coherence-gate.d.ts.map

package/dist/pipeline/phase7/coherence-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coherence-gate.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase7/coherence-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,SAAS,GACT,KAAK,GACL,KAAK,GACL,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAmND;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB1D;AAgBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAiOD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAqE1B"}

package/dist/pipeline/phase7/coherence-gate.js

@@ -0,0 +1,541 @@
+/**
+ * ADR-PIPELINE-098 D8 — Coherence Gate.
+ *
+ * Post-render financial validator. Walks the deliverables directory, scans
+ * every emitted file for `<!-- fcv:kind=... -->` provenance tags, and
+ * compares the value that follows each tag against the canonical value held
+ * in `unit-economics.json` (per ADR-PIPELINE-066 — the single financial
+ * source of truth).
+ *
+ * Tolerance: ±5% by default. Range tokens like `$22.1M – $30.9M` pass when
+ * the canonical falls inside the range OR the range midpoint is within
+ * tolerance of the canonical.
+ *
+ * The gate is a pure reporter: it does NOT decide phase status. The Phase 7
+ * coordinator inspects the violation list and downgrades to `partial` when
+ * appropriate (per D8). Coherence violations are non-fatal.
+ *
+ * Implementation notes:
+ *  - File discovery is a manual recursive walk over `node:fs` — `fast-glob`
+ *    is not a project dependency and pulling one in just for this gate is
+ *    avoided.
+ *  - File read errors are non-fatal: the offending file is skipped (not
+ *    counted in `files_scanned`), but the gate continues.
+ *  - The unit-economics manifest schema is permissive: only the fields that
+ *    are actually present feed the canonical map. Kinds the manifest does
+ *    not carry are skipped silently rather than reported as violations
+ *    (the canonical value is unknown, not wrong).
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+// ============================================================================
+// File discovery
+// ============================================================================
+const SUPPORTED_EXT = new Set(['.md', '.json', '.csv']);
+async function walkFiles(root) {
+    const out = [];
+    async function visit(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return; // unreadable dir is non-fatal
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isSymbolicLink()) {
+                // Resolve the symlink target and decide based on its kind. Mirror
+                // entries (D6) are symlinks to top-level docs; we still want to
+                // scan them.
+                try {
+                    const stat = await fs.stat(full);
+                    if (stat.isFile() && SUPPORTED_EXT.has(path.extname(full).toLowerCase())) {
+                        out.push(full);
+                    }
+                    else if (stat.isDirectory()) {
+                        await visit(full);
+                    }
+                }
+                catch {
+                    // dangling symlink — skip
+                }
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await visit(full);
+                continue;
+            }
+            if (entry.isFile() && SUPPORTED_EXT.has(path.extname(entry.name).toLowerCase())) {
+                out.push(full);
+            }
+        }
+    }
+    await visit(root);
+    return out;
+}
+// ============================================================================
+// Section / slug derivation
+// ============================================================================
+/**
+ * Phase 7 lays files out as `<runDir>/deliverables/<NN-section>/<slug>.<ext>`.
+ * The leading two-digit prefix on the parent directory is the section
+ * number. Files outside this layout (e.g. `index.md`, `phase7-manifest.json`)
+ * are still scanned, but reported with `section: 0`.
+ */
+function deriveSlugAndSection(absPath, root) {
+    const rel = path.relative(root, absPath);
+    const parts = rel.split(path.sep);
+    const ext = path.extname(absPath);
+    const slug = path.basename(absPath, ext);
+    // First directory under root: e.g. `01-executive` → section 1.
+    if (parts.length >= 2) {
+        const dir = parts[0];
+        const m = dir.match(/^(\d{1,2})-/);
+        if (m && m[1]) {
+            const n = Number.parseInt(m[1], 10);
+            if (Number.isFinite(n) && n >= 1 && n <= 12) {
+                return { slug, section: n };
+            }
+        }
+    }
+    return { slug, section: 0 };
+}
+// ============================================================================
+// Tag scanner
+// ============================================================================
+const FCV_TAG_RE = /<!--\s*fcv:([^>]+?)\s*-->/g;
+/**
+ * Parse a single fcv tag's attribute string (the bit between `fcv:` and
+ * the closing `-->`). Only `kind=` is significant for the gate — `scope`,
+ * `doc`, `src` are recorded by the renderer but not used here.
+ */
+function parseTagAttrs(attrs) {
+    let kind = null;
+    for (const pair of attrs.split(/\s+/)) {
+        const eq = pair.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = pair.slice(0, eq).trim();
+        const val = pair.slice(eq + 1).trim();
+        if (key === 'kind')
+            kind = val;
+    }
+    // Kind aliasing: keep the canonical set narrow but accept renderer-side
+    // synonyms. `revenueImpact` → `savings`, `paybackPeriod` → `payback`.
+    // The exec-summary uses `timeline` for payback figures; we keep that as
+    // its own kind so range/duration parsing can split, then alias to
+    // `payback` for the canonical-value lookup later.
+    if (!kind)
+        return { kind: null };
+    const lower = kind.toLowerCase();
+    if (lower === 'revenueimpact' || lower === 'revenue-impact' || lower === 'cost-savings' || lower === 'costsavings') {
+        return { kind: 'savings' };
+    }
+    if (lower === 'paybackperiod' || lower === 'payback-period') {
+        return { kind: 'payback' };
+    }
+    if (lower === 'investment' ||
+        lower === 'savings' ||
+        lower === 'npv' ||
+        lower === 'roi' ||
+        lower === 'payback' ||
+        lower === 'timeline') {
+        return { kind: lower };
+    }
+    return { kind: null };
+}
+function scanTags(body) {
+    const out = [];
+    for (const m of body.matchAll(FCV_TAG_RE)) {
+        const attrs = m[1] ?? '';
+        const tailIndex = (m.index ?? 0) + m[0].length;
+        const { kind } = parseTagAttrs(attrs);
+        out.push({ kind, tailIndex });
+    }
+    return out;
+}
+// ============================================================================
+// Value extraction (the token immediately following a tag)
+// ============================================================================
+/**
+ * Scan up to ~200 chars after a tag for the next dollar-or-duration token.
+ * This window comfortably covers the patterns observed in exec-summary:
+ *   `<!-- ... --> $22.1M – $30.9M (Bottom-up unit economics ...)`
+ *   `<!-- ... --> 5 months (break-even ...)`
+ *   `<!-- ... --> 250% projected ($55.3M annual savings ...)`
+ *
+ * For ROI we want the percent token, not the trailing `$X.YM`. The kind
+ * dictates which extractor runs.
+ */
+const VALUE_WINDOW = 240;
+function extractValueText(body, fromIndex, kind) {
+    const window = body.slice(fromIndex, fromIndex + VALUE_WINDOW);
+    // Trim leading whitespace / pipe (table cells) / colon.
+    const trimmed = window.replace(/^[\s:|]+/, '');
+    if (trimmed.length === 0)
+        return null;
+    if (kind === 'roi') {
+        const m = trimmed.match(/^(\d+(?:\.\d+)?)\s*%/);
+        if (m)
+            return `${m[1]}%`;
+        // Some renderers print `ROI: 250% projected`. If the value isn't first,
+        // fall through to a broader scan.
+        const broad = trimmed.match(/(\d+(?:\.\d+)?)\s*%/);
+        if (broad)
+            return `${broad[1]}%`;
+        return null;
+    }
+    if (kind === 'payback' || kind === 'timeline') {
+        // Duration tokens: "5 months", "0.7 year(s)", "3-month", "18-week".
+        const m = trimmed.match(/^(\d+(?:\.\d+)?)[\s-]?(months?|years?|weeks?)\b/i);
+        if (m)
+            return `${m[1]} ${m[2].toLowerCase()}`;
+        // Some payback cells lead with a dollar token (the cumulative-savings
+        // breakeven). Fall through to dollar extraction so the gate still
+        // produces a comparable number.
+        return extractDollarToken(trimmed);
+    }
+    // investment / savings / npv → dollar token (point or range)
+    return extractDollarToken(trimmed);
+}
+function extractDollarToken(s) {
+    // Range: `$22.1M – $30.9M`, `$22.1M-$30.9M`, `$22.1M to $30.9M`.
+    const range = s.match(/^\$\s*[\d,]+(?:\.\d+)?\s*[KMB]?\s*(?:[-–—]|to)\s*\$?\s*[\d,]+(?:\.\d+)?\s*[KMB]?/i);
+    if (range)
+        return range[0].trim();
+    // Point: `$22.1M`, `$1,200,000`, `$500K`.
+    const point = s.match(/^\$\s*[\d,]+(?:\.\d+)?\s*[KMB]?/i);
+    if (point)
+        return point[0].trim();
+    return null;
+}
+// ============================================================================
+// Numeric parsers
+// ============================================================================
+const SUFFIX_MULT = {
+    K: 1_000,
+    M: 1_000_000,
+    B: 1_000_000_000,
+};
+/**
+ * Parse a single dollar token like `$22.1M`, `$500K`, `$1,200,000`.
+ * Returns null on failure — callers decide whether absence is a violation.
+ */
+export function parseDollarToBase(s) {
+    const cleaned = s.trim().replace(/^\$/, '').replace(/\s+/g, '');
+    if (cleaned.length === 0)
+        return null;
+    const suffixMatch = cleaned.match(/^([\d,]+(?:\.\d+)?)([KMB])$/i);
+    if (suffixMatch) {
+        const num = Number.parseFloat(suffixMatch[1].replace(/,/g, ''));
+        const mult = SUFFIX_MULT[suffixMatch[2].toUpperCase()] ?? 1;
+        if (Number.isFinite(num))
+            return num * mult;
+        return null;
+    }
+    const plainMatch = cleaned.match(/^([\d,]+(?:\.\d+)?)$/);
+    if (plainMatch) {
+        const num = Number.parseFloat(plainMatch[1].replace(/,/g, ''));
+        if (Number.isFinite(num))
+            return num;
+    }
+    return null;
+}
+function parseDollarRange(s) {
+    const parts = s.split(/\s*(?:[-–—]|\bto\b)\s*/i);
+    if (parts.length !== 2)
+        return null;
+    const a = parseDollarToBase(parts[0]);
+    const b = parseDollarToBase(parts[1]);
+    if (a === null || b === null)
+        return null;
+    return { low: Math.min(a, b), high: Math.max(a, b) };
+}
+/**
+ * Parse a duration token like `5 months`, `1.5 years`, `12-week` and
+ * normalize to months. Years/weeks are converted at standard ratios
+ * (1 yr = 12 mo, 1 wk = 12/52 mo ≈ 0.231 mo).
+ */
+export function parseDurationToMonths(s) {
+    const m = s.trim().match(/^(\d+(?:\.\d+)?)[\s-]?(months?|years?|weeks?)\b/i);
+    if (!m)
+        return null;
+    const n = Number.parseFloat(m[1]);
+    if (!Number.isFinite(n))
+        return null;
+    const unit = m[2].toLowerCase();
+    if (unit.startsWith('month'))
+        return n;
+    if (unit.startsWith('year'))
+        return n * 12;
+    if (unit.startsWith('week'))
+        return (n * 12) / 52;
+    return null;
+}
+/**
+ * Best-effort canonical-value extractor for the unit-economics manifest.
+ *
+ * The manifest schema (ADR-PIPELINE-066) encodes savings directly but
+ * derives investment / NPV / ROI / payback at render time. To keep the
+ * gate self-contained we re-derive the same numbers here using the same
+ * rule-of-thumb the renderer uses (40% of enterprise savings as
+ * implementation cost, NPV = enterprise × 3.5 − impl, payback months =
+ * impl / enterprise × 12, ROI = enterprise / impl × 100).
+ *
+ * If the manifest carries explicit fields (`pilot_investment`,
+ * `enterprise_investment`, `payback_months`, `npv_5yr`, `roi_pct`) those
+ * take precedence over the derivation. This makes the gate forward-compatible
+ * with future schema extensions without breaking on today's manifests.
+ */
+async function loadCanonical(unitEconomicsPath) {
+    const display = {
+        investment: undefined,
+        savings: undefined,
+        npv: undefined,
+        roi: undefined,
+        payback: undefined,
+        timeline: undefined,
+    };
+    let raw;
+    try {
+        raw = await fs.readFile(unitEconomicsPath, 'utf-8');
+    }
+    catch {
+        return { display };
+    }
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch {
+        return { display };
+    }
+    if (!isRecord(json))
+        return { display };
+    // ----- direct fields (may or may not be present) -----
+    const directInvestment = pickNumber(json, 'enterprise_investment') ?? pickNumber(json, 'pilot_investment');
+    const directSavings = pickNumber(json, 'enterprise_savings_per_year') ??
+        pickNumber(json, 'pilot_savings_per_year') ??
+        pickNumber(json, 'annual_extrapolated_savings_usd') ??
+        pickNumber(json, 'annual_measured_savings_usd');
+    const directNpv = pickNumber(json, 'npv_5yr');
+    const directRoi = pickNumber(json, 'roi_pct');
+    const directPayback = pickNumber(json, 'payback_months');
+    // ----- derive missing fields from annual_extrapolated_savings_usd -----
+    const enterpriseSavings = pickNumber(json, 'annual_extrapolated_savings_usd');
+    const measuredSavings = pickNumber(json, 'annual_measured_savings_usd');
+    const baseSavings = enterpriseSavings ?? measuredSavings;
+    let investmentUsd = directInvestment;
+    let savingsUsd = directSavings;
+    let npvUsd = directNpv;
+    let roiPct = directRoi;
+    let paybackMonths = directPayback;
+    if (savingsUsd === undefined && baseSavings !== undefined) {
+        savingsUsd = baseSavings;
+    }
+    if (baseSavings !== undefined && baseSavings > 0) {
+        const derivedImpl = Math.max(500_000, Math.round(baseSavings * 0.4));
+        if (investmentUsd === undefined)
+            investmentUsd = derivedImpl;
+        if (npvUsd === undefined)
+            npvUsd = Math.round(baseSavings * 3.5 - derivedImpl);
+        if (roiPct === undefined)
+            roiPct = Math.round((baseSavings / derivedImpl) * 100);
+        if (paybackMonths === undefined) {
+            paybackMonths = Math.max(3, Math.min(36, Math.round((derivedImpl / baseSavings) * 12)));
+        }
+    }
+    if (investmentUsd !== undefined)
+        display.investment = formatMoney(investmentUsd);
+    if (savingsUsd !== undefined)
+        display.savings = formatMoney(savingsUsd);
+    if (npvUsd !== undefined)
+        display.npv = formatMoney(npvUsd);
+    if (roiPct !== undefined)
+        display.roi = `${roiPct}%`;
+    if (paybackMonths !== undefined) {
+        const txt = `${paybackMonths} months`;
+        display.payback = txt;
+        display.timeline = txt;
+    }
+    return {
+        ...(investmentUsd !== undefined ? { investmentUsd } : {}),
+        ...(savingsUsd !== undefined ? { savingsUsd } : {}),
+        ...(npvUsd !== undefined ? { npvUsd } : {}),
+        ...(roiPct !== undefined ? { roiPct } : {}),
+        ...(paybackMonths !== undefined ? { paybackMonths } : {}),
+        display,
+    };
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function pickNumber(obj, key) {
+    const v = obj[key];
+    return typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+}
+function formatMoney(n) {
+    if (!Number.isFinite(n))
+        return '$0';
+    const abs = Math.abs(n);
+    if (abs >= 1_000_000)
+        return `$${(n / 1_000_000).toFixed(1)}M`;
+    if (abs >= 1_000)
+        return `$${(n / 1_000).toFixed(0)}K`;
+    return `$${Math.round(n)}`;
+}
+function canonicalFor(kind, c) {
+    switch (kind) {
+        case 'investment':
+            if (c.investmentUsd === undefined)
+                return null;
+            return { numeric: c.investmentUsd, display: c.display.investment, unit: 'usd' };
+        case 'savings':
+            if (c.savingsUsd === undefined)
+                return null;
+            return { numeric: c.savingsUsd, display: c.display.savings, unit: 'usd' };
+        case 'npv':
+            if (c.npvUsd === undefined)
+                return null;
+            return { numeric: c.npvUsd, display: c.display.npv, unit: 'usd' };
+        case 'roi':
+            if (c.roiPct === undefined)
+                return null;
+            return { numeric: c.roiPct, display: c.display.roi, unit: 'percent' };
+        case 'payback':
+        case 'timeline':
+            if (c.paybackMonths === undefined)
+                return null;
+            return { numeric: c.paybackMonths, display: c.display.payback, unit: 'months' };
+    }
+}
+function compareValues(got, canon, tolerancePct) {
+    if (canon.numeric === undefined) {
+        return { inTolerance: true, deltaPct: 0, nonNumeric: true };
+    }
+    // Try numeric parse based on the canonical unit.
+    let gotNum = null;
+    let gotRange = null;
+    if (canon.unit === 'usd') {
+        gotRange = parseDollarRange(got);
+        if (gotRange === null)
+            gotNum = parseDollarToBase(got);
+    }
+    else if (canon.unit === 'months') {
+        gotNum = parseDurationToMonths(got);
+    }
+    else if (canon.unit === 'percent') {
+        const m = got.match(/(-?\d+(?:\.\d+)?)\s*%/);
+        if (m)
+            gotNum = Number.parseFloat(m[1]);
+    }
+    if (gotRange) {
+        // Range passes when canonical falls in the range OR midpoint is within
+        // tolerance.
+        const inRange = canon.numeric >= gotRange.low && canon.numeric <= gotRange.high;
+        if (inRange) {
+            return { inTolerance: true, deltaPct: 0, nonNumeric: false };
+        }
+        const mid = (gotRange.low + gotRange.high) / 2;
+        const delta = pctDelta(mid, canon.numeric);
+        return { inTolerance: delta <= tolerancePct, deltaPct: delta, nonNumeric: false };
+    }
+    if (gotNum === null) {
+        // Couldn't parse — non-numeric mismatch (the deliverable said something
+        // we couldn't compare; flag it so a human can review).
+        return { inTolerance: false, deltaPct: -1, nonNumeric: true };
+    }
+    const delta = pctDelta(gotNum, canon.numeric);
+    return { inTolerance: delta <= tolerancePct, deltaPct: delta, nonNumeric: false };
+}
+function pctDelta(got, canonical) {
+    if (canonical === 0) {
+        return got === 0 ? 0 : Number.POSITIVE_INFINITY;
+    }
+    return Math.abs((got - canonical) / canonical) * 100;
+}
+// ============================================================================
+// Entry point
+// ============================================================================
+/**
+ * Run the coherence gate over a deliverables directory.
+ *
+ * Walks `<deliverablesDir>` recursively, scans every `*.md` / `*.json` /
+ * `*.csv` for fcv tags, extracts the value following each tag, and compares
+ * against the canonical from `unitEconomicsPath`. Returns a report — never
+ * throws; all errors are absorbed (unreadable files are skipped, invalid
+ * JSON in unit-economics yields an empty canonical map and the gate emits
+ * zero violations).
+ */
+export async function runCoherenceGate(deliverablesDir, unitEconomicsPath, options) {
+    const tolerancePct = options?.tolerancePct !== undefined && options.tolerancePct >= 0
+        ? options.tolerancePct
+        : 5;
+    const canonical = await loadCanonical(unitEconomicsPath);
+    let files;
+    try {
+        files = await walkFiles(deliverablesDir);
+    }
+    catch {
+        return {
+            violations: [],
+            files_scanned: 0,
+            fcv_tags_total: 0,
+            tolerance_pct: tolerancePct,
+        };
+    }
+    const violations = [];
+    let filesScanned = 0;
+    let fcvTagsTotal = 0;
+    for (const file of files) {
+        let body;
+        try {
+            body = await fs.readFile(file, 'utf-8');
+        }
+        catch {
+            // file errors are non-fatal and don't increment files_scanned
+            continue;
+        }
+        filesScanned += 1;
+        const tags = scanTags(body);
+        fcvTagsTotal += tags.length;
+        if (tags.length === 0)
+            continue;
+        const { slug, section } = deriveSlugAndSection(file, deliverablesDir);
+        for (const tag of tags) {
+            if (tag.kind === null)
+                continue; // unrecognized kind — not validated
+            const canon = canonicalFor(tag.kind, canonical);
+            if (canon === null)
+                continue; // canonical not present for this kind
+            const valueText = extractValueText(body, tag.tailIndex, tag.kind);
+            if (valueText === null)
+                continue; // no value to compare — silent skip
+            const cmp = compareValues(valueText, canon, tolerancePct);
+            if (cmp.inTolerance)
+                continue;
+            violations.push({
+                slug,
+                section,
+                kind: tag.kind,
+                expected: canon.display ?? String(canon.numeric),
+                got: valueText,
+                delta_pct: cmp.nonNumeric ? -1 : roundDelta(cmp.deltaPct),
+                path: path.resolve(file),
+            });
+        }
+    }
+    return {
+        violations,
+        files_scanned: filesScanned,
+        fcv_tags_total: fcvTagsTotal,
+        tolerance_pct: tolerancePct,
+    };
+}
+function roundDelta(n) {
+    if (!Number.isFinite(n))
+        return n;
+    return Math.round(n * 10) / 10;
+}
+//# sourceMappingURL=coherence-gate.js.map

package/dist/pipeline/phase7/coherence-gate.js.map

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