@codeledger/selector 0.2.1 → 0.5.1

package/dist/intent/normalize.js

@@ -0,0 +1,35 @@
+/**
+ * Deterministic normalization for intent governance.
+ *
+ * Rules:
+ * 1. Trim whitespace
+ * 2. Lowercase
+ * 3. Collapse internal whitespace to single spaces
+ * 4. Remove non-semantic punctuation: ,;:!? (keep / - _ . for paths/flags/extensions)
+ * 4b. Remove periods only at word boundaries or end of string (preserve .ts, .js, etc.)
+ * 5. Normalize path separators to /
+ * 6. Remove trailing /
+ * 7. Sort arrays lexicographically
+ * 8. Remove duplicates
+ */
+/**
+ * Normalize a single string value.
+ */
+export function norm(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/\\/g, '/') // normalize path separators early (before punctuation removal)
+        .replace(/[,;:!?]/g, '') // remove non-semantic punctuation (NOT periods)
+        .replace(/\.(?=\s|$)/g, '') // remove periods only at word boundaries or end of string
+        .replace(/\s+/g, ' ')
+        .replace(/\/+$/, ''); // remove trailing /
+}
+/**
+ * Normalize an array of strings: norm each, deduplicate, sort.
+ */
+export function normArr(xs) {
+    const set = new Set(xs.map(norm).filter(Boolean));
+    return Array.from(set).sort();
+}
+//# sourceMappingURL=normalize.js.map

package/dist/intent/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/intent/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,CAAC;SACL,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,+DAA+D;SACnF,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,gDAAgD;SACxE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,0DAA0D;SACrF,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/intent/types.d.ts

@@ -0,0 +1,37 @@
+import type { AddressedFile, BundleInvalidationReport } from '@codeledger/types';
+/** Structured, normalized representation of the session's objective */
+export interface TaskContractV1 {
+    version: 1;
+    objective: string;
+    deliverable: string | null;
+    scope_in: string[];
+    scope_out: string[];
+    constraints: string[];
+    acceptance_criteria: string[];
+    risk_flags: string[];
+    repo_paths_in_scope: string[];
+    timestamp: string;
+}
+export type DriftLevel = 'NONE' | 'MINOR' | 'MAJOR' | 'CRITICAL';
+export interface DriftReason {
+    field: keyof Omit<TaskContractV1, 'version' | 'timestamp'>;
+    distance: number;
+}
+export interface DriftResult {
+    drift_score: number;
+    drift_level: DriftLevel;
+    reasons: DriftReason[];
+}
+/** Event record written to intent_drift.jsonl */
+export interface IntentDriftEvent {
+    ts: string;
+    type: 'INTENT_DRIFT';
+    baseline_hash: string;
+    current_hash: string;
+    drift_score: number;
+    drift_level: DriftLevel;
+    reasons: DriftReason[];
+    recommended_action: 'NONE' | 'LOG_ONLY' | 'REFRESH_BUNDLE' | 'REQUIRE_ACK';
+}
+export type { AddressedFile, BundleInvalidationReport, };
+//# sourceMappingURL=types.d.ts.map

package/dist/intent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAIjF,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,aAAa,CAAC;CAC5E;AAGD,YAAY,EACV,aAAa,EACb,wBAAwB,GACzB,CAAC"}

package/dist/intent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/intent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":""}

package/dist/loop-detection.d.ts

@@ -0,0 +1,28 @@
+import type { LoopDetectionConfig, LoopDetectionReport } from '@codeledger/types';
+/** Default thresholds for loop detection */
+export declare const DEFAULT_LOOP_THRESHOLDS: LoopDetectionConfig;
+/** Entry in the session activity log — tracks tool usage for pattern detection */
+export interface ActivityEntry {
+    type: 'test_run' | 'file_edit' | 'command';
+    target: string;
+    success: boolean;
+    /** Hash of failure output for duplicate detection */
+    output_hash?: string;
+}
+/**
+ * Analyze a session's activity log for stuck patterns.
+ *
+ * All detection is numeric and deterministic — pattern matching on
+ * activity sequences with configurable thresholds.
+ */
+export declare function detectStuckPatterns(activities: ActivityEntry[], config?: LoopDetectionConfig): LoopDetectionReport;
+/**
+ * Parse git log and diff output into activity entries for loop detection.
+ * This enables post-hoc analysis from git state without requiring
+ * real-time event ledger integration.
+ */
+export declare function buildActivityLogFromGit(_commitLog: string[], fileEdits: Map<string, number>, testResults: Array<{
+    name: string;
+    pass: boolean;
+}>): ActivityEntry[];
+//# sourceMappingURL=loop-detection.d.ts.map

package/dist/loop-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detection.d.ts","sourceRoot":"","sources":["../src/loop-detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAgB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhG,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,EAAE,mBAIrC,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,aAAa,EAAE,EAC3B,MAAM,GAAE,mBAA6C,GACpD,mBAAmB,CAqDrB;AA8DD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAClD,aAAa,EAAE,CAoBjB"}

package/dist/loop-detection.js

@@ -0,0 +1,124 @@
+/** Default thresholds for loop detection */
+export const DEFAULT_LOOP_THRESHOLDS = {
+    max_test_retries: 3,
+    max_file_edits: 5,
+    max_command_retries: 3,
+};
+/**
+ * Analyze a session's activity log for stuck patterns.
+ *
+ * All detection is numeric and deterministic — pattern matching on
+ * activity sequences with configurable thresholds.
+ */
+export function detectStuckPatterns(activities, config = DEFAULT_LOOP_THRESHOLDS) {
+    const episodes = [];
+    // 1. Repeated test failures without progress
+    const testFailStreaks = detectRepeatedFailures(activities.filter((a) => a.type === 'test_run'), config.max_test_retries);
+    for (const streak of testFailStreaks) {
+        episodes.push({
+            type: 'repeated_test_failure',
+            target: streak.target,
+            count: streak.count,
+            message: `Test "${streak.target}" failed ${streak.count} consecutive times with no file changes between runs`,
+        });
+    }
+    // 2. Same file edited excessively
+    const fileEditCounts = new Map();
+    for (const a of activities) {
+        if (a.type === 'file_edit') {
+            fileEditCounts.set(a.target, (fileEditCounts.get(a.target) ?? 0) + 1);
+        }
+    }
+    for (const [file, count] of fileEditCounts) {
+        if (count > config.max_file_edits) {
+            episodes.push({
+                type: 'repeated_file_edit',
+                target: file,
+                count,
+                message: `File "${file}" was edited ${count} times (threshold: ${config.max_file_edits})`,
+            });
+        }
+    }
+    // 3. Same command fails repeatedly with identical output
+    const commandFailStreaks = detectRepeatedCommandFailures(activities.filter((a) => a.type === 'command'), config.max_command_retries);
+    for (const streak of commandFailStreaks) {
+        episodes.push({
+            type: 'repeated_command_failure',
+            target: streak.target,
+            count: streak.count,
+            message: `Command "${streak.target}" failed ${streak.count} times with identical output`,
+        });
+    }
+    return {
+        stuck_episodes: episodes,
+        total_episodes: episodes.length,
+    };
+}
+/**
+ * Find sequences of test failures with no intervening file changes.
+ * A file_edit activity between test runs resets the counter.
+ */
+function detectRepeatedFailures(testActivities, threshold) {
+    const streaks = [];
+    const currentStreak = new Map();
+    for (const a of testActivities) {
+        if (!a.success) {
+            const count = (currentStreak.get(a.target) ?? 0) + 1;
+            currentStreak.set(a.target, count);
+            if (count >= threshold) {
+                // Only report once per target at the threshold
+                if (count === threshold) {
+                    streaks.push({ target: a.target, count });
+                }
+            }
+        }
+        else {
+            // Test passed — reset streak for this target
+            currentStreak.delete(a.target);
+        }
+    }
+    return streaks;
+}
+/**
+ * Find commands that fail repeatedly with the same output hash.
+ */
+function detectRepeatedCommandFailures(commandActivities, threshold) {
+    const streaks = [];
+    // Group by target + output_hash
+    const failCounts = new Map();
+    for (const a of commandActivities) {
+        if (!a.success && a.output_hash) {
+            const key = `${a.target}::${a.output_hash}`;
+            const count = (failCounts.get(key) ?? 0) + 1;
+            failCounts.set(key, count);
+            if (count === threshold) {
+                streaks.push({ target: a.target, count });
+            }
+        }
+    }
+    return streaks;
+}
+/**
+ * Parse git log and diff output into activity entries for loop detection.
+ * This enables post-hoc analysis from git state without requiring
+ * real-time event ledger integration.
+ */
+export function buildActivityLogFromGit(_commitLog, fileEdits, testResults) {
+    const activities = [];
+    // Add file edits
+    for (const [file, count] of fileEdits) {
+        for (let i = 0; i < count; i++) {
+            activities.push({ type: 'file_edit', target: file, success: true });
+        }
+    }
+    // Add test results
+    for (const result of testResults) {
+        activities.push({
+            type: 'test_run',
+            target: result.name,
+            success: result.pass,
+        });
+    }
+    return activities;
+}
+//# sourceMappingURL=loop-detection.js.map

package/dist/loop-detection.js.map

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

package/dist/review-candidates.d.ts

@@ -0,0 +1,23 @@
+import type { RepoIndex, DepGraph, ReviewCandidate } from '@codeledger/types';
+/**
+ * Generate review-mode candidates from a task prompt.
+ *
+ * Unlike edit-mode candidates (which predict files-to-edit), review-mode
+ * candidates identify files that MUST be read to verify a review task.
+ *
+ * Heuristics:
+ * 1. Extract file paths mentioned in the task prompt (literal path references)
+ * 2. Extract package/module names → resolve to entry points
+ * 3. For export/API review tasks: identify index.ts and re-export files
+ * 4. For feature review tasks: use keyword matching + dependency graph
+ * 5. Mark each file as MUST_READ (directly referenced) or SHOULD_READ (inferred)
+ */
+export declare function generateReviewCandidates(task: string, repoIndex: RepoIndex, depGraph: DepGraph): ReviewCandidate[];
+/**
+ * Split review candidates into must-read and should-read lists.
+ */
+export declare function splitReviewCandidates(candidates: ReviewCandidate[]): {
+    mustRead: string[];
+    shouldRead: string[];
+};
+//# sourceMappingURL=review-candidates.d.ts.map

package/dist/review-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-candidates.d.ts","sourceRoot":"","sources":["../src/review-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,GACjB,eAAe,EAAE,CA0FnB;AAyID;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,eAAe,EAAE,GAC5B;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAa9C"}

package/dist/review-candidates.js

@@ -0,0 +1,230 @@
+/**
+ * Generate review-mode candidates from a task prompt.
+ *
+ * Unlike edit-mode candidates (which predict files-to-edit), review-mode
+ * candidates identify files that MUST be read to verify a review task.
+ *
+ * Heuristics:
+ * 1. Extract file paths mentioned in the task prompt (literal path references)
+ * 2. Extract package/module names → resolve to entry points
+ * 3. For export/API review tasks: identify index.ts and re-export files
+ * 4. For feature review tasks: use keyword matching + dependency graph
+ * 5. Mark each file as MUST_READ (directly referenced) or SHOULD_READ (inferred)
+ */
+export function generateReviewCandidates(task, repoIndex, depGraph) {
+    const candidates = new Map();
+    const repoFiles = new Set(repoIndex.files.map((f) => f.path));
+    // Stage 1: Extract explicit file path references from the task
+    const explicitPaths = extractExplicitPaths(task, repoFiles);
+    for (const path of explicitPaths) {
+        candidates.set(path, {
+            path,
+            review_reason: 'explicit_reference',
+            requirement: 'must_read',
+            relevance: 1.0,
+        });
+    }
+    // Stage 2: Extract package/module references → resolve entry points
+    const packageEntries = resolvePackageEntries(task, repoIndex);
+    for (const path of packageEntries) {
+        if (!candidates.has(path)) {
+            candidates.set(path, {
+                path,
+                review_reason: 'package_entry',
+                requirement: 'must_read',
+                relevance: 0.9,
+            });
+        }
+    }
+    // Stage 3: For export/API review tasks, identify export surfaces
+    if (isExportReviewTask(task)) {
+        const exportSurfaces = findExportSurfaces(repoIndex);
+        for (const path of exportSurfaces) {
+            if (!candidates.has(path)) {
+                candidates.set(path, {
+                    path,
+                    review_reason: 'export_surface',
+                    requirement: 'must_read',
+                    relevance: 0.85,
+                });
+            }
+        }
+    }
+    // Stage 4: Keyword-inferred candidates from task text
+    const keywords = extractReviewKeywords(task);
+    if (keywords.length > 0) {
+        const keywordMatches = matchKeywordsToFiles(keywords, repoIndex);
+        for (const { path, relevance } of keywordMatches) {
+            if (!candidates.has(path)) {
+                const requirement = relevance >= 0.7 ? 'must_read' : 'should_read';
+                candidates.set(path, {
+                    path,
+                    review_reason: 'keyword_inferred',
+                    requirement,
+                    relevance,
+                });
+            }
+        }
+    }
+    // Stage 5: Expand must-read files via dependency graph
+    const mustReadPaths = [...candidates.entries()]
+        .filter(([_, c]) => c.requirement === 'must_read')
+        .map(([p]) => p);
+    for (const seedPath of mustReadPaths) {
+        const deps = depGraph.imports[seedPath];
+        if (!deps)
+            continue;
+        for (const dep of deps) {
+            if (!repoFiles.has(dep))
+                continue;
+            if (!candidates.has(dep)) {
+                candidates.set(dep, {
+                    path: dep,
+                    review_reason: 'dependency_chain',
+                    requirement: 'should_read',
+                    relevance: 0.6,
+                });
+            }
+        }
+    }
+    // Sort: must_read first, then by relevance descending
+    const result = [...candidates.values()].sort((a, b) => {
+        if (a.requirement !== b.requirement) {
+            return a.requirement === 'must_read' ? -1 : 1;
+        }
+        return b.relevance - a.relevance;
+    });
+    return result;
+}
+/**
+ * Extract file paths explicitly mentioned in the task text.
+ * Matches patterns like `packages/types/src/index.ts` or `src/foo.js`.
+ */
+function extractExplicitPaths(task, repoFiles) {
+    // Match anything that looks like a relative file path
+    const pathPattern = /(?:^|\s|["'`(])([a-zA-Z0-9_./\-]+\.[a-zA-Z]{1,6})(?:$|\s|["'`),])/g;
+    const found = [];
+    let match;
+    while ((match = pathPattern.exec(task)) !== null) {
+        const candidate = match[1];
+        // Check if this path exists in the repo
+        if (repoFiles.has(candidate)) {
+            found.push(candidate);
+        }
+    }
+    return [...new Set(found)];
+}
+/**
+ * Resolve package/module names mentioned in the task to their entry points.
+ * E.g., "packages/selector" → "packages/selector/src/index.ts"
+ */
+function resolvePackageEntries(task, repoIndex) {
+    const dirPattern = /(?:packages|src|lib)\/[a-zA-Z0-9_-]+/g;
+    const dirs = [];
+    let match;
+    while ((match = dirPattern.exec(task)) !== null) {
+        dirs.push(match[0]);
+    }
+    const entries = [];
+    for (const dir of dirs) {
+        // Look for index files in this directory
+        const indexCandidates = [
+            `${dir}/src/index.ts`,
+            `${dir}/src/index.js`,
+            `${dir}/index.ts`,
+            `${dir}/index.js`,
+        ];
+        for (const candidate of indexCandidates) {
+            const found = repoIndex.files.find((f) => f.path === candidate);
+            if (found) {
+                entries.push(found.path);
+                break;
+            }
+        }
+    }
+    return [...new Set(entries)];
+}
+/** Detect if the task is about reviewing exports, APIs, or public interfaces */
+function isExportReviewTask(task) {
+    const lower = task.toLowerCase();
+    const exportKeywords = ['export', 'api', 'public interface', 'surface', 'contract', 're-export'];
+    return exportKeywords.some((kw) => lower.includes(kw));
+}
+/** Find files that are export surfaces (index.ts, barrel files) */
+function findExportSurfaces(repoIndex) {
+    return repoIndex.files
+        .filter((f) => {
+        const name = f.path.split('/').pop() ?? '';
+        return name === 'index.ts' || name === 'index.js';
+    })
+        .map((f) => f.path);
+}
+/** Extract review-relevant keywords from a task prompt */
+function extractReviewKeywords(task) {
+    const stopWords = new Set([
+        'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+        'should', 'may', 'might', 'shall', 'can', 'need', 'must', 'ought',
+        'i', 'you', 'he', 'she', 'it', 'we', 'they', 'me', 'him', 'her',
+        'us', 'them', 'my', 'your', 'his', 'its', 'our', 'their',
+        'this', 'that', 'these', 'those', 'and', 'or', 'but', 'if', 'then',
+        'of', 'in', 'on', 'at', 'to', 'for', 'with', 'from', 'by', 'as',
+        'into', 'through', 'during', 'before', 'after', 'above', 'below',
+        'not', 'no', 'nor', 'so', 'very', 'just', 'all', 'each', 'every',
+        'review', 'verify', 'check', 'audit', 'ensure', 'confirm', 'validate',
+    ]);
+    const words = task.toLowerCase().replace(/[^a-z0-9_\-]/g, ' ').split(/\s+/);
+    return words
+        .filter((w) => w.length >= 3 && !stopWords.has(w))
+        .slice(0, 20);
+}
+/** Match keywords to repo files by path and content keyword overlap */
+function matchKeywordsToFiles(keywords, repoIndex) {
+    const results = [];
+    const keywordSet = new Set(keywords);
+    for (const file of repoIndex.files) {
+        if (file.is_test)
+            continue;
+        let score = 0;
+        const pathLower = file.path.toLowerCase();
+        // Path-based matching
+        for (const kw of keywords) {
+            if (pathLower.includes(kw)) {
+                score += 0.3;
+            }
+        }
+        // Content keyword matching
+        if (file.content_keywords) {
+            const contentSet = new Set(file.content_keywords);
+            for (const kw of keywordSet) {
+                if (contentSet.has(kw)) {
+                    score += 0.15;
+                }
+            }
+        }
+        const relevance = Math.min(score, 1.0);
+        if (relevance >= 0.15) {
+            results.push({ path: file.path, relevance });
+        }
+    }
+    // Sort by relevance descending
+    results.sort((a, b) => b.relevance - a.relevance);
+    return results.slice(0, 50);
+}
+/**
+ * Split review candidates into must-read and should-read lists.
+ */
+export function splitReviewCandidates(candidates) {
+    const mustRead = [];
+    const shouldRead = [];
+    for (const c of candidates) {
+        if (c.requirement === 'must_read') {
+            mustRead.push(c.path);
+        }
+        else {
+            shouldRead.push(c.path);
+        }
+    }
+    return { mustRead, shouldRead };
+}
+//# sourceMappingURL=review-candidates.js.map

package/dist/review-candidates.js.map

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

package/dist/review-coverage.d.ts

@@ -0,0 +1,33 @@
+import type { ReviewCoverageReport, FileReadDepth, ISODateTime, RepoIndex } from '@codeledger/types';
+/**
+ * Read depth info for a file (from ReadTracker or equivalent).
+ * This is the input interface — decoupled from the instrument package.
+ */
+export interface ReadDepthInput {
+    path: string;
+    total_lines: number;
+    lines_read: number;
+    read_depth: number;
+    first_read_at: ISODateTime;
+    read_count: number;
+}
+/**
+ * Compute review coverage by comparing the review bundle's required files
+ * against the session's actual read data.
+ *
+ * Three metrics:
+ * 1. File Coverage — did the agent open the file at all?
+ * 2. Depth-Weighted Coverage — how much of each file was actually read?
+ * 3. Temporal Alignment — did reads happen BEFORE claims, or after?
+ */
+export declare function computeReviewCoverage(requiredFiles: string[], readDepths: ReadDepthInput[], readPaths: Set<string>, repoIndex: RepoIndex, firstClaimTs?: ISODateTime): ReviewCoverageReport;
+/**
+ * Evaluate whether coverage meets a threshold.
+ * Returns true if both file coverage and depth coverage meet their thresholds.
+ */
+export declare function meetsCoverageThreshold(report: ReviewCoverageReport, fileCoverageThreshold: number, depthCoverageThreshold: number): boolean;
+/**
+ * Get files that were only shallowly read (below a depth threshold).
+ */
+export declare function getShallowReads(report: ReviewCoverageReport, shallowThreshold: number): FileReadDepth[];
+//# sourceMappingURL=review-coverage.d.ts.map

package/dist/review-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-coverage.d.ts","sourceRoot":"","sources":["../src/review-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,EAAE,cAAc,EAAE,EAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,WAAW,GACzB,oBAAoB,CA8FtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,qBAAqB,EAAE,MAAM,EAC7B,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,gBAAgB,EAAE,MAAM,GACvB,aAAa,EAAE,CAIjB"}