chore: prepare release 2.9.0

.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.8.1                 # Matches dockerhub compose.
+APP_VERSION=v2.9.0                 # Matches dockerhub compose.
 
 ############################
 # Theming

CHANGELOG.md

@@ -9,6 +9,22 @@ This format follows Keep a Changelog principles and aims for Semantic Versioning
 
 ## [Unreleased]
 ### Summary
+_No unreleased changes yet_
+
+### Added
+_None_
+
+### Changed
+_None_
+
+### Removed
+_None_
+
+### Fixed
+_None_
+
+## [2.9.0] - 2025-10-17
+### Summary
 New card browser for exploring 29,839 Magic cards with advanced filters, similar card recommendations, and performance optimizations.
 
 ### Added

RELEASE_NOTES_TEMPLATE.md

@@ -1,36 +1,16 @@
 # MTG Python Deckbuilder ${VERSION}
 
 ### Summary
-New card browser for exploring and discovering cards with advanced filters, similar card recommendations, and fast performance.
+_No unreleased changes yet_
 
 ### Added
-- **Card Browser**: Browse and search all 29,839 Magic cards at `/browse/cards`
+_None_
-  - Smart autocomplete with typo tolerance for card names and themes
-  - Multi-theme filtering (up to 5 themes)
-  - Color, type, rarity, CMC, power/toughness filters
-  - Multiple sorting options including EDHREC popularity
-  - Infinite scroll with shareable URLs
-- **Card Detail Pages**: Individual card pages with similar card suggestions
-  - Enable with `ENABLE_CARD_DETAILS=1` environment variable
-  - Full card stats, oracle text, and theme tags
-  - Similar cards based on theme overlap with color-coded scores
-  - Card preview on hover
-- **Similarity Cache**: Pre-computed card similarities for instant page loads
-  - Build cache with `python -m code.scripts.build_similarity_cache_parquet --parallel`
-  - Control with `SIMILARITY_CACHE_ENABLED` environment variable
-- **Keyboard Shortcuts**: Quick navigation
-  - `Enter` to add autocomplete matches
-  - `Shift+Enter` to apply filters  
-  - Double `Esc` to clear all filters
 
 ### Changed
-- **Card Database**: Expanded to 29,839 cards (from 26,427)
+_None_
-- **Theme Catalog**: Improved coverage and filtering
 
 ### Removed
-- **Unused Scripts**: Removed redundant `regenerate_parquet.py`
+_None_
 
 ### Fixed
-- **Card Browser**: Improved UI consistency and image loading
+_None_
-- **Infinite Scroll**: No more duplicate cards when loading more
-- **Sorting**: Sort order now persists correctly across pages

docker-compose.yml

@@ -125,7 +125,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.8.1"          # Displayed version label (set per release/tag)
+      APP_VERSION: "2.9.0"          # Displayed version label (set per release/tag)
 
       # ------------------------------------------------------------------
       # Misc / Land Selection (Step 7) Environment Tuning

dockerhub-docker-compose.yml

@@ -127,7 +127,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.8.1"          # Displayed version label (set per release/tag)
+      APP_VERSION: "2.9.0"          # Displayed version label (set per release/tag)
 
       # ------------------------------------------------------------------
       # Misc / Land Selection (Step 7) Environment Tuning

docs/releases/v2.9.0.md

@@ -0,0 +1,38 @@
+# MTG Python Deckbuilder v2.9.0
+
+### Summary
+New card browser for exploring 29,839 Magic cards with advanced filters, similar card recommendations, and performance optimizations.
+
+### Added
+- **Card Browser**: Browse and search all Magic cards at `/browse/cards`
+  - Smart autocomplete for card names and themes with typo tolerance
+  - Multi-theme filtering (up to 5 themes)
+  - Color, type, rarity, CMC, power/toughness filters
+  - Multiple sorting options including EDHREC popularity
+  - Infinite scroll with shareable filter URLs
+- **Card Detail Pages**: Individual card pages with similar card suggestions
+  - Full card stats, oracle text, and theme tags
+  - Similar cards based on theme overlap
+  - Color-coded similarity scores
+  - Card preview on hover
+  - Enable with `ENABLE_CARD_DETAILS=1` environment variable
+- **Similarity Cache**: Pre-computed card similarities for fast page loads
+  - Build cache with parallel processing script
+  - Automatically used when available
+  - Control with `SIMILARITY_CACHE_ENABLED` environment variable
+- **Keyboard Shortcuts**: Quick navigation in card browser
+  - `Enter` to add autocomplete matches
+  - `Shift+Enter` to apply filters
+  - Double `Esc` to clear all filters
+
+### Changed
+- **Card Database**: Expanded to 29,839 cards (updated from 26,427)
+- **Theme Catalog**: Improved coverage with better filtering
+
+### Removed
+- **Unused Scripts**: Removed `regenerate_parquet.py` (functionality now in web UI setup)
+
+### Fixed
+- **Card Browser UI**: Improved styling consistency and card image loading
+- **Infinite Scroll**: Fixed cards appearing multiple times when loading more results
+- **Sorting**: Sort order now persists correctly when scrolling through all pages

pyproject.toml

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