Merge branch 'fix/saga-match'

1 files changed, 13 insertions, 0 deletions

diff --git a/docs/mediacenter.md b/docs/mediacenter.md
index aa1bd03..3a6b733 100644
--- a/docs/mediacenter.md
+++ b/docs/mediacenter.md
@@ -786,6 +786,19 @@ flat-dumped episode always carries a marker, so nothing regresses.
 (`Show.2019.308.mkv`) that guessit slots wrongly has no in-UI remedy short of renaming the
 file. A "this is a movie / a show" toggle would close that.
 
+### 10.3 A whole saga matched to its first film (2026-08-30)
+
+Every `Star Wars Episode <N> - <subtitle>` file resolved to the 1977 original (TMDB id 11).
+Cause: `sequel_variants` stripped `Episode <N>` and offered the bare `Star Wars` as a
+candidate query — which matches the 1977 film's `original_title` at ratio 1.0, beating
+PASS 1's correct (but lower-ratio) hit. A franchise's bare name is very often a real,
+different film. **Fixed** (`fix/starwars-saga-match`): when a `Part`/`Episode`/… keyword is
+what carried the index, `sequel_variants` no longer emits the bare base — only
+`<base> <digit>` and `<base> <roman>`. Without a keyword (`Jurassic Park 3`) the bare base
+is still offered. Verified live: Star Wars I–VI now each resolve to their own episode;
+Jurassic Park / Kill Bill / Bond regressions all hold. V12's movie merge, reverted the
+same day, would have compounded this into one card for the saga.
+
 ## 11. Acceptance before shipping
 
 1. Re-run the §3 validation (real TMDB calls, same corpus, same script