manual_slop/conductor/tracks/gui_performance_20260223/plan.md

Implementation Plan: GUI Performance Fix

Phase 1: Instrumented Profiling and Regression Analysis

• Task: Baseline Profiling Run
  • Sub-task: Launch app with --enable-test-hooks and capture get_ui_performance snapshot on idle startup.
  • Sub-task: Identify which component (Dialogs, History, GUI_Tasks, Blinking, Comms, Telemetry) exceeds 1ms.
• Task: Regression Analysis (Commit 8aa70e2 to HEAD)
  • Sub-task: Review git diff for gui.py and ai_client.py across the suspected range.
  • Sub-task: Identify any code added to the while dpg.is_dearpygui_running() loop that lacks throttling.
• Task: Conductor - User Manual Verification 'Phase 1: Instrumented Profiling and Regression Analysis' (Protocol in workflow.md)

Phase 2: Bottleneck Remediation

• Task: Implement Performance Fixes
  • Sub-task: Write Tests (Performance regression test - verify no new heavy loops introduced)
  • Sub-task: Implement Feature (Refactor/Throttle identified bottlenecks)
• Task: Verify Idle FPS Stability
  • Sub-task: Write Tests (Verify frametimes are < 16.6ms via API hooks)
  • Sub-task: Implement Feature (Final tuning of update frequencies)
• Task: Conductor - User Manual Verification 'Phase 2: Bottleneck Remediation' (Protocol in workflow.md)

Phase 3: Final Validation

• Task: Stress Test Verification
  • Sub-task: Write Tests (Simulate high volume of comms entries and verify FPS remains stable)
  • Sub-task: Implement Feature (Ensure optimizations scale with history size)
• Task: Conductor - User Manual Verification 'Phase 3: Final Validation' (Protocol in workflow.md)

Phase: Review Fixes

• Task: Apply review suggestions 4628813