adom/hd-bootstrap: Hydrogen Desktop Bootstrap (apps + skills)

Hydrogen Desktop's workspace layer, as a registry bootstrap. One package that carries BOTH the dependency list (apps) and the platform-generic hd-* skills (bundled in skills/, deployed by the postinstall hook). Installing it converges a workspace to "ready to run inside Hydrogen Desktop."

adom-wiki pkg install adom/hd-bootstrap

Tooling note (2026-07-16): adompkg is deprecated. All install/update flows use the adom-wiki CLI (adom-wiki pkg ...). The golden image v17 was still baked with adompkg; v18 must bake with adom-wiki pkg (planned).

The golden WSL2 image runs exactly that install line at bake time and ships the result pre-converged. A live workspace can run the same line on demand, and adom-wiki pkg update (via the adom/hook prompt hook) keeps every package, this one included, current at runtime. The bake is an optimization of the runtime flow, not a different mechanism.

How it layers (apps as deps, skills bundled per layer)

adom/hd-bootstrap depends on adom/core and adds only what is specific to running inside HD. A layer is just a bootstrap that depends on the one below it. Each layer bundles ITS OWN skills (decision John + Kyle, 2026-07-16): skills are documentation for the layer, they live with the layer, and they install as part of the layer's package. There is no separate skills package (adom/hd-skillpack is deprecated; its content lives here now).

adom/core                        the Adom ecosystem (shared with web Hydrogen)
  └─ adom/hd-bootstrap           THIS: HD apps (deps) + platform-generic hd-* skills (bundled)
       ├─ adom/hd-windows-bootstrap   Windows/WSL2 layer + wsl2 hd-* skills (bundled)
       └─ adom/hd-mac-bootstrap       macOS sibling + mac skills (in progress, Kyle)

Tool-specific skills are NOT here: a skill that documents a tool ships inside that tool's package (the webview skill rides adom/adom-workspace-control, the pup skill rides the puppeteer bridge, the adom-google skill rides adom/adom-google). This package's bundle is HD's own manual: the hd-* skills.

This is the public reference design: other orgs build their own bootstrap the same way. A vendor publishes <org>/bootstrap depending on adom/core (plus this package only if their capability needs HD's runtime), and their users get set up by telling their AI "I use ." (The BOOTSTRAP-CONVENTION doc is not hosted on the wiki yet. TODO: publish it and link here.)

What's a dependency vs. what's in the hook

The rule: apps that are packages are dependencies; this layer's skills are bundled content deployed by the hook; environment config that isn't a package is also the hook; the OS baseline is the golden image's build (not this package at all).

Dependencies

Retired (2026-07-16): adom/adom-workspace-updater (the in-distro updater daemon; removed from adom/hd-windows-bootstrap in 0.2.3) and adom/hd-skillpack (the short-lived separate skills package; its skills are bundled HERE as of 0.2.7, hard-deleted 2026-07-16). Updates are registry-native via adom-wiki pkg update + adom/hook. The updater retirement also removes the only needs_sudo package from the tree, so the old ADOMPKG_ALLOW_SUDO=1 requirement should die with it (verify on the v18 bake).

postinstall.sh (deploy bundled skills + environment config)

Runs as the workspace user after all deps install (sudo only for the system-owned workbench file). Mirrors the config sections of hd-wsl2-image's bake-hd-setup.sh:

0. Deploy the bundled platform-generic hd-* skills (skills/ dir, 38 of them, to ~/.claude/skills/)
1. Claude Code CLI (claude.ai installer, lands at ~/.local/bin/claude)
2. Claude Code extension (Open VSX) registered in code-server
3. adom-vscode extension .vsix registered in code-server (binary from the core dep)
4. code-server settings.json (dark theme, Claude Code perms, chat/agent panel off, silent ports, git notifications quieted, no model pin)
5. code-server config.yaml (telemetry + update-check off)
6. workbench.html IndexedDB seed (trusted domains * + activity-bar unpin)
7. tidy (rm ~/project/.mcp.json)

NOT in this package (golden-image base)

apt baseline, code-server, systemd/systemd-sysv, cron, the gh CLI, user/group/linger/pam fixes. The "hardware" the bootstrap runs on. A live install assumes a workspace that already has it.

NOT in this package (per-machine, injected by HD at wsl --import)

The Carbon API key, DefaultUid=1001, the host.docker.internal alias.

Resolved / superseded decisions (history)

• ✅ Skills live IN the bootstraps (2026-07-16, John + Kyle). Supersedes the one-day experiment with a separate adom/hd-skillpack package (1.0.0-1.0.4, now deprecated). Rationale: skills are the layer's documentation, they change at product cadence, and two humans maintain them next to the layer they document. pkg update is per-package, so bundling costs only a bootstrap version bump per skills change.
• ✅ InstaPCB is EXCLUDED (2026-07-16). Supersedes the 2026-06-19 decision to include it. hd-instapcb moved out of the public bucket (InstaPCB is not releasable yet); the setup prompts no longer reference it.
• ✅ The adom/fusion-update-libraries signature blocker is RESOLVED. The v17 golden image baked and ships (adom-golden-v17.tar.gz).
• ⏳ Verify adom/core carries adom-google / adom-tts / adom-gchat so HD inherits them (planned 2026-06-19; core is now 4.13.x, confirm before the v18 bake).

Status (2026-07-16)

PUBLISHED + PUBLIC, latest adom/[email protected] (apps + skills model, 38 platform-generic skills bundled, incl. hd-webview + hd-pup; 0.2.10 = renamed hd-workspace-updater skill -> hd-staying-current; 0.2.9 was the full stale-content audit sweep). Deps resolve anonymously. Golden image v17 ships from hd-wsl2-image (baked with the deprecated adompkg; v18 re-bake with adom-wiki pkg planned, picking up this version, hd-windows-bootstrap 0.2.6, and no retired packages). Build the image on the laptop via AD or in CI, never in the cloud container.