@codeledger/engine 0.7.2 → 0.7.3

package/dist/dashboard/store.js

@@ -0,0 +1,97 @@
+/**
+ * Dashboard Data Store — Append-only JSONL persistence for dashboard snapshots
+ *
+ * Storage: .codeledger/dashboard-history.jsonl
+ *
+ * Each line is a JSON-encoded DashboardSnapshot.
+ */
+import { readFileSync, appendFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const DASHBOARD_HISTORY_FILE = 'dashboard-history.jsonl';
+// Trend threshold: delta > 0.02 = improving, delta < -0.02 = degrading
+const TREND_THRESHOLD = 0.02;
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Append a dashboard metrics snapshot to the JSONL history file.
+ */
+export function appendDashboardSnapshot(dataDir, metrics, source = 'cli') {
+    const snapshot = {
+        ...metrics,
+        snapshot_source: source,
+    };
+    const filePath = join(dataDir, DASHBOARD_HISTORY_FILE);
+    const line = JSON.stringify(snapshot) + '\n';
+    appendFileSync(filePath, line, 'utf-8');
+}
+/**
+ * Read all dashboard snapshots from the JSONL history file.
+ * Returns an empty array if the file does not exist.
+ */
+export function readDashboardHistory(dataDir) {
+    const filePath = join(dataDir, DASHBOARD_HISTORY_FILE);
+    if (!existsSync(filePath))
+        return [];
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter((l) => l.trim().length > 0);
+        const snapshots = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                snapshots.push(parsed);
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return snapshots;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compute trend directions from dashboard history.
+ *
+ * Uses the last 5 entries to determine if each metric is improving, stable, or degrading.
+ * For DRI and override_frequency, a decrease is "improving" (lower risk is better).
+ */
+export function computeTrends(history) {
+    if (history.length < 2) {
+        return {
+            ahs_trend: 'stable',
+            dri_trend: 'stable',
+            eds_trend: 'stable',
+            sts_trend: 'stable',
+            override_trend: 'stable',
+            overall_trend: 'stable',
+        };
+    }
+    // Use last 5 entries (or fewer)
+    const recent = history.slice(-5);
+    const first = recent[0];
+    const last = recent[recent.length - 1];
+    return {
+        ahs_trend: trendDirection(last.ahs - first.ahs, false),
+        dri_trend: trendDirection(last.dri - first.dri, true), // inverted: decrease = improving
+        eds_trend: trendDirection(last.eds - first.eds, false),
+        sts_trend: trendDirection(last.sts - first.sts, false),
+        override_trend: trendDirection(last.override_frequency - first.override_frequency, true), // inverted
+        overall_trend: trendDirection(last.overall - first.overall, false),
+    };
+}
+/**
+ * Determine trend direction from a delta value.
+ *
+ * @param delta - The difference (last - first)
+ * @param inverted - If true, a negative delta is "improving" (e.g., DRI, overrides)
+ */
+function trendDirection(delta, inverted) {
+    const effectiveDelta = inverted ? -delta : delta;
+    if (effectiveDelta > TREND_THRESHOLD)
+        return 'improving';
+    if (effectiveDelta < -TREND_THRESHOLD)
+        return 'degrading';
+    return 'stable';
+}
+//# sourceMappingURL=store.js.map

package/dist/dashboard/store.js.map

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

package/dist/index.d.ts

@@ -51,4 +51,14 @@ export * from './team-metrics/index.js';
 export * from './provenance/index.js';
 export * from './policy-sim/index.js';
 export * from './orchestrator/index.js';
+export * from './pulse/index.js';
+export * from './layer-d/index.js';
+export * from './severity/index.js';
+export * from './claims/index.js';
+export * from './staleness/index.js';
+export * from './integration/index.js';
+export * from './trust/index.js';
+export * from './dashboard/index.js';
+export * from './intervention/index.js';
+export * from './policy-domains/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -53,4 +53,23 @@ export * from './team-metrics/index.js';
 export * from './provenance/index.js';
 export * from './policy-sim/index.js';
 export * from './orchestrator/index.js';
+// v2.5 — Pulse: Ambient Session Discovery
+export * from './pulse/index.js';
+// Layer D — Semantic / Signature Conflict Detection
+export * from './layer-d/index.js';
+// v2.6 — Conflict Severity Matrix & Soft Claims
+export * from './severity/index.js';
+export * from './claims/index.js';
+// v2.7 — JIT Staleness / Context Shadowing
+export * from './staleness/index.js';
+// v2.8 — Ambient Coordination Integration Layer
+export * from './integration/index.js';
+// v3.0 — Executive Trust: Command Capsules & Approval Workflow
+export * from './trust/index.js';
+// v3.1 — Architecture Health Dashboard
+export * from './dashboard/index.js';
+// v3.2 — Architecture Intervention Engine
+export * from './intervention/index.js';
+// v3.3 — Policy Domain Framework (Governance-as-Code)
+export * from './policy-domains/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,wDAAwD;AACxD,cAAc,oBAAoB,CAAC;AAEnC,yCAAyC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,wDAAwD;AACxD,cAAc,oBAAoB,CAAC;AAEnC,yCAAyC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC,0CAA0C;AAC1C,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,oBAAoB,CAAC;AAEnC,gDAAgD;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAElC,2CAA2C;AAC3C,cAAc,sBAAsB,CAAC;AAErC,gDAAgD;AAChD,cAAc,wBAAwB,CAAC;AAEvC,+DAA+D;AAC/D,cAAc,kBAAkB,CAAC;AAEjC,uCAAuC;AACvC,cAAc,sBAAsB,CAAC;AAErC,0CAA0C;AAC1C,cAAc,yBAAyB,CAAC;AAExC,sDAAsD;AACtD,cAAc,2BAA2B,CAAC"}

package/dist/integration/ambient-coordinator.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Ambient Coordinator — Integration Layer (Part G)
+ *
+ * Wires the new ambient coordination subsystems into existing
+ * CodeLedger architecture:
+ *
+ * - Pulse → SCE (slice builder), CCS (confidence scoring), ISC (intent sufficiency)
+ * - Layer D → dependency graph, intent model
+ * - Staleness → ECL-Lite history, failure hotspots
+ * - Claims → session awareness, multi-agent coordination
+ *
+ * This module provides a unified entry point for ambient coordination,
+ * keeping subsystems loosely coupled while enabling cross-system data flow.
+ */
+import type { PulseSession, PulseState, LayerDConflict, LayerDAnalysis, ConflictSeverityAssessment, SoftClaim, ShadowUpdate, SessionRecord, ConflictZone, SeverityConfig, ISODateTime } from '@codeledger/types';
+/** Full ambient coordination status for a repository */
+export interface AmbientStatus {
+    pulse: PulseState;
+    activeClaims: SoftClaim[];
+    fileConflicts: ConflictZone[];
+    semanticConflicts: LayerDAnalysis | null;
+    severityAssessments: ConflictSeverityAssessment[];
+    staleness: ShadowUpdate[];
+    timestamp: ISODateTime;
+}
+/**
+ * Run Pulse scan and return inferred sessions.
+ * These sessions can feed into ISC (intent sufficiency) and SCE (slice builder)
+ * as candidate task contexts.
+ */
+export declare function discoverSessions(repoRoot: string): PulseSession[];
+/**
+ * Extract intent keywords from Pulse sessions for ISC cross-referencing.
+ * Returns a map of sessionId → intent keywords.
+ */
+export declare function extractIntentKeywords(sessions: PulseSession[]): Map<string, string[]>;
+/**
+ * Run Layer D analysis across active sessions.
+ * Compares public surfaces to detect semantic/signature conflicts.
+ */
+export declare function analyzeSemanticConflicts(repoRoot: string, sessions: SessionRecord[]): LayerDAnalysis;
+/**
+ * Compute severity assessments for all session pairs.
+ * Combines file-level conflict zones with Layer D semantic conflicts.
+ */
+export declare function assessConflictSeverity(sessions: SessionRecord[], fileConflicts: ConflictZone[], semanticConflicts: LayerDConflict[], config?: SeverityConfig): ConflictSeverityAssessment[];
+/**
+ * Compute staleness for all active sessions.
+ * Integrates with ECL-Lite history by using the session's activation ref
+ * as the staleness baseline.
+ */
+export declare function computeSessionStaleness(repoRoot: string, sessions: SessionRecord[], activationRefs: Map<string, string>): ShadowUpdate[];
+/**
+ * Sync a session's working set to a soft claim.
+ * Called after Pulse scan to keep claims up-to-date.
+ */
+export declare function syncPulseToClaims(repoRoot: string, pulseSession: PulseSession, actorId: string): SoftClaim;
+/**
+ * Get formatted presence summary for display.
+ * Combines claims from all sources (explicit + Pulse-synced).
+ */
+export declare function getPresenceSummary(repoRoot: string): string[];
+/**
+ * Run a complete ambient coordination scan.
+ * This is the main entry point for the integration layer.
+ *
+ * Steps:
+ * 1. Run Pulse to discover sessions
+ * 2. Read active claims
+ * 3. Analyze semantic conflicts (if multiple sessions)
+ * 4. Compute severity assessments
+ * 5. Compute staleness for each session
+ */
+export declare function runAmbientScan(repoRoot: string, sessions: SessionRecord[], fileConflicts: ConflictZone[], activationRefs: Map<string, string>): AmbientStatus;
+//# sourceMappingURL=ambient-coordinator.d.ts.map

package/dist/integration/ambient-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-coordinator.d.ts","sourceRoot":"","sources":["../../src/integration/ambient-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAU3B,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,iBAAiB,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,mBAAmB,EAAE,0BAA0B,EAAE,CAAC;IAClD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,WAAW,CAAC;CACxB;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAEjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CASvB;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EAAE,GACxB,cAAc,CAgBhB;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EAAE,EACzB,aAAa,EAAE,YAAY,EAAE,EAC7B,iBAAiB,EAAE,cAAc,EAAE,EACnC,MAAM,GAAE,cAAwC,GAC/C,0BAA0B,EAAE,CA8C9B;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EAAE,EACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,YAAY,EAAE,CAmBhB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,GACd,SAAS,CASX;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAY7D;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EAAE,EACzB,aAAa,EAAE,YAAY,EAAE,EAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,aAAa,CAkCf"}

package/dist/integration/ambient-coordinator.js

@@ -0,0 +1,183 @@
+/**
+ * Ambient Coordinator — Integration Layer (Part G)
+ *
+ * Wires the new ambient coordination subsystems into existing
+ * CodeLedger architecture:
+ *
+ * - Pulse → SCE (slice builder), CCS (confidence scoring), ISC (intent sufficiency)
+ * - Layer D → dependency graph, intent model
+ * - Staleness → ECL-Lite history, failure hotspots
+ * - Claims → session awareness, multi-agent coordination
+ *
+ * This module provides a unified entry point for ambient coordination,
+ * keeping subsystems loosely coupled while enabling cross-system data flow.
+ */
+import { runPulseScan, loadPulseState } from '../pulse/index.js';
+import { extractSessionSurface, detectLayerDConflicts } from '../layer-d/index.js';
+import { computeSeverity, buildSignalsFromOverlap, DEFAULT_SEVERITY_CONFIG } from '../severity/index.js';
+import { writeClaim, readActiveClaims, pruneExpiredClaims, getPresence } from '../claims/index.js';
+import { computeShadowUpdate } from '../staleness/index.js';
+// ─── Pulse → Intent Feed ───────────────────────────────────────────────────
+/**
+ * Run Pulse scan and return inferred sessions.
+ * These sessions can feed into ISC (intent sufficiency) and SCE (slice builder)
+ * as candidate task contexts.
+ */
+export function discoverSessions(repoRoot) {
+    return runPulseScan(repoRoot);
+}
+/**
+ * Extract intent keywords from Pulse sessions for ISC cross-referencing.
+ * Returns a map of sessionId → intent keywords.
+ */
+export function extractIntentKeywords(sessions) {
+    const result = new Map();
+    for (const s of sessions) {
+        const keywords = s.candidateIntent
+            .split(/[\s+\-_]/)
+            .filter((k) => k.length > 2);
+        result.set(s.sessionId, keywords);
+    }
+    return result;
+}
+// ─── Layer D → Dependency Graph Feed ───────────────────────────────────────
+/**
+ * Run Layer D analysis across active sessions.
+ * Compares public surfaces to detect semantic/signature conflicts.
+ */
+export function analyzeSemanticConflicts(repoRoot, sessions) {
+    // Extract public surfaces for each session's files
+    const surfaces = sessions
+        .filter(s => s.bundle_files.length > 0)
+        .map(s => {
+        const fullPaths = s.bundle_files.map(f => `${repoRoot}/${f}`);
+        return extractSessionSurface(s.session_id, fullPaths);
+    });
+    // Build dependency surface map (session → directories of their files)
+    const depSurfaces = new Map();
+    for (const s of sessions) {
+        depSurfaces.set(s.session_id, s.bundle_files);
+    }
+    return detectLayerDConflicts(surfaces, depSurfaces);
+}
+// ─── Severity Assessment ───────────────────────────────────────────────────
+/**
+ * Compute severity assessments for all session pairs.
+ * Combines file-level conflict zones with Layer D semantic conflicts.
+ */
+export function assessConflictSeverity(sessions, fileConflicts, semanticConflicts, config = DEFAULT_SEVERITY_CONFIG) {
+    const assessments = [];
+    const processedPairs = new Set();
+    // Group file conflicts by session pairs
+    for (const session of sessions) {
+        const sessionConflicts = fileConflicts.filter(z => z.other_session !== session.session_id);
+        for (const conflict of sessionConflicts) {
+            const pairKey = [session.session_id, conflict.other_session].sort().join('::');
+            if (processedPairs.has(pairKey))
+                continue;
+            processedPairs.add(pairKey);
+            const overlappingFiles = fileConflicts
+                .filter(z => (z.other_session === conflict.other_session) ||
+                (z.other_session === session.session_id))
+                .map(z => z.file);
+            const semanticForPair = semanticConflicts.filter(c => (c.producerSession === session.session_id &&
+                c.consumerSessions.includes(conflict.other_session)) ||
+                (c.producerSession === conflict.other_session &&
+                    c.consumerSessions.includes(session.session_id)));
+            const signals = buildSignalsFromOverlap(overlappingFiles, [], // dependency overlaps computed separately
+            [], // shared test surface
+            false, // branch divergence
+            semanticForPair.map(c => ({ symbol: c.affectedSymbol, file: c.file })), config.weights);
+            assessments.push(computeSeverity(signals, [session.session_id, conflict.other_session], config));
+        }
+    }
+    return assessments.sort((a, b) => b.aggregateScore - a.aggregateScore);
+}
+// ─── Staleness Integration ─────────────────────────────────────────────────
+/**
+ * Compute staleness for all active sessions.
+ * Integrates with ECL-Lite history by using the session's activation ref
+ * as the staleness baseline.
+ */
+export function computeSessionStaleness(repoRoot, sessions, activationRefs) {
+    const updates = [];
+    for (const session of sessions) {
+        const ref = activationRefs.get(session.session_id);
+        if (!ref)
+            continue;
+        const update = computeShadowUpdate(repoRoot, session.session_id, session.bundle_files, [], // dependency surface from Pulse
+        ref);
+        updates.push(update);
+    }
+    return updates;
+}
+// ─── Claims Integration ────────────────────────────────────────────────────
+/**
+ * Sync a session's working set to a soft claim.
+ * Called after Pulse scan to keep claims up-to-date.
+ */
+export function syncPulseToClaims(repoRoot, pulseSession, actorId) {
+    return writeClaim(repoRoot, {
+        sessionId: pulseSession.sessionId,
+        actorId,
+        timestamp: pulseSession.timestamp,
+        touchedFiles: pulseSession.touchedFiles,
+        dependencySurface: pulseSession.dependencySurface,
+        intentLabel: pulseSession.candidateIntent,
+    });
+}
+/**
+ * Get formatted presence summary for display.
+ * Combines claims from all sources (explicit + Pulse-synced).
+ */
+export function getPresenceSummary(repoRoot) {
+    pruneExpiredClaims(repoRoot);
+    const presence = getPresence(repoRoot);
+    if (presence.length === 0)
+        return ['No active claims detected.'];
+    const lines = [];
+    for (const p of presence) {
+        const actors = p.actors.map((a) => `${a.actorId} (${a.intentLabel})`).join(', ');
+        lines.push(`${p.file}: ${actors}`);
+    }
+    return lines;
+}
+// ─── Full Ambient Scan ─────────────────────────────────────────────────────
+/**
+ * Run a complete ambient coordination scan.
+ * This is the main entry point for the integration layer.
+ *
+ * Steps:
+ * 1. Run Pulse to discover sessions
+ * 2. Read active claims
+ * 3. Analyze semantic conflicts (if multiple sessions)
+ * 4. Compute severity assessments
+ * 5. Compute staleness for each session
+ */
+export function runAmbientScan(repoRoot, sessions, fileConflicts, activationRefs) {
+    // 1. Pulse scan
+    discoverSessions(repoRoot);
+    const pulseState = loadPulseState(repoRoot);
+    // 2. Active claims
+    pruneExpiredClaims(repoRoot);
+    const activeClaims = readActiveClaims(repoRoot);
+    // 3. Semantic conflicts (only if multiple sessions)
+    let semanticConflicts = null;
+    if (sessions.length >= 2) {
+        semanticConflicts = analyzeSemanticConflicts(repoRoot, sessions);
+    }
+    // 4. Severity assessments
+    const severityAssessments = assessConflictSeverity(sessions, fileConflicts, semanticConflicts?.conflicts ?? []);
+    // 5. Staleness
+    const staleness = computeSessionStaleness(repoRoot, sessions, activationRefs);
+    return {
+        pulse: pulseState,
+        activeClaims,
+        fileConflicts,
+        semanticConflicts,
+        severityAssessments,
+        staleness,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=ambient-coordinator.js.map

package/dist/integration/ambient-coordinator.js.map

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

package/dist/integration/index.d.ts

@@ -0,0 +1,4 @@
+export { discoverSessions, extractIntentKeywords, analyzeSemanticConflicts, assessConflictSeverity, computeSessionStaleness, syncPulseToClaims, getPresenceSummary, runAmbientScan, } from './ambient-coordinator.js';
+export type { AmbientStatus } from './ambient-coordinator.js';
+export { generateFileOverlapWarnings, generateSeverityWarnings, generateStalenessWarnings, deduplicateWarningsByPair, throttleWarnings, formatWarnings, loadThrottleState, saveThrottleState, warningHash, warningDedupKey, coalesceWarnings, } from './warning-throttle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/integration/index.js

@@ -0,0 +1,3 @@
+export { discoverSessions, extractIntentKeywords, analyzeSemanticConflicts, assessConflictSeverity, computeSessionStaleness, syncPulseToClaims, getPresenceSummary, runAmbientScan, } from './ambient-coordinator.js';
+export { generateFileOverlapWarnings, generateSeverityWarnings, generateStalenessWarnings, deduplicateWarningsByPair, throttleWarnings, formatWarnings, loadThrottleState, saveThrottleState, warningHash, warningDedupKey, coalesceWarnings, } from './warning-throttle.js';
+//# sourceMappingURL=index.js.map

package/dist/integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/integration/warning-throttle.d.ts

@@ -0,0 +1,63 @@
+import type { ConflictWarning, WarningThrottleState, ConflictZone, ConflictSeverityAssessment, ShadowUpdate } from '@codeledger/types';
+/**
+ * Generate conflict warnings from file overlap zones.
+ *
+ * Hardened: severity is based on overlapping file count with graduated thresholds.
+ * Only MEDIUM+ severity overlaps generate warnings (1-file overlap = LOW = silent).
+ */
+export declare function generateFileOverlapWarnings(sessionId: string, zones: ConflictZone[]): ConflictWarning[];
+/** Generate warnings from severity assessments (MEDIUM+ only) */
+export declare function generateSeverityWarnings(sessionId: string, assessments: ConflictSeverityAssessment[]): ConflictWarning[];
+/**
+ * Generate staleness warnings.
+ *
+ * Hardened: only generates warnings for MEDIUM+ staleness.
+ * LOW staleness is too noisy for user-facing warnings — it is recorded
+ * in the PRCheckResult for programmatic consumers but not surfaced.
+ */
+export declare function generateStalenessWarnings(updates: ShadowUpdate[]): ConflictWarning[];
+/**
+ * Merge overlapping warnings for the same session pair.
+ * Prevents both a file-overlap warning and a severity warning for the
+ * same pair from reaching the user — keeps only the higher-severity one.
+ */
+export declare function deduplicateWarningsByPair(warnings: ConflictWarning[]): ConflictWarning[];
+/**
+ * Compute a content hash for a warning (for dedup).
+ * Hardened: includes severity in hash so severity changes bypass throttle.
+ */
+export declare function warningHash(warning: ConflictWarning): string;
+/**
+ * Compute a dedup key for a warning based on type and session pair.
+ */
+export declare function warningDedupKey(warning: ConflictWarning): string;
+/**
+ * Coalesce redundant warnings for the same session pair.
+ * Alias for deduplicateWarningsByPair.
+ */
+export declare const coalesceWarnings: typeof deduplicateWarningsByPair;
+/** Load throttle state from disk */
+export declare function loadThrottleState(repoRoot: string, sessionId?: string): WarningThrottleState;
+/** Save throttle state to disk */
+export declare function saveThrottleState(repoRoot: string, state: WarningThrottleState, sessionId?: string): void;
+/**
+ * Filter warnings through throttle/dedup.
+ * Returns only warnings that should be shown to the user.
+ *
+ * Hardened algorithm:
+ * 1. Deduplicate by session pair (one-warning-per-surface)
+ * 2. Apply severity-aware cooldown windows
+ * 3. Same-signal suppression (skip if material content unchanged)
+ * 4. Severity escalation bypass (always show if severity increased)
+ */
+export declare function throttleWarnings(repoRoot: string, warnings: ConflictWarning[], throttleIntervalMs?: number, sessionId?: string): ConflictWarning[];
+/**
+ * Format warnings as human-readable lines.
+ *
+ * Hardened tone: measured, technical, precise.
+ * - HIGH → "Warning" (not "CRITICAL" or "ALERT")
+ * - MEDIUM → "Notice"
+ * - LOW → "Info"
+ */
+export declare function formatWarnings(warnings: ConflictWarning[]): string[];
+//# sourceMappingURL=warning-throttle.d.ts.map

package/dist/integration/warning-throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning-throttle.d.ts","sourceRoot":"","sources":["../../src/integration/warning-throttle.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAEpB,YAAY,EACZ,0BAA0B,EAC1B,YAAY,EAEb,MAAM,mBAAmB,CAAC;AA6B3B;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,EAAE,GACpB,eAAe,EAAE,CA0CnB;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,0BAA0B,EAAE,GACxC,eAAe,EAAE,CA6BnB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EAAE,GACtB,eAAe,EAAE,CAqCnB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAiCxF;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAO5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAGhE;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,kCAA4B,CAAC;AAgB1D,oCAAoC;AACpC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAgB5F;AAED,kCAAkC;AAClC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAKzG;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,EAAE,EAC3B,kBAAkB,CAAC,EAAE,MAAM,EAC3B,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAuEnB;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CASpE"}