ARCADIA-Studio/harness/release-port-drawing.md

Direct connections and port placement

User workflow and decisions

Architecture has explicit Select/move and perspective-specific drawing tools: OA Interaction, SA Functional exchange and SA Boundary exchange. Select a source and a highlighted target, or drag between them. Function cards generate/reuse typed ports through the existing atomic planner; explicit port hits retain the chosen identity. Boundary links use actual compatible component ports. Middle drag and canvas-focused arrows pan while retaining the chosen source. Escape cancels; empty space restarts. Hover details identify ports, owners and aliases.

Port sides and normalized positions belong to each diagram placement, preserving semantic ownership. Dragging snaps to the owner's border; automatic placement uses direction, connected peers and available border space. Right-click Reset automatic position restores the derived anchor. Core commands, source bundles, JSON/REST and SVG use the same model and projected geometry. Each completed gesture makes one source-aware history operation. Menus and source-file folders are covered separately in release-context-menus.md.

The bounded automatic router still permits dense-model crossings. Authored bends remain available; no perfect-layout guarantee is made. Input direction and carried items are not guessed from geometry. Drawing creates an empty carried-item list; Properties supplies the name and contract editing workflow.

Findings resolved during integration

• Shared feasibility queries previously scanned unrelated interface roles for every candidate. Commit93fd32c reduced the measured4000-port/4000-role picker from804ms to3.169ms optimized without relaxing final validation.
• Per-placement port anchors are integrated in35133de. Owner changes repair graphical anchors atomically; raw source/API reject invalid owner references.
• Automatic labels now avoid other edge strokes as well as nodes/labels, with bounded deterministic placement. Both source-ID orders have regression tests.
• Iced supplies a batch-final window cursor for every event. Ordered motion is now authoritative for both press and release, preserving stationary-source drags and preventing later motion from converting a click into a model edit. Menu transitions invalidate cached pointer state through captured epochs.
• Enlarged port hit areas overlap at overview zoom. All three picking paths now choose the nearest glyph, with stable tie-breaking for coincident ports.
• Port labels use a separate screen-space frame, avoiding text overprint and keeping target identification legible while zoomed out.

Earlier verification (superseded by final acceptance below)

Full Windows workspace passed485 tests (264 core,185 desktop,36 server); full Linux passed488 (267 core,185 desktop,36 server), with strict Linux workspace Clippy and optimized desktop/server builds. These full runs precede the last ordered-release/hover changes. Four subsequent production lifecycle tests and nine external lifecycle probes passed. Final189-test desktop runs, strict workspace Clippy and rebuilds passed on both Windows and Linux. Native acceptance is still in progress; do not infer it from automated suites.

Root operated DE6BD100 and46EE7BD9 Windows builds through Computer Use. OA palette click-click creation/history, SA direct FE/Flow boundary links, fast port-to-port drag, four port sides across trials, automatic reset/Undo, draft/menu guards and save/reopen passed. The46EE build was inspected at1100x700, rejected an input port as an outgoing source, and cancelled without dirtying the saved model. Its window closed normally, exit0. The final ordered-pointer/hover/pan build still needs native acceptance on both platforms; middle-button dragging is unavailable in the native tool, so use the actual keyboard-pan path plus production mouse probes.

Saved evidence under D:/CodexBuilds/Capella2-release1-01a06e2e/:

• ui-port-drawing/authored/project.arcadia:41objects,27links,0checks; Left anchor, FE and Flow boundary link. Reopened on46EE and exported project.svg (5050bytes). Root inspected its raster rendering for port direction, nesting and routes; the renderer's fallback font differs from the application.
• ui-port-drawing-reviewed/authored/project.arcadia:41objects,26links,0checks; Bottom anchor and fast-drawn FE, source bytes inspected after native Save.
• port-drawing-final-tests.log, port-drawing-final-linux-*.log and independent review/probe folders retain exact command scopes.

Root's final Windows build9A7FF074 passed fast FE drag, first Bottom port drag, repeated Left drag, readable hover name/owner/alias, arrow pan with source retained offscreen, target completion and one Undo. Current native window328292 has the isolated41object/26link model; independent native reviewer owns it exclusively for the remaining Windows tasks. Linux final build23CEAE18 passed189 desktop tests and strict workspace Clippy but still needs native verification.

Pending: final menu lifecycle, Function-card auto endpoint creation, Standard boundary drawing, minimum layout, save/reopen and Linux native workflow. The broader first-release objective remains incomplete.

Final tooltip and native acceptance

The earlier statement that separate Frames eliminated overprint was falsified by independent native QA. Iced batches text after meshes within one GPU layer. A passive second Canvas in Stack now creates a real layer above diagram text, with no input capture or cursor override. Context-scoped held-button tracking prevents stale suppression after menu dismissal and premature tooltips during leave/reentry. Four production lifecycle tests passed on Windows and Linux.

Final Windows193 desktop tests, strict desktop Clippy and build passed. Root tested binary1EEBDC3C (full SHA256 in ui-port-tooltip-final executable): first Bottom drag, menu outside dismissal, first repeated Left drag, FE creation and Save,41/26/0. Independent9A7/3F534C review passed Standard rejection/completion, function-card endpoint generation, one Undo/Redo, Save/reopen and minimum1100x700; it reproduced then verified the tooltip fix. Exact report: drawing-independent-native-review.md in the external evidence directory.

Root operated Linux binary7AC5EEEFFFD5514C771CF0E3B75471CA771DF75BE5DEBE9B9928B1527E1591F1: first FE drag; Right→Bottom and Bottom→Left port movement; Reset/Undo; arrow pan with source offscreen and target completion; Save/reopen; source folders and file opening. Saved ui-port-tooltip-linux/project.arcadia,41/27/0, contains both exchanges and Left anchor. Runtime log empty; normal close exit0. Inspected1440x900; minimum layout evidence is Windows. Linux189 desktop tests/strict Clippy/release passed, then four new lifecycle tests passed separately. A stale142-test shared-worktree cache result was excluded and main explicitly rebuilt; targets must be checkout-specific.

Drawing milestone accepted with these evidence boundaries. The broader first release and direct behavior editing remain incomplete.