@codeledger/selector 0.5.0 → 0.5.1

package/dist/index.d.ts

@@ -36,4 +36,7 @@ export { buildKnowledgeBundle, buildKnowledgeTrace } from './knowledge-bundle.js
 export type { KnowledgeBundleOptions } from './knowledge-bundle.js';
 export { detectSelectionMode } from './mode-detect.js';
 export type { ModeDetectionInput } from './mode-detect.js';
+export { generateReviewCandidates, splitReviewCandidates } from './review-candidates.js';
+export { computeReviewCoverage, meetsCoverageThreshold, getShallowReads } from './review-coverage.js';
+export type { ReadDepthInput } from './review-coverage.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -28,4 +28,7 @@ export { tokenizeIntent, computeKnowledgeTokenWeights, inferAnchorFolders, gener
 export { extractKnowledgeExcerpt } from './knowledge-excerpt.js';
 export { buildKnowledgeBundle, buildKnowledgeTrace } from './knowledge-bundle.js';
 export { detectSelectionMode } from './mode-detect.js';
+// ─── Review Coverage (Sentinel) ──────────────────────────────────────────────
+export { generateReviewCandidates, splitReviewCandidates } from './review-candidates.js';
+export { computeReviewCoverage, meetsCoverageThreshold, getShallowReads } from './review-coverage.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,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE5G,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEjH,+EAA+E;AAC/E,OAAO,EACL,IAAI,IAAI,UAAU,EAClB,OAAO,IAAI,aAAa,EACxB,YAAY,EACZ,MAAM,IAAI,YAAY,EACtB,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE5G,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEjH,+EAA+E;AAC/E,OAAO,EACL,IAAI,IAAI,UAAU,EAClB,OAAO,IAAI,aAAa,EACxB,YAAY,EACZ,MAAM,IAAI,YAAY,EACtB,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,gFAAgF;AAChF,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

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":"AAOA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,SAAoB,EACpB,QAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9D,+DAA+D;IAC/D,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;YACnB,IAAI;YACJ,aAAa,EAAE,oBAAoB;YACnC,WAAW,EAAE,WAAW;YACxB,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;gBACnB,IAAI;gBACJ,aAAa,EAAE,eAAe;gBAC9B,WAAW,EAAE,WAAW;gBACxB,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;oBACnB,IAAI;oBACJ,aAAa,EAAE,gBAAgB;oBAC/B,WAAW,EAAE,WAAW;oBACxB,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjE,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,cAAc,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,WAAW,GAAsB,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;gBACtF,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;oBACnB,IAAI;oBACJ,aAAa,EAAE,kBAAkB;oBACjC,WAAW;oBACX,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,MAAM,aAAa,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE;oBAClB,IAAI,EAAE,GAAG;oBACT,aAAa,EAAE,kBAAkB;oBACjC,WAAW,EAAE,aAAa;oBAC1B,SAAS,EAAE,GAAG;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpD,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,SAAsB;IAChE,sDAAsD;IACtD,MAAM,WAAW,GAAG,oEAAoE,CAAC;IACzF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC5B,wCAAwC;QACxC,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,IAAY,EAAE,SAAoB;IAC/D,MAAM,UAAU,GAAG,uCAAuC,CAAC;IAC3D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,yCAAyC;QACzC,MAAM,eAAe,GAAG;YACtB,GAAG,GAAG,eAAe;YACrB,GAAG,GAAG,eAAe;YACrB,GAAG,GAAG,WAAW;YACjB,GAAG,GAAG,WAAW;SAClB,CAAC;QACF,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YAChE,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACjG,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,mEAAmE;AACnE,SAAS,kBAAkB,CAAC,SAAoB;IAC9C,OAAO,SAAS,CAAC,KAAK;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC3C,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,CAAC;IACpD,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,0DAA0D;AAC1D,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACxB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;QACnE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;QACnE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;QACjE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;QAC/D,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO;QACxD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;QAClE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;QAC/D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;QAChE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;QAChE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU;KACtE,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5E,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACjD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,uEAAuE;AACvE,SAAS,oBAAoB,CAC3B,QAAkB,EAClB,SAAoB;IAEpB,MAAM,OAAO,GAA+C,EAAE,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO;YAAE,SAAS;QAE3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAE1C,sBAAsB;QACtB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,KAAK,IAAI,GAAG,CAAC;YACf,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAClD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACvB,KAAK,IAAI,IAAI,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA6B;IAE7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}

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

package/dist/review-coverage.js

@@ -0,0 +1,110 @@
+/**
+ * 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 function computeReviewCoverage(requiredFiles, readDepths, readPaths, repoIndex, firstClaimTs) {
+    const requiredSet = new Set(requiredFiles);
+    const readPathSet = readPaths;
+    // Files actually read (intersection with required)
+    const filesRead = [];
+    const filesSkipped = [];
+    for (const rf of requiredFiles) {
+        if (readPathSet.has(rf)) {
+            filesRead.push(rf);
+        }
+        else {
+            filesSkipped.push(rf);
+        }
+    }
+    // File-level coverage
+    const fileCoverage = requiredFiles.length > 0
+        ? filesRead.length / requiredFiles.length
+        : 1.0;
+    // Build file depth entries for required files
+    const depthMap = new Map();
+    for (const d of readDepths) {
+        depthMap.set(d.path, d);
+    }
+    // Build FileReadDepth entries for all required files (including unread ones)
+    const fileDepths = [];
+    const repoFileMap = new Map();
+    for (const f of repoIndex.files) {
+        repoFileMap.set(f.path, f.lines);
+    }
+    for (const rf of requiredFiles) {
+        const depthInfo = depthMap.get(rf);
+        if (depthInfo) {
+            fileDepths.push({
+                path: depthInfo.path,
+                total_lines: depthInfo.total_lines,
+                lines_read: depthInfo.lines_read,
+                read_depth: depthInfo.read_depth,
+                first_read_at: depthInfo.first_read_at,
+                read_count: depthInfo.read_count,
+            });
+        }
+        else {
+            // Unread file
+            const totalLines = repoFileMap.get(rf) ?? 0;
+            fileDepths.push({
+                path: rf,
+                total_lines: totalLines,
+                lines_read: 0,
+                read_depth: 0,
+                first_read_at: '',
+                read_count: 0,
+            });
+        }
+    }
+    // Depth-weighted coverage: average read_depth across required files
+    let depthSum = 0;
+    for (const fd of fileDepths) {
+        depthSum += fd.read_depth;
+    }
+    const depthWeightedCoverage = requiredFiles.length > 0
+        ? depthSum / requiredFiles.length
+        : 1.0;
+    // Post-hoc reads: files first read AFTER the first claim timestamp
+    let postHocReads = [];
+    if (firstClaimTs) {
+        for (const fd of fileDepths) {
+            if (fd.read_count > 0 &&
+                fd.first_read_at &&
+                fd.first_read_at > firstClaimTs &&
+                requiredSet.has(fd.path)) {
+                postHocReads.push(fd.path);
+            }
+        }
+        postHocReads.sort();
+    }
+    return {
+        required_files: requiredFiles,
+        files_read: filesRead,
+        files_skipped: filesSkipped,
+        file_coverage: fileCoverage,
+        depth_weighted_coverage: depthWeightedCoverage,
+        file_depths: fileDepths,
+        post_hoc_reads: postHocReads,
+        analyzed_at: new Date().toISOString(),
+    };
+}
+/**
+ * Evaluate whether coverage meets a threshold.
+ * Returns true if both file coverage and depth coverage meet their thresholds.
+ */
+export function meetsCoverageThreshold(report, fileCoverageThreshold, depthCoverageThreshold) {
+    return (report.file_coverage >= fileCoverageThreshold &&
+        report.depth_weighted_coverage >= depthCoverageThreshold);
+}
+/**
+ * Get files that were only shallowly read (below a depth threshold).
+ */
+export function getShallowReads(report, shallowThreshold) {
+    return report.file_depths.filter((fd) => fd.read_count > 0 && fd.read_depth < shallowThreshold);
+}
+//# sourceMappingURL=review-coverage.js.map

package/dist/review-coverage.js.map

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@codeledger/selector",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "type": "module",
   "description": "Deterministic context selection algorithm for CodeLedger",
-  "license": "Apache-2.0",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/codeledgerECF/codeledger-blackbox.git",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@codeledger/types": "0.5.0"
+    "@codeledger/types": "0.5.1"
   },
   "devDependencies": {
     "typescript": "^5.4.0"