@codeledger/engine 0.7.1 → 0.7.3

package/dist/integration/warning-throttle.js

@@ -0,0 +1,347 @@
+/**
+ * Ambient Conflict Warning — Throttling & Deduplication (Hardened v2.5.1)
+ *
+ * Generates conflict warnings when sessions overlap, with
+ * throttle logic to prevent warning spam. Warnings are
+ * deduplicated by content hash and throttled by time interval.
+ *
+ * Hardening guarantees:
+ * - Per-session warning deduplication (same hash never repeats within cooldown)
+ * - Severity-aware cooldown windows (HIGH=5min, MEDIUM=15min, LOW=30min)
+ * - "Same signal" suppression: if the underlying data hasn't materially changed,
+ *   the warning is suppressed even after cooldown expires
+ * - One-warning-per-surface: overlapping file warnings and severity warnings
+ *   for the same session pair are merged into a single warning
+ * - Staleness warnings only escalate (low→medium→high), never re-emit at same level
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const THROTTLE_FILE = '.codeledger/warning-throttle.json';
+const MAX_WARNINGS_RETAINED = 100;
+/**
+ * Severity-aware cooldown intervals.
+ * HIGH warnings have short cooldowns (they represent real risk).
+ * LOW warnings have long cooldowns (they are informational noise).
+ */
+const COOLDOWN_BY_SEVERITY = {
+    HIGH: 5 * 60 * 1000, // 5 minutes — real risk, show relatively quickly
+    MEDIUM: 15 * 60 * 1000, // 15 minutes — advisory, moderate cooldown
+    LOW: 30 * 60 * 1000, // 30 minutes — informational, long cooldown
+};
+/**
+ * Resolve the throttle file path. When a sessionId is provided, the throttle
+ * state is stored per-session to avoid cross-session warning suppression.
+ */
+function resolveThrottlePath(repoRoot, sessionId) {
+    if (sessionId) {
+        return join(repoRoot, '.codeledger', 'sessions', sessionId, 'warning-throttle.json');
+    }
+    return join(repoRoot, THROTTLE_FILE);
+}
+// ─── Warning Generation ────────────────────────────────────────────────────
+/**
+ * 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 function generateFileOverlapWarnings(sessionId, zones) {
+    if (zones.length === 0)
+        return [];
+    // Group zones by other session
+    const bySession = new Map();
+    for (const z of zones) {
+        const existing = bySession.get(z.other_session) ?? [];
+        existing.push(z);
+        bySession.set(z.other_session, existing);
+    }
+    const warnings = [];
+    const now = new Date().toISOString();
+    for (const [otherSession, sessionZones] of bySession) {
+        const files = [...new Set(sessionZones.map(z => z.file))];
+        const severity = files.length >= 5 ? 'HIGH' :
+            files.length >= 3 ? 'MEDIUM' :
+                files.length >= 2 ? 'MEDIUM' :
+                    'LOW';
+        // Hardened: single-file overlaps are LOW and will be suppressed by default.
+        // Only surface them if they are in the same module (meaningful overlap).
+        const fileList = files.slice(0, 4).join(', ');
+        const suffix = files.length > 4 ? ` (+${files.length - 4} more)` : '';
+        // Suppress single-file LOW overlap — not actionable enough to surface
+        if (severity === 'LOW')
+            continue;
+        warnings.push({
+            sessionId,
+            message: `${files.length} shared file(s) with session ${otherSession}: ${fileList}${suffix}`,
+            severity,
+            overlappingFiles: files,
+            relatedSessions: [otherSession],
+            timestamp: now,
+            warningType: 'file_overlap',
+        });
+    }
+    return warnings;
+}
+/** Generate warnings from severity assessments (MEDIUM+ only) */
+export function generateSeverityWarnings(sessionId, assessments) {
+    const warnings = [];
+    const now = new Date().toISOString();
+    for (const assessment of assessments) {
+        if (assessment.level === 'LOW')
+            continue; // Only warn on MEDIUM+
+        const otherSession = assessment.sessionPair.find(s => s !== sessionId) ?? assessment.sessionPair[1];
+        // Hardened: produce concise, technical signal summaries
+        const signalSummaries = assessment.signals
+            .filter(s => s.weight >= 0.4) // Only include meaningful signals in message
+            .map(s => s.details);
+        const signalText = signalSummaries.length > 0
+            ? signalSummaries.join('; ')
+            : `aggregate score ${assessment.aggregateScore.toFixed(2)}`;
+        warnings.push({
+            sessionId,
+            message: `${assessment.level} conflict risk with session ${otherSession}: ${signalText}`,
+            severity: assessment.level,
+            overlappingFiles: [],
+            relatedSessions: [otherSession],
+            timestamp: now,
+            warningType: 'severity_assessment',
+        });
+    }
+    return warnings;
+}
+/**
+ * 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 function generateStalenessWarnings(updates) {
+    const warnings = [];
+    const now = new Date().toISOString();
+    for (const update of updates) {
+        // Hardened: suppress fresh and low staleness entirely
+        if (update.stalenessLevel === 'fresh' || update.stalenessLevel === 'low')
+            continue;
+        const severity = update.stalenessLevel === 'high' ? 'HIGH' : 'MEDIUM';
+        const changedFiles = update.changedFiles.map(f => f.path);
+        // Hardened: provide specific, actionable summary
+        const bundleChanges = update.changedFiles.filter(f => f.inBundle);
+        const depChanges = update.changedFiles.filter(f => !f.inBundle && f.inDependencySurface);
+        const parts = [];
+        if (bundleChanges.length > 0) {
+            parts.push(`${bundleChanges.length} bundle file(s) changed`);
+        }
+        if (depChanges.length > 0) {
+            parts.push(`${depChanges.length} dependency file(s) changed`);
+        }
+        const detail = parts.length > 0 ? parts.join(', ') : update.summary;
+        warnings.push({
+            sessionId: update.sessionId,
+            message: `Context staleness (${update.stalenessLevel}): ${detail}. Refresh recommended before PR.`,
+            severity,
+            overlappingFiles: changedFiles,
+            relatedSessions: [],
+            timestamp: now,
+            warningType: 'staleness',
+        });
+    }
+    return warnings;
+}
+/**
+ * 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 function deduplicateWarningsByPair(warnings) {
+    if (warnings.length <= 1)
+        return warnings;
+    // Build a key for each warning based on session pair
+    const pairMap = new Map();
+    const severityOrder = { HIGH: 3, MEDIUM: 2, LOW: 1 };
+    for (const w of warnings) {
+        // Staleness warnings have no related sessions — keep them separate
+        if (w.relatedSessions.length === 0) {
+            pairMap.set(`staleness:${w.sessionId}:${w.severity}`, w);
+            continue;
+        }
+        const pairKey = [w.sessionId, ...w.relatedSessions].sort().join('::');
+        const existing = pairMap.get(pairKey);
+        if (!existing || severityOrder[w.severity] > severityOrder[existing.severity]) {
+            // Merge overlapping files from both warnings
+            if (existing) {
+                const mergedFiles = [...new Set([...w.overlappingFiles, ...existing.overlappingFiles])];
+                pairMap.set(pairKey, { ...w, overlappingFiles: mergedFiles });
+            }
+            else {
+                pairMap.set(pairKey, w);
+            }
+        }
+        else if (existing && severityOrder[w.severity] === severityOrder[existing.severity]) {
+            // Same severity — merge files
+            const mergedFiles = [...new Set([...existing.overlappingFiles, ...w.overlappingFiles])];
+            pairMap.set(pairKey, { ...existing, overlappingFiles: mergedFiles });
+        }
+    }
+    return [...pairMap.values()];
+}
+// ─── Throttle State ────────────────────────────────────────────────────────
+/**
+ * Compute a content hash for a warning (for dedup).
+ * Hardened: includes severity in hash so severity changes bypass throttle.
+ */
+export function warningHash(warning) {
+    const hash = createHash('sha256');
+    hash.update(warning.sessionId);
+    hash.update(warning.severity);
+    hash.update(warning.overlappingFiles.sort().join(','));
+    hash.update(warning.relatedSessions.sort().join(','));
+    return hash.digest('hex').slice(0, 16);
+}
+/**
+ * Compute a dedup key for a warning based on type and session pair.
+ */
+export function warningDedupKey(warning) {
+    const sessions = [warning.sessionId, ...warning.relatedSessions].sort().join('::');
+    return `${warning.warningType}:${sessions}`;
+}
+/**
+ * Coalesce redundant warnings for the same session pair.
+ * Alias for deduplicateWarningsByPair.
+ */
+export const coalesceWarnings = deduplicateWarningsByPair;
+/**
+ * Compute a "signal fingerprint" that captures the material content of a warning.
+ * Used for same-signal suppression: if the fingerprint hasn't changed since last
+ * emission, the warning is suppressed even after cooldown expires.
+ */
+function signalFingerprint(warning) {
+    const hash = createHash('sha256');
+    hash.update(warning.sessionId);
+    // Don't include severity — we want to detect when severity changes
+    hash.update(warning.overlappingFiles.sort().join(','));
+    hash.update(warning.relatedSessions.sort().join(','));
+    return hash.digest('hex').slice(0, 12);
+}
+/** Load throttle state from disk */
+export function loadThrottleState(repoRoot, sessionId) {
+    const statePath = resolveThrottlePath(repoRoot, sessionId);
+    if (existsSync(statePath)) {
+        try {
+            const raw = JSON.parse(readFileSync(statePath, 'utf-8'));
+            // Migrate v1 entries that lack dedupKey/severity
+            for (const entry of raw.lastWarnings) {
+                if (!entry.dedupKey)
+                    entry.dedupKey = entry.hash;
+                if (!entry.severity)
+                    entry.severity = 'LOW';
+            }
+            return raw;
+        }
+        catch {
+            // Corrupted — start fresh
+        }
+    }
+    return { schema_version: 'warning-throttle/v1', lastWarnings: [] };
+}
+/** Save throttle state to disk */
+export function saveThrottleState(repoRoot, state, sessionId) {
+    const statePath = resolveThrottlePath(repoRoot, sessionId);
+    const dir = dirname(statePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n', 'utf-8');
+}
+// ─── Throttle & Dedup ──────────────────────────────────────────────────────
+/**
+ * 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 function throttleWarnings(repoRoot, warnings, throttleIntervalMs, sessionId) {
+    if (warnings.length === 0)
+        return [];
+    // Step 1: deduplicate by session pair before throttling
+    const deduped = deduplicateWarningsByPair(warnings);
+    const state = loadThrottleState(repoRoot, sessionId);
+    const now = Date.now();
+    // Build lookups from stored state
+    const recentByHash = new Map();
+    const recentByFingerprint = new Map();
+    for (const entry of state.lastWarnings) {
+        recentByHash.set(entry.hash, new Date(entry.timestamp).getTime());
+        if (entry.fingerprint && entry.severity) {
+            recentByFingerprint.set(entry.fingerprint, {
+                severity: entry.severity,
+                timestamp: new Date(entry.timestamp).getTime(),
+            });
+        }
+    }
+    const passed = [];
+    const newEntries = [];
+    const severityOrder = { HIGH: 3, MEDIUM: 2, LOW: 1 };
+    for (const warning of deduped) {
+        const hash = warningHash(warning);
+        const fp = signalFingerprint(warning);
+        const cooldown = throttleIntervalMs ?? COOLDOWN_BY_SEVERITY[warning.severity];
+        const lastSeen = recentByHash.get(hash);
+        const lastSignal = recentByFingerprint.get(fp);
+        // Check 1: exact duplicate within cooldown → suppress
+        if (lastSeen !== undefined && now - lastSeen < cooldown) {
+            continue;
+        }
+        // Check 2: same-signal suppression — if the fingerprint matches and severity
+        // hasn't escalated, suppress (the user already saw this signal)
+        if (lastSignal !== undefined) {
+            const severityEscalated = severityOrder[warning.severity] > severityOrder[lastSignal.severity];
+            if (!severityEscalated && now - lastSignal.timestamp < cooldown * 2) {
+                // Same signal, same or lower severity, within 2× cooldown → suppress
+                continue;
+            }
+        }
+        passed.push(warning);
+        newEntries.push({
+            hash,
+            dedupKey: `${warning.sessionId}:${warning.severity}`,
+            timestamp: new Date(now).toISOString(),
+            fingerprint: fp,
+            severity: warning.severity,
+        });
+    }
+    // Update state: merge new entries, prune old (4× longest cooldown)
+    const maxRetention = COOLDOWN_BY_SEVERITY.LOW * 4;
+    const updatedWarnings = [...state.lastWarnings, ...newEntries]
+        .filter(e => now - new Date(e.timestamp).getTime() < maxRetention)
+        .slice(-MAX_WARNINGS_RETAINED);
+    saveThrottleState(repoRoot, {
+        schema_version: 'warning-throttle/v1',
+        lastWarnings: updatedWarnings,
+    }, sessionId);
+    return passed;
+}
+// ─── Formatting ─────────────────────────────────────────────────────────────
+/**
+ * Format warnings as human-readable lines.
+ *
+ * Hardened tone: measured, technical, precise.
+ * - HIGH → "Warning" (not "CRITICAL" or "ALERT")
+ * - MEDIUM → "Notice"
+ * - LOW → "Info"
+ */
+export function formatWarnings(warnings) {
+    if (warnings.length === 0)
+        return [];
+    const lines = [];
+    for (const w of warnings) {
+        const prefix = w.severity === 'HIGH' ? 'Warning' : w.severity === 'MEDIUM' ? 'Notice' : 'Info';
+        lines.push(`  [${prefix}] ${w.message}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=warning-throttle.js.map

package/dist/integration/warning-throttle.js.map

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

package/dist/intervention/escalation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Escalation Engine — Architecture Intervention Engine
+ *
+ * Takes aggregated signals and determines the escalation level
+ * based on severity distribution and compound escalation rules.
+ */
+import type { AggregatedSignal, EscalationResult } from '@codeledger/types';
+/**
+ * Determine the escalation level from aggregated signals.
+ *
+ * Rules (evaluated top to bottom, first match wins):
+ * 1. Any critical signal → blocking
+ * 2. 3+ high signals in the same category → blocking
+ * 3. 2+ high signals across different categories → warning
+ * 4. Any high signal → advisory
+ * 5. Any medium signal → advisory
+ * 6. Only low signals → none
+ *
+ * Compound escalation: when drift + duplication + governance all have
+ * signals simultaneously, bump the level up by one.
+ */
+export declare function determineEscalation(signals: AggregatedSignal[]): EscalationResult;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/intervention/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../src/intervention/escalation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAyElG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAgFjF"}

package/dist/intervention/escalation.js

@@ -0,0 +1,149 @@
+/** All intervention categories for summary initialization. */
+const ALL_CATEGORIES = [
+    'drift_spike',
+    'duplication_pressure',
+    'governance_breakdown',
+    'architectural_violation',
+    'test_gap',
+    'scope_creep',
+];
+/** Categories that trigger compound escalation when all present. */
+const COMPOUND_TRIGGER_CATEGORIES = [
+    'drift_spike',
+    'duplication_pressure',
+    'governance_breakdown',
+];
+/**
+ * Build a signal count summary grouped by category.
+ */
+function buildSignalSummary(signals) {
+    const summary = {};
+    for (const cat of ALL_CATEGORIES) {
+        summary[cat] = 0;
+    }
+    for (const signal of signals) {
+        summary[signal.category] = (summary[signal.category] ?? 0) + 1;
+    }
+    return summary;
+}
+/**
+ * Count signals at a given severity level.
+ */
+function countBySeverity(signals, severity) {
+    return signals.filter((s) => s.severity === severity).length;
+}
+/**
+ * Count high-severity signals grouped by category, returning category counts.
+ */
+function highSignalsByCategory(signals) {
+    const map = new Map();
+    for (const signal of signals) {
+        if (signal.severity === 'high') {
+            map.set(signal.category, (map.get(signal.category) ?? 0) + 1);
+        }
+    }
+    return map;
+}
+/**
+ * Check whether compound escalation applies.
+ * Compound escalation triggers when drift + duplication + governance all have signals.
+ */
+function isCompoundEscalation(signals) {
+    const categoriesPresent = new Set(signals.map((s) => s.category));
+    return COMPOUND_TRIGGER_CATEGORIES.every((cat) => categoriesPresent.has(cat));
+}
+/** Escalation level ordering for bump operations. */
+const ESCALATION_ORDER = ['none', 'advisory', 'warning', 'blocking'];
+function bumpEscalation(level) {
+    const idx = ESCALATION_ORDER.indexOf(level);
+    if (idx < ESCALATION_ORDER.length - 1) {
+        return ESCALATION_ORDER[idx + 1];
+    }
+    return level;
+}
+/**
+ * Determine the escalation level from aggregated signals.
+ *
+ * Rules (evaluated top to bottom, first match wins):
+ * 1. Any critical signal → blocking
+ * 2. 3+ high signals in the same category → blocking
+ * 3. 2+ high signals across different categories → warning
+ * 4. Any high signal → advisory
+ * 5. Any medium signal → advisory
+ * 6. Only low signals → none
+ *
+ * Compound escalation: when drift + duplication + governance all have
+ * signals simultaneously, bump the level up by one.
+ */
+export function determineEscalation(signals) {
+    const summary = buildSignalSummary(signals);
+    const compound = isCompoundEscalation(signals);
+    if (signals.length === 0) {
+        return {
+            level: 'none',
+            reason: 'No signals detected',
+            compound_escalation: false,
+            signal_summary: summary,
+        };
+    }
+    let level = 'none';
+    let reason = '';
+    // Rule 1: Any critical signal → blocking
+    const criticalCount = countBySeverity(signals, 'critical');
+    if (criticalCount > 0) {
+        level = 'blocking';
+        reason = `${criticalCount} critical signal(s) detected`;
+    }
+    // Rule 2: 3+ high signals in same category → blocking
+    if (level !== 'blocking') {
+        const highByCategory = highSignalsByCategory(signals);
+        for (const [category, count] of highByCategory) {
+            if (count >= 3) {
+                level = 'blocking';
+                reason = `${count} high-severity signals in category '${category}'`;
+                break;
+            }
+        }
+    }
+    // Rule 3: 2+ high signals across different categories → warning
+    if (level !== 'blocking') {
+        const highByCategory = highSignalsByCategory(signals);
+        const categoriesWithHigh = highByCategory.size;
+        if (categoriesWithHigh >= 2) {
+            level = 'warning';
+            reason = `High-severity signals across ${categoriesWithHigh} categories`;
+        }
+    }
+    // Rule 4: Any high signal → advisory
+    if (level === 'none') {
+        const highCount = countBySeverity(signals, 'high');
+        if (highCount > 0) {
+            level = 'advisory';
+            reason = `${highCount} high-severity signal(s)`;
+        }
+    }
+    // Rule 5: Medium signals → advisory
+    if (level === 'none') {
+        const mediumCount = countBySeverity(signals, 'medium');
+        if (mediumCount > 0) {
+            level = 'advisory';
+            reason = `${mediumCount} medium-severity signal(s)`;
+        }
+    }
+    // Rule 6: Only low → none
+    if (level === 'none') {
+        reason = 'Only low-severity signals — tracked but no escalation';
+    }
+    // Compound escalation: bump one level if compound trigger applies
+    if (compound && level !== 'blocking') {
+        level = bumpEscalation(level);
+        reason = `${reason} [compound escalation: drift + duplication + governance converge]`;
+    }
+    return {
+        level,
+        reason,
+        compound_escalation: compound,
+        signal_summary: summary,
+    };
+}
+//# sourceMappingURL=escalation.js.map

package/dist/intervention/escalation.js.map

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

package/dist/intervention/generator.d.ts

@@ -0,0 +1,12 @@
+import type { AggregatedSignal, EscalationResult, Intervention } from '@codeledger/types';
+/**
+ * Generate prioritized interventions from escalation result and aggregated signals.
+ *
+ * Each intervention is actionable: it includes a title, description, affected files,
+ * a suggested fix, and optionally an agent-ready execution template.
+ *
+ * Interventions are sorted by priority (1 = highest), then by affected file count
+ * (more impacted first).
+ */
+export declare function generateInterventions(escalation: EscalationResult, signals: AggregatedSignal[]): Intervention[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/intervention/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/intervention/generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAuI3B;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,gBAAgB,EAAE,GAC1B,YAAY,EAAE,CAmDhB"}