Adom Hydrogen

For the Windows owner. Found on the Linux port (hl-ubuntu, tester batch 21). The code is shared, so Windows Hydrogen has the same break.

What the user sees

Project workspaces menu > Show me how it works: the first caption shows, the menu closes, and then the tour stops. Nothing else happens, and every later try fails the same way.

Why

• The tour's example bench, kcknox/ztest-bench-lite, is no longer on the wiki: adom-wiki repo clone answers PAGE_NOT_FOUND. kcknox/ztest-bench-kicad is gone too.
• The failed clone leaves an empty ~/project/ztest-bench-lite folder in the workspace.
• The clone step only runs when that folder is missing ([ -d ztest-bench-lite ] || adom-wiki repo clone ...), so every later run skips the clone and stops again.
• The code is src/lib/stores/projectWorkspaces.ts (TOUR_BENCH, the Apply beat of runWalkthrough), shared by every platform.

The fix (on the linux branch of adom-inc/hydrogen-desktop; port it to main)

• https://github.com/adom-inc/hydrogen-desktop/commit/ff40533e, the fallback:
  • The tour tries kcknox/ztest-bench-lite, then john/example-bench (public, no bridges, the layout from the Project workspaces demo video).
  • Each clone is checked: the folder must hold hydrogen/workspace.json, and an empty folder is removed.
  • A missing example gets a warning toast ("Walkthrough: example bench missing: kcknox/ztest-bench-lite (it is no longer on the wiki). Using john/example-bench instead."). If none can be fetched, the tour stops with an error toast.
  • The hydrogen-project-workspaces skill and the /workspaces/apply API example now point at john/example-bench.
• https://github.com/adom-inc/hydrogen-desktop/commit/b361bb24, two related bugs the first fixed run exposed (also shared code):
  • The tour applied in replace mode whatever the "Keep my other tabs open" box said. A demo now always merges, so it never closes the user's tabs.
  • A replace-mode Apply records the layout while its own "Workspace apply" console tab is open, so Unload restored that console as a lasting tab. Unload now closes restored consoles.

Verified on hl-ubuntu (b361bb24)

The tour runs end to end: the menu caption, the missing-example toast, Apply ("mode: merge, created: KiCad bridge, Example bench"), then Unload ("removed: KiCad bridge, Example bench"). The tab list is identical before and after. Not yet run on a Windows machine.

For a Windows machine today

If a user already ran the tour, an empty ~/project/ztest-bench-lite may be sitting in their workspace. The fix removes it on the next run.