Adom Hydrogen

@@ -85,9 +85,9 @@ 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 | (was) "all steps done" with no workspace | Checks the real distro first; starts fresh if it is missing | 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` | | 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 | (was) setup stuck at one step forever | Only trusts a step as running if it really is | 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 | | A console window flashes during install | A black terminal pops up | Every helper runs hidden | Not yet | | An old Adom Bridge from a previous install still running | Setup talks to a leftover | Reclaims stale processes; the uninstaller cleans up | Not yet |@@ -177,6 +177,9 @@ Each video was recorded on a test PC with the build named in its caption, sped u |---|---|---|---| | A check fails at the very end | A title that names the problem, one sentence on what to do, and one button that says what it does (for example Run setup again, or Reconnect and finish setup) | Every failure has a plain explanation; Continue anyway skips ahead; Report this problem sends us the log | Any scenario that stops | | (was) the card quoted a log line and offered Try again / Open Hydrogen / Report side by side | | Replaced on 1.0.554 | |+| The setup card reloads after setup stopped (WebView2 can do this on its own) | 1.0.564: the stop message and its buttons are still there (was: the card went back to "Preparing your workspace..." with no button, and on winvm stayed that way for hours) | Keeps the last stop message until the next run starts; the card asks for it when it loads | `port-7380-taken.sh reload` |+| Windows Update restarts the PC in the middle of setup | Hydrogen comes back at sign-in and carries on | Starts at Windows sign-in (registered by the installer) and resumes from the step it was on; on winvm (2026-10-07, 03:23) it came back, found the workspace gone and rebuilt it in 72 seconds | Seen live on winvm |+| Adom's own servers are down while you set up | Setup stops at "The editor didn't finish starting" | Run setup again (or reopening Hydrogen) picks up where it stopped once Adom is back: on winvm the step that had failed during the 2026-10-07 outage passed in 10 seconds afterwards | Seen live on winvm |  ## For developers: running the scenarios