Adom Hydrogen

@@ -23,6 +23,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u | Expired Adom sign-in | The saved session is rejected; Hydrogen clears it and opens a fresh sign-in while setup carries on | [video](dead-session.mp4) | `scripts/test-scenarios/dead-session.sh` | | Another WSL distro already running | Hydrogen never stops it on its own; when it needs one WSL restart it names the distro and lets you choose (1.0.559) | [video](other-distro-running.mp4) | `scripts/test-scenarios/other-distro-running.sh` | | Workspace download blocked | Setup stops in seconds and says your network is blocking Adom's download server (1.0.557) | [video](image-download-blocked.mp4) | `scripts/test-scenarios/image-download-blocked.sh` |+| Another app holding the editor's port | A Windows app on 127.0.0.1:7380: from a generic error, to wrong advice, to naming the app in 20 seconds (1.0.560) | [video](port-7380-taken.mp4) | `scripts/test-scenarios/port-7380-taken.sh` |  <video controls preload="metadata" width="1080" src="setup-steps-pitfalls/wsl2-from-scratch.mp4" style="max-width:100%;height:auto"></video> @@ -60,6 +61,10 @@ Each video was recorded on a test PC with the build named in its caption, sped u  *Workspace download blocked, 1.0.556 then 1.0.559: from the wrong advice to a plain explanation.* +<video controls preload="metadata" width="1080" src="setup-steps-pitfalls/port-7380-taken.mp4" style="max-width:100%;height:auto"></video>++*Another app on the editor's port, 1.0.556, 1.0.559 and 1.0.560: Hydrogen now asks Windows who is listening and names the app.*+ ## 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.@@ -132,7 +137,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u | Pitfall | What you see | What Hydrogen does | Tested by | |---|---|---|---| | Windows can't reach the editor | "Windows could not reach the workspace: a VPN, security tool or firewall" | Three repair rounds, then the network fix, then a clear diagnosis | `wsl-network-blocked.sh` |-| Port 7380 already taken by a Windows app | 1.0.558: "Another app is using Hydrogen's editor port. Port 7380 is in use by *app name* on Windows... Close it, then run setup again." (was: the generic "Setup didn't finish", verified on 1.0.556) | Asks Windows which app is listening and names it; an app inside the workspace was already named | `port-7380-taken.sh` |+| Port 7380 already taken by a Windows app | 1.0.560: "Another app is using Hydrogen's editor port. Port 7380 is in use by *app name* on Windows, and Hydrogen's editor needs it. Close *app name*, then run setup again." within about 20 seconds (was: the generic "Setup didn't finish" on 1.0.556; on 1.0.559 the stranger fooled an early check, the editor pane loaded it, and the card said "run wsl --unregister") | Asks Windows which app is listening before trusting the port, at every step that checks it, and stops without retrying | `port-7380-taken.sh`, [video](port-7380-taken.mp4) | | The editor listening on your whole network | (was) a passwordless editor visible on your Wi-Fi | Listens on this PC only, and moves older installs over at launch | ralph `codeserver.localhost_only` (adom/hydrogen#100) | | The editor waits for your Adom sign-in | "Waiting for you to finish signing in to Adom" | Waits as long as you need | `hd-vm-test.sh` | | The editor's extension never starts | "The editor didn't finish starting" | Run setup again restarts it | Not yet |

⋯ 1 unchanged line ⋯