@codeledger/cli 0.2.1 → 0.5.1

package/dist/commands/session-summary.js

@@ -2,7 +2,10 @@ import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { execSync } from 'node:child_process';
 import { resolveSessionId } from '../session-id.js';
-import { sessionActivateRef, sessionStartRef } from '../session-paths.js';
+import { sessionActivateRef, sessionStartRef, sessionTaskHistoryPath, sessionReadLogPath, sessionReviewConfigPath, } from '../session-paths.js';
+import { countCheckpoints } from './checkpoint.js';
+import { evaluateDrift } from './intent.js';
+import { loadReadTracker } from './review-coverage.js';
 /**
  * `codeledger session-summary [--session <id>]`
  *
@@ -18,7 +21,9 @@ import { sessionActivateRef, sessionStartRef } from '../session-paths.js';
 export async function runSessionSummary(cwd, flags) {
     const configPath = join(cwd, '.codeledger', 'config.json');
     if (!existsSync(configPath)) {
-        // No CodeLedger setup — exit silently (don't pollute agent output)
+        if (flags['quiet'] !== 'true') {
+            console.log('No .codeledger/ found. Run "codeledger init" first.');
+        }
         return;
     }
     let config;
@@ -56,6 +61,43 @@ export async function runSessionSummary(cwd, flags) {
     const reductionPct = repoTokens > 0
         ? ((repoTokens - bundle.total_tokens) / repoTokens) * 100
         : 0;
+    // ── Debt injection detection ─────────────────────────────────────────────
+    const debt = analyzeDebt(cwd, sessionId);
+    // ── Commit hygiene analysis ─────────────────────────────────────────────
+    const commitHygiene = analyzeCommitHygiene(cwd, sessionId, bundleFiles);
+    // ── Scope drift detection ─────────────────────────────────────────────
+    const scopeDriftFiles = bundle.scope_contract
+        ? getScopeDriftFiles(filesChanged, bundle.scope_contract)
+        : [];
+    const scopeDriftCount = scopeDriftFiles.length > 0 ? scopeDriftFiles.length : undefined;
+    // ── Conflict zone touches ─────────────────────────────────────────────
+    const conflictZoneTouches = bundle.conflict_zones
+        ? countConflictTouches(filesChanged, bundle.conflict_zones)
+        : undefined;
+    // ── Bundle invalidation (commit-aware staleness) ──────────────────────
+    const bundleInvalidation = analyzeBundleInvalidation(cwd, sessionId, bundleFiles);
+    // ── Checkpoint count ──────────────────────────────────────────────────
+    const checkpointCount = countCheckpoints(cwd, sessionId);
+    // ── Review coverage (Sentinel) ───────────────────────────────────────
+    let reviewCoverage;
+    const reviewConfigPath = sessionReviewConfigPath(cwd, sessionId);
+    if (existsSync(reviewConfigPath)) {
+        try {
+            const reviewConfig = JSON.parse(readFileSync(reviewConfigPath, 'utf-8'));
+            const indexPath = join(cwd, config.workspace.cache_dir, 'repo-index.json');
+            if (existsSync(indexPath)) {
+                const ridx = JSON.parse(readFileSync(indexPath, 'utf-8'));
+                const readLogPath = sessionReadLogPath(cwd, sessionId);
+                const tracker = loadReadTracker(readLogPath, ridx);
+                const { computeReviewCoverage } = await import('@codeledger/selector');
+                const allRequired = [...reviewConfig.must_read_files, ...reviewConfig.should_read_files];
+                reviewCoverage = computeReviewCoverage(allRequired, tracker.getAllDepths(), tracker.getReadPaths(), ridx);
+            }
+        }
+        catch {
+            // Non-fatal: review coverage is optional enrichment
+        }
+    }
     const summary = {
         bundle_id: bundle.bundle_id,
         task: bundle.task,
@@ -69,13 +111,24 @@ export async function runSessionSummary(cwd, flags) {
         context_reduction_pct: reductionPct,
         generated_at: new Date().toISOString(),
         session_id: sessionId ?? undefined,
+        debt: debt ?? undefined,
+        commit_hygiene: commitHygiene ?? undefined,
+        scope_drift_count: scopeDriftCount,
+        conflict_zone_touches: conflictZoneTouches,
+        checkpoint_count: checkpointCount > 0 ? checkpointCount : undefined,
+        bundle_invalidation: bundleInvalidation ?? undefined,
+        review_coverage: reviewCoverage,
     };
-    // ── Print concise recap ─────────────────────────────────────────────────
-    printRecap(summary);
+    // ── Intent drift evaluation ───────────────────────────────────────────
+    const intentDrift = evaluateDrift(cwd, sessionId);
     // ── Session-wide aggregate (only on --final, i.e. Stop hook) ───────────
+    // Print the per-task breakdown FIRST when --final is set, so the most
+    // useful information appears at the top (Fix 3.1)
     if (flags['final'] === 'true') {
         printSessionAggregate(cwd, sessionId, summary);
     }
+    // ── Print concise recap ─────────────────────────────────────────────────
+    printRecap(summary, intentDrift, scopeDriftFiles, config.suggestions?.prefill_task === true);
 }
 function loadLatestBundle(cwd, config) {
     const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
@@ -145,7 +198,7 @@ function getSessionChangedFiles(cwd, sessionId) {
                 }
             }
         }
-        return [...files];
+        return [...files].filter((f) => !f.startsWith('.codeledger/') && !f.startsWith('.claude/'));
     }
     catch {
         return [];
@@ -164,7 +217,7 @@ function estimateRepoTokens(cwd, config) {
         return 0;
     }
 }
-function printRecap(s) {
+function printRecap(s, intentDrift, scopeDriftFiles, prefillTask) {
     const recallPct = Math.round(s.recall * 100);
     const precisionPct = Math.round(s.precision * 100);
     const reductionPct = Math.round(s.context_reduction_pct);
@@ -183,7 +236,7 @@ function printRecap(s) {
         lines.push(`   Bundle missed: predicted ${s.files_overlapping.length}/${s.files_changed.length} files you changed (${recallPct}% recall)`);
         lines.push(`   Bundle accuracy: ${s.files_overlapping.length}/${s.bundle_files.length} bundled files were relevant (${precisionPct}% precision)`);
         lines.push(`   The bundle was not useful for this task.`);
-        lines.push(`   Tip: Re-run "codeledger activate --task ..." with a more specific task description.`);
+        lines.push(`   Tip: Re-run "codeledger activate --task ${prefillTask ? `"${s.task}"` : '...'}" with a more specific task description.`);
     }
     else if (s.recall < 0.5) {
         // Bundle was partially useful — show all stats but highlight room to improve
@@ -198,6 +251,83 @@ function printRecap(s) {
         lines.push(`   Bundle accuracy: ${s.files_overlapping.length}/${s.bundle_files.length} bundled files were relevant (${precisionPct}% precision)`);
         lines.push(`   Context: ~${fmtTokens(s.bundle_tokens)} tokens vs ~${fmtTokens(s.repo_total_tokens)} full repo (${reductionPct}% reduction)`);
     }
+    // ── Debt injection section ───────────────────────────────────────────
+    if (s.debt && s.debt.total_suppressions > 0) {
+        lines.push(`   Debt: ${s.debt.total_suppressions} suppression${s.debt.total_suppressions === 1 ? '' : 's'} detected (score: ${s.debt.debt_score.toFixed(2)})`);
+        // Show up to 3 debt warnings
+        for (const w of s.debt.warnings.slice(0, 3)) {
+            lines.push(`     - ${w.file}:${w.line}: ${w.message}`);
+        }
+        if (s.debt.warnings.length > 3) {
+            lines.push(`     ... and ${s.debt.warnings.length - 3} more`);
+        }
+    }
+    // ── Commit hygiene section ──────────────────────────────────────────
+    if (s.commit_hygiene) {
+        const h = s.commit_hygiene;
+        const issues = [];
+        if (h.empty_commits > 0)
+            issues.push(`${h.empty_commits} empty`);
+        if (h.no_verify_count > 0)
+            issues.push(`${h.no_verify_count} --no-verify`);
+        if (h.out_of_scope_files.length > 0)
+            issues.push(`${h.out_of_scope_files.length} out-of-scope files`);
+        if (issues.length > 0) {
+            lines.push(`   Commit hygiene: ${h.hygiene_score.toFixed(2)} (${issues.join(', ')})`);
+        }
+    }
+    // ── Scope drift section ───────────────────────────────────────────
+    if (s.scope_drift_count !== undefined && s.scope_drift_count > 0) {
+        lines.push(`   Scope drift: ${s.scope_drift_count} file${s.scope_drift_count === 1 ? '' : 's'} edited outside scope contract`);
+        if (scopeDriftFiles && scopeDriftFiles.length > 0) {
+            for (const f of scopeDriftFiles.slice(0, 5)) {
+                lines.push(`     - ${f}`);
+            }
+            if (scopeDriftFiles.length > 5) {
+                lines.push(`     ... and ${scopeDriftFiles.length - 5} more`);
+            }
+        }
+    }
+    // ── Conflict zone touches section ─────────────────────────────────
+    if (s.conflict_zone_touches !== undefined && s.conflict_zone_touches > 0) {
+        lines.push(`   Conflict zones: ${s.conflict_zone_touches} contested file${s.conflict_zone_touches === 1 ? '' : 's'} were modified`);
+    }
+    // ── Bundle invalidation section ─────────────────────────────────
+    if (s.bundle_invalidation && s.bundle_invalidation.addressed_files.length > 0) {
+        const inv = s.bundle_invalidation;
+        const stalenessPct = Math.round(inv.staleness_ratio * 100);
+        lines.push(`   Bundle freshness: ${inv.addressed_files.length} of ${inv.addressed_files.length + inv.fresh_files.length} files committed (${stalenessPct}% addressed)`);
+        if (inv.staleness_ratio >= 0.75) {
+            lines.push(`   Tip: Bundle is mostly stale — refresh with "codeledger activate --task ${prefillTask ? `"${s.task}"` : '...'}" for updated context.`);
+        }
+    }
+    // ── Checkpoint count section ────────────────────────────────────
+    if (s.checkpoint_count && s.checkpoint_count > 0) {
+        lines.push(`   Checkpoints: ${s.checkpoint_count} saved`);
+    }
+    // ── Intent drift section ───────────────────────────────────────
+    if (intentDrift && intentDrift.drift.drift_level !== 'NONE') {
+        const d = intentDrift.drift;
+        lines.push(`   Intent drift: ${d.drift_level} (${d.drift_score.toFixed(3)})`);
+        if (d.drift_level === 'MAJOR' || d.drift_level === 'CRITICAL') {
+            const topReasons = d.reasons.filter((r) => r.distance > 0).slice(0, 3);
+            for (const r of topReasons) {
+                lines.push(`     - ${r.field}: ${r.distance.toFixed(3)}`);
+            }
+        }
+    }
+    // ── Review coverage section (Sentinel) ─────────────────────────
+    if (s.review_coverage) {
+        const rc = s.review_coverage;
+        const pct = (rc.file_coverage * 100).toFixed(1);
+        const depthPct = (rc.depth_weighted_coverage * 100).toFixed(1);
+        const thresholdTag = rc.file_coverage >= 0.90 ? 'PASS' : 'BELOW 90%';
+        lines.push(`   Review Coverage: ${rc.files_read.length}/${rc.required_files.length} files read (${pct}%)    ${thresholdTag}`);
+        lines.push(`   Depth Coverage: ${depthPct}%`);
+        if (rc.post_hoc_reads.length > 0) {
+            lines.push(`   Post-hoc reads: ${rc.post_hoc_reads.length} file${rc.post_hoc_reads.length === 1 ? '' : 's'}`);
+        }
+    }
     lines.push(`   [${s.bundle_id}]`);
     lines.push('-'.repeat(61));
     lines.push('');
@@ -208,80 +338,533 @@ function fmtTokens(n) {
         return `${(n / 1000).toFixed(1)}k`;
     return `${n}`;
 }
+// ── Debt Injection Detection ────────────────────────────────────────────────
+function analyzeDebt(cwd, sessionId) {
+    const activateRefPath = sessionActivateRef(cwd, sessionId);
+    const sessionRefPath = sessionStartRef(cwd, sessionId);
+    const refPath = existsSync(activateRefPath) ? activateRefPath : sessionRefPath;
+    if (!existsSync(refPath))
+        return null;
+    const startRef = readFileSync(refPath, 'utf-8').trim();
+    if (!startRef)
+        return null;
+    try {
+        const diff = execSync(`git diff ${startRef}..HEAD`, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 10000,
+            maxBuffer: 10 * 1024 * 1024,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (!diff.trim())
+            return null;
+        // Dynamic import to avoid bundling selector into CLI at compile time
+        const debtFns = loadDebtDetection();
+        if (!debtFns.scanDebtPatterns || !debtFns.computeDebtScore)
+            return null;
+        const warnings = debtFns.scanDebtPatterns(diff);
+        const addedLines = diff.split('\n').filter((l) => l.startsWith('+') && !l.startsWith('+++')).length;
+        const debtScore = debtFns.computeDebtScore(warnings, addedLines);
+        return {
+            warnings,
+            total_suppressions: warnings.length,
+            debt_score: debtScore,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function loadDebtDetection() {
+    try {
+        // Inline implementation to avoid cross-package import complexity
+        const DEBT_PATTERNS = [
+            { pattern: /@Suppress\b/, message: '@Suppress annotation suppresses warnings' },
+            { pattern: /@SuppressWarnings\b/, message: '@SuppressWarnings hides compiler warnings' },
+            { pattern: /eslint-disable(?!-next-line)/, message: 'eslint-disable disables linting for entire block' },
+            { pattern: /eslint-disable-next-line/, message: 'eslint-disable-next-line suppresses linting' },
+            { pattern: /@ts-ignore\b/, message: '@ts-ignore suppresses TypeScript errors' },
+            { pattern: /@ts-expect-error\b/, message: '@ts-expect-error suppresses a TypeScript error' },
+            { pattern: /:\s*any\b/, message: 'Explicit `any` type bypasses type safety' },
+            { pattern: /as\s+any\b/, message: '`as any` assertion bypasses type safety' },
+            { pattern: /\/\/\s*noinspection\b/, message: 'noinspection comment suppresses IDE warnings' },
+            { pattern: /NOSONAR\b/, message: 'NOSONAR suppresses static analysis' },
+            { pattern: /--no-verify\b/, message: '--no-verify skips pre-commit hooks' },
+        ];
+        const scanDebtPatterns = (diffContent) => {
+            const warnings = [];
+            const lines = diffContent.split('\n');
+            let currentFile = '';
+            let lineNumber = 0;
+            for (const line of lines) {
+                const fileMatch = /^\+\+\+ b\/(.+)$/.exec(line);
+                if (fileMatch) {
+                    currentFile = fileMatch[1];
+                    if (currentFile.startsWith('.codeledger/') || currentFile.startsWith('.claude/')) {
+                        currentFile = '';
+                    }
+                    lineNumber = 0;
+                    continue;
+                }
+                const hunkMatch = /^@@ -\d+(?:,\d+)? \+(\d+)/.exec(line);
+                if (hunkMatch) {
+                    lineNumber = parseInt(hunkMatch[1], 10);
+                    continue;
+                }
+                if (!currentFile) {
+                    continue;
+                }
+                if (line.startsWith('+') && !line.startsWith('+++')) {
+                    const content = line.slice(1);
+                    for (const { pattern, message } of DEBT_PATTERNS) {
+                        if (pattern.test(content)) {
+                            warnings.push({ file: currentFile, line: lineNumber, pattern: pattern.source, message });
+                        }
+                    }
+                    lineNumber++;
+                }
+                else if (!line.startsWith('-')) {
+                    lineNumber++;
+                }
+            }
+            return warnings;
+        };
+        const computeDebtScore = (warnings, lineCount) => {
+            if (lineCount === 0 || warnings.length === 0)
+                return 0;
+            const ratio = warnings.length / (lineCount / 10);
+            return Math.min(1.0, Math.round(ratio * 100) / 100);
+        };
+        return { scanDebtPatterns, computeDebtScore };
+    }
+    catch {
+        return { scanDebtPatterns: null, computeDebtScore: null };
+    }
+}
+// ── Commit Hygiene Analysis ─────────────────────────────────────────────────
+function analyzeCommitHygiene(cwd, sessionId, bundleFiles) {
+    const activateRefPath = sessionActivateRef(cwd, sessionId);
+    const sessionRefPath = sessionStartRef(cwd, sessionId);
+    const refPath = existsSync(activateRefPath) ? activateRefPath : sessionRefPath;
+    if (!existsSync(refPath))
+        return null;
+    const startRef = readFileSync(refPath, 'utf-8').trim();
+    if (!startRef)
+        return null;
+    try {
+        // Get commit log since start ref
+        const log = execSync(`git log --format="%H %s" ${startRef}..HEAD`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (!log)
+            return null;
+        const commits = log.split('\n').filter(Boolean);
+        let emptyCommits = 0;
+        let noVerifyCount = 0;
+        let forcePushCount = 0;
+        for (const commit of commits) {
+            const sha = commit.split(' ')[0];
+            // Check for empty commits (no file changes)
+            try {
+                const files = execSync(`git diff-tree --no-commit-id --name-only -r ${sha}`, {
+                    cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                if (!files)
+                    emptyCommits++;
+            }
+            catch {
+                // non-fatal
+            }
+            // Check commit message for --no-verify indicators
+            const message = commit.slice(sha.length + 1);
+            if (message.includes('--no-verify') || message.includes('[skip ci]')) {
+                noVerifyCount++;
+            }
+        }
+        // Detect out-of-scope files (changed files not in bundle)
+        const bundleSet = new Set(bundleFiles);
+        const changedFiles = new Set();
+        try {
+            const diff = execSync(`git diff --name-only ${startRef}..HEAD`, {
+                cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            if (diff) {
+                for (const f of diff.split('\n')) {
+                    if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                        changedFiles.add(f);
+                }
+            }
+        }
+        catch {
+            // non-fatal
+        }
+        const outOfScope = [...changedFiles].filter((f) => !bundleSet.has(f));
+        // Compute hygiene score: 1.0 = perfect, deductions for issues
+        let hygieneScore = 1.0;
+        if (commits.length > 0) {
+            hygieneScore -= (emptyCommits / commits.length) * 0.3;
+            hygieneScore -= (noVerifyCount / commits.length) * 0.3;
+        }
+        if (changedFiles.size > 0 && outOfScope.length > 0) {
+            hygieneScore -= Math.min(0.3, (outOfScope.length / changedFiles.size) * 0.3);
+        }
+        hygieneScore = Math.max(0, Math.round(hygieneScore * 100) / 100);
+        return {
+            total_commits: commits.length,
+            empty_commits: emptyCommits,
+            no_verify_count: noVerifyCount,
+            force_push_count: forcePushCount,
+            out_of_scope_files: outOfScope,
+            hygiene_score: hygieneScore,
+        };
+    }
+    catch {
+        return null;
+    }
+}
 /**
- * When the session involved multiple tasks (`.session-start-ref` differs from
- * `.activate-ref`), print a session-wide aggregate line so the developer sees
- * the full picture at session end.
+ * When the session involved multiple tasks, print a per-task breakdown
+ * showing recall/precision for each activate call, plus session-wide totals.
+ *
+ * Reads `.task-history.jsonl` to reconstruct what happened in each task.
  */
 function printSessionAggregate(cwd, sessionId, lastTaskSummary) {
-    const activateRefPath = sessionActivateRef(cwd, sessionId);
     const sessionRefPath = sessionStartRef(cwd, sessionId);
-    // Both refs must exist and differ to indicate multiple tasks were run
-    if (!existsSync(sessionRefPath) || !existsSync(activateRefPath))
+    if (!existsSync(sessionRefPath))
         return;
     const sessionRef = readFileSync(sessionRefPath, 'utf-8').trim();
-    const activateRef = readFileSync(activateRefPath, 'utf-8').trim();
-    if (!sessionRef || !activateRef || sessionRef === activateRef)
+    if (!sessionRef)
         return;
-    // Gather all files changed since session start
-    const allChanged = new Set();
+    // -- Load task history (JSONL) -------------------------------------------
+    const historyPath = sessionTaskHistoryPath(cwd, sessionId);
+    const activations = loadTaskHistory(historyPath);
+    // -- Count commits since session start -----------------------------------
+    let commitCount = 0;
     try {
-        const committed = execSync(`git diff --name-only ${sessionRef}..HEAD`, {
+        const count = execSync(`git rev-list --count ${sessionRef}..HEAD`, {
             cwd,
             encoding: 'utf-8',
             timeout: 5000,
             stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
-        if (committed) {
-            for (const f of committed.split('\n'))
-                allChanged.add(f);
-        }
+        commitCount = parseInt(count, 10) || 0;
     }
     catch {
-        return;
+        // non-fatal
     }
-    // Include uncommitted work
+    // -- Gather all files changed across the entire session -------------------
+    const allChanged = new Set();
     try {
-        const uncommitted = execSync('git diff --name-only HEAD', {
+        const committed = execSync(`git diff --name-only ${sessionRef}..HEAD`, {
             cwd,
             encoding: 'utf-8',
             timeout: 5000,
             stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
-        if (uncommitted) {
-            for (const f of uncommitted.split('\n'))
-                allChanged.add(f);
+        if (committed) {
+            for (const f of committed.split('\n')) {
+                if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                    allChanged.add(f);
+            }
         }
     }
     catch {
         // non-fatal
     }
-    // Only show aggregate if it covers more files than the last task alone
-    if (allChanged.size <= lastTaskSummary.files_changed.length)
-        return;
-    // Count commits since session start
-    let commitCount = 0;
     try {
-        const count = execSync(`git rev-list --count ${sessionRef}..HEAD`, {
+        const uncommitted = execSync('git diff --name-only HEAD', {
             cwd,
             encoding: 'utf-8',
             timeout: 5000,
             stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
-        commitCount = parseInt(count, 10) || 0;
+        if (uncommitted) {
+            for (const f of uncommitted.split('\n')) {
+                if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                    allChanged.add(f);
+            }
+        }
     }
     catch {
         // non-fatal
     }
+    // -- Compute per-task metrics -------------------------------------------
+    const taskMetrics = computePerTaskMetrics(cwd, activations);
     const lines = [];
     lines.push('');
-    lines.push('-- Session Totals (all tasks) --------------------------------');
-    lines.push(`   ${allChanged.size} files changed across ${commitCount} commit${commitCount === 1 ? '' : 's'} this session`);
+    lines.push('-- Session Summary (all tasks) --------------------------------');
     if (sessionId) {
         lines.push(`   Session: ${sessionId}`);
     }
+    // Per-task breakdown (only if there's history and at least one task had changes)
+    if (taskMetrics.length > 0) {
+        lines.push('');
+        for (let i = 0; i < taskMetrics.length; i++) {
+            const m = taskMetrics[i];
+            const recallPct = Math.round(m.recall * 100);
+            const precisionPct = Math.round(m.precision * 100);
+            const icon = m.verdict === 'HIT' ? '\u2705' : m.verdict === 'PARTIAL' ? '\u{1F7E1}' : '\u274C';
+            lines.push(`   Task ${i + 1}: "${truncate(m.task, 55)}"`);
+            if (m.files_changed.length === 0) {
+                lines.push(`     No files changed — skipped`);
+            }
+            else {
+                lines.push(`     Recall: ${m.files_overlapping.length}/${m.files_changed.length} (${recallPct}%)    Precision: ${m.files_overlapping.length}/${m.bundle_file_count} (${precisionPct}%)    ${icon} ${m.verdict}`);
+            }
+        }
+    }
+    else if (allChanged.size > lastTaskSummary.files_changed.length) {
+        // Fallback: no task history but session had multiple tasks worth of changes
+        lines.push(`   ${allChanged.size} files changed across ${commitCount} commit${commitCount === 1 ? '' : 's'}`);
+    }
+    // Session totals
+    if (taskMetrics.length > 1 || (taskMetrics.length === 0 && allChanged.size > 0)) {
+        const totalChanged = taskMetrics.length > 0
+            ? new Set(taskMetrics.flatMap((m) => m.files_changed)).size
+            : allChanged.size;
+        const totalOverlap = taskMetrics.length > 0
+            ? new Set(taskMetrics.flatMap((m) => m.files_overlapping)).size
+            : lastTaskSummary.files_overlapping.length;
+        const sessionRecall = totalChanged > 0 ? totalOverlap / totalChanged : 0;
+        const sessionRecallPct = Math.round(sessionRecall * 100);
+        const hits = taskMetrics.filter((m) => m.verdict === 'HIT').length;
+        const partials = taskMetrics.filter((m) => m.verdict === 'PARTIAL').length;
+        const misses = taskMetrics.filter((m) => m.verdict === 'MISS').length;
+        lines.push('');
+        lines.push(`   Session: ${totalChanged} files changed, ${commitCount} commit${commitCount === 1 ? '' : 's'}, ${sessionRecallPct}% overall recall`);
+        if (taskMetrics.length > 0) {
+            lines.push(`   Tasks: ${hits} hit, ${partials} partial, ${misses} miss (${taskMetrics.length} total)`);
+        }
+    }
     lines.push('-'.repeat(61));
     lines.push('');
     console.log(lines.join('\n'));
 }
+// ── Scope Drift Detection ───────────────────────────────────────────────────
+function getScopeDriftFiles(changedFiles, scopeContract) {
+    const scopeSet = new Set([...scopeContract.bundle_files, ...scopeContract.neighbor_files]);
+    return changedFiles.filter((f) => !scopeSet.has(f));
+}
+// ── Conflict Zone Touches ───────────────────────────────────────────────────
+function countConflictTouches(changedFiles, conflictZones) {
+    const conflictFiles = new Set(conflictZones.map((z) => z.file));
+    return changedFiles.filter((f) => conflictFiles.has(f)).length;
+}
+// ── Bundle Invalidation (Commit-Aware) ──────────────────────────────────────
+function analyzeBundleInvalidation(cwd, sessionId, bundleFiles) {
+    if (bundleFiles.length === 0)
+        return null;
+    // Get the activate ref to know when the bundle was generated
+    const activateRefPath = sessionActivateRef(cwd, sessionId);
+    const sessionRefPath = sessionStartRef(cwd, sessionId);
+    const refPath = existsSync(activateRefPath) ? activateRefPath : sessionRefPath;
+    if (!existsSync(refPath))
+        return null;
+    const startRef = readFileSync(refPath, 'utf-8').trim();
+    if (!startRef)
+        return null;
+    try {
+        // Get commit log with file names since the bundle was generated
+        const log = execSync(`git log --format="%H %aI" --name-only ${startRef}..HEAD`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (!log)
+            return null;
+        // Parse which files were committed
+        const committedFiles = new Map();
+        const lines = log.split('\n');
+        let currentSha = '';
+        let currentDate = '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const commitMatch = /^([0-9a-f]{40})\s+(.+)$/.exec(trimmed);
+            if (commitMatch) {
+                currentSha = commitMatch[1];
+                currentDate = commitMatch[2];
+                continue;
+            }
+            // File path — only record the first (most recent) commit
+            if (currentSha && !committedFiles.has(trimmed)) {
+                committedFiles.set(trimmed, { commit_sha: currentSha, committed_at: currentDate });
+            }
+        }
+        if (committedFiles.size === 0)
+            return null;
+        // Cross-reference with bundle files
+        const addressed = [];
+        const fresh = [];
+        for (const filePath of bundleFiles) {
+            const commitInfo = committedFiles.get(filePath);
+            if (commitInfo) {
+                addressed.push({
+                    path: filePath,
+                    addressed_at: commitInfo.committed_at,
+                    commit_sha: commitInfo.commit_sha,
+                });
+            }
+            else {
+                fresh.push(filePath);
+            }
+        }
+        if (addressed.length === 0)
+            return null;
+        return {
+            addressed_files: addressed,
+            fresh_files: fresh,
+            staleness_ratio: Math.round((addressed.length / bundleFiles.length) * 100) / 100,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── Per-Task History & Metrics ──────────────────────────────────────────────
+/**
+ * Load the JSONL task history file. Returns an empty array if missing or
+ * malformed (best-effort — task history is non-critical).
+ */
+function loadTaskHistory(historyPath) {
+    if (!existsSync(historyPath))
+        return [];
+    try {
+        const content = readFileSync(historyPath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * For each activation in the task history, compute the files changed between
+ * that activation's ref and the next activation's ref (or HEAD for the last one).
+ * Then compute recall/precision against that task's bundle.
+ */
+function computePerTaskMetrics(cwd, activations) {
+    if (activations.length === 0)
+        return [];
+    const metrics = [];
+    for (let i = 0; i < activations.length; i++) {
+        const activation = activations[i];
+        const nextActivation = activations[i + 1];
+        // Determine the end ref: next activation's ref or HEAD
+        const startRef = activation.activate_ref;
+        let endRef = 'HEAD';
+        if (nextActivation) {
+            endRef = nextActivation.activate_ref;
+        }
+        // Get files changed in this task's window
+        const filesChanged = getFilesChangedBetween(cwd, startRef, endRef);
+        // Also include uncommitted changes if this is the last task
+        if (!nextActivation) {
+            try {
+                const uncommitted = execSync('git diff --name-only HEAD', {
+                    cwd,
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                if (uncommitted) {
+                    for (const f of uncommitted.split('\n')) {
+                        if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                            filesChanged.add(f);
+                    }
+                }
+            }
+            catch {
+                // non-fatal
+            }
+            try {
+                const untracked = execSync('git ls-files --others --exclude-standard', {
+                    cwd,
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                if (untracked) {
+                    for (const f of untracked.split('\n')) {
+                        if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                            filesChanged.add(f);
+                    }
+                }
+            }
+            catch {
+                // non-fatal
+            }
+        }
+        const changed = [...filesChanged];
+        const bundleSet = new Set(activation.bundle_files);
+        const overlapping = changed.filter((f) => bundleSet.has(f));
+        const recall = changed.length > 0 ? overlapping.length / changed.length : 0;
+        const precision = activation.bundle_files.length > 0
+            ? overlapping.length / activation.bundle_files.length
+            : 0;
+        // Verdict based on F1 thresholds
+        const f1 = (precision + recall) > 0
+            ? 2 * (precision * recall) / (precision + recall)
+            : 0;
+        let verdict;
+        if (changed.length === 0) {
+            verdict = 'MISS'; // No files changed — can't evaluate
+        }
+        else if (f1 >= 0.3) {
+            verdict = 'HIT';
+        }
+        else if (recall > 0) {
+            verdict = 'PARTIAL';
+        }
+        else {
+            verdict = 'MISS';
+        }
+        metrics.push({
+            task: activation.task,
+            bundle_id: activation.bundle_id,
+            bundle_file_count: activation.bundle_files.length,
+            bundle_tokens: activation.bundle_tokens,
+            files_changed: changed,
+            files_overlapping: overlapping,
+            recall,
+            precision,
+            verdict,
+        });
+    }
+    return metrics;
+}
+/**
+ * Get files changed between two git refs. Returns a mutable set.
+ */
+function getFilesChangedBetween(cwd, startRef, endRef) {
+    const files = new Set();
+    try {
+        const diff = execSync(`git diff --name-only ${startRef}..${endRef}`, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (diff) {
+            for (const f of diff.split('\n')) {
+                if (!f.startsWith('.codeledger/') && !f.startsWith('.claude/'))
+                    files.add(f);
+            }
+        }
+    }
+    catch {
+        // non-fatal: ref may no longer be valid
+    }
+    return files;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 3) + '...';
+}
 //# sourceMappingURL=session-summary.js.map