cognitive-core 0.0.2 → 0.1.2

package/dist/session-bank/index.d.ts

@@ -0,0 +1,5 @@
+export { SessionBank } from './session-bank.js';
+export { EntireGitReader, type GitReaderOptions } from './git-reader.js';
+export { EntireTranscriptParser, type ParsedMetadata, } from './parser.js';
+export type { SessionRecord, SessionMetadata, TranscriptMessage, ContentBlock, TextBlock, ToolUseBlock, ToolResultBlock, SessionSummary, TokenUsage, Attribution, SessionSource, CheckpointRef, SessionQuery, SessionQueryResult, ProcessingLogEntry, SessionBankOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session-bank/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-bank/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/session-bank/index.js

@@ -0,0 +1,4 @@
+export { SessionBank } from './session-bank.js';
+export { EntireGitReader } from './git-reader.js';
+export { EntireTranscriptParser, } from './parser.js';
+//# sourceMappingURL=index.js.map

package/dist/session-bank/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session-bank/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,sBAAsB,GAEvB,MAAM,aAAa,CAAC"}

package/dist/session-bank/parser.d.ts

@@ -0,0 +1,39 @@
+import type { SessionRecord, SessionMetadata, TranscriptMessage, SessionSummary, TokenUsage, Attribution, CheckpointRef } from './types.js';
+export interface ParsedMetadata {
+    sessionId: string;
+    checkpointId: string;
+    metadata: SessionMetadata;
+    summary?: SessionSummary;
+    tokenUsage: TokenUsage;
+    attribution?: Attribution;
+}
+export declare class EntireTranscriptParser {
+    /**
+     * Parse a full session from its component files.
+     */
+    parseSession(metadataJson: string, transcriptJsonl: string, checkpointPath: string, sessionIndex: string): SessionRecord;
+    /**
+     * Parse per-session metadata.json (fast path — no transcript).
+     */
+    parseMetadata(metadataJson: string): ParsedMetadata;
+    /**
+     * Parse a JSONL transcript into structured messages.
+     * Tolerant of malformed lines — skips them silently.
+     */
+    parseTranscript(jsonlContent: string): TranscriptMessage[];
+    /**
+     * Parse chunked transcripts (full.jsonl.001, .002, etc.)
+     */
+    parseChunkedTranscript(chunks: string[]): TranscriptMessage[];
+    /**
+     * Parse the root checkpoint summary to discover session subdirectories.
+     */
+    parseCheckpointSummary(metadataJson: string, checkpointPath: string): CheckpointRef;
+    private parseTranscriptLine;
+    private parseContentBlock;
+    private parseTokenUsage;
+    private parseSummary;
+    private parseAttribution;
+    private checkpointIdFromPath;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/session-bank/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/session-bank/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EAEjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAwFpB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,qBAAa,sBAAsB;IACjC;;OAEG;IACH,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,aAAa;IAoBhB;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc;IA6BnD;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAoB1D;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE;IAK7D;;OAEG;IACH,sBAAsB,CACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,aAAa;IAehB,OAAO,CAAC,mBAAmB;IAwD3B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,oBAAoB;CAQ7B"}

package/dist/session-bank/parser.js

@@ -0,0 +1,231 @@
+export class EntireTranscriptParser {
+    /**
+     * Parse a full session from its component files.
+     */
+    parseSession(metadataJson, transcriptJsonl, checkpointPath, sessionIndex) {
+        const parsed = this.parseMetadata(metadataJson);
+        const transcript = this.parseTranscript(transcriptJsonl);
+        return {
+            sessionId: parsed.sessionId,
+            checkpointId: parsed.checkpointId,
+            metadata: parsed.metadata,
+            transcript,
+            summary: parsed.summary,
+            tokenUsage: parsed.tokenUsage,
+            attribution: parsed.attribution,
+            source: {
+                branch: 'entire/checkpoints/v1',
+                checkpointPath,
+                sessionIndex,
+            },
+        };
+    }
+    /**
+     * Parse per-session metadata.json (fast path — no transcript).
+     */
+    parseMetadata(metadataJson) {
+        const raw = JSON.parse(metadataJson);
+        const tokenUsage = this.parseTokenUsage(raw.token_usage);
+        const summary = raw.summary ? this.parseSummary(raw.summary) : undefined;
+        const attribution = raw.initial_attribution
+            ? this.parseAttribution(raw.initial_attribution)
+            : undefined;
+        return {
+            sessionId: raw.session_id ?? '',
+            checkpointId: raw.checkpoint_id ?? '',
+            metadata: {
+                cliVersion: raw.cli_version ?? '',
+                strategy: raw.strategy === 'auto-commit' ? 'auto-commit' : 'manual-commit',
+                createdAt: raw.created_at ? new Date(raw.created_at) : new Date(0),
+                branch: raw.branch ?? '',
+                agent: raw.agent ?? '',
+                filesTouched: raw.files_touched ?? [],
+                isTask: raw.is_task ?? false,
+                toolUseId: raw.tool_use_id,
+                checkpointTranscriptStart: raw.checkpoint_transcript_start ?? 0,
+            },
+            summary,
+            tokenUsage,
+            attribution,
+        };
+    }
+    /**
+     * Parse a JSONL transcript into structured messages.
+     * Tolerant of malformed lines — skips them silently.
+     */
+    parseTranscript(jsonlContent) {
+        const messages = [];
+        const lines = jsonlContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            try {
+                const raw = JSON.parse(line);
+                const msg = this.parseTranscriptLine(raw, i);
+                if (msg)
+                    messages.push(msg);
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return messages;
+    }
+    /**
+     * Parse chunked transcripts (full.jsonl.001, .002, etc.)
+     */
+    parseChunkedTranscript(chunks) {
+        const combined = chunks.join('\n');
+        return this.parseTranscript(combined);
+    }
+    /**
+     * Parse the root checkpoint summary to discover session subdirectories.
+     */
+    parseCheckpointSummary(metadataJson, checkpointPath) {
+        const raw = JSON.parse(metadataJson);
+        const sessions = raw.sessions ?? [];
+        const checkpointId = this.checkpointIdFromPath(checkpointPath);
+        return {
+            checkpointId,
+            sessionIds: [], // populated later from per-session metadata
+            path: checkpointPath,
+            sessionCount: sessions.length,
+        };
+    }
+    // ── Private helpers ──────────────────────────────────────────
+    parseTranscriptLine(raw, lineIndex) {
+        // Map Entire CLI's "human" → "user", keep "assistant" as-is.
+        // Also support the role field nested under message.role.
+        let role;
+        if (raw.type === 'user' || raw.type === 'human') {
+            role = 'user';
+        }
+        else if (raw.type === 'assistant') {
+            role = 'assistant';
+        }
+        else if (raw.type === 'tool_result') {
+            // Real Entire CLI emits tool_result as a top-level JSONL line.
+            // Wrap it as a user message containing a tool_result block.
+            const toolResultBlock = {
+                type: 'tool_result',
+                toolUseId: raw.tool_use_id ?? '',
+                content: typeof raw.content === 'string'
+                    ? raw.content
+                    : Array.isArray(raw.content)
+                        ? raw.content
+                            .filter((b) => b.type === 'text')
+                            .map((b) => b.text ?? '')
+                            .join('\n')
+                        : '',
+                isError: raw.is_error,
+            };
+            return {
+                role: 'user',
+                uuid: raw.uuid ?? `line-${lineIndex}`,
+                content: [toolResultBlock],
+                lineIndex,
+            };
+        }
+        else {
+            return null;
+        }
+        // UUID may not be present in real Entire CLI output
+        const uuid = raw.uuid ?? `line-${lineIndex}`;
+        const rawContent = raw.message?.content;
+        let content;
+        if (typeof rawContent === 'string') {
+            content = [{ type: 'text', text: rawContent }];
+        }
+        else if (Array.isArray(rawContent)) {
+            content = rawContent
+                .map((block) => this.parseContentBlock(block))
+                .filter((b) => b !== null);
+        }
+        else {
+            content = [];
+        }
+        return { role, uuid, content, lineIndex };
+    }
+    parseContentBlock(raw) {
+        switch (raw.type) {
+            case 'text':
+                return { type: 'text', text: raw.text ?? '' };
+            case 'tool_use':
+                return {
+                    type: 'tool_use',
+                    id: raw.id ?? '',
+                    name: raw.name ?? '',
+                    input: raw.input ?? {},
+                };
+            case 'tool_result':
+                return {
+                    type: 'tool_result',
+                    toolUseId: raw.tool_use_id ?? '',
+                    content: raw.content ?? '',
+                    isError: raw.is_error,
+                };
+            default:
+                return null;
+        }
+    }
+    parseTokenUsage(raw) {
+        if (!raw) {
+            return {
+                inputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+                outputTokens: 0,
+                apiCallCount: 0,
+                total: 0,
+            };
+        }
+        const inputTokens = raw.input_tokens ?? 0;
+        const cacheCreationTokens = raw.cache_creation_tokens ?? 0;
+        const cacheReadTokens = raw.cache_read_tokens ?? 0;
+        const outputTokens = raw.output_tokens ?? 0;
+        const apiCallCount = raw.api_call_count ?? 0;
+        const subagentUsage = raw.subagent_usage?.map((s) => this.parseTokenUsage(s));
+        return {
+            inputTokens,
+            cacheCreationTokens,
+            cacheReadTokens,
+            outputTokens,
+            apiCallCount,
+            subagentUsage,
+            total: inputTokens + cacheCreationTokens + cacheReadTokens + outputTokens,
+        };
+    }
+    parseSummary(raw) {
+        return {
+            intent: raw.intent ?? '',
+            outcome: raw.outcome ?? '',
+            learnings: {
+                repoPatterns: raw.learnings?.repo_patterns ?? [],
+                codeFindings: raw.learnings?.code_findings ?? [],
+                workflowPractices: raw.learnings?.workflow_practices ?? [],
+            },
+            frictionPoints: raw.friction_points ?? [],
+            openItems: raw.open_items ?? [],
+        };
+    }
+    parseAttribution(raw) {
+        return {
+            agentLinesAdded: raw.agent_lines_added ?? 0,
+            humanAdditions: raw.human_additions ?? 0,
+            humanModifications: raw.human_modifications ?? 0,
+            humanRemovals: raw.human_removals ?? 0,
+            totalCommittedLines: raw.total_committed_lines ?? 0,
+            agentContribution: raw.agent_contribution ?? 0,
+        };
+    }
+    checkpointIdFromPath(path) {
+        // Path is "<shard>/<rest>" → checkpoint ID is shard + rest
+        const parts = path.split('/');
+        if (parts.length >= 2) {
+            return parts[0] + parts[1];
+        }
+        return path;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/session-bank/parser.js.map

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

package/dist/session-bank/session-bank.d.ts

@@ -0,0 +1,35 @@
+import type { SessionRecord, CheckpointRef, SessionQuery, SessionQueryResult, SessionBankOptions, ProcessingLogEntry } from './types.js';
+export declare class SessionBank {
+    private reader;
+    private parser;
+    private stateDir;
+    private cacheEnabled;
+    private available;
+    private initialized;
+    private cachedBranchHead;
+    private sessionCache;
+    private checkpointCache;
+    private processingState;
+    constructor(options?: SessionBankOptions);
+    init(): Promise<void>;
+    isAvailable(): boolean;
+    close(): Promise<void>;
+    listCheckpoints(): Promise<CheckpointRef[]>;
+    discover(): Promise<SessionRecord[]>;
+    count(query?: SessionQuery): Promise<number>;
+    query(query?: SessionQuery): Promise<SessionQueryResult>;
+    getBySessionId(sessionId: string): Promise<SessionRecord | undefined>;
+    getByCheckpointId(checkpointId: string): Promise<SessionRecord[]>;
+    getByCommit(commitSha: string): Promise<SessionRecord[]>;
+    markProcessed(sessionId: string, metadata?: Record<string, unknown>): Promise<void>;
+    isProcessed(sessionId: string): boolean;
+    getProcessingLog(): ProcessingLogEntry[];
+    invalidateCache(): void;
+    private ensureInitialized;
+    private ensureCacheValid;
+    private filterByMetadata;
+    private loadTranscript;
+    private loadProcessingState;
+    private saveProcessingState;
+}
+//# sourceMappingURL=session-bank.d.ts.map

package/dist/session-bank/session-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bank.d.ts","sourceRoot":"","sources":["../../src/session-bank/session-bank.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAiBpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAU;IAE9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,eAAe,CAAgC;IAGvD,OAAO,CAAC,eAAe,CAGrB;gBAEU,OAAO,CAAC,EAAE,kBAAkB;IAYlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,WAAW,IAAI,OAAO;IAIhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA8B3C,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAuDpC,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5C,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+CxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAOrE,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgCjE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQxD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAWhB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC,gBAAgB,IAAI,kBAAkB,EAAE;IAMxC,eAAe,IAAI,IAAI;IAQvB,OAAO,CAAC,iBAAiB;YAQX,gBAAgB;IAU9B,OAAO,CAAC,gBAAgB;YA+CV,cAAc;YAiDd,mBAAmB;YA8BnB,mBAAmB;CAsBlC"}

package/dist/session-bank/session-bank.js

@@ -0,0 +1,326 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { EntireGitReader } from './git-reader.js';
+import { EntireTranscriptParser } from './parser.js';
+export class SessionBank {
+    reader;
+    parser;
+    stateDir;
+    cacheEnabled;
+    available = false;
+    initialized = false;
+    // Cache
+    cachedBranchHead = null;
+    sessionCache = new Map();
+    checkpointCache = null;
+    // Processing state
+    processingState = {
+        entries: [],
+        sessionIds: new Set(),
+    };
+    constructor(options) {
+        const repoPath = options?.repoPath ?? process.cwd();
+        const branch = options?.branch ?? 'entire/checkpoints/v1';
+        this.stateDir = options?.stateDir ?? join(repoPath, '.atlas', 'session-bank');
+        this.cacheEnabled = options?.cache ?? true;
+        this.reader = new EntireGitReader({ repoPath, branch });
+        this.parser = new EntireTranscriptParser();
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────
+    async init() {
+        this.available = await this.reader.branchExists();
+        await this.loadProcessingState();
+        if (this.available) {
+            this.cachedBranchHead = await this.reader.getBranchHead();
+        }
+        this.initialized = true;
+    }
+    isAvailable() {
+        return this.available;
+    }
+    async close() {
+        await this.saveProcessingState();
+    }
+    // ── Discovery (metadata-only, fast) ───────────────────────────
+    async listCheckpoints() {
+        this.ensureInitialized();
+        if (!this.available)
+            return [];
+        await this.ensureCacheValid();
+        if (this.checkpointCache)
+            return this.checkpointCache;
+        const checkpointPaths = await this.reader.listCheckpoints();
+        const refs = [];
+        for (const path of checkpointPaths) {
+            try {
+                const rootMeta = await this.reader.readFileOrNull(`${path}/metadata.json`);
+                if (rootMeta) {
+                    const ref = this.parser.parseCheckpointSummary(rootMeta, path);
+                    refs.push(ref);
+                }
+            }
+            catch {
+                // Skip corrupt checkpoints
+            }
+        }
+        if (this.cacheEnabled) {
+            this.checkpointCache = refs;
+        }
+        return refs;
+    }
+    async discover() {
+        this.ensureInitialized();
+        if (!this.available)
+            return [];
+        const refs = await this.listCheckpoints();
+        const sessions = [];
+        for (const ref of refs) {
+            const sessionIndices = await this.reader.listSessions(ref.path);
+            for (const idx of sessionIndices) {
+                const cacheKey = `${ref.path}/${idx}`;
+                const cached = this.sessionCache.get(cacheKey);
+                if (cached) {
+                    sessions.push(cached.record);
+                    continue;
+                }
+                try {
+                    const metaJson = await this.reader.readFile(`${ref.path}/${idx}/metadata.json`);
+                    const parsed = this.parser.parseMetadata(metaJson);
+                    const record = {
+                        sessionId: parsed.sessionId,
+                        checkpointId: parsed.checkpointId,
+                        metadata: parsed.metadata,
+                        transcript: [], // lazy — not loaded during discover
+                        summary: parsed.summary,
+                        tokenUsage: parsed.tokenUsage,
+                        attribution: parsed.attribution,
+                        source: {
+                            branch: 'entire/checkpoints/v1',
+                            checkpointPath: ref.path,
+                            sessionIndex: idx,
+                        },
+                    };
+                    if (this.cacheEnabled) {
+                        this.sessionCache.set(cacheKey, {
+                            record,
+                            hasTranscript: false,
+                        });
+                    }
+                    sessions.push(record);
+                }
+                catch {
+                    // Skip sessions with unreadable metadata
+                }
+            }
+        }
+        return sessions;
+    }
+    async count(query) {
+        const sessions = await this.discover();
+        return this.filterByMetadata(sessions, query).length;
+    }
+    // ── Querying (loads transcripts on demand) ────────────────────
+    async query(query) {
+        this.ensureInitialized();
+        if (!this.available)
+            return { sessions: [], total: 0 };
+        // Discover all sessions (metadata only)
+        let sessions = await this.discover();
+        // Apply metadata-based filters first
+        sessions = this.filterByMetadata(sessions, query);
+        const total = sessions.length;
+        // Sort
+        const sort = query?.sort ?? 'newest';
+        sessions.sort((a, b) => {
+            const diff = a.metadata.createdAt.getTime() - b.metadata.createdAt.getTime();
+            return sort === 'newest' ? -diff : diff;
+        });
+        // Apply limit
+        if (query?.limit && query.limit > 0) {
+            sessions = sessions.slice(0, query.limit);
+        }
+        // Load transcripts for matching sessions
+        const fullSessions = await Promise.all(sessions.map((s) => this.loadTranscript(s)));
+        // Apply search filter (requires transcript)
+        let result = fullSessions;
+        if (query?.search) {
+            const needle = query.search.toLowerCase();
+            result = result.filter((s) => s.transcript.some((msg) => msg.role === 'user' &&
+                msg.content.some((b) => b.type === 'text' &&
+                    b.text.toLowerCase().includes(needle))));
+        }
+        return { sessions: result, total };
+    }
+    async getBySessionId(sessionId) {
+        const sessions = await this.discover();
+        const match = sessions.find((s) => s.sessionId === sessionId);
+        if (!match)
+            return undefined;
+        return this.loadTranscript(match);
+    }
+    async getByCheckpointId(checkpointId) {
+        // Derive path from checkpoint ID
+        const shard = checkpointId.slice(0, 2);
+        const rest = checkpointId.slice(2);
+        const path = `${shard}/${rest}`;
+        const sessionIndices = await this.reader.listSessions(path);
+        const sessions = [];
+        for (const idx of sessionIndices) {
+            try {
+                const metaJson = await this.reader.readFile(`${path}/${idx}/metadata.json`);
+                const transcriptJsonl = await this.reader.readFileOrNull(`${path}/${idx}/full.jsonl`);
+                const record = this.parser.parseSession(metaJson, transcriptJsonl ?? '', path, idx);
+                sessions.push(record);
+            }
+            catch {
+                // Skip sessions with errors
+            }
+        }
+        return sessions;
+    }
+    async getByCommit(commitSha) {
+        const checkpointId = await this.reader.getCheckpointTrailer(commitSha);
+        if (!checkpointId)
+            return [];
+        return this.getByCheckpointId(checkpointId);
+    }
+    // ── Processing Tracking ───────────────────────────────────────
+    async markProcessed(sessionId, metadata) {
+        const entry = {
+            sessionId,
+            processedAt: new Date(),
+            metadata,
+        };
+        this.processingState.entries.push(entry);
+        this.processingState.sessionIds.add(sessionId);
+        await this.saveProcessingState();
+    }
+    isProcessed(sessionId) {
+        return this.processingState.sessionIds.has(sessionId);
+    }
+    getProcessingLog() {
+        return [...this.processingState.entries];
+    }
+    // ── Cache Management ──────────────────────────────────────────
+    invalidateCache() {
+        this.sessionCache.clear();
+        this.checkpointCache = null;
+        this.cachedBranchHead = null;
+    }
+    // ── Private helpers ───────────────────────────────────────────
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('SessionBank not initialized. Call init() first.');
+        }
+    }
+    async ensureCacheValid() {
+        if (!this.cacheEnabled)
+            return;
+        const currentHead = await this.reader.getBranchHead();
+        if (currentHead !== this.cachedBranchHead) {
+            this.invalidateCache();
+            this.cachedBranchHead = currentHead;
+        }
+    }
+    filterByMetadata(sessions, query) {
+        if (!query)
+            return sessions;
+        let result = sessions;
+        if (query.since) {
+            const since = query.since.getTime();
+            result = result.filter((s) => s.metadata.createdAt.getTime() >= since);
+        }
+        if (query.before) {
+            const before = query.before.getTime();
+            result = result.filter((s) => s.metadata.createdAt.getTime() < before);
+        }
+        if (query.branch) {
+            result = result.filter((s) => s.metadata.branch === query.branch);
+        }
+        if (query.agent) {
+            result = result.filter((s) => s.metadata.agent === query.agent);
+        }
+        if (query.strategy) {
+            result = result.filter((s) => s.metadata.strategy === query.strategy);
+        }
+        if (query.hasSummary !== undefined) {
+            result = result.filter((s) => (s.summary !== undefined) === query.hasSummary);
+        }
+        if (query.unprocessedOnly) {
+            result = result.filter((s) => !this.isProcessed(s.sessionId));
+        }
+        return result;
+    }
+    async loadTranscript(session) {
+        // Check if transcript is already loaded
+        if (session.transcript.length > 0)
+            return session;
+        const cacheKey = `${session.source.checkpointPath}/${session.source.sessionIndex}`;
+        const cached = this.sessionCache.get(cacheKey);
+        if (cached?.hasTranscript)
+            return cached.record;
+        const basePath = `${session.source.checkpointPath}/${session.source.sessionIndex}`;
+        // Try single file first
+        let transcriptContent = await this.reader.readFileOrNull(`${basePath}/full.jsonl`);
+        if (transcriptContent === null) {
+            // Try chunked format
+            const chunks = [];
+            for (let i = 1;; i++) {
+                const chunkNum = String(i).padStart(3, '0');
+                const chunk = await this.reader.readFileOrNull(`${basePath}/full.jsonl.${chunkNum}`);
+                if (chunk === null)
+                    break;
+                chunks.push(chunk);
+            }
+            if (chunks.length > 0) {
+                transcriptContent = chunks.join('\n');
+            }
+        }
+        const transcript = transcriptContent
+            ? this.parser.parseTranscript(transcriptContent)
+            : [];
+        const fullRecord = { ...session, transcript };
+        if (this.cacheEnabled) {
+            this.sessionCache.set(cacheKey, {
+                record: fullRecord,
+                hasTranscript: true,
+            });
+        }
+        return fullRecord;
+    }
+    async loadProcessingState() {
+        try {
+            const raw = await readFile(join(this.stateDir, 'processed.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            const entries = (data.entries ?? []).map((e) => ({
+                sessionId: e.sessionId,
+                processedAt: new Date(e.processedAt),
+                metadata: e.metadata,
+            }));
+            this.processingState = {
+                entries,
+                sessionIds: new Set(entries.map((e) => e.sessionId)),
+            };
+        }
+        catch {
+            // No existing state — start fresh
+            this.processingState = { entries: [], sessionIds: new Set() };
+        }
+    }
+    async saveProcessingState() {
+        try {
+            await mkdir(this.stateDir, { recursive: true });
+            await writeFile(join(this.stateDir, 'processed.json'), JSON.stringify({
+                entries: this.processingState.entries.map((e) => ({
+                    sessionId: e.sessionId,
+                    processedAt: e.processedAt.toISOString(),
+                    metadata: e.metadata,
+                })),
+            }, null, 2), 'utf-8');
+        }
+        catch {
+            // Best-effort persistence
+        }
+    }
+}
+//# sourceMappingURL=session-bank.js.map