checkpoint: fix stale API references in doc comments · Entire
checkpoint: fix stale API references in doc comments
7c4c381→main·
Soph·3w ago·3 files·+5 added/-4 removed
Address Copilot review on #1495: update doc comments that named the
pre-union methods (EphemeralStore.WriteTemporary/WriteTemporaryTask,
PersistentStore.WriteCommitted) to the current Write(request) surface, and
fix a comment join mangled by an earlier rename pass (multiple// -> two lines).
Comments only; no behavior change.
Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com
Sessions
020a6a198c75View transcript
?\
Review Checkpoint Commit f16b7101Codex·GPT-5.5·1 step
Changes
3
cmd/entire/cli
checkpoint
- Mcheckpoint.go+2/-1
strategy
Mmanual_commit_condensation.go+1/-1
Mmanual_commit_git.go+2/-2
350 unmodified lines
351
352
353
354
354
355
356
357
358
350 unmodified lines
}
// PrecomputedTranscriptBlobs holds blob hashes for a transcript that was
// chunked and written to the object store once, for reuse across multiple// transcript-backfill writes sharing the same transcript content.
// chunked and written to the object store once, for reuse across multiple
// transcript-backfill writes sharing the same transcript content.
// Callers should avoid constructing this for empty transcripts; agent.ChunkTranscript
// would otherwise produce a single zero-length chunk and a hash for an empty
// blob, which downstream stores would never reference.
Mcmd/entire/cli/checkpoint/checkpoint.go+2/-1
134 unmodified lines
135
136
137
138
138
139
140
141
134 unmodified lines
// CondenseSession condenses a session's shadow branch to permanent storage.
// checkpointID is the 12-hex-char value from the Entire-Checkpoint trailer.
// Metadata is stored at sharded path: <checkpoint_id[:2]>/<checkpoint_id[2:]>/
// Uses checkpoint.PersistentStore.WriteCommitted for committed storage.
// Uses checkpoint.PersistentStore.Write with a checkpoint.WriteSession request for persistent storage.
//
// For mid-session commits (no Stop/SaveStep called yet), the shadow branch may not exist.
// In this case, data is extracted from the live transcript instead.
Mcmd/entire/cli/strategy/manual_commit_condensation.go+1/-1
20 unmodified lines
21
22
23
24
24
25
26
27
140 unmodified lines
168
169
170
171
171
172
173
174
20 unmodified lines
)// SaveStep saves a checkpoint to the shadow branch.
// Uses checkpoint.EphemeralStore.WriteTemporary for git operations.
// Uses checkpoint.EphemeralStore.Write with a checkpoint.WriteCheckpoint request.
func (s *ManualCommitStrategy) SaveStep(ctx context.Context, step StepContext) error {
_, openRepoSpan := perf.Start(ctx, "open_repository")
repo, err := OpenRepository(ctx)
140 unmodified lines
// SaveTaskStep saves a task step checkpoint to the shadow branch.
// Uses checkpoint.EphemeralStore.WriteTemporaryTask for git operations.
// Uses checkpoint.EphemeralStore.Write with a checkpoint.WriteTask request.
func (s *ManualCommitStrategy) SaveTaskStep(ctx context.Context, step TaskStepContext) error {
repo, err := OpenRepository(ctx)
if err != nil {