# checkpoint: make Write(WriteRequest) the only public persistent write

`ef0c5a0`→[main](/content/gh/entireio/cli/commits/main/index.html)·
Soph·3w ago·25 files·+138 added/-137 removed

The committed write operations are now internal dispatch targets of
Write(ctx, WriteRequest); callers use the request union exclusively:
WriteCommitted -> writeSession (Write WriteSession{...})
UpdateCommitted -> backfillTranscript (Write BackfillTranscript{...})
UpdateSummary -> backfillSummary (Write BackfillSummary{...})
UpdateCheckpointSummary -> backfillAttribution (Write BackfillAttribution{...})

Production already wrote through the union; this migrates the test callers
and unexports the dispatch targets, so 'Committed' is gone from the persistent
write surface and Write is the single entry point. No behavior change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

## Sessions

608f3d762503View transcript

## Changes

25

- cmd/entire/cli

- Mattach_test.go+2/-2
  - Mattribution_test.go+1/-1
  - benchutil

- Mbench_test.go+1/-1

- checkpoint

- Mbackwards_compat_test.go+1/-1
    - Mblob_resolver_test.go+1/-1
    - Mcheckpoint.go+6/-5
    - Mcheckpoint_test.go+46/-46
    - Mcommitted.go+10/-10
    - Mcommitted_opf_trailer_test.go+1/-1
    - Mcommitted_phantom_paths_test.go+2/-2
    - Mcommitted_read_store_test.go+1/-1
    - Mcommitted_reader_resolve_test.go+2/-2
    - Mcommitted_update_test.go+19/-19
    - Mcommitted_write.go+10/-10

- dispatch

- Mmode_local_test.go+3/-3

- Mexplain_export_test.go+2/-2
  - Mexplain_test.go+17/-17
  - Mhead_checkpoint_flags_test.go+1/-1
  - Mresume_test.go+5/-5
  - Mreview_context_test.go+1/-1
  - Mstatus_test.go+1/-1
  - strategy

- Mclean_test.go+1/-1
    - Mmanual_commit_opf_rewrite_test.go+1/-1
    - Mmanual_commit_test.go+2/-2
    - Mrewind_test.go+1/-1

```
424 unmodified lines

### Example Code

```python
# Seed the local branch with a checkpoint representing Alice's session.

alicesCheckpoint = id.MustCheckpointID("abcdef012345")
store = cpkg.NewGitStore(repo, cpkg.DefaultV1Refs())
if writeErr := store.WriteCommitted(context.Background(), cpkg.WriteOptions{
if writeErr := store.Write(context.Background(), cpkg.WriteSession{
CheckpointID: alicesCheckpoint,
SessionID: "alice-original",
Strategy: "manual-commit",
```  
  
#### Other Important Functions

```python
// CheckpointInfo contains summary information about a committed checkpoint.
type CheckpointInfo struct {
// CheckpointID is the stable 12-hex-char identifier
CheckpointID id.CheckpointID
}
```

---

```  
// PrecomputeTranscriptBlobs holds blob hashes for a transcript that was
// chunked and written to the object store once, for reuse across multiple
// UpdateCommitted calls sharing the same transcript content.
func PrecomputeTranscriptBlobs(ctx context.Context, repo *git.Repository, transcript redact.RedactedBytes, agentType types.AgentType) (*PrecomputedTranscriptBlobs, error) {
raw := transcript.Bytes()
```

---

```python
// The error handling demonstrates best practices applying to the checkpoint storage.
if err := store.UpdateCommitted(context.Background(), UpdateOptions{}) {
// Error handling logic
}
```

```python
// UpdateSummary updates the summary field in the latest session's metadata.
```

---

```python
{