Skip to content

Carry whole checkpoints across sessions; capture source excerpts by default - #21

Merged
jbwinters merged 3 commits into
mainfrom
fix/continuity-capture-recall-20261110
Nov 12, 2026
Merged

jbwinters merged 3 commits into
mainfrom
fix/continuity-capture-recall-20261110

Conversation

@jbwinters

Copy link
Copy Markdown
Contributor

Two commits.

Carry whole checkpoints across sessions and survive killed sessions

  • Hot continuity delivers larger checkpoints and names the memory-hot command in injected context.
  • A PostToolUse hook records evidence as tools complete, so a session that is killed keeps what it read.
  • Bounded workspace command output is captured as evidence.
  • memory-search falls back to local memory.

Capture source excerpts by default

  • CROSSHEAD_CAPTURE_SOURCE_EVIDENCE is on unless set to 0.
  • The README section "Choose what memory can retain" states what is retained, where it can be sent, the limits of the secret filters, and how to turn it off.

Why: in a 540-trial handoff study the released client passed 12 of 48; with these changes and excerpt capture off, 24 of 48; with capture on, 48 of 48, and 78 of 80 on fresh seeds (the two misses were provider capacity errors).

Checks: typecheck clean; 490 tests pass locally.

A session that received a cut-off hot checkpoint had no way to read the rest,
and a session killed mid-turn left nothing behind.

- Deliver the saved checkpoint in pages: the first inline on a session's first
  prompt, the rest through a new checkpoint-page bridge command named in the
  prompt. Later prompts keep the small excerpt.
- Keep findings up to 12,000 characters and always select the most recent
  explicit save. Every stored checkpoint is trimmed to the hot-sync replica
  budget so a checkpoint valid locally is valid to sync.
- With source evidence capture enabled, checkpoint each finished tool call
  through new PostToolUse (and Claude Code PostToolUseFailure) hooks, keep
  bounded output of project-tool commands run in the workspace, and recover
  files read through globs, loops or a batch that fails at its last step.
- Mid-turn snapshots supersede each other in the synced document and never
  trigger archiving or warm promotion.
- Local-only profiles answer memory search from local checkpoints, confined to
  the caller's workspace.
A fresh session that received only a summary of earlier work could not
recover the exact rules it had read. In a 540-trial continuity study the
same client passed 24 of 48 handoffs with excerpt capture off and 48 of
48 with it on.

Capture of bounded workspace-read and command-output excerpts is now on
unless CROSSHEAD_CAPTURE_SOURCE_EVIDENCE=0. The README states what is
retained, where it can be sent, the limits of the secret filters, and
how to turn it off.
@jbwinters
jbwinters merged commit efddc38 into main Nov 12, 2026
9 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant