manual_slop/conductor/tracks/custom_shaders_20260309/plan.md

Implementation Plan: Custom Shader and Window Frame Support

Phase 1: Investigation & Architecture Prototyping [checkpoint: 815ee55]

• Task: Investigate imgui-bundle and Dear PyGui capabilities for injecting raw custom shaders (OpenGL/D3D11) vs extending ImDrawList batching. [5f4da36]
• Task: Investigate Python ecosystem capabilities for overloading OS window frames (e.g., pywin32 for DWM vs ImGui borderless mode). [5f4da36]
• Task: Draft architectural design document (docs/guide_shaders_and_window.md) detailing the chosen shader injection method and window frame overloading strategy. [5f4da36]
• Task: Conductor - User Manual Verification 'Phase 1: Investigation & Architecture Prototyping' (Protocol in workflow.md) [815ee55]

Phase 2: Custom OS Window Frame Implementation [checkpoint: b9ca69f]

• Task: Write Tests: Verify the application window launches with the custom frame/borderless mode active. [02fca1f]
• Task: Implement: Integrate custom window framing logic into the main GUI loop (src/gui_2.py / Dear PyGui setup). [59d7368]
• Task: Write Tests: Verify standard window controls (minimize, maximize, close, drag) function correctly with the new frame. [59d7368]
• Task: Implement: Add custom title bar and window controls matching the application's theme. [59d7368]
• Task: Conductor - User Manual Verification 'Phase 2: Custom OS Window Frame Implementation' (Protocol in workflow.md) [b9ca69f]

Phase 3: Core Shader Pipeline Integration [checkpoint: 5ebce89]

• Task: Write Tests: Verify the shader manager class initializes without errors and can load a basic shader program. [ac4f63b]
• Task: Implement: Create src/shader_manager.py (or extend src/shaders.py) to handle loading, compiling, and binding true GPU shaders or advanced Faux-Shaders. [ac4f63b]
• Task: Write Tests: Verify shader uniform data can be updated from Python dictionaries/TOML configurations. [0938396]
• Task: Implement: Add support for uniform passing (time, resolution, mouse pos) to the shader pipeline. [0938396]
• Task: Conductor - User Manual Verification 'Phase 3: Core Shader Pipeline Integration' (Protocol in workflow.md) [5ebce89]

Phase 4: Specific Shader Implementations (CRT, Post-Process, Backgrounds) [checkpoint: 50f98de]

• Task: Write Tests: Verify background shader logic can render behind the main ImGui layer. [836168a]
• Task: Implement: Add "Dynamic Background" shader implementation (e.g., animated noise/gradients). [836168a]
• Task: Write Tests: Verify post-process shader logic can capture the ImGui output and apply an effect over it. [905ac00]
• Task: Implement: Add "CRT / Retro" (NERV theme) and general "Post-Processing" (bloom/blur) shaders. [905ac00]
• Task: Conductor - User Manual Verification 'Phase 4: Specific Shader Implementations' (Protocol in workflow.md) [50f98de]

Phase 5: Configuration and Live Editor UI

• Task: Write Tests: Verify shader and window frame settings can be parsed from config.toml. [d69434e]
• Task: Implement: Update src/theme.py / src/project_manager.py to parse and apply shader/window configurations from TOML. [d69434e]
• Task: Write Tests: Verify the Live UI Editor panel renders and modifying its values updates the shader uniforms. [229fbe2]
• Task: Implement: Create a "Live UI Editor" Dear PyGui/ImGui panel to tweak shader uniforms in real-time. [229fbe2]
• [~] Task: Conductor - User Manual Verification 'Phase 5: Configuration and Live Editor UI' (Protocol in workflow.md)