Adom Hydrogen

@@ -173,6 +173,15 @@ Measured against the live control API. Order matters: the census first (open thr 2. `GET /ai-threads/history?tag=app:<owner>/<slug>` returns `{ok, items:[{ai, id, title, updated_ms}], open_excluded}`. The id field is `id`. Staging into a closed thread means `POST /ai-threads/resume {ai, id}` first (it reopens the tab), then `run-prompt {sid: id}`; a dashboard may prefer to copy the phrase instead and say why. 3. Neither found: copy the phrase and say so. The control API is reachable from the workspace at `127.0.0.1:47084` under mirrored networking; in a cloud container it is not, and copying is the right fallback there. +### hero: override the card art++The dock card and hover preview default to the wiki page's own hero image. `hero` overrides+that with dock-specific art: either a path inside the page repo (`"hero":+"docs/img/dock-hero.png"`) or an absolute `https://` URL. Use it when the page hero bakes in+text that fights the card's caption, or when the dock deserves a tighter crop. The dock+cache-busts the image on every manifest re-resolve and on the right-click refresh actions,+so a pushed replacement shows up without the user clearing anything.+ ### The three rules that break every first attempt  Each of these was learned from a bundled bridge shipping it wrong:@@ -202,6 +211,18 @@ The curated global list (`dock/apps.json` in adom/hydrogen-bootstrap) is a list 7. A **settings window** built with the `settings-layout` skill: a cog in the upper right of the 44px header opens a dismissible modal (dimmed backdrop, never blurred), settings cards with a 3px accent edge and full-sentence descriptions, toggles rather than checkboxes, Install / Update / Uninstall rows with live consoles, and a two-click Restore defaults footer. Every dashboard shares this look so users only learn it once. 8. **Taskbar progress for long work.** Any verb that runs start to end paints a determinate progress bar on the app's Windows taskbar button, sized by the durations the app has measured for that operation (the `pup-taskbar-progress` skill is the reference; kicad, fusion and pup all ship it behind a toggle in their settings). Open-ended work driven by the AI, such as a part lookup that can take minutes, shows an **indeterminate** taskbar bar for as long as it runs, so the user always sees that something is happening without a false estimate. +9. **The dashboard contract.** The page your icon opens follows the shared anatomy in the+`adom/adom-ui-design` skillpack: the **dock-dashboard** skill is the parent contract (house+header, say strip, status pill row, then your app's own content, and the two species: bridge+launch page vs full app whose main UI is the dock target), with **dash-header** (human name+never a slug, version never inline in the bar, the standard target chip), **say-strip** (one+heading, one chip style, one Try-it: copy plus the toast "Copied to clipboard. Paste it into+any AI thread."), **status-leds** (one compact LED pill row, prose on tap, red always carries+its next step), and **newbie-graduation** (scaffolding folds after dismissal, 3 green+launches, or the first AI-driven action, and the header's ? always brings it back). Install+the pack with `adom-wiki pkg install adom/adom-ui-design`; each skill ships a copy-paste+recipe.+ Reference implementation: adom/kicad-bridge, verified green end to end. The dock's own implementation notes live in the Hydrogen source at `docs/DOCK-BAR.md`.  ## Talk to the AI