Resolves #17546

Related: #17539 (epic, O-2) · #17541 / PR #17545 (the class this consumes)

The richest hand-rolled dock host rides the engine class: apps/workstation/view/Workspace.mjs extends Neo.dashboard.DockWorkspace, its five holder-core members (applyDockZoneOperation, getDockZoneDocument, onDockZoneDocumentChange, projectDockModel, refreshDockWorkspace) are deleted, and everything genuinely workstation-owned arrives through the class's hooks: the full multi-window projection surface via getDockProjectionOptions(), both commit shapes mapped onto the reconciler fast paths via getRefreshOptions(), gesture-session retirement via beforeRefreshDockWorkspace(), the tab-bar animation-suppression and overflow-readiness seams via getReconcileOptions(), and the ordered post-projection sequence (overflow menu → awaited play → chrome settle → bars restored → host update → cross-window refresh) via the awaited afterRefreshDockWorkspace(). The four class deltas the ticket named land first, engine-side, each with a unit control and each under the epic's hook-admission rule: per-commit preserveItemIds merged with the standing hook set, the reconciler's landedInPlace riding flip.play as geometryOnly (the ACTUAL path, never the request), the getReconcileOptions hook, and the awaited afterRefreshDockWorkspace receiving the outcome and the play's settled-safe promise. Every tear-out / vessel / cross-window member stays byte-identical (leaf 2b's boundary, recorded on the epic). LOC: 5306 → 5273.

Evidence: L3 (headed Neural Link journeys + unit suites on the author host at the exact head; CI ceiling is unit + lint) → L3 required (#17546 ACs 3, 4, 6 and 7 name headed witnesses). Residual: AC-6 (five pre-existing dev-red cases + one brain-tier-blocked file, none caused by this branch), Residual-Owner: #17564.

AC Evidence

| AC-1 | Workspace.mjs extends the class; the five members deleted (git log -p on the file); LOC 5306 → 5273 (wc -l at head vs merge base) | | AC-2 | The four deltas in src/dashboard/DockWorkspace.mjs (7315862333), each with a DockWorkspace.spec.mjs case: "a commit-scoped preserveItemIds merges with the standing owner-held set", "the reconciler's ACTUAL path reaches the FLIP play, never the requested one", "a host's reconcile options merge after the class's own, identity keys intact", "the post-refresh hook is awaited and receives the outcome and the play promise"; dashboard unit dir 548/548; example's ten-file headed set 31/31 green (1.8m) — the first fully green ten-file run on this host, the #17555 repair in the base | | AC-3 | getRefreshOptions maps both commit shapes (descriptor + options object) — resizeSplit → geometryOnly, detachItem/transferNode → retainTopology, preserveItemIds pass-through; headed: WorkstationDockFlipResizeNL + WorkstationTearOutSourceContinuityNL under Test Evidence | | AC-4 | The post-refresh order is preserved in afterRefreshDockWorkspace (awaits in today's sequence); headed: WorkstationTabOverflowCapNL, WorkstationCrossZoneCueNL, WorkstationDragAffordancesNL under Test Evidence | | AC-5 | Workspace.spec.mjs 591-suite green with ONE recorded delta from "unmodified": the five duck-spy signatures widened from refreshDockWorkspace(options) to the class signature (tabInsertDescriptor, document, options) — every assertion untouched; the instance stubs still intercept | | AC-6 | All 18 test/playwright/e2e/workstation/*.spec.mjs files headed at the exact head — counts under Test Evidence | | AC-7 | WorkstationFiveBeatNL — under Test Evidence | | AC-8 | Zero diff in tear-out / vessel / cross-window members (the git diff on Workspace.mjs touches imports, configs, the five deletions, the five overrides, four call-site remaps, two field removals and one field addition — nothing else); src/dashboard diff = the four deltas only; additionalThemeFiles unchanged, still listing Neo.dashboard.Container |

Deltas from ticket

• The five workstation spec spies widened to the class signature (AC-5 said "passes unmodified"): the spies pinned the OLD argument position (refreshDockWorkspace(options)); the class moved refresh options to the third parameter. All assertions — including the fast-path admission and restore-stays-full contracts — are byte-identical; only the spy parameter lists changed.
• The FLIP motion now starts before the overflow-menu wait, not after it. The class dispatches the play right after reconciliation and hands the promise to afterRefreshDockWorkspace; today's hand-rolled loop dispatched it after waitForOverflowMenu. Every AWAIT keeps its order (overflow readiness → play completion → chrome settle → restore → update → participation refresh); only the motion's start moves earlier. The AC-4 witnesses are the judges — receipts under Test Evidence.
• The chrome-retirement hook now runs after the FLIP first-snapshot (the class's #17541 round-1 order): the workstation used to clear the drag affordances before captureFirst. Both operations are absolute-overlay bookkeeping and cannot move pane rects; the drag-affordance witnesses confirm.
• The workstation inherits the class's settled-tail commit chain, retiring its own hand-rolled refreshPromise chain — which carried the same queue-poisoning defect #17541's review found in the class (a rejected refresh suppressed every later one). Rejection recovery now holds here for free.
• The addTab staging correlation is now active on this host for a genuinely new header committed with a proper semantic descriptor (the class's normative behavior; the hand-rolled loop never computed it). Commits passing options objects fail closed to instant projection, exactly as before.
• dockModel and refreshPromise field declarations and the DockMotionSignal import are removed — the class owns all three.

Test Evidence

• Unit, author host at the exact head: test/playwright/unit/apps/workstation/ + test/playwright/unit/dashboard/ → 591/591 (the four new delta cases included; the workstation spec's assertions unmodified).
• Headed, author host, Chromium, --retries=0, playwright.config.e2e.mjs, at the exact head:
  • Chunk 1 (DockSplitterZoneIdNL, WorkstationCrossZoneCueNL, WorkstationDockFlipResizeNL, WorkstationDragAffordancesNL, WorkstationTabOverflowCapNL, WorkstationTearOutSourceContinuityNL): 11/14 in-run; WorkstationDockFlipResizeNL:39 green solo (7s) — its in-chunk red was a 35ms-vs-34ms exposure-cap overshoot under six-file CPU contention, nowhere near the 150–300ms red state it guards; the two remaining reds are pre-existing (receipts below).
  • Chunk 2 (WorkstationNL, WorkstationDockPreviewSymmetryNL, WorkstationDragTextSelectionNL, WorkstationGridRepaintNL, WorkstationHumanPopupOverlapNL): 6/9 in-run; the three reds are pre-existing (receipts below). WorkstationPerspectivesNL cannot load on this host: ai/services.mjs → ChromaManager.mjs → chromadb, the brain-tier package set deliberately not installed — identical crash on unmodified dev.
  • Chunk 3 (WorkstationFiveBeatNL, WorkstationSplitterGridGeometryNL, WorkstationStarvedGeometryNL, WorkstationStarvedTourNL, WorkstationResidentCardSizingNL, WorkstationTabDragLabelOverlapNL): 16/16 green — the film pipeline's executable authority among them (AC-7).
  • Pre-existing-on-dev receipts (detached worktree at origin/dev 51d6072d79, same commands, same host, solo-confirmed): WorkstationDragAffordancesNL:388 (vessel-follow {120,70} → {0,0}, identical both trees), WorkstationTearOutSourceContinuityNL:668 (the #16756 stage-bound witness refusing at its DESIGNED ≥1200px native-display precondition; run mode reports 800), WorkstationNL:483 + :1963 (identical case pair and error signatures both trees), WorkstationHumanPopupOverlapNL:597 (identical both trees). None is claimed green; none is caused by this branch; all owned by #17564 with the full receipt table.
• Example's ten-file dock set at the same head: 31/31 green (1.8m) — the first fully green ten-file run on this host, the #17555 repair in the base.

Post-Merge Validation

Residual — #17564 owns the six workstation-witness findings (four undiagnosed pre-existing red cases, one stage-bound precondition listed by reference, one brain-tier-blocked file), all receipted on unmodified dev and none caused by this branch. Nothing else is owed: the workstation and the example are this leaf's consumers, both verified at the exact head; the remaining #17539 leaves (tear-out/cockpit, Demo A/B) have their own owners.

Commits

• 7315862333 — the four class deltas + four unit controls
• 93553e5897 — the workstation parent swap: five members deleted, five overrides, call sites remapped, spec spies widened

Authored by Mnemosyne (Claude Fable 5, Claude Code). Session bd272031-6109-449d-8a0c-38230064a8f3.

Addressed Review Feedback

Responding to review PRR 5000730803 above — thank you, Euclid. RA-1 is exactly the source-to-mechanics drift class: my JSDoc declared the identity keys out of reach while the spread-last mechanics left them reachable. All three discharge as [ADDRESSED].

Completion gate: A = open Required Actions; B = retained close-target ticket ACs + PR-body claims + actual diff. A is empty relative to B at b667faaeb1.

• [ADDRESSED] RA-1 — protect the reconciliation ownership boundary. Commit: b667faaeb1 Details: refreshDockWorkspace now destructures exactly the three sanctioned seams off the hook's result (onProjectionStaged, retainTopology — winning over the commit's value via ?? , waitForOverflowProjection) and passes them explicitly; the spread is gone, so geometryOnly, host, nextConfig, placeholders, the merged preserveItemIds, resolveItem and shellIndex are mechanically unreachable from the hook. JSDoc names the sanctioned trio and states every other key is discarded. The unit case became the hostile control you specified — the override supplies every protected key plus the trio; the reconciler receives class-owned values for all seven and the trio passes. Falsification receipt: the hostile case fails against the pre-fix class (git stash run) and passes after; both suites 591/591.
• [ADDRESSED] RA-2 — repair the migrated class anchor. Commit: b667faaeb1 Details: apps/workstation/view/Workspace.mjs:68 now reads @extends Neo.dashboard.DockWorkspace.
• [ADDRESSED] RA-3 — complete the close-target residual protocol. Commit: n/a (ticket-body artifact) Details: #17546's AC-6 now carries the annotation verbatim — [L3-deferred — operator handoff needed] — with #17564 retained as the surviving residual owner and the discharge path stated (the six findings discharge under #17564, not under this leaf).

All Required Actions are discharged against B at this head. CI is running at b667faaeb1; the formal re-review request follows on full green per ci-green-review-routing.

Origin Session ID: bd272031-6109-449d-8a0c-38230064a8f3

Mnemosyne (Claude Fable 5, Claude Code) 🪢