From 86fcd868a82f5383e96694e9f3314eb17bc11a48 Mon Sep 17 00:00:00 2001
From: gramps <gramps@llamachile.shop>
Date: Fri, 14 Aug 2026 18:48:42 -0700
Subject: [PATCH] =?UTF-8?q?Monetization=20policy=20locked=20+=20dev=20paus?=
 =?UTF-8?q?e=20recorded=20(docs=20changeset,=202026-08-14):=20the=20one=20?=
 =?UTF-8?q?paid=20line=20becomes=20an=20annual=20subscription=20=E2=80=94?=
 =?UTF-8?q?=20early=20access=20$49.99/yr=20=E2=86=92=20$99/yr=20list=20at?=
 =?UTF-8?q?=20GA,=20grandfather-while-subscribed=20with=20lapse=20?=
 =?UTF-8?q?=E2=86=92=20list=20on=20renewal=20(no=20escalation=20matrix);?=
 =?UTF-8?q?=20free=20tier=20unchanged=20(branding=20flash=20is=20the=20fre?=
 =?UTF-8?q?e=20tier's=20billboard=20+=20no=20Alerts,=20which=20is=20the=20?=
 =?UTF-8?q?one=20paid=20feature);=20billing=20NOT=20locked=20to=20itch.io?=
 =?UTF-8?q?=20(hunted=20fact:=20itch.io=20has=20no=20native=20subscription?=
 =?UTF-8?q?=20billing=20=E2=80=94=20candidates=20Gumroad,=20whose=20native?=
 =?UTF-8?q?=20affiliate=20program=20is=20the=20tiebreaker,=20and=20Lemon?=
 =?UTF-8?q?=20Squeezy);=20support=20=3D=20in-app=20bug-report=20=E2=86=92?=
 =?UTF-8?q?=20git=20issues=20with=20a=20when-I-get-around-to-it=20cadence?=
 =?UTF-8?q?=20+=20emergency=20patches.=20ai.md=20Monetization=20section=20?=
 =?UTF-8?q?rewritten=20+=20stale=20paid-unlock=20seams=20fixed=20(L115=20s?=
 =?UTF-8?q?ubscription-entitlement=20wording,=20the=20About=20hub's=20tabl?=
 =?UTF-8?q?ed=20billing=20PremiumUrl=20seam);=20TASKS.md=20gains=20TASK=20?=
 =?UTF-8?q?23=20(Monetization=20=E2=80=94=20billing=20provider=20decision,?=
 =?UTF-8?q?=20unlock=20mechanism=20with=20lapse=E2=86=92flash-returns=20en?=
 =?UTF-8?q?forcement,=20in-app=20bug-report=20loop,=20Unlock=20Premium=20s?=
 =?UTF-8?q?eam=20lighting,=20Alerts=20gating,=20and=20line-item=20pointers?=
 =?UTF-8?q?=20for=20the=20early-access=20strategy,=20affiliate/ads=20phase?=
 =?UTF-8?q?=202,=20and=20the=20channel=20revival);=20HANDOFF.md=20records?=
 =?UTF-8?q?=20the=20decisions=20+=20the=20development=20pause=20(resume=20?=
 =?UTF-8?q?streaming=20=3D=20pair-programming=20dev=20streams=20via=20OBS?=
 =?UTF-8?q?=20+=20The=20Division=202=20under=20the=20gramps/GOAT=20persona?=
 =?UTF-8?q?,=2067=20and=20gaming=20since=201981,=203D-printing=20content?=
 =?UTF-8?q?=20retired;=20dogfood=20switch=20to=20ytLlive=20once=20TASK=205?=
 =?UTF-8?q?=20lands;=20resume=20point=20=3D=20TASK=205).=20Stale=20itch.io?=
 =?UTF-8?q?=20assertions=20corrected=20across=20comments=20and=20indexes?=
 =?UTF-8?q?=20(MainViewModel.cs=20PremiumUrl/IsPremium=20seams,=20MainWind?=
 =?UTF-8?q?ow.xaml=20tooltip,=20AboutHubTests=20comment,=20ViewModels/inde?=
 =?UTF-8?q?x.md,=20TASK=209=20out-of-scope=20note).=20Build=200=20warnings?=
 =?UTF-8?q?,=20196=20tests=20passing?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 HANDOFF.md                    | 64 +++++++++++++++++++----------------
 MainWindow.xaml               |  2 +-
 TASKS.md                      | 49 +++++++++++++++++++++++++--
 ViewModels/MainViewModel.cs   |  8 ++---
 ViewModels/index.md           |  2 +-
 ai.md                         | 30 +++++++++++-----
 ytLive.Tests/AboutHubTests.cs |  2 +-
 7 files changed, 110 insertions(+), 47 deletions(-)

diff --git a/HANDOFF.md b/HANDOFF.md
index 2979185..b6df16d 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -7,35 +7,39 @@
 
 ## Session state (last updated: 2026-08-14)
 
-- **Branch:** `main` (audio milestone work is uncommitted, see "Uncommitted").
-- **AUDIO MILESTONE (TASK 9) — SHIPPED this session.** Real stream audio + voice filters + auto-duck
-  + free TRAX background music. Build **0 warnings**, full suite **196 passing** (ONE integration
-  test: `AudioPipelineTests.Mix_WithFiltersDuckAndGain_Lands_On_AudioPipe`). Everything below in the
-  milestone section is DONE. **NOT yet committed** — next step is review + commit (with `ai.md`/
-  `TASKS.md`/this file already updated in the same changeset).
-- **Two build-time deviations from the settled plan (both recorded in ai.md + TASKS.md):**
-  1. `MusicPlayer` uses **`WaveOutEvent`** (new sibling package `NAudio.WinMM` 2.2.1) — not `WasapiOut`
-     as planned; `WaveOutEvent` isn't in `NAudio.Wasapi`/`NAudio.Core`.
-  2. No forced 48 kHz capture — NAudio 2.2.1's `WasapiCapture` has no overridable
-     `GetDefaultMixFormat`, so both sources run the device mix format and the mixer's
-     `TinyResampler` normalizes any rate to 48 kHz (resampler IS the design, not a fallback).
-  3. `FfmpegEncoder.cs` is **untouched** — the VM closes the audio pipe (`_audioMixer.StopLive()`) in
-     `StopStream` BEFORE the frame pump stops (audio EOF then video EOF, in order).
-- **SERVER RECOVERY (llamachile.tube / YunoHost / DO droplet) — done earlier session.** Side task
-  complete; **rotate the DO API token** (control-panel only) and any password no longer trusted.
-- **Shipped, all pushed before this session:** TASK 21 (creator-hub About, `3d92bd0`), TASK 8 (meter
-  +10 dB), TASK 4 ship step 7 (one-click go-live + private-only). **174 tests passing, 0 warnings.**
-- **Uncommitted (whole TASK 9 milestone):** `Services/Audio/` (new `VoiceFilterChain.cs`,
-  `AudioRingBuffer.cs`, `AutoDucker.cs`, `TinyResampler.cs`, `MusicPlayer.cs`, `NamedPipeAudioWriter.cs`,
-  rewritten `AudioMixer.cs`, simplified `WasapiMicAudioSource.cs`), `Models/Music.cs` (new),
-  `FfmpegArgs.cs`, `EncoderOptions.cs`, `LayoutStore.cs` (v9), `MainViewModel.cs`, `MainWindow.xaml`,
-  `MainWindow.xaml.cs`, `ytLive.csproj` (NAudio.WinMM), `ytLive.Tests/` (`AudioPipelineTests.cs` new,
-  `FfmpegEncoderTests.cs` + `LayoutStorePersistenceTests.cs` updated), and docs `ai.md`, `TASKS.md`,
-  `HANDOFF.md`.
-- **Next step:** commit the milestone (docs already staged in the same changeset), push, then start
-  **TASK 5** (reusable stream → `_rtmpUrlProvider` — the last blocker before go-live actually encodes).
-  Then **itch.io product page setup** (premium URL lands in `MainViewModel.PremiumUrl`, lights up
-  Unlock Premium). Optional, not queued: rewriting the healed entry's `ProfileUrl` to
+- **Branch:** `main`, tracking `origin/main` at **`f2f6401`** (pushed). Working tree was clean until the
+  monetization docs changeset below.
+- **AUDIO MILESTONE (TASK 9) — SHIPPED + COMMITTED + PUSHED this session.** Real stream audio + voice
+  filters + auto-duck + free TRAX background music. Build **0 warnings**, full suite **196 passing**
+  (ONE integration test: `AudioPipelineTests.Mix_WithFiltersDuckAndGain_Lands_On_AudioPipe`). Commits
+  **`6d71ace`** (milestone) + **`f2f6401`** (secrets cleanup), force-pushed (`725f5a7...f2f6401`).
+- **Secrets scrubbed from git history.** The DO token + passwords recorded in `HANDOFF.md` were removed
+  from the working file and **purged from all history** via `git filter-branch` over `3d92bd0..main`
+  + `git gc --prune=now --aggressive` (scan of all refs = 0 hits). They still exist in chat — **keep
+  treating as compromised**; rotate the DO API token. Old objects remain in llgit's store until server
+  GC (unreachable, not fetchable). If a value is ever needed, `git reflog` is expired — it's gone.
+- **MONETIZATION LOCKED (2026-08-14, creator).** One paid line = **annual subscription**: early access
+  **$49.99/yr** → **$99/yr list at GA**, **grandfather-while-subscribed**, lapse → list on renewal.
+  Free tier unchanged (branding flash = the billboard + no Alerts; Alerts is the paid feature).
+  **Billing NOT itch-locked** — itch.io has no native subscription billing; candidates Gumroad (native
+  affiliates = tiebreaker) / Lemon Squeezy. Support = in-app bug-report → git issues, "when I get
+  around to it" + emergency patches. Full policy in `ai.md` → Monetization; scoped plan + line-items
+  in `TASKS.md` **TASK 23**.
+- **DEVELOPMENT PAUSED (creator's call 2026-08-14) — resuming streaming instead.** Channel revival =
+  **pair-programming dev streams via OBS** (ytLlive can't go live yet: private-only + `_rtmpUrlProvider`
+  null) + **The Division 2** gaming streams under the **"gramps/GOAT"** persona (67, gaming since 1981).
+  3D-printing content retired (printer hard down, novelty gone). **Dogfood switch** later: when TASK 5 +
+  go-live capability land, stream *with* ytLlive — Division 2 (loud game + voice) is the demo for the
+  ducking/voice-filter story. Early-access strategy + affiliate/ads are their own future line-item tasks.
+- **Docs changeset in flight (THIS changeset):** `ai.md` Monetization rewritten + stale paid-unlock seams
+  fixed; `TASKS.md` TASK 23 added + TASK 21's itch.io URL mention corrected; this file rewritten. Commit
+  + push as one change.
+- **Shipped, all pushed:** TASK 21 (creator-hub About, `3d92bd0`), TASK 8 (meter +10 dB), TASK 4 ship
+  step 7 (one-click go-live + private-only), TASK 9 audio milestone (`6d71ace`), secrets cleanup
+  (`f2f6401`).
+- **Resume point (when dev starts again):** **TASK 5** — reusable stream → `_rtmpUrlProvider` (the last
+  blocker before go-live actually encodes + pushes). Then TASK 23 (billing + unlock + support).
+  Optional, not queued: rewriting the healed entry's `ProfileUrl` to
   `https://mastodon.llamachile.tube/@gramps` (user must say the word).
 
 ## TASK 9 audio milestone — SHIPPED 2026-08-14 (what changed)
@@ -67,7 +71,7 @@ and `ai.md` ("Live audio capture"). Highlights:
   start-of-stream silence race was seen and eliminated).
 
 **Out of scope this branch:** IP webcam, chat box, alt-key crop, credits, bg removal, music-off-VOD
-track (YouTube mutes VODs with copyrighted music — future feature), itch.io `PremiumUrl`.
+track (YouTube mutes VODs with copyrighted music — future feature), `PremiumUrl` (TASK 23 seam).
 
 - **Landmines:**
   - Never add another test that constructs `new App()` — use `RealAppHost.Run(...)` (shared STA host
diff --git a/MainWindow.xaml b/MainWindow.xaml
index d6fddcc..b23a3c5 100644
--- a/MainWindow.xaml
+++ b/MainWindow.xaml
@@ -1158,7 +1158,7 @@
                                 <Button Content="Unlock Premium" Command="{Binding OpenPremiumCommand}"
                                         Style="{StaticResource YtButtonSecondary}"
                                         IsEnabled="{Binding IsPremiumAvailable}"
-                                        ToolTip="Coming soon — the itch.io unlock page is being set up"/>
+                                        ToolTip="Coming soon — subscription billing is on the way (TASK 23)"/>
                             </StackPanel>
 
                             <Button Content="Licenses &amp; legal" Command="{Binding OpenLicensesCommand}"
diff --git a/TASKS.md b/TASKS.md
index 1f7b5cc..1633a2e 100644
--- a/TASKS.md
+++ b/TASKS.md
@@ -115,7 +115,7 @@ Lifecycle: `created → ready → [testing] → live → complete` (transitional
 18. ☐ **Chat box** — YouTube live chat rendered *on* the stream so viewers read along in-video
 19. ❌ **Background removal (milestone 2)** — ONNX Runtime + DirectML, MediaPipe Selfie Segmentation — deliberately NOT in this build
 20. ☐ **Alerts** — Super Chat / membership / subscribe pop-ins; build after the six; **the one paid feature** (see Monetization in `ai.md`)
-21. ✅ **Logo + richer in-app About (2026-08-13, queued → 2026-08-14 SHIPPED)** — the ytLlive wordmark in the top bar opens the About overlay (already wired); the About overlay is now the **creator hub**: the real logo (the "llama fortnite superman logo" from the creator's vault, copied to `Assets/llama-logo.png` — the creator's own art, no third-party license), plus **creator-hub links** — llama chile shop on YouTube (`MainViewModel.ChannelUrl`), Mastodon (`https://mastodon.llamachile.tube/@gramps`), **Buy me a coffee** (`https://buymeacoffee.com/llamachiley` — live), and **Unlock Premium** (greyed "coming soon" — the itch.io product URL is a tabled seam, `PremiumUrl`, until the account is set up). A **Licenses & legal** button flips the About overlay to an in-app scrolling panel that loads the full `THIRD-PARTY-NOTICES.txt` text (`MainViewModel.ShowLicenses` reads the shipped file from the executable directory on first open; graceful "not found" fallback — **never the OS viewer, everything stays in-app**); "← Back to About" returns. The About overlay is also the in-app home of the notices — the top-bar About button that opened the file in the OS viewer was removed on 2026-08-13 for exactly this reason. Integration test (Good Dog Rule — ONE): `AboutHubTests.About_Opens_InApp_Licensing_Loads_Shipped_Notices` drives the real window + VM, asserting the hub opens, the link URLs are real, the licensing panel loads the shipped notices text (contains "Third-Party Notices" + "LGPL"), and back returns to the hub. 174 tests passing, 0 warnings
+21. ✅ **Logo + richer in-app About (2026-08-13, queued → 2026-08-14 SHIPPED)** — the ytLlive wordmark in the top bar opens the About overlay (already wired); the About overlay is now the **creator hub**: the real logo (the "llama fortnite superman logo" from the creator's vault, copied to `Assets/llama-logo.png` — the creator's own art, no third-party license), plus **creator-hub links** — llama chile shop on YouTube (`MainViewModel.ChannelUrl`), Mastodon (`https://mastodon.llamachile.tube/@gramps`), **Buy me a coffee** (`https://buymeacoffee.com/llamachiley` — live), and **Unlock Premium** (greyed "coming soon" — the **billing** product URL is a tabled seam, `PremiumUrl`, until TASK 23 picks the subscription provider). A **Licenses & legal** button flips the About overlay to an in-app scrolling panel that loads the full `THIRD-PARTY-NOTICES.txt` text (`MainViewModel.ShowLicenses` reads the shipped file from the executable directory on first open; graceful "not found" fallback — **never the OS viewer, everything stays in-app**); "← Back to About" returns. The About overlay is also the in-app home of the notices — the top-bar About button that opened the file in the OS viewer was removed on 2026-08-13 for exactly this reason. Integration test (Good Dog Rule — ONE): `AboutHubTests.About_Opens_InApp_Licensing_Loads_Shipped_Notices` drives the real window + VM, asserting the hub opens, the link URLs are real, the licensing panel loads the shipped notices text (contains "Third-Party Notices" + "LGPL"), and back returns to the hub. 174 tests passing, 0 warnings
 22. ✅ **Voice filters on the mic channel (2026-08-13 queued → SHIPPED 2026-08-14 inside TASK 9, the audio milestone)** — the standard four applied to the sound input path (before the meter/encoder mix): **bass boost, treble, noise suppression, compressor** (set decided with the creator 2026-08-13). Noise suppression = a **pure-C# noise gate** (creator chose over RNNoise / a second ffmpeg `afftdn` pipe, 2026-08-14 — KISS). Always-on — no UI knobs; the mic stays the creator's single audio control
 
 ### The Minimal Source Set (design decision — do not expand casually)
@@ -554,7 +554,7 @@ the validator → persisted), compositor bar overlay (top/bottom + above-flash),
 
 **Testing (Good Dog Rule — ONE integration test):** `AudioPipelineTests.Mix_WithFiltersDuckAndGain_Lands_On_AudioPipe` — real filter chain + mixer + ducker + `NamedPipeAudioWriter`, fake `IAudioSource`s, test-side `NamedPipeClientStream` reads the bytes and asserts post-filter/post-gain/post-duck mixed stereo (ring buffers pre-filled so the first pipe tick already carries real audio — avoids a start-of-stream silence race). Units: each DSP stage (known sine-in → expected gain), ring buffer wrap/underflow/overwrite, ducker envelope, resampler (down/up/stateful/identity), `FfmpegArgs` pipe+map, schema v9 roundtrip + no-music-row. Existing tests stay green.
 
-**Out of scope (this branch):** IP webcam (video-only when it lands — never an audio input), chat box source (TASK 3 item 18), alt-key crop, credits, background removal, music-off-VOD, itch.io `PremiumUrl` (TASK 21 seam).
+**Out of scope (this branch):** IP webcam (video-only when it lands — never an audio input), chat box source (TASK 3 item 18), alt-key crop, credits, background removal, music-off-VOD, `PremiumUrl` (TASK 23 seam).
 
 ---
 
@@ -590,6 +590,51 @@ the validator → persisted), compositor bar overlay (top/bottom + above-flash),
 
 ---
 
+## TASK 23 — Monetization: subscription billing + in-app unlock + support (2026-08-14, scoped)
+
+**Goal:** turn the settled monetization policy (see `ai.md` → Monetization) into a paying product line:
+annual subscription billing, an in-app unlock seam, and the in-app bug-report → git-issues support loop.
+
+**Decisions already locked (2026-08-14, creator):** one paid line = **annual subscription** (early
+access **$49.99/yr** → **$99/yr list at GA**; grandfather-while-subscribed, lapse → list on renewal;
+no escalation matrix). Free tier unchanged (branding flash + no Alerts; the flash is the free tier's
+billboard — distribution, not compromise). Billing **not locked to itch.io** (hunted fact: itch.io has
+no native subscription billing); candidates **Gumroad** (native affiliates = tiebreaker) and **Lemon
+Squeezy**. Support = in-app bug-report → git issues; "when I get around to it" cadence + emergency
+patches. Unlock outcome: flash removal flips `BrandFlashEnabled` off + **Alerts** on.
+
+### Status: 🔶 Scoped — nothing built; this entry records the plan + decisions
+
+1. ☐ **Billing provider decision** — Gumroad vs Lemon Squeezy (annual subs + license-key verification
+   APIs; Gumroad's native affiliate program is the tiebreaker if the TASK 23 affiliate line-item matters)
+2. ☐ **Unlock mechanism** — license-key entry + online/offline verification + persisted entitlement
+   (extends `LayoutStore`, schema bump) + renewal/lapse handling (**lapse → branding flash returns** —
+   the flash is the enforcement and the billboard)
+3. ☐ **In-app bug-report → git issues** — a built-in report control that files an issue (title/body/
+   log attachment) into the creator's git repo; the support loop, per the settled support model
+4. ☐ **"Unlock Premium" seam** — the About hub's greyed button (TASK 21; `PremiumUrl` is the tabled
+   billing URL) lights up and routes to the billing page / unlock dialog
+5. ☐ **Alerts gating** — the Super Chat pop-ins (TASK 3 item 18 / minimal source set item 7) are the
+   one paid feature; subscription state gates them
+6. **Line-item pointers (their own big tasks — do NOT start here):**
+   - ☐ **Early-access strategy** — the 90-day funnel (founder window $49.99 → GA $99), waitlist,
+     testimonials/QA, clips → Shorts. Separate planning effort.
+   - ☐ **Affiliate & ads (phase 2)** — own-channel gear affiliates from day one (organic), a
+     ytLlive referral program gated behind GA + happy users, YPP as the channel's ad revenue, paid
+     ads deferred.
+   - ☐ **Channel revival (the prequel to both)** — **resume streaming**: pair-programming dev
+     streams via **OBS** (ytLlive can't go live yet — private-only + `_rtmpUrlProvider` null) +
+     **The Division 2** gaming streams under the **"gramps/GOAT"** persona (67, gaming since 1981).
+     3D-printing content retired (printer hard down, novelty gone). **Dogfood switch** — once TASK 5 +
+     go-live capability land, stream *with* ytLlive; Division 2 (loud game + voice) is the demo for the
+     ducking/voice-filter story. The flash billboard + the grandfather promise are the monetization
+     hooks this line-item feeds.
+
+**Out of scope (TASK 23):** the early-access strategy itself, the affiliate program, channel content
+planning — those are separate line-item tasks. TASK 23 owns billing + unlock + support + gating only.
+
+---
+
 ## TASK 6 — Layout Persistence (SQLite)
 
 **Goal:** Scenes, sources, and asset bytes survive restarts; assets are always available.
diff --git a/ViewModels/MainViewModel.cs b/ViewModels/MainViewModel.cs
index c6ed684..dd9cdd5 100644
--- a/ViewModels/MainViewModel.cs
+++ b/ViewModels/MainViewModel.cs
@@ -140,14 +140,14 @@ public class MainViewModel : ViewModelBase
     // integration test can assert they point at real destinations.
     public const string ChannelUrl = "https://youtube.com/@llamachileshop";
     public const string MastodonUrl = "https://mastodon.llamachile.tube/@gramps";
-    // Tabled 2026-08-14: the itch.io account was just created — the product page
-    // (premium unlock) lands here once set up. Coffee/thanks URL is live.
+    // Tabled 2026-08-14: the billing provider is not chosen yet (Gumroad/Lemon Squeezy — TASK 23);
+    // the subscription page (premium unlock) lands here once set up. Coffee/thanks URL is live.
     public const string PremiumUrl = "";
     public const string CoffeeUrl = "https://buymeacoffee.com/llamachiley";
     public static string AppVersionLabel => $"Version {typeof(MainViewModel).Assembly.GetName().Version?.ToString(3)}";
 
     /// <summary>The About hub's Unlock Premium button lights up only once the
-    /// itch.io product URL is set (tabled 2026-08-14 — account in setup).</summary>
+    /// billing URL is set (tabled 2026-08-14 — provider undecided, TASK 23).</summary>
     public bool IsPremiumAvailable => PremiumUrl.Length > 0;
 
     /// <summary>Full in-app licensing/legal text, loaded on demand from the
@@ -244,7 +244,7 @@ public class MainViewModel : ViewModelBase
     public SocialsConfig? Socials => _socials;
 
     /// <summary>Freemium: 6 slots — YT + 1 other, the rest locked. Premium seam: all 6 open.</summary>
-    private static bool IsPremium => false; // itch.io unlock deferred — seam only
+    private static bool IsPremium => false; // unlock deferred (TASK 23) — seam only
 
     /// <summary>Canvas.Top for the social bar: 0 = top, 1040 = bottom (40px from the 1080 edge).</summary>
     public double SocialBarTop => _socials?.BarPosition == SocialBarPosition.Top ? 0 : 1040;
diff --git a/ViewModels/index.md b/ViewModels/index.md
index e68ee6f..3e71605 100644
--- a/ViewModels/index.md
+++ b/ViewModels/index.md
@@ -6,7 +6,7 @@ MVVM layer. See [`schema.md`](../schema.md) for the memory-map conventions.
 |------|---------|
 | `MainViewModel.cs` | The app brain: scenes/elements collections + commands, stream state (`IsLive`/`IsOffline`/`IsConnected`), chat feed, overlays, layout save/open, **resolution dropdown** (`QualityOptions`, `SelectedQuality`, `ResolutionHelp`, `ApplyStreamQuality`) that computes the output rect over the 1920×1080 master (`OutputRectX/Y/W/H`, `DimRects`, `IsOutputCropped`, `ResolutionBadgeText`). Auth: loads the saved DPAPI session at startup (`LoadSavedSessionAsync`), `SignInAsync` feeds the GoLive dialog; **go-live (ship step 7): `BeginGoLive` accepts the dialog → sets `StreamVisibility` (always "Private") → fires `CreateBroadcastAsync` (stores `_currentBroadcastId` for TASK 5's bind/transition; failure → `StreamStatus.Error`) + `_framePump.StartAsync()`**; **End Livestream signs out** (`StopStream` clears session + token + `_currentBroadcastId` — crash-safe). **Connected account:** top-bar avatar/name (`AccountAvatarUrl`/`AccountDisplayName` via `SyncConnectedAccount`, cleared on End). **Element rows:** scenes are pure selection rows (no per-row icons); source rows carry edit/visibility/trash (`EditElementCommand` sets `element.IsEditing`, `ToggleElementVisibilityCommand` flips `IsVisible`, `RemoveSourceCommand`); duplicate resource names get a no-space incrementing suffix via shared `NextSourceName` (Image, Image2, Image3… — next free number derived from actual names, so deletions never collide; used by `AddSource` + `AddReusedImage`). **Audio (KISS — the mic is the creator's only audio control; capture SHIPPED, runs for the app's lifetime so the meters preview live):** the sound meter is a **READ-ONLY realtime level display**: fill = `Math.Min(1, AudioLevelMeter.ToDisplay((float)AudioLevel) * MicVolume)` (`MeterFillWidth`/`MeterBrush`, green→yellow→red, zone markers at 60%/80% — `ToDisplay` maps the raw linear RMS onto a −60..0 dBFS scale with +10 dB amplification so real speech/game levels occupy the bar and peaks hit red at maxed volume), where `AudioLevel` (live input, 0 with no input) is fed by the audio mixer once capture lands and `MicVolume` acts as a gain on ambient noise; while the slider is dragged the bar previews the slider position (`SetVolumeAdjusting`), returning to the live level on release (0 with no input — clicking the meter does nothing); `MicVolume` (default 0.8) + read-only `MicMuted`/`MicMuteText`/`ToggleMicMuteCommand` — **MicVolume drives MicMuted** (muted ⇔ volume 0): sliding to 0 flips the speaker to muted, sliding up from 0 clears it; muting stores the prior volume, unmuting restores it (default 0.8 if unknown) and flashes the meter to the restored position ~300ms (`BeginVolumeFlash`/`EndVolumeFlash`); `MicSourceName` = picked voice source, shown left-justified inside the meter bar (the fill runs at 75% opacity so the text + ruler markings show through); `OpenMicPickerCommand`/`PickMicrophone()` open the `MicPickerDialog` (a picked device takes effect immediately — `PickMicrophone` swaps the live source via `_audioMixer.RestartMic()`, loopback keeps running); the **MIC label is a button** (`OpenMicPickerCommand`) with a **status dot** (`MicStatus`, `Models/MicStatus`: green = `MicConnected` via the source's `Started` event, yellow = `MicFailed` — in use/unplugged, red = no mic device at startup; `MicStatusBrush`/`MicStatusToolTip`); capture starts once at startup (`StartMicCaptureAsync`) — NOT go-live (`BeginGoLive`/`StopStream` no longer touch the mixer) — zero devices = red dot + the mixer never starts. **Game audio bar** (desktop/game, **overlaid at the bottom of the preview window** — bottom-center chip, a mirror of the mic bar): `IsGameAudioBarVisible` (shown only while a full-screen game is producing sound — the VM polls `IGameAudioDetector` via the default `GameAudioDetector` every 250ms (`_gameAudioTimer`); the pure `GameAudioHysteresis` SHOWs after ~500ms of fullscreen+sound, HIDEs ~1s after leaving fullscreen, and **silence never hides an active bar**), `GameAudioLevel` (loopback meter via `LoopbackLevelChanged`, scaled by volume), `GameMuted`/`GameMuteText`/`ToggleGameMuteCommand`, `GameAudioVolume` (0..1 volume slider), `Begin/End/CancelGameVolumeFlash` (mirrors the mic bar's volume flash); the game speaker + slider share the mic bar's `PreviewMouseLeftButtonDown/Up` + `LostMouseCapture` code-behind pattern. **Webcam:** owns `CameraManager` (MediaCapture), `AddWebcamToActiveSceneAsync` (picker → default 480×270 bottom-right placement → acquire; the Windows camera picker ALWAYS opens so the creator chooses — never silently reuses the previous camera; picking a different camera swaps the app-wide identity via `SwapWebcamIdentityAsync`, same path as `ChangeWebcamAsync`; propagates the running shared bitmap via `CameraManager.GetPreviewBitmap` first, so a webcam added mid-session never renders a transparent container; greys out when the active scene already has a config via `CanAddWebcamToActiveScene`), `ChangeWebcamAsync` (device swap — `ReleaseAllAsync` old + re-acquire), `ShowWebcamInActiveScene` (reveal hidden config / empty-canvas right-click), `ReacquireWebcam` after layout load (re-propagates the shared bitmap to every config), `OnCameraPreviewBitmapChanged` forwards the shared bitmap into every `WebcamSceneConfig.VideoImageSource`; `SelectedElement` drives the preview overlay + `internal ClampWebcamToBounds(config, sceneName)` (per-scene size cap seam: 50%-per-dimension everywhere, half-screen-AREA in Chat via `MaxWebcamWidthFor`/`MaxWebcamHeightFor`). **Scenes (five-scene catalog):** empty DB seeds Starting/Live/BRB/Chat/Ending (`SceneCatalog.All`); `AddScene(name)` accepts only canonical, missing names; `MissingScenes`/`ShowAddScene` drive the "+" button (hidden once all five exist; its menu lists only the missing scenes via `AddSceneCommand`). **Screen backdrop (Live-only by policy):** owns `ScreenCaptureManager` + `ScreenCaptureSourceFactory` (WinRT GraphicsCapture), `internal static EnsureBackdrop` heals one per backdrop-enabled scene (gated on `Scene.HasBackdrop`), `ReacquireScreenCaptures`/`RefreshBackdropAutoCapture`/`NoteBackgroundWindow` key by full-screen game monitor or the **primary display** via `Win32FullScreenDetector` (`GetDisplays()`/`PrimaryMonitorIndex()`), `ChangeBackdropCaptureAsync` (OS picker) + `SetBackdropCapture(DisplayInfo)` (in-app "Capture Display"), `RedesignateBackdropAsync` re-targets all backdrops and releases orphaned sessions, `internal static EnforceBackdropPolicy` normalizes `Scene.HasBackdrop` by name on every load + strips lingering non-Live backdrops, `CanChangeBackdrop` gates the capture menu to Live (the only scene with a backdrop), `BackdropImage` hides the preview watermark (`ShowPreviewPlaceholder`). **REC sign (2026-08-13):** top-center indicator always visible — `RecDotBrush` (offline `#555555`, live `#e94560`, live-private `#8f1f1f`), `RecTextBrush` (dim offline, white live), `RecDotOpacity` (0.55 offline, pulsing 1.0/0.35 live via `_recDotPulse` flipped on the live tick), `IsLivePrivate` (`IsLive && StreamVisibility == "Private"`) — notified from the `StreamStatus` + `StreamVisibility` setters; `LiveIndicatorVisible`/`LivePulseOpacity` removed. **Mic mute icon:** a second 16px clickable glyph (mic, red + slash when muted) between the meter and the speaker on the mic bar — same `ToggleMicMuteCommand`. **Health stats (TASK 4 ship step 6, 2026-08-13):** `OnFramePumpHealthUpdated` marshals `FramePump.HealthUpdated` (encoder's parsed bitrate/FPS/dropped/duration — raised on the stderr thread) onto the UI thread into `CurrentHealth` (bottom bar bindings); `ResetHealth(status)` zeroes dropped/duration on go-live/End so stats never linger |
 | `GoLiveViewModel.cs` | Start Stream dialog: **account row** (saved channel shown with Change Account, or Sign in to YouTube; Start gated on `IsSignedIn`/`IsBusy`) + title/description + **locked Visibility (always "Private" — ship step 7, no dropdown)**, start/cancel requests |
-| **About hub (TASK 21, in `MainViewModel`)** | the About overlay is the in-app creator hub: `ChannelUrl`/`MastodonUrl`/`CoffeeUrl` (public consts, live) + `PremiumUrl` (tabled itch.io seam → the greyed "Unlock Premium" button lights up when filled); `OpenLicensesCommand` → `ShowLicenses()` loads the shipped `THIRD-PARTY-NOTICES.txt` into `LicensesText` and sets `IsLicensesOpen` (in-app scrolling panel, never the OS viewer); `BackToAbout_Click` in `MainWindow.xaml.cs` flips it off. |
+| **About hub (TASK 21, in `MainViewModel`)** | the About overlay is the in-app creator hub: `ChannelUrl`/`MastodonUrl`/`CoffeeUrl` (public consts, live) + `PremiumUrl` (tabled billing seam — TASK 23 → the greyed "Unlock Premium" button lights up when filled); `OpenLicensesCommand` → `ShowLicenses()` loads the shipped `THIRD-PARTY-NOTICES.txt` into `LicensesText` and sets `IsLicensesOpen` (in-app scrolling panel, never the OS viewer); `BackToAbout_Click` in `MainWindow.xaml.cs` flips it off. |
 | `ReuseImageViewModel.cs` | Add Image dialog: candidate list (`ReuseImageCandidate`), reuse/new/cancel |
 | `CameraPickerViewModel.cs` | Add Webcam dialog: async camera list (loading / has / none states), `UseRequested(CameraDeviceInfo)`/`CancelRequested` |
 | `MicPickerViewModel.cs` | Select Microphone dialog (voice source): async mic list (loading / has / none states), `UseRequested(MicrophoneDeviceInfo)`/`CancelRequested` |
diff --git a/ai.md b/ai.md
index dae3661..16dfa6e 100644
--- a/ai.md
+++ b/ai.md
@@ -112,7 +112,7 @@ C# / WPF (.NET 8) following MVVM:
 ### Current limitations / TODOs
 
 - `Helpers/OAuthCredentials.cs` contains the real ClientId/ClientSecret. Auth is complete and the session **persists via Windows DPAPI** (`Helpers/TokenStore.cs` → `%APPDATA%\ytLlive\ytLlive.auth`, CurrentUser scope), reloaded best-effort at startup with a proactive refresh of a near-expiry access token. Sign-in/Change Account lives **inside the Start Stream dialog** (two-state flow — no separate Connect button). A **graceful End Livestream signs out**: `StopStream()` clears the session + token, so the next go-live needs a fresh sign-in; a crash never runs End, so the token survives and the creator stays signed in. `YouTubeAuthService` takes an optional `HttpClient` + `sessionChanged` callback (test seam + save hook; services are still constructed in `MainViewModel`)
-- Scene/source/asset layout + the social bar persist (SQLite, schema v8); the OAuth session persists (DPAPI); the paid-unlock state does not (yet — itch.io key verification pending)
+- Scene/source/asset layout + the social bar persist (SQLite, schema v8); the OAuth session persists (DPAPI); the paid-unlock state does not (yet — subscription entitlement verification pending, TASK 23)
 - `YouTubeStreamService` uses hardcoded `1080p`/`60fps` and per-broadcast streams — must switch to the v3 `variable` reusable stream
 - Webcam capture is shipped (milestone 1); the live desktop/game backdrop is shipped (ship task #1); **the output compositor (TASK 4 ship step 1) is SHIPPED**, **the FFmpeg locator (TASK 4 ship step 2) is SHIPPED**, **the encoder + RTMP push (TASK 4 ship step 3) is SHIPPED**, **WASAPI audio capture (TASK 4 ship step 4) is SHIPPED** — full plan in `TASKS.md`; the frame-pipeline wiring follows (its own PR)
 - `StreamConfig` defaults (`TargetBitrate=6000`, `Resolution="1920x1080"`) are stale — the live dropdown drives `StreamHealth.CurrentBitrate`/`FPS` instead
@@ -558,10 +558,10 @@ guardrails below — written down so a future "quick fix" never reintroduces a G
   release blocker). Queued early is wrong; the release pass owns it.
 - **Break the in-app About requirement** — since TASK 21 the About overlay is the app's in-app creator
   hub: the real logo, the creator links (YouTube channel, Mastodon, Buy me a coffee, and the greyed
-  "Unlock Premium" seam whose itch.io URL is tabled), and a **Licenses & legal** sub-panel that loads
+  "Unlock Premium" seam whose billing URL is tabled), and a **Licenses & legal** sub-panel that loads
   `THIRD-PARTY-NOTICES.txt` from the executable directory and renders it in a scrolling panel —
   **never the OS viewer, no Notepad, no browser tab**. The premium/coffee link constants live in
-  `MainViewModel` (`PremiumUrl`, `CoffeeUrl`, `ChannelUrl`, `MastodonUrl`); filling in the itch.io URL
+  `MainViewModel` (`PremiumUrl`, `CoffeeUrl`, `ChannelUrl`, `MastodonUrl`); filling in the billing URL
   lights up the premium button. Do not reintroduce an "open the notices in Notepad" button.
 
 ## Design Principle
@@ -576,9 +576,8 @@ Apply this to every UI decision:
 
 ## Monetization (design decision — the branding flash is the sword)
 
-Free forever: all streams unlimited, no time caps, no subscription, no per-feature paywalls. The
-**one paid line is a one-time unlock** (delivered via itch.io — they handle hosting, payment, and key
-delivery; we never own a server or a key shop):
+Free forever: all streams unlimited, no time caps, no per-feature paywalls. The **one paid line is an
+annual subscription** (settled 2026-08-14 — replaces the earlier "one-time unlock" shape):
 
 - **Free:** a periodic full-frame branding flash — "made with ytLlive!" rendered big and centered at
   ~25% opacity for about one second (soft 250ms fade in/out), repeated every 300s, on the live output
@@ -586,8 +585,23 @@ delivery; we never own a server or a key shop):
   (`MainWindow.xaml` CanvasGrid) + `BrandFlashTimer` in `MainViewModel` — cadence 300s, first flash
   ~5s after go-live, only while live or recording. An always-on watermark can be cropped or covered;
   an intermittent full-frame flash can't be cropped and is impractical to edit around on a live feed.
-- **Paid (one-time):** branding flash removed (flips `BrandFlashEnabled` off) + **Alerts**
-  (Super Chat / membership / subscribe pop-ins).
+  **The flash is also the free tier's billboard** — every free stream advertises ytLlive to its own
+  viewers; the free tier is distribution, not compromise.
+- **Paid (annual subscription):** branding flash removed (flips `BrandFlashEnabled` off) + **Alerts**
+  (Super Chat / membership / subscribe pop-ins). Alerts is the recurring-value engine — a live-API
+  feature we maintain forever, which is the strongest argument for a yearly bill.
+- **Pricing:** early-access founders rate **$49.99/yr** → **$99/yr list at GA** (v1). **Grandfathering:
+  early adopters keep $49.99/yr for as long as the subscription is maintained**; a lapse means renewal
+  at list. That's the whole policy — no escalation matrix (a realistic product lifetime is a few years;
+  keep the promise simple).
+- **Billing:** NOT locked to itch.io (creator's call 2026-08-14). Hunted fact — **itch.io has no native
+  subscription billing** (no annual/recurring product billing; only pay-what-you-want, pre-orders,
+  early-access, keys, and a Patreon integration). Candidates for annual subs + license-key verification:
+  **Gumroad** (its native affiliate program is a tiebreaker if the affiliate angle in TASK 23 matters)
+  and **Lemon Squeezy**. Decision deferred to TASK 23.
+- **Support (creator's model):** in-app bug-reporting mechanism → issues into git; most queries are
+  how-tos / feature requests / manual-skimmers. Maintenance cadence = "when I get around to it" with
+  emergency patches; not a 24/7 service promise.
 
 Deliberately rejected: always-on watermark (obscurable — replaced by the flash), hard stream-time
 cutoffs (the worst dead end — a stream dying mid-broadcast reads as broken, and YouTube streams
diff --git a/ytLive.Tests/AboutHubTests.cs b/ytLive.Tests/AboutHubTests.cs
index debe99e..beeabeb 100644
--- a/ytLive.Tests/AboutHubTests.cs
+++ b/ytLive.Tests/AboutHubTests.cs
@@ -42,7 +42,7 @@ public sealed class AboutHubTests
             Assert.False(vm.IsLicensesOpen);
 
             // The hub links resolve to real destinations (channel + mastodon +
-            // coffee are live; premium is the tabled itch.io seam).
+            // coffee are live; premium is the tabled billing seam).
             Assert.Equal("https://youtube.com/@llamachileshop", MainViewModel.ChannelUrl);
             Assert.Equal("https://mastodon.llamachile.tube/@gramps", MainViewModel.MastodonUrl);
             Assert.Equal("https://buymeacoffee.com/llamachiley", MainViewModel.CoffeeUrl);