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

package/dist/synthesis/consensus-tiers.js

@@ -0,0 +1,285 @@
+/**
+ * ADR-PIPELINE-071: Consensus Tier Classifier
+ *
+ * Classifies an engagement's analytical consensus into one of three tiers:
+ *
+ *   - aligned     — agreement ≥70% AND precision ≥70% → footnote OK
+ *   - directional — partial agreement (40–69 / 50–69) → opening-paragraph
+ *                   acknowledgement + ranges instead of point estimates
+ *   - contested   — agreement <40 AND precision <50    → headline-level
+ *                   treatment, drives document structure, "Why we are not
+ *                   more confident" section, Week-4 consensus gate, etc.
+ *
+ * Pure functions over a `ConsensusSnapshot`. The snapshot is populated from
+ * agent results by `populateConsensusSnapshot`.
+ */
+// ============================================================================
+// Classification
+// ============================================================================
+/**
+ * ADR-PIPELINE-071 §1: tier thresholds.
+ *
+ * The classifier intentionally biases toward `contested` for ambiguous cases —
+ * a low-consensus run rendered as if it were aligned is the failure mode the
+ * ADR is trying to eliminate.
+ */
+export function classifyConsensus(agreementLevelPct, precisionConfidencePct) {
+    if (agreementLevelPct >= 70 && precisionConfidencePct >= 70)
+        return 'aligned';
+    if (agreementLevelPct < 40 && precisionConfidencePct < 50)
+        return 'contested';
+    if (agreementLevelPct >= 40 || precisionConfidencePct >= 50)
+        return 'directional';
+    return 'contested';
+}
+// ============================================================================
+// Snapshot population
+// ============================================================================
+const DEFAULT_PER_DIMENSION = {
+    financial: 0.5,
+    operational: 0.5,
+    compliance: 0.5,
+    workforce: 0.5,
+    technical: 0.5,
+};
+/**
+ * Build a ConsensusSnapshot from explicit inputs. All fields default to a
+ * conservative middle-ground when omitted, except `tier` which is always
+ * recomputed from the two confidence numbers.
+ */
+export function buildConsensusSnapshot(inputs = {}) {
+    const agreementLevelPct = clampPct(inputs.agreementLevelPct ?? 50);
+    const precisionConfidencePct = clampPct(inputs.precisionConfidencePct ?? 50);
+    const directionalConfidencePct = clampPct(inputs.directionalConfidencePct ?? Math.max(agreementLevelPct, precisionConfidencePct + 20));
+    const tier = classifyConsensus(agreementLevelPct, precisionConfidencePct);
+    return {
+        agreementLevelPct,
+        precisionConfidencePct,
+        directionalConfidencePct,
+        tier,
+        dissentingAgents: inputs.dissentingAgents ?? [],
+        loadBearingAssumptions: inputs.loadBearingAssumptions ?? [],
+        perDimension: { ...DEFAULT_PER_DIMENSION, ...(inputs.perDimension ?? {}) },
+    };
+}
+/**
+ * ADR-PIPELINE-071 §3: populate the snapshot from raw agent results.
+ *
+ * Reads:
+ *   - `analytics-hub/consensus`     → agreement, precision, dissenting agents
+ *   - `simulator/enterprise`        → success_probability fallback for direction
+ *   - all `*` agent error responses → dissent dimension
+ *
+ * Returns a snapshot that's safe for renderers to consume — never throws.
+ */
+export function populateConsensusSnapshot(simulationResult, platformResults) {
+    const consensusAgent = platformResults.find(r => r.domain === 'analytics-hub' && r.agent === 'consensus');
+    const data = consensusAgent ? extractConsensusData(consensusAgent) : null;
+    const agreementLevelPct = clampPct(data?.agreementLevelPct ?? Math.round((extractSimSuccess(simulationResult) ?? 0.5) * 100));
+    const precisionConfidencePct = clampPct(data?.precisionConfidencePct ?? data?.confidencePct ?? 50);
+    const directionalConfidencePct = clampPct(data?.directionalConfidencePct ??
+        Math.min(99, Math.max(agreementLevelPct, precisionConfidencePct + 20)));
+    const dissentingAgents = [];
+    for (const r of platformResults) {
+        if (r.status >= 200 && r.status < 300)
+            continue;
+        dissentingAgents.push({
+            domain: r.domain,
+            agent: r.agent,
+            dimension: dimensionFromDomain(r.domain),
+            summary: `Agent returned status ${r.status}.`,
+        });
+    }
+    if (data?.dissentingAgents) {
+        dissentingAgents.push(...data.dissentingAgents);
+    }
+    const loadBearingAssumptions = data?.loadBearingAssumptions ?? [
+        'Pilot data reflects production conditions',
+        'Adoption rate matches analogous deployments',
+        'No regulatory scope changes during the pilot window',
+    ];
+    const perDimension = data?.perDimension ?? {
+        financial: precisionConfidencePct / 100,
+        operational: precisionConfidencePct / 100,
+        compliance: agreementLevelPct / 100,
+        workforce: Math.max(0.3, (agreementLevelPct - 10) / 100),
+        technical: Math.min(0.95, (precisionConfidencePct + 20) / 100),
+    };
+    return buildConsensusSnapshot({
+        agreementLevelPct,
+        precisionConfidencePct,
+        directionalConfidencePct,
+        dissentingAgents,
+        loadBearingAssumptions,
+        perDimension,
+    });
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function clampPct(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    if (n <= 0)
+        return 0;
+    if (n >= 100)
+        return 100;
+    return Math.round(n);
+}
+function extractConsensusData(agent) {
+    const response = agent.response;
+    if (!response || typeof response !== 'object')
+        return {};
+    const signal = response['signal'];
+    const payloadOuter = signal ? signal['payload'] : undefined;
+    const payload = payloadOuter ? payloadOuter['data'] : undefined;
+    const data = payload ?? response;
+    const out = {};
+    if (typeof data['agreement_level_pct'] === 'number') {
+        out.agreementLevelPct = data['agreement_level_pct'];
+    }
+    else if (typeof data['agreementLevelPct'] === 'number') {
+        out.agreementLevelPct = data['agreementLevelPct'];
+    }
+    if (typeof data['precision_confidence_pct'] === 'number') {
+        out.precisionConfidencePct = data['precision_confidence_pct'];
+    }
+    else if (typeof data['precisionConfidencePct'] === 'number') {
+        out.precisionConfidencePct = data['precisionConfidencePct'];
+    }
+    if (typeof data['confidence'] === 'number') {
+        out.confidencePct = data['confidence'] * 100;
+    }
+    else if (typeof data['overallConfidence'] === 'number') {
+        out.confidencePct = data['overallConfidence'] * 100;
+    }
+    if (typeof data['directional_confidence_pct'] === 'number') {
+        out.directionalConfidencePct = data['directional_confidence_pct'];
+    }
+    if (Array.isArray(data['dissenting_agents'])) {
+        out.dissentingAgents = data['dissenting_agents'].map(d => ({
+            domain: String(d['domain'] ?? 'unknown'),
+            agent: String(d['agent'] ?? 'unknown'),
+            dimension: (typeof d['dimension'] === 'string'
+                ? d['dimension']
+                : 'operational'),
+            summary: String(d['summary'] ?? d['reason'] ?? ''),
+        }));
+    }
+    if (Array.isArray(data['load_bearing_assumptions'])) {
+        out.loadBearingAssumptions = data['load_bearing_assumptions']
+            .filter(x => typeof x === 'string')
+            .slice(0, 3);
+    }
+    if (data['per_dimension'] && typeof data['per_dimension'] === 'object') {
+        out.perDimension = data['per_dimension'];
+    }
+    return out;
+}
+function dimensionFromDomain(domain) {
+    const d = domain.toLowerCase();
+    if (/cost|finan|roi|npv/.test(d))
+        return 'financial';
+    if (/governance|policy|compliance|shield|legal/.test(d))
+        return 'compliance';
+    if (/work\s*force|hr/.test(d))
+        return 'workforce';
+    if (/sec|engineer|tech|integration|architect/.test(d))
+        return 'technical';
+    return 'operational';
+}
+function extractSimSuccess(simulationResult) {
+    if (!simulationResult || typeof simulationResult !== 'object')
+        return null;
+    const sig = simulationResult['signal'];
+    const payload = sig?.['payload'];
+    const data = (payload?.['data'] ?? simulationResult);
+    const val = data['success_probability'] ?? data['confidence'];
+    if (typeof val === 'number')
+        return val;
+    return null;
+}
+// ============================================================================
+// Tier-driven content blocks
+// ============================================================================
+/** Used by renderers as a top-of-document banner. */
+export function consensusBanner(snapshot) {
+    if (snapshot.tier === 'aligned')
+        return null;
+    if (snapshot.tier === 'directional') {
+        return [
+            `> 📊 **Consensus: directional** — agreement ${snapshot.agreementLevelPct}%, precision ${snapshot.precisionConfidencePct}%.`,
+            '> Direction is supported, magnitude has meaningful variance. Treat headline figures as ranges.',
+        ].join('\n');
+    }
+    return [
+        `> 📊 **Consensus: contested** — agreement ${snapshot.agreementLevelPct}%, precision ${snapshot.precisionConfidencePct}%.`,
+        '> See "Why we are not more confident" before interpreting figures.',
+    ].join('\n');
+}
+/** Required opening paragraph for the executive summary on directional / contested tiers. */
+export function consensusOpeningParagraph(snapshot) {
+    if (snapshot.tier === 'aligned')
+        return null;
+    if (snapshot.tier === 'directional') {
+        return (`**Agent consensus: directional (${snapshot.agreementLevelPct}%)** — direction is supported, ` +
+            'magnitude has meaningful variance. Headline figures should be read as ranges, not point estimates.');
+    }
+    return (`**Agent consensus is contested (agreement ${snapshot.agreementLevelPct}%, precision ${snapshot.precisionConfidencePct}%).** ` +
+        'This is why the recommendation is a bounded pilot, not full deployment — the pilot is designed ' +
+        'to resolve the disagreement with measured data before any broader commitment.');
+}
+/** "Why we are not more confident" section body for the decision memo. */
+export function whyNotMoreConfidentSection(snapshot) {
+    if (snapshot.tier === 'aligned')
+        return [];
+    const lines = ['## Why We Are Not More Confident', ''];
+    lines.push(`Agent consensus reached **agreement ${snapshot.agreementLevelPct}%** with **precision ${snapshot.precisionConfidencePct}%**. ` +
+        `Directional confidence is **${snapshot.directionalConfidencePct}%** — we are confident in the direction of the answer, ` +
+        'but the magnitude carries meaningful uncertainty.', '');
+    if (snapshot.dissentingAgents.length > 0) {
+        lines.push('**Dissenting agents:**', '');
+        for (const d of snapshot.dissentingAgents.slice(0, 6)) {
+            lines.push(`- \`${d.domain}/${d.agent}\` (${d.dimension}) — ${d.summary}`);
+        }
+        lines.push('');
+    }
+    if (snapshot.loadBearingAssumptions.length > 0) {
+        lines.push('**Load-bearing assumptions:**', '');
+        for (const a of snapshot.loadBearingAssumptions.slice(0, 3)) {
+            lines.push(`- ${a}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+/** Week-4 consensus gate for the roadmap on contested runs. */
+export function consensusGate(snapshot) {
+    if (snapshot.tier !== 'contested')
+        return null;
+    return {
+        week: 4,
+        threshold_pct: 60,
+        default_action: 'STOP',
+        description: 'If measured pilot data has not moved precision confidence above 60% by Week 4, the Week 8 scale ' +
+            'decision defaults to STOP. Resume only after a follow-up consensus check confirms the direction.',
+    };
+}
+/**
+ * Risk-register row injected on contested runs so analytical uncertainty is
+ * a named, owned risk rather than a tone-of-voice.
+ */
+export function analyticalUncertaintyRisk(snapshot) {
+    if (snapshot.tier !== 'contested')
+        return null;
+    return {
+        risk: `Analytical uncertainty: agent consensus contested (agreement ${snapshot.agreementLevelPct}%, precision ${snapshot.precisionConfidencePct}%)`,
+        category: 'Analytical',
+        likelihood: 'High',
+        impact: 'High',
+        score: 9,
+        mitigation: 'Week-4 consensus gate (default STOP if precision <60%); pilot scope locked at one region; ' +
+            'load-bearing assumptions tracked weekly with named owners.',
+    };
+}
+//# sourceMappingURL=consensus-tiers.js.map

package/dist/synthesis/consensus-tiers.js.map

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

package/dist/synthesis/domain-labor-classifier.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ADR-PIPELINE-070: Domain Labor-Intensity Classifier
+ *
+ * Pure rules-based classifier. Maps the detected sector + free-text query
+ * keywords to a LaborProfile that downstream renderers consume:
+ *
+ *   - Risk register injects a Workforce Impact section
+ *   - Financial analysis adds a workforce exposure block
+ *   - Decision memo RACI gains HR + Legal rows
+ *   - Sensitivity table gains a change-management variable
+ *
+ * The classifier is intentionally coarse — it answers "is this sector
+ * labor-intensive enough that workforce risk MUST appear in the
+ * deliverables?" not "what specific labor risks does this engagement
+ * have?". The Workforce Impact rows it produces are templates labelled
+ * `*Template risk — refine with HR during pilot scoping*`.
+ */
+import { type Sector } from './domain-unit-registry.js';
+import type { DomainAnalysis } from './simulation-renderers.js';
+export type LaborIntensity = 'high' | 'medium' | 'low';
+export type UnionizationRisk = 'high' | 'medium' | 'low';
+export type Region = 'NA' | 'EMEA' | 'APAC';
+export interface LaborProfile {
+    /** Overall labor intensity for this engagement. */
+    readonly intensity: LaborIntensity;
+    /** Detected sector (from ADR-066 registry) — 'unknown' when unmatched. */
+    readonly sector: Sector;
+    /** Plain-English role types most affected by the engagement. */
+    readonly roleTypes: readonly string[];
+    /** Likelihood that affected workforce sits within a unionized population. */
+    readonly unionizationRisk: UnionizationRisk;
+    /** Per-region labor exposure multipliers (1.0 = baseline). */
+    readonly regionMultipliers: Readonly<Record<Region, number>>;
+    /** Why the classifier picked this intensity — surfaced in logs/artifacts. */
+    readonly reasoning: string;
+}
+/**
+ * ADR-PIPELINE-070: classify the labor intensity of an engagement.
+ *
+ * Inputs:
+ *   - `domainAnalysis` — when present, its `domain` field is treated as the
+ *     authoritative sector hint (from ADR-PIPELINE-041's pipeline output).
+ *   - `query` — free-text query, used both for sector detection and for
+ *     intensity-override patterns.
+ *
+ * The function never throws. Unknown sectors return the LOW_DEFAULT profile.
+ */
+export declare function classifyLaborIntensity(domainAnalysis: DomainAnalysis | null, query: string): LaborProfile;
+/** True when the renderer must inject workforce content. */
+export declare function isLaborIntensive(profile: LaborProfile): boolean;
+export interface WorkforceRiskRow {
+    readonly category: string;
+    readonly risk: string;
+    readonly likelihood: 'High' | 'Medium' | 'Low';
+    readonly severity: 'High' | 'Medium' | 'Low';
+    readonly owner: string;
+    readonly mitigation: string;
+    readonly template: true;
+}
+export declare function workforceRiskTemplate(profile: LaborProfile): readonly WorkforceRiskRow[];
+export interface WorkforceExposure {
+    readonly rolesAffected: number;
+    readonly emeaUnionExposure: number;
+    readonly changeMgmtBudgetLowUsd: number;
+    readonly changeMgmtBudgetHighUsd: number;
+    readonly changeMgmtPct: number;
+    readonly reallocationNeutral: boolean;
+    readonly primaryRoleLabel: string;
+}
+interface WorkforceExposureInputs {
+    /** Total enterprise headcount (for context only — never the savings base). */
+    readonly employees: number;
+    /** Operational units (rooms, sqft, vehicles, ...) when known. */
+    readonly operationalUnits?: number;
+    /** Pilot investment range mid-point in USD — basis for change-mgmt budget. */
+    readonly pilotInvestmentUsd?: number;
+}
+export declare function estimateWorkforceExposure(profile: LaborProfile, inputs: WorkforceExposureInputs): WorkforceExposure | null;
+export interface WorkforceRaciRow {
+    readonly role: string;
+    readonly responsibility: 'Responsible' | 'Accountable' | 'Consulted' | 'Informed';
+    readonly cadence: string;
+    readonly template: true;
+}
+export declare function workforceRaciTemplate(profile: LaborProfile): readonly WorkforceRaciRow[];
+export interface WorkforceSensitivityRow {
+    readonly variable: string;
+    readonly range: string;
+    readonly impactPctOfPilot: number;
+    readonly reasoning: string;
+}
+export declare function workforceSensitivityRow(profile: LaborProfile): WorkforceSensitivityRow | null;
+export interface LaborProfileArtifact {
+    readonly version: '1.0';
+    readonly generated_at: string;
+    readonly profile: LaborProfile;
+    readonly exposure: WorkforceExposure | null;
+}
+export declare function buildLaborProfileArtifact(profile: LaborProfile, exposure: WorkforceExposure | null): LaborProfileArtifact;
+export {};
+//# sourceMappingURL=domain-labor-classifier.d.ts.map

package/dist/synthesis/domain-labor-classifier.d.ts.map

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