dsh-checkpoint-rewind

Configuration

All tunables are Schemastery Config fields (changeable from cordis.yml). Nothing is hardcoded.

Key	Default	Meaning
enabled	true	Master switch; false removes the commands, listeners, and providers entirely
provider	auto (worktree in the shipped bundle patch)	Snapshot provider: worktree · auto (git if available, else copy) · git · copy
gitBin	git	Git executable path
snapshotDir	$DSH_HOME/dsh-checkpoint-rewind (fallback ~/.dsh/dsh-checkpoint-rewind when $DSH_HOME is unset)	Root for copy-provider snapshots
maxSnapshots	50	Checkpoints kept per session (oldest pruned first)
maxSnapshotBytes	536870912 (512 MiB)	Global incremental-byte soft quota (newest per session always retained)
pruneOnTurnEnd	true	Run quota pruning when a turn ends
mutationTools	['bash','write','edit','str_replace_editor','pwsh','terminal_send']	Tools treated as mutating at tools/pre-execute
excludeGlobs	['node_modules','.git','.dsh','dist','build']	Glob patterns skipped by the copy provider
confirmVia	auto	Confirmation channel: auto (userQuestions first) · userQuestions · approval
listLimit	10	Checkpoints shown by bare /rewind
preRewindCheckpoint	warn	Guard checkpoint before restore: warn · require · off
verifyByHash	false	Copy-provider content-hash comparison and restore verification
autoCheckpoint.enabled	true	Automatic interval snapshots on step/start
autoCheckpoint.intervalMinutes	0	Interval; 0 = every step
workspaceRestore	restore	Workspace rollback: restore (safe overwrite) · reset-hard (CC-style, opt-in)
promptSection	true	Inject a short role-statement prompt section
checkpointTool	true	Register the checkpoint model tool

- insert:
    - id: checkpoint-rewind
      name: dsh-checkpoint-rewind
      config:
        provider: worktree
        maxSnapshots: 50
        maxSnapshotBytes: 536870912
        pruneOnTurnEnd: true
        confirmVia: auto
        preRewindCheckpoint: warn