@codeledger/engine 0.7.2 → 0.7.5

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,16 @@ 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';
+export * from './broker/index.js';
+export * from './insight/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;AAG1C,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -53,4 +53,27 @@ 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';
+// v3.4 — Context Broker (system-awareness layer for non-terminal agents)
+export * from './broker/index.js';
+// v3.5 — Insight System (value dashboard)
+export * from './insight/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;AAE1C,yEAAyE;AACzE,cAAc,mBAAmB,CAAC;AAElC,0CAA0C;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/insight/collector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Insight Collector — ingests guardrail events, CIC transitions,
+ * validation ledger data, and pre-PR/release-check results.
+ *
+ * Every collected item MUST have a verifiable provenance (ID or ledger entry).
+ * No narrative hallucination — if it can't be traced, it's not collected.
+ */
+import type { GuardrailResult, CompletionRecord, CompletionState, ReleaseCheckResult, ReleaseState, PrePRReport, InsightPreventedIssue, InsightWorkAvoided, InsightTruthEstablished, InsightStateTransition } from '@codeledger/types';
+/** Raw inputs the collector accepts */
+export interface CollectorInput {
+    guardrails?: GuardrailResult[];
+    completionRecord?: CompletionRecord;
+    previousCompletionState?: CompletionState;
+    releaseResult?: ReleaseCheckResult;
+    previousReleaseState?: ReleaseState;
+    prePRReport?: PrePRReport;
+    validationSurfaces?: number;
+    reusedSurfaces?: number;
+    totalRepoFiles?: number;
+    scannedFiles?: number;
+    skippedTests?: number;
+}
+/** Collected insight data ready for the engine */
+export interface CollectedInsight {
+    prevented: InsightPreventedIssue[];
+    workAvoided: InsightWorkAvoided;
+    truth: InsightTruthEstablished;
+    transitions: InsightStateTransition[];
+}
+export declare function collect(input: CollectorInput): CollectedInsight;
+//# sourceMappingURL=collector.d.ts.map

package/dist/insight/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/insight/collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EAEX,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uBAAuB,CAAC,EAAE,eAAe,CAAC;IAC1C,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,oBAAoB,CAAC,EAAE,YAAY,CAAC;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,WAAW,EAAE,kBAAkB,CAAC;IAChC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC;AA0BD,wBAAgB,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CA4J/D"}

package/dist/insight/collector.js

@@ -0,0 +1,172 @@
+/**
+ * Insight Collector — ingests guardrail events, CIC transitions,
+ * validation ledger data, and pre-PR/release-check results.
+ *
+ * Every collected item MUST have a verifiable provenance (ID or ledger entry).
+ * No narrative hallucination — if it can't be traced, it's not collected.
+ */
+const COMPLETION_ORDER = [
+    'incomplete', 'edited', 'implemented', 'wired', 'verified', 'audited', 'release_safe',
+];
+const RELEASE_ORDER = [
+    'not_ready', 'ready_conditional', 'ready', 'ready_hardened',
+];
+const COMPLETION_DELTAS = {
+    'verified': 15,
+    'audited': 20,
+    'release_safe': 25,
+};
+const RELEASE_DELTAS = {
+    'ready_conditional': 5,
+    'ready': 10,
+    'ready_hardened': 25,
+};
+function isPromotion(order, from, to) {
+    return order.indexOf(to) > order.indexOf(from);
+}
+export function collect(input) {
+    const prevented = [];
+    const transitions = [];
+    const truth = {};
+    // ── Guardrail events → prevented issues ────────────────────────────────
+    if (input.guardrails) {
+        for (const g of input.guardrails) {
+            if (g.outcome === 'fail' || g.outcome === 'warn') {
+                prevented.push({
+                    id: g.id,
+                    description: g.detail,
+                    severity: g.outcome === 'fail' ? 'high' : 'medium',
+                    source: 'guardrail',
+                });
+            }
+        }
+    }
+    // ── Pre-PR findings → prevented issues (severity >= medium) ────────────
+    if (input.prePRReport) {
+        const allFindings = [
+            ...input.prePRReport.blockers,
+            ...input.prePRReport.warnings,
+        ];
+        for (const f of allFindings) {
+            if (f.severity === 'critical' || f.severity === 'high' || f.severity === 'medium') {
+                prevented.push({
+                    id: `pre-pr:${f.category}:${f.title.slice(0, 40).replace(/\s+/g, '_')}`,
+                    description: f.title,
+                    severity: f.severity === 'critical' ? 'critical' : f.severity === 'high' ? 'high' : 'medium',
+                    source: 'pre_pr',
+                    recursiveImpact: f.files && f.files.length > 2
+                        ? `affects ${f.files.length} files — potential cascade`
+                        : undefined,
+                });
+            }
+        }
+    }
+    // ── Release findings → prevented issues ────────────────────────────────
+    if (input.releaseResult) {
+        for (const f of input.releaseResult.findings) {
+            if (f.severity === 'critical' || f.severity === 'high' || f.severity === 'medium') {
+                prevented.push({
+                    id: f.id,
+                    description: f.title,
+                    severity: f.severity === 'critical' ? 'critical' : f.severity === 'high' ? 'high' : 'medium',
+                    source: 'release_check',
+                });
+            }
+        }
+    }
+    // ── CIC drift/mismatch warnings → prevented issues ────────────────────
+    if (input.completionRecord) {
+        const rec = input.completionRecord;
+        if (rec.semanticDriftWarnings) {
+            for (const d of rec.semanticDriftWarnings) {
+                prevented.push({
+                    id: `cic:drift:${d.term.replace(/\s+/g, '_')}`,
+                    description: `Semantic drift: "${d.term}" expected ${d.expectedConcept} — ${d.detail}`,
+                    severity: 'medium',
+                    source: 'cic',
+                });
+            }
+        }
+        if (rec.realityMismatches) {
+            for (const m of rec.realityMismatches) {
+                if (!m.actualDiffPresence) {
+                    prevented.push({
+                        id: `cic:mismatch:${m.expectedTarget.replace(/\//g, '_')}`,
+                        description: `Reality mismatch: claim "${m.claim}" — ${m.expectedTarget} not in diff`,
+                        severity: m.severity === 'critical' ? 'critical' : m.severity === 'major' ? 'high' : 'medium',
+                        source: 'cic',
+                    });
+                }
+            }
+        }
+        if (rec.guards) {
+            for (const g of rec.guards) {
+                if (g.outcome === 'fail') {
+                    prevented.push({
+                        id: g.id,
+                        description: g.detail,
+                        severity: 'high',
+                        source: 'guardrail',
+                    });
+                }
+            }
+        }
+    }
+    // ── CIC state transitions → truth + transitions ───────────────────────
+    if (input.completionRecord) {
+        truth.completionState = input.completionRecord.completionState;
+        if (input.previousCompletionState) {
+            const from = input.previousCompletionState;
+            const to = input.completionRecord.completionState;
+            if (isPromotion(COMPLETION_ORDER, from, to)) {
+                transitions.push({
+                    from,
+                    to,
+                    label: `completion: ${from} → ${to}`,
+                    delta: COMPLETION_DELTAS[to] ?? 10,
+                });
+            }
+        }
+    }
+    // ── Release state transitions → truth + transitions ───────────────────
+    if (input.releaseResult) {
+        truth.releaseState = input.releaseResult.releaseState;
+        if (input.previousReleaseState) {
+            const from = input.previousReleaseState;
+            const to = input.releaseResult.releaseState;
+            if (isPromotion(RELEASE_ORDER, from, to)) {
+                transitions.push({
+                    from,
+                    to,
+                    label: `release: ${from} → ${to}`,
+                    delta: RELEASE_DELTAS[to] ?? 5,
+                });
+            }
+        }
+    }
+    // ── Pre-PR pass → confidence transition ───────────────────────────────
+    if (input.prePRReport && input.prePRReport.verdict === 'PASS') {
+        transitions.push({
+            from: 'unchecked',
+            to: 'pre_pr_pass',
+            label: 'pre-pr: passed all checks',
+            delta: 10,
+        });
+    }
+    // ── Work avoided ──────────────────────────────────────────────────────
+    const reusedSurfaces = input.reusedSurfaces ?? 0;
+    const contextScansAvoided = input.totalRepoFiles && input.scannedFiles
+        ? input.totalRepoFiles - input.scannedFiles
+        : 0;
+    const skippedTests = input.skippedTests ?? 0;
+    // Estimate: ~2s per surface revalidation, ~2s per file scan, ~1s per test
+    const estimatedTimeSavedSec = (reusedSurfaces * 2) + (contextScansAvoided > 0 ? Math.round(contextScansAvoided * 2) : 0) + (skippedTests * 1);
+    const workAvoided = {
+        surfaces: reusedSurfaces,
+        tests: skippedTests,
+        contextScansAvoided,
+        estimatedTimeSavedSec: estimatedTimeSavedSec > 0 ? estimatedTimeSavedSec : undefined,
+    };
+    return { prevented, workAvoided, truth, transitions };
+}
+//# sourceMappingURL=collector.js.map

package/dist/insight/collector.js.map

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

package/dist/insight/engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Insight Engine — computes value signals from collected data.
+ *
+ * Applies value detection rules:
+ * - Prevented: only severity >= medium
+ * - Avoided: >3 surfaces OR >10 files OR >30s estimated
+ * - Confidence: delta >= 10
+ *
+ * Produces an InsightResult with silence/health-pulse flags.
+ */
+import type { InsightResult } from '@codeledger/types';
+import type { CollectedInsight } from './collector.js';
+export interface InsightEngineOptions {
+    sessionId?: string;
+    consecutiveSilentCount?: number;
+}
+export declare function computeInsight(collected: CollectedInsight, opts?: InsightEngineOptions): InsightResult;
+//# sourceMappingURL=engine.d.ts.map

package/dist/insight/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/insight/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAWvD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,gBAAgB,EAC3B,IAAI,GAAE,oBAAyB,GAC9B,aAAa,CAgDf"}

package/dist/insight/engine.js

@@ -0,0 +1,84 @@
+/**
+ * Insight Engine — computes value signals from collected data.
+ *
+ * Applies value detection rules:
+ * - Prevented: only severity >= medium
+ * - Avoided: >3 surfaces OR >10 files OR >30s estimated
+ * - Confidence: delta >= 10
+ *
+ * Produces an InsightResult with silence/health-pulse flags.
+ */
+/** Thresholds for value detection (from spec §7) */
+const THRESHOLDS = {
+    minSeverity: 'medium',
+    minSurfaces: 3,
+    minFiles: 10,
+    minTimeSavedSec: 30,
+    minConfidenceDelta: 10,
+};
+export function computeInsight(collected, opts = {}) {
+    // ── Confidence delta from state transitions ────────────────────────────
+    const confidenceDelta = collected.transitions.reduce((sum, t) => sum + t.delta, 0);
+    // ── Apply value detection rules ────────────────────────────────────────
+    // Prevented: already filtered to >= medium in collector
+    const preventedDetails = collected.prevented;
+    const preventedIssues = preventedDetails.length;
+    // Work avoided: check thresholds
+    const wa = collected.workAvoided;
+    const workIsSignificant = wa.surfaces > THRESHOLDS.minSurfaces ||
+        wa.contextScansAvoided > THRESHOLDS.minFiles ||
+        (wa.estimatedTimeSavedSec != null && wa.estimatedTimeSavedSec > THRESHOLDS.minTimeSavedSec);
+    // Zero out work avoided display if below thresholds
+    const workAvoided = workIsSignificant ? wa : {
+        surfaces: 0,
+        tests: 0,
+        contextScansAvoided: 0,
+    };
+    // Confidence: only show if >= threshold
+    const showConfidence = confidenceDelta >= THRESHOLDS.minConfidenceDelta;
+    // ── Silence rule (§3) ─────────────────────────────────────────────────
+    const silent = preventedIssues === 0 && !workIsSignificant && !showConfidence;
+    // ── Health pulse (§4) — triggers after 3+ consecutive silent outputs ──
+    const healthPulse = silent && (opts.consecutiveSilentCount ?? 0) >= 3;
+    // ── Next action (§8) — single, state-driven ───────────────────────────
+    const recommendedAction = deriveNextAction(collected);
+    return {
+        preventedIssues,
+        preventedDetails,
+        workAvoided,
+        truthEstablished: collected.truth,
+        confidenceDelta: showConfidence ? confidenceDelta : 0,
+        stateTransitions: collected.transitions,
+        recommendedAction,
+        silent,
+        healthPulse,
+        timestamp: new Date().toISOString(),
+        sessionId: opts.sessionId,
+    };
+}
+function deriveNextAction(collected) {
+    // Priority: critical preventions → state gaps → nothing
+    const criticals = collected.prevented.filter(p => p.severity === 'critical');
+    if (criticals.length > 0) {
+        return `fix ${criticals.length} critical issue${criticals.length > 1 ? 's' : ''} before proceeding`;
+    }
+    const highs = collected.prevented.filter(p => p.severity === 'high');
+    if (highs.length > 0) {
+        return `resolve ${highs.length} high-severity finding${highs.length > 1 ? 's' : ''}`;
+    }
+    // State-driven suggestions
+    if (collected.truth.completionState === 'implemented') {
+        return 'run complete-check to verify';
+    }
+    if (collected.truth.completionState === 'verified' && !collected.truth.releaseState) {
+        return 'run pre-pr before opening PR';
+    }
+    if (collected.truth.releaseState === 'ready_conditional') {
+        return 'resolve conditions for full release readiness';
+    }
+    if (collected.truth.releaseState === 'ready') {
+        return 'run release-check --strict for hardened release';
+    }
+    return undefined;
+}
+//# sourceMappingURL=engine.js.map

package/dist/insight/engine.js.map

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

package/dist/insight/formatter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Insight Formatter — human (≤10 lines) and JSON output.
+ */
+import type { InsightResult } from '@codeledger/types';
+/** Format InsightResult as human-readable output (≤10 lines per spec §5) */
+export declare function formatInsightHuman(result: InsightResult): string[];
+/** Format InsightResult as JSON string */
+export declare function formatInsightJson(result: InsightResult): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/insight/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/insight/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkFlE;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE/D"}

package/dist/insight/formatter.js

@@ -0,0 +1,87 @@
+/**
+ * Insight Formatter — human (≤10 lines) and JSON output.
+ */
+/** Format InsightResult as human-readable output (≤10 lines per spec §5) */
+export function formatInsightHuman(result) {
+    // ── Health pulse (§4) ─────────────────────────────────────────────────
+    if (result.healthPulse) {
+        return [
+            '',
+            '\u{1F9E0} CodeLedger Health',
+            '---------------------',
+            '\u2714 100% integrity maintained',
+            '\u2714 No intervention required',
+            '\u2714 System actively monitoring',
+            '',
+        ];
+    }
+    // ── Silence rule (§3) ─────────────────────────────────────────────────
+    if (result.silent) {
+        return [
+            '',
+            '\u2714 No issues detected',
+            '\u2714 No unnecessary work',
+            '\u2714 System stable',
+            '',
+        ];
+    }
+    // ── Full insight output (§5) ──────────────────────────────────────────
+    const lines = ['', '\u{1F9E0} CodeLedger Insight', '---------------------'];
+    // Prevented
+    if (result.preventedIssues > 0) {
+        const top = result.preventedDetails.slice(0, 3);
+        const summary = top.map(p => {
+            const base = p.description.length > 60
+                ? p.description.slice(0, 57) + '...'
+                : p.description;
+            return p.recursiveImpact ? `${base} (${p.recursiveImpact})` : base;
+        }).join('; ');
+        const extra = result.preventedIssues > 3 ? ` (+${result.preventedIssues - 3} more)` : '';
+        lines.push(`\u2714 PREVENTED: ${summary}${extra}`);
+    }
+    // Avoided
+    const wa = result.workAvoided;
+    const avoidedParts = [];
+    if (wa.surfaces > 0)
+        avoidedParts.push(`${wa.surfaces} surfaces reused`);
+    if (wa.contextScansAvoided > 0)
+        avoidedParts.push(`${wa.contextScansAvoided} files skipped`);
+    if (wa.tests > 0)
+        avoidedParts.push(`${wa.tests} redundant tests skipped`);
+    if (wa.estimatedTimeSavedSec && wa.estimatedTimeSavedSec > 0) {
+        avoidedParts.push(`~${wa.estimatedTimeSavedSec}s saved`);
+    }
+    if (avoidedParts.length > 0) {
+        lines.push(`\u2714 AVOIDED:   ${avoidedParts.join(', ')}`);
+    }
+    // Truth
+    const truthParts = [];
+    if (result.truthEstablished.completionState) {
+        truthParts.push(`completion ${result.truthEstablished.completionState}`);
+    }
+    if (result.truthEstablished.releaseState) {
+        truthParts.push(`release ${result.truthEstablished.releaseState}`);
+    }
+    if (truthParts.length > 0) {
+        lines.push(`\u2714 TRUTH:     ${truthParts.join(', ')}`);
+    }
+    // Confidence
+    if (result.confidenceDelta > 0) {
+        const lastTransition = result.stateTransitions[result.stateTransitions.length - 1];
+        const label = lastTransition ? lastTransition.label : 'state promoted';
+        lines.push('');
+        lines.push(`Confidence: +${result.confidenceDelta}% (${label})`);
+    }
+    // Next action
+    if (result.recommendedAction) {
+        lines.push('');
+        lines.push(`\u{1F449} Next: ${result.recommendedAction}`);
+    }
+    lines.push('');
+    return lines;
+}
+/** Format InsightResult as JSON string */
+export function formatInsightJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=formatter.js.map

package/dist/insight/formatter.js.map

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

package/dist/insight/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Insight System — value dashboard for CodeLedger.
+ *
+ * Shows prevented risk, avoided work, truth progression,
+ * and confidence deltas after key commands.
+ */
+export { collect } from './collector.js';
+export type { CollectorInput, CollectedInsight } from './collector.js';
+export { computeInsight } from './engine.js';
+export type { InsightEngineOptions } from './engine.js';
+export { formatInsightHuman, formatInsightJson } from './formatter.js';
+export { storeInsight, loadSessionInsights, getConsecutiveSilentCount, } from './session.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insight/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/insight/index.js

@@ -0,0 +1,11 @@
+/**
+ * Insight System — value dashboard for CodeLedger.
+ *
+ * Shows prevented risk, avoided work, truth progression,
+ * and confidence deltas after key commands.
+ */
+export { collect } from './collector.js';
+export { computeInsight } from './engine.js';
+export { formatInsightHuman, formatInsightJson } from './formatter.js';
+export { storeInsight, loadSessionInsights, getConsecutiveSilentCount, } from './session.js';
+//# sourceMappingURL=index.js.map

package/dist/insight/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insight/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}