# checkpoint: use compact_transcript path field instead of boolean

`0eaaf1b`→[main](/content/gh/entireio/cli/commits/main/index.html)·

Replace the has_compact_transcript boolean with a compact_transcript string holding the path to transcript.jsonl, placed alongside the transcript (full.jsonl) pointer in the root metadata.json sessions[] entries. Omitted when no compact transcript was written. This mirrors the existing transcript pointer rather than signalling presence separately.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

## Sessions

d1553195a011View transcript

## Changes

5

- MCLAUDE.md+1/-1

- api/checkpoint

- Mmetadata.go+8/-11

- cmd/entire/cli/checkpoint

- Mpersistent.go+8/-6

- Mpersistent_compact_transcript_test.go+8/-6

- docs/architecture

- Msessions-and-checkpoints.md+4/-4

```
494 unmodified lines
```

- **Worktree-specific branches** - each git worktree gets its own shadow branch namespace, preventing conflicts
- **Supports multiple concurrent sessions** - checkpoints from different sessions in the same directory interleave on the same shadow branch
- Condenses session logs to permanent `entire/checkpoints/v1` branch on user commits
- Each committed session stores the raw transcript (`full.jsonl`, read by CLI rewind/resume/explain) plus a best-effort compact transcript (`transcript.jsonl`, generated via `transcript/compact` and pre-sliced to the checkpoint's `checkpoint_transcript_start`). Both are pushed with the v1 branch. The root `metadata.json` `sessions[].transcript` pointer keeps targeting `full.jsonl`; when the compact transcript was generated the session entry also carries `has_compact_transcript: true` (omitted otherwise) so external readers can locate `transcript.jsonl` next to it.
- Uses the `post-rewrite` Git hook to keep local session linkage aligned after amend/rebase rewrites
- Builds git trees in-memory using go-git plumbing APIs
- Rewind restores files from shadow branch commit tree (does not use `git reset`)

```
MCLAUDE.md+1/-1
```

```
380 unmodified lines
```

### SessionFilePaths Struct

```go
type SessionFilePaths struct {
    Metadata string `json:"metadata"`
    Transcript  string `json:"transcript,omitempty"`
    ContentHash string `json:"content_hash,omitempty"`
    Prompt      string `json:"prompt"`
    HasCompactTranscript bool `json:"has_compact_transcript,omitempty"`
    CompactTranscript string `json:"compact_transcript,omitempty"`
}
```

```
403 unmodified lines
```

// Write transcript. The pointer targets full.jsonl, which CLI
// rewind/resume/explain read by filename. The compact transcript.jsonl is
// also written into the tree (so it is pushed) and signalled to external
// readers via the HasCompactTranscript flag below.

```
79 unmodified lines
```

```go
// Root metadata.json still points at full.jsonl; the compact transcript is
// written into the tree (and pushed) and flagged via has_compact_transcript.
```

```
215 unmodified lines
```

It is written into the checkpoint tree and pushed alongside `full.jsonl`. The
root `metadata.json` `sessions[].transcript` pointer keeps targeting `full.jsonl`; when a compact transcript was generated the session entry also carries a `compact_transcript` path pointing at `transcript.jsonl` (omitted otherwise) so external readers can find it next to `full.jsonl`.

{  
  "metadata": "/ab/c123def456/0/metadata.json",  
  "transcript": "/ab/c123def456/0/full.jsonl",  
  "compact_transcript": "/ab/c123def456/0/transcript.jsonl",  
  "content_hash": "/ab/c123def456/0/content_hash.txt",  
  "prompt": "/ab/c123def456/0/prompt.txt",  
  "has_compact_transcript": true 
}