Definitions

@@ -7,7 +7,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | Term | Definition | |------|-----------| | **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. |+| **The wiki** (short: **aw**) | 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**; 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. |@@ -53,7 +53,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | Term | Definition | |------|-----------| | **adom-cli** | Platform CLI — containers, repos, workspaces, orgs, SSH keys, Hydrogen control (`adom-cli hydrogen …` drives panels/webviews). |-| **adom-wiki** | THE wiki CLI — pkg publish/install/update, page repos, releases, issues, PRs. (`adompkg` is dead; never use it.) |+| **adom-wiki** (short: **aw**) | THE wiki CLI — pkg publish/install/update, page repos, releases, issues, PRs. (`adompkg` is dead; never use it.) | | **adom-desktop** | AD's verb surface from any container — shell, files, screenshots, bridges, pup (`browser_*`), windows (`desktop_*`), HD control (`hd_*`). | | **adom-vscode** | CLI + VS Code extension controlling code-server (port 8821): open files, run editor commands, drive Claude Code panels. | | **shotlog** | THE show-your-work channel: a screenshot log server + CLI (port 8820). The AI cannot display images in chat — shotlog is how the human actually SEES: inject/paste shots into named CHANNELS (per task/topic), watched live in a skinny wv panel, a pup window, or on the phone. `shotlog viewers -c <channel>` verifies a HUMAN is genuinely watching (on-screen vs backgrounded vs nobody) so the AI never claims "shown" unwatched. `shotlog channels` shows what every AI thread is sharing. Ralph loops and demos log every frame here. Always lowercase. |@@ -114,7 +114,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, hd, hw — 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 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. |