Add first-party MangaPill source and distinct volume releases

docs/library-format.md

@@ -82,6 +82,14 @@ Different source UUIDs remain distinct releases; no content equivalence is guess
 Numeric IDs and source-version folders are unchanged. Older reader releases ignore
 these new folders but retain them on disk; upgrade again to restore visibility.
 
+Whole-volume WeebCentral releases use the analogous
+`special-weebcentral-volume-<26-character-release-id>` chapter key. They live in
+the matching volume book and carry `releaseKind:"volume"`, `volume`, `sourceId`,
+and a `Volume N` label in `chapter.json`. This keeps an entire volume distinct
+from a numbered chapter in the same book. The default `skip-any` download policy
+also skips a whole-volume release if that book already contains numbered chapters;
+`add-source` allows the extra source edition explicitly.
+
 The number is normalised: leading zeros and trailing decimal zeros are dropped (`0010.50` → `10.5`), and an `x` prefix is kept. The result is the **key**:
 
 | Folder | Key |

docs/scraper-service.md

@@ -154,6 +154,12 @@ exclude them; missing, exact-ID and applicable volume scopes include them. Catal
 ordering puts numbered chapters first and source-ID-ordered specials afterward;
 first/last/latest operate on that ordering, not on publication timestamps.
 
+WeebCentral whole-volume releases use `special-weebcentral-volume-<release-id>`
+and a `Volume N` label rather than an invented chapter number. MangaPill is a
+first-party module in the same scraper process; its catalog and chapter HTML
+must remain on `mangapill.com`, and its page URLs must match the reviewed image
+host. It uses the ordinary source lane, pacing, checkpoint and publication rules.
+
 `existingPolicy:"skip-any"` skips a chapter when any version already exists.
 `existingPolicy:"add-source"` permits another host's version but still skips a version
 already present from the selected host. Existing version folders are never overwritten.