chore: prepare release v3.0.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=v3.0.0                 # Matches dockerhub compose.
+APP_VERSION=v3.0.1                 # Matches dockerhub compose.
 
 ############################
 # Theming

CHANGELOG.md

@@ -17,6 +17,28 @@ _None_
 ### Removed
 _None_
 
+### Fixed
+_None_
+
+### Performance
+_None_
+
+### Deprecated
+_None_
+
+### Security
+_None_
+
+## [3.0.1] - 2025-10-19
+### Added
+_None_
+
+### Changed
+_None_
+
+### Removed
+_None_
+
 ### Fixed
 - **Color Identity Display**: Fixed commander color identity showing incorrectly as "Colorless (C)" for non-partner commanders in the summary panel
 

RELEASE_NOTES_TEMPLATE.md

@@ -3,7 +3,7 @@
 ## [Unreleased]
 
 ### Summary
-Performance improvements and bug fixes for commander selection and display.
+_No unreleased changes yet_
 
 ### Added
 _None_
@@ -15,16 +15,13 @@ _None_
 _None_
 
 ### Fixed
-- **Color Identity Display**: Fixed commander color identity showing incorrectly as "Colorless (C)" for non-partner commanders in the summary panel
+_None_
 
 ### Performance
-- **Commander Selection Speed**: Dramatically improved response time from 4+ seconds to under 1 second
+_None_
-  - Implemented intelligent caching for card data to eliminate redundant file loading
-  - Both commander data and full card database now cached with automatic refresh when data updates
 
 ### For Users
-- Commander selection is now **much faster** - expect sub-second response times
+_No changes yet_
-- Color identity labels in deck summaries now display correctly for all commanders
 
 ### Deprecated
 _None_

docker-compose.yml

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

dockerhub-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: "v3.0.0"         # Displayed version label (set per release/tag)
+      APP_VERSION: "v3.0.1"         # Displayed version label (set per release/tag)
 
       # ------------------------------------------------------------------
       # Misc / Land Selection (Step 7) Environment Tuning

docs/releases/v3.0.1.md

@@ -0,0 +1,24 @@
+# MTG Python Deckbuilder v3.0.1
+
+## Summary
+Performance improvements and bug fixes for commander selection and display.
+
+## Fixed
+- **Color Identity Display**: Fixed commander color identity showing incorrectly as "Colorless (C)" for non-partner commanders in the summary panel
+
+## Performance
+- **Commander Selection Speed**: Dramatically improved response time from 4+ seconds to under 1 second
+  - Implemented intelligent caching for card data to eliminate redundant file loading
+  - Both commander data and full card database now cached with automatic refresh when data updates
+  - Past builds recommendations now 107x faster (0.86s → 0.008s)
+
+## For Users
+- Commander selection is now **much faster** - expect sub-second response times
+- Color identity labels in deck summaries now display correctly for all commanders
+- Web UI "Download from GitHub" button now includes the new commander cache file
+
+## Infrastructure
+- Created dedicated `commander_cards.parquet` file (472KB) for fast commander lookups
+- Updated GitHub Actions workflow to build and publish commander cache
+- Added commander cache download support in Docker entrypoint
+- Implemented three-level caching system for optimal performance

pyproject.toml

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