feat(type): type a yearless complete run as an episode

`other: Complete` is emitted for two unrelated things — a complete run of a
series and a complete disc of a film — and auto-detection read neither, so
every complete series pack came back as `type: movie`.

The signal that separates them is already in the guess: a film carries its own
release year, a run spanning several of them carries none. A yearless
`Complete` now weighs towards `episode`, in the same shape as the existing
`date and not year` / `bonus and not year` branches. On the sample of #953 that
takes 6/16 to 16/16.

`MINISERIES` was also left in the title next to the marker (`Chernobyl COMPLETE
MINISERIES`) where `SERIES` was consumed, giving consumers a phantom second key
for the same show; it joins the configured season words.

Neither half of the year signal is a proof, and the trade-off is deliberate: a
film whose filename omits its year, and a box set of films, are now typed
`episode`. Both are pinned in the corpus and recorded in the known-limitations
page.

closes #953

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: Toilal

docs/known-limitations.md

@@ -313,6 +313,24 @@ downstream lookup against a real title database.
 The show *19-2* produces `19-2.2014`, which is a valid `DD-M.YYYY` date. A title that is itself a
 date-like number is structurally indistinguishable from an actual date; date detection wins.
 
+## A yearless `COMPLETE` film typed as a series
+
+```text
+The.Matrix.COMPLETE.BLURAY-GRP
+  type: episode                                           (#953)
+  wanted -> type: movie
+
+Lord.of.the.Rings.Trilogy.COMPLETE.BLURAY-GRP
+  type: episode                                           (#953)
+  wanted -> type: movie
+```
+
+`other: Complete` marks two unrelated things: a complete **run** of a series, and a complete
+**disc** of a film. The only local signal separating them is the year — a run spanning several
+years carries none, a film carries its own — so a yearless `COMPLETE` is read as a series. A film
+whose filename omits its release year, and a box set of films, therefore fall on the wrong side.
+Adding the year (`The.Matrix.1999.COMPLETE.BLURAY-GRP`) or `type=movie` settles it.
+
 ## How these could be revisited
 
 Most of the cases above share one root: they need to know whether an ambiguous token is *content*

guessit/config/options.json

@@ -597,7 +597,7 @@
         "Proof": {"string": "Proof", "tags": ["at-end", "not-a-release-group"]},
         "Obfuscated": {"string": ["Obfuscated", "Scrambled"], "tags": ["at-end", "not-a-release-group"]},
         "Repost": {"string": ["xpost", "postbot", "asrequested"], "tags": "not-a-release-group"},
-        "_complete_words": {"callable": "import:guessit.rules.properties.other:complete_words", "complete_marker_words": ["Complete", "Int[ée]grale"], "season_words": ["seasons?", "series?"], "complete_article_words": ["The"], "complete_prefix_words": ["L['’]?", "Coffret"], "season_number_separators": ["&", "and"]}
+        "_complete_words": {"callable": "import:guessit.rules.properties.other:complete_words", "complete_marker_words": ["Complete", "Int[ée]grale"], "season_words": ["seasons?", "mini-?series?", "series?"], "complete_article_words": ["The"], "complete_prefix_words": ["L['’]?", "Coffret"], "season_number_separators": ["&", "and"]}
       },
       "art": {
         "poster": "Poster",

guessit/rules/properties/type.py

@@ -79,6 +79,14 @@ def when(self, matches: Matches, context: dict[str, Any] | None) -> Any:
         if bonus and not year:
             return "episode"
 
+        # A complete run of a series spans several years and so carries none of its own, whereas a
+        # film on a complete disc carries its release year. The year is the only signal that tells
+        # the two apart, and neither half is a proof: a film whose name omits its year, or a box
+        # set of films, still lands on the episode side (#953).
+        complete = matches.named("other", lambda match: match.value == "Complete")
+        if complete and not year:
+            return "episode"
+
         crc32 = matches.named("crc32")
         anime_release_group = matches.named("release_group", lambda match: "anime" in match.tags)
         if crc32 and anime_release_group:

guessit/test/cross_parser/baseline.json

@@ -299,11 +299,6 @@
     "thomas.and.friends.s19e09_s20e14.convert.hdtv.x264-w4f[eztv].mkv": [
       "season",
       "episode"
-    ],
-    "2012 2009 x264 720p Esub BluRay 6.0 Dual Audio English Hindi GOPISAHI": [
-      "title",
-      "year",
-      "video_codec"
     ]
   },
   "ptn": {
@@ -430,6 +425,12 @@
     "[Anime Time] Naruto - 116 - 360 Degrees of Vision The Byakugan's Blind Spot.mkv": [
       "episode"
     ],
+    "[JySzE] Naruto [v2] [R2J] [VFR] [Dual Audio] [Complete] [Extras] [x264]": [
+      "type"
+    ],
+    "[JySzE] Naruto [v3] [R2J] [VFR] [Dual Audio] [Complete] [Extras] [x264]": [
+      "type"
+    ],
     "Naruto Collection [DB 1080p][ Dual Audio ][ English & Arabic Sub ]": [
       "title"
     ],
@@ -468,6 +469,9 @@
     "xXx.2002.15th.Anniversary.Edition.1080p.BluRay.Remux.AVC.DTS-HD.MA.5.1-FraMeSToR": [
       "title"
     ],
+    "Dragon Ball Z (Complete Series) [1080p] [MP4] [English Audio]": [
+      "type"
+    ],
     "[GM-Team][国漫][太乙仙魔录 灵飞纪 第3季][Magical Legend of Rise to immortality Ⅲ][01-26][AVC][GB][1080P]": [
       "title"
     ],

guessit/test/episodes.yml

@@ -2021,13 +2021,46 @@
   type: episode
   video_codec: H.264
 
+? Breaking.Bad.COMPLETE.1080p.BluRay.x264-GRP
+: title: Breaking Bad
+  other: Complete
+  screen_size: 1080p
+  source: Blu-ray
+  video_codec: H.264
+  release_group: GRP
+  type: episode
+
+? The.Wire.COMPLETE.SERIES.720p.BluRay-GRP
+: title: The Wire
+  other: Complete
+  screen_size: 720p
+  source: Blu-ray
+  release_group: GRP
+  type: episode
+
+? Chernobyl.COMPLETE.MINISERIES.1080p.WEB-GRP
+: title: Chernobyl
+  other: Complete
+  screen_size: 1080p
+  source: Web
+  release_group: GRP
+  type: episode
+
+? Kampen Om Tungtvannet aka The Heavy Water War COMPLETE 720p x265 HEVC-Lund
+: title: Kampen Om Tungtvannet aka The Heavy Water War
+  other: Complete
+  screen_size: 720p
+  video_codec: H.265
+  release_group: Lund
+  type: episode
+
 ? How.I.Met.Your.Mother.COMPLETE.SERIES.DVDRip.XviD-AR
 : options: -L en -C us
   source: DVD
   other: [Complete, Rip]
   release_group: AR
   title: How I Met Your Mother
-  type: movie # Should be episode
+  type: episode
   video_codec: Xvid
 
 ? Friends.INTEGRALE.MULTi.1080p.BluRay-GRP
@@ -2038,7 +2071,7 @@
   screen_size: 1080p
   source: Blu-ray
   release_group: GRP
-  type: movie # Should be episode, see #953
+  type: episode
 
 ? Malcolm.LIntegrale.FRENCH.DVDRip-GRP
 ? Malcolm.L'Integrale.FRENCH.DVDRip-GRP
@@ -2047,15 +2080,15 @@
   language: French
   source: DVD
   release_group: GRP
-  type: movie # Should be episode, see #953
+  type: episode
 
 ? Engrenages.Coffret.Integrale.FRENCH.1080p-GRP
 : title: Engrenages
   other: Complete
   language: French
   screen_size: 1080p
   release_group: GRP
-  type: movie # Should be episode, see #953
+  type: episode
 
 ? Breaking.Bad.INTEGRALE.Saison.1.FRENCH.1080p-GRP
 : title: Breaking Bad

guessit/test/movies.yml

@@ -1116,14 +1116,39 @@
   video_codec: H.264
   type: movie
 
-? Kampen Om Tungtvannet aka The Heavy Water War COMPLETE 720p x265 HEVC-Lund
-: title: Kampen Om Tungtvannet aka The Heavy Water War
+? The.Matrix.1999.COMPLETE.BLURAY-GRP
+: title: The Matrix
+  year: 1999
   other: Complete
-  screen_size: 720p
-  video_codec: H.265
-  release_group: Lund
+  source: Blu-ray
+  release_group: GRP
+  type: movie
+
+? Heat.1995.COMPLETE.BLURAY.REMUX-GRP
+: title: Heat
+  year: 1995
+  other: [Complete, Remux]
+  source: Blu-ray
+  release_group: GRP
   type: movie
 
+# The year is the only thing separating a film on a complete disc from a complete run of a
+# series. A film that does not carry its own year, and a box set of films, both fall on the
+# wrong side of that line.
+? The.Matrix.COMPLETE.BLURAY-GRP
+: title: The Matrix
+  other: Complete
+  source: Blu-ray
+  release_group: GRP
+  type: episode # Should be movie, no year to tell it from a complete run
+
+? Lord.of.the.Rings.Trilogy.COMPLETE.BLURAY-GRP
+: title: Lord of the Rings Trilogy
+  other: Complete
+  source: Blu-ray
+  release_group: GRP
+  type: episode # Should be movie, no year to tell it from a complete run
+
 ? All.Fall.Down.x264.PROOFFIX-OUTLAWS
 : title: All Fall Down
   video_codec: H.264