Serialize restore recovery and rebase manifest paths

2026-08-10 21:01:28 +00:00
parent 4158394dcf
commit 8375ad83f3
14 changed files with 581 additions and 78 deletions
--- a/docs/operations.md
+++ b/docs/operations.md
@@ -283,6 +283,12 @@ Optional:

 Restore writes an execution report at `reports/restore-latest.json`.

+If restore fails after beginning installation, it leaves a durable
+`.restore-incomplete.json` marker in the session root. Pipeline runs will stop
+until you rerun the same restore command and it completes. Restore intentionally
+does not try to roll back files already installed; retrying the selected remote
+snapshot is the recovery procedure.
+
 ## Local State Layout

 Session root: