LlamaCasty/HANDOFF.md

HANDOFF — Session State

Branch

main @ 67baac6, working tree dirty (WebView2 web source feature + transparency fix). NOT pushed — user rule: never push without explicit instruction (2026-08-24). No feature branches pre-1.0: all work lands on main per work unit.

Uncommitted changes (WebView2 web source — to be committed this session)

User exception (2026-08-27): bundle the prior-session dirty work + today's transparency fix into ONE commit instead of separate work units.

9 files:

• Services/WebView2Manager.cs (new) — off-screen WebView2 capture: PropertyChanged syncs source W/H to control, JS transparent background injection on every nav, CapturePreviewAsync → BGRA VideoFrame; DefaultBackgroundColor = System.Drawing.Color.Transparent set in the constructor (before EnsureCoreWebView2Async, per WPF SDK doc) — this is the real fix for transparency. The old white-pixel alpha hack is removed.
• ytLive.Tests/WebView2ManagerTests.cs (new) — 4 tests: 3 scale-sync + 1 WebView2_DefaultBackgroundColor_Is_Transparent, all pass.
• Models/Source.cs — DisplaySource selector now routes WebSource to VideoImageSource like ChatBox.
• Services/LayoutStore.cs — WebUri column added (idempotent ALTER TABLE), read/write in the source load/save queries.
• ViewModels/MainViewModel.cs — WebView2Manager init + register/unregister lifecycle (loaded web sources rehydrate, WebUri PropertyChanged forwards to manager).
• MainWindow.xaml + .cs — off-screen WebView2 host Canvas (offscreen-positioned at -5000/-5000) added to the window's visual tree.
• ytLive.csproj — Microsoft.Web.WebView2 1.0.2903.40 package reference.
• ytLive.Tests/LayoutStorePersistenceTests.cs — WebSource_WebUri_Persists roundtrip test.

Build: 0 warnings. Tests: 234/236 pass (1 new pass + 2 pre-existing failures unchanged: AudioPipelineTests.Mix_HonorsProviderGains_AndGameMute_KillsTheLoopback (HANDOFF-known, unrelated) + RoundClipInteractionTests.Round_Clip_Corner_Is_Grabbable_And_Shape_Is_Circle (pre-existing, verified by stash-and-rerun, unrelated).

Two bugs — status

Bug 1: Scale (web source doesn't render at configured size)

PARTIALLY ADDRESSED. PropertyChanged handler syncs source Width/Height to WebView2 control. But CapturePreviewAsync captures at the HWND's physical pixel size (Width × DPI / 96), which may not match WPF logical units on high-DPI displays. The capture pipeline scales to webView.Width/Height but this fights the WPF Image element's own UniformToFill. Further work needed.

Bug 2: Transparency (web source loses transparency in capture)

SOLVED (2026-08-27). Root cause was looking at the wrong property: previous session tried CoreWebView2.BackgroundColor and AddScriptToExecuteOnDocumentCreated — neither exists on CoreWebView2 in this SDK. The real property is WebView2.DefaultBackgroundColor on the WPF control (a System.Drawing.Color, projected from ICoreWebView2Controller2). Confirmed via strings on Microsoft.Web.WebView2.Wpf.dll and the IDL §7363: "In the case of a transparent DefaultBackgroundColor WebView will render hosting app content as the background." WPF doc: "The most recent value set to this property before CoreWebView2Controller has been initialized will be set on it after initialization." Setting it in the constructor (before InitializeAsync → EnsureCoreWebView2Async) makes the captured PNG have alpha=0 in transparent regions. Combined with the existing CSS injection (html/body { background: transparent } on every nav), the pixel-level white→transparent alpha hack is no longer needed and has been removed.

Verification path: launch the app with a stream-elements widget URL, the animation should over the scene's background with no white box. Visual check needed — no automated test for capture alpha (would need a real rendered WebView2).

⚠️ Landmines (inherited from prior sessions + this session)

• User verdict (2026-08-23 + 2026-08-26): "The AI wrote fucked up code after repeatedly and intentionally misunderstanding instructions." and "fuck you for wasting an entire fucking day." Trust nothing without verification. Verify behavior, don't pattern-match.
• USER RULE: never git push without explicit instruction.
• Pre-existing test failures are TWO (not one — corrected 2026-08-27): AudioPipelineTests.Mix_HonorsProviderGains_AndGameMute_KillsTheLoopback (HANDOFF-known, sound channel related, can't test when not live) + RoundClipInteractionTests.Round_Clip_Corner_Is_Grabbable_And_Shape_Is_Circle (verified pre-existing by stash-and-rerun 2026-08-27). Both unrelated to web source.
• Real-MainWindow tests MUST set LayoutPathOverride (ai.md) — DB pollution wiped real data once.
• WPF handle forcing: WindowInteropHelper.Handle pre-show returns Zero and does NOT raise SourceInitialized; use EnsureHandle() (does both).
• Two MainWindows alive at once double-register hotkeys — second window's RegisterHotKey fails silently-by-log. Tests close windows before opening the next.
• Closing a MainWindow OVERWRITES saved window geometry (Closing → SaveWindowGeometry). In tests that assert restore-from-DB, save state AFTER closing prior windows.
• liveBroadcasts.update replaces the whole snippet part — UpdateBroadcast echoes scheduledStartTime or YouTube clears the schedule.
• contentDetails lock in created/ready — latency/DVR/embed etc. cannot be edited while live.
• Text Runs are not Visuals — ANY new hit-testing code must type-guard before VisualTreeHelper.GetParent.
• Avatar images: never decode via BitmapImage.UriSource on this box — use HttpClient→ StreamSource pattern.
• App running locks ytLive.exe — build fails MSB3027 until creator exits the app.
• Source.Type setter derives IsBackground (Models/Source.cs:40) — any Type change must re-set IsBackground after.
• vstest quirk: only one --tests: param allowed; plain substrings work, alternation regexes silently match nothing.
• WebView2 SDK 1.0.2903.40 TFM net8.0-windows10.0.19041.0: the property is Microsoft.Web.WebView2.Wpf.WebView2.DefaultBackgroundColor, NOT CoreWebView2.BackgroundColor (which throws CS1061 because it doesn't exist). Its TYPE is System.Drawing.Color, not System.Windows.Media.Color — using System.Drawing; is required alongside System.Windows.Media (otherwise Color is ambiguous). AddScriptToExecuteOnDocumentCreated is also not on CoreWebView2 — the equivalent is WebView2's CoreWebView2.AddScriptToExecuteOnDocumentCreated once initialized, or set per-page via NavigationCompleted/NavigationStarting events (what the manager does).
• WebView2 WPF control inherits from HwndHost, NOT Control — no Background property.
• CapturePreviewAsync preserves alpha when the controller's DefaultBackgroundColor is transparent — PNG decode → BitmapImage → FormatConvertedBitmap(Bgra32) keeps the alpha channel. The previous session's diagnosis ("always opaque white") was based on the default white DefaultBackgroundColor, not on CapturePreview itself.

Next steps

1. Launch the app with a stream-elements widget URL on a scene; visually confirm the animation composites over the scene background (no white box). PENDING creator go-ahead.
2. Decide on the scale bug (Bug 1) — DPI/physical-pixel mismatch in the capture pipeline.
3. Continue queue: TASK 18 local recording, TASK 21 media source, TASK 22 audio sync offset.
4. Loose ends: dead ShowWebcamCommand, the two pre-existing test failures, Velopack update URL.

Build

"/mnt/c/Program Files/dotnet/dotnet.exe" build "C:\Users\gramp\Documents\Code\projects\ytLive\ytLive.csproj"
"/mnt/c/Program Files/dotnet/dotnet.exe" vstest "C:\Users\gramp\Documents\Code\projects\ytLive\ytLive.Tests\bin\Debug\net8.0-windows10.0.19041.0\ytLive.Tests.dll"

Polar.sh resources

Resource	ID
Org ID	c05fb364-b967-4f6c-adf2-8a144e46d085
Product	d105dfa1-497e-423b-8cd4-e0ee2e3abbc0
Price	7c1b6f70-cf8c-46df-9bc8-6703f9fa64d0
Benefit	80f66bc1-d5a3-44a1-b9ea-1709ae508535
Checkout URL	https://buy.polar.sh/polar_cl_ueMy8AyAClO0o0yo19IroZwKTbD587gzUsjEW3bFapw
Validate endpoint	POST https://api.polar.sh/v1/customer-portal/license-keys/validate
Key prefix	LCYT-

v1 vision

A streaming tool so intuitive it needs no manual — go live or record in minutes, OBS-free.