# HANDOFF — Session State

## Branch / Commit State

**`main`**, working tree is **CLEAN**.

Commits `46978b8` (AGENTS push policy), `fc33022` (HANDOFF), and refactor
commits `0–5` through `e286719` are **pushed** (incl. `refactor-commit-0..5`).
Refactor commits **6–11 are LOCAL ONLY** (policy 2026-08-30: no per-commit
push; `git push --tags` only at a user-agreed milestone / "push it"):

| Commit | Hash | Tag | Partial | Lines |
|--------|------|-----|---------|-------|
| 6 Audio | `c1126a5` | `refactor-commit-6` | `MainViewModel.Audio.cs` | 408 |
| 7 Trax | `535a501` | `refactor-commit-7` | `MainViewModel.Trax.cs` | 132 |
| 8 Socials | `c41ff7f` | `refactor-commit-8` | `MainViewModel.Socials.cs` | 161 |
| 9 Streaming | `e1006a0` | `refactor-commit-9` | `MainViewModel.Streaming.cs` | 787 |
| 10 Chat | `3b77a13` | `refactor-commit-10` | `MainViewModel.Chat.cs` | 194 |
| 11 Overlays | `1efde5a` | `refactor-commit-11` | `MainViewModel.Overlays.cs` | 194 |

Nightly summary: **Phase 1 complete.** The plan was 11 partials + scaffold;
all live in `ViewModels/`. Core `MainViewModel.cs` shrank 1,890 → **758
lines**. Every change: clean build (0 warnings), `scripts/verify.sh` (246
passed + 2 known failures only), `scripts/scope-check.sh` with explicit file
args, `ViewModels/index.md` updated in the SAME commit, tagged
`refactor-commit-N`, no per-commit push.

## What's In Flight

Nothing code-in-flight — working tree clean, Phase 1 done.

**Next (queued, not started): Phase 2 — split `MainWindow.xaml` (1,681 lines)
into UserControls.** Same rules: one work unit per control, docs in the same
commit, verify + scope-check, commit locally, `git push` only on user go.

**Push pending:** refactor commits 6–11 + their tags are local. The Session-1
push checkpoint was never reached because the user directive was to run the
series to completion; Phase 1 completion is the natural milestone to push on
explicit user confirmation.

## Landmines

- **Pre-existing test failures (do not chase):**
  `AudioPipelineTests.Mix_HonorsProviderGains_AndGameMute_KillsTheLoopback` +
  `RoundClipInteractionTests.Round_Clip_Corner_Is_Grabbable_And_Shape_Is_Circle`.
- **Tests occasionally abort early (236/237)** — known flake, accepted by `verify.sh`.
- **App running locks `ytLive.exe`** → build fails MSB3027. Kill PID before building.
- **Implicit usings are SDK-default but partials must still carry their own
  domain usings** (they do not inherit core's): `ICommand`/`ObservableCollection`/
  `WriteableBitmap`/`DispatcherTimer` etc. are NOT implicit. Grep-verified usings:
  - Audio: Input, Media, Threading, `NAudio.CoreAudioApi`, `ytLive`, Helpers, Models, Services, Services.Audio
  - Trax: IO, Media, `Microsoft.Win32`, Helpers, Models, Services.Audio
  - Socials: Windows, Input, Media, `ytLive`, Helpers, Models, Services, Services.Compositor
  - Streaming: ObjectModel, IO, Windows, Input, Threading, `Microsoft.Win32`, Helpers, Models, Services, Services.Encoder
  - Chat: ObjectModel, Media, Media.Imaging, Threading, Helpers, Models, Services
  - Overlays: Diagnostics, IO, Input, Helpers
- **Pre-commit gate:** `scripts/verify.sh` (0-warning build + full tests) and
  `scripts/scope-check.sh "file1" …` — scope-check REQUIRES explicit file args.
- Build from WSL with the Windows dotnet host only (see `AGENTS.md`).

## Todo state

- MainViewModel refactor: **Phase 1 complete (11/11 partials + scaffold).**
  `ViewModels/index.md` has a per-partial table row (code↔commit map in the
  tracker section). Core row now describes only what remains (ctor wiring,
  lifecycle, source commands, WebView2 hosting, frame-pump seam,
  `SelectedElement`, `BrandFlash*`, `BuildCompositorOptions`/`ResolveOutputFrame`).
- TASK 3: 27/30 (preview compositor 16, text source 17, alerts 20 still open).
- TASK 4: ✅ shipped. TASK 9: items 1–3 shipped; 4–7 open. TASK 10: steps 1–7; Velopack pending.
- TASK 18: shipped, creator verification pending. TASK 19/23, 20, 21-A: shipped.
- TASK 22 (audio sync offset): not started — required for v1.
- Monitoring: cross-partial private access is the point of partial classes —
  no moved member re-declared anywhere; moved setters reference other partials
  purely by name.

## Session summary (2026-08-30)

- Ran the MainViewModel split to completion under the standing directive
  ("continue until you can continue no longer" — no interruption prompts).
- Commits 9 (Streaming), 10 (Chat), 11 (Overlays) landed locally, each ~8:40
  back-to-back: cut → 0-warning build → verify (246 pass + 2 known) →
  scope-check → index.md in-commit → `git tag refactor-commit-N`. No push.
- Streaming was the hardest cut (interleaved props, master-frame consts,
  session timer, health pipeline, record rename-on-stop); Chat and Overlays
  were clean contiguous cuts. One build fix each: Streaming needed
  `ObjectModel`/`Input`, Chat needed `Media.Imaging` for `WriteableBitmap`.
- Docs kept honest throughout: `index.md` rows for Streaming/Chat/Overlays,
  About-hub row re-pointed to the Overlays partial, core row trimmed each time.