Update to v0.5.0 — Prowlarr match UX improvements

CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to the DarkPeers Mod Queue Helper will be documented in this
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.5.0] - 2026-04-06
+
+### Added
+
+- **Preferred indexer selection** — new `preferredIndexers` setting (comma-separated list in Settings panel) allows moderators to specify trusted indexers. When multiple indexers return the same release (tied relevance scores), preferred indexers are selected first. Preference is strictly a tiebreaker — never overrides a clearly better match from a non-preferred indexer.
+- **Best match link** — best match title now links to the source tracker page via Prowlarr's `infoUrl` field (opens in new tab). Link omitted gracefully when URL unavailable.
+- **Field comparison detail** — collapsible "Comparison details" section shows per-field match status (title, year, resolution, source, video codec, audio codec), self-consistency check results (folder ✓/✗, filename ✓/✗), and alternative indexers.
+- **Alternative indexers** — up to 3 alternative indexers shown in detail section ("Also found on: BLU, TL")
+
+### Changed
+
+- **Explainability rewrite** — replaced vague "Title consistent with indexed release" with specific moderation summaries:
+  - `match`: "Name matches release on {indexer} — title, year, resolution, codecs all consistent"
+  - `likely_match`: "Name likely matches release on {indexer} — minor field differences"
+  - `uncertain`: "No strong match found — cannot verify release name automatically"
+  - `likely_renamed`: "Possible rename — {specific issue}"
+  - `renamed`: "Likely renamed — folder and filename both differ from torrent name"
+- **Rename issue labels** — replaced misleading "expected/found" framing with "Torrent name: / Folder name:" to avoid implying the torrent name is the authoritative source
+- **Header wording** — "Found on N indexer(s)" replaced with "Found on {indexer}" (single) or "Best match from {indexer} (N indexers total)" (multiple)
+- **Match selection algorithm** — replaced single-pass highest-score selection with candidate-based ranking: relevance score (descending, 0.01 epsilon for ties) → preferred indexer rank → seeders (descending)
+
 ## [0.4.1] - 2026-04-06
 
 ### Fixed

README.md

@@ -19,4 +19,8 @@ Tampermonkey checks for updates automatically. To force a check: Tampermonkey ic
 
 ## Optional: Prowlarr Integration
 
-Open the settings via Tampermonkey menu > **ModQ Helper Settings** and enter your Prowlarr URL and API key to enable cross-seed detection.
+Open the settings via Tampermonkey menu > **ModQ Helper Settings** and enter your Prowlarr URL and API key to enable indexer-backed rename detection.
+
+### Preferred Indexers
+
+In the settings panel you can optionally set a comma-separated list of preferred indexers (e.g. `Aither, BLU`). When multiple indexers return the same release, the preferred one is shown as the best match. This is a tiebreaker only — a clearly better match from another indexer still wins.