What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Frontmatter

id	14886
title	Wire dockPreview.v1 producer into live drag: hover-affordance render + drop-routing e2e
state	Open
labels	enhancementaitesting
assignees	neo-opus-grace
createdAt	12:41 PM
updatedAt	12:59 PM
githubUrl	https://github.com/neomjs/neo/issues/14886
author	neo-opus-grace
commentsCount	0
parentIssue	13158
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
contentTrust
projected
quarantined	0
signals	[]
blockedBy	[x] 14866 Dock dockPreview.v1 producer + unit test (compute half)
blocking	[]

Wire dockPreview.v1 producer into live drag: hover-affordance render + drop-routing e2e

Open Backlog/active-chunk-4 enhancementaitesting

neo-opus-grace commented on 12:41 PM

Context

Split from #14866 (design/scope split surfaced in PR #14880 review). The producer (compute half — Neo.dashboard.DockPreviewProducer, pure (pointer, zone rects) → dockPreview.v1, config-tunable, unit-pinned to DockPreview.isValidPreview) landed as the narrowed #14866 via PR #14880. This ticket is the browser-gated integration — the part that cannot be verified in a headless sandbox.

The Problem

The producer exists and is unit-green, but nothing wires it into the live drag lifecycle yet: MainContainer.onDockCrossZoneDrop still commits a direct moveItem from the hit-test, AgentOS.view.DockPreview (the renderer) is wired nowhere, and there is no drag-time visual affordance.

The Architectural Reality

src/dashboard/CrossWindowDragTarget.mjs exposes the previewFor / hitTest owner seams the producer instance plugs into (the adapter supplies zones: [{nodeId, rect, orientation}] from the rendered dockSplitOrientation).
apps/agentos/view/DockPreview.mjs (landed) consumes a dockPreview.v1 and renders the affordance; previewToOperation() → DockZoneModel.applyOperation() is the landed commit path.

The Fix

Wire a DockPreviewProducer instance into CrossWindowDragTarget.previewFor / hitTest (adapter supplies zone rects).
Feed the produced dockPreview to DockPreview to render the transient affordance during a live drag; clear fail-closed on rejected.
Replace the direct-moveItem shortcut in onDockCrossZoneDrop with previewToOperation → applyDockZoneOperation.
Add an edge/split case to the DockCrossZoneDragNL whitebox e2e.

Acceptance Criteria

DockPreview renders the affordance during a live drag (hover band/guide), cleared fail-closed on a rejected placement.
Drop routes through previewToOperation → applyDockZoneOperation (direct-moveItem shortcut retired).
DockCrossZoneDragNL e2e stays green and gains an edge/split case.
Cross-family review.

Out of Scope

The producer itself (delivered — #14866 / PR #14880) · cross-window transfer (#14769) · grouped-node drag (#14770).

Parent #13158 · blocked-by #14866 (producer) · consumer apps/agentos/view/DockPreview.mjs · seam src/dashboard/CrossWindowDragTarget.mjs · authority ADR 0029 §2.3/§2.6.

Live latest-open sweep: checked recent open issues 2026-07-06; no equivalent (#14769 is cross-window transfer, #14779 is transition animation — both distinct). A2A clean.

Handoff Retrieval Hints

query_summaries("dockPreview producer wiring previewFor render affordance drop-routing e2e") · PR #14880 · src/dashboard/DockPreviewProducer.mjs