# HANDOFF — 2026-10-29 (memory map restructured; text layer is next)

## State

- Branch `main`, worktree clean after this commit. **Docs-only session — not pushed** (push at a
  checkpoint the creator names).
- Commits: `a311c8f` partition `ai.md` into five subsystem docs · `c9ac348` router + invariants +
  doc-budget gate · this commit = decisions log, queue trim, handoff rewrite.

## What changed

- `ai.md` 1,308 → 64 lines (router). Subsystem truth: `docs/ai/{capture,frame-pipeline,output,
  overlays,youtube-api,ui-surface,product,environment,decisions}.md`.
- `AGENTS.md` is the single always-read file: rules + the 20 invariants.
- `TASKS.md` 467 → ~90 lines (active queue); the old catalogue is `TASKS/archive.md`.
- `scripts/verify.sh` now runs doc budgets first (AGENTS 210, ai 100, HANDOFF 40, TASKS 120).
- Creator's 2026-10-29 report: App Settings/gear, transitions and Brand logo **all working** — closed.

## Next action

**TASK 3·17 — the Text layer**: content, font family/size/weight/style, colour, alignment,
drag/resize, persisted; renderer mirrors `Services/ChatBoxRenderer.cs`. The type today is a
placeholder with no code behind it. One Good Dog test, code + memory in one commit.

## Landmines (live, not historical)

- `%APPDATA%\ytLlive` (capital L) — never rename it; it holds the layout DB, `Assets` and the auth
  token. Paths: `docs/ai/environment.md`.
- The **full test suite hangs** (WASAPI teardown, pre-existing); per-class runs work and are the way
  to validate. `RealMouseDrag_OnTheLayerList_…` is an environment flake, not a regression.
- `verify.sh`'s known-failure whitelist still matches on the two old test names; every other FAIL is
  a real regression.
- `stash@{0}` ("WIP on main: 0464593 Compositor fast-path") predates this work — do not drop blindly.
- Off-repo ops notes (HA lights, Pi-hole clock, GOG/Galaxy, sudo rotation) live in the previous
  handoff: `git show ee3c592:HANDOFF.md`.

## Pending creator checks

Vertical-tier camera geometry (Live tile in the band, Chat rect-only); and a Release webcam-cadence
take in the failing geometry, which is what blocks cadence Units 1–2.