belote-cli 4.9.5__tar.gz → 4.9.7__tar.gz

{belote_cli-4.9.5 → belote_cli-4.9.7}/.gitignore

@@ -147,3 +147,7 @@ cython_debug/
 
 # PyCharm
 .idea/
+
+# Editor swap files
+*.kate-swp
+*.swp

{belote_cli-4.9.5 → belote_cli-4.9.7}/CHANGELOG.md

@@ -5,6 +5,133 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.9.7] - 2026-11-01
+
+Repo-wide audit: four parallel reviewers swept the classic engine, the
+classic UI/terminal layer, the BelAtro engine/run/progression code and the
+BelAtro items/UI; every finding was verified (most with a repro script) before
+fixing. Test count 1111 → 1228.
+
+### Fixed — test suite
+
+- **Tests no longer depend on (or write to) your real profile.** A new
+  `tests/conftest.py` points `HOME` / `XDG_CONFIG_HOME` / `XDG_DATA_HOME` at a
+  temp dir. The suite used to render with whatever theme the developer last
+  picked (the golden-frame hashes only passed with `moonlit_tavern` saved) and
+  `theme_manager.set_current()` rewrote `~/.config/belote/theme.json`.
+  Golden hashes re-pinned to the default `classic_green` theme.
+- Hardcoded `/home/mrrobot/belote/` paths in `tests/test_alt_screen_scroll.py`
+  replaced with a path relative to the test file.
+- `scripts/benchmark.py` is now `mypy --strict` clean.
+
+### Fixed — classic game
+
+- **L'Anarchie scored every trick with the end-of-round trump.** Tricks now
+  record the trump they were played under (`GameState.trick_trumps`) and final
+  scoring uses it (was wrong in ~99% of L'Anarchie rounds).
+- A **worthless carré of 7s/8s outranked the other team's sequences** and
+  wiped out their points. 0-point carrés no longer take part in declarations.
+- **Hard AI threw high off-suit cards to the opponents**, believing an
+  off-suit Ace beat a led King (normal and Tout Atout contracts).
+- **Tout Atout under L'Anarchie** silently became a one-suit game while still
+  being scored as Tout Atout; trump no longer rotates under TA.
+- Capots by the opponents counted as **your** capots in stats/achievements;
+  `first_capot` used `== 1`; "Triple Coup" read lifetime instead of session capots.
+- 6+ card sequences were labelled "0" in the round summary.
+
+### Fixed — terminal, UI and files
+
+- `--target 750` (non-preset) crashed the main menu.
+- Stats file: atomic writes; corrupt / wrong-shaped files no longer crash the
+  game (moved aside to `stats.json.bak`).
+- Unknown escape sequences leaked as keystrokes (F2 quit the game, Ctrl+→
+  played card 5, Delete typed `~`); Ctrl-C now quits.
+- In-game `FitAbortedError` (terminal too small → Q) exits cleanly.
+- Spacious HUD overflowed at 120–143 columns and scrolled the screen.
+- Game-over screen "staircased" (bare `\n` in raw mode).
+- Pressing T crashed on a read-only config dir; theme saves are atomic.
+- The game can now start on Windows (`termios` imported only on Unix); classic
+  stats honour `%APPDATA%`.
+- `BELOTE_A11Y=1` no longer scribbles over the game screen — see
+  DEVELOPMENT.md → Accessibility (`BELOTE_A11Y_OUT`).
+
+### Fixed — BelAtro
+
+- **All-pass deals ended the run**; they now redeal (and round-end jokers no
+  longer fire on the abandoned deal).
+- Partner bidding was backwards in round 1 (could take any suit except the
+  legal one; L'Économe could never bid).
+- L'Architecte "buy contract" crashed in round 1 after taking $10.
+- Le Traître / L'Agent Double replaced the boss's larger sabotage set.
+- L'Avocat's doubled target was ignored for payout, Le Puriste, trust and history.
+- Ghost runs: real seeds, seeded rounds, unique file names.
+- Corrupt / newer-schema `profile.json` no longer crashes launch.
+- Capots by EW counted as yours (unlocks, Pluto); Mercury/Pluto paid on EW contracts.
+- The shop offered jokers you already own (duplicates corrupted each other's
+  state); Le Jugement too.
+- Le Patriote, L'Illusionniste and La Sentinelle (P) mishandled Tout Atout;
+  Le Passeur paid $2 when North bid Sans Atout.
+- Shop cards: frame misaligned, long names overflowed, editions invisible.
+- Compact HUD: trust bar overwrote the synergy tooltip.
+- History overlay overflowed 90–99 column terminals.
+- An ante-8 victory continued into endless mode was recorded as a loss.
+
+### Changed — design calls
+
+- **Le Diable** now works: for one round North over-cuts with its lowest
+  winning trump whenever it can — even over your winning card.
+- **Sell jokers** in the shop with `S` for half their cost (same value as
+  La Tempérance). Corrupted jokers can't be sold; selling a Negative joker
+  returns its slot.
+- **Le Sergent** grows with the streak: +0.5, +1.0, +1.5, then +2.0 per trick
+  (was a flat +0.5 that ignored "consecutive").
+- **Le Tournoi** really offers you a coinche; theme flags no longer outlive
+  their ante. **Le Café**'s +25 chips is a petit-blind bonus, not permanent.
+- **Auto-Capot** (trust 9+) is no longer advertised — it was never implemented.
+- **Trust 3+ shows North's void suits** (`✦ Void: ♠♦`) instead of the whole
+  hand; seeing the full hand needs Le Carnet.
+- **Pluto** pays only when you took the contract and made it as a capot.
+
+## [4.9.6] - 2026-06-01
+
+Follow-up bug-hunt, logic, and performance audit. Three parallel Explore agents
+re-swept the classic engine, BelAtro mechanics, and the UI/render layer; every
+"major" finding was then traced to exact code and verified before acting. The
+result: **no critical or major bug survived verification.** The flagged items
+were all either false positives (Le Passeur "double-payout" — the post-coinche
+`BidMadeEvent` re-emit carries the taker's seat + a real trump, so the
+North-pass gate never matches; Le Carnet's +1 Mult *is* wired via
+`acc.carnet_active`; Tout Streak / Quinte Royale re-emit guards are already
+present; `modifier_patch` is a fresh per-instance proxy each round) or
+intentional, test-pinned behaviour (Le Patriote's `// 2`). Benchmarks confirmed
+the render/scoring/AI paths are already well within budget (render ≈0.4 ms, E2E
+round ≈4–6 ms). This release therefore lands the one genuine latent gap the
+audit surfaced plus a layer of behaviour-locking tests. Test count 1079 → 1111.
+
+### Added
+
+- **Minimal wide-character (wcwidth) support** (`src/belote/ansi.py`). `visible_len()`
+  previously counted codepoints, so `ansi_center()` / `ansi_ljust()` and the
+  render diff's per-row width would mis-align by one cell per wide glyph (emoji,
+  CJK). A new dependency-free `char_width()` (stdlib `unicodedata`) returns 0
+  for combining/zero-width marks, 2 for East-Asian Wide/Fullwidth, 1 otherwise,
+  and `visible_len()` now measures display **cells**. A pure-ASCII escape-free
+  fast path keeps the hot render path allocation-free and byte-identical, so
+  there is no performance regression. A new `ansi_truncate()` (cell-aware,
+  escape-skipping) replaces the raw byte-slices that trimmed BelAtro HUD joker
+  names and synergy lines (`belatro/ui/hud.py`), which could previously split a
+  wide glyph.
+- **Behaviour-locking tests** that freeze what the audit confirmed correct:
+  `tests/test_render_golden.py` (full-frame snapshot + per-row cell-width
+  fingerprint — the regression guard for the wcwidth change),
+  `tests/test_wcwidth.py` (per-character widths and helper cell-correctness),
+  `tests/test_scoring_totals.py` (the canonical 152 / 120 / 248 point totals,
+  belote 20, capot bases 252 / 220 / 348, dix de der +10), and
+  `tests/belatro/test_registry_integrity.py` (item-census counts 42 jokers /
+  8 planets / 12 tarots / 12 vouchers, id↔key consistency, no duplicate display
+  names — so a duplicate-id registration that silently overwrites an item now
+  fails a test).
+
 ## [4.9.5] - 2026-05-28
 
 Bug-hunt, logic, and performance audit pass. Three parallel Explore agents

{belote_cli-4.9.5 → belote_cli-4.9.7}/DEVELOPMENT.md

@@ -2,6 +2,61 @@
 
 Welcome to the Belote development guide. This project is structured as a standard Python package.
 
+## Cheat Sheet
+
+Everything below assumes you're in the repo with the venv active:
+
+```bash
+cd ~/Projects/belote
+source .venv/bin/activate        # gives you `python`, `pip`, pytest, mypy, ruff
+```
+
+**1. Check everything is green (do this before every commit):**
+```bash
+PYTHONPATH=src python -m pytest -q && \
+  PYTHONPATH=src python -m mypy --strict src/ && \
+  python -m ruff check src/ tests/
+```
+
+**2. Push code to GitHub (no PyPI release):**
+```bash
+git status                       # see what changed — don't commit editor swap files
+git add <files>                  # or: git add -A   (after checking git status)
+git commit -m "what changed"
+git push origin master
+```
+
+**3. Release a new version to PyPI** (example: 4.9.7):
+```bash
+# a) bump the version in BOTH files (they must match):
+#      pyproject.toml          ->  version = "4.9.7"
+#      src/belote/__init__.py  ->  __version__ = "4.9.7"
+# b) add a "## 4.9.7" entry at the top of CHANGELOG.md
+# c) run the gates (step 1), then commit, tag and push:
+git add -A
+git commit -m "Release v4.9.7"
+git tag -a v4.9.7 -m "v4.9.7"
+git push origin master --tags
+# d) build, check and upload:
+rm -rf dist/ build/ *.egg-info/
+pipx run build --sdist --wheel
+pipx run twine check dist/*
+pipx run twine upload dist/*
+#    username: __token__
+#    password: your PyPI API token (starts with pypi-)
+#    make one at https://pypi.org/manage/account/token/
+```
+
+**4. Update the game installed with pipx** (from PyPI — https://pypi.org/project/belote-cli/):
+```bash
+pipx install belote-cli          # first time only
+pipx upgrade belote-cli          # after each release
+belote --version                 # confirm the new version
+```
+PyPI can take a minute to show a new upload. If `pipx upgrade` says you're
+already on the latest, wait a moment and retry, or force it with
+`pipx install --force belote-cli`.
+
 ## Setup
 
 1. **Clone the repository:**
@@ -10,15 +65,17 @@ Welcome to the Belote development guide. This project is structured as a standar
    cd belote
    ```
 
-2. **Create a virtual environment:**
+2. **Create a virtual environment** (use `python3` — many Linux distros don't
+   ship a bare `python` or `pip` outside a venv):
    ```bash
-   python -m venv .venv
+   python3 -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    ```
 
-3. **Install in editable mode:**
+3. **Install in editable mode with the test + dev tools** (pytest, pytest-cov,
+   mypy, ruff):
    ```bash
-   pip install -e .
+   pip install -e ".[test,dev]"
    ```
 
 ## Running the Game
@@ -42,29 +99,31 @@ PYTHONPATH=src python3 -m belote.main
 
 ## Testing
 
-We use `pytest` for testing. Install it if you haven't already:
-```bash
-pip install pytest
-```
+We use `pytest` (installed by `pip install -e ".[test,dev]"` above).
+
+`tests/conftest.py` points `HOME`, `XDG_CONFIG_HOME` and `XDG_DATA_HOME` at a
+throwaway temp dir for the whole run, so the suite never reads or writes your
+real `~/.config/belote/theme.json`, stats or BelAtro saves, and always renders
+with the default theme (the golden-frame snapshot depends on that).
 
 Run tests:
 ```bash
 # Run all tests (Classic + BelAtro)
 PYTHONPATH=src pytest
 
-# Run only Classic Belote tests
-PYTHONPATH=src pytest tests/
+# Run only Classic Belote tests (tests/belatro/ lives inside tests/)
+PYTHONPATH=src pytest tests/ --ignore=tests/belatro
 
 # Run only BelAtro tests
 PYTHONPATH=src pytest tests/belatro/
 
 # Run a single test file
-PYTHONPATH=src pytest tests/test_game.py
-PYTHONPATH=src pytest tests/belatro/test_scoring.py
+PYTHONPATH=src pytest tests/test_game_logic.py
+PYTHONPATH=src pytest tests/belatro/test_round_driver.py
 
 # Run a single test by name
-PYTHONPATH=src pytest tests/test_game.py::test_play_card_legal
-PYTHONPATH=src pytest -k "test_scoring"
+PYTHONPATH=src pytest tests/test_render_golden.py::test_golden_frame_sha256
+PYTHONPATH=src pytest -k "capot"
 
 # Run with verbose output
 PYTHONPATH=src pytest -v
@@ -84,7 +143,7 @@ PYTHONPATH=src mypy --strict src/
 # Linting (0 violations expected)
 ruff check src/ tests/
 
-# Full test suite (1079 tests expected)
+# Full test suite (1228 tests expected)
 PYTHONPATH=src pytest
 ```
 
@@ -92,7 +151,7 @@ Run all gates before committing:
 
 ```bash
 PYTHONPATH=src python -m pytest --tb=short -q && \
-  python -m mypy --strict src/ && \
+  PYTHONPATH=src python -m mypy --strict src/ && \
   python -m ruff check src/ tests/
 ```
 
@@ -116,8 +175,18 @@ Use these as a regression-detection floor for future changes.
 
 Set `BELOTE_A11Y=1` to emit one-line plain-text descriptions of card plays,
 trick winners, locked contracts (4.6.5), declarations (4.6.5), and round
-results to stderr — readable by terminal screen readers (Orca, NVDA over
-WSL, VoiceOver via iTerm2).
+results — readable by terminal screen readers (Orca, NVDA over WSL,
+VoiceOver via iTerm2).
+
+Where the lines go (4.9.7 — writing them onto the full-screen game used to
+scroll and scramble the frame):
+
+- `BELOTE_A11Y_OUT=/path` — appended to that file or terminal device, e.g.
+  run `tty` in a second terminal and use its `/dev/pts/N`.
+- otherwise stderr, when it's redirected (`belote 2>a11y.txt`) or is a
+  different terminal from the game.
+- otherwise `~/.local/share/belote/a11y.log` (`%APPDATA%\belote\a11y.log` on
+  Windows) — follow it with `tail -f` in another terminal.
 
 The env var is read once at import; tests that mutate it must call
 `belote.a11y._refresh_enabled_from_env()` after the patch. Hook points live
@@ -136,8 +205,8 @@ once at startup; toggling mid-run has no effect.
   affects scoring. Backed by `src/belote/replay.py`.
 - `BELOTE_GHOST=1` — silently record every BelAtro run (seed, deck,
   bids, plays, round outcomes) to
-  `~/.local/share/belote/ghosts/<label>-<seed>.json`. The file is written
-  once when the run ends. Useful for sharing or replaying interesting
+  `~/.local/share/belote/ghosts/<label>-<seed>-<timestamp>.json`. The file
+  is written once when the run ends and never overwrites an earlier one. Useful for sharing or replaying interesting
   runs. Backed by `src/belote/belatro/ghost_run.py`.
 - `NO_COLOR=<any-non-empty>` — suppress truecolor SGR escapes from
   `fg()` / `bg()` per the [no-color.org](https://no-color.org/) spec.
@@ -164,9 +233,9 @@ once at startup; toggling mid-run has no effect.
 
 ## Releasing a New Version
 
-### Code-only update (push to GitHub without releasing a new PyPI version)
+The short version is in the [Cheat Sheet](#cheat-sheet) at the top. Details:
 
-If you're just iterating on code, fixing typos, updating docs, etc., and don't want to cut a new PyPI release yet:
+### Code-only update (push to GitHub without releasing a new PyPI version)
 
 ```bash
 git add <files>
@@ -174,32 +243,32 @@ git commit -m "<what changed>"
 git push origin master
 ```
 
-## Releasing a New Version (Manual)
+### Full release (GitHub + PyPI)
 
-1. **Bump the version** in BOTH `pyproject.toml` AND `src/belote/__init__.py`
+1. **Run all gates** (see Code Quality) — don't release a red build.
+2. **Bump the version** in BOTH `pyproject.toml` AND `src/belote/__init__.py`
    (they must stay in sync — `belote --version` / `belatro --version` read
    `__version__` while PyPI / pipx read `pyproject.toml`).
-2. **Add a CHANGELOG entry** at the top of `CHANGELOG.md`.
-3. **Clean stale build artifacts:**
+3. **Add a CHANGELOG entry** at the top of `CHANGELOG.md`.
+4. **Commit, tag and push:**
    ```bash
-   rm -rf dist/ build/ *.egg-info/
+   git add -A          # check `git status` first
+   git commit -m "Release vX.Y.Z"
+   git tag -a vX.Y.Z -m "vX.Y.Z"
+   git push origin master --tags
    ```
-4. **Build, validate, and upload:**
+5. **Clean stale build artifacts, then build, validate and upload:**
    ```bash
+   rm -rf dist/ build/ *.egg-info/
    pipx run build --sdist --wheel
    pipx run twine check dist/*
    pipx run twine upload dist/*
    ```
-
-   *Note: `twine upload` will prompt for your PyPI credentials or use your `~/.pypirc` file.*
-
-5. **Commit and tag in git:**
-   ```bash
-   git add pyproject.toml CHANGELOG.md
-   git commit -m "Release vX.Y.Z"
-   git tag -a vX.Y.Z -m "vX.Y.Z"
-   git push origin master --tags
-   ```
+   `twine upload` uses `~/.pypirc` if present; otherwise it prompts — enter
+   `__token__` as the username and a PyPI API token as the password.
+   PyPI never accepts the same version twice, so a botched upload means
+   bumping to the next patch version.
+6. **Update your own install:** `pipx upgrade belote-cli`.
 
 ## Performance measurement
 
@@ -221,8 +290,10 @@ PYTHONPATH=src python scripts/benchmark.py
 If you suspect a per-frame allocation regression, the canonical hot paths to
 profile live (e.g. with `py-spy record --rate 100`) are `render()` in
 `src/belote/ui/render.py` and `_calculate_legal_cards_impl` in
-`src/belote/game.py`. The 4.9.4 / 4.9.5 audit passes found only minor wins
+`src/belote/game.py`. The 4.9.4 / 4.9.5 / 4.9.6 audit passes found only minor wins
 beyond those already landed in the 4.6.x / 4.7.x perf cleanups (4.9.5 bumped
 the `_pip_at` cache to 8192, trimmed `visible_len`'s cache to ANSI strings,
-and memoised the BelAtro history overlay) — start from a profiler trace, not
-from guesswork, before adding new caches.
+and memoised the BelAtro history overlay; 4.9.6 made `visible_len` measure
+terminal *cells* via a minimal `char_width`, keeping the allocation-free
+ASCII fast path so the hot path is unchanged) — start from a profiler trace,
+not from guesswork, before adding new caches.

{belote_cli-4.9.5 → belote_cli-4.9.7}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: belote-cli
-Version: 4.9.5
+Version: 4.9.7
 Summary: A 4-player terminal card game
 Project-URL: Homepage, https://github.com/ElysiumDisc/belote
 Project-URL: Repository, https://github.com/ElysiumDisc/belote
@@ -157,8 +157,8 @@ belatro
 # Install in editable mode (recommended for development)
 pip install -e .
 
-# Or install from PyPI (once uploaded)
-pip install belote-cli
+# Or install from PyPI (recommended for playing)
+pipx install belote-cli      # update later with: pipx upgrade belote-cli
 
 # Play using the belote command
 belote
@@ -189,6 +189,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 **BelAtro (Roguelite):**
 - `1`-`5`: Inspect specific Jokers in the Shop
 - `C`: Open the Consumables tray in the Shop (use Tarots / Planets you've purchased)
+- `S` *(4.9.7)*: Sell a joker in the Shop for half its cost (corrupted jokers can't be sold)
 
 **Gameplay:**
 - `←` `→` or `↑` `↓` or **`W` `A` `S` `D`** *(4.5.0)*: Move selection
@@ -211,7 +212,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Collection (Almanac):** Persistent tracker to browse every Joker, Planet, and Voucher you've discovered across your runs.
 - **Full Boss Blind Suite:** All 21 unique bosses implemented, including complex mechanics like *L'Anarchie* (dynamic trump) and *La Rupture* (no consecutive wins).
 - **Multiplier Scoring:** Use items to stack Multipliers and reach scores in the millions.
-- **Partner Trust:** Build a relationship with your AI partner to unlock synergies.
+- **Partner Trust:** Build a relationship with your AI partner to unlock synergies. At trust 3+ the trust bar shows which suits North is void in (`✦ Void: ♠♦`); seeing North's full hand requires the Le Carnet voucher.
 - **Rich Terminal UI:** Full-screen themed felt table with detailed card graphics and "You" vs "Partner" terminology.
 - **Enhanced Hard AI**: Advanced void inference and 2-ply lookahead for critical tricks (Dix de Der).
 - **Customizable Themes:** Switch between thirteen color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast, Colorblind, Forest Night, Moonlit Tavern, Royal Purple, Emerald Isle, Sunset Magma, Provence Lavande) using the `T` key during gameplay.
@@ -264,7 +265,7 @@ belote/
 │   ├── input.py       # Platform-dispatched key reader and interruptible sleep
 │   ├── stats.py       # Global and session statistics tracking
 │   └── rules.py       # Game rules content
-├── tests/             # Comprehensive test suite (1079 tests)
+├── tests/             # Comprehensive test suite (1228 tests)
 ├── scripts/           # Performance benchmarks
 ├── pyproject.toml      # Build system and dev dependencies (ruff/mypy)
 ├── LICENSE             # MIT License
@@ -279,14 +280,14 @@ belote/
 PYTHONPATH=src pytest
 ```
 
-Currently **1079 tests** passing with 100% coverage on game-logic modules (4.9.5).
+Currently **1228 tests** passing with 100% coverage on game-logic modules (4.9.7).
 
 ## Technical Integrity
 
 The codebase is strictly validated with the following tools:
 - **mypy**: 0 errors (strict type safety)
 - **ruff**: 0 violations (linting & formatting)
-- **pytest**: 1044/1044 passed
+- **pytest**: 1228/1228 passed
 - **Functional Architecture**: Purely immutable state transitions using `dataclasses.replace`
 - **Performance**: High-efficiency rendering and sub-millisecond AI decision times (see `scripts/benchmark.py`)
 

{belote_cli-4.9.5 → belote_cli-4.9.7}/README.md

@@ -114,8 +114,8 @@ belatro
 # Install in editable mode (recommended for development)
 pip install -e .
 
-# Or install from PyPI (once uploaded)
-pip install belote-cli
+# Or install from PyPI (recommended for playing)
+pipx install belote-cli      # update later with: pipx upgrade belote-cli
 
 # Play using the belote command
 belote
@@ -146,6 +146,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 **BelAtro (Roguelite):**
 - `1`-`5`: Inspect specific Jokers in the Shop
 - `C`: Open the Consumables tray in the Shop (use Tarots / Planets you've purchased)
+- `S` *(4.9.7)*: Sell a joker in the Shop for half its cost (corrupted jokers can't be sold)
 
 **Gameplay:**
 - `←` `→` or `↑` `↓` or **`W` `A` `S` `D`** *(4.5.0)*: Move selection
@@ -168,7 +169,7 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Collection (Almanac):** Persistent tracker to browse every Joker, Planet, and Voucher you've discovered across your runs.
 - **Full Boss Blind Suite:** All 21 unique bosses implemented, including complex mechanics like *L'Anarchie* (dynamic trump) and *La Rupture* (no consecutive wins).
 - **Multiplier Scoring:** Use items to stack Multipliers and reach scores in the millions.
-- **Partner Trust:** Build a relationship with your AI partner to unlock synergies.
+- **Partner Trust:** Build a relationship with your AI partner to unlock synergies. At trust 3+ the trust bar shows which suits North is void in (`✦ Void: ♠♦`); seeing North's full hand requires the Le Carnet voucher.
 - **Rich Terminal UI:** Full-screen themed felt table with detailed card graphics and "You" vs "Partner" terminology.
 - **Enhanced Hard AI**: Advanced void inference and 2-ply lookahead for critical tricks (Dix de Der).
 - **Customizable Themes:** Switch between thirteen color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast, Colorblind, Forest Night, Moonlit Tavern, Royal Purple, Emerald Isle, Sunset Magma, Provence Lavande) using the `T` key during gameplay.
@@ -221,7 +222,7 @@ belote/
 │   ├── input.py       # Platform-dispatched key reader and interruptible sleep
 │   ├── stats.py       # Global and session statistics tracking
 │   └── rules.py       # Game rules content
-├── tests/             # Comprehensive test suite (1079 tests)
+├── tests/             # Comprehensive test suite (1228 tests)
 ├── scripts/           # Performance benchmarks
 ├── pyproject.toml      # Build system and dev dependencies (ruff/mypy)
 ├── LICENSE             # MIT License
@@ -236,14 +237,14 @@ belote/
 PYTHONPATH=src pytest
 ```
 
-Currently **1079 tests** passing with 100% coverage on game-logic modules (4.9.5).
+Currently **1228 tests** passing with 100% coverage on game-logic modules (4.9.7).
 
 ## Technical Integrity
 
 The codebase is strictly validated with the following tools:
 - **mypy**: 0 errors (strict type safety)
 - **ruff**: 0 violations (linting & formatting)
-- **pytest**: 1044/1044 passed
+- **pytest**: 1228/1228 passed
 - **Functional Architecture**: Purely immutable state transitions using `dataclasses.replace`
 - **Performance**: High-efficiency rendering and sub-millisecond AI decision times (see `scripts/benchmark.py`)
 

{belote_cli-4.9.5 → belote_cli-4.9.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "belote-cli"
-version = "4.9.5"
+version = "4.9.7"
 description = "A 4-player terminal card game"
 readme = "README.md"
 requires-python = ">=3.10"

{belote_cli-4.9.5 → belote_cli-4.9.7}/scripts/benchmark.py

@@ -4,6 +4,7 @@ import random
 import statistics
 import sys
 import time
+from dataclasses import replace
 from pathlib import Path
 
 # Add src to sys.path
@@ -23,7 +24,6 @@ def benchmark_render(iterations: int = 100) -> float:
     rng = random.Random(42)
     state = start_round(state, rng)
     # Mock some state transitions to get into PLAYING phase
-    from belote.game import replace
 
     state = replace(state, phase=Phase.PLAYING, trump=Suit.SPADES, taker=Seat.SOUTH)
 
@@ -50,7 +50,6 @@ def benchmark_ai(difficulty: Difficulty, iterations: int = 50) -> float:
     state = new_game()
     rng = random.Random(42)
     state = start_round(state, rng)
-    from belote.game import replace
 
     state = replace(state, phase=Phase.PLAYING, trump=Suit.SPADES, taker=Seat.SOUTH)
 
@@ -69,12 +68,13 @@ def benchmark_ai(difficulty: Difficulty, iterations: int = 50) -> float:
 def benchmark_belatro_bus(num_jokers: int = 5, iterations: int = 1000) -> float:
     from belote.belatro.core.scoring import ScoreAccumulator
     from belote.belatro.engine.event_bus import TrickWonEvent
+    from belote.belatro.items.base import Joker
     from belote.belatro.items.jokers.contract import LeDiplomate
     from belote.deck import Card, Rank
 
     print(f"Benchmarking BelAtro State Update ({num_jokers} Jokers) over {iterations} iterations...")
 
-    jokers = [LeDiplomate() for _ in range(num_jokers)]
+    jokers: list[Joker] = [LeDiplomate() for _ in range(num_jokers)]
     acc = ScoreAccumulator()
     acc.attach_jokers(jokers)
 
@@ -102,7 +102,7 @@ def benchmark_belatro_bus(num_jokers: int = 5, iterations: int = 1000) -> float:
 
 def benchmark_scoring(iterations: int = 1000) -> float:
     from belote.deck import Card, Rank
-    from belote.game import Phase, TrickCard, replace
+    from belote.game import Phase, TrickCard
     from belote.scoring import score_round
 
     print(f"Benchmarking score_round() over {iterations} iterations...")
@@ -147,7 +147,7 @@ def benchmark_deal(iterations: int = 1000) -> float:
 
 
 def benchmark_legal_cards(iterations: int = 1000) -> float:
-    from belote.game import clear_legal_cards_cache, legal_cards, replace
+    from belote.game import clear_legal_cards_cache, legal_cards
     print(f"Benchmarking legal_cards() (cache cleared per call) over {iterations} iterations...")
 
     state = new_game()
@@ -172,7 +172,7 @@ def benchmark_legal_cards_cached(iterations: int = 1000) -> float:
     `benchmark_legal_cards` above invalidates every iteration and so reflects
     worst-case-only time.
     """
-    from belote.game import clear_legal_cards_cache, legal_cards, replace
+    from belote.game import clear_legal_cards_cache, legal_cards
     print(f"Benchmarking legal_cards() (warm cache) over {iterations} iterations...")
 
     state = new_game()
@@ -198,7 +198,7 @@ def benchmark_trick_scoring(iterations: int = 1000) -> float:
     (final round score). One of the hottest functions in a played round.
     """
     from belote.deck import Card, Rank
-    from belote.game import TrickCard, replace
+    from belote.game import TrickCard
     from belote.scoring import trick_card_points
 
     print(f"Benchmarking trick_card_points() over {iterations} iterations...")
@@ -228,7 +228,7 @@ def benchmark_ai_legality_filter(iterations: int = 500) -> float:
     AI calls `legal_cards` once per decision; an unrepresentative cold-cache
     benchmark above would over-attribute AI time to legality checks.
     """
-    from belote.game import legal_cards, replace
+    from belote.game import legal_cards
     print(f"Benchmarking AI legality filter over {iterations} iterations...")
 
     state = new_game()

{belote_cli-4.9.5 → belote_cli-4.9.7}/src/belote/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "4.9.5"
+__version__ = "4.9.7"
 
 __all__ = ["__version__"]