cognitive-core 0.1.2 → 0.2.0

package/src/session-bank/git-reader.ts

@@ -1,22 +1,28 @@
 import { execFile } from 'node:child_process';
 
-// ─── EntireGitReader ────────────────────────────────────────────────
-// Low-level git plumbing for reading from the Entire orphan branch
-// without checking it out. Uses only git commands, no fs access.
+// ─── CheckpointGitReader ────────────────────────────────────────────
+// Low-level git plumbing for reading from SessionLog checkpoint orphan
+// branches without checking them out.
+// Uses only git commands, no fs access.
 // ─────────────────────────────────────────────────────────────────────
 
 export interface GitReaderOptions {
   repoPath: string;
   branch?: string;
+  /** Trailer keys to search for checkpoint IDs in commit messages.
+   *  Defaults to ['Sessionlog-Checkpoint']. */
+  trailerKeys?: string[];
 }
 
-export class EntireGitReader {
-  private repoPath: string;
-  private branch: string;
+export class CheckpointGitReader {
+  readonly repoPath: string;
+  readonly branch: string;
+  private trailerKeys: string[];
 
   constructor(options: GitReaderOptions) {
     this.repoPath = options.repoPath;
-    this.branch = options.branch ?? 'entire/checkpoints/v1';
+    this.branch = options.branch ?? 'sessionlog/checkpoints/v1';
+    this.trailerKeys = options.trailerKeys ?? ['Sessionlog-Checkpoint'];
   }
 
   /** Check if the orphan branch exists in this repo */
@@ -151,22 +157,26 @@ export class EntireGitReader {
   }
 
   /**
-   * Find the Entire-Checkpoint trailer value for a given commit.
+   * Find a checkpoint trailer value for a given commit.
+   * Tries each configured trailer key in order.
    * Returns the checkpoint ID or null.
    */
   async getCheckpointTrailer(commitSha: string): Promise<string | null> {
-    try {
-      const output = await this.git([
-        'log',
-        '--format=%(trailers:key=Entire-Checkpoint,valueonly)',
-        commitSha,
-        '-1',
-      ]);
-      const value = output.trim();
-      return value || null;
-    } catch {
-      return null;
+    for (const key of this.trailerKeys) {
+      try {
+        const output = await this.git([
+          'log',
+          `--format=%(trailers:key=${key},valueonly)`,
+          commitSha,
+          '-1',
+        ]);
+        const value = output.trim();
+        if (value) return value;
+      } catch {
+        // Try next key
+      }
     }
+    return null;
   }
 
   // ── Private ──────────────────────────────────────────────────

package/src/session-bank/index.ts

@@ -1,7 +1,9 @@
 export { SessionBank } from './session-bank.js';
-export { EntireGitReader, type GitReaderOptions } from './git-reader.js';
+export { CheckpointGitReader, type GitReaderOptions } from './git-reader.js';
 export {
-  EntireTranscriptParser,
+  CheckpointParser,
+  detectFormat,
+  type CheckpointFormat,
   type ParsedMetadata,
 } from './parser.js';
 export type {

package/src/session-bank/parser.ts

@@ -9,9 +9,22 @@ import type {
   CheckpointRef,
 } from './types.js';
 
+// ─── Format Detection ──────────────────────────────────────────────
+
+export type CheckpointFormat = 'entire' | 'sessionlog' | 'unknown';
+
+/** Auto-detect whether raw metadata JSON is Entire CLI or SessionLog format. */
+export function detectFormat(raw: Record<string, unknown>): CheckpointFormat {
+  if ('checkpointID' in raw) return 'sessionlog';
+  if ('checkpoint_id' in raw) return 'entire';
+  if (raw.cliVersion === 'opentasks-sessionlog') return 'sessionlog';
+  if (typeof raw.cli_version === 'string') return 'entire';
+  return 'unknown';
+}
+
 // ─── Raw Entire JSON shapes (snake_case, matching Go structs) ───────
 
-interface RawMetadata {
+interface RawEntireMetadata {
   cli_version?: string;
   checkpoint_id?: string;
   session_id?: string;
@@ -23,21 +36,21 @@ interface RawMetadata {
   is_task?: boolean;
   tool_use_id?: string;
   checkpoint_transcript_start?: number;
-  token_usage?: RawTokenUsage;
-  summary?: RawSummary;
-  initial_attribution?: RawAttribution;
+  token_usage?: RawEntireTokenUsage;
+  summary?: RawEntireSummary;
+  initial_attribution?: RawEntireAttribution;
 }
 
-interface RawTokenUsage {
+interface RawEntireTokenUsage {
   input_tokens?: number;
   cache_creation_tokens?: number;
   cache_read_tokens?: number;
   output_tokens?: number;
   api_call_count?: number;
-  subagent_usage?: RawTokenUsage[];
+  subagent_usage?: RawEntireTokenUsage[];
 }
 
-interface RawSummary {
+interface RawEntireSummary {
   intent?: string;
   outcome?: string;
   learnings?: {
@@ -49,7 +62,7 @@ interface RawSummary {
   open_items?: string[];
 }
 
-interface RawAttribution {
+interface RawEntireAttribution {
   agent_lines_added?: number;
   human_additions?: number;
   human_modifications?: number;
@@ -58,6 +71,62 @@ interface RawAttribution {
   agent_contribution?: number;
 }
 
+// ─── Raw SessionLog JSON shapes (camelCase) ─────────────────────────
+
+interface RawSessionLogMetadata {
+  cliVersion?: string;
+  checkpointID?: string;
+  sessionID?: string;
+  strategy?: string;
+  createdAt?: string;
+  branch?: string;
+  filesTouched?: string[];
+  agent?: string;
+  turnID?: string;
+  isTask?: boolean;
+  toolUseID?: string;
+  checkpointTranscriptStart?: number;
+  tokenUsage?: RawSessionLogTokenUsage;
+  summary?: RawSessionLogSummary;
+  initialAttribution?: RawSessionLogAttribution;
+  tasks?: Record<string, unknown>;
+  planEntries?: unknown[];
+  skillsUsed?: unknown[];
+}
+
+interface RawSessionLogTokenUsage {
+  inputTokens?: number;
+  cacheCreationTokens?: number;
+  cacheReadTokens?: number;
+  outputTokens?: number;
+  apiCallCount?: number;
+  subagentTokens?: RawSessionLogTokenUsage;
+}
+
+interface RawSessionLogSummary {
+  intent?: string;
+  outcome?: string;
+  learnings?: {
+    repo?: string[];
+    code?: Array<{ path: string; line?: number; endLine?: number; finding: string }>;
+    workflow?: string[];
+  };
+  friction?: string[];
+  openItems?: string[];
+}
+
+interface RawSessionLogAttribution {
+  calculatedAt?: string;
+  agentLines?: number;
+  humanAdded?: number;
+  humanModified?: number;
+  humanRemoved?: number;
+  totalCommitted?: number;
+  agentPercentage?: number;
+}
+
+// ─── Shared raw types for transcript parsing ────────────────────────
+
 interface RawTranscriptLine {
   type?: string;
   uuid?: string;
@@ -65,7 +134,7 @@ interface RawTranscriptLine {
     role?: string;
     content?: string | RawContentBlock[];
   };
-  // Real Entire CLI uses these for tool_result lines
+  // Entire CLI uses these for top-level tool_result lines
   tool_use_id?: string;
   content?: string | RawContentBlock[];
   is_error?: boolean;
@@ -84,6 +153,7 @@ interface RawContentBlock {
 }
 
 interface RawCheckpointSummary {
+  // Entire format (snake_case)
   sessions?: Array<{
     metadata?: string;
     transcript?: string;
@@ -91,6 +161,9 @@ interface RawCheckpointSummary {
     content_hash?: string;
     prompt?: string;
   }>;
+  // SessionLog format may also use camelCase — same structure
+  checkpointID?: string;
+  checkpointsCount?: number;
 }
 
 // ─── Parser ─────────────────────────────────────────────────────────
@@ -102,9 +175,10 @@ export interface ParsedMetadata {
   summary?: SessionSummary;
   tokenUsage: TokenUsage;
   attribution?: Attribution;
+  format: CheckpointFormat;
 }
 
-export class EntireTranscriptParser {
+export class CheckpointParser {
   /**
    * Parse a full session from its component files.
    */
@@ -113,6 +187,7 @@ export class EntireTranscriptParser {
     transcriptJsonl: string,
     checkpointPath: string,
     sessionIndex: string,
+    sourceBranch?: string,
   ): SessionRecord {
     const parsed = this.parseMetadata(metadataJson);
     const transcript = this.parseTranscript(transcriptJsonl);
@@ -126,7 +201,7 @@ export class EntireTranscriptParser {
       tokenUsage: parsed.tokenUsage,
       attribution: parsed.attribution,
       source: {
-        branch: 'entire/checkpoints/v1',
+        branch: sourceBranch ?? 'sessionlog/checkpoints/v1',
         checkpointPath,
         sessionIndex,
       },
@@ -135,39 +210,22 @@ export class EntireTranscriptParser {
 
   /**
    * Parse per-session metadata.json (fast path — no transcript).
+   * Auto-detects Entire (snake_case) vs SessionLog (camelCase) format.
    */
   parseMetadata(metadataJson: string): ParsedMetadata {
-    const raw: RawMetadata = 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;
+    const raw = JSON.parse(metadataJson) as Record<string, unknown>;
+    const format = detectFormat(raw);
 
-    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,
-    };
+    if (format === 'sessionlog') {
+      return this.parseSessionLogMetadata(raw as unknown as RawSessionLogMetadata);
+    }
+    return this.parseEntireMetadata(raw as unknown as RawEntireMetadata);
   }
 
   /**
    * Parse a JSONL transcript into structured messages.
    * Tolerant of malformed lines — skips them silently.
+   * Handles both Entire ("human") and SessionLog ("user") role types.
    */
   parseTranscript(jsonlContent: string): TranscriptMessage[] {
     const messages: TranscriptMessage[] = [];
@@ -216,21 +274,204 @@ export class EntireTranscriptParser {
     };
   }
 
-  // ── Private helpers ──────────────────────────────────────────
+  // ── Entire format parsing (snake_case) ────────────────────────
+
+  private parseEntireMetadata(raw: RawEntireMetadata): ParsedMetadata {
+    const tokenUsage = this.parseEntireTokenUsage(raw.token_usage);
+    const summary = raw.summary ? this.parseEntireSummary(raw.summary) : undefined;
+    const attribution = raw.initial_attribution
+      ? this.parseEntireAttribution(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,
+      format: 'entire',
+    };
+  }
+
+  private parseEntireTokenUsage(raw?: RawEntireTokenUsage): TokenUsage {
+    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.parseEntireTokenUsage(s),
+    );
+
+    return {
+      inputTokens,
+      cacheCreationTokens,
+      cacheReadTokens,
+      outputTokens,
+      apiCallCount,
+      subagentUsage,
+      total: inputTokens + cacheCreationTokens + cacheReadTokens + outputTokens,
+    };
+  }
+
+  private parseEntireSummary(raw: RawEntireSummary): SessionSummary {
+    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 ?? [],
+    };
+  }
+
+  private parseEntireAttribution(raw: RawEntireAttribution): Attribution {
+    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,
+    };
+  }
+
+  // ── SessionLog format parsing (camelCase) ─────────────────────
+
+  private parseSessionLogMetadata(raw: RawSessionLogMetadata): ParsedMetadata {
+    const tokenUsage = this.parseSessionLogTokenUsage(raw.tokenUsage);
+    const summary = raw.summary ? this.parseSessionLogSummary(raw.summary) : undefined;
+    const attribution = raw.initialAttribution
+      ? this.parseSessionLogAttribution(raw.initialAttribution)
+      : undefined;
+
+    return {
+      sessionId: raw.sessionID ?? '',
+      checkpointId: raw.checkpointID ?? '',
+      metadata: {
+        cliVersion: raw.cliVersion ?? '',
+        strategy: raw.strategy === 'auto-commit' ? 'auto-commit' : 'manual-commit',
+        createdAt: raw.createdAt ? new Date(raw.createdAt) : new Date(0),
+        branch: raw.branch ?? '',
+        agent: raw.agent ?? '',
+        filesTouched: raw.filesTouched ?? [],
+        isTask: raw.isTask ?? false,
+        toolUseId: raw.toolUseID,
+        checkpointTranscriptStart: raw.checkpointTranscriptStart ?? 0,
+      },
+      summary,
+      tokenUsage,
+      attribution,
+      format: 'sessionlog',
+    };
+  }
+
+  private parseSessionLogTokenUsage(raw?: RawSessionLogTokenUsage): TokenUsage {
+    if (!raw) {
+      return {
+        inputTokens: 0,
+        cacheCreationTokens: 0,
+        cacheReadTokens: 0,
+        outputTokens: 0,
+        apiCallCount: 0,
+        total: 0,
+      };
+    }
+
+    const inputTokens = raw.inputTokens ?? 0;
+    const cacheCreationTokens = raw.cacheCreationTokens ?? 0;
+    const cacheReadTokens = raw.cacheReadTokens ?? 0;
+    const outputTokens = raw.outputTokens ?? 0;
+    const apiCallCount = raw.apiCallCount ?? 0;
+
+    // SessionLog uses single subagentTokens object; wrap in array for compatibility
+    const subagentUsage = raw.subagentTokens
+      ? [this.parseSessionLogTokenUsage(raw.subagentTokens)]
+      : undefined;
+
+    return {
+      inputTokens,
+      cacheCreationTokens,
+      cacheReadTokens,
+      outputTokens,
+      apiCallCount,
+      subagentUsage,
+      total: inputTokens + cacheCreationTokens + cacheReadTokens + outputTokens,
+    };
+  }
+
+  private parseSessionLogSummary(raw: RawSessionLogSummary): SessionSummary {
+    // SessionLog uses learnings.code as CodeLearning[] — normalize to string[]
+    const codeFindings = (raw.learnings?.code ?? []).map((cl) => {
+      const loc = cl.line ? `${cl.path}:${cl.line}` : cl.path;
+      return `${loc} - ${cl.finding}`;
+    });
+
+    return {
+      intent: raw.intent ?? '',
+      outcome: raw.outcome ?? '',
+      learnings: {
+        repoPatterns: raw.learnings?.repo ?? [],
+        codeFindings,
+        workflowPractices: raw.learnings?.workflow ?? [],
+      },
+      frictionPoints: raw.friction ?? [],
+      openItems: raw.openItems ?? [],
+    };
+  }
+
+  private parseSessionLogAttribution(raw: RawSessionLogAttribution): Attribution {
+    return {
+      agentLinesAdded: raw.agentLines ?? 0,
+      humanAdditions: raw.humanAdded ?? 0,
+      humanModifications: raw.humanModified ?? 0,
+      humanRemovals: raw.humanRemoved ?? 0,
+      totalCommittedLines: raw.totalCommitted ?? 0,
+      agentContribution: raw.agentPercentage ?? 0,
+    };
+  }
+
+  // ── Transcript parsing (shared — works for both formats) ──────
 
   private parseTranscriptLine(
     raw: RawTranscriptLine,
     lineIndex: number,
   ): TranscriptMessage | null {
     // Map Entire CLI's "human" → "user", keep "assistant" as-is.
-    // Also support the role field nested under message.role.
+    // SessionLog always uses "user". Both handled here.
     let role: 'user' | 'assistant';
     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.
+      // Entire CLI emits tool_result as a top-level JSONL line.
       // Wrap it as a user message containing a tool_result block.
       const toolResultBlock: ContentBlock = {
         type: 'tool_result',
@@ -255,7 +496,6 @@ export class EntireTranscriptParser {
       return null;
     }
 
-    // UUID may not be present in real Entire CLI output
     const uuid = raw.uuid ?? `line-${lineIndex}`;
 
     const rawContent = raw.message?.content;
@@ -297,64 +537,6 @@ export class EntireTranscriptParser {
     }
   }
 
-  private parseTokenUsage(raw?: RawTokenUsage): TokenUsage {
-    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,
-    };
-  }
-
-  private parseSummary(raw: RawSummary): SessionSummary {
-    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 ?? [],
-    };
-  }
-
-  private parseAttribution(raw: RawAttribution): Attribution {
-    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,
-    };
-  }
-
   private checkpointIdFromPath(path: string): string {
     // Path is "<shard>/<rest>" → checkpoint ID is shard + rest
     const parts = path.split('/');

package/src/session-bank/session-bank.ts

@@ -1,7 +1,7 @@
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
-import { EntireGitReader } from './git-reader.js';
-import { EntireTranscriptParser } from './parser.js';
+import { CheckpointGitReader } from './git-reader.js';
+import { CheckpointParser } from './parser.js';
 import type {
   SessionRecord,
   CheckpointRef,
@@ -12,10 +12,12 @@ import type {
 } from './types.js';
 
 // ─── SessionBank ────────────────────────────────────────────────────
-// Main facade for reading Entire CLI checkpoint data from the
-// orphan branch. Read-only — never writes to the orphan branch.
+// Main facade for reading SessionLog checkpoint data from orphan
+// branches. Read-only.
 // ─────────────────────────────────────────────────────────────────────
 
+const DEFAULT_BRANCH = 'sessionlog/checkpoints/v1';
+
 interface CachedSession {
   record: SessionRecord;
   hasTranscript: boolean;
@@ -27,13 +29,16 @@ interface ProcessingState {
 }
 
 export class SessionBank {
-  private reader: EntireGitReader;
-  private parser: EntireTranscriptParser;
+  private reader: CheckpointGitReader;
+  private parser: CheckpointParser;
   private stateDir: string;
   private cacheEnabled: boolean;
+  private repoPath: string;
+  private explicitBranch: string | undefined;
 
   private available = false;
   private initialized = false;
+  private detectedBranch: string = '';
 
   // Cache
   private cachedBranchHead: string | null = null;
@@ -47,19 +52,29 @@ export class SessionBank {
   };
 
   constructor(options?: SessionBankOptions) {
-    const repoPath = options?.repoPath ?? process.cwd();
-    const branch = options?.branch ?? 'entire/checkpoints/v1';
-    this.stateDir = options?.stateDir ?? join(repoPath, '.atlas', 'session-bank');
+    this.repoPath = options?.repoPath ?? process.cwd();
+    this.explicitBranch = options?.branch;
+    this.stateDir = options?.stateDir ?? join(this.repoPath, '.atlas', 'session-bank');
     this.cacheEnabled = options?.cache ?? true;
 
-    this.reader = new EntireGitReader({ repoPath, branch });
-    this.parser = new EntireTranscriptParser();
+    // Initial reader with explicit or default branch
+    const branch = this.explicitBranch ?? DEFAULT_BRANCH;
+    this.reader = new CheckpointGitReader({
+      repoPath: this.repoPath,
+      branch,
+      trailerKeys: options?.trailerKeys,
+    });
+    this.parser = new CheckpointParser();
   }
 
   // ── Lifecycle ──────────────────────────────────────────────────
 
   async init(): Promise<void> {
     this.available = await this.reader.branchExists();
+    if (this.available) {
+      this.detectedBranch = this.reader.branch;
+    }
+
     await this.loadProcessingState();
     if (this.available) {
       this.cachedBranchHead = await this.reader.getBranchHead();
@@ -71,6 +86,11 @@ export class SessionBank {
     return this.available;
   }
 
+  /** The orphan branch name that was detected or configured. */
+  getBranch(): string {
+    return this.detectedBranch;
+  }
+
   async close(): Promise<void> {
     await this.saveProcessingState();
   }
@@ -140,7 +160,7 @@ export class SessionBank {
             tokenUsage: parsed.tokenUsage,
             attribution: parsed.attribution,
             source: {
-              branch: 'entire/checkpoints/v1',
+              branch: this.detectedBranch,
               checkpointPath: ref.path,
               sessionIndex: idx,
             },
@@ -245,6 +265,7 @@ export class SessionBank {
           transcriptJsonl ?? '',
           path,
           idx,
+          this.detectedBranch,
         );
         sessions.push(record);
       } catch {