Add README with design principle, TASKS.md roadmap, and ai.md agent guide

2026-08-04 10:24:20 -07:00
parent b3c81f0af8
commit 8aebbff318
3 changed files with 184 additions and 0 deletions
@@ -0,0 +1,90 @@
+# ytLive — Task List
+
+## TASK 1 — Initial Scaffold
+
+**Goal:** Working C# / WPF project with MVVM architecture, dark-theme main window, and YouTube service stubs.
+
+### Status: ✅ Done
+- Models: Scene, Source, StreamConfig, StreamHealth, YouTubeChannel, ChatMessage
+- Services: YouTubeAuthService (OAuth2), YouTubeStreamService (broadcast/health), YouTubeChatService (chat polling)
+- MainViewModel: scene management, stream controls, chat
+- MainWindow: scene/source panel, preview area, chat panel, status bar
+- Clean build, 0 warnings (WSL + Windows)
+
+---
+
+## TASK 2 — YouTube OAuth2 Authentication
+
+**Goal:** Fully working Google OAuth2 flow — user clicks "YouTube", browser opens, authorization callback lands, channel info is stored.
+
+### Requirements:
+
+1. **Google Cloud OAuth credentials** — client ID + secret (user provides; needs "Localhost" redirect URI)
+2. **Local HTTP listener** — `HttpListener` on `http://localhost:PORT/oauth2/callback` to catch the redirect
+3. **Browser launch** — open the authorization URL in the default browser
+4. **Token persistence** — store access/refresh tokens securely (Windows DPAPI), reload on startup
+5. **UI state** — account name/avatar shown when connected, connection status reflected
+
+### Tests:
+
+- Mock token exchange response, verify channel info parsed
+- Verify token refresh triggers when near expiry
+- Verify credential load/save roundtrip
+
+### Status: Not started
+
+---
+
+## TASK 3 — Capture Pipeline (Scenes/Sources)
+
+**Goal:** Real video preview in the center panel — display capture, window capture, webcam, images, text overlays, composited per scene.
+
+### Requirements:
+
+1. **Display capture** — Windows.Graphics.Capture API (WinRT), enumerate monitors
+2. **Window capture** — enumerate top-level windows, capture per-window
+3. **Webcam** — MediaCapture (WinRT) with device enumeration
+4. **Image / text overlay** — static sources positioned/scaled/opacity
+5. **Scene compositing** — per-scene source layering (z-order), preview rendered via D3DImage or MediaElement
+6. **Drag/drop source placement** — intuitive, visual (per design principle)
+
+### Status: Not started
+
+---
+
+## TASK 4 — RTMP Ingest to YouTube
+
+**Goal:** Push encoded video to YouTube's RTMP ingest.
+
+### Requirements:
+
+1. **Encoding** — H.264 (hardware via NVENC/AMD, fallback x264) + AAC audio
+2. **RTMP push** — FFmpeg subprocess or native RTMP library
+3. **Stream key management** — save keys securely, prefill default YouTube ingest URL `rtmp://a.rtmp.youtube.com/live2`
+4. **Health stats** — bitrate, FPS, dropped frames reported live in the bottom bar
+5. **One-click go live** — defaults that work out of the box
+
+### Status: Not started
+
+---
+
+## TASK 5 — YouTube Live Stream Management
+
+**Goal:** Create/bind broadcasts, monitor YouTube-side stream health.
+
+### Requirements:
+
+1. **Broadcast creation** — title/description/visibility via API
+2. **Stream binding** — create stream, bind to broadcast
+3. **Health monitoring** — poll `liveBroadcasts` lifecycle status, surface YouTube health messages
+4. **Live chat** — poll `liveChat/messages`, render in right panel, support Super Chat + membership badges
+
+### Status: Not started
+
+---
+
+## Backlog (future versions)
+
+- v0.2 — Recording to local file
+- v0.3 — Stream scheduling
+- v0.4 — Multi-destination restreaming