STV_PR_013: Keep node positions stable during relationship expansion
Reporter/date: Project owner, 2026-10-24. Original baseline Reported problem (language-corrected): Expanding a node’s relationships shifts its same-level peers and the activated node, making navigation hard. Cause and reproduction: Fresh ELK ordering, parent centering and origin normalization ran on every toggle without committed geometry. Firefox measured P moving about 357 screen px and Q about -510 screen px on first expansion over both file and HTTP. PR013 position-stability proof of concept preserves before/after measurements, failed attempts and owner-review screenshots. Owner decisions: The owner requested a PoC before broad documentation, liked stable navigation, reported missing arrows in Firefox, then approved the corrected arrows and requested natural numeric seed ordering. After approving the PoC (“i love it”), the owner explicitly requested concept creation, review and implementation to finalize the fix. No release or commit is authorized by that instruction. Design and ownership: STV_ADR_008: Stable navigation after fresh placement partially supersedes repeated centering in STV_ADR_006: Centered layout and interactive overview. Fresh layouts retain Center parents over their v... (STV_SHR_052) / Center parent boxes with co... (STV_SWR_056); group/root commands follow Keep navigation positions s... (STV_SHR_054) / Stabilize committed navigat... (STV_SWR_058). Semantic rank layout (STV_SWE_LAYOUT) owns nearest free slots, clicked-band anchoring and shared-test reranking. Accessible view and viewport (STV_SWE_RENDER) owns per-view committed snapshots, transactional retention, focus, transforms and Render complete edge bounds... (STV_SWR_059) SVG bounds. Initial numeric order follows Order initial ordinary node... (STV_SHR_055) / Use natural ID order for fr... (STV_SWR_060). Arrow regression: The PoC introduced valid negative graph coordinates outside a zero-origin SVG viewport. Logical ports were correct but Firefox clipped segments. Matching positioned SVG/viewBox origins now include every route/node extent with padding; final routes remain governed by Prefer direct facing-edge r... (STV_SWR_053). No coordinate shift is used to disguise the clipping. Accepted limits: Surviving ordinary horizontal slots and the clicked band remain stable. Other bands may move vertically for changed height; shared tests may change their median associated rank. Collapsed gaps can remain until fresh initialization/reseed/overview/page placement. Reset viewport changes the transform only. This is not global frozen geometry. Concept and verification: Round 9: Stable navigation concept and implementation handover records scoped acceptance, semantic coverage and diagram review. PR013 final development verification records final development checks and canonical cases. The final development run has 111 distinct latest passing tests, including component, Firefox file/HTTP, 200-node capacity and clean-package checks. The two placeholder visibility test failures and corrected retests remain recorded; product geometry did not change during those retests. Historical candidate results do not qualify the current code. Full release qualification remains separate. |