@codeledger/engine 0.7.0

package/dist/ccs/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CCS — Context Confidence Score
+ *
+ * Pre-execution certification layer. Computes a deterministic [0,1] score
+ * from 5 factors (dependency coverage, test coverage, historical success rate,
+ * symbol completeness, expansion level efficiency) and recommends whether to
+ * proceed, expand, or block execution.
+ */
+export { computeCcs, CCS_HIGH_THRESHOLD, CCS_MEDIUM_THRESHOLD, CCS_DEFAULT_BLOCK_THRESHOLD, } from './score.js';
+export type { CcsInputs } from './score.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ccs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/ccs/index.js

@@ -0,0 +1,10 @@
+/**
+ * CCS — Context Confidence Score
+ *
+ * Pre-execution certification layer. Computes a deterministic [0,1] score
+ * from 5 factors (dependency coverage, test coverage, historical success rate,
+ * symbol completeness, expansion level efficiency) and recommends whether to
+ * proceed, expand, or block execution.
+ */
+export { computeCcs, CCS_HIGH_THRESHOLD, CCS_MEDIUM_THRESHOLD, CCS_DEFAULT_BLOCK_THRESHOLD, } from './score.js';
+//# sourceMappingURL=index.js.map

package/dist/ccs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ccs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/ccs/score.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CCS — Context Confidence Score
+ *
+ * Certifies context BEFORE execution with a deterministic [0,1] score.
+ * Computed from 5 weighted factors. No ML, no embeddings.
+ *
+ * Formula:
+ *   raw = 0.30 * dependencyCoverage
+ *       + 0.25 * testCoverageMapping
+ *       + adjustedHistoricalWeight * historicalSuccessRate   (weight scaled by sample size)
+ *       + 0.15 * symbolCompleteness
+ *       + 0.10 * (1 - expansionLevelNormalized)
+ *       - intentConfidencePenalty                           (0 when confidence >= 0.4)
+ *   CCS = clamp(raw, 0, 1)
+ *
+ * Maturity scaling (FIX 1 — prevents early-data instability):
+ *   historySampleSize < 5  → adjustedHistoricalWeight = 0   (weight redistributed)
+ *   5 ≤ size < 20          → weight scales linearly 0 → W_HISTORICAL_SUCCESS
+ *   size ≥ 20              → full W_HISTORICAL_SUCCESS (0.20) applies
+ *
+ * Thresholds (FIX 4 — explicit gating policy):
+ *   >= 0.75 → PROCEED
+ *   0.60–0.75 → EXPAND
+ *   < 0.60  → BLOCK
+ *
+ * Deterministic: given the same inputs, always returns the same score.
+ */
+import type { ContextBundle, ContextConfidenceScore } from '@codeledger/types';
+export declare const CCS_PROCEED_THRESHOLD = 0.75;
+export declare const CCS_EXPAND_THRESHOLD = 0.6;
+export declare const CCS_HIGH_THRESHOLD = 0.75;
+export declare const CCS_MEDIUM_THRESHOLD = 0.6;
+export declare const CCS_DEFAULT_BLOCK_THRESHOLD = 0.6;
+export interface CcsInputs {
+    bundle: ContextBundle;
+    /** Task keywords (lowercased) */
+    taskKeywords: string[];
+    /** Current expansion ladder level (1–4) */
+    expansionLevel: number;
+    /** Historical pass rate from ECL-lite for this intent (0–1). Default 0.5. */
+    historicalSuccessRate: number;
+    /**
+     * Number of ledger entries that produced historicalSuccessRate.
+     * Used for maturity scaling — small samples get reduced weight.
+     * Default 0 (empty ledger → weight 0).
+     */
+    historySampleSize?: number;
+    /**
+     * Extraction confidence from IntentObject [0,1].
+     * Low confidence reduces CCS slightly (max -0.05 penalty).
+     * Default 1.0 (no penalty).
+     */
+    intentConfidence?: number;
+}
+/**
+ * Compute the Context Confidence Score for a bundle.
+ *
+ * All factor computations are deterministic arithmetic — no randomness.
+ */
+export declare function computeCcs(inputs: CcsInputs): ContextConfidenceScore;
+//# sourceMappingURL=score.d.ts.map

package/dist/ccs/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/ccs/score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAe3B,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,oBAAoB,MAAQ,CAAC;AAI1C,eAAO,MAAM,kBAAkB,OAAiC,CAAC;AACjE,eAAO,MAAM,oBAAoB,MAA8B,CAAC;AAChE,eAAO,MAAM,2BAA2B,MAAuB,CAAC;AAIhE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,iCAAiC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,CA0EpE"}

package/dist/ccs/score.js

@@ -0,0 +1,250 @@
+/**
+ * CCS — Context Confidence Score
+ *
+ * Certifies context BEFORE execution with a deterministic [0,1] score.
+ * Computed from 5 weighted factors. No ML, no embeddings.
+ *
+ * Formula:
+ *   raw = 0.30 * dependencyCoverage
+ *       + 0.25 * testCoverageMapping
+ *       + adjustedHistoricalWeight * historicalSuccessRate   (weight scaled by sample size)
+ *       + 0.15 * symbolCompleteness
+ *       + 0.10 * (1 - expansionLevelNormalized)
+ *       - intentConfidencePenalty                           (0 when confidence >= 0.4)
+ *   CCS = clamp(raw, 0, 1)
+ *
+ * Maturity scaling (FIX 1 — prevents early-data instability):
+ *   historySampleSize < 5  → adjustedHistoricalWeight = 0   (weight redistributed)
+ *   5 ≤ size < 20          → weight scales linearly 0 → W_HISTORICAL_SUCCESS
+ *   size ≥ 20              → full W_HISTORICAL_SUCCESS (0.20) applies
+ *
+ * Thresholds (FIX 4 — explicit gating policy):
+ *   >= 0.75 → PROCEED
+ *   0.60–0.75 → EXPAND
+ *   < 0.60  → BLOCK
+ *
+ * Deterministic: given the same inputs, always returns the same score.
+ */
+// ─── Weights ─────────────────────────────────────────────────────────────────
+const W_DEPENDENCY_COVERAGE = 0.30;
+const W_TEST_COVERAGE = 0.25;
+const W_HISTORICAL_SUCCESS = 0.20; // max; scaled down by maturity
+const W_SYMBOL_COMPLETENESS = 0.15;
+const W_EXPANSION_EFFICIENCY = 0.10;
+// Maturity thresholds for historical success weight scaling
+const HISTORY_MIN_SAMPLES = 5; // below → weight = 0
+const HISTORY_FULL_SAMPLES = 20; // at or above → full weight
+// Thresholds (FIX 4: tightened + explicit gating)
+export const CCS_PROCEED_THRESHOLD = 0.75; // >= PROCEED
+export const CCS_EXPAND_THRESHOLD = 0.60; // >= EXPAND, < PROCEED
+// < CCS_EXPAND_THRESHOLD → BLOCK
+// Keep old names as aliases for backward compatibility
+export const CCS_HIGH_THRESHOLD = CCS_PROCEED_THRESHOLD;
+export const CCS_MEDIUM_THRESHOLD = CCS_EXPAND_THRESHOLD;
+export const CCS_DEFAULT_BLOCK_THRESHOLD = CCS_EXPAND_THRESHOLD; // now same as expand floor
+/**
+ * Compute the Context Confidence Score for a bundle.
+ *
+ * All factor computations are deterministic arithmetic — no randomness.
+ */
+export function computeCcs(inputs) {
+    const { bundle, taskKeywords, expansionLevel, historicalSuccessRate, historySampleSize = 0, intentConfidence = 1.0, } = inputs;
+    // Factor 1: Dependency Coverage
+    const depCoverage = computeDependencyCoverage(bundle);
+    // Factor 2: Test Coverage Mapping
+    const testCoverage = computeTestCoverage(bundle);
+    // Factor 3: Historical Success Rate — with maturity scaling
+    // When sample is small, the historical rate is unreliable. Scale its weight
+    // linearly from 0 (< 5 samples) to full (>= 20 samples).
+    const histSuccess = clamp(historicalSuccessRate, 0, 1);
+    const adjustedHistoricalWeight = computeAdjustedHistoricalWeight(historySampleSize);
+    // Redistribute unused historical weight to dep coverage (largest other factor)
+    const redistributed = W_HISTORICAL_SUCCESS - adjustedHistoricalWeight;
+    // Factor 4: Symbol Completeness
+    const symbolComp = computeSymbolCompleteness(bundle, taskKeywords);
+    // Factor 5: Expansion Level Efficiency
+    const expansionNorm = (expansionLevel - 1) / 3; // [0, 1]
+    const expansionPenalty = expansionNorm * 0.3; // max 0.30
+    // Intent confidence penalty: low confidence = ambiguous prompt = slight downgrade
+    // Max penalty: 0.05 (when intentConfidence = 0)
+    const confidencePenalty = (1 - clamp(intentConfidence, 0, 1)) * 0.05;
+    const raw = (W_DEPENDENCY_COVERAGE + redistributed) * depCoverage +
+        W_TEST_COVERAGE * testCoverage +
+        adjustedHistoricalWeight * histSuccess +
+        W_SYMBOL_COMPLETENESS * symbolComp +
+        W_EXPANSION_EFFICIENCY * (1 - expansionNorm)
+        - confidencePenalty;
+    const score = clamp(raw, 0, 1);
+    const factors = {
+        dependencyCoverage: depCoverage,
+        testCoverageMapping: testCoverage,
+        historicalSuccessRate: histSuccess,
+        symbolCompleteness: symbolComp,
+        expansionLevelPenalty: expansionPenalty,
+        historySampleSize,
+        adjustedHistoricalWeight,
+    };
+    const level = score >= CCS_PROCEED_THRESHOLD
+        ? 'high'
+        : score >= CCS_EXPAND_THRESHOLD
+            ? 'medium'
+            : 'low';
+    const issues = collectIssues(factors, bundle, taskKeywords, intentConfidence);
+    const { recommendation, suggestedExpansionLevel } = recommendAction(score, expansionLevel, issues);
+    return {
+        score,
+        level,
+        factors,
+        recommendation,
+        suggestedExpansionLevel,
+        issues,
+        computed_at: new Date().toISOString(),
+    };
+}
+// ─── Maturity Scaling ─────────────────────────────────────────────────────────
+/**
+ * Compute the effective historical success weight based on sample size.
+ *
+ * < HISTORY_MIN_SAMPLES (5)  → 0 (too noisy to trust)
+ * HISTORY_MIN_SAMPLES..HISTORY_FULL_SAMPLES (5–19) → linear ramp 0 → W_HISTORICAL_SUCCESS
+ * >= HISTORY_FULL_SAMPLES (20) → full W_HISTORICAL_SUCCESS
+ */
+function computeAdjustedHistoricalWeight(sampleSize) {
+    if (sampleSize < HISTORY_MIN_SAMPLES)
+        return 0;
+    if (sampleSize >= HISTORY_FULL_SAMPLES)
+        return W_HISTORICAL_SUCCESS;
+    // Linear interpolation between min and full
+    const t = (sampleSize - HISTORY_MIN_SAMPLES) / (HISTORY_FULL_SAMPLES - HISTORY_MIN_SAMPLES);
+    return t * W_HISTORICAL_SUCCESS;
+}
+// ─── Factor Computations ──────────────────────────────────────────────────────
+function computeDependencyCoverage(bundle) {
+    const relationships = bundle.file_relationships;
+    if (!relationships || relationships.length === 0) {
+        // No relationship data: assume neutral coverage
+        return 0.7;
+    }
+    const bundlePaths = new Set(bundle.files.map((f) => f.path));
+    const targets = new Set(relationships.map((r) => r.to));
+    if (targets.size === 0)
+        return 1.0;
+    let covered = 0;
+    for (const t of targets) {
+        if (bundlePaths.has(t))
+            covered++;
+    }
+    return covered / targets.size;
+}
+function computeTestCoverage(bundle) {
+    const sourceFiles = bundle.files.filter((f) => !f.path.match(/\.(test|spec)\.[tj]sx?$/) && !f.is_stub);
+    if (sourceFiles.length === 0)
+        return 1.0;
+    // A file is "test-covered" if: it has test_relevant reason, or there's a
+    // matching .test. file in the bundle
+    const testPaths = new Set(bundle.files
+        .filter((f) => f.path.match(/\.(test|spec)\.[tj]sx?$/))
+        .map((f) => f.path));
+    let covered = 0;
+    for (const sf of sourceFiles) {
+        const hasTestReason = sf.reasons.includes('test_relevant');
+        const hasTestInBundle = [...testPaths].some((tp) => tp.includes(sf.path.replace(/\.[tj]sx?$/, '').split('/').pop() ?? ''));
+        if (hasTestReason || hasTestInBundle)
+            covered++;
+    }
+    return covered / sourceFiles.length;
+}
+function computeSymbolCompleteness(bundle, keywords) {
+    if (keywords.length === 0)
+        return 1.0;
+    // Check how many keywords appear in: file paths, reason codes, or high scores
+    const bundleText = bundle.files
+        .map((f) => f.path.toLowerCase() + ' ' + f.reasons.join(' '))
+        .join(' ');
+    const matched = keywords.filter((kw) => bundleText.includes(kw.toLowerCase()));
+    return matched.length / keywords.length;
+}
+// ─── Issue Reporting ──────────────────────────────────────────────────────────
+function collectIssues(factors, bundle, keywords, intentConfidence = 1.0) {
+    const issues = [];
+    if (factors.dependencyCoverage < 0.6) {
+        const missing = getMissingDeps(bundle);
+        for (const m of missing.slice(0, 3)) {
+            issues.push(`missing dependency: ${m}`);
+        }
+        if (missing.length > 3) {
+            issues.push(`… and ${missing.length - 3} more missing dependencies`);
+        }
+    }
+    if (factors.testCoverageMapping < 0.5) {
+        issues.push('test mapping incomplete — less than 50% of source files have linked tests');
+    }
+    // Historical confidence: report sample size + weight applied
+    if (factors.historySampleSize < HISTORY_MIN_SAMPLES) {
+        issues.push(`historical data insufficient (${factors.historySampleSize} entries) — success rate weight set to 0 until ${HISTORY_MIN_SAMPLES}+ entries`);
+    }
+    else if (factors.historySampleSize < HISTORY_FULL_SAMPLES) {
+        const pct = (factors.adjustedHistoricalWeight / W_HISTORICAL_SUCCESS * 100).toFixed(0);
+        issues.push(`historical data maturing (${factors.historySampleSize} entries) — success rate weight at ${pct}% of full`);
+    }
+    else if (factors.historicalSuccessRate < 0.4) {
+        issues.push(`low historical success rate (${(factors.historicalSuccessRate * 100).toFixed(0)}%) for this intent type`);
+    }
+    if (intentConfidence < 0.4) {
+        issues.push(`low intent confidence (${(intentConfidence * 100).toFixed(0)}%) — task description is ambiguous; consider adding domain or operation keywords`);
+    }
+    if (factors.symbolCompleteness < 0.5) {
+        const unmatched = keywords.filter((kw) => {
+            const bundleText = bundle.files
+                .map((f) => f.path.toLowerCase() + ' ' + f.reasons.join(' '))
+                .join(' ');
+            return !bundleText.includes(kw.toLowerCase());
+        });
+        if (unmatched.length > 0) {
+            issues.push(`task keywords not matched in bundle: ${unmatched.slice(0, 4).join(', ')}`);
+        }
+    }
+    if (factors.expansionLevelPenalty > 0.15) {
+        issues.push(`context expanded to level ${Math.round(factors.expansionLevelPenalty / 0.1) + 1} — earlier iterations were insufficient`);
+    }
+    if (bundle.confidence?.level === 'low') {
+        issues.push('bundle confidence is LOW — run with --expand to increase coverage');
+    }
+    return issues;
+}
+function getMissingDeps(bundle) {
+    if (!bundle.file_relationships)
+        return [];
+    const bundlePaths = new Set(bundle.files.map((f) => f.path));
+    return [...new Set(bundle.file_relationships
+            .filter((r) => !bundlePaths.has(r.to))
+            .map((r) => r.to))];
+}
+// ─── Recommendation ───────────────────────────────────────────────────────────
+/**
+ * Determine the gating recommendation from the CCS score.
+ *
+ * Policy (FIX 4 — explicit, unambiguous thresholds):
+ *   >= 0.75 → PROCEED  (context is sufficient)
+ *   0.60–0.75 → EXPAND  (context needs broadening; do NOT block, suggest next level)
+ *   < 0.60  → BLOCK    (context is insufficient; stop unless --force)
+ */
+function recommendAction(score, currentLevel, _issues) {
+    if (score >= CCS_PROCEED_THRESHOLD) {
+        return { recommendation: 'proceed' };
+    }
+    if (score >= CCS_EXPAND_THRESHOLD) {
+        // Suggest expanding to the next level (max L4)
+        return {
+            recommendation: 'expand',
+            suggestedExpansionLevel: Math.min(currentLevel + 1, 4),
+        };
+    }
+    // Below expand threshold → block
+    return { recommendation: 'block' };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function clamp(v, min, max) {
+    return Math.min(max, Math.max(min, v));
+}
+//# sourceMappingURL=score.js.map

package/dist/ccs/score.js.map

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

package/dist/ecl/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ECL-Lite — Local Context Ledger
+ *
+ * Persistent institutional memory for CodeLedger. Records execution cycles
+ * to `.codeledger/ecl-lite.jsonl` and provides success/failure indexes that
+ * feed deterministic pattern weighting back into the CCS and selector.
+ */
+export { eclPath, recordExecution, buildEntry, loadEntries, buildWeightIndex, historicalSuccessRate, historicalSuccessContext, buildFailureHotspots, ledgerStatus, pruneLedger, ECL_FILENAME, } from './ledger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecl/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,eAAe,EACf,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/ecl/index.js

@@ -0,0 +1,9 @@
+/**
+ * ECL-Lite — Local Context Ledger
+ *
+ * Persistent institutional memory for CodeLedger. Records execution cycles
+ * to `.codeledger/ecl-lite.jsonl` and provides success/failure indexes that
+ * feed deterministic pattern weighting back into the CCS and selector.
+ */
+export { eclPath, recordExecution, buildEntry, loadEntries, buildWeightIndex, historicalSuccessRate, historicalSuccessContext, buildFailureHotspots, ledgerStatus, pruneLedger, ECL_FILENAME, } from './ledger.js';
+//# sourceMappingURL=index.js.map

package/dist/ecl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ecl/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,eAAe,EACf,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/ecl/ledger.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ECL-Lite — Local Context Ledger
+ *
+ * Provides persistent institutional memory for CodeLedger. Records every
+ * execution cycle to `.codeledger/ecl-lite.jsonl` (JSON Lines, append-only).
+ *
+ * Responsibilities:
+ * - Append execution outcomes (success/failure + context used)
+ * - Build and query success/failure indexes
+ * - Expose ledger status, inspection, and pruning
+ *
+ * Format: JSON Lines — one EclLiteEntry per line. Human-readable, no SQLite
+ * dependency. Safe for concurrent reads; single-writer append model.
+ *
+ * Deterministic: integer weights only, no floats in the index.
+ */
+import type { EclLiteEntry, EclWeightEntry, FailureHotspot, EclLiteStatus } from '@codeledger/types';
+export declare const ECL_FILENAME = "ecl-lite.jsonl";
+/** Derive the ECL-lite path for a given repo root */
+export declare function eclPath(repoRoot: string): string;
+/**
+ * Append a new execution cycle entry to the ledger.
+ * Creates the file (and `.codeledger/` dir) if they don't exist.
+ */
+export declare function recordExecution(repoRoot: string, entry: EclLiteEntry): void;
+/**
+ * Build an EclLiteEntry from the inputs of a completed execution cycle.
+ * Computes the contextHash deterministically from the sorted file list.
+ */
+export declare function buildEntry(intentSignature: string, files: string[], symbols: string[], expansionLevel: number, outcome: 'success' | 'failure', confidenceScore: number, failureVector?: {
+    kind: string;
+    implicated_files: string[];
+}, intentCategory?: string): EclLiteEntry;
+/**
+ * Load all entries from the ledger.
+ * Returns empty array if ledger does not exist or is malformed.
+ */
+export declare function loadEntries(repoRoot: string): EclLiteEntry[];
+/**
+ * Build the success/failure weight index from ledger entries.
+ *
+ * Uses integer arithmetic only — deterministic, no floats.
+ * successWeight++ on each success, failureWeight++ on each failure.
+ */
+export declare function buildWeightIndex(entries: EclLiteEntry[]): Map<string, EclWeightEntry>;
+/**
+ * Compute the historical success rate for an intent signature.
+ * Returns 0.5 (neutral) if no history exists.
+ */
+export declare function historicalSuccessRate(entries: EclLiteEntry[], intentSignature: string): number;
+/**
+ * Returns both the historical success rate AND the sample size used.
+ *
+ * Falls back to category-level aggregation when the specific intent signature
+ * has < 5 entries — avoids early-data noise from single-entry signatures.
+ *
+ * Priority:
+ *   1. Exact intentSignature match (>= 5 entries) → specific rate
+ *   2. intentCategory match (< 5 exact OR no exact) → category rate
+ *   3. No data → 0.5 neutral prior
+ */
+export declare function historicalSuccessContext(entries: EclLiteEntry[], intentSignature: string, intentCategory?: string): {
+    rate: number;
+    sampleSize: number;
+};
+/**
+ * Build the failure hotspot index — files frequently implicated in failures.
+ * Returns hotspots sorted by implicationRate descending.
+ *
+ * v2.1.1: tracks lastFailureTimestamp per file for recency decay in slice-builder.
+ */
+export declare function buildFailureHotspots(entries: EclLiteEntry[]): FailureHotspot[];
+/**
+ * Compute overall ledger status summary.
+ */
+export declare function ledgerStatus(repoRoot: string): EclLiteStatus;
+/**
+ * Prune old entries to keep the ledger bounded.
+ * Keeps the most recent `maxEntries` entries (default 2000).
+ * Rewrites the entire file atomically (temp-write then rename not available
+ * in pure Node fs sync, so writes to path directly).
+ */
+export declare function pruneLedger(repoRoot: string, maxEntries?: number): number;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/ecl/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/ecl/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAK7C,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAI3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,EAC5D,cAAc,CAAC,EAAE,MAAM,GACtB,YAAY,CAmBd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAqBrF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,eAAe,EAAE,MAAM,GACtB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EAAE,EACvB,eAAe,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA0BtC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAoC9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAsB5D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAsB,GAAG,MAAM,CAWtF"}