Adom Hydrogen (Windows / WSL2)

@@ -1,10 +1,10 @@ --- name: hydrogen-api-windows description: >--  Windows companion to hydrogen-api: the /wsl/* and legacy /docker/* endpoints,-  /system reboot, /test/probe-dialogs, WebView2 CDP notes, and host-side port-  discovery (ports.json). Use when asked about wsl status, reboot windows,-  probe-dialogs, or ports.json.+  Windows companion to hydrogen-api: the /wsl/*, /ab/*, /dock/*, /hbw/*, /widgets/*+  and legacy /docker/* endpoints, the Windows-only destructive routes, /system reboot,+  and host-side port discovery. Use when asked about wsl status, ab health, reboot+  windows, probe-dialogs, or ports.json. ---  # Hydrogen Control API — Windows / WSL2 specifics@@ -97,41 +97,51 @@ Hydrogen's webview is **WebView2** on Windows; `/cdp-eval`, `/cdp-info`, and  (Gated behind `HD_TEST_API_ENABLED=1`, like the rest of `/test/*`.) -## Moved from the generic hydrogen-api (Windows-only, 2026-10-21)+## Moved from the generic hydrogen-api (Windows-only) -These endpoints exist only in the Windows Hydrogen; the macOS app does not serve them.+These sections exist only in the Windows Hydrogen; the macOS app does not serve them. The+generic `hydrogen-api` skill (adom/hydrogen-bootstrap) is the one `hydrogen-api`; this+companion is where the Windows rows live, so the two never collide in `~/.claude/skills/`. -## ab-health diagnostics (`/ab/*`)+### Windows-only safety rules (add these to hydrogen-api's Safety section)++- **`catastrophic`** on Windows also covers `/setup/virgin-reset` and `/wsl/unregister`+  (deletes the whole `Adom-Workspace` distro, including `/home/adom/project`).+- ⛔ **REFUSED as deprecated** (headless runs with no visible UI): `POST /setup/run-all`,+  `POST /setup/run-step`, `POST /setup/virgin-reset`, `POST /virgin-reset`,+  `POST /wsl/unregister`. They return a refusal pointing at the UI-visible path: run steps+  from the Setup panel, or use its Virgin Reset (`POST /setup/panel/run-virgin-reset`).+- The legacy Docker routes `POST /container-delete`, `/container-pull-image`,+  `/image-delete` and `/volume-delete` still answer, but the workspace is a WSL2 distro, so+  there is nothing to delete or pull: they say so and point at the reset path.+- `GET /container-status` renamed two fields: `docker_available` -> **`runtime_available`**+  and `image_pulled` -> **`workspace_installed`**. The old field names are gone.++### ab-health diagnostics (`/ab/*`)  (Canonical since 1.0.47; the old `/ad/*` spellings still answer as aliases.) -These verify the **adom-bridge / relay / embedded-ab** half of Hydrogen is alive (the-bridge that connects this cloud container to Hydrogen). All GET, all return `{ok, ...}`.+These verify the **adom-bridge / relay / embedded-ab** half of Hydrogen is alive. All GET,+all return `{ok, ...}`.  | Method | Path | Description | |---|---|---| | GET | `/ab/health` | Overall embedded-ab health roll-up | | GET | `/ab/process` | Is the adom-bridge process running | | GET | `/ab/embedded` | Embedded-ab module status |-| GET | `/ab/workspace-direct` | ⭐ The **converged** check — direct path to the workspace relay (use this one) |+| GET | `/ab/workspace-direct` | ⭐ The **converged** check: direct path to the workspace relay (use this one) | | GET | `/ab/relay` | Relay (WS/HTTP) reachability | | GET | `/ab/liveness-beacon` | Liveness beacon freshness | | GET | `/ab/direct-api` | Direct-API reachability | | GET | `/ab/discovery-file` | Discovery file present + parseable | -### Workspace / WSL endpoints+## Windows-only route index -| Method | Path | Body | Description |-|---|---|---|---|-| GET | `/wsl/status` | — | WSL distro state (registered, running, code-server reachable) |-| GET | `/workspace/health` | — | Deep workspace health (distro + code-server + host reachability) |-| GET | `/virgin-reset-progress` | — | Live progress of an in-flight virgin reset |-| POST | `/workspace/terminal-profile` | — | Ensure the stable `Adom-Workspace` Windows Terminal profile (idempotent) |-| POST | `/workspace/terminal-profile/remove` | — | Remove the `Adom-Workspace` Windows Terminal profile(s) |-| POST | `/workspace/check-updates` | — | Check upstream for newer code-server + Claude extension; stage them |-| POST | `/workspace/apply-updates` | — | Apply staged code-server/extension updates + reload editor |+<!-- BEGIN GENERATED WINDOWS ROUTE INDEX --> -### Windows-only route groups+The 59 routes only the Windows Hydrogen serves, generated from the same table+`/_manifest` serves (`scripts/check-manifest-fresh.sh` fails the build if this drifts). The+platform-generic routes are indexed in **hydrogen-api**.  **Adom Bridge** (19) @@ -155,6 +165,13 @@ bridge that connects this cloud container to Hydrogen). All GET, all return `{ok - `GET /direct/health` - `GET /direct/status` +**Container / Docker (legacy)** (4)++- `POST /container-delete`+- `POST /container-pull-image`+- `POST /image-delete`+- `POST /volume-delete`+ **Dock** (6)  - `GET /dock/apps`@@ -171,13 +188,15 @@ bridge that connects this cloud container to Hydrogen). All GET, all return `{ok - `POST /editor/normalize` - `GET /editor/state` -**Hydrogen Browser Window** (9)+**Hydrogen Browser Window** (11)  - `GET /hbw/chrome` - `POST /hbw/chrome-toggle` - `POST /hbw/close` - `POST /hbw/nav` - `POST /hbw/open`+- `GET /hbw/speed`+- `POST /hbw/speed` - `GET /hbw/state` - `GET /hbw/tip` - `GET /hbw/tip-state`@@ -188,9 +207,17 @@ bridge that connects this cloud container to Hydrogen). All GET, all return `{ok - `GET /settings/external-changes` - `POST /settings/rebroadcast` -**Widgets** (7)+**Setup Cascade** (4)++- `POST /setup/run-all`+- `POST /setup/run-step`+- `POST /setup/virgin-reset`+- `POST /virgin-reset`++**Widgets** (8)  - `GET /widgets`+- `POST /widgets/card` - `POST /widgets/close` - `POST /widgets/menu` - `POST /widgets/navigate`@@ -198,3 +225,8 @@ bridge that connects this cloud container to Hydrogen). All GET, all return `{ok - `POST /widgets/refresh` - `GET /widgets/status` +**Workspace & Updates** (1)++- `POST /wsl/unregister`++<!-- END GENERATED WINDOWS ROUTE INDEX -->