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

package/dist/synthesis/domain-unit-registry.js

@@ -0,0 +1,320 @@
+/**
+ * ADR-PIPELINE-066: Domain Unit Registry
+ *
+ * Maps a detected sector to its domain unit (the thing savings actually scale
+ * with) and a savings-base formula. Replaces per-employee heuristics whenever
+ * a sector in this registry is detected.
+ *
+ * Pure functions — no I/O.
+ */
+/**
+ * The eight sectors called out in ADR-PIPELINE-066 §3.
+ * Order matters for classification — more specific patterns first.
+ */
+export const SECTOR_REGISTRY = [
+    {
+        sector: 'hospitality',
+        domainUnit: { label: 'occupied room night', abbrev: 'orn' },
+        scopeKeys: ['rooms', 'properties'],
+        savingsFormula: 'rooms × occupancy × $/occupied-room-night',
+        unitSavingsKey: 'usd_per_orn',
+    },
+    {
+        sector: 'commercial-real-estate',
+        domainUnit: { label: 'square foot-year', abbrev: 'sqft-yr' },
+        scopeKeys: ['sqft', 'properties'],
+        savingsFormula: 'sqft × $/sqft-year',
+        unitSavingsKey: 'usd_per_sqft_year',
+    },
+    {
+        sector: 'fleet',
+        domainUnit: { label: 'vehicle-mile', abbrev: 'vmi' },
+        scopeKeys: ['vehicles'],
+        savingsFormula: 'fleet × miles × $/mile',
+        unitSavingsKey: 'usd_per_vehicle_mile',
+    },
+    {
+        sector: 'retail',
+        domainUnit: { label: 'transaction', abbrev: 'txn' },
+        scopeKeys: ['properties', 'units'],
+        savingsFormula: 'daily transactions × 365 × $/transaction',
+        unitSavingsKey: 'usd_per_transaction',
+    },
+    {
+        sector: 'manufacturing',
+        domainUnit: { label: 'unit produced', abbrev: 'unit' },
+        scopeKeys: ['units'],
+        savingsFormula: 'throughput × $/unit',
+        unitSavingsKey: 'usd_per_unit_produced',
+    },
+    {
+        sector: 'healthcare',
+        domainUnit: { label: 'patient-day', abbrev: 'pday' },
+        scopeKeys: ['beds'],
+        savingsFormula: 'census × $/patient-day',
+        unitSavingsKey: 'usd_per_patient_day',
+    },
+    {
+        sector: 'data-center',
+        domainUnit: { label: 'kilowatt-hour', abbrev: 'kWh' },
+        scopeKeys: ['units'],
+        savingsFormula: 'load × 8760 × $/kWh',
+        unitSavingsKey: 'usd_per_kwh',
+    },
+    {
+        sector: 'call-center',
+        domainUnit: { label: 'contact minute', abbrev: 'cmin' },
+        scopeKeys: ['agents'],
+        savingsFormula: 'agents × minutes × $/contact-minute',
+        unitSavingsKey: 'usd_per_contact_minute',
+    },
+    {
+        sector: 'airline-catering',
+        domainUnit: { label: 'meal loaded', abbrev: 'meal' },
+        scopeKeys: ['units', 'properties'],
+        savingsFormula: 'meals × flights × 365 × $/meal-loaded',
+        unitSavingsKey: 'usd_per_meal_loaded',
+    },
+];
+const REGISTRY_BY_SECTOR = new Map(SECTOR_REGISTRY.map(e => [e.sector, e]));
+export function getSectorEntry(sector) {
+    return REGISTRY_BY_SECTOR.get(sector) ?? null;
+}
+// Hard patterns: unambiguous sector indicators that lock the classification.
+// Order matters — airline-catering must be checked BEFORE hospitality because
+// an airline-catering query ("in-flight catering", "meals") might otherwise
+// match "catering" as hospitality-adjacent.
+const HARD_RULES = [
+    {
+        sector: 'airline-catering',
+        patterns: [
+            /\bin[-\s]?flight\s+catering\b/i,
+            /\bairline\s+catering\b/i,
+            /\bflight\s+catering\b/i,
+            /\bmeal\s+planning\b/i,
+            /\bmeals?\s+(?:loaded|per\s+flight)\b/i,
+            /\bgalley\s+catering\b/i,
+            /\b(?:airline|carrier)\s+(?:meal|food|galley)\b/i,
+        ],
+    },
+    {
+        sector: 'hospitality',
+        patterns: [
+            /\bhotel\b/i,
+            /\bhousekeep/i,
+            /\blodging\b/i,
+            /\bhospitality\b/i,
+            /\bresort\b/i,
+            /\broom\s*night/i,
+            /\boccupanc/i,
+        ],
+    },
+    {
+        sector: 'commercial-real-estate',
+        patterns: [
+            /\bcommercial\s+real\s+estate\b/i,
+            /\boffice\s+portfolio\b/i,
+            /\bbuilding\s+portfolio\b/i,
+            /\bworkplace\s+(?:optim|utiliz)/i,
+            /\bsqft\b/i,
+            /\bsquare\s+f(?:oot|eet)\b/i,
+            /\bfacility\s+management\b/i,
+        ],
+    },
+    {
+        sector: 'fleet',
+        patterns: [
+            /\bfleet\b/i,
+            /\b(?:truck|vehicle)\s+fleet\b/i,
+            /\bEV\s+transition\b/i,
+            /\bfleet\s+electrification\b/i,
+            /\btransportation\s+(?:cost|fuel)/i,
+        ],
+    },
+    {
+        sector: 'retail',
+        patterns: [
+            /\bretail\s+chain\b/i,
+            /\bstores?\b/i,
+            /\bgrocery\b/i,
+            /\bpoint[-\s]?of[-\s]?sale\b/i,
+            /\bregister\s+throughput\b/i,
+        ],
+    },
+    {
+        sector: 'manufacturing',
+        patterns: [
+            /\bmanufactur/i,
+            /\bfactory\b/i,
+            /\bproduction\s+line\b/i,
+            /\bassembly\s+line\b/i,
+            /\bOEE\b/i,
+        ],
+    },
+    {
+        sector: 'healthcare',
+        patterns: [
+            /\bhospital\b/i,
+            /\bclinic\b/i,
+            /\bpatient\b/i,
+            /\bnurs(?:e|ing)\b/i,
+            /\bhealthcare\b/i,
+            /\bhealth\s*system\b/i,
+        ],
+    },
+    {
+        sector: 'data-center',
+        patterns: [
+            /\bdata\s*center\b/i,
+            /\bdatacenter\b/i,
+            /\bPUE\b/i,
+            /\bserver\s+farm\b/i,
+            /\bcolocation\b/i,
+        ],
+    },
+    {
+        sector: 'call-center',
+        patterns: [
+            /\bcall\s*center\b/i,
+            /\bcontact\s*center\b/i,
+            /\bBPO\b/i,
+            /\bagent\s+productivity\b/i,
+            /\bcustomer\s+service\s+center\b/i,
+        ],
+    },
+];
+/**
+ * Classify a query into a sector from the registry, or 'unknown'.
+ * Prefers an explicit sector hint (from domain_analysis.sector) when provided.
+ */
+export function classifySector(query, sectorHint) {
+    if (sectorHint) {
+        const normalized = normalizeSectorHint(sectorHint);
+        if (normalized !== 'unknown')
+            return normalized;
+    }
+    for (const rule of HARD_RULES) {
+        if (rule.patterns.some(p => p.test(query)))
+            return rule.sector;
+    }
+    return 'unknown';
+}
+function normalizeSectorHint(hint) {
+    const h = hint.toLowerCase().trim();
+    // airline-catering checked BEFORE hospitality so "hotel catering" doesn't misclassify
+    if (/airline[-\s]catering|in[-\s]?flight|flight[-\s]catering|galley/.test(h))
+        return 'airline-catering';
+    if (/hospitality|hotel|lodging|resort/.test(h))
+        return 'hospitality';
+    if (/commercial[-\s]real[-\s]estate|cre\b|office|workplace|building/.test(h))
+        return 'commercial-real-estate';
+    if (/fleet|transportation|vehicle/.test(h))
+        return 'fleet';
+    if (/retail|store/.test(h))
+        return 'retail';
+    if (/manufactur|factory|production/.test(h))
+        return 'manufacturing';
+    if (/healthcare|hospital|clinic|patient/.test(h))
+        return 'healthcare';
+    if (/data[-\s]?center|datacenter/.test(h))
+        return 'data-center';
+    if (/call[-\s]?center|contact[-\s]?center|bpo/.test(h))
+        return 'call-center';
+    return 'unknown';
+}
+/** Extract employee count from free text. Used for context only. */
+export function extractEmployeeCountFromText(query) {
+    const lower = query.toLowerCase();
+    let employees = 10000;
+    const empIdx = lower.indexOf('employees');
+    const staffIdx = lower.indexOf('staff');
+    const targetIdx = empIdx !== -1 ? empIdx : staffIdx;
+    if (targetIdx > 5) {
+        const before = query.substring(Math.max(0, targetIdx - 30), targetIdx).trim();
+        const words = before.split(/\s+/);
+        for (let i = words.length - 1; i >= 0; i--) {
+            const cleaned = (words[i] ?? '').replace(/,/g, '').replace(/approximately/i, '').trim();
+            const num = parseInt(cleaned, 10);
+            if (num > 100 && num < 10_000_000) {
+                employees = num;
+                break;
+            }
+        }
+    }
+    return employees;
+}
+const UNIT_PATTERNS = [
+    { pattern: /(\d[\d,]*)\s*(?:flights?|aircraft)/i, sector: 'airline-catering', unitLabel: 'flights', unitAbbrev: 'flights' },
+    { pattern: /(\d[\d,]*)\s*(?:hotels?|properties|resorts?)/i, sector: 'hospitality', unitLabel: 'rooms', unitAbbrev: 'rooms' },
+    { pattern: /(\d[\d,]*)\s*(?:rooms?)\b/i, sector: 'hospitality', unitLabel: 'rooms', unitAbbrev: 'rooms' },
+    { pattern: /(\d[\d,]*)\s*(?:buildings?|offices?|sites?)/i, sector: 'commercial-real-estate', unitLabel: 'sqft', unitAbbrev: 'sqft' },
+    { pattern: /(\d[\d,]*)\s*(?:vehicles?|trucks?|vans?|cars?)/i, sector: 'fleet', unitLabel: 'vehicles', unitAbbrev: 'vehicles' },
+    { pattern: /(\d[\d,]*)\s*(?:stores?|locations?|outlets?|branches?)/i, sector: 'retail', unitLabel: 'stores', unitAbbrev: 'stores' },
+    { pattern: /(\d[\d,]*)\s*(?:plants?|factor(?:y|ies))/i, sector: 'manufacturing', unitLabel: 'plants', unitAbbrev: 'plants' },
+    { pattern: /(\d[\d,]*)\s*(?:beds?|patients?)/i, sector: 'healthcare', unitLabel: 'beds', unitAbbrev: 'beds' },
+    { pattern: /(\d[\d,]*)\s*(?:agents?)/i, sector: 'call-center', unitLabel: 'agents', unitAbbrev: 'agents' },
+];
+/**
+ * ADR-PIPELINE-066 §4: Replace `extractEmployeeCount` with a richer shape that
+ * carries the operational unit *and* its source. Savings math that used to
+ * multiply `employees * ratio` must now multiply `operationalUnits * ratio`
+ * whenever `source !== 'default'`.
+ */
+export function extractDomainScale(query, sectorHint) {
+    const employees = extractEmployeeCountFromText(query);
+    const sector = classifySector(query, sectorHint);
+    // Prefer an explicit unit count in the query over sector-based fallback.
+    for (const rule of UNIT_PATTERNS) {
+        const match = query.match(rule.pattern);
+        if (match?.[1]) {
+            const count = parseInt(match[1].replace(/,/g, ''), 10);
+            if (count > 0) {
+                return {
+                    employees,
+                    operationalUnits: count,
+                    unitLabel: rule.unitLabel,
+                    unitAbbrev: rule.unitAbbrev,
+                    sector: sector === 'unknown' ? rule.sector : sector,
+                    source: 'query-regex',
+                };
+            }
+        }
+    }
+    // Sector-based ratios when no explicit count was given. These are
+    // intentionally coarse — the goal is to produce a plausible operational
+    // unit count, NOT to compute savings. Savings come from unit-economics.json.
+    if (sector !== 'unknown') {
+        const entry = getSectorEntry(sector);
+        const primaryKey = entry?.scopeKeys[0] ?? 'units';
+        const ratios = {
+            rooms: 0.02, // ~1 room per 50 employees (hotel avg)
+            sqft: 200, // ~200 sqft per employee
+            vehicles: 0.05, // ~5% of workforce drives fleet
+            stores: 0.005, // ~1 store per 200 employees
+            plants: 0.001, // ~1 plant per 1000 employees
+            beds: 0.2, // ~1 bed per 5 staff
+            agents: 0.3, // ~30% of headcount
+            units: 0.1,
+            properties: 0.002,
+        };
+        const ratio = ratios[primaryKey] ?? 0.1;
+        const operationalUnits = Math.max(1, Math.round(employees * ratio));
+        return {
+            employees,
+            operationalUnits,
+            unitLabel: primaryKey,
+            unitAbbrev: primaryKey,
+            sector,
+            source: 'query-regex',
+        };
+    }
+    return {
+        employees,
+        operationalUnits: employees,
+        unitLabel: 'employees',
+        unitAbbrev: 'emp',
+        sector: 'unknown',
+        source: 'default',
+    };
+}
+//# sourceMappingURL=domain-unit-registry.js.map

package/dist/synthesis/domain-unit-registry.js.map

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

package/dist/synthesis/financial-claim-extractor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ADR-PIPELINE-067: Financial Claim Extractor
+ *
+ * Parses rendered executive markdown and returns a structured list of
+ * FinancialClaim records. Used by the cross-document consistency runner to
+ * compare dollar figures, timelines, and scope labels across documents.
+ *
+ * Pure functions. Regex-based — no LLM calls.
+ *
+ * Renderers can short-circuit extraction by emitting an HTML comment tag
+ * immediately before the figure:
+ *
+ *   <!-- fcv:kind=investment scope=pilot -->
+ *   **Pilot investment:** $1.0M–$1.4M
+ */
+export type FinancialClaimDocument = 'executive-summary' | 'decision-memo' | 'roadmap' | 'business-case' | 'risk-register' | 'financial-analysis' | 'unknown';
+export type FinancialClaimKind = 'investment' | 'savings' | 'timeline' | 'headcount' | 'roi' | 'npv';
+export type FinancialClaimScope = 'pilot' | 'phase-1' | 'phase-2' | 'phase-3' | 'full-program' | 'unscoped';
+export type FinancialClaimUnit = 'USD' | 'weeks' | 'months' | 'years' | 'count' | 'percent';
+export interface FinancialClaim {
+    readonly document: FinancialClaimDocument;
+    readonly section: string;
+    readonly kind: FinancialClaimKind;
+    readonly scope: FinancialClaimScope;
+    readonly rangeLow?: number;
+    readonly rangeHigh?: number;
+    readonly pointValue?: number;
+    readonly unit: FinancialClaimUnit;
+    readonly rawText: string;
+    readonly line: number;
+    /** True when the claim was pulled from an explicit fcv: HTML comment tag. */
+    readonly tagged: boolean;
+    /**
+     * ADR-PIPELINE-073: when the tag carried a `doc=` field, this holds its
+     * value. FCR-012 fires when this disagrees with the enclosing document.
+     */
+    readonly docTag?: FinancialClaimDocument;
+}
+/**
+ * ADR-PIPELINE-073: Documents that MUST carry authoritative fcv tags on
+ * every money figure. Untagged money figures in these docs fire FCR-011.
+ * Other documents (narrative memos, agent output) continue to use
+ * proximity-based scope detection as a fallback.
+ */
+export declare const EXPECTS_TAGS: ReadonlySet<FinancialClaimDocument>;
+/**
+ * Parse a single currency token like "$1.2M", "$600K", "$1,200,000",
+ * "USD 1.2M", or "1.2 million dollars". Returns NaN when the input does not
+ * look like a currency amount.
+ */
+export declare function parseCurrency(token: string): number;
+/** ADR-PIPELINE-073: count fcv tags in a document body. */
+export declare function countFcvTags(body: string): number;
+/**
+ * ADR-PIPELINE-073: emit an fcv HTML comment tag. Used by renderers.
+ * Exported here (not in simulation-renderers) so the extractor and the
+ * renderer speak the same grammar.
+ */
+export declare function fcvTag(kind: FinancialClaimKind, scope: FinancialClaimScope, doc: FinancialClaimDocument): string;
+/**
+ * Extract FinancialClaim records from a markdown document. The document name
+ * is recorded on every claim and becomes the primary key for
+ * cross-document rule evaluation.
+ *
+ * Scoping heuristic:
+ *   1. If an HTML fcv: tag precedes the figure (same line or prior line),
+ *      use its declared kind/scope verbatim.
+ *   2. Otherwise scan a ±60 char window around the figure for scope words
+ *      ("pilot", "phase 1", "full program", ...).
+ */
+export declare function extractClaims(markdown: string, document: FinancialClaimDocument): FinancialClaim[];
+//# sourceMappingURL=financial-claim-extractor.d.ts.map

package/dist/synthesis/financial-claim-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-claim-extractor.d.ts","sourceRoot":"","sources":["../../src/synthesis/financial-claim-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,eAAe,GACf,SAAS,GACT,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,SAAS,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,SAAS,GACT,UAAU,GACV,WAAW,GACX,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,GACT,cAAc,GACd,UAAU,CAAC;AAEf,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,sBAAsB,CAM3D,CAAC;AAYH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsCnD;AA0GD,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,sBAAsB,GAC1B,MAAM,CAER;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAC/B,cAAc,EAAE,CAmClB"}