@codeledger/cli 0.1.1

package/dist/commands/session-init.js

@@ -0,0 +1,46 @@
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { generateSessionId } from '../session-id.js';
+import { sessionDir } from '../session-paths.js';
+import { registerSession } from '../session-registry.js';
+/**
+ * `codeledger session-init`
+ *
+ * Lightweight command to establish a new session identity.
+ * Called from the SessionStart hook to generate a session ID, create
+ * the session directory, and register the session. Prints the session
+ * ID to stdout for capture in the hook script.
+ */
+export async function runSessionInit(cwd, flags) {
+    const quiet = flags['quiet'] === 'true';
+    const sessionId = generateSessionId();
+    // Create the session directory
+    const dir = sessionDir(cwd, sessionId);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Register the session
+    const now = new Date().toISOString();
+    registerSession(cwd, {
+        session_id: sessionId,
+        task: null,
+        started_at: now,
+        last_active_at: now,
+        pid: process.ppid ?? process.pid,
+        bundle_files: [],
+        status: 'active',
+    });
+    // Write PID-tagged marker so downstream hooks can discover this session
+    const ppid = process.ppid ?? process.pid;
+    const markerPath = join(cwd, '.codeledger', `.current-session-pid-${ppid}`);
+    const markerDir = join(cwd, '.codeledger');
+    if (!existsSync(markerDir))
+        mkdirSync(markerDir, { recursive: true });
+    writeFileSync(markerPath, sessionId + '\n');
+    // Print session ID to stdout (captured by hook script)
+    console.log(sessionId);
+    if (!quiet) {
+        console.error(`CodeLedger: session ${sessionId} initialized`);
+    }
+}
+//# sourceMappingURL=session-init.js.map

package/dist/commands/session-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-init.js","sourceRoot":"","sources":["../../src/commands/session-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,KAA6B;IAE7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IACxC,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IAEtC,+BAA+B;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,uBAAuB;IACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,eAAe,CAAC,GAAG,EAAE;QACnB,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,GAAG;QACf,cAAc,EAAE,GAAG;QACnB,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG;QAChC,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;IAEH,wEAAwE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,wBAAwB,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,aAAa,CAAC,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;IAE5C,uDAAuD;IACvD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,cAAc,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/commands/session-progress.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `codeledger session-progress [--session <id>]`
+ *
+ * Writes a session-progress.md — a ground-truth snapshot of implementation
+ * state derived from git. Designed to be called from the PreCompact hook
+ * so the progress file survives context compaction.
+ *
+ * Multi-session: when a session ID is provided, reads/writes from the
+ * session-specific directory instead of the shared .codeledger/ root.
+ */
+export declare function runSessionProgress(cwd: string, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=session-progress.d.ts.map

package/dist/commands/session-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-progress.d.ts","sourceRoot":"","sources":["../../src/commands/session-progress.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/commands/session-progress.js

@@ -0,0 +1,259 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { resolveSessionId } from '../session-id.js';
+import { sessionStartRef, sessionProgressPath } from '../session-paths.js';
+/**
+ * `codeledger session-progress [--session <id>]`
+ *
+ * Writes a session-progress.md — a ground-truth snapshot of implementation
+ * state derived from git. Designed to be called from the PreCompact hook
+ * so the progress file survives context compaction.
+ *
+ * Multi-session: when a session ID is provided, reads/writes from the
+ * session-specific directory instead of the shared .codeledger/ root.
+ */
+export async function runSessionProgress(cwd, flags) {
+    const configPath = join(cwd, '.codeledger', 'config.json');
+    if (!existsSync(configPath))
+        return;
+    const quiet = flags['quiet'] === 'true';
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    const sessionId = resolveSessionId({ session: flags['session'] });
+    const bundle = loadLatestBundle(cwd, config);
+    const startRef = loadSessionStartRef(cwd, sessionId);
+    const commits = getSessionCommits(cwd, startRef);
+    const uncommitted = getUncommittedChanges(cwd);
+    const allChanged = getAllChangedFiles(cwd, startRef);
+    // Cross-reference bundle files against actual changes
+    const bundleFiles = bundle ? bundle.files : [];
+    const changedSet = new Set(allChanged);
+    const untouched = bundleFiles.filter((f) => !changedSet.has(f.path));
+    const md = renderProgressMarkdown({
+        task: bundle?.task ?? null,
+        bundleId: bundle?.bundle_id ?? null,
+        sessionId,
+        commits,
+        uncommitted,
+        allChanged,
+        untouched,
+    });
+    const progressPath = sessionProgressPath(cwd, sessionId);
+    const dir = dirname(progressPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(progressPath, md);
+    if (!quiet) {
+        const displayPath = sessionId
+            ? `.codeledger/sessions/${sessionId}/session-progress.md`
+            : '.codeledger/session-progress.md';
+        console.log(`CodeLedger: session progress written to ${displayPath}`);
+    }
+}
+// ── Git introspection ──────────────────────────────────────────────────────
+function loadSessionStartRef(cwd, sessionId) {
+    const refPath = sessionStartRef(cwd, sessionId);
+    if (!existsSync(refPath))
+        return null;
+    const ref = readFileSync(refPath, 'utf-8').trim();
+    return ref || null;
+}
+function getSessionCommits(cwd, startRef) {
+    if (!startRef)
+        return [];
+    try {
+        const log = execSync(`git log --format="%H %s" ${startRef}..HEAD`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (!log)
+            return [];
+        return log.split('\n').map((line) => {
+            const spaceIdx = line.indexOf(' ');
+            const sha = line.slice(0, spaceIdx);
+            const message = line.slice(spaceIdx + 1);
+            const files = getCommitFiles(cwd, sha);
+            return { sha: sha.slice(0, 7), message, files };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function getCommitFiles(cwd, sha) {
+    try {
+        const output = execSync(`git diff-tree --no-commit-id --name-only -r ${sha}`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        return output ? output.split('\n') : [];
+    }
+    catch {
+        return [];
+    }
+}
+function getUncommittedChanges(cwd) {
+    const changes = [];
+    try {
+        // Staged + unstaged modifications
+        const diff = execSync('git diff --name-status HEAD', {
+            cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (diff) {
+            for (const line of diff.split('\n')) {
+                const [status, ...rest] = line.split('\t');
+                if (status && rest.length > 0) {
+                    changes.push({ status: status.charAt(0), path: rest.join('\t') });
+                }
+            }
+        }
+        // Untracked files
+        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')) {
+                changes.push({ status: '?', path: f });
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return changes;
+}
+function getAllChangedFiles(cwd, startRef) {
+    const files = new Set();
+    try {
+        // Uncommitted
+        const diff = execSync('git diff --name-only HEAD', {
+            cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (diff)
+            for (const f of diff.split('\n'))
+                files.add(f);
+        // Untracked
+        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'))
+                files.add(f);
+        // Committed since session start
+        if (startRef) {
+            try {
+                const committed = execSync(`git diff --name-only ${startRef}..HEAD`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                if (committed)
+                    for (const f of committed.split('\n'))
+                        files.add(f);
+            }
+            catch {
+                // startRef may be invalid
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return [...files];
+}
+// ── Bundle loading (mirrors session-summary.ts) ────────────────────────────
+function loadLatestBundle(cwd, config) {
+    const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
+    if (!existsSync(bundleDir))
+        return null;
+    const files = readdirSync(bundleDir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => ({
+        name: f,
+        mtime: statSync(join(bundleDir, f)).mtimeMs,
+    }))
+        .sort((a, b) => b.mtime - a.mtime);
+    if (files.length === 0)
+        return null;
+    const latestPath = join(bundleDir, files[0].name);
+    return JSON.parse(readFileSync(latestPath, 'utf-8'));
+}
+// ── Markdown rendering ─────────────────────────────────────────────────────
+function renderProgressMarkdown(data) {
+    const lines = [];
+    lines.push('# CodeLedger Session Progress');
+    lines.push('');
+    lines.push('<!-- Auto-generated by codeledger session-progress. -->');
+    lines.push('<!-- Read this after context compaction to understand what has been accomplished. -->');
+    lines.push('');
+    lines.push(`Updated: ${new Date().toISOString()}`);
+    if (data.sessionId) {
+        lines.push(`Session: ${data.sessionId}`);
+    }
+    lines.push('');
+    // ── Task ──
+    if (data.task) {
+        lines.push('## Task');
+        lines.push('');
+        lines.push(data.task);
+        lines.push('');
+    }
+    // ── Commits ──
+    if (data.commits.length > 0) {
+        lines.push('## Commits This Session');
+        lines.push('');
+        for (const c of data.commits) {
+            lines.push(`- \`${c.sha}\` ${c.message}`);
+            for (const f of c.files) {
+                lines.push(`  - ${f}`);
+            }
+        }
+        lines.push('');
+    }
+    else {
+        lines.push('## Commits This Session');
+        lines.push('');
+        lines.push('No commits yet.');
+        lines.push('');
+    }
+    // ── Uncommitted changes ──
+    if (data.uncommitted.length > 0) {
+        lines.push('## Uncommitted Changes');
+        lines.push('');
+        for (const c of data.uncommitted) {
+            const label = statusLabel(c.status);
+            lines.push(`- ${c.path} (${label})`);
+        }
+        lines.push('');
+    }
+    // ── Remaining bundle files ──
+    if (data.untouched.length > 0) {
+        lines.push('## Bundle Files Not Yet Touched');
+        lines.push('');
+        lines.push('These files were selected as relevant but have not been modified:');
+        lines.push('');
+        for (const f of data.untouched.slice(0, 15)) {
+            const reasons = f.reasons.join(', ');
+            lines.push(`- ${f.path} (score: ${f.score.toFixed(2)}, ${reasons})`);
+        }
+        if (data.untouched.length > 15) {
+            lines.push(`- ... and ${data.untouched.length - 15} more`);
+        }
+        lines.push('');
+    }
+    // ── Summary line ──
+    lines.push('## At a Glance');
+    lines.push('');
+    lines.push(`- ${data.commits.length} commit(s)`);
+    lines.push(`- ${data.allChanged.length} file(s) changed`);
+    lines.push(`- ${data.uncommitted.length} uncommitted change(s)`);
+    lines.push(`- ${data.untouched.length} bundle file(s) not yet touched`);
+    if (data.bundleId) {
+        lines.push(`- Bundle: ${data.bundleId}`);
+    }
+    if (data.sessionId) {
+        lines.push(`- Session: ${data.sessionId}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function statusLabel(status) {
+    switch (status) {
+        case 'M': return 'modified';
+        case 'A': return 'added';
+        case 'D': return 'deleted';
+        case '?': return 'new file';
+        default: return status;
+    }
+}
+//# sourceMappingURL=session-progress.js.map

package/dist/commands/session-progress.js.map

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

package/dist/commands/session-summary.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `codeledger session-summary [--session <id>]`
+ *
+ * Lightweight session-end value report. Compares the active context bundle
+ * against files actually changed during the session, producing a concise
+ * recap that reinforces the value of deterministic context selection.
+ *
+ * Designed to be called from the Claude Code Stop hook.
+ *
+ * Multi-session: when a session ID is provided, reads refs from the
+ * session-specific directory instead of the shared .codeledger/ root.
+ */
+export declare function runSessionSummary(cwd: string, flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=session-summary.d.ts.map

package/dist/commands/session-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.d.ts","sourceRoot":"","sources":["../../src/commands/session-summary.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/commands/session-summary.js

@@ -0,0 +1,287 @@
+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';
+/**
+ * `codeledger session-summary [--session <id>]`
+ *
+ * Lightweight session-end value report. Compares the active context bundle
+ * against files actually changed during the session, producing a concise
+ * recap that reinforces the value of deterministic context selection.
+ *
+ * Designed to be called from the Claude Code Stop hook.
+ *
+ * Multi-session: when a session ID is provided, reads refs from the
+ * session-specific directory instead of the shared .codeledger/ root.
+ */
+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)
+        return;
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        // Malformed config — exit silently (don't pollute agent output from hook)
+        return;
+    }
+    const sessionId = resolveSessionId({ session: flags['session'] });
+    // ── Find the latest bundle artifact ─────────────────────────────────────
+    const bundle = loadLatestBundle(cwd, config);
+    if (!bundle) {
+        // No bundle was generated this session — nothing to summarize
+        return;
+    }
+    // ── Gather actual file changes from git ─────────────────────────────────
+    const filesChanged = getSessionChangedFiles(cwd, sessionId);
+    if (filesChanged.length === 0) {
+        console.log('CodeLedger: no files changed this session — nothing to recap.');
+        return;
+    }
+    // ── Compute overlap metrics ─────────────────────────────────────────────
+    const bundleFiles = bundle.files.map((f) => f.path);
+    const overlap = filesChanged.filter((f) => bundleFiles.includes(f));
+    const recall = filesChanged.length > 0
+        ? overlap.length / filesChanged.length
+        : 0;
+    const precision = bundleFiles.length > 0
+        ? overlap.length / bundleFiles.length
+        : 0;
+    // ── Estimate repo-wide token count for context reduction ────────────────
+    const repoTokens = estimateRepoTokens(cwd, config);
+    const reductionPct = repoTokens > 0
+        ? ((repoTokens - bundle.total_tokens) / repoTokens) * 100
+        : 0;
+    const summary = {
+        bundle_id: bundle.bundle_id,
+        task: bundle.task,
+        bundle_files: bundleFiles,
+        files_changed: filesChanged,
+        files_overlapping: overlap,
+        recall,
+        precision,
+        bundle_tokens: bundle.total_tokens,
+        repo_total_tokens: repoTokens,
+        context_reduction_pct: reductionPct,
+        generated_at: new Date().toISOString(),
+        session_id: sessionId ?? undefined,
+    };
+    // ── Print concise recap ─────────────────────────────────────────────────
+    printRecap(summary);
+    // ── Session-wide aggregate (only on --final, i.e. Stop hook) ───────────
+    if (flags['final'] === 'true') {
+        printSessionAggregate(cwd, sessionId, summary);
+    }
+}
+function loadLatestBundle(cwd, config) {
+    const bundleDir = join(cwd, config.workspace.artifacts_dir, 'bundles');
+    if (!existsSync(bundleDir))
+        return null;
+    const files = readdirSync(bundleDir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => ({
+        name: f,
+        mtime: statSync(join(bundleDir, f)).mtimeMs,
+    }))
+        .sort((a, b) => b.mtime - a.mtime);
+    if (files.length === 0)
+        return null;
+    const latestPath = join(bundleDir, files[0].name);
+    try {
+        return JSON.parse(readFileSync(latestPath, 'utf-8'));
+    }
+    catch {
+        // Corrupted or deleted bundle file — treat as missing
+        return null;
+    }
+}
+function getSessionChangedFiles(cwd, sessionId) {
+    try {
+        const files = new Set();
+        // 1. Uncommitted changes (staged + unstaged)
+        const diffOutput = execSync('git diff --name-only HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (diffOutput) {
+            for (const f of diffOutput.split('\n'))
+                files.add(f);
+        }
+        // 2. Untracked files
+        const untrackedOutput = execSync('git ls-files --others --exclude-standard', {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (untrackedOutput) {
+            for (const f of untrackedOutput.split('\n'))
+                files.add(f);
+        }
+        // 3. Committed changes: prefer .activate-ref (scoped to current task)
+        //    over .session-start-ref (full session) for accurate per-task metrics
+        //    Use session-specific paths when a session ID is available
+        const activateRefPath = sessionActivateRef(cwd, sessionId);
+        const sessionRefPath = sessionStartRef(cwd, sessionId);
+        const refPath = existsSync(activateRefPath) ? activateRefPath : sessionRefPath;
+        if (existsSync(refPath)) {
+            const startRef = readFileSync(refPath, 'utf-8').trim();
+            if (startRef) {
+                try {
+                    const committedDiff = execSync(`git diff --name-only ${startRef}..HEAD`, { cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                    if (committedDiff) {
+                        for (const f of committedDiff.split('\n'))
+                            files.add(f);
+                    }
+                }
+                catch {
+                    // startRef may no longer be valid (rebased away, etc.) — non-fatal
+                }
+            }
+        }
+        return [...files];
+    }
+    catch {
+        return [];
+    }
+}
+function estimateRepoTokens(cwd, config) {
+    const indexPath = join(cwd, config.workspace.cache_dir, 'repo-index.json');
+    if (!existsSync(indexPath))
+        return 0;
+    try {
+        const repoIndex = JSON.parse(readFileSync(indexPath, 'utf-8'));
+        // Use same heuristic as selector stop-rule: 4 tokens per line
+        return repoIndex.files.reduce((sum, f) => sum + f.lines * 4, 0);
+    }
+    catch {
+        return 0;
+    }
+}
+function printRecap(s) {
+    const recallPct = Math.round(s.recall * 100);
+    const precisionPct = Math.round(s.precision * 100);
+    const reductionPct = Math.round(s.context_reduction_pct);
+    // F1 score: harmonic mean of precision and recall — single usefulness metric
+    const f1 = (s.precision + s.recall) > 0
+        ? 2 * (s.precision * s.recall) / (s.precision + s.recall)
+        : 0;
+    const lines = [];
+    lines.push('');
+    lines.push('-- CodeLedger Session Recap ----------------------------------');
+    if (s.session_id) {
+        lines.push(`   Session: ${s.session_id}`);
+    }
+    if (f1 < 0.3) {
+        // Bundle was not useful — lead with the miss, suppress reduction stat
+        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.`);
+    }
+    else if (s.recall < 0.5) {
+        // Bundle was partially useful — show all stats but highlight room to improve
+        lines.push(`   Bundle 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(`   Context: ~${fmtTokens(s.bundle_tokens)} tokens vs ~${fmtTokens(s.repo_total_tokens)} full repo (${reductionPct}% reduction)`);
+        lines.push(`   Tip: A more specific task description may improve recall.`);
+    }
+    else {
+        // Bundle worked well — show the full value story
+        lines.push(`   Bundle 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(`   Context: ~${fmtTokens(s.bundle_tokens)} tokens vs ~${fmtTokens(s.repo_total_tokens)} full repo (${reductionPct}% reduction)`);
+    }
+    lines.push(`   [${s.bundle_id}]`);
+    lines.push('-'.repeat(61));
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+function fmtTokens(n) {
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return `${n}`;
+}
+/**
+ * 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.
+ */
+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))
+        return;
+    const sessionRef = readFileSync(sessionRefPath, 'utf-8').trim();
+    const activateRef = readFileSync(activateRefPath, 'utf-8').trim();
+    if (!sessionRef || !activateRef || sessionRef === activateRef)
+        return;
+    // Gather all files changed since session start
+    const allChanged = new Set();
+    try {
+        const committed = execSync(`git diff --name-only ${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);
+        }
+    }
+    catch {
+        return;
+    }
+    // Include uncommitted work
+    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'))
+                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`, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        commitCount = parseInt(count, 10) || 0;
+    }
+    catch {
+        // non-fatal
+    }
+    const lines = [];
+    lines.push('');
+    lines.push('-- Session Totals (all tasks) --------------------------------');
+    lines.push(`   ${allChanged.size} files changed across ${commitCount} commit${commitCount === 1 ? '' : 's'} this session`);
+    if (sessionId) {
+        lines.push(`   Session: ${sessionId}`);
+    }
+    lines.push('-'.repeat(61));
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=session-summary.js.map