yolo/arr
3
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects Releases Wiki Activity

Amend DESIGN.md: untracking clears intent, library is the homepage #169

New Issue
Closed
opened 2026-08-24 16:11:49 +01:00 by naps62-yolo · 0 comments
naps62-yolo commented 2026-08-24 16:11:49 +01:00
Owner
Copy Link
Copy Source

Four operator rulings from a hands-on pass contradict the design document as it
stands. Amend it first, so the issues that implement them are not implementing a
discrepancy.

Delete the overturned text rather than layering a note on top of it. The document
is the contract and has to read as one coherent statement afterwards.

§4.1 — turning a season's tracking off now withdraws that season's leaf intent.

The paragraph currently reads "Turning it off withdraws nothing: leaf intent is
never removed implicitly, so anything already marked wanted stays wanted until
cleared explicitly." That ruling is reversed. Turning tracking off clears wanted
on every episode of that season.

The reasoning behind the reversal: nothing in the product ever offered the
"explicit clear" the sentence promised, so untracking produced a state with no way
back — a series with every season untracked and every episode still wanted, sitting
permanently at incomplete. Toggling the flag is itself the explicit act.

Keep the surrounding rules intact. Season.tracked is still a rule rather than
intent, turning it on still marks every revealed episode wanted, and marking
individual episodes wanted on a season that was never tracked is still supported
and still untouched by anything else. Only the off-transition changes.

§9.2 — episodes and seasons never appear as unified search results.

The sentence added by #161, "An episode row surfaces only when the query matches
something beyond the series title", is withdrawn. Unified search returns titles:
series and movies, in library and on TMDB. Episode rows do not appear under any
query, and season rows are not introduced.

§9.x — the library is the homepage.

/ renders the library. The signal-chain diagram (tmdb, prowlarr, arr,
transmission with their lamps) becomes a section of the settings page and loses its
own route entirely. The master lamp stays on the rail, so the at-a-glance health
read survives the move.

§9.x — the wordmark is a link home.

arr on the rail navigates to /.

Non-goals: no change to §4.2's derived status table, and no data migration. A
season that is already untracked while its episodes are still wanted is existing
data this amendment does not retroactively rewrite.

Four operator rulings from a hands-on pass contradict the design document as it stands. Amend it first, so the issues that implement them are not implementing a discrepancy. Delete the overturned text rather than layering a note on top of it. The document is the contract and has to read as one coherent statement afterwards. **§4.1 — turning a season's tracking off now withdraws that season's leaf intent.** The paragraph currently reads "Turning it off withdraws nothing: leaf intent is never removed implicitly, so anything already marked wanted stays wanted until cleared explicitly." That ruling is reversed. Turning tracking off clears `wanted` on every episode of that season. The reasoning behind the reversal: nothing in the product ever offered the "explicit clear" the sentence promised, so untracking produced a state with no way back — a series with every season untracked and every episode still wanted, sitting permanently at `incomplete`. Toggling the flag is itself the explicit act. Keep the surrounding rules intact. `Season.tracked` is still a rule rather than intent, turning it on still marks every revealed episode wanted, and marking individual episodes wanted on a season that was never tracked is still supported and still untouched by anything else. Only the off-transition changes. **§9.2 — episodes and seasons never appear as unified search results.** The sentence added by #161, "An episode row surfaces only when the query matches something beyond the series title", is withdrawn. Unified search returns titles: series and movies, in library and on TMDB. Episode rows do not appear under any query, and season rows are not introduced. **§9.x — the library is the homepage.** `/` renders the library. The signal-chain diagram (tmdb, prowlarr, arr, transmission with their lamps) becomes a section of the settings page and loses its own route entirely. The master lamp stays on the rail, so the at-a-glance health read survives the move. **§9.x — the wordmark is a link home.** `arr` on the rail navigates to `/`. Non-goals: no change to §4.2's derived status table, and no data migration. A season that is already untracked while its episodes are still wanted is existing data this amendment does not retroactively rewrite.
naps62-yolo added this to the Removal and navigation milestone 2026-08-24 16:11:49 +01:00
naps62-yolo added the phase/5-uiarea/infratype/choredifficulty/moderate labels 2026-08-24 16:11:49 +01:00
naps62-yolo added a new dependency 2026-08-24 16:13:22 +01:00
#172 Unified search returns titles only, never episodes
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/api
arr-api
 area/ci
CI and test harness
 area/compat
arr-compat
 area/core
arr-core
 area/daemon
arr-daemon
 area/db
arr-db
 area/dl
arr-dl
 area/indexer
arr-indexer
 area/infra
workspace and tooling
 area/meta
arr-meta
 area/parse
arr-parse
 area/probe
arr-probe
 area/subs
arr-subs crate: providers, extraction, translation, sync
 area/web
web/
 difficulty/easy
bounded, obvious approach, few files
 difficulty/hard
subtle correctness or cross-cutting
 difficulty/moderate
multiple files, judgement, an interface to design
 difficulty/trivial
one file, mechanical, no design decisions
 phase/1-skeleton
workspace, CI, config, database, empty API and SPA
 phase/2-logic
parsing and policy engine, pure, no network
 phase/3-sourcing
TMDB and Prowlarr, read-only
 phase/4-movies
movies end to end
 phase/5-ui
search, buckets, library views, queues
 phase/6-tv
seasons, episodes, tracking, derived status
 phase/7-people
owner tags and notifications
 phase/8-compat
Jellyseerr shim
 phase/9-subtitles
build order: subtitles, DESIGN.md §15
 type/bug
type/chore
type/feature
type/test
No labels area/infra difficulty/moderate phase/5-ui type/chore
Milestone
No items
No Milestone Removal and navigation
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes (agent)) naps62 (Miguel Palhas) naps62-yolo (naps62-yolo (agent))
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Blocks
#171 Turning a season's tracking off clears its episodes' wanted
yolo/arr
#172 Unified search returns titles only, never episodes
yolo/arr
#173 Homepage is the library; signal chain moves to settings; logo links home
yolo/arr
Reference: yolo/arr#169