chore: release 2.5.1

.env.example

@@ -13,7 +13,7 @@
 # HOST=0.0.0.0                       # Uvicorn bind host (only when APP_MODE=web).
 # PORT=8080                          # Uvicorn port.
 # WORKERS=1                          # Uvicorn worker count.
-APP_VERSION=v2.5.0                 # Matches dockerhub compose.
+APP_VERSION=v2.5.1                 # Matches dockerhub compose.
 
 ############################
 # Theming

CHANGELOG.md

@@ -14,6 +14,19 @@ This format follows Keep a Changelog principles and aims for Semantic Versioning
 
 ## [Unreleased]
 ### Summary
+- _No changes yet_
+
+### Added
+- _None_
+
+### Changed
+- _None_
+
+### Fixed
+- _None_
+
+## [2.5.1] - 2025-10-06
+### Summary
 - Alternative suggestions in the build wizard now surface the replacement card preview immediately and reload the list after a swap.
 
 ### Added

docker-compose.yml

@@ -106,7 +106,7 @@ services:
       # WEB_THEME_FILTER_PREWARM: "0"
       WEB_AUTO_ENFORCE: "0"         # 1=auto-run compliance export after builds
       WEB_CUSTOM_EXPORT_BASE: ""    # Optional: custom base dir for deck export artifacts
-      APP_VERSION: "2.5.0"          # Displayed version label (set per release/tag)
+      APP_VERSION: "2.5.1"          # Displayed version label (set per release/tag)
 
       # ------------------------------------------------------------------
       # Misc / Land Selection (Step 7) Environment Tuning

dockerhub-docker-compose.yml

@@ -108,7 +108,7 @@ services:
       # WEB_THEME_FILTER_PREWARM: "0"
       WEB_AUTO_ENFORCE: "0"         # 1=auto-run compliance export after builds
       WEB_CUSTOM_EXPORT_BASE: ""    # Optional: custom base dir for deck export artifacts
-      APP_VERSION: "2.5.0"          # Displayed version label (set per release/tag)
+      APP_VERSION: "2.5.1"          # Displayed version label (set per release/tag)
 
       # ------------------------------------------------------------------
       # Misc / Land Selection (Step 7) Environment Tuning

docs/releases/v2.5.1.md

@@ -0,0 +1,13 @@
+# MTG Python Deckbuilder v2.5.1
+
+## Summary
+- Alternative suggestions in the build wizard now surface the replacement card preview immediately and reload the list after a swap.
+
+## Added
+- Alternatives panel includes a "New pool" button so you can request a fresh batch of suggestions without rerunning the stage.
+
+## Changed
+- Alternative suggestion buttons expose role, mana, and rarity metadata to hover previews for better at-a-glance context.
+
+## Fixed
+- Previewing an alternative card now shows the replacement instead of the currently slotted card, and the list refreshes automatically after choosing an alternative.

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mtg-deckbuilder"
-version = "2.5.0"
+version = "2.5.1"
 description = "A command-line tool for building and analyzing Magic: The Gathering decks"
 readme = "README.md"
 license = {file = "LICENSE"}