ersatztv/docs/handoffs/chicorytv-issue-queue.md

ChicoryTV issue-queue handoff (living document)

Paste the prompt below into a fresh session to work the next item. Each session ends by UPDATING THIS FILE in place (rewrite the state section and the queue for the next item) so it always holds the current handoff. History: created 2026-07-02 after the plan audit (#59 epic); all backend gap issues (#100–#111) and all SPA screens (#84–#89, #93, #109), the rebrand (#90) and the cutover root-flip (#91 phase a, PR #148) are MERGED. v26.5.0 tagged + DEPLOYED to prod 2026-07-07 (verified live: image :26.5.0, / 302→/app, ChicoryTV title, /api/version 26.5.0, M3U serving). Blazor removal (#91 phase b) is blocked on parity issues #140–#147.

Session state (2026-07-07, post-housekeeping): main = 7e5a6b75 (+ this doc commit). Housekeeping session did:

• Dep batch: PR #61 (BlazorSortable 6.0.2 + CliWrap 3.10.2 + Dapper 2.1.79, rebased) and PR #132 (EFProfiler.Appender 6.0.6053, rebased) MERGED; #21/#48/#49 closed as superseded by #61; #131 (Scriban 7.2.0) closed obsolete — main already has Scriban 7.2.5 (47c3c3b5).
• MCP PR #76 (#58): rebased onto main (clean, purely additive ErsatzTV.Mcp project), 12 tests green locally, pushed (head d1c04030). Still OPEN — needs a content refresh against the full API surface before merge, plus review.
• Filed #149: CI flake — migrations job MySQL service publishes fixed host port 3306:3306, so two concurrent runs collide ("port is already allocated"). Fix = drop the ports: mapping (job connects via Server=mysql service name); verify MySql drift/apply still passes.
• Worktrees: removed issue-91-cutover; .worktrees/deps was this session's scratch (remove it). .worktrees/parity-147 exists (branch feat/147-classic-ui-link off 1cf4a7a9, web/ npm ci already done) — rebase onto current main and use it for #147.
• PARITY NOT STARTED — recon done though; facts baked into the prompt below.

Lessons for all remaining prompts (accumulated):

• The main checkout (/Users/timothy/ersatztv) sits on the STALE docs/59-ui-redesign-brief branch. NEVER recon/edit there — point subagents at a worktree pinned to origin/main, or they report placeholders that no longer exist (this bit a recon agent on 2026-07-07).
• Gitea 1.24 has no rerun-run API; retrigger CI with an empty commit. Runs on the single runner queue mostly sequentially; concurrent migration jobs collide on port 3306 until #149 lands.
• DTO records in ErsatzTV.Core/Api MUST get file-scoped #nullable enable (else OpenAPI emits ["null","string"] and SPA typegen degrades). ErsatzTV.Application has NO nullable context — string? there trips CS8632.
• NSubstitute + ConfigElementKey: keys are fresh instances per access — stub with Arg.Any<ConfigElementKey>() disambiguated by the generic <T>.
• Option<T>.ToNullable() doesn't exist; use MatchUnsafe(v => (T?)v, () => null).
• ./scripts/update-openapi.sh needs a prior normal dotnet build ErsatzTV/ErsatzTV.csproj.
• Id-taking child-collection GETs 404 on unknown parent via pre-check + ApiResults + an OpenApiErrorResponseContractTests [TestCase] entry.
• Backlog nits: pageSize unclamped on paged endpoints; artwork content-type trusted (#66); GET /api/guide runs the full 21-include eager-load per channel per request; fillerKind almost always None in JSON guide (merged into adjacent programmes).

---

PROMPT — Parity kickoff: #147 escape hatch → #146 channel edit → #140 collections

You are Fable, the ORCHESTRATOR in the main Claude Code session (Claude Code only). Fable is EXPENSIVE: delegate (recon → Explore/haiku; mechanical → sonnet; judgment-heavy code → opus; fable forks for review). Read CLAUDE.md + the Lessons above first.

HARD CONSTRAINTS:

• Work in worktrees off origin/main; NEVER touch /Users/timothy/ersatztv (stale branch). .worktrees/parity-147 exists (npm ci done) — rebase feat/147-classic-ui-link onto origin/main first. cd web && npm ci in any NEW worktree.
• Max 2–3 concurrent builds; ONE dotnet build at a time. NEVER set ETV_UPDATE_GOLDENS.
• Merge consent in-conversation per PR. CI reruns = empty commit (no rerun API).
• Live-E2E new screens per the #93 recipe (curl localhost, NOT 127.0.0.1 — host guard; wait for "Done migrating search index").

Recon facts (2026-07-07, verified against main)

• Routing: web/src/App.tsx (~150–252). /app/collections renders PlaceholderScreen (App.tsx ~2776). Manual pushState routing, no router lib.
• #147: web/src/screens/SettingsScreen.tsx, System pane About card (~852) is the natural home for a "Classic UI" link to /system/health; reuse the existing LegacyCallout component (ExternalLink icon + "Legacy UI" badge, used by the Media sources card ~840). Remove again in #91 phase (b).
• #146: Channels screen edit pencil already navigates navigateToPath(/app/new-channel?edit=${channel.id}) (App.tsx ~1216) but web/src/builder/ChannelBuilder.tsx never reads query params → dead-end. Backend ready: GET /api/channels/{id} → full ChannelViewModel; PUT /api/channels/{id} takes UpdateChannelRequest (ChannelController.cs). Issue #146 also covers /channels/numbers bulk renumbering — bulkRenumberChannels already exists in web/src/api/channels.ts (check what UI exposes it). Decide: hydrate the builder for edit vs a dedicated edit view — the builder's lineup model (from-lineup composite create) does NOT map 1:1 onto editing an existing channel's 30+ settings; a form-style edit view calling PUT may be the honest shape.
• #140: manual + smart collections have FULL API CRUD (CollectionController incl. items add/remove; SmartCollectionController). NO API exists for multi-collections, playlists, rerun collections → those need backend gap issues/endpoints for full Blazor parity (/media/multi-collections, /media/playlists, /media/rerun-collections). SPA has getCollections()/getSmartCollections() in web/src/api/schedules.ts (no collections.ts yet). Tests: Vitest + testing-library; App.test.tsx mocks fetch by path (mockDashboardApi).

Task (in order)

1. #147 [small, sonnet]: Classic UI link in Settings → System About card (+ optional "opens in ChicoryTV" cue on migrated Blazor sidebar links, per the issue). Vitest coverage. PR, CI, consent, merge.
2. #146 [opus]: channel edit path. Scope call first (builder hydration vs edit form — recommend and confirm in an issue comment), then implement + tests + live E2E. Include or explicitly defer /channels/numbers with an issue comment. PR, consent, merge.
3. #140 [opus, biggest]: collections screen for manual + smart collections (list/create/ edit/delete/items). File follow-up issues for multi/playlist/rerun API gaps and cover those types read-only if feasible (they surface in GET /api/collections by CollectionType). PR, consent, merge.
4. Adversarial review fork over each PR diff before asking merge consent.
5. Update THIS handoff: merged PRs + main SHA, pop done items, next prompt = remaining parity (#141–#145). Commit to main. Print the next prompt in a fenced block.

---

Issue queue (work top-down)

1. #147 SPA escape-hatch link (tiny) ← PROMPT above
2. #146 channel edit + /channels/numbers (blocker for #91b)
3. #140 collections management (biggest gap; spawns multi/playlist/rerun API follow-ups)
4. #141–#145 remaining parity gaps (media browse/search, trakt, filler, watermarks, ffmpeg profiles, blocks/decos/templates, playout editors, logs, troubleshooting — see each issue)
5. #91 phase (b): remove Blazor once #140–#147 close; also remove the #147 link then.
6. MCP PR #76 (#58): refresh tool catalog against the full API surface, review, merge.
7. #149 CI flake (migrations job host-port collision) — small, slot into any session. Cross-refs: #99 (TS/HLS-Direct sessions) stays backlog. Done this pass: dep PRs #61/#132 merged; #21/#48/#49/#131 closed; prod verified on v26.5.0.