P8-00: Master tracking issue for React/ELK refactor #47

Closed
opened 2026-02-19 19:06:06 -05:00 by Rbanh · 11 comments
Owner

Master tracker for milestone #7.

Execution plan document:

  • docs/phase8-react-elk-refactor-plan.md

Sub-issues:

  • #37 P8-01 Frontend architecture migration to React + TS + Vite
  • #38 P8-02 Deterministic state model
  • #39 P8-03 Canvas subsystem rewrite
  • #40 P8-04 ELK integration
  • #41 P8-05 Routing revamp
  • #42 P8-06 Label placement engine
  • #43 P8-07 Symbol readability standards
  • #44 P8-08 JSON editor upgrade
  • #45 P8-09 QA hardening
  • #46 P8-10 Cutover/rollback

Done criteria:

  • All sub-issues closed.
  • CI quality gates pass.
  • React path set as default with rollback validated.
Master tracker for milestone #7. Execution plan document: - `docs/phase8-react-elk-refactor-plan.md` Sub-issues: - #37 P8-01 Frontend architecture migration to React + TS + Vite - #38 P8-02 Deterministic state model - #39 P8-03 Canvas subsystem rewrite - #40 P8-04 ELK integration - #41 P8-05 Routing revamp - #42 P8-06 Label placement engine - #43 P8-07 Symbol readability standards - #44 P8-08 JSON editor upgrade - #45 P8-09 QA hardening - #46 P8-10 Cutover/rollback Done criteria: - All sub-issues closed. - CI quality gates pass. - React path set as default with rollback validated.
Rbanh added this to the Phase 8 - React/ELK Core Refactor milestone 2026-02-19 19:06:06 -05:00
Author
Owner

Execution plan committed in 85dc9a1:

  • docs/phase8-react-elk-refactor-plan.md

Next execution order (critical path):

  1. #37 + #38
  2. #39
  3. #40
  4. #41
  5. #42 + #43
  6. #44
  7. #45 + #46
Execution plan committed in `85dc9a1`: - `docs/phase8-react-elk-refactor-plan.md` Next execution order (critical path): 1) #37 + #38 2) #39 3) #40 4) #41 5) #42 + #43 6) #44 7) #45 + #46
Author
Owner

Parallelized Sprint 1 execution completed across multiple agents; merged in d029e48.

Completed this sprint:

  • React migration scaffold + API client foundation (#37, partial).
  • Deterministic store + undo/redo scaffold + tests (#38, partial).
  • CI/docs plumbing for dual-run path and react command stubs.

Validation:

  • npm test passed.
  • npm run frontend:react:check passed via deterministic stubs (dependencies not installed in this environment).

Next sprint recommendation:

  1. Wire React components to centralized store and real compile/analyze flows.
  2. Replace placeholder canvas with interaction substrate.
  3. Begin ELK adapter boundary implementation.
Parallelized Sprint 1 execution completed across multiple agents; merged in `d029e48`. Completed this sprint: - React migration scaffold + API client foundation (#37, partial). - Deterministic store + undo/redo scaffold + tests (#38, partial). - CI/docs plumbing for dual-run path and react command stubs. Validation: - `npm test` passed. - `npm run frontend:react:check` passed via deterministic stubs (dependencies not installed in this environment). Next sprint recommendation: 1) Wire React components to centralized store and real compile/analyze flows. 2) Replace placeholder canvas with interaction substrate. 3) Begin ELK adapter boundary implementation.
Author
Owner

Sprint 2 merged in 5a4e116 via parallel agent tracks.

Completed this sprint:

  • Live React workflow actions against backend API.
  • Store lifecycle + React hook subscriptions.
  • Interactive canvas baseline (render/select/drag single node + zoom).

Validation:

  • npm test passed.
  • npm run frontend:react:check passed using deterministic stub path in this environment.

Next sprint (recommended):

  1. Implement multi-select/box-select and keyboard editing contracts.
  2. Add incremental wire rendering adapter in React canvas.
  3. Start ELK adapter boundary with feature-flagged auto-layout route.
Sprint 2 merged in `5a4e116` via parallel agent tracks. Completed this sprint: - Live React workflow actions against backend API. - Store lifecycle + React hook subscriptions. - Interactive canvas baseline (render/select/drag single node + zoom). Validation: - `npm test` passed. - `npm run frontend:react:check` passed using deterministic stub path in this environment. Next sprint (recommended): 1) Implement multi-select/box-select and keyboard editing contracts. 2) Add incremental wire rendering adapter in React canvas. 3) Start ELK adapter boundary with feature-flagged auto-layout route.
Author
Owner

Sprint 3 completed locally in commit dc9c277 (push pending; DNS resolution to git.spacetrainclubhouse.com failed from this environment).

Delivered this sprint:

  • React canvas interaction parity improvements (multi-select, marquee select, keyboard ops, strict locked handling).
  • Canvas net click/highlight path through wire and label layers.
  • ELK integration boundary metadata + deterministic fallback contract.
  • Contract tests and regression checks updated/passing (npm test, npm run test:ui).

Next sprint target:

  1. Layout/routing readability pass to reduce tie-net-heavy fallback in dense examples.
  2. Deterministic label placement collision resolver (legend/notes reservation + anchor rules).
  3. React frontend dependency/bootstrap reliability in CI to enforce TS build gate.
Sprint 3 completed locally in commit `dc9c277` (push pending; DNS resolution to `git.spacetrainclubhouse.com` failed from this environment). Delivered this sprint: - React canvas interaction parity improvements (multi-select, marquee select, keyboard ops, strict locked handling). - Canvas net click/highlight path through wire and label layers. - ELK integration boundary metadata + deterministic fallback contract. - Contract tests and regression checks updated/passing (`npm test`, `npm run test:ui`). Next sprint target: 1) Layout/routing readability pass to reduce tie-net-heavy fallback in dense examples. 2) Deterministic label placement collision resolver (legend/notes reservation + anchor rules). 3) React frontend dependency/bootstrap reliability in CI to enforce TS build gate.
Author
Owner

Sprint 4 summary (local commit e69f2db, not yet pushed):

Done:

  • Deterministic net label collision resolver pass added to renderer.
  • Added blocked regions for legend/annotations/components to reduce floating/overlapping labels.
  • Regression baselines refreshed and deterministic hash updated.
  • Full local backend + UI regression suites passing.

Still pending in Phase 8:

  1. Full ELK primary-placement activation (current state is boundary + fallback metadata only).
  2. Routing engine congestion strategy improvements for dense topologies.
  3. React dependency bootstrap in CI and full React build gate enforcement.

Infra blocker:

  • Remote git push unavailable from this host due DNS resolution failure for git.spacetrainclubhouse.com.
Sprint 4 summary (local commit `e69f2db`, not yet pushed): Done: - Deterministic net label collision resolver pass added to renderer. - Added blocked regions for legend/annotations/components to reduce floating/overlapping labels. - Regression baselines refreshed and deterministic hash updated. - Full local backend + UI regression suites passing. Still pending in Phase 8: 1) Full ELK primary-placement activation (current state is boundary + fallback metadata only). 2) Routing engine congestion strategy improvements for dense topologies. 3) React dependency bootstrap in CI and full React build gate enforcement. Infra blocker: - Remote git push unavailable from this host due DNS resolution failure for `git.spacetrainclubhouse.com`.
Author
Owner

Sprint 5 shipped to main (b8d894f).

Delivered:

  • Generic/template symbol readability normalization with deterministic behavior.
  • New validate regression test coverage.
  • Full backend + UI regression pass.

Phase 8 focus next:

  1. P8-04 full ELK primary placement activation (currently boundary/fallback only).
  2. P8-05 routing revamp for dense congestion (incremental reroute + tie-net policy tuning).
  3. P8-08 JSON editor upgrade in React path (schema-aware, line diagnostics, apply-diff UX).
Sprint 5 shipped to `main` (`b8d894f`). Delivered: - Generic/template symbol readability normalization with deterministic behavior. - New validate regression test coverage. - Full backend + UI regression pass. Phase 8 focus next: 1) P8-04 full ELK primary placement activation (currently boundary/fallback only). 2) P8-05 routing revamp for dense congestion (incremental reroute + tie-net policy tuning). 3) P8-08 JSON editor upgrade in React path (schema-aware, line diagnostics, apply-diff UX).
Author
Owner

Sprint 6 shipped to main (35211c6).

Delivered this sprint:

  • React JSON power-tool workflow landed (Validate/Format/Sort/Copy Repro/Apply).
  • Editor state and feedback integrated into React app shell.
  • Full regression checks remain green (npm test, npm run test:ui).

Phase 8 priority now remains centered on:

  1. P8-04 ELK primary auto-layout activation.
  2. P8-05 routing revamp / congestion strategy.
  3. P8-10 cutover + rollback + CI React build gating.
Sprint 6 shipped to main (`35211c6`). Delivered this sprint: - React JSON power-tool workflow landed (Validate/Format/Sort/Copy Repro/Apply). - Editor state and feedback integrated into React app shell. - Full regression checks remain green (`npm test`, `npm run test:ui`). Phase 8 priority now remains centered on: 1) P8-04 ELK primary auto-layout activation. 2) P8-05 routing revamp / congestion strategy. 3) P8-10 cutover + rollback + CI React build gating.
Author
Owner

Sprint 7 shipped to main (0c5c104).

Delivered:

  • Phase 8 cutover gate command + report generation.
  • Formal rollback/cutover runbook and release-checklist integration.
  • Continues milestone progress on P8-10 operational readiness.

Still open critical engineering items:

  1. P8-04 ELK primary layout activation.
  2. P8-05 routing revamp for dense/congested topologies.
  3. P8-08 schema-aware inline diagnostics + apply-diff UX in React editor.
Sprint 7 shipped to main (`0c5c104`). Delivered: - Phase 8 cutover gate command + report generation. - Formal rollback/cutover runbook and release-checklist integration. - Continues milestone progress on P8-10 operational readiness. Still open critical engineering items: 1) P8-04 ELK primary layout activation. 2) P8-05 routing revamp for dense/congested topologies. 3) P8-08 schema-aware inline diagnostics + apply-diff UX in React editor.
Author
Owner

Phase 8 progress update:

Completed implementation commits:

  • dc9c277 canvas interaction parity + ELK boundary metadata
  • e69f2db deterministic label collision pass
  • b8d894f symbol readability normalization (generic/template)
  • 35211c6 React JSON editor power-tool workflow
  • 0c5c104 cutover gate + rollback runbook

Status:

  • Core React path + interaction stability improved materially.
  • Major layout/readability regressions still remain in dense samples (as seen in latest QA screenshots).
  • Phase 8 remains open until routing/layout quality bars are actually met in practice, not just feature-complete by checklist.

Proposed next step:

  • Open a dedicated production-hardening milestone focused on ELK-first placement quality, incremental routing channelization, and readability constraints with visual gates.
Phase 8 progress update: Completed implementation commits: - `dc9c277` canvas interaction parity + ELK boundary metadata - `e69f2db` deterministic label collision pass - `b8d894f` symbol readability normalization (generic/template) - `35211c6` React JSON editor power-tool workflow - `0c5c104` cutover gate + rollback runbook Status: - Core React path + interaction stability improved materially. - Major layout/readability regressions still remain in dense samples (as seen in latest QA screenshots). - Phase 8 remains open until routing/layout quality bars are actually met in practice, not just feature-complete by checklist. Proposed next step: - Open a dedicated production-hardening milestone focused on ELK-first placement quality, incremental routing channelization, and readability constraints with visual gates.
Author
Owner

Tracker update after board cleanup:

Closed as complete:

  • #37 (React architecture migration)
  • #38 (deterministic state model)
  • #44 (JSON editor upgrade)

Still open in Phase 8 (quality-critical):

  • #39 canvas subsystem
  • #40 ELK integration
  • #41 routing revamp
  • #42 label placement
  • #43 symbol readability
  • #45 QA hardening
  • #46 cutover/rollback

Follow-on production milestone created:

  • Milestone #8 Phase 9 - Layout & Readability Production Hardening
  • Master: #48, Sub-issues: #49-#54
Tracker update after board cleanup: Closed as complete: - #37 (React architecture migration) - #38 (deterministic state model) - #44 (JSON editor upgrade) Still open in Phase 8 (quality-critical): - #39 canvas subsystem - #40 ELK integration - #41 routing revamp - #42 label placement - #43 symbol readability - #45 QA hardening - #46 cutover/rollback Follow-on production milestone created: - Milestone #8 `Phase 9 - Layout & Readability Production Hardening` - Master: #48, Sub-issues: #49-#54
Author
Owner

Phase 8 master is now complete. All remaining sub-issues have been closed and superseding Phase 9 hardening has shipped. Closing tracker.

Phase 8 master is now complete. All remaining sub-issues have been closed and superseding Phase 9 hardening has shipped. Closing tracker.
Rbanh closed this issue 2026-02-20 01:36:02 -05:00
Sign in to join this conversation.
No Label
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Rbanh/schemeta#47
No description provided.