Definitions

@@ -8,8 +8,8 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in |------|-----------| | **Adom** | The platform and company. Never surface internal codenames to users. | | **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 App** (aka **Workspace**; team shorthand **hw** = "Hydrogen Web") | The full web app: toolbar, panels, VS Code, profile. Internal codename "Hydrogen" — the team says "hydrogen web"/"hw" to distinguish it from hd. "Workspace" also names the persistent environment itself (cloud: a Docker container; under hd: the local WSL2 `Adom-Workspace` distro). Public-facing name stays "Adom App". |+| **Hydrogen Desktop (HD)** (casual: **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>`. 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. |@@ -100,7 +100,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, ad — always lowercase in casual prose (AD in formal docs). |+| **lowercase tools** | pup, shotlog, abe, wv, nb, hdbw, ad, hd, hw — always lowercase in casual prose (AD/HD in formal docs). hw is team-internal (it exposes the Hydrogen codename) — never user-facing. | | **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. |