LlamaCasty/HANDOFF.md

HANDOFF — 2026-09-26 (TASK 47 shipped, NOT yet pushed: alert box video)

Branch / Commit State

main — TASK 47 changes are staged-ready, uncommitted in the working tree (repo was clean at 2c9af94, the TASK 46 handoff commit; origin/main = ecb329e). Commit + push pending the creator's go / milestone signal. The TASK 46 commit was pushed 2026-09-25 (origin/main = 197ee81..ecb329e).

⚠️ The unit that just shipped (creator directive)

TASK 43 closed with "make the alerts animate like a video" / "I want to play my own video for alerts" — that follow-up is TASK 47, done 2026-09-26:

• Video alerts: the alert box plays a clip on every alert — the shipped built-in (Assets/alert-default.mp4, stamped into the Asset table at startup via StampDefaultAlertVideo, id tracked in the AlertDefaultVideoAssetId setting) unless the creator picks their own file (path-only reference, never stored in the DB; the six AlertRenderer animations remain the fallback when nothing plays). Per-alert IAlertClipDecoder (ffmpeg bgra + f32le pipes, real-time paced, disposed at drain).
• Read-time fade (FadeDurationSeconds = 0.30 in AlertOverlayLayer): fade-in alpha on a straight-alpha frame copy; EOF → freeze-frame → fade-out → drain back to idle/transparent.
• Message ticker top-of-frame ("Funder — Super Chat · $10.00"): AlertTickerRenderer (marquee 140px/s), never baked — threaded via a FramePump._alertTicker seam into SceneCompositor.Render/CompositeLayers and mixed into BuildFullRenderSignature.
• Alert audio at unity, NO duck (creator ruling): AudioMixer.EnqueueAlertAudio + an 8s stereo-48k ring drained pre-limiter; per-alert Volume slider instead.
• New Stream Alerts config section in LeftPanel (built-in pill, path + Browse…, Reset, ticker pill, volume).

Good Dog test: ytLive.Tests/AlertLayerVideoTests.cs (RealApp STA) — one [Fact] driving a fake IAlertClipDecoder through the whole lifecycle: custom path wins per-source, decoder spawns/disposes (Start=1, Dispose=1 at drain), alpha envelope 0→127→255, pre-fade audio dropped while ramp audio forwards at volume×fade (0.8×0.5→[0.2,−0.1]) and full-fade at volume only, ticker renders non-null, has pixels and scrolls between ticks (and null when idle), EOF freeze-fades to a null frame. The test caught a real bug on the first run: the clip branch of Advance never cleared _current before AdvanceToNext → the layer stayed IsPlaying after drain (see MyMistakes.md). Gate: clean build 0 warnings; alert tests 2/2; full vstest 318/319 — the one failure LayerReorderPersistenceTests.RealMouseDrag… is the HANDOFF-documented env class (physical mouse drag no-ops when the desktop/session isn't interactive; this unit it failed 2× then passed in isolation on re-run; SourceList row geometry provably unchanged — AlertOverlayLayer — and its two sibling reorder tests, the same persistence path, pass).

Follow-ups queued (NOT done in this unit)

• TASK 3 item 20 persistence half — canonical RewardEvents SQLite table + superChatEvents.list (30-day) backfill + session-report rollup (still in-memory only).
• TASK 3 item 16 (Text source); TASK 40 units A/C/D; TASK 32–36; TASK 12 master limiter — all queued unchanged.

Around the task (carried facts)

• RealMouseDrag tests no-op while a game/fullscreen window steals the mouse (POE 2 seen 2026-09-22) — close fullscreen windows before full-suite runs; the single test passes in isolation when re-run alone. AudioPipeline timing flake similar.
• Test-env trap: saved OAuth session loads synchronously → force vm.IsConnected in signed-in tests.
• subscriberCount YPP slice 2 needs re-consent — do not merge with other units. $99/yr Polar must become one-time before launch. MARCOM.md/MONETIZATION.md gitignored — never commit.
• Latent bug the YPP 403 masked: statistics are JSON strings — always the ValueKind-first ReadInt64 (MyMistakes recipe), never GetInt64.
• API facts (TASK 44 + 45): a liveChatId fetch before the broadcast is live returns nothing by design (read snippet.liveChatId, poll until active); 400 MISSING_REQUIRED_FIELD from liveChat/messages.insert = wrong body shape (missing snippet.type), NOT auth/scope.
• WPF test technique (TASK 46): a MouseButtonEventArgs { RoutedEvent = Mouse.PreviewMouseLeftButtonDownEvent } raised on the window root deterministically simulates an "outside the drawer rail" click — InputBindings are NOT triggered by RaiseEvent.
• TASK 47 sticky facts: bgra from ffmpeg is opaque (alpha=255); audio pipe = carry-buffer loop (PCM bytes → float chunks straddle pipe reads); default clip lives at %TEMP%\ytLive-alert-{id}.mp4 when materialized; decoder per-play, never the refcounted MediaVideoSourceManager. Recipe in MyMistakes.md. DB stays user_version 10 — TASK 47's Source columns are additive guarded ALTERs.
• Every committed change needs a close + relaunch of the running app to be seen.

Next step

1. Run scripts/scope-check.sh with the declared file list (TASK 47), final clean build (verify, 0 warnings, "/mnt/c/Program Files/dotnet/dotnet.exe" build ytLive.csproj) + full vstest.
2. Single commit (code + this unit's docs: ai.md, TASKS.md, TASKS/task-47-alert-videos.md, Services/index.md, HANDOFF.md, MyMistakes.md). Push at the creator's go/milestone.
3. When scoped: TASK 3 item 20 (RewardEvents persistence half) draws next.

Critical working rules (unchanged, still binding)

• Good Dog = ONE integration test per change. Scope lock + ./scripts/scope-check.sh before commit.
• Windows dotnet host for all WSL builds (/mnt/c/Program Files/dotnet/dotnet.exe, quoted paths).
• 0 warnings on real clean builds (verify only, never incremental). One runtime model.
• No menus/polls with the creator; decisions asked once then held; do the work, then report.