Definitions

@@ -8,11 +8,12 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in |------|-----------| | **Adom** | The platform and company. Never surface internal codenames to users. | | **The wiki** / **adom-wiki** (short: **aw**) | One product, two faces: the site (https://wiki.adom.inc — the shared electronics wiki for the AI age: apps, skills, components, bootstraps, packages; THE distribution channel for everything Adom) and its CLI (`adom-wiki`). "The wiki", "adom-wiki", and "aw" all refer to it — context says whether you mean the site or the CLI. |-| **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 and bundles AD. HD-specific terms: see the Hydrogen Desktop section below. |+| **Hydrogen Web (HW)** (casual: **hw**) | The web app at hydrogen.adom.inc: toolbar, panels, VS Code, profile — the browser twin of Hydrogen Desktop. Parallel naming: hw (web) and hd (desktop) are the two faces of Hydrogen. ("Adom App" and "Workspace" are NOT names for this product.) |+| **Workspace** | The persistent environment your work lives in — panels layout, files, tooling. hw attaches to a cloud workspace (Docker container); hd runs a local one (the WSL2 `Adom-Workspace` distro / Lima). |+| **Hydrogen Desktop (HD)** (casual: **hd**) | The Windows/macOS desktop app — the flagship, publicly released face of Hydrogen. Runs the workspace locally and bundles AD. Sibling of hw. HD-specific terms: see the Hydrogen Desktop section below. | | **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. |-| **Panel** | A rectangular area of the Adom App layout — VS Code, webview, 3D viewer, cameras, sensors. Panels split, resize, move, close; each has a tab with name + icon. |+| **Panel** | A rectangular area of the Hydrogen layout (hw or hd) — VS Code, webview, 3D viewer, cameras, sensors. Panels split, resize, move, close; each has a tab with name + icon. |  ## Display Surfaces (how the AI shows an app or page) @@ -112,7 +113,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | URL Pattern | What it is | |-------------|-----------| | `https://hydrogen.adom.inc/{owner}/{repo}` | Repo page (info, container status, README) — not the editor. |-| `https://hydrogen.adom.inc/{owner}/{repo}/edit` | The editor — the full Adom App. Always add `/edit` to work in a container. |+| `https://hydrogen.adom.inc/{owner}/{repo}/edit` | The editor — full Hydrogen Web. Always add `/edit` to work in a container. | | `https://{slug}.adom.cloud/` | Direct container URL (raw VS Code). App ports proxy at `https://{slug}.adom.cloud/proxy/{port}/`. | | `https://wiki.adom.inc/{org}/{page}` | A wiki page (Overview, Files, Skills, Packages, Releases, Issues tabs). | @@ -121,9 +122,9 @@ 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, hd, hw, aw, cf — always lowercase in casual prose (AD/HD in formal docs). hw is team-internal (it exposes the Hydrogen codename) — never user-facing. |+| **lowercase tools** | pup, shotlog, abe, wv, nb, hdbw, ad, hd, hw, aw, cf — always lowercase in casual prose (AD/HD/HW 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. |+| **No internal codenames to users** | "Carbon" (the backend registry) is internal — code/URLs only. "Hydrogen" is PUBLIC brand (Hydrogen Web / Hydrogen Desktop). |  ## Coordinate System