Open general

Dock Bar return: dock-ready launch layer + the dashboard contract (adom-ui-design 1.9.1)

John Lauer · 1mo ago

Project Manager just returned to the Dock Bar curated list (adom/hydrogen-bootstrap dock/apps.json, order 100, between LBR and Parts Search), the FIRST add-back per John's TODO on adom/hydrogen-bootstrap#4. Right now the card degrades to opening this wiki page, which is correct until the app is dock-ready. To go live it needs two layers:

1. Dock readiness (the launch layer) - full reference: item 1-8 of "Make your own app dock-ready" in docs/dockbar.md on adom/hydrogen:

  • dockbar.json at this page's repo root (dock_manifest 1.2.0): webview{title,favicon}, health{url,poll_seconds,timeout_ms}, launch steps using the install-or-update pattern (adom-wiki pkg update ... || pkg install ..., never skip_if version pinning), and a say array (3-6 noun phrases teaching YOUR noun).
  • The serve verb prints a direct http://127.0.0.1:<port>/ URL (mirrored WSL2; NEVER the :7380/proxy form), self-backgrounds, and is idempotent AND version-aware (retire an older running instance, exact-argv victim match excluding self and parent).
  • The backend takes OWNERSHIP of its webview: every step runs with ADOM_DOCK_WEBVIEW and ADOM_DOCK_APP in its environment; the CLI claims the tab via adom-cli hydrogen webview open-or-refresh --name "$ADOM_DOCK_WEBVIEW".
  • Every /api/* route answers CORS Access-Control-Allow-Origin: * plus OPTIONS, and /api/status answers in milliseconds from cache with a top-level state.

2. The dashboard contract (the UI layer) - install adom/adom-ui-design 1.9.1 and adopt the six skills, same issue the whole fleet received today (item 9 of docs/dockbar.md):

  • dock-dashboard (anatomy; you are the "full app" species: your main UI is the dock target, embed the primitives in it)
  • dash-header (HUMAN name: the page title currently reads "adom-project-manager", a slug echo; the header says "Adom Project Manager"; version in the popover never the bar; outline icons only, cog = settings-cog-outline.svg)
  • say-strip ("Say it" heading, quoted phrases, TWO buttons per phrase: Copy + Send to AI via your backend POST /api/say-send -> panel /ai-threads/new + run-prompt, NEW threads only, tag dock:adom-project-manager)
  • dash-demo (one guided demo: play/pause/prev/next/exit toolbar, pre-created adom-tts mp3s, audio ON by default + mute, ab captions synced at bridge DEFAULT size)
  • status-leds (compact pill row, prose on tap, red carries its next step)
  • newbie-graduation (scaffolding folds on dismissal / 3 green launches / first AI-driven action; ? recalls)

Also update this page's title to the human name and give it a current hero (the dock card shows exactly the page's hero + brief). Cold-verify on ConfRoomROG follows your first dock-ready ship; ping the ah dock-bar thread when it is up.

0 Replies

Log in to reply.