LearnNewsExamplesServices
Frontmatter
id16322
titleRelocate the dockdemo child-app out of the agentos FM app
stateClosed
labels
enhancementairefactoring
assigneesneo-opus-grace
createdAtAug 2, 2026, 2:32 AM
updatedAtAug 23, 2026, 8:23 PM
githubUrlhttps://github.com/neomjs/neo/issues/16322
authorneo-fable
commentsCount9
parentIssuenull
subIssues
17577 The dock demos move to examples/, Mission Control stays with the product
subIssuesCompleted1
subIssuesTotal1
contentTrust
projected
quarantined0
signals[]
blockedBy[x] 17504 examples/dashboard is both a leaf app and a parent of nested apps
blocking[]
closedAtAug 23, 2026, 8:23 PM

Relocate the dockdemo child-app out of the agentos FM app

Closed Backlog/active-chunk-11 enhancementairefactoring
neo-fable
neo-fable commented on Aug 2, 2026, 2:32 AM

Context

Operator directive (2026-08-02): demos do not belong inside the real Fleet Manager app — they belong in examples/ or their own apps/ entry. Live surface: apps/agentos/childapps/dockdemo/index.html?demo=b (in active use tonight — Iris's #16309 work and Phoebe's Demo-B perspective/undo leaves target it).

Duplicate sweep (2026-08-02T00:30Z, latest-open + keyword): no existing relocation ticket. #15614 (decompose DemoBWorkspace into composed host modules) is the decomposition sibling, not relocation. Phoebe's #16315/#16316 build specs against the current location — coordinate, don't collide.

The Problem

FM (apps/agentos) is the product surface. A demo child-app living inside it couples demo lifecycle to the product app, ships demo code with the cockpit, and muddies what the flagship IS. The workstation set the precedent the other way: promoted OUT of demo-hood into a standalone app (#15144).

The Architectural Reality

  • apps/agentos/childapps/ holds dockdemo + widget; DemoB is the cross-window wiring precedent source (the July sibling-lift map lived on it).
  • In-flight consumers: #16315/#16316 (L2/L3 of epic #15252) add perspective + undo/redo spec witnesses on Demo B — new specs should not deepen location coupling.

The Fix

Relocate dockdemo (and evaluate widget) to examples/ or a standalone apps/ entry — the destination decision runs through structural-pre-flight at pickup, not here. Migrate references, specs, and links; leave the FM app demo-free. Execution timing: post-video per operator sequencing — but claimants of #16315/#16316 should shape new code knowing the move is coming.

Acceptance Criteria

  • Destination chosen via structural-pre-flight (sibling precedent: #15144 workstation promotion) and recorded on this ticket.
  • dockdemo relocated; all imports/URLs/specs/docs migrated; e2e green at the new location.
  • apps/agentos contains no demo child-apps (widget disposition recorded: moved or justified-in-place).
  • #16315/#16316 surfaces reconciled (their specs travel with the demo).

Out of Scope

  • DemoBWorkspace decomposition (#15614).
  • ADR-0029 renaming — operator, same note: 0029-harness-docking-design.md starts with "harness", which is wrong for the generic dashboard/docking system meant to be used anywhere; that is a separate post-video ticket to be authored with the ADR read in-context (unfiled as of this sweep; deliberately not buried here).

Related

#15614 (decomposition sibling) · #16315 / #16316 (in-flight consumers) · #15144 (workstation promotion precedent) · #15252 (flagship-film epic — demo surfaces feed its beats)

Unclaimed; post-video execution window.

Origin Session ID: 355d67d5-9abc-4497-a9e8-937265636376 Retrieval Hint: "dockdemo relocation out of agentos FM app post-video"

tobiu referenced in commit d3f7d5a - "The dock demos leave the Fleet Manager app (#17562) on Aug 23, 2026, 12:12 AM