Definitions

@@ -10,7 +10,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **The wiki** | https://wiki.adom.inc — the shared electronics wiki for the AI age: apps, skills, components, bootstraps, packages. THE distribution channel for everything Adom. Driven by the `adom-wiki` CLI. | | **Adom App** (aka **Workspace**) | The full web app: toolbar, panels, VS Code, profile. Internal codename "Hydrogen". "Workspace" also names the persistent environment itself (cloud: a Docker container; under HD: the local WSL2 `Adom-Workspace` distro). | | **Hydrogen Desktop (HD)** | The Windows/macOS desktop app — the flagship Adom experience. Runs the workspace LOCALLY (Windows: WSL2 `Adom-Workspace` distro; macOS: Lima). Bundles Adom Desktop. Signed installer; a 27-step first-run cascade builds the workspace from the golden image. |-| **Adom Desktop (AD)** | The desktop bridge/relay: gives AIs hands on the user's real machine — shell, files, screenshots, KiCad/Fusion bridges, pup, the browser extension, window control. CLI surface: `adom-desktop <verb>`. |+| **Adom Desktop (AD)** | The desktop bridge/relay: gives AIs hands on the user's real machine — shell, files, screenshots, KiCad/Fusion bridges, pup, the browser extension, window control. CLI surface: `adom-desktop <verb>`. Everyday short form: **AD** / "ad" ("is ad running?", "ask ad", "ad is back") — when a user says "ad" they mean this bridge. | | **abe** | The Adom browser extension — lets the AI drive the user's REAL signed-in Chrome/Edge (`nbrowser_*` verbs): logged-in sites, real credentials, human trust. | | **Golden image** | The pre-baked workspace rootfs (`adom-golden-vN.tar.gz`) that HD imports on first run — code-server, the Adom CLIs, extensions, settings, and all bundled skills, pre-converged via one `adom-wiki pkg install` of the platform bootstrap at bake time. The bake is an optimization of the runtime flow, not a different mechanism. | | **Setup cascade** | HD's gated first-run steps (currently 27): import the golden image, inject identity, wire the relay, install the `claude` CLI (the one runtime install), walk Claude auth, then open the welcome + named AI-thread conversations. Every step is a hard gate — it verifies its artifact or halts. |@@ -25,7 +25,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **pup** | The AI's own Chrome on the user's desktop (Puppeteer bridge via AD, `browser_*` verbs). A real, full browser window the AI fully controls: sessions (`sessionId` is the handle — task-prefix it and set `owner` so threads never steal each other's windows), many TABS in one window (preferred over window sprawl), screenshots, JS eval, taskbar flash. Opens BACKGROUND by default — `foreground:true` is the only thing that raises it; signal with a flash instead of stealing focus. Cold profiles = LOGGED OUT by design: the safe automation surface (fresh-user testing, scraping public pages, showing wiki pages). For logged-in sites use nb instead. Windows never auto-close — clean up when a task ends. Always lowercase. | | **native browser** (short: **nb**) | The user's own signed-in Chrome/Edge, driven via abe (`nbrowser_*`). For logged-in sites. "Show it in nb" == open in the user's real browser. | | **nb addressing** | `nb [browser] [profile]` names a specific browser/profile: "nb chrome", "nb edge", "nb chrome work", "nb chrome personal". Maps to the Browser Picker's native destination ids (`browser:<browser>:<profileDir>`) and the profiles abe reports. The AI resolves the profile from the user's words + `GET /browser-profiles`. |-| **hdbw** | HD Browser Window — Hydrogen Desktop's standalone built-in Tauri browser window (picker label "HD Browser Window", window label `hd-browse-*`, destination id `webview-window`). Open first-class via `POST /hdbw/open {url}` on HD's control API. NOT a webview panel, NOT pup — its own surface, only under HD. |+| **hdbw** | HD Browser Window — Hydrogen Desktop's standalone built-in Tauri browser window: a separate OS window HD manages directly (1200x800, centered, its own webview badge icon; window label `hd-browse-*`). Bigger canvas than a wv pane tab, still HD-native — NOT a webview panel, NOT pup. Open first-class via `POST /hdbw/open {url}` on HD's control API, or pick "HD Browser Window (hdbw)" in the Browser Picker (destination id `webview-window`). Only exists under HD. Graduating into a full mini-browser — URL bar, back/forward, tabs, and a move-this-tab-to-another-surface action powered by the Browser Picker (design in flight). | | **Browser Picker** | HD's canonical URL router: every link opened inside HD goes through it. Offers the surfaces above + native profiles from abe, a fresh-window toggle, a 5s auto-countdown, and per-domain memory of the user's past choice (incl. localhost:port domains). | | **Simple Browser** | VS Code's built-in browser page. NEVER an Adom surface — showing an app there is a bug on every platform. | @@ -85,7 +85,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | Rule | Detail | |------|--------| | **webview is one word** | Never "Web View". Short form: wv. |-| **lowercase tools** | pup, shotlog, abe, wv, nb, hdbw — always lowercase in prose. |+| **lowercase tools** | pup, shotlog, abe, wv, nb, hdbw, ad — always lowercase in casual prose (AD in formal docs). | | **VS Code** | The IDE inside the workspace (powered by code-server). Never call it "the editor" — the Editor is the Adom App around it. Avoid "code-server"/"Coder" in user-facing text. | | **No internal codenames to users** | "Hydrogen" (the web app) and "Carbon" (backend registry) appear in code/URLs only. Public names: Adom App / Adom. |