Adom Hydrogen

@@ -27,6 +27,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u | Damaged workspace image | Hydrogen notices the bad copy, fetches a fresh one and finishes (1.0.562) | [video](download-corrupt.mp4) | `scripts/test-scenarios/download-cache.sh corrupt` | | Download cut short | Hydrogen resumes from where it stopped and finishes (1.0.562) | [video](download-resume.mp4) | `scripts/test-scenarios/download-cache.sh resume` | | Sign-in window closed, or its link expired | Hydrogen brings the sign-in back, and after expiry opens a fresh link (1.0.565) | [video](signin-window.mp4) | `scripts/test-scenarios/signin-window.sh` |+| Workspace deleted after setup finished | Before 1.0.565 the editor waited forever; now Hydrogen notices at launch and rebuilds it | [video](workspace-gone.mp4) | `scripts/test-scenarios/state-recovery.sh gone` |  <video controls preload="metadata" width="1080" src="setup-steps-pitfalls/wsl2-from-scratch.mp4" style="max-width:100%;height:auto"></video> @@ -80,6 +81,10 @@ Each video was recorded on a test PC with the build named in its caption, sped u  *The Adom sign-in closed and then expired, recorded on 1.0.565: Hydrogen brings it back, and after the link expires it opens a fresh one.* +<video controls preload="metadata" width="1080" src="setup-steps-pitfalls/workspace-gone.mp4" style="max-width:100%;height:auto"></video>++*The workspace deleted after setup finished, 1.0.564 then 1.0.565: from stuck forever to a rebuild in about a minute and a half.*+ ## The pitfalls, by setup phase  **Tested by** names the scenario script that reproduces it on a test PC. *Not yet* means it is documented here and handled in the code, but has no automated reproduction yet.@@ -90,7 +95,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u |---|---|---|---| | ARM64 PC (Surface Pro X and similar) | Setup stops: "This PC's processor is ARM64; Hydrogen needs an x64 PC" | Stops before the 800 MB download; nothing else is changed | Not yet (adom/hydrogen#89) | | Setup started twice at once | (was) steps marked done that never ran | A lock makes the second start a no-op | Not yet |-| Saved progress says done but the workspace is gone (an uninstall and reinstall, `wsl --unregister`, a cleanup tool) | 1.0.565: setup runs again by itself and the workspace is back in about 95 seconds (was, on 1.0.564: "Your workspace is ready" next to an editor stuck on "Starting AI Environment..." forever) | At launch it checks that the workspace really exists (an instant registry read) and rebuilds it if it does not | `state-recovery.sh gone` |+| Saved progress says done but the workspace is gone (an uninstall and reinstall, `wsl --unregister`, a cleanup tool) | 1.0.565: setup runs again by itself and the workspace is back in about 95 seconds (was, on 1.0.564: "Your workspace is ready" next to an editor stuck on "Starting AI Environment..." forever) | At launch it checks that the workspace really exists (an instant registry read) and rebuilds it if it does not | `state-recovery.sh gone`, [video](workspace-gone.mp4) | | Workspace there but the editor died with an old Hydrogen | Editor stuck on "Starting" | Re-runs the workspace and editor steps | Not yet | | A step left "running" by a crash | Nothing: setup carries on | Re-runs the step on the next launch and finishes (verified on 1.0.565: done in 67 seconds) | `state-recovery.sh stuck` | | A minute of silence on a cold PC | (was) a dead panel | Reads Windows' registry instead of waking WSL, and narrates | Not yet |

⋯ 1 unchanged line ⋯