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

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)

Phase 2: Visual and Functional Parity Implementation

Address all identified gaps and ensure functional equivalence.

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

Phase 3: Performance Optimization and Final Validation

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.
• Task: Optimize rendering and docking logic in gui_2.py if performance targets are not met.
• Task: Verify performance parity using tests/test_gui2_performance.py.
• Task: Run full suite of automated GUI tests with live_gui fixture on gui_2.py.
• Task: Conductor - User Manual Verification 'Phase 3: Performance Optimization and Final Validation' (Protocol in workflow.md)

Phase 4: Deprecation and Cleanup

Finalize the migration and decommission the original gui.py.

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

---

[checkpoint: (SHA will be recorded here)]