Overview
dsh-checkpoint-rewind
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- `worktree` mode requires repository-root cwd, a `snapshotDir` outside that repository, and refuses unborn HEAD, sparse checkout, unmerged paths, and submodules. It captures tracked and nonignored untracked files; ignored files and side effects outside Git (processes, databases, network calls) are not rolled back. Workspace-only rewind is rejected because continuation requires a child session in the new worktree. Restored worktrees stay locked until explicitly removed. - On rc.6, `checkpoint/*` session events are suppressed by the adaptive gate; the audit chain rides `command/run` + `command/done` plus the storage domain until a host ships the vocabulary or the `ignorable` envelope. - `confirmVia: approval` needs an open turn, and commands run between turns — mount userQuestions (or set `confirmVia: userQuestions`) on rc.6. - Session rollback creates a **new child session** seeded from the checkpoint boundary; it never rewrites or truncates the original session. - `workspaceRestore: 'reset-hard'` moves the branch head to the snapshot commit; it is off by default. - A checkpoint captured before any closed turn has no replay boundary — session rollback then creates a fresh child session with empty context.
