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

Daily series metadata refresh #121

New Issue
Closed
opened 2026-08-23 15:55:56 +01:00 by naps62-yolo · 0 comments
naps62-yolo commented 2026-08-23 15:55:56 +01:00
Owner
Copy Link
Copy Source

Depends on: #117, #118, #119, #120

DESIGN.md §8 schedules a daily metadata refresh. Movies have one, gated on
movies.metadata_refreshed_at (crates/arr-daemon/src/grab.rs:1124). Series
have no equivalent column and no lane, and apply_auto_track is called from
exactly one place — crates/arr-api/src/series.rs:634, when the operator
creates a season by hand.

The consequence is that nothing about a series ever changes after it is added.
New seasons never appear, new episodes never appear, air dates never correct,
and upstream_ended is never written, so derive_series_status can never
return ended. auto_track is a flag that does nothing. This issue is the
tracking in TV tracking.

The lane, on the same shape and TTL gate as the movie one:

  • Reveal new seasons. apply_auto_track marks them tracked when the series has
    auto_track, season 0 excepted (#118).
  • Reveal new episodes into existing seasons, wanted per the tracked rule
    (#119).
  • Update air_date on existing episodes. TMDB moves dates constantly, and both
    §4.2's airing window and §6.2's do-not-search-before-it-exists gate read
    them, so a stale date is either a wasted query or a missed grab.
  • Update episode titles. TMDB ships Episode 7 placeholders and fills them in
    later; the title reaches §7.4 filenames and §9.2 episode search.
  • Set upstream_ended from TMDB's series status.
  • Backfill tvdb_id for series added before #120.

Episodes that vanish or renumber upstream are #122. Until it lands, this lane
leaves unknown episodes alone rather than deleting them.

Add series.metadata_refreshed_at, gate on it the way the movie lane does, and
stagger against the other ticks. Refresh must be idempotent: a second run over
unchanged TMDB data writes nothing and marks nothing wanted twice.

Depends on: #117, #118, #119, #120 DESIGN.md §8 schedules a daily metadata refresh. Movies have one, gated on `movies.metadata_refreshed_at` (`crates/arr-daemon/src/grab.rs:1124`). Series have no equivalent column and no lane, and `apply_auto_track` is called from exactly one place — `crates/arr-api/src/series.rs:634`, when the operator creates a season by hand. The consequence is that nothing about a series ever changes after it is added. New seasons never appear, new episodes never appear, air dates never correct, and `upstream_ended` is never written, so `derive_series_status` can never return `ended`. `auto_track` is a flag that does nothing. This issue is the tracking in TV tracking. The lane, on the same shape and TTL gate as the movie one: - Reveal new seasons. `apply_auto_track` marks them tracked when the series has `auto_track`, season 0 excepted (#118). - Reveal new episodes into existing seasons, wanted per the `tracked` rule (#119). - Update `air_date` on existing episodes. TMDB moves dates constantly, and both §4.2's `airing` window and §6.2's do-not-search-before-it-exists gate read them, so a stale date is either a wasted query or a missed grab. - Update episode titles. TMDB ships `Episode 7` placeholders and fills them in later; the title reaches §7.4 filenames and §9.2 episode search. - Set `upstream_ended` from TMDB's series status. - Backfill `tvdb_id` for series added before #120. Episodes that vanish or renumber upstream are #122. Until it lands, this lane leaves unknown episodes alone rather than deleting them. Add `series.metadata_refreshed_at`, gate on it the way the movie lane does, and stagger against the other ticks. Refresh must be idempotent: a second run over unchanged TMDB data writes nothing and marks nothing wanted twice.
naps62-yolo added the difficulty/hardarea/daemonphase/6-tvtype/feature labels 2026-08-23 15:55:56 +01:00
naps62-yolo added this to the TV tracking milestone 2026-08-23 15:58:35 +01:00
naps62-yolo added a new dependency 2026-08-23 16:36:55 +01:00
#117 Amend DESIGN.md for TV tracking decisions
naps62-yolo added a new dependency 2026-08-23 16:36:55 +01:00
#122 Reconcile episodes that vanish or renumber upstream
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/daemon difficulty/hard phase/6-tv type/feature
Milestone
No items
No Milestone TV tracking
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
#122 Reconcile episodes that vanish or renumber upstream
yolo/arr
Depends on
#117 Amend DESIGN.md for TV tracking decisions
yolo/arr
Reference: yolo/arr#121