@codeledger/engine 0.7.3 → 0.7.5

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"}

package/dist/insight/session.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Insight Session Storage — persists insight results per session
+ * for `codeledger report --session` retrieval.
+ *
+ * Stores to `.codeledger/insight-sessions/` as append-only JSONL.
+ */
+import type { InsightResult, InsightSessionEntry } from '@codeledger/types';
+export declare function storeInsight(cwd: string, command: string, result: InsightResult, sessionId?: string): void;
+export declare function loadSessionInsights(cwd: string, sessionId: string): InsightSessionEntry[];
+export declare function getConsecutiveSilentCount(cwd: string, sessionId: string): number;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/insight/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAY5E,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAgBN;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAgBzF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYhF"}

package/dist/insight/session.js

@@ -0,0 +1,60 @@
+/**
+ * Insight Session Storage — persists insight results per session
+ * for `codeledger report --session` retrieval.
+ *
+ * Stores to `.codeledger/insight-sessions/` as append-only JSONL.
+ */
+import { existsSync, mkdirSync, readFileSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+const INSIGHT_DIR = 'insight-sessions';
+function insightDir(cwd) {
+    return join(cwd, '.codeledger', INSIGHT_DIR);
+}
+function sessionFile(cwd, sessionId) {
+    return join(insightDir(cwd), `${sessionId}.jsonl`);
+}
+export function storeInsight(cwd, command, result, sessionId) {
+    const sid = sessionId ?? result.sessionId ?? 'default';
+    const dir = insightDir(cwd);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const entry = {
+        sessionId: sid,
+        command,
+        result,
+        timestamp: result.timestamp,
+    };
+    appendFileSync(sessionFile(cwd, sid), JSON.stringify(entry) + '\n', 'utf-8');
+}
+export function loadSessionInsights(cwd, sessionId) {
+    const file = sessionFile(cwd, sessionId);
+    if (!existsSync(file))
+        return [];
+    const lines = readFileSync(file, 'utf-8').split('\n').filter(Boolean);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            // Skip malformed lines — do not fabricate data
+        }
+    }
+    return entries;
+}
+export function getConsecutiveSilentCount(cwd, sessionId) {
+    const entries = loadSessionInsights(cwd, sessionId);
+    let count = 0;
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry && entry.result.silent) {
+            count++;
+        }
+        else {
+            break;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=session.js.map

package/dist/insight/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/insight/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAEvC,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,SAAiB;IACjD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,OAAe,EACf,MAAqB,EACrB,SAAkB;IAElB,MAAM,GAAG,GAAG,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;IACvD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAwB;QACjC,SAAS,EAAE,GAAG;QACd,OAAO;QACP,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IAEF,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,SAAiB;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAW,EAAE,SAAiB;IACtE,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeledger/engine",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "type": "module",
   "description": "Deterministic Context Orchestration Layer (DCOL) — SCE and IOLE subsystems for CodeLedger v2",
   "license": "MIT",
@@ -37,10 +37,14 @@
     "./intervention": {
       "types": "./dist/intervention/index.d.ts",
       "import": "./dist/intervention/index.js"
+    },
+    "./insight": {
+      "types": "./dist/insight/index.d.ts",
+      "import": "./dist/insight/index.js"
     }
   },
   "dependencies": {
-    "@codeledger/types": "0.7.3"
+    "@codeledger/types": "0.7.5"
   },
   "devDependencies": {
     "typescript": "^5.4.0"