fix(snapshot): harden side-git restore wiring

docs/ARCHITECTURE.md

@@ -165,6 +165,7 @@ drives turns through Chat Completions.
 3. While degraded/offline, new prompts are queued in-memory and mirrored to `~/.deepseek/sessions/checkpoints/offline_queue.json`
 4. Queue edits (`/queue ...`) are persisted continuously so drafts and queued prompts survive restarts
 5. Successful turn completion clears the active checkpoint and writes a durable session snapshot
+6. Agent/Yolo turns also take pre/post-turn side-git workspace snapshots under `~/.deepseek/snapshots/<project_hash>/<worktree_hash>/.git`; `/restore N` and `revert_turn` restore file state without changing conversation history or the user's `.git`
 
 ### Tool Execution
 
@@ -249,5 +250,6 @@ command = "echo 'Running tool: $TOOL_NAME'"
 - `~/.deepseek/skills/` - User skills directory
 - `~/.deepseek/sessions/` - Session history
 - `~/.deepseek/sessions/checkpoints/` - Crash checkpoint + offline queue persistence
+- `~/.deepseek/snapshots/` - Side-git pre/post-turn workspace snapshots for `/restore` and `revert_turn`
 - `~/.deepseek/tasks/` - Background task records, queue, timelines, artifacts
 - `~/.deepseek/audit.log` - Append-only audit events for credential + approval/elevation actions

docs/CONFIGURATION.md

@@ -170,6 +170,10 @@ If you are upgrading from older releases:
 - `mcp_config_path` (string, optional): defaults to `~/.deepseek/mcp.json`.
 - `notes_path` (string, optional): defaults to `~/.deepseek/notes.txt` and is used by the `note` tool.
 - `memory_path` (string, optional): defaults to `~/.deepseek/memory.md`.
+- `snapshots.*` (optional): side-git workspace snapshots for file rollback:
+  - `[snapshots].enabled` (bool, default `true`)
+  - `[snapshots].max_age_days` (int, default `7`)
+  - snapshots live under `~/.deepseek/snapshots/<project_hash>/<worktree_hash>/.git` and never use the workspace's own `.git` directory
 - `retry.*` (optional): retry/backoff settings for API requests:
   - `[retry].enabled` (bool, default `true`)
   - `[retry].max_retries` (int, default `3`)