Skip to content

Document how multiple playlists and guides become one lineup (#153) - #271

Merged
Jumpstile merged 1 commit into
mainfrom
docs/multi-lineup-aggregation
Nov 17, 2026
Merged

Jumpstile merged 1 commit into
mainfrom
docs/multi-lineup-aggregation

Conversation

@Jumpstile

Copy link
Copy Markdown
Owner

Part of #153 (Milestone 2). Does not close it: the not-built-yet items remain.

  • Docs only: one new architecture note, MULTI_LINEUP_AGGREGATION.md. It explains what a playlist and a guide contribute, canonical channel, source variant, guide binding, why many entries are not many channels, the step-by-step merge, guide-to-playlist bindings, and duplicate handling, each with the code it lives in.
  • Describes main as it is today. Spot-checked against code by the coordinator: four duplicate-decision choices (not six), PreferredNumber exists but is never used, first duplicate wins, the identity-collision check runs before an exact guide match, and Backup/Alt/Alternate are the only alternate-feed words removed.
  • A marked 'Not built yet' section lists what M3U aggregation: custom channel numbers and duplicate-resolution workflow #153 asks for that does not exist: user-chosen channel numbers, the six-choice decision, provider failover, regional variant detection, cross-guide programme merge.
  • Not verified: the ESPN worked example step 5 was read from code order, not run (marked INFERENCE in the doc). Prettier check passes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh

Adds a beginner-readable architecture note that describes what main does today for multi-playlist merging, guide bindings and duplicate handling, with the code each part lives in, one worked example, and a clearly marked section for what is not built yet (user-chosen channel numbers, the six-choice duplicate decision, provider failover, regional variants, cross-guide programme merge). Docs only.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh
@Jumpstile
Jumpstile merged commit 2dd9663 into main Nov 17, 2026
11 checks passed
@Jumpstile
Jumpstile deleted the docs/multi-lineup-aggregation branch November 17, 2026 11:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant