Adom Hydrogen (platform base)

@@ -4,7 +4,7 @@   "type": "bootstrap",   "title": "Hydrogen Desktop Bootstrap (apps + skills)",   "brief": "Layer Hydrogen Desktop's workspace onto a standard Adom workstation.",-  "version": "0.2.20",+  "version": "0.2.21",   "description": "Hydrogen Desktop's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen Desktop on ANY platform: the platform-generic hd-* skills (BUNDLED in this package by design; wsl2 skills ride adom/hd-windows-bootstrap, mac skills ride adom/hd-mac-bootstrap) and the generic HD editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hd-windows-bootstrap, adom/hd-mac-bootstrap.",   "org": "adom",   "tags": [

@@ -4,7 +4,7 @@   "type": "bootstrap",   "title": "Hydrogen Desktop Bootstrap (apps + skills)",   "brief": "Layer Hydrogen Desktop's workspace onto a standard Adom workstation.",-  "version": "0.2.20",+  "version": "0.2.21",   "description": "Hydrogen Desktop's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen Desktop on ANY platform: the platform-generic hd-* skills (BUNDLED in this package by design; wsl2 skills ride adom/hd-windows-bootstrap, mac skills ride adom/hd-mac-bootstrap) and the generic HD editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hd-windows-bootstrap, adom/hd-mac-bootstrap.",   "org": "adom",   "tags": [

@@ -142,10 +142,11 @@ curl -s -X POST -H 'Content-Type: application/json' \   "$BASE/open-in-profile" ``` -- **DEFAULT to `background:true`** for anything the user just needs to SEE later. A native-  browser window jumping to the foreground over HD is jarring (it happened on setup). The-  ONLY foreground open is an AUTH consent the user must click NOW (`fresh:true`, and a-  `/auth/intent` URL always foregrounds regardless).+- **Background is the DEFAULT (per the governing rule) — you don't even need to pass+  `background:true`.** Omit `foregroundReason` and the window opens behind HD. A native+  browser jumping to the foreground over HD is jarring (it happened on setup). To foreground,+  pass `foregroundReason:"<why>"` (HD logs it). AUTH consents (`/auth/intent`, `oauth/authorize`,+  `claude.ai/login`) and a user-chosen picker open foreground automatically — no reason needed. - **ALWAYS pass a `profileDir`** from `/browser-profiles` so the window carries the user's   login. `browser:"default"` with no profile lands them logged-OUT. - **NEVER** open a signed-in page with a bare OS-default open (`open::that`) or the VS Code@@ -167,10 +168,13 @@ Pup; otherwise the user's last choice for that domain. See `hd-browser-picker`.  **Fresh window (`"fresh":true`)** — the native-browser path (#4) can open the URL either as a tab in an already-running browser (default) or as a **brand-new window/-process** (`--new-window`). A freshly-launched window **auto-foregrounds** on Windows;-a tab does not. So for **auth flows the user must complete** (Claude/Adom sign-in),-prefer `fresh:true` — the consent page comes to the front by itself, no manual focus.-The Browser Picker defaults the "Open in a fresh window" toggle ON for auth URLs.+process** (`--new-window`). `fresh` is about window-vs-tab; it is **NOT** a foreground+switch — the governing rule still applies, so an AI `fresh` open is demoted to the+background unless it's an auth consent or you passed a `foregroundReason`. (Windows *tries*+to auto-foreground a freshly-launched window; HD sinks it back down when the open isn't+justified.) So for **auth flows the user must complete** (Claude/Adom sign-in) the consent+comes to the front by itself (auth is the justified case); for everything else, `fresh`+without a reason stays background. The Browser Picker defaults the "fresh window" toggle ON for auth URLs. On `/open-url`, `fresh` pre-seeds that toggle (the picker still shows; add `direct:true` to skip it); `/open-in-profile` opens fresh directly. See `hd-browser-picker`.