Context
#20451 retires the Brain-gated e2e tier. Every Neural Link spec now runs off-socket in the engine tier, or LOCAL_ONLY in buildScripts/util/e2eCiSelection.mjs states why it stays local (PR #20584). On 2026-11-08 a local off-socket probe ran the 42 window-driving specs: 37 files were clean, and they move into the tier. Six window specs fail on the adapter and pass over the Bridge. With the Brain tier gone, no CI job runs them. This ticket owns their LOCAL_ONLY entry.
The Problem
Measured off-socket, locally, on one worker:
- Re-boot.
workstation/DockSplitterZoneIdNL "3 consecutive boots" fails 3/3 off-socket and passes 2/2 over the Bridge (#20461). After a re-boot the dock host never becomes visible: the adapter's SharedWorker handle does not survive the re-boot.
workstation/WorkstationResetSurvivesReloadNL (2 arms) and workstation/WorkstationTopologyGroupsNL (4 arms) fail after page.reload with neuralLink.connectToApp(...): "the page's App Worker … did not initialize Neo.ai.Client within 30000 ms".
workstation/WorkstationFiveBeatNL (2 arms) times out in its boot(), which waits 30 s for .workstation-tour-play after re-navigating.
- Closed bound page.
realworld/EmailMultiWindowNL closes its source page (page.close({runBeforeUnload: true})). Then: "Tearing down "neuralLink" exceeded the test timeout of 90000ms".
- Topology.
neural-link/WindowOps compares a drag receipt with popupWindow.innerRect.x from get_window_topology. The value is undefined: a toBeCloseTo matcher error at line 158.
Measured at intake (2026-11-08), each cause now established:
- Re-boot (
DockSplitterZoneIdNL, WorkstationFiveBeatNL): the adapter's held CDP session keeps the App SharedWorker alive past its last client. The re-booted page connects to that survivor (same targetId), whose Data, VDom and Canvas siblings started fresh, and never finishes booting. A four-arm probe settled it: holding the session, releasing only the writer pair, and attaching without a call all fail, while detaching before the navigation passes.
- Closed bound page (
EmailMultiWindowNL): the hang follows the context's last window closing. The held App Worker then never answers and emits no target event.
- Topology (
WindowOps): Neo.util.Rectangle is a DOMRect, and CDP returnByValue drops its accessor x/y, while the Bridge's JSON wire keeps them. The spec then also needs the Bridge's refusal of an unknown window (resolveWindowTarget).
- Not a reload (
WorkstationResetSurvivesReloadNL, WorkstationTopologyGroupsNL): they cold-boot a second browser context and bind it by worker id, which the adapter cannot reach. They keep LOCAL_ONLY under #20614.
The Architectural Reality
test/playwright/dedicatedWorkerNeuralLink.mjs is the adapter. Its get_window_topology reads Neo.manager.Window.items in the App Worker, then adds the windows of Neo.apps that have no item, and those come without innerRect. An item gets innerRect only from Neo.manager.Window#onWindowConnect (src/manager/Window.mjs:181), and only when the connect carried windowData.
test/playwright/sharedWorkerAppWorker.mjs (attachPageSharedAppWorker) holds the page's SharedWorker handle, the one a re-boot invalidates.
test/playwright/externalBrainSelection.mjs lists the eligible specs (ADAPTER_ELIGIBLE_SPECS). buildScripts/util/e2eCiSelection.mjs holds RUN_PATHS, LOCAL_ONLY and the duration table the shards balance by.
The Fix
In the adapter:
- After a re-boot (reload or re-navigation), re-attach to the page's App Worker instead of keeping the first handle.
- Release a binding whose page closed, instead of waiting on it at teardown.
- Find why the
WindowOps popup reaches the topology without innerRect, and make the off-socket topology carry it.
Then, for each spec green on a hosted run:
- move it from
LOCAL_ONLY into ADAPTER_ELIGIBLE_SPECS, and into RUN_PATHS for workstation/;
- give it a duration in
e2eEngineDurations.json.
Acceptance Criteria
Out of Scope
- The Bridge and Brain-service classes of
LOCAL_ONLY. They test the Brain itself and stay local.
- Rewriting Brain-service specs to the off-socket SDK.
Related
- #20451 retires the Brain tier.
- PR #20584 adds
LOCAL_ONLY and the newly admitted specs.
- #20461 and #20376 are the SharedWorker adapter.
- #18770 covers reload versus SharedWorker state.
- #20328 is v13.4.
Ownership: self-assigned. Not a good first issue: two of the three causes are unresolved, and it owns a CI disclosure entry.
Live latest-open + closed sweep: checked latest 20 open + closed search (off-socket adapter re-boot; adapter SharedWorker reload neuralLink) at 2026-11-08T07:59Z; no equivalent or prior exclusion (closed #20370 is the single-app port this extends). A2A in-flight sweep: last 30 messages, no claim on this scope. Memory Core sweep: #20461's two residuals and #18770's reload finding, both cited above. Own open assignments: #20451, #20328.
Origin Session ID: 03506c7d-003d-47bf-9c85-0c87a27e3213
Retrieval Hint: "off-socket Neural Link adapter re-boot SharedWorker handle window specs LOCAL_ONLY"
Context
#20451 retires the Brain-gated e2e tier. Every Neural Link spec now runs off-socket in the engine tier, or
LOCAL_ONLYinbuildScripts/util/e2eCiSelection.mjsstates why it stays local (PR #20584). On 2026-11-08 a local off-socket probe ran the 42 window-driving specs: 37 files were clean, and they move into the tier. Six window specs fail on the adapter and pass over the Bridge. With the Brain tier gone, no CI job runs them. This ticket owns theirLOCAL_ONLYentry.The Problem
Measured off-socket, locally, on one worker:
workstation/DockSplitterZoneIdNL"3 consecutive boots" fails 3/3 off-socket and passes 2/2 over the Bridge (#20461). After a re-boot the dock host never becomes visible: the adapter's SharedWorker handle does not survive the re-boot.workstation/WorkstationResetSurvivesReloadNL(2 arms) andworkstation/WorkstationTopologyGroupsNL(4 arms) fail afterpage.reloadwithneuralLink.connectToApp(...): "the page's App Worker … did not initialize Neo.ai.Client within 30000 ms".workstation/WorkstationFiveBeatNL(2 arms) times out in itsboot(), which waits 30 s for.workstation-tour-playafter re-navigating.realworld/EmailMultiWindowNLcloses its source page (page.close({runBeforeUnload: true})). Then: "Tearing down "neuralLink" exceeded the test timeout of 90000ms".neural-link/WindowOpscompares a drag receipt withpopupWindow.innerRect.xfromget_window_topology. The value isundefined: atoBeCloseTomatcher error at line 158.Measured at intake (2026-11-08), each cause now established:
DockSplitterZoneIdNL,WorkstationFiveBeatNL): the adapter's held CDP session keeps the App SharedWorker alive past its last client. The re-booted page connects to that survivor (sametargetId), whose Data, VDom and Canvas siblings started fresh, and never finishes booting. A four-arm probe settled it: holding the session, releasing only the writer pair, and attaching without a call all fail, while detaching before the navigation passes.EmailMultiWindowNL): the hang follows the context's last window closing. The held App Worker then never answers and emits no target event.WindowOps):Neo.util.Rectangleis aDOMRect, and CDPreturnByValuedrops its accessorx/y, while the Bridge's JSON wire keeps them. The spec then also needs the Bridge's refusal of an unknown window (resolveWindowTarget).WorkstationResetSurvivesReloadNL,WorkstationTopologyGroupsNL): they cold-boot a second browser context and bind it by worker id, which the adapter cannot reach. They keepLOCAL_ONLYunder #20614.The Architectural Reality
test/playwright/dedicatedWorkerNeuralLink.mjsis the adapter. Itsget_window_topologyreadsNeo.manager.Window.itemsin the App Worker, then adds the windows ofNeo.appsthat have no item, and those come withoutinnerRect. An item getsinnerRectonly fromNeo.manager.Window#onWindowConnect(src/manager/Window.mjs:181), and only when the connect carriedwindowData.test/playwright/sharedWorkerAppWorker.mjs(attachPageSharedAppWorker) holds the page's SharedWorker handle, the one a re-boot invalidates.test/playwright/externalBrainSelection.mjslists the eligible specs (ADAPTER_ELIGIBLE_SPECS).buildScripts/util/e2eCiSelection.mjsholdsRUN_PATHS,LOCAL_ONLYand the duration table the shards balance by.The Fix
In the adapter:
WindowOpspopup reaches the topology withoutinnerRect, and make the off-socket topology carry it.Then, for each spec green on a hosted run:
LOCAL_ONLYintoADAPTER_ELIGIBLE_SPECS, and intoRUN_PATHSforworkstation/;e2eEngineDurations.json.Acceptance Criteria
DockSplitterZoneIdNL"3 consecutive boots" passes off-socket 3/3 locally, red first: 0/3 on the base.LOCAL_ONLY. A spec that cannot keeps an entry that states its measured cause.Out of Scope
LOCAL_ONLY. They test the Brain itself and stay local.Related
LOCAL_ONLYand the newly admitted specs.Ownership: self-assigned. Not a
good first issue: two of the three causes are unresolved, and it owns a CI disclosure entry.Live latest-open + closed sweep: checked latest 20 open + closed search (off-socket adapter re-boot; adapter SharedWorker reload neuralLink) at 2026-11-08T07:59Z; no equivalent or prior exclusion (closed #20370 is the single-app port this extends). A2A in-flight sweep: last 30 messages, no claim on this scope. Memory Core sweep: #20461's two residuals and #18770's reload finding, both cited above. Own open assignments: #20451, #20328.
Origin Session ID: 03506c7d-003d-47bf-9c85-0c87a27e3213
Retrieval Hint: "off-socket Neural Link adapter re-boot SharedWorker handle window specs LOCAL_ONLY"