docs(todo): add Wine black screen investigation task

demo64k.exe runs under Wine but renders no visuals. Audio/timeline work.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

1 files changed, 13 insertions, 0 deletions

diff --git a/TODO.md b/TODO.md
index c89c9a6..0f6c600 100644
--- a/TODO.md
+++ b/TODO.md
@@ -59,6 +59,19 @@ Ongoing shader code hygiene for granular, reusable snippets.
 
 ---
 
+## Priority 4: Wine/Windows Black Screen
+
+`demo64k.exe` runs under Wine (wgpu-native v27, Vulkan/MoltenVK) but shows a black window — no visuals rendered. Audio and timeline progress correctly. GPU device/adapter init succeeds.
+
+**Likely causes to investigate:**
+- Swapchain format mismatch (Wine Vulkan may prefer BGRA8 over RGBA8)
+- Surface present failing silently (check `WGPUSurfaceGetCurrentTexture` status)
+- Render pass output not reaching the surface (missing present call or wrong texture view)
+
+**To reproduce:** `./scripts/run_win.sh` — window opens, stays black.
+
+---
+
 ## Future: Size Optimization (64k Target)
 
 - Task #22: Windows Native Platform (Win32)