Definitions

@@ -7,10 +7,12 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | Term | Definition | |------|-----------| | **Adom** | The platform and company. Never say "Gallia" or "Hydrogen" to users — those are internal codenames. |-| **Adom App** (aka **Workspace**) | The full web app: toolbar, panels, VS Code, profile, workcell picker. Internal codename "Hydrogen". "Workspace" emphasizes the persistent panel layout stored in Docker container layout files. |-| **Adom Viewer (AV)** | The AI GUI panel inside the Adom App. Internal codename was "Gallia Viewer (GV)". This is where Views live. A single AV server (port 8770) can serve multiple independent AV panels — each is an AV instance with its own tabs, state, and content. |-| **AV Instance** | A single AV panel running inside a Web View panel. Each instance has a unique ID passed via URL param (`?instance=<id>`). Instances are independent — their own tabs, nav history, and dropdown state. The default instance (no param) is the general-purpose AV. |-| **Panel** | A rectangular area in the Adom App (Workspace) layout — like a window pane. Each panel has a tab with a name and icon. Panels can be split, resized, moved, and closed. Types include VS Code, Web View, 3D Viewer, Schematic Editor, cameras, sensors, etc. AV runs inside a Web View panel. |+| **Adom App** (aka **Workspace**) | The full web app: toolbar, panels, VS Code, profile, workcell picker. Internal codename "Hydrogen". "Workspace" emphasizes the persistent panel layout (cloud: Docker container; under Hydrogen Desktop: the WSL2 `Adom-Workspace` distro). |+| **Hydrogen Desktop (HD)** | The Windows/macOS desktop app — the flagship Adom experience. Runs the workspace LOCALLY (Windows: the WSL2 `Adom-Workspace` distro; macOS: Lima). Bundles Adom Desktop. Ships as a signed installer; a 27-step first-run cascade sets up the workspace. |+| **Adom Desktop (AD)** | The desktop bridge app/relay: gives cloud AIs and HD hands on the user's real machine — shell, files, screenshots, KiCad/Fusion bridges, pup, the browser extension. CLI verb surface `adom-desktop <verb>`. |+| **Adom Viewer (AV)** | **DEPRECATED (2026-06)** — was the AI GUI panel (internal codename "Gallia Viewer (GV)", server port 8770). Show content via a Hydrogen **webview** instead (see Display Surfaces). The `av_*` verbs and AV Views are legacy; do not build new content on AV. |+| **AV Instance** | **DEPRECATED** with AV — was a single AV panel inside a webview panel (`?instance=<id>`). |+| **Panel** | A rectangular area in the Adom App (Workspace) layout — like a window pane. Each panel has a tab with a name and icon. Panels can be split, resized, moved, and closed. Types include VS Code, webview, 3D Viewer, Schematic Editor, cameras, sensors, etc. | | **AV2** | **DEPRECATED** — was a second AV on separate ports (8790/8791/8792). Replaced by AV instances: just open another Web View panel pointed at `?instance=<id>`. |  ## Display Surfaces (how the AI shows an app or page)@@ -23,7 +25,12 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **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 (0.1.115+). NOT a webview panel, NOT pup — its own surface, only under HD. (Renamed from the one-day short name "hdw" 2026-07-17: "hdw" invited webview/window conflation.) | | **Simple Browser** | VS Code's built-in browser page. NEVER an Adom surface — using it to show an app is a bug on every platform. | -## Views+## Views (DEPRECATED with AV)++> The Views system below was AV's mini-app catalog. AV is deprecated — new content ships as+> Adom apps shown in a **webview** (see Display Surfaces + the app-creator skill). Kept for+> reference while legacy code still mentions View IDs. The **real-view / fake-view** rules+> below REMAIN IN FORCE for all surfaces (they are not AV-specific).  | Term | Definition | |------|-----------|@@ -75,7 +82,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **adom-cli** | Rust CLI for the Adom platform API — containers, repos, users, workspaces, SSH keys, orgs. Binary at `/usr/local/bin/adom-cli`. Repo: `adom-inc/adom-cli`. | | **adom-vscode** | Rust CLI + VS Code extension for controlling code-server from Docker processes. Opens files, reveals in explorer, searches/installs extensions, starts Claude Code chats, switches UI modes. Extension runs HTTP server on port 8821. Binary at `/usr/local/bin/adom-vscode`. Repo: `adom-inc/adom-vscode`. | | **shotlog** | Rust CLI + HTTP server for chronological screenshot logging. Supports multiple named channels, clipboard paste with auto-resize, real-time WebSocket updates. Server on port 8820. Binary at `/usr/local/bin/shotlog`. |-| **pup** | Puppeteer browser control via Desktop Conduit. Opens/closes Chrome windows, reloads pages, takes screenshots, evaluates JS, flashes taskbar alerts. Commands run via `adom-desktop browser_*`. Always lowercase. |+| **pup** | Puppeteer browser control via Adom Desktop (`adom-desktop browser_*` verbs): a clean, scriptable Chrome the AI fully owns — sessions, tabs, screenshots, JS eval, taskbar alerts. The logged-out automation surface (see Display Surfaces). Always lowercase. |  ## URLs @@ -85,7 +92,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | `https://hydrogen.adom.inc/{owner}/{repo}/edit` | **Editor** — the full Adom App (Workspace) with panels, VS Code, AV, toolbar. This is what users open to work in their container. Always add `/edit` to get into the editor. | | `https://hydrogen.adom.inc/{owner}/{repo}/tree/latest/{path}` | **File browser** — browse project files in the repo. | | `https://hydrogen.adom.inc/{owner}/{repo}/blob/latest/{path}` | **File viewer** — view a single file in the repo. |-| `https://coder.{owner}-{repo}-{hash}.containers.adom.inc/` | **Direct container URL** — raw VS Code in browser, bypasses the Adom App. The hash is assigned by the platform. |+| `https://{slug}.adom.cloud/` | **Direct container URL** — raw VS Code in the browser, bypassing the Adom App (the slug is assigned by the platform, e.g. `john-galliaapril-…`). Proxied app ports: `https://{slug}.adom.cloud/proxy/{port}/`. |  **Key distinction:** `/{owner}/{repo}` is the repo page. `/{owner}/{repo}/edit` is the editor (Adom App / Workspace). Always use `/edit` when you want users to actually work in the container. @@ -93,7 +100,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in  | Term | Definition | |------|-----------|-| **Skill** | A Markdown document (SKILL.md) that teaches Claude Code how to perform a specialized task. Lives in gallia repo, deployed to ~/.claude/skills/. |+| **Skill** | A Markdown document (SKILL.md) that teaches the AI a specialized task. Distributed REGISTRY-NATIVE: skills ship inside wiki packages (an app's skill rides its package; platform-layer skills are bundled in the bootstraps, e.g. adom/hd-bootstrap) and install to `~/.claude/skills/<name>/`. Kept current by `adom-wiki pkg update` via the adom/hook. (The old model — skills living in the gallia repo — is retired.) | | **Conduit** | WebSocket bridge between containers or between container and desktop. Two types: Desktop Conduit (DeskConduit) and Container Conduit (ContConduit). | | **MCP** | Model Context Protocol — the tool interface that connects Claude to services (viewer, DigiKey, Mouser, etc.). | | **Sample data** | Pre-generated real view HTML files in viewer/samples/ used for dropdown landing pages. Ensures real-view compliance when no user data is available. |@@ -113,9 +120,9 @@ Use these names consistently in conversation, docs, CLI output, and skill files. | Name | What it is | Notes | |------|-----------|-------| | **Adom Editor** | The full Hydrogen web app (panels, toolbar, layout) | "Editor" always means this. Never call VS Code "the editor". |-| **VS Code** | The code IDE running inside the Docker container, powered by Coder's code-server | **Primary name.** Embedded as an iframe panel in the Adom Editor, or accessed directly via `https://<slug>.adom.cloud/?folder=...`. Synonyms to avoid in user-facing contexts: "code-server", "coder", "Coder.com". Use those only when discussing internals or infrastructure. Never call it "the editor" (that's Hydrogen). |-| **AV** | Adom Viewer — the AI GUI panel | Short form is fine in conversation and code. |-| **pup** | Puppeteer browser control via Desktop Conduit | Always lowercase. "Open in pup", "pup screenshot", "pup reload". |+| **VS Code** | The code IDE running inside the workspace (cloud: Docker container; HD: the WSL2 distro), powered by code-server | **Primary name.** Embedded as an iframe panel in the Adom Editor, or accessed directly via `https://<slug>.adom.cloud/?folder=...`. Synonyms to avoid in user-facing contexts: "code-server", "coder", "Coder.com". Use those only when discussing internals or infrastructure. Never call it "the editor" (that's Hydrogen). |+| **AV** | Adom Viewer — DEPRECATED | Legacy only. Show content via a webview instead. |+| **pup** | Puppeteer browser control via Adom Desktop | Always lowercase. "Open in pup", "pup screenshot", "pup reload". | | **shotlog** | Screenshot log viewer and injector | Always lowercase. CLI binary name = `shotlog`. | | **adom-vscode** | VS Code extension + CLI for controlling code-server | Hyphenated. CLI binary name = `adom-vscode`. | | **adom-cli** | Adom platform CLI (containers, repos, users, workspaces) | Hyphenated. Binary = `adom-cli`. |