Repository navigation
v0.1.26 — Better 'Because you watched X' recommendations
Fixes the noise on "Because you watched X" shelves
1. /similar → /recommendations
TMDB's `/similar` endpoint is shallow keyword + genre overlap (lots of "thrillers from the 2010s with female lead" filler). `/recommendations` is collaborative-filter data — "people who rated X also liked Y" — and is noticeably more relevant for both movies and TV. One-line endpoint swap.
2. Title → tmdbId resolution now uses type + year
Previously we hit `/search/multi` with the title alone and took the first match. For any common-title title (Avatar, It, Up, The Office, any remake) we'd routinely lock onto the wrong franchise/version and build the entire shelf off it. Now we use `/search/movie` or `/search/tv` with the release year as a disambiguator.
Year is only carried for movies — `item.year` on an episode is the episode's air year, not the show's first-aired year, so passing it to TMDB would hurt more than help.
What this doesn't fix
The 90-day random-shuffle pool (one outlier kids-movie watch can poison the recs for an hour), the lack of quality floor, and the cache-keyed-by-hour churn. All called out in the audit; can ship as a follow-up if shelves still feel noisy.
Backend-only fix.