@llm-dev-ops/agentics-cli 2.3.0 → 2.4.0

package/dist/pipeline/phase4-5-pre-render/pre-render-coordinator.js

@@ -0,0 +1,105 @@
+/**
+ * ADR-PIPELINE-072 §1 — Pre-Render Analysis Pass coordinator.
+ *
+ * Orchestrates:
+ *   1. Classify sector from query + domain analysis
+ *   2. Compute bottom-up unit economics via `computePreRenderUnitEconomics`
+ *   3. Write `<runDir>/unit-economics.json` with `source='prototype-preview'`
+ *
+ * Runs BEFORE `renderExecutiveSummary`, `renderDecisionMemo`, and
+ * `renderFinancialAnalysis` so the ADR-066 tier-1 manifest path fires on
+ * every run.
+ *
+ * The module is purely additive: if it fails (unknown sector, I/O error,
+ * schema validation) the renderers fall back to ADR-066 tier-3 heuristic +
+ * mandatory warning banner — which is the exact behavior before this ADR.
+ * Never blocks the pipeline.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { UnitEconomicsSchema } from '../types.js';
+import { computePreRenderUnitEconomics, } from './financial-model.js';
+/**
+ * Run the pre-render pass. Never throws. Returns an `emitted` result on
+ * success or a `skipped` result with a reason when the pass can't produce
+ * a preview manifest.
+ */
+export function executePreRender(input) {
+    const manifestPath = path.join(input.runDir, 'unit-economics.json');
+    // If a prototype-sourced manifest already exists at this path (e.g. the
+    // user re-ran the pipeline and an earlier prototype demo landed a real
+    // manifest in the same runDir), leave it alone. Pre-render never
+    // overwrites a real prototype manifest.
+    if (existingPrototypeManifest(manifestPath)) {
+        return {
+            status: 'skipped',
+            reason: 'existing-prototype-manifest',
+            detail: 'A prototype-sourced unit-economics.json already exists; pre-render left it untouched.',
+        };
+    }
+    const sectorHint = input.domainAnalysis?.domain ?? null;
+    const financial = computePreRenderUnitEconomics({
+        runId: input.runId,
+        query: input.query,
+        sectorHint,
+    });
+    if (!financial) {
+        return {
+            status: 'skipped',
+            reason: 'unknown-sector',
+            detail: 'classifySector returned "unknown" — no ADR-066 registry entry.',
+        };
+    }
+    const parsed = UnitEconomicsSchema.safeParse(financial.manifest);
+    if (!parsed.success) {
+        return {
+            status: 'skipped',
+            reason: 'schema-rejected',
+            detail: parsed.error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join('; '),
+        };
+    }
+    try {
+        fs.mkdirSync(input.runDir, { recursive: true });
+        fs.writeFileSync(manifestPath, JSON.stringify(parsed.data, null, 2) + '\n', 'utf-8');
+    }
+    catch (err) {
+        return {
+            status: 'skipped',
+            reason: 'io-error',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    return {
+        status: 'emitted',
+        manifestPath,
+        manifest: parsed.data,
+        metrics: financial.metrics,
+    };
+}
+function existingPrototypeManifest(manifestPath) {
+    if (!fs.existsSync(manifestPath))
+        return false;
+    try {
+        const raw = fs.readFileSync(manifestPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return parsed['source'] === 'prototype';
+    }
+    catch {
+        // Corrupt file — pre-render will overwrite it
+        return false;
+    }
+}
+// Exported for tests + reconciler module.
+export function readManifestIfExists(manifestPath) {
+    if (!fs.existsSync(manifestPath))
+        return null;
+    try {
+        const raw = fs.readFileSync(manifestPath, 'utf-8');
+        const parsed = UnitEconomicsSchema.safeParse(JSON.parse(raw));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pre-render-coordinator.js.map

package/dist/pipeline/phase4-5-pre-render/pre-render-coordinator.js.map

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

package/dist/pipeline/phase4-5-pre-render/sector-baselines.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ADR-PIPELINE-072 §6: Sector baseline waste / unit-cost / achievable-reduction
+ * table. Consumed by the pre-render financial model to produce an initial
+ * `unit-economics.json` BEFORE the prototype runs, so the ADR-066 tier-1
+ * renderer path fires on the executive summary / decision memo / financial
+ * analysis instead of falling to the per-employee heuristic.
+ *
+ * Numbers are conservative industry rules-of-thumb. The prototype is expected
+ * to produce a more accurate manifest when its demo runs, and the ADR-072 §5
+ * reconciler emits a warning on any drift >25%.
+ *
+ * Every entry must correspond to an entry in the ADR-066 sector registry
+ * (`src/synthesis/domain-unit-registry.ts`). The integration test in
+ * `tests/unit/pipeline/pre-render/sector-baselines-072.test.ts` enforces the
+ * lockstep invariant.
+ */
+import type { Sector } from '../../synthesis/domain-unit-registry.js';
+export interface SectorBaseline {
+    /** Sector key — must match the ADR-066 registry. */
+    readonly sector: Exclude<Sector, 'unknown'>;
+    /** Human-readable label for the operational unit. */
+    readonly unitLabel: string;
+    /** Savings key (must match the registry's unitSavingsKey). */
+    readonly unitSavingsKey: string;
+    /** USD saved per operational unit per year, at baseline achievable reduction. */
+    readonly usdPerUnitPerYear: number;
+    /** Baseline waste rate (0..1) — what fraction of the unit cost is wasted today. */
+    readonly baselineWasteRate: number;
+    /** Achievable reduction (0..1) — what fraction of the waste can reasonably be eliminated. */
+    readonly achievableReduction: number;
+    /** Methodology string displayed in the rendered financial analysis. */
+    readonly methodology: string;
+    /** Short description of the unit cost basis (rooms × occupancy, etc.). */
+    readonly unitCostBasis: string;
+}
+/**
+ * ADR-PIPELINE-072 §6 — baseline table. Conservative industry rules-of-thumb.
+ * The prototype's measured numbers will overwrite these during the real demo.
+ */
+export declare const SECTOR_BASELINES: readonly SectorBaseline[];
+export declare function getSectorBaseline(sector: Sector): SectorBaseline | null;
+//# sourceMappingURL=sector-baselines.d.ts.map

package/dist/pipeline/phase4-5-pre-render/sector-baselines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sector-baselines.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4-5-pre-render/sector-baselines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6FAA6F;IAC7F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EA2FrD,CAAC;AAMF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEvE"}

package/dist/pipeline/phase4-5-pre-render/sector-baselines.js

@@ -0,0 +1,117 @@
+/**
+ * ADR-PIPELINE-072 §6: Sector baseline waste / unit-cost / achievable-reduction
+ * table. Consumed by the pre-render financial model to produce an initial
+ * `unit-economics.json` BEFORE the prototype runs, so the ADR-066 tier-1
+ * renderer path fires on the executive summary / decision memo / financial
+ * analysis instead of falling to the per-employee heuristic.
+ *
+ * Numbers are conservative industry rules-of-thumb. The prototype is expected
+ * to produce a more accurate manifest when its demo runs, and the ADR-072 §5
+ * reconciler emits a warning on any drift >25%.
+ *
+ * Every entry must correspond to an entry in the ADR-066 sector registry
+ * (`src/synthesis/domain-unit-registry.ts`). The integration test in
+ * `tests/unit/pipeline/pre-render/sector-baselines-072.test.ts` enforces the
+ * lockstep invariant.
+ */
+/**
+ * ADR-PIPELINE-072 §6 — baseline table. Conservative industry rules-of-thumb.
+ * The prototype's measured numbers will overwrite these during the real demo.
+ */
+export const SECTOR_BASELINES = [
+    {
+        sector: 'hospitality',
+        unitLabel: 'occupied room night',
+        unitSavingsKey: 'usd_per_orn',
+        usdPerUnitPerYear: 0.82,
+        baselineWasteRate: 0.32,
+        achievableReduction: 0.18,
+        methodology: 'rooms × occupancy × $/occupied-room-night linen + water reduction',
+        unitCostBasis: '0.32 kg linen/orn × $2.10/kg laundry',
+    },
+    {
+        sector: 'airline-catering',
+        unitLabel: 'meal loaded',
+        unitSavingsKey: 'usd_per_meal_loaded',
+        usdPerUnitPerYear: 0.92,
+        baselineWasteRate: 0.18,
+        achievableReduction: 0.22,
+        methodology: 'meals × flights × 365 × $/meal-loaded waste reduction',
+        unitCostBasis: '0.18 kg/meal × $4.20/meal loaded (loaded-to-consumed gap)',
+    },
+    {
+        sector: 'commercial-real-estate',
+        unitLabel: 'square foot-year',
+        unitSavingsKey: 'usd_per_sqft_year',
+        usdPerUnitPerYear: 0.25,
+        baselineWasteRate: 0.20,
+        achievableReduction: 0.15,
+        methodology: 'sqft × $/sqft-year energy + HVAC reduction',
+        unitCostBasis: '12 kWh/sqft-year × $0.14/kWh',
+    },
+    {
+        sector: 'fleet',
+        unitLabel: 'vehicle-mile',
+        unitSavingsKey: 'usd_per_vehicle_mile',
+        usdPerUnitPerYear: 0.28,
+        baselineWasteRate: 0.20,
+        achievableReduction: 0.12,
+        methodology: 'fleet × miles × $/mile fuel + maintenance reduction',
+        unitCostBasis: '0.65 gal/vehicle-mile × $3.80/gal',
+    },
+    {
+        sector: 'retail',
+        unitLabel: 'store-year',
+        unitSavingsKey: 'usd_per_transaction',
+        usdPerUnitPerYear: 14250,
+        baselineWasteRate: 0.30,
+        achievableReduction: 0.15,
+        methodology: 'stores × $95K/yr energy × achievable reduction',
+        unitCostBasis: '$95K/store/yr energy × 15% reduction ceiling',
+    },
+    {
+        sector: 'manufacturing',
+        unitLabel: 'unit produced',
+        unitSavingsKey: 'usd_per_unit_produced',
+        usdPerUnitPerYear: 0.85,
+        baselineWasteRate: 0.023,
+        achievableReduction: 0.25,
+        methodology: 'throughput × $/unit scrap reduction',
+        unitCostBasis: '2.3% scrap rate × $/unit',
+    },
+    {
+        sector: 'healthcare',
+        unitLabel: 'patient-day',
+        unitSavingsKey: 'usd_per_patient_day',
+        usdPerUnitPerYear: 0.22,
+        baselineWasteRate: 0.18,
+        achievableReduction: 0.20,
+        methodology: 'census × $/patient-day disposal + material reduction',
+        unitCostBasis: '0.8 kg waste/patient-day × $1.40/kg disposal',
+    },
+    {
+        sector: 'data-center',
+        unitLabel: 'kilowatt-hour',
+        unitSavingsKey: 'usd_per_kwh',
+        usdPerUnitPerYear: 0.018,
+        baselineWasteRate: 0.23,
+        achievableReduction: 0.18,
+        methodology: 'load × 8760 × $/kWh PUE optimization',
+        unitCostBasis: 'PUE 1.6 → 1.3 opportunity × $0.08/kWh',
+    },
+    {
+        sector: 'call-center',
+        unitLabel: 'contact minute',
+        unitSavingsKey: 'usd_per_contact_minute',
+        usdPerUnitPerYear: 0.09,
+        baselineWasteRate: 0.12,
+        achievableReduction: 0.14,
+        methodology: 'agents × shifts × $/contact-minute overstaffing reduction',
+        unitCostBasis: '12% overstaffing × $38/hr loaded',
+    },
+];
+const BASELINE_BY_SECTOR = new Map(SECTOR_BASELINES.map(b => [b.sector, b]));
+export function getSectorBaseline(sector) {
+    return BASELINE_BY_SECTOR.get(sector) ?? null;
+}
+//# sourceMappingURL=sector-baselines.js.map

package/dist/pipeline/phase4-5-pre-render/sector-baselines.js.map

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

package/dist/pipeline/phase5-build/phases/post-generation-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-generation-validator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase5-build/phases/post-generation-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,aAAa,CAAC;AAQxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAMD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,iBAAiB,EAAE,CAAC;CAC7E;AA0jBD,eAAO,MAAM,KAAK,EAAE,SAAS,2BAA2B,EAAc,CAAC;AAMvE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAsC9E;AAqBD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kBAAkB,GAC1B;IAAE,WAAW,EAAE,yBAAyB,CAAA;CAAE,CAgG5C"}
+{"version":3,"file":"post-generation-validator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase5-build/phases/post-generation-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,aAAa,CAAC;AAQxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAMD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,iBAAiB,EAAE,CAAC;CAC7E;AAg6BD,eAAO,MAAM,KAAK,EAAE,SAAS,2BAA2B,EAAc,CAAC;AAMvE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAsC9E;AAqBD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kBAAkB,GAC1B;IAAE,WAAW,EAAE,yBAAyB,CAAA;CAAE,CAgG5C"}

package/dist/pipeline/phase5-build/phases/post-generation-validator.js

@@ -558,10 +558,350 @@ const RULE_PGV_012 = {
         return findings;
     },
 };
+/** PGV-016: Ban module-level correlation-ID mutable state (ADR-PIPELINE-074). */
+const RULE_PGV_016 = {
+    id: 'PGV-016',
+    title: 'No module-level `let currentCorrelationId` in logger / logging files',
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-074',
+    check: (files) => {
+        const findings = [];
+        // Target: any variable binding named correlation* at module scope in
+        // logger-shaped files. Inside functions / classes the pattern is fine
+        // (AsyncLocalStorage stores are allowed); it's only the MODULE-LEVEL
+        // mutable that breaks under concurrent requests.
+        const pattern = /^(?:let|var)\s+(\w*[cC]orrelation[A-Za-z0-9_]*)\b/gm;
+        for (const [filePath, content] of files) {
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            // Match scaffolded logger files + any generator-emitted logging module
+            if (!(n.endsWith('/logger.ts') || n.includes('/logging/') || n.endsWith('/correlation.ts')))
+                continue;
+            if (isTestFile(filePath))
+                continue;
+            let match;
+            const re = new RegExp(pattern.source, 'gm');
+            while ((match = re.exec(content)) !== null) {
+                findings.push({
+                    ruleId: 'PGV-016',
+                    filePath,
+                    line: lineAt(content, match.index),
+                    severity: 'error',
+                    message: `Module-level mutable \`${match[1]}\` in logger/logging file — concurrent requests will cross-contaminate log lines. ` +
+                        'Use `runWithCorrelation` + AsyncLocalStorage from the scaffolded `src/logger.ts` instead (ADR-PIPELINE-074).',
+                });
+                if (match.index === re.lastIndex)
+                    re.lastIndex++;
+            }
+        }
+        return findings;
+    },
+};
+/** PGV-017: Ban Map-backed service stores (ADR-PIPELINE-075). */
+const RULE_PGV_017 = {
+    id: 'PGV-017',
+    title: 'Service layers must use Repository<T>, not new Map<string, T>',
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-075',
+    check: (files) => {
+        const findings = [];
+        // Match a class field declared as `new Map<string, T>`. We look for
+        // the field-binding form specifically (private/public/readonly/protected
+        // prefix + identifier + assignment) so local variables and request-
+        // scoped caches inside methods don't trigger.
+        const fieldPattern = /^\s*(?:private|public|protected)\s+(?:readonly\s+)?\w+\s*(?::\s*[^=]+)?=\s*new\s+Map\s*<\s*string\s*,/gm;
+        for (const [filePath, content] of files) {
+            if (isTestFile(filePath))
+                continue;
+            // Scope: only flag inside service / application layers
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            const isServiceLayer = n.includes('/services/') ||
+                n.includes('/application/') ||
+                n.includes('/domain/services/');
+            if (!isServiceLayer)
+                continue;
+            // Only fire when the file defines a *Service class (heuristic).
+            // This avoids flagging repositories, controllers, and utility classes
+            // that legitimately use Map for in-memory state.
+            const serviceClassMatch = content.match(/\bclass\s+(\w*(?:Service|Store|Manager))\b/);
+            if (!serviceClassMatch)
+                continue;
+            const serviceName = serviceClassMatch[1];
+            // Soften to a warning when the service clearly depends on a
+            // Repository — the Map is probably a request-scoped cache, not the
+            // primary store.
+            const hasRepositoryDep = /\b(?:private|public|protected|readonly)\s+\w+\s*:\s*\w*Repository\b/.test(content);
+            let match;
+            const re = new RegExp(fieldPattern.source, 'gm');
+            while ((match = re.exec(content)) !== null) {
+                findings.push({
+                    ruleId: 'PGV-017',
+                    filePath,
+                    line: lineAt(content, match.index),
+                    severity: hasRepositoryDep ? 'warn' : 'error',
+                    message: `Service class \`${serviceName}\` stores state in a Map<string, T> field — use \`Repository<T>\` from ` +
+                        '`src/persistence/repository.ts` instead. InMemoryRepository for tests, SqliteRepository for production (ADR-PIPELINE-075).',
+                });
+                if (match.index === re.lastIndex)
+                    re.lastIndex++;
+            }
+        }
+        return findings;
+    },
+};
+/** PGV-018: /metrics + /health/live + /health/ready routes must exist (ADR-PIPELINE-076). */
+const RULE_PGV_018 = {
+    id: 'PGV-018',
+    title: 'Generated project must expose /metrics, /health/live, /health/ready',
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-076',
+    check: (files) => {
+        const findings = [];
+        // Collect server-side files across common layouts. Exclude the
+        // scaffold's own api/base-app.ts because those routes are emitted
+        // there — PGV-018 is verifying downstream integration, not the
+        // scaffold file itself.
+        const serverFiles = Array.from(files.entries()).filter(([filePath]) => {
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            if (isTestFile(filePath))
+                return false;
+            return (n.includes('/server/') ||
+                n.includes('/api/') ||
+                n.endsWith('/app.ts') ||
+                n.endsWith('/server.ts') ||
+                n.endsWith('/index.ts'));
+        });
+        if (serverFiles.length === 0)
+            return findings;
+        // Two paths satisfy the rule:
+        //   (a) The project imports createBaseApp from the scaffold (every
+        //       generated project inherits the three routes automatically).
+        //   (b) The project defines the three routes explicitly in a server file.
+        const anyImportsBaseApp = serverFiles.some(([, content]) => /\bcreateBaseApp\b/.test(content) &&
+            /from\s+['"][^'"]*base-app(\.js)?['"]/.test(content));
+        if (anyImportsBaseApp)
+            return findings;
+        const aggregatedContent = serverFiles.map(([, c]) => c).join('\n');
+        const missing = [];
+        if (!/['"]\/metrics['"]/.test(aggregatedContent))
+            missing.push('/metrics');
+        if (!/['"]\/health\/live['"]/.test(aggregatedContent))
+            missing.push('/health/live');
+        if (!/['"]\/health\/ready['"]/.test(aggregatedContent))
+            missing.push('/health/ready');
+        if (missing.length > 0) {
+            const sample = serverFiles[0];
+            findings.push({
+                ruleId: 'PGV-018',
+                filePath: sample[0],
+                line: 0,
+                severity: 'error',
+                message: `Generated project does not expose ${missing.join(', ')}. ` +
+                    'Import `createBaseApp` from `src/api/base-app.ts` and call `app.route()` ' +
+                    'for your domain routes; the base app wires /metrics, /health/live, and /health/ready automatically (ADR-PIPELINE-076).',
+            });
+        }
+        return findings;
+    },
+};
+/** PGV-019: createBaseApp readiness list must cover declared dependencies (ADR-PIPELINE-076). */
+const RULE_PGV_019 = {
+    id: 'PGV-019',
+    title: 'createBaseApp readiness list should cover every external dependency',
+    severity: 'warn',
+    adrReference: 'ADR-PIPELINE-076',
+    check: (files) => {
+        const findings = [];
+        // Match createBaseApp({...}) invocation blocks and inspect the
+        // readiness array. Because the rule is regex-based, we only flag
+        // the clearly-wrong cases: readiness is the empty array alongside
+        // clear dependencies on db, erp, auditRepo, or circuit-breaker.
+        const invocationPattern = /createBaseApp\s*\(\s*\{([\s\S]*?)readiness\s*:\s*\[([\s\S]*?)\]([\s\S]*?)\}\s*\)/g;
+        for (const [filePath, content] of files) {
+            if (isTestFile(filePath))
+                continue;
+            let match;
+            const re = new RegExp(invocationPattern.source, 'g');
+            while ((match = re.exec(content)) !== null) {
+                const body = match[2] ?? '';
+                const trimmedBody = body.trim();
+                // Empty readiness list
+                const isEmpty = trimmedBody.length === 0;
+                // Only contains unconditional-pass checks like `{ ok: true }`
+                const onlyUnconditional = !isEmpty &&
+                    /ok\s*:\s*true/.test(trimmedBody) &&
+                    !/await|await\s+\w/.test(trimmedBody);
+                if (!isEmpty && !onlyUnconditional)
+                    continue;
+                // Does the file clearly declare downstream dependencies?
+                const hasDbDep = /\bDatabase\s*\(|new\s+Database\s*\(|SqliteRepository|drizzle|sqlite/i.test(content);
+                const hasErpDep = /ErpAdapter|erp[_-]?client|Ramco|OPERA|Workday|SAP\b/i.test(content);
+                const hasCircuitDep = /CircuitBreaker/.test(content);
+                const depCount = [hasDbDep, hasErpDep, hasCircuitDep].filter(Boolean).length;
+                if (depCount < 1)
+                    continue;
+                findings.push({
+                    ruleId: 'PGV-019',
+                    filePath,
+                    line: lineAt(content, match.index),
+                    severity: 'warn',
+                    message: `createBaseApp readiness list is ${isEmpty ? 'empty' : 'unconditional-pass-only'} but the file has ${depCount} external dependencies (db/erp/circuit). ` +
+                        'Add a readiness check for each dependency so /health/ready fails when they are unavailable (ADR-PIPELINE-076).',
+                });
+                if (match.index === re.lastIndex)
+                    re.lastIndex++;
+            }
+        }
+        return findings;
+    },
+};
+/** PGV-020: Every ERP adapter/schema file exports ERP_SCHEMA_PROVENANCE (ADR-PIPELINE-077). */
+const RULE_PGV_020 = {
+    id: 'PGV-020',
+    title: 'ERP adapter/schema files must export ERP_SCHEMA_PROVENANCE',
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-077',
+    check: (files) => {
+        const findings = [];
+        for (const [filePath, content] of files) {
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            // Scope: files under src/erp/ that are NOT tests and NOT the
+            // scaffolded helper itself (schema-provenance.ts).
+            if (!n.includes('/erp/'))
+                continue;
+            if (isTestFile(filePath))
+                continue;
+            if (n.endsWith('/schema-provenance.ts'))
+                continue;
+            // Skip obvious non-adapter files (enums, constants, utilities).
+            // We only require the block on files that export a Zod schema OR
+            // look like an adapter class — these are the code paths that talk
+            // to the real ERP.
+            const looksLikeAdapter = /\bz\.object\s*\(/.test(content) ||
+                /\bclass\s+\w*(?:Adapter|Client|Schema)\b/.test(content) ||
+                /\bexport\s+const\s+\w+Schema\s*=/.test(content);
+            if (!looksLikeAdapter)
+                continue;
+            const hasBlock = /export\s+const\s+ERP_SCHEMA_PROVENANCE\b/.test(content);
+            if (!hasBlock) {
+                findings.push({
+                    ruleId: 'PGV-020',
+                    filePath,
+                    line: 0,
+                    severity: 'error',
+                    message: 'ERP adapter/schema file does not export `ERP_SCHEMA_PROVENANCE`. ' +
+                        "Import `ErpSchemaProvenance` from `src/erp/schema-provenance.ts` and export a constant with `source: 'invented'` as the default (ADR-PIPELINE-077).",
+                });
+            }
+        }
+        return findings;
+    },
+};
+/** PGV-021: source='validated' requires non-null reviewer + catalog_version (ADR-PIPELINE-077). */
+const RULE_PGV_021 = {
+    id: 'PGV-021',
+    title: "ERP_SCHEMA_PROVENANCE source='validated' requires reviewer + catalog_version",
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-077',
+    check: (files) => {
+        const findings = [];
+        // Regex over the provenance literal. We look for the object body
+        // between `ERP_SCHEMA_PROVENANCE` and the next top-level `};` so
+        // multi-line declarations are captured.
+        const literalPattern = /export\s+const\s+ERP_SCHEMA_PROVENANCE[^=]*=\s*\{([\s\S]*?)\}\s*;/g;
+        for (const [filePath, content] of files) {
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            if (!n.includes('/erp/'))
+                continue;
+            if (isTestFile(filePath))
+                continue;
+            if (n.endsWith('/schema-provenance.ts'))
+                continue;
+            let match;
+            const re = new RegExp(literalPattern.source, 'g');
+            while ((match = re.exec(content)) !== null) {
+                const body = match[1] ?? '';
+                // Extract source value — tolerate single / double quotes + backticks
+                const sourceMatch = body.match(/\bsource\s*:\s*['"`](\w+)['"`]/);
+                if (!sourceMatch || sourceMatch[1] !== 'validated')
+                    continue;
+                // Under validated, reviewer and catalog_version must be non-null
+                const reviewerMatch = body.match(/\breviewer\s*:\s*([^,}]+)/);
+                const catalogMatch = body.match(/\bcatalog_version\s*:\s*([^,}]+)/);
+                const reviewerVal = (reviewerMatch?.[1] ?? '').trim();
+                const catalogVal = (catalogMatch?.[1] ?? '').trim();
+                const reviewerOk = reviewerVal !== '' && reviewerVal !== 'null' && reviewerVal !== 'undefined';
+                const catalogOk = catalogVal !== '' && catalogVal !== 'null' && catalogVal !== 'undefined';
+                if (!reviewerOk || !catalogOk) {
+                    const missing = [];
+                    if (!reviewerOk)
+                        missing.push('reviewer');
+                    if (!catalogOk)
+                        missing.push('catalog_version');
+                    findings.push({
+                        ruleId: 'PGV-021',
+                        filePath,
+                        line: lineAt(content, match.index),
+                        severity: 'error',
+                        message: `ERP_SCHEMA_PROVENANCE has source='validated' but ${missing.join(' and ')} is null/missing. ` +
+                            "Record the SME review details (reviewer name + role, catalog version) — don't rubber-stamp the validation status (ADR-PIPELINE-077).",
+                    });
+                }
+                if (match.index === re.lastIndex)
+                    re.lastIndex++;
+            }
+        }
+        return findings;
+    },
+};
+/** PGV-022: Audit services must use hashAuditEntry from the scaffold (ADR-PIPELINE-078). */
+const RULE_PGV_022 = {
+    id: 'PGV-022',
+    title: 'Audit services must hash with hashAuditEntry, not raw JSON.stringify + SHA-256',
+    severity: 'error',
+    adrReference: 'ADR-PIPELINE-078',
+    check: (files) => {
+        const findings = [];
+        // Match the anti-pattern: createHash('sha256').update(JSON.stringify(...))
+        // in a file that looks like an audit service.
+        const antiPattern = /createHash\s*\(\s*['"]sha256['"]\s*\)[\s\S]{0,80}\.update\s*\(\s*JSON\.stringify/g;
+        for (const [filePath, content] of files) {
+            if (isTestFile(filePath))
+                continue;
+            const n = filePath.replace(/\\/g, '/').toLowerCase();
+            // Only audit-shaped files: audit*.ts, services/audit*.ts, or files
+            // that declare a class with Audit in the name.
+            const isAuditShaped = n.endsWith('/audit.ts') ||
+                n.includes('/audit') ||
+                /\bclass\s+\w*Audit\w*\b/.test(content);
+            if (!isAuditShaped)
+                continue;
+            // Skip the scaffolded helper itself
+            if (n.endsWith('/audit-hash.ts') || n.endsWith('/canonical-json.ts'))
+                continue;
+            let match;
+            const re = new RegExp(antiPattern.source, 'g');
+            while ((match = re.exec(content)) !== null) {
+                findings.push({
+                    ruleId: 'PGV-022',
+                    filePath,
+                    line: lineAt(content, match.index),
+                    severity: 'error',
+                    message: 'Raw `JSON.stringify` + `createHash("sha256")` in audit code — use ' +
+                        '`hashAuditEntry` from `src/persistence/audit-hash.ts` instead. ' +
+                        'JSON.stringify does not sort keys and nested payload mutations escape tamper detection (ADR-PIPELINE-078).',
+                });
+                if (match.index === re.lastIndex)
+                    re.lastIndex++;
+            }
+        }
+        return findings;
+    },
+};
 const ALL_RULES = [
     RULE_PGV_001, RULE_PGV_002, RULE_PGV_003, RULE_PGV_004, RULE_PGV_005,
     RULE_PGV_006, RULE_PGV_007, RULE_PGV_008, RULE_PGV_009, RULE_PGV_010,
-    RULE_PGV_011, RULE_PGV_012,
+    RULE_PGV_011, RULE_PGV_012, RULE_PGV_016, RULE_PGV_017, RULE_PGV_018, RULE_PGV_019,
+    RULE_PGV_020, RULE_PGV_021, RULE_PGV_022,
 ];
 // Exported for unit tests that want to run individual rules
 export const RULES = ALL_RULES;