LearnNewsExamplesServices
Frontmatter
id14589
titleDock choreography showcase: animated split/tab/auto-hide demo, NL-drivable, tour-scripted
stateClosed
labels
enhancementdeveloper-experienceai
assigneesneo-gpt-emmy
createdAtJul 4, 2026, 3:58 AM
updatedAtJul 14, 2026, 9:10 PM
githubUrlhttps://github.com/neomjs/neo/issues/14589
authorneo-fable-clio
commentsCount1
parentIssue13158
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJul 14, 2026, 9:10 PM
milestonev13.2

Dock choreography showcase: animated split/tab/auto-hide demo, NL-drivable, tour-scripted

Closed Backlog/active-chunk-3 enhancementdeveloper-experienceai
neo-fable-clio
neo-fable-clio commented on Jul 4, 2026, 3:58 AM

Context

Operator seed (2026-07-04, live): "we need stunning interactive examples with animations and a beautiful design… we could even use them for creating youtube videos." Lane 3's bar (D#14561) is ≥2 stunning PUBLIC demos; this is Demo A — buildable NOW against shipped dockZone.v1 ops, no spec gate.

The Problem

The docking substrate is real and shipped, and completely invisible: no public surface makes the story legible to a stranger. Lane 6 explicitly consumes lanes 1–3's demos as reach artifacts (the demo-to-metric loop), and the funnel-sync convergence (biz-repo, 2026-07-04) makes measurable public assets the door. A verification example (#13247) is not a showcase — different consumer, different bar.

The Architectural Reality

  • Shipped ops to choreograph: split/tab adapters, resizeSplit, setItemAutoHidden (+ drag preview, splitter resize) — src/dashboard/*, contract learn/agentos/HarnessDockZoneModel.md.
  • Consumer boundary with #13247 (Vega): his standalone example = the correctness/verification surface; this leaf = the showcase/reach surface. Both consume the same model; neither replaces the other.
  • Design-first bar: the FM-cockpit precedent (apps/agentos/design/fleet-manager-cockpit-plan.html) — design artifact before build, "flagship or embarrassment" standard.
  • Placement: NEW app files ⇒ structural-pre-flight runs at claim (candidates: an apps/ showcase app vs examples/ extension; sibling sweep decides — recorded here as the gate, not pre-decided).

The Fix

One PR delivering the showcase:

  1. Design artifact first (HTML mock, house precedent) — layout story, motion language, visual identity; reviewed before build.
  2. The choreography demo: a beautiful, themed surface where dock operations run as smooth animated transitions (FLIP-class) — split, re-tab, auto-hide/reveal, resize — hand-driven AND NL-driven (consumes the NL dock tools leaf).
  3. Scripted tour mode: a deterministic, NL-driven run that plays the full story end-to-end. The tour IS the video path: screen-record a tour run, publish — no hand-driving, reproducible takes. Public-safe content only (no client names, per standing rule).

Acceptance Criteria

  • Design artifact exists and passed review before implementation started.
  • Every shipped v1 op appears in the choreography with animated transitions; smoothness verified via observe_motion (no jank-class regressions on the demo path).
  • Fully NL-drivable: the tour executes exclusively through NL tool calls.
  • Tour mode is deterministic: two consecutive runs produce the same operation sequence (recordability requirement).
  • Public-safe; builds and runs from a fresh checkout with documented steps.
  • Cross-family review before merge.

Out of Scope

  • Perspectives + multi-window pop-out (Demo B — spec-gated sibling).
  • The e2e spec suite (sibling leaf; consumes the tour).
  • NL tool implementation (sibling leaf; this consumes it).
  • Public performance claims (inherited #13032 guardrail).

Related

Parent: #13158. Siblings (same batch): NL dock tools + Demo B + whitebox-e2e leaves. Boundary: #13247 (verification example — Vega). Consumers: Lane 6 reach (D#14561), tour recordings. Design precedent: the cockpit plan SSOT. Sweeps: live latest-20 + A2A scan 2026-07-04T01:56Z — no equivalent, no competing claim.

Origin Session ID: fa2a6fd5-7488-4af6-a0d2-3855c86003e4 Retrieval Hint: "dock choreography showcase tour mode recordable NL-driven animations"

tobiu referenced in commit e2d39c2 - "feat(ai): deterministic tour-runner + Demo-A dock-choreography screenplay (#14640) (#14912) on Jul 10, 2026, 7:48 AM
tobiu referenced in commit 5a24e00 - "docs(dockdemo): document fresh-checkout theme build (#14589) (#15177)" on Jul 14, 2026, 9:10 PM
tobiu closed this issue on Jul 14, 2026, 9:10 PM