manual_slop/conductor/tracks/gui2_parity_20260224/plan.md

Implementation Plan: GUI 2.0 Feature Parity and Migration

This plan follows the project's standard task workflow to ensure full feature parity and a stable transition to the ImGui-based gui_2.py.

Phase 1: Research and Gap Analysis [checkpoint: 36988cb]

Identify and document the exact differences between gui.py and gui_2.py.

• Task: Audit gui.py and gui_2.py side-by-side to document specific visual and functional gaps. [fe33822]
• Task: Map existing EventEmitter and ApiHookClient integrations in gui.py to gui_2.py. [579b004]
• Task: Write failing tests in tests/test_gui2_parity.py that identify missing UI components or broken hooks in gui_2.py. [7c51674]
• Task: Verify failing parity tests. [0006f72]
• Task: Conductor - User Manual Verification 'Phase 1: Research and Gap Analysis' (Protocol in workflow.md) [9f99b77]

Phase 2: Visual and Functional Parity Implementation [checkpoint: ad84843]

Address all identified gaps and ensure functional equivalence.

• Task: Implement missing panels and UX nuances (text sizing, font rendering) in gui_2.py. [a85293f]
• Task: Complete integration of all EventEmitter hooks in gui_2.py to match gui.py. [9d59a45]
• Task: Verify functional parity by running tests/test_gui2_events.py and tests/test_gui2_layout.py. [450820e]
• Task: Address any identified regressions or missing interactive elements. [2d8ee64]
• Task: Conductor - User Manual Verification 'Phase 2: Visual and Functional Parity Implementation' (Protocol in workflow.md) [ad84843]

Phase 3: Performance Optimization and Final Validation [checkpoint: 611c897]

Ensure gui_2.py meets performance requirements and passes all quality gates.

• Task: Conduct performance benchmarking (FPS, CPU, Frame Time) for both gui.py and gui_2.py. [312b0ef]
• Task: Optimize rendering and docking logic in gui_2.py if performance targets are not met. [d647251]
• Task: Verify performance parity using tests/test_gui2_performance.py. [d647251]
• Task: Run full suite of automated GUI tests with live_gui fixture on gui_2.py. [d647251]
• Task: Conductor - User Manual Verification 'Phase 3: Performance Optimization and Final Validation' (Protocol in workflow.md) [14984c5]

Phase 4: Deprecation and Cleanup

Finalize the migration and decommission the original gui.py.

• Task: Rename gui.py to gui_legacy.py. [c4c47b8]
• Task: Update project entry point or documentation to point to gui_2.py as the primary interface. [b92fa90]
• Task: Final project-wide link validation and documentation update. [14984c5]
• Task: Conductor - User Manual Verification 'Phase 4: Deprecation and Cleanup' (Protocol in workflow.md) [14984c5]

---

[checkpoint: (SHA will be recorded here)]