# 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`.

- [x] Task: Audit `gui.py` and `gui_2.py` side-by-side to document specific visual and functional gaps. [fe33822]
- [x] Task: Map existing `EventEmitter` and `ApiHookClient` integrations in `gui.py` to `gui_2.py`. [579b004]
- [x] Task: Write failing tests in `tests/test_gui2_parity.py` that identify missing UI components or broken hooks in `gui_2.py`. [7c51674]
- [x] Task: Verify failing parity tests. [0006f72]
- [x] 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.

- [x] Task: Implement missing panels and UX nuances (text sizing, font rendering) in `gui_2.py`. [a85293f]
- [x] Task: Complete integration of all `EventEmitter` hooks in `gui_2.py` to match `gui.py`. [9d59a45]
- [x] Task: Verify functional parity by running `tests/test_gui2_events.py` and `tests/test_gui2_layout.py`. [450820e]
- [x] Task: Address any identified regressions or missing interactive elements. [2d8ee64]
- [x] 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.

- [x] Task: Conduct performance benchmarking (FPS, CPU, Frame Time) for both `gui.py` and `gui_2.py`. [312b0ef]
- [x] Task: Optimize rendering and docking logic in `gui_2.py` if performance targets are not met. [d647251]
- [x] Task: Verify performance parity using `tests/test_gui2_performance.py`. [d647251]
- [x] 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)

## Phase 4: Deprecation and Cleanup
Finalize the migration and decommission the original `gui.py`.

- [x] 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.
- [ ] 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)]