Adom Hydrogen (platform base)

@@ -1,55 +1,85 @@ #!/usr/bin/env bash-# postinstall.sh — adom/hd-bootstrap+# install.sh — adom/hydrogen-bootstrap (the scripts.install lifecycle hook; was postinstall.sh) # # Runs (as the workspace user) after every dependency is installed —-# apps/skills install first, bootstraps (and their postinstall) last. This hook applies the HD *environment configuration* that isn't a+# adompkg installs apps/skills first, bootstraps (and their postinstall)+# last. This hook applies the HD *environment configuration* that isn't a # package: the Claude Code + adom-vscode extensions, and the VS Code / code-server-# settings that make the editor behave like Hydrogen Desktop.+# settings that make the editor behave like Hydrogen. # # What is NOT here, by design: #   - the Adom ecosystem (skills hub, distributor search, KiCad/Fusion, pup, #     adom-cli, adom-vscode binary, ...) — comes from the adom/core dependency-#   - the hd-* runtime skills — BUNDLED in this package (skills/ dir)-#   - the CLIs (adom-cli, adom-desktop) — their own dependencies+#   - the hd-* runtime skills — the adom/hd-skills dependency+#   - the workspace-updater daemon + the CLIs — their own dependencies #   - the OS baseline (apt, code-server, systemd, user/linger/pam) — that's #     the golden image's Dockerfile ("hardware"); a live install assumes a #     workspace that already has it. # # Idempotent + LIVE-INSTALLABLE: this must converge correctly from a cold-# `adom-wiki pkg install adom/hd-bootstrap` on an already-running workspace (the+# `adompkg install adom/hydrogen-bootstrap` on an already-running workspace (the # vendor "am I set up?" path), not only inside the golden-image bake. Re-runs # are safe. The bake runs the exact same command, just earlier. #-# Mirrors the config sections of hd-wsl2-image/image/bake-hd-setup.sh — keep-# the two in lockstep until the bake is rewritten to just install this.+# Mirrors the config sections of the golden-image bake script+# (bake-hydrogen-setup.sh in the image repo) — keep the two in lockstep until+# the bake is rewritten to just install this. set -euo pipefail log() { echo "[hd-bootstrap] $*"; }  CS="$(command -v code-server 2>/dev/null || echo /usr/lib/code-server/bin/code-server)" HERE="$(cd "$(dirname "$0")" && pwd)" -# 0. Deploy the bundled hd-* runtime skills into ~/.claude/skills/. These ship-#    INSIDE this package (HD-specific); the package's skills/ dir is the source of truth.+# 0. Deploy the bundled hydrogen-* runtime skills into ~/.claude/skills/. These+#    ship INSIDE this package (Hydrogen-specific — there is no separate skills+#    package); the package's skills/ dir is the source of truth.+#    NAMING CUTOVER (2026-08): skills renamed hd-* -> hydrogen-*. Deploy EVERY+#    bundled skill dir (no name-prefix glob to go stale again), and purge the+#    old hd-* copies a previous version deployed so the two generations never+#    sit side by side (the ab 2.0.17 lesson, issue #584 sidebar). if [ -d "$HERE/skills" ]; then-  log "deploying bundled hd-* skills"+  log "deploying bundled hydrogen skills"   install -d -m 0755 "$HOME/.claude/skills"   count=0-  for d in "$HERE"/skills/hd-*/; do+  for d in "$HERE"/skills/*/; do     [ -f "${d}SKILL.md" ] || continue     name="$(basename "$d")"     install -d -m 0755 "$HOME/.claude/skills/${name}"     install -m 0644 "${d}SKILL.md" "$HOME/.claude/skills/${name}/SKILL.md"     count=$((count + 1))   done-  log "  deployed ${count} hd-* skills"+  log "  deployed ${count} bundled skills"+  purged=0+  for d in "$HOME"/.claude/skills/hd-*/; do+    [ -d "$d" ] || continue+    rm -rf "$d"+    purged=$((purged + 1))+  done+  [ "$purged" -gt 0 ] && log "  purged ${purged} stale hd-* skill dirs (renamed to hydrogen-*)" fi +# 0b. Purge KNOWN-DEAD sibling module dirs. These are baked v22 leftovers whose+#     packages were renamed in the registry (June slug consolidation + the+#     adom-desktop -> adom-bridge rename): `pkg update` skips them forever with a+#     STALE_INSTALL warning and never deletes the folders, so every fresh install+#     carries dead names in adom_modules (John, 2026-08-09). Fixed allowlist on+#     purpose - a hook must never guess at deleting things the registry merely+#     failed to resolve transiently. Successors all install via the dependency+#     tree, so removing the corpse loses nothing.+MODULES_ADOM="$(cd "$HERE/.." && pwd)"+for dead in adom-desktop step2glb adom-theme-system adom-workspace-control; do+  if [ -d "${MODULES_ADOM}/${dead}" ]; then+    rm -rf "${MODULES_ADOM}/${dead}"+    log "purged dead module dir: adom/${dead} (renamed in the registry; successor installs via the tree)"+  fi+done+ # 1. Claude Code CLI — NOT installed here, on purpose. It's not an adompkg/wiki #    package (it's Anthropic's, from claude.ai), and its installer needs a working #    systemd user session, which is unreliable in the bake env. HD installs + auths #    it at runtime via its setup cascade (install-claude-cli + claude-auth), in the #    real workspace where the user session works. So the bootstrap leaves Claude to-#    HD. Just ensure ~/.local/bin is on PATH (for adompkg + adom-desktop).+#    HD. Just ensure ~/.local/bin is on PATH (for adompkg + the Adom CLIs). grep -q '/.local/bin' "$HOME/.bashrc" 2>/dev/null \   || printf 'export PATH="$HOME/.local/bin:$PATH"\n' >> "$HOME/.bashrc" @@ -80,13 +110,14 @@ cat > "$HOME/.local/share/code-server/User/settings.json" <<'SETTINGS'   "workbench.startupEditor": "none",   "workbench.activityBar.location": "default",   "workbench.activityBar.iconClickBehavior": "toggle",-  "workbench.colorTheme": "Default Dark Modern",+  "workbench.colorTheme": "Adom Studio Dark (Brighter Text)",+  "editor.fontSize": 15,   "workbench.statusBar.visible": false,   "workbench.navigationControl.enabled": false,   "workbench.secondarySideBar.visible": false,   "workbench.secondarySideBar.defaultVisibility": "hidden",-  "claudeCode.allowDangerouslySkipPermissions": true,-  "claudeCode.initialPermissionMode": "bypassPermissions",+  "claudeCode.allowDangerouslySkipPermissions": false,+  "claudeCode.initialPermissionMode": "auto",   "claudeCode.preferredLocation": "panel",   "chat.agent.enabled": false,   "chat.commandCenter.enabled": false,@@ -117,34 +148,35 @@ disable-update-check: true CSCONF  # NOTE: the workbench.html IndexedDB seed (trusted domains + activity-bar unpin)-# patches the WSL2 code-server install path and is therefore PLATFORM-SPECIFIC —-# it lives in adom/hd-windows-bootstrap, not here. Mac/Ubuntu layers add their own.+# patches a code-server install path that differs per host and is therefore+# PLATFORM-SPECIFIC — it lives in the platform bootstraps+# (adom/hydrogen-windows-bootstrap etc.), not here. -# 6. API-KEY PERSISTENCE (2026-08-04). /var/run is tmpfs — wiped on EVERY distro-#    boot — and HD's launch-time re-injection missed every other boot path-#    (workspace stop/start under a running HD, relay-exec auto-start, manual-#    wsl --terminate), so /var/run/adom/api-key vanished and every in-workspace-#    tool 401'd against carbon/wiki until the next HD relaunch. Fix is-#    DAEMONLESS: a systemd-tmpfiles rule (declarative, runs during sysinit,-#    before code-server) re-materializes the tmpfs key from a persistent copy-#    at ~/.adom/api-key on every boot. HD writes both copies whenever it holds-#    the session token (write-through, HD >= build a1e3b20); this section-#    installs the machinery and migrates a live key into the persistent copy,-#    so a plain `adom-wiki pkg update` retrofits already-running workspaces.-#    NO key material ships in this package — plumbing only.+# 6. API-KEY PERSISTENCE (2026-08-04). /var/run is tmpfs — wiped on EVERY workspace+#    boot — and HD's launch-time re-injection missed every other boot path, so+#    /var/run/adom/api-key vanished and all in-workspace tools 401'd against+#    carbon/wiki. Fix is DAEMONLESS: systemd-tmpfiles (declarative, runs during+#    sysinit, before code-server) re-materializes the tmpfs key from a persistent+#    copy at /home/adom/.adom/api-key on every boot. HD writes both copies when+#    it has the token (write-through); this section installs the machinery and,+#    if a live key exists but no persistent copy yet, migrates it — so a plain+#    `adom-wiki pkg update` retrofits running workspaces. No key material ships+#    in this package; only the plumbing. log "api-key persistence: tmpfiles machinery + persistent-copy migration" install -d -m 0700 "$HOME/.adom" if [ -s /var/run/adom/api-key ] && [ ! -s "$HOME/.adom/api-key" ]; then   cp /var/run/adom/api-key "$HOME/.adom/api-key" && chmod 600 "$HOME/.adom/api-key"   log "  migrated live key to persistent copy" fi-if printf 'd /run/adom 0755 root root -\nC /run/adom/api-key 0644 root root - %s/.adom/api-key\n' "$HOME" \-  | sudo tee /etc/tmpfiles.d/adom-api-key.conf >/dev/null 2>&1; then-  log "  tmpfiles.d/adom-api-key.conf installed (boot-time re-materialization)"-else-  log "  WARN: could not install tmpfiles snippet (no sudo?) — HD self-heal installs it on next start"-fi+printf 'd /run/adom 0755 root root -+C /run/adom/api-key 0644 root root - /home/adom/.adom/api-key+'   | sudo tee /etc/tmpfiles.d/adom-api-key.conf >/dev/null   && log "  tmpfiles.d/adom-api-key.conf installed (boot-time re-materialization)"   || log "  WARN: could not install tmpfiles snippet (no sudo?) — HD self-heal will retry"  # 7. tidy — install.mjs / tooling leave an empty ~/project/.mcp.json; remove it. rm -f "$HOME/project/.mcp.json" 2>/dev/null || true log "done"++# ── Retired-slug migration (John 2026-08-13) ─────────────────────────────────+# Heals pre-rename lockfile roots (hd-bootstrap, adom-desktop, ...) so the old+# wiki pages/redirects can be deleted. Idempotent, best-effort, never fatal.+bash "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/migrate-retired-slugs.sh" || true

@@ -18,9 +18,13 @@ description: >  Hydrogen's window has these regions (top to bottom, left to right): -### Title Bar-- **Left**: "jlauer12 / Hydrogen" — shows user + app name-- **Right**: CPU/RAM badges, window controls (minimize/maximize/close)+### Title Bar (frameless, 0.1.251+)+Hydrogen is a FRAMELESS window: the nav bar IS the title bar (no separate OS chrome).+- **Left**: Adom logo (the Adom menu button), then the lightbulb (sample-prompts menu, moved here 0.1.265) — drag anywhere else in the bar to move the window+- **Right**: CPU/RAM badges, profile avatar menu, then the window controls+  (minimize/maximize/close) merged into the bar's right end+- All title-bar controls share one interaction family: soft white hover wash, teal+  press, steady teal wash while their menu is open  ### Tab Bar - **VS Code** tab — the main code editor (iframe to code-server)@@ -32,8 +36,17 @@ Hydrogen's window has these regions (top to bottom, left to right): - **Right pane**: Usually webview (wiki, shotlog, etc.) - Panes are split and resizable +### Moving tabs between panes (drag-to-split, 1.0.140+)+Drag any tab and hover another pane: teal drop zones light up (Split Left / Right /+Top / Bottom, Swap, or the tab bar to add). This works over EVERY pane type,+webviews included (a glass layer covers iframes during the drag so they cannot+swallow the pointer), and exactly ONE zone pill shows at a time. Releasing on a+zone performs the move; **Escape abandons the drag** and everything returns to+exactly how it was. Right-clicking a tab offers the same splits as menu items+(a one-tab pane asks what to put in the new half via Add Panel).+ ### Setup Panel (bottom)-- Collapsible panel showing the setup-cascade steps+- Collapsible panel showing the setup-cascade steps (27 steps under the WSL2 runtime) - See `hydrogen-setup` skill for details  ## Menus@@ -41,28 +54,26 @@ Hydrogen's window has these regions (top to bottom, left to right): ### Adom Menu (top-left logo dropdown) The main menu, opened by clicking the Adom logo at the top-left. Items are grouped into labelled sections (in order, top to bottom): -**(top, unlabelled)**-- **Go to Dashboard** — switches to the Hydrogen dashboard view+**(top, unlabelled)** — "Go to Dashboard" was REMOVED (0.1.252, John 2026-07-24); don't offer it - **Settings** — opens the Settings dialog - **Ports...** — opens the port configuration dialog (see hydrogen-ports) - **API Explorer...** — opens the control-API endpoint explorer dialog  **DESKTOP** (Tauri-only — won't appear in browser-served Hydrogen; in order)-- **Adom Bridge** — brings the embedded Adom Bridge window to the foreground; bus id `adom-bridge-cli.open`+- **Adom Bridge** — brings the embedded Adom Bridge window to the foreground (taskbar); bus id `adom-bridge-cli.open` - **Zoom** — webview zoom controls (− %  +) with persistence across launches - **Fullscreen** — toggle fullscreen - **Console** — show/hide the Hydrogen debug console window-- **Developer Tools** — open the webview developer tools-- **Dev Toolbar** — show/hide the Adom Dev Toolbar window (eval-in / shot / Claude control endpoints); bus id `dev-toolbar.toggle`+- **Developer Tools** — open WebView2 DevTools. (The "Dev Toolbar" item was retired in 0.1.256 — use the API Explorer instead)  > The Bridges section / "Bridge Manager" item was removed (it was a no-op with no backing panel). For the bridge panel itself, see `hydrogen-bridges`.  **Workspace / runtime section** (section label shows live status badge: `RUNNING`, `STOPPED`, etc.)-- **Restart** — restarts the workspace (terminates and re-ensures code-server). The exact mechanism is runtime-specific.-- **Stop** — stops the workspace. The exact mechanism is runtime-specific.+- **Restart** — restarts the workspace: terminates the `Adom-Workspace` distro and re-ensures code-server.+- **Stop** — stops the workspace: terminates the `Adom-Workspace` distro.  **ADMIN**-- **Setup Steps** — opens the setup panel (the setup cascade for the active runtime); see hydrogen-setup-steps+- **Setup Steps** — opens the setup panel (the setup cascade); see hydrogen-setup-steps - **Virgin Reset** — opens the virgin reset section of the setup panel; see hydrogen-volume for what each toggle deletes - **Browser Picker Manager** — configure per-domain default browser/profile prefs; see hydrogen-browser-picker @@ -100,9 +111,9 @@ API — no CDP, no `.click()`, no selector guessing.** This is how you operate H user says "open the Ports dialog", "open About", "show settings", etc.  **Get the control URL from the discovery file** `~/.adom/hydrogen-control-url` (Hydrogen rewrites it with-the live, dynamic control port every launch; it's the host loopback, reachable from the-workspace). Read it from a file, not an env var — your Bash tool runs non-interactive shells-that don't source `.bashrc`/`profile.d`:+the live, dynamic control port every launch; it's the host loopback, shared with the distro by+WSL2 mirrored networking). Read it from a file, not an env var — your Bash tool runs+non-interactive shells that don't source `.bashrc`/`profile.d`:  ```bash CTRL="$(cat ~/.adom/hydrogen-control-url)"@@ -129,9 +140,11 @@ CTRL="$(cat ~/.adom/hydrogen-control-url)" Common ids (always `GET /ui/actions` for the live set): `adom-menu.open`/`.close`, **`profile-menu.open`/`.close`**, `ports.open`/`.close`, `settings.open`/`.close`, `api-explorer.open`/`.close`, `browser-picker.open`/`.close`, `about.open`/`.close`,-`adom-bridge-cli.open`, `setup-panel.show`, `virgin-reset.open`, `dashboard.go`,-`fullscreen.toggle`, `console.toggle`, `devtools.open`, `dev-toolbar.toggle`,-`container.start`/`.stop`/`.restart`.+`adom-bridge-cli.open`, `setup-panel.show`, `virgin-reset.open`,+**`samples-menu.open`/`.close`** (the lightbulb sample-prompts menu),+`fullscreen.toggle`, `console.toggle`, `devtools.open`,+`container.start`/`.stop`/`.restart`. (`dashboard.go` and `dev-toolbar.toggle` were+REMOVED — 0.1.252/0.1.256.)  **Menu ITEMS, not just open/close:** the profile menu also exposes per-item actions — **`profile.view`**, **`profile.repositories`**, **`profile.molecules`**, **`profile.logout`** —@@ -162,37 +175,43 @@ b64/silent) is in **[hydrogen-self-screenshot](../hydrogen-self-screenshot/SKILL ## Legacy: raw CDP clicking (deprecated fallback — the command bus above is canonical)  ⚠ The command bus (`/ui/actions` → `/ui/invoke`) is the canonical way to drive Hydrogen's UI. Before-it existed, UI was driven by CDP `.click()` on CSS selectors via the Hydrogen CDP eval channel. This-is brittle (selectors drift; multiple `localhost:1420` CDP targets) and the selectors below may-be stale. Reach for CDP ONLY for an element not yet on the bus — and the better fix is to-register it. Eval JS against the CDP endpoint (its port comes from `/discover` as `cdp`).+it existed, UI was driven by CDP `.click()` on CSS selectors via hydrogen-cdp.js. This is brittle+(selectors drift; multiple `localhost:1420` CDP targets) and the selectors below may be stale.+Reach for CDP ONLY for an element not yet on the bus — and the better fix is to register it.  ### Find and click menu items-```js-// Open Adom menu-document.querySelector('.logo-button')?.click()--// Find a menu item by text-var items = document.querySelectorAll('.dropdown-link,.menu-item');-var target = Array.from(items).find(function(e){return e.textContent.includes('Ports')});-if (target) target.click()+```bash+# Open Adom menu+echo document.querySelector('.logo-button')?.click() | node C:\Users\john\hydrogen-cdp.js++# Find a menu item by text+echo var items=document.querySelectorAll('.dropdown-link,.menu-item');+var target=Array.from(items).find(function(e){return e.textContent.includes('Ports')});+if(target)target.click() | node C:\Users\john\hydrogen-cdp.js ```  ### Click setup panel buttons-```js-document.querySelector('.run-all').click()                 // Run All-document.querySelector('.virgin-reset-btn')?.click()       // Virgin Reset dropdown-document.querySelector('.virgin-go')?.click()              // Wipe Selected (execute virgin reset)-document.querySelector('.close-btn,.setup-close')?.click() // Close setup panel+```bash+# Run All+echo document.querySelector('.run-all').click() | node C:\Users\john\hydrogen-cdp.js++# Virgin Reset dropdown+echo document.querySelector('.virgin-reset-btn')?.click() | node C:\Users\john\hydrogen-cdp.js++# Wipe Selected (execute virgin reset)+echo document.querySelector('.virgin-go')?.click() | node C:\Users\john\hydrogen-cdp.js++# Close setup panel+echo document.querySelector('.close-btn,.setup-close')?.click() | node C:\Users\john\hydrogen-cdp.js ```  ### Query step states-```js-JSON.stringify(Array.from(document.querySelectorAll('.step-row')).map(+```bash+echo JSON.stringify(Array.from(document.querySelectorAll('.step-row')).map( function(e,i){   var icon=e.querySelector('.step-icon');   return{n:i+1, s:icon?.textContent?.trim()}-}))+})) | node C:\Users\john\hydrogen-cdp.js ```  ## CSS Selectors for Key Elements