docs(context): define exploration checkpoint and rewind boundaries - #250
Closed
627150795 wants to merge 1 commit into
Closed
docs(context): define exploration checkpoint and rewind boundaries#250627150795 wants to merge 1 commit into
627150795 wants to merge 1 commit into
Conversation
6 tasks
7 tasks
Collaborator
|
Thank you for preserving this research. We are closing this PR as a source record for the Execution lifecycle consolidation tracked in #277. This is not a finding that the content is wrong. The current queue contains overlapping contracts from one stale base, so we will extract only settled facts and unresolved decisions into at most one successor record, citing this PR explicitly. Please do not spend time rebasing this branch. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
OpenPI has a
context_pivotcapability, but there is no explicit design contract distinguishing recyclable exploration checkpoints and rewind from Session compaction, branch navigation, or filesystem rollback.Value
This gives contributors a safe vocabulary for recovery boundaries, branch preservation, owner responsibilities, artifact evidence, retention, and failure states without promising that provider state or external side effects can be undone.
Approach
Added a focused design document and linked it from the design index. The proposal keeps rewind append-only and branch-based, treats worktree restoration as a separate future permissioned operation, and keeps Pi as the owner of Session history and compaction.
Validation
git diff --cached --checkbun run lintbun run typecheckImpact
Documentation-only; no runtime, API, Git-ref, filesystem, or persisted-data behavior changes.
Fixes #154