Definitions

@@ -6,14 +6,11 @@ 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** | The platform and company. Never surface internal codenames to users. | | **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). Superseded (with all of AV) by webviews; historically: another webview panel pointed at `?instance=<id>`. |  ## Display Surfaces (how the AI shows an app or page) @@ -25,45 +22,6 @@ 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 (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 |-|------|-----------|-| **View** | A mini-app/tab inside AV. Each View has a View ID (e.g., SymView, FpView). Views are like apps on a desktop OS — each has its own icon, author, and real interactive content. |-| **View ID** | The short identifier for a View (e.g., SymView, Fp3dView, DkSearch). Used in code and the dropdown. |-| **real-view** | A keyword and enforcement rule meaning: always use the ACTUAL running view/app, never a fake mockup, placeholder, or approximation. This applies everywhere — dropdown landing pages, wiki submissions, demos, screenshots. If you're about to create an HTML page that *looks like* a view but isn't the real app, STOP — that's a fake. Use the real app with sample data instead. See av-creator skill Rule #2. |-| **fake-view** | Any static SVG/HTML/screenshot that approximates a real view but doesn't run the actual app code. Fake-views are BANNED. Examples: a hand-drawn SVG of a symbol instead of loading the real symbol viewer; a placeholder with "Ask Claude to..." text; a generated mockup that looks similar to the real thing. |--## View IDs Reference--| View ID | Name | What it does |-|---------|------|-------------|-| SymView | Symbol Creator | Interactive KiCad schematic symbol viewer with hover tooltips |-| FpView | Footprint Creator | 2D KiCad footprint viewer |-| Fp3dView | Footprint 3D | 3D Babylon.js pad geometry viewer (from fp-to-3d.js) |-| 3dView | 3D Component | STEP/GLB 3D model viewer with pad overlays and camera tours |-| Basic3dView | Basic 3D | Minimal GLB viewer — renders exactly as-is, no fixups |-| LibView | Library Review | Three-pane view: symbol + footprint + 3D side by side |-| SchView | Schematic Creator | Interactive schematic visualization with net highlighting |-| BoardView | Board Creator | Interactive board layout (2D SVG or 3D GLB) |-| DkSearch | DigiKey Search | Component search against DigiKey API |-| MsrSearch | Mouser Search | Component search against Mouser API |-| JlcSearch | JLCPCB Search | Component search against JLCPCB catalog |-| DeskConduit | Desktop Conduit | Bridge to user's local desktop (KiCad, Fusion 360, file transfer) |-| ContConduit | Container Conduit | Manage satellite containers (shell, files, monitoring) |-| GChat | Google Chat | Send/receive Google Chat messages as Kel |-| Instruments | Instrument Viewer | Live oscilloscope/DAQ waveform display |-| InstaPCB | InstaPCB | PCB fabrication quotes and DFM checks |-| PcbDesign | PCB Design | tscircuit-based PCB design |-| MovieMaker | Movie Maker | Record narrated video walkthroughs |-| SkillsMap | Skills Map | Visual map of all available skills |-| Prefs | Preferences | User preferences for symbol creator etc. |- ## Creators and Services  | Term | Definition |@@ -73,7 +31,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **footprint-creator** | Skill that generates .kicad_mod files and viewer HTML. | | **fp-to-3d.js** | CLI script that generates Babylon.js 3D pad viewer HTML from .kicad_mod files. | | **3dcomponent-creator** | Generates STEP/GLB 3D component models. |-| **library-creator** | Creates all three artifacts (symbol + footprint + 3D) and shows them in LibView. |+| **library-creator** | Creates all three artifacts (symbol + footprint + 3D) and shows them in a webview. |  ## CLI Tools @@ -89,10 +47,10 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | URL Pattern | What it is | |-------------|-----------| | `https://hydrogen.adom.inc/{owner}/{repo}` | **Repo page** — shows repo info, container status, README. Not the editor. |-| `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}/edit` | **Editor** — the full Adom App (Workspace) with panels, VS Code, 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://{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}/`. |+| `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-myboard-8v0y…`). 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. @@ -100,7 +58,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in  | Term | Definition | |------|-----------|-| **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.) |+| **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. | | **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. |@@ -121,7 +79,6 @@ Use these names consistently in conversation, docs, CLI output, and skill files. |------|-----------|-------| | **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 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`. |@@ -140,8 +97,6 @@ The following names are used internally in code, repos, and infrastructure. **Al | Internal Name | Public Name | Where you'll see the internal name | |---------------|-------------|-------------------------------------| | **Hydrogen** | **Adom Editor** (or just "Editor") | Repo paths (`hydrogen.adom.inc`), API endpoints, workspace control skill |-| **Gallia** | **Adom** | GitHub repo (`adom-inc/gallia`), skill/service source paths |-| **GV** | **Adom Viewer (AV)** | Old code comments, some variable names | | **Carbon** | (no public name — backend only) | Container registry API (`carbon.adom.inc`), `adom-cli carbon` commands | | **code-server** / **Coder** | **VS Code** | Docker infrastructure, server processes, port configs | | **conduit** | **Desktop Conduit** or **Container Conduit** | Relay server code, WebSocket bridge internals |