@codeledger/aggregations 0.8.9

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 Intelligent Context AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This license applies to the CLI wrapper, types, repository scanning,
+instrumentation, harness, and report packages (the "Plugin"). The scoring
+engine (packages/core-engine/bin/) is licensed separately under LICENSE-CORE.

package/dist/engine.d.ts

@@ -0,0 +1,4 @@
+import type { FilterOptions, InsightEvent, InsightMetrics } from '@codeledger/types';
+export declare function computeMetrics(events: InsightEvent[], filters?: FilterOptions): InsightMetrics;
+export declare function filterEvents(events: InsightEvent[], filters: FilterOptions): InsightEvent[];
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EAEZ,cAAc,EAKf,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,cAAc,CAGlG;AAuGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,EAAE,CAW3F"}

package/dist/engine.js

@@ -0,0 +1,184 @@
+export function computeMetrics(events, filters = {}) {
+    const filtered = filterEvents(events, filters);
+    return computeMetricsFromFilteredEvents(filtered, true);
+}
+function computeMetricsFromFilteredEvents(filtered, includeTrend) {
+    const executions = filtered.filter((event) => event.type === 'EXECUTION_RESULT');
+    const policies = filtered.filter((event) => event.type === 'POLICY_EVALUATION');
+    const contexts = filtered.filter((event) => event.type === 'CONTEXT_EVALUATION');
+    const shadows = filtered.filter((event) => event.type === 'SHADOW_KNOWLEDGE_SIGNAL');
+    const patternEvents = filtered.filter((event) => event.type === 'PATTERN_REUSE');
+    const goldenPaths = filtered.filter((event) => event.type === 'GOLDEN_PATH_ADHERENCE');
+    const writeSafetySuccessRate = rate(executions.filter((event) => event.writeSafe === true).length, executions.filter((event) => event.writeSafe !== undefined).length);
+    const redactRate = rate(executions.filter((event) => event.redactApplied === true).length, executions.filter((event) => event.redactApplied !== undefined).length);
+    const rejectRate = rate(executions.filter((event) => event.rejected === true).length, executions.filter((event) => event.rejected !== undefined).length);
+    const integrityDrift = rate(policies.filter((event) => event.violations > 0).length, policies.length);
+    const firstPassSuccessRate = rate(executions.filter((event) => event.firstPass === true && event.status === 'success').length, executions.filter((event) => event.firstPass !== undefined).length);
+    const reworkRatio = rate(executions.filter((event) => event.rework === true).length, executions.filter((event) => event.rework !== undefined).length);
+    const executionReliability = rate(executions.filter((event) => event.status === 'success').length, executions.length);
+    const patternReuseRate = rate(patternEvents.filter((event) => event.type === 'PATTERN_REUSE' && event.reused).length, patternEvents.length);
+    const timeToContext = averageMetric(contexts.map((event) => Math.max(1, Math.round(event.totalTokens / 500))));
+    const shadowKnowledgeIndex = averageMetric(shadows.map((event) => clamp(event.weight)));
+    const goldenPathAdherence = rate(goldenPaths.filter((event) => event.type === 'GOLDEN_PATH_ADHERENCE' && event.adhered).length, goldenPaths.length);
+    const primitiveAdoptionRate = rate(new Set(patternEvents.filter((event) => event.type === 'PATTERN_REUSE' && event.reused).map((event) => event.primitive)).size, new Set(patternEvents.filter((event) => event.type === 'PATTERN_REUSE').map((event) => event.primitive)).size);
+    // Efficiency: Prompt Lift (blended), Context Compression, Waste Avoided
+    const refinements = filtered.filter((event) => event.type === 'PROMPT_REFINEMENT');
+    const promptLift = computePromptLift(refinements);
+    const contextCompression = refinements.length > 0
+        ? averageMetric(refinements.map((e) => clamp(e.contextReductionPct / 100)))
+        : rate(0, 0);
+    const wasteAvoided = computeWasteAvoided(refinements, executions);
+    return {
+        integrity: {
+            writeSafetySuccessRate,
+            redactRate,
+            rejectRate,
+            integrityDrift,
+        },
+        quality: {
+            firstPassSuccessRate,
+            reworkRatio,
+            executionReliability,
+        },
+        knowledge: {
+            patternReuseRate,
+            timeToContext,
+            shadowKnowledgeIndex,
+        },
+        patterns: {
+            goldenPathAdherence,
+            primitiveAdoptionRate,
+        },
+        efficiency: {
+            promptLift,
+            contextCompression,
+            wasteAvoided,
+        },
+        overview: {
+            eventCount: filtered.length,
+            repos: Array.from(new Set(filtered.map((event) => event.repo))).sort(),
+            teams: Array.from(new Set(filtered.map((event) => event.team).filter((team) => Boolean(team)))).sort(),
+            trend: includeTrend ? buildTrend(filtered) : [],
+        },
+    };
+}
+export function filterEvents(events, filters) {
+    return events.filter((event) => {
+        if (filters.repo && event.repo !== filters.repo)
+            return false;
+        if (filters.team && event.team !== filters.team)
+            return false;
+        if (filters.dateFrom && event.timestamp < filters.dateFrom)
+            return false;
+        if (filters.dateTo && event.timestamp > filters.dateTo)
+            return false;
+        if (filters.syntheticOnly === true && !event.isSynthetic)
+            return false;
+        if (filters.syntheticOnly === false && event.isSynthetic)
+            return false;
+        if (filters.scenarioId && event.scenarioId !== filters.scenarioId)
+            return false;
+        return true;
+    });
+}
+function buildTrend(events) {
+    const days = new Map();
+    for (const event of events) {
+        const day = event.timestamp.slice(0, 10);
+        const bucket = days.get(day) ?? [];
+        bucket.push(event);
+        days.set(day, bucket);
+    }
+    return Array.from(days.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .slice(-30)
+        .map(([date, bucket]) => {
+        const metrics = computeMetricsFromFilteredEvents(bucket, false);
+        return {
+            date,
+            integrity: metrics.integrity.writeSafetySuccessRate.value,
+            quality: metrics.quality.executionReliability.value,
+            knowledge: 1 - metrics.knowledge.shadowKnowledgeIndex.value,
+            patterns: metrics.patterns.goldenPathAdherence.value,
+            efficiency: metrics.efficiency.promptLift.value,
+            value: metrics.quality.firstPassSuccessRate.value + metrics.knowledge.patternReuseRate.value,
+        };
+    });
+}
+function rate(numerator, denominator) {
+    return {
+        value: denominator === 0 ? 0 : numerator / denominator,
+        numerator,
+        denominator,
+    };
+}
+function averageMetric(values) {
+    return {
+        value: values.length === 0 ? 0 : values.reduce((sum, value) => sum + value, 0) / values.length,
+        numerator: values.length === 0 ? 0 : Math.round(values.reduce((sum, value) => sum + value, 0) * 100),
+        denominator: values.length === 0 ? 0 : values.length * 100,
+    };
+}
+function clamp(value) {
+    return Math.max(0, Math.min(1, value));
+}
+/**
+ * Prompt Lift: a blended indicator of prompt refinement effectiveness.
+ *
+ * Components (weighted):
+ *   - Refinement usage rate (40%): fraction of tasks that used prompt coach
+ *   - Acceptance rate (30%): accepted / (accepted + bypassed)
+ *   - Low bypass rate (15%): 1 - bypass rate
+ *   - Edit engagement (15%): edit-after-refinement indicates active use
+ *
+ * Returns 0 when no PROMPT_REFINEMENT events exist (graceful zero-state).
+ */
+function computePromptLift(refinements) {
+    if (refinements.length === 0)
+        return rate(0, 0);
+    const total = refinements.length;
+    const accepted = refinements.filter((e) => e.accepted).length;
+    const bypassed = refinements.filter((e) => e.bypassed).length;
+    const edited = refinements.filter((e) => e.edited).length;
+    const decided = accepted + bypassed;
+    const acceptanceRate = decided > 0 ? accepted / decided : 0;
+    const lowBypassRate = decided > 0 ? 1 - (bypassed / decided) : 0;
+    const editEngagement = total > 0 ? edited / total : 0;
+    // Usage rate is always 1.0 when refinement events exist (they only fire when coach is used)
+    const usageSignal = 1.0;
+    const blended = (usageSignal * 0.40) + (acceptanceRate * 0.30) + (lowBypassRate * 0.15) + (editEngagement * 0.15);
+    return {
+        value: clamp(blended),
+        numerator: accepted,
+        denominator: total,
+    };
+}
+/**
+ * Waste Avoided: estimated operational proxy (not a precise accounting metric).
+ *
+ * Derived from:
+ *   - Retries avoided from prompt refinement events
+ *   - First-pass success rate from execution results
+ *   - Low rework rate from execution results
+ *
+ * Returns a 0-1 score representing the fraction of waste that was avoided.
+ */
+function computeWasteAvoided(refinements, executions) {
+    const totalRetries = refinements.reduce((sum, e) => sum + e.retriesAvoided, 0);
+    const firstPassCount = executions.filter((e) => e.firstPass === true && e.status === 'success').length;
+    const firstPassTotal = executions.filter((e) => e.firstPass !== undefined).length;
+    const reworkCount = executions.filter((e) => e.rework === true).length;
+    const reworkTotal = executions.filter((e) => e.rework !== undefined).length;
+    if (refinements.length === 0 && firstPassTotal === 0)
+        return rate(0, 0);
+    const retriesSignal = refinements.length > 0 ? Math.min(1, totalRetries / (refinements.length * 2)) : 0;
+    const firstPassSignal = firstPassTotal > 0 ? firstPassCount / firstPassTotal : 0;
+    const lowReworkSignal = reworkTotal > 0 ? 1 - (reworkCount / reworkTotal) : 0;
+    const blended = (retriesSignal * 0.40) + (firstPassSignal * 0.35) + (lowReworkSignal * 0.25);
+    return {
+        value: clamp(blended),
+        numerator: totalRetries + firstPassCount,
+        denominator: refinements.length + firstPassTotal,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/hotspots.d.ts

@@ -0,0 +1,7 @@
+import type { InsightEvent, InsightHotspotEntry, InsightPatternEntry, InsightShadowEntry, InsightValueTrend } from '@codeledger/types';
+export declare function computeQualityHotspots(events: InsightEvent[]): InsightHotspotEntry[];
+export declare function computeIntegrityHotspots(events: InsightEvent[]): InsightHotspotEntry[];
+export declare function computeKnowledgePatterns(events: InsightEvent[]): InsightPatternEntry[];
+export declare function computeShadowHotspots(events: InsightEvent[]): InsightShadowEntry[];
+export declare function computeValueTrend(current: number, previous: number): InsightValueTrend;
+//# sourceMappingURL=hotspots.d.ts.map

package/dist/hotspots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspots.d.ts","sourceRoot":"","sources":["../src/hotspots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEvI,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,mBAAmB,EAAE,CA8BpF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,mBAAmB,EAAE,CA0BtF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,mBAAmB,EAAE,CAiBtF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAgBlF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAStF"}

package/dist/hotspots.js

@@ -0,0 +1,107 @@
+export function computeQualityHotspots(events) {
+    const repoStats = new Map();
+    for (const event of events) {
+        if (event.type !== 'EXECUTION_RESULT')
+            continue;
+        const repo = event.repo;
+        const stats = repoStats.get(repo) ?? { rework: 0, firstPass: 0, total: 0, lastSuccess: 0, prevSuccess: 0 };
+        stats.total += 1;
+        if (event.rework)
+            stats.rework += 1;
+        if (event.firstPass)
+            stats.firstPass += 1;
+        const success = event.status === 'success' ? 1 : 0;
+        stats.prevSuccess = stats.lastSuccess;
+        stats.lastSuccess = success;
+        repoStats.set(repo, stats);
+    }
+    return Array.from(repoStats.entries())
+        .map(([repo, stats]) => {
+        const reworkRatio = stats.total ? stats.rework / stats.total : 0;
+        const firstPassRate = stats.total ? stats.firstPass / stats.total : 0;
+        const direction = stats.lastSuccess > stats.prevSuccess ? 'up' : stats.lastSuccess < stats.prevSuccess ? 'down' : 'flat';
+        return {
+            repo,
+            value: reworkRatio,
+            secondaryValue: firstPassRate,
+            label: 'Rework',
+            direction,
+        };
+    })
+        .sort((a, b) => b.value - a.value)
+        .slice(0, 3);
+}
+export function computeIntegrityHotspots(events) {
+    const repoViolations = new Map();
+    for (const event of events) {
+        if (event.type === 'POLICY_EVALUATION') {
+            const repo = event.repo;
+            const stats = repoViolations.get(repo) ?? { violations: 0, rejects: 0 };
+            stats.violations += event.violations;
+            repoViolations.set(repo, stats);
+        }
+        if (event.type === 'EXECUTION_RESULT' && event.rejected) {
+            const repo = event.repo;
+            const stats = repoViolations.get(repo) ?? { violations: 0, rejects: 0 };
+            stats.rejects += 1;
+            repoViolations.set(repo, stats);
+        }
+    }
+    return Array.from(repoViolations.entries())
+        .map(([repo, stats]) => ({
+        repo,
+        value: stats.violations,
+        secondaryValue: stats.rejects,
+        label: 'Violations',
+        direction: stats.violations > 3 ? 'up' : 'flat',
+    }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, 3);
+}
+export function computeKnowledgePatterns(events) {
+    const patternMap = new Map();
+    for (const event of events) {
+        if (event.type !== 'PATTERN_REUSE')
+            continue;
+        const entry = patternMap.get(event.pattern) ?? { count: 0, repos: new Set() };
+        entry.count += 1;
+        entry.repos.add(event.repo);
+        patternMap.set(event.pattern, entry);
+    }
+    return Array.from(patternMap.entries())
+        .map(([pattern, entry]) => ({
+        pattern,
+        count: entry.count,
+        repos: Array.from(entry.repos),
+    }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 3);
+}
+export function computeShadowHotspots(events) {
+    const repoShadow = new Map();
+    for (const event of events) {
+        if (event.type !== 'SHADOW_KNOWLEDGE_SIGNAL')
+            continue;
+        const stats = repoShadow.get(event.repo) ?? { total: 0, sum: 0 };
+        stats.total += 1;
+        stats.sum += event.weight ?? 0;
+        repoShadow.set(event.repo, stats);
+    }
+    return Array.from(repoShadow.entries())
+        .map(([repo, stats]) => ({
+        repo,
+        shadowIndex: stats.total ? stats.sum / stats.total : 0,
+    }))
+        .sort((a, b) => b.shadowIndex - a.shadowIndex)
+        .slice(0, 3);
+}
+export function computeValueTrend(current, previous) {
+    const direction = current > previous ? 'up' : current < previous ? 'down' : 'flat';
+    const delta = Number((current - previous).toFixed(2));
+    return {
+        direction,
+        delta,
+        period: 'last 7 days',
+    };
+}
+//# sourceMappingURL=hotspots.js.map

package/dist/hotspots.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './engine.js';
+export * from './job.js';
+export * from './recommendations.js';
+export * from './value.js';
+export * from './store.js';
+export * from './scheduler.js';
+export * from './team-attribution.js';
+export * from './ownership.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './engine.js';
+export * from './job.js';
+export * from './recommendations.js';
+export * from './value.js';
+export * from './store.js';
+export * from './scheduler.js';
+export * from './team-attribution.js';
+export * from './ownership.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/insights.d.ts

@@ -0,0 +1,6 @@
+import type { InsightBaseline, InsightMetrics, InsightSignal, InsightValueTrend, ValueSummary } from '@codeledger/types';
+export declare function generateSystemInsights(metrics: InsightMetrics, value: ValueSummary, context?: {
+    valueTrend?: InsightValueTrend;
+    baseline?: InsightBaseline;
+}): InsightSignal[];
+//# sourceMappingURL=insights.d.ts.map

package/dist/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../src/insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EAEb,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AA4B3B,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACvE,aAAa,EAAE,CAyKjB"}

package/dist/insights.js

@@ -0,0 +1,89 @@
+function buildLink(metric) {
+    return `/api/evidence?metric=${encodeURIComponent(metric)}`;
+}
+function addSignal(list, title, detail, severity, linkedMetric) {
+    list.push({
+        title,
+        detail,
+        severity,
+        linkedMetric,
+        link: buildLink(linkedMetric),
+    });
+}
+const severityRank = {
+    critical: 3,
+    warn: 2,
+    info: 1,
+};
+export function generateSystemInsights(metrics, value, context) {
+    const insights = [];
+    const trend = metrics.overview.trend;
+    const last = trend.at(-1);
+    const prev = trend.length > 1 ? trend.at(-2) : undefined;
+    const baseline = context?.baseline;
+    const rework = metrics.quality.reworkRatio.value;
+    if (rework > 0.32) {
+        addSignal(insights, 'Rework is elevated', `Rework ratio is ${Math.round(rework * 100)}% this period—review rework flows before downstream work starts.`, 'warn', 'reworkRatio');
+    }
+    else if (rework < 0.15) {
+        addSignal(insights, 'Rework under control', `Rework is low (${Math.round(rework * 100)}%); first-pass success is holding steady.`, 'info', 'reworkRatio');
+    }
+    const drift = metrics.integrity.integrityDrift.value;
+    if (drift > 0.25) {
+        addSignal(insights, 'Policy drift alert', `Integrity drift ${Math.round(drift * 100)}%—policy violations and rejects are rising.`, 'critical', 'integrityDrift');
+    }
+    else if (drift < 0.1) {
+        addSignal(insights, 'Integrity signals stable', `Policy drift is low (${Math.round(drift * 100)}%); enforcement is staying tight.`, 'info', 'integrityDrift');
+    }
+    const shadowRisk = metrics.knowledge.shadowKnowledgeIndex.value;
+    const timeToContext = metrics.knowledge.timeToContext.value;
+    if (shadowRisk > 0.5 && timeToContext > 5) {
+        addSignal(insights, 'Shadow knowledge rising', `Shadow index ${shadowRisk.toFixed(2)} with ${timeToContext.toFixed(1)} min context—the docs gap may be widening.`, 'warn', 'shadowKnowledgeIndex');
+    }
+    else if (shadowRisk < 0.4 && metrics.knowledge.patternReuseRate.value > 0.65) {
+        addSignal(insights, 'Knowledge compounding', `Pattern reuse ${Math.round(metrics.knowledge.patternReuseRate.value * 100)}% with low shadow risk—reuse signals are amplifying.`, 'info', 'patternReuseRate');
+    }
+    const reuse = metrics.knowledge.patternReuseRate.value;
+    if (reuse < 0.25) {
+        addSignal(insights, 'Pattern reuse muted', `Reuse events are sparse (${Math.round(reuse * 100)}%); surface re-use candidates or references.`, 'warn', 'patternReuseRate');
+    }
+    if (last && prev) {
+        const deltaQuality = last.quality - prev.quality;
+        if (deltaQuality > 0.02) {
+            addSignal(insights, 'Quality trending upward', `Execution reliability improved ${(deltaQuality * 100).toFixed(1)} pts vs last period.`, 'info', 'executionReliability');
+        }
+        else if (deltaQuality < -0.02) {
+            addSignal(insights, 'Quality facing headwinds', `Execution reliability slipped ${(-deltaQuality * 100).toFixed(1)} pts—check the failing flows.`, 'warn', 'executionReliability');
+        }
+    }
+    if (baseline) {
+        if (metrics.quality.executionReliability.value > baseline.qualityScore + 0.03) {
+            addSignal(insights, 'Quality above typical baseline', `Quality (${Math.round(metrics.quality.executionReliability.value * 100)}%) exceeds the baseline (${Math.round(baseline.qualityScore * 100)}%).`, 'info', 'executionReliability');
+        }
+        else if (metrics.quality.executionReliability.value < baseline.qualityScore - 0.03) {
+            addSignal(insights, 'Quality below baseline', `Quality is ${Math.round(metrics.quality.executionReliability.value * 100)}% vs baseline ${Math.round(baseline.qualityScore * 100)}%.`, 'warn', 'executionReliability');
+        }
+    }
+    if (metrics.patterns.goldenPathAdherence.value < 0.8) {
+        addSignal(insights, 'Golden path pressure', 'Golden path adherence slipped below 80%; review the divergent flows for potential drift.', 'warn', 'goldenPathAdherence');
+    }
+    const valueTrend = context?.valueTrend;
+    if (valueTrend) {
+        if (valueTrend.direction === 'up') {
+            addSignal(insights, 'Value accelerating', `Estimated savings up ${valueTrend.delta} vs ${valueTrend.period}.`, 'info', 'executionReliability');
+        }
+        else if (valueTrend.direction === 'down') {
+            addSignal(insights, 'Value slipping', `Estimated savings down ${Math.abs(valueTrend.delta)} vs ${valueTrend.period}; rework or knowledge may need attention.`, 'warn', 'executionReliability');
+        }
+        else {
+            addSignal(insights, 'Value holding steady', `Estimated savings stable over ${valueTrend.period}.`, 'info', 'executionReliability');
+        }
+    }
+    if (value.estimatedSavings > 0) {
+        addSignal(insights, 'Value compounding', `Estimated savings $${Math.round(value.estimatedSavings)} this period; keep the evidence traceable.`, 'info', 'estimatedSavings');
+    }
+    return insights
+        .sort((a, b) => severityRank[b.severity] - severityRank[a.severity])
+        .slice(0, 5);
+}
+//# sourceMappingURL=insights.js.map

package/dist/insights.js.map

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

package/dist/job.d.ts

@@ -0,0 +1,9 @@
+import type { FilterOptions, InsightSnapshot, ValueAssumptions } from '@codeledger/types';
+export interface InsightJobOptions {
+    cwd: string;
+    filters?: FilterOptions;
+    assumptions?: ValueAssumptions;
+}
+export declare function writeInsightSnapshot(cwd: string, snapshot: InsightSnapshot): string;
+export declare function runInsightAggregationJob(options: InsightJobOptions): InsightSnapshot;
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EAKb,eAAe,EAMf,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMnF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAoEpF"}