belote-cli 4.7.2__tar.gz → 4.8.0__tar.gz

{belote_cli-4.7.2 → belote_cli-4.8.0}/CHANGELOG.md

@@ -5,6 +5,182 @@ 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.8.0] - 2026-05-21
+
+Feature release: a twelfth theme, a coordinated animation polish pass for
+BelAtro, and a tactile feel pass for classic-mode Belote. All additions are
+UI-only — zero rules / scoring / AI changes. Every new helper follows the
+established `try / finally invalidate_diff()` architectural rule (4.6.4 /
+4.0.0). New `BELOTE_NO_ANIM=1` env-var kill switch short-circuits every new
+animation to its end-state for slow terminals or scripted runs.
+
+### Added
+
+- **Twelfth theme: Sunset Magma** (`src/belote/themes.py::sunset_magma`).
+  Deep-magenta felt, coral suits, smoky-purple "blacks", amber-sunset
+  highlights, magenta-on-cream banners. Fills the warm orange/magenta niche
+  none of the existing 11 themes occupied. Cycles via the `T` key and
+  shows up in the main-menu theme selector automatically — no other code
+  changes needed because `ThemeManager.set_current` validates dynamically.
+- **Shared animation toolkit** (`src/belote/ui/anim.py`). New module with
+  three easing helpers (`ease_out_quad`, `ease_in_out_quad`,
+  `ease_out_cubic`) and three painted-frame helpers (`pulse_text`,
+  `float_text`, `tick_bar`). Every painted helper ends with
+  `invalidate_diff()` in `finally`; every interruptible delay routes
+  through `reader.read_timeout(...)` so test stubs (and the existing
+  `slot_machine_tally` idiom) work uniformly. Env switch
+  `BELOTE_NO_ANIM=1` short-circuits to the end-state, paired with
+  `_refresh_animations_enabled_from_env()` for test fixtures.
+- **(BelAtro / B1) Joker trigger callouts in the slot-machine tally**
+  (`belatro/ui/announce.py`). Per-trick log entries added by
+  `ScoreAccumulator._log` (joker firings, planet/Carnet/Architecte
+  attributions) now float above the bucket row as labelled callouts
+  (`⚡ Foo: +25 chips` / `✦ Bar: ×2.5 Mult` / `$ Architecte: +$2 …`).
+  New module-level `_last_log_count` cursor + `_classify_callout` /
+  `_emit_callouts` helpers; reset by `reset_tally_state()`. Capped at 4
+  callouts per trick to keep the moment under ~600 ms.
+- **(BelAtro / B2) Shop purchase and reroll feedback**
+  (`belatro/ui/shop.py`). New `_animate_purchase(idx, num_items, money_before,
+  money_after)` (gold pulse on the bought slot + `tick_bar` money tick-down)
+  and `_animate_reroll(num_items)` (pulsed "↻ rerolling..." cue before the
+  new inventory paints). Hooked from the existing `run()` loop without
+  changing shop state semantics.
+- **(BelAtro / B3) Target-crossing celebration**
+  (`belatro/ui/announce.py::_emit_target_celebration`). Fires once per
+  round on the first tally where the running total crosses
+  `acc.target_score`: gold pulse on the odometer line plus a `★ TARGET ★`
+  floater above it. The existing 1.2× flame row is unchanged.
+- **(BelAtro / B4) Trust-bar tick-up animation**
+  (`belatro/ui/trust_bar.py::TrustBar.animate_change`). After the
+  round-end trust mutations in `belatro/main.py` (`blind_beaten` /
+  `blind_failed` / `big_margin_win` / `chute` / `capot_together`), the bar
+  animates from the pre-round value to the post-round value via `tick_bar`.
+  Snapshot taken right after `trust = self.run.partner.trust`; animation
+  fires only when `trust.value != pre_trust_value`.
+- **(Classic / C3) Tactile play-trail on SOUTH plays**
+  (`belote/ui/render.py::slide_card_to_table_hint`). A brief vertical
+  sparkle trail (`✦/✧/·`) from the south hand toward the south trick
+  slot, painted just before the played card lands via `patch_trick_card`.
+  AI plays are unchanged. Self-cleaning trail; ~120 ms, skippable.
+- **(Classic / C4) Trick-winner glow + hold**
+  (`belote/ui/render.py::pulse_winner_glow`). After all four cards land
+  and the MIN_TRICK_DWELL pause completes, a 3-frame gold→white→gold pulse
+  on the bottom hint row announces `★ <Direction> wins the trick ★`
+  before the trick sweeps. Computed via `trick_winner_seat` (Rupture
+  swing takes effect at scoring, so the on-table label stays accurate).
+- **(Classic / C5) Dramatic centered Belote / Rebelote stinger**
+  (`belote/ui/announce.py::belote_stinger`). Replaces the modest
+  one-line `announce("Belote!")` / `announce("Rebelote!")` call with a
+  4-row centered banner framed in `╔═╗║╚═╝` chars, painted in the active
+  theme's `banner_bg()` + `gold_fg()`. Falls back to the slim
+  `announce()` path on terminals narrower than 32 columns. Routed through
+  `gameflow.py`'s existing `current.announced` dispatch.
+
+### Internal
+
+- `belote/ui/__init__.py` now re-exports `belote_stinger`,
+  `pulse_winner_glow`, and `slide_card_to_table_hint` alongside the
+  existing UI surface.
+- Test count baseline: **1028** (4.7.3 had 1007; +21 in 4.8.0). New files:
+  `tests/test_anim_helpers.py` (8), `tests/test_belote_stinger.py` (2),
+  `tests/test_winner_glow.py` (5), `tests/belatro/test_joker_callouts.py`
+  (5), `tests/belatro/test_shop_animations.py` (2). All anim tests use
+  `sys.modules["belote.ui.render"]` to bypass the `belote.ui` re-export
+  shadow (per the 4.0.0 architectural note).
+- **Deferred from this release:** the original plan included a
+  "card lift on selection" (C1) and "smooth highlight slide between cards"
+  (C2) for the south-hand cursor. Both require deeper changes to the
+  multi-row horizontal hand renderer than fit cleanly in the same release
+  as the new toolkit; tracked for a follow-up. The remaining tactile
+  effects (C3 trail, C4 winner glow, C5 stinger) ship as planned.
+
+## [4.7.3] - 2026-05-21
+
+Patch release: targeted bug-hunt + performance + code-logic audit. Three
+parallel exploration passes (classic engine, BelAtro layer, UI/render)
+surfaced ~30 candidate findings; verifying each against the live code
+rejected the false positives (deck.py "deluge scores 0", LePasseur "missing
+re_emit guard", show_rules "missing invalidate on scroll", show_history
+"missing term_h in cache key", legal_cards "missing trick_rank hoist") and
+shipped only the verified-true delta. All baselines green: `ruff` 0
+violations, `mypy --strict` 0 errors, `pytest` 1007/1007.
+
+### Fixed
+
+- **(Bug) `announce()` did not invalidate the render-diff baseline.** The
+  function paints a transient banner with absolute cursor positioning,
+  bypassing `display()`. Without a post-paint `invalidate_diff()` the next
+  `display()` diffed against `_last_emitted_lines` (which has no record of
+  the banner) and could leave the banner visible as a ghost on the bottom
+  row. Same architectural rule as `show_help` / `show_history` /
+  `show_rules` / `show_card_detail` / `show_round_summary` /
+  `animate_score_update`. `announce()` was the last unfixed site of the
+  4.0.0 / 4.6.4 finally-pattern sweep. Pinned by
+  `test_announce_invalidates_diff_baseline` in `tests/test_render_diff.py`.
+- **(Bug) L'Infiltré × La Déluge interaction.** The `ghost_lead` deck rule
+  paid `+2 Mult / +$1` when NS won a trick by playing trump on a "non-trump
+  lead". The is-trump-lead check at `belatro/core/scoring.py:414-417`
+  considered only `lead_suit == event.trump` and the TOUT_ATOUT case —
+  it did not honour `seven_eight_trump` (La Déluge), so a 7-led or 8-led
+  trick was incorrectly treated as a non-trump lead and the bonus could
+  fire even though the lead was effectively trump. Pinned by
+  `test_ghost_lead_silent_when_lead_is_seven_under_deluge` in
+  `tests/belatro/test_decks_4_5.py`.
+- **(Defensive) `LeDemon.on_purchase` is now idempotent.** Re-running the
+  hook on an already-owned joker (a future save/load round-trip or replay-
+  resume tool) would have compounded the trust subtraction. New
+  `_applied_purchase_ids: set[str]` field on `BelAtroRun` (mirrors
+  `_applied_voucher_ids` from 3.9.3) short-circuits the second call. Pinned
+  by `test_le_demon_on_purchase_is_idempotent` in
+  `tests/belatro/test_joker_contracts.py`.
+
+### Changed
+
+- **AI comment about La Déluge corrected** (`src/belote/ai.py:293-296`).
+  The pre-4.7.3 comment claimed "promotes 7s/8s of trump above the Jack" —
+  but `deck.py::trick_rank` puts the 7 at rank 8 and the 8 at rank 9
+  (the two LOWEST trumps, scoring 0). The boss description in
+  `boss.py:95` ("become trump") matches the code, not the comment. The
+  comment now states the actual behaviour so future maintainers don't
+  chase a phantom bug.
+- **`render_joker_pip_strip` / `render_synergy_tooltip` split into
+  builders + writers** (`belatro/ui/hud.py`). Pre-4.7.3 each helper did
+  its own `sys.stdout.write + flush` outside `BelAtroHUD._render`'s
+  batched parts list, costing 2–3 syscalls per HUD refresh instead of
+  one. New `build_joker_pip_strip` / `build_synergy_tooltip` return
+  strings; the legacy `render_*` wrappers (used by direct callers and
+  tests) still exist for backward compatibility. `BelAtroHUD.render`
+  and `_render_compact` now embed both builders into a single batched
+  write. Pinned by `test_belatro_hud_render_writes_once` in
+  `tests/belatro/test_hud_toggle.py`.
+
+### Performance
+
+- **`_get_card_face` reads `_cached_theme_name` instead of
+  `theme_manager.current_name`** (`belote/ui/render.py:314`). The module
+  already caches the theme name (line 84) and refreshes it via the theme
+  callback (line 95); `_get_card_face` is called ~52 times per game
+  frame, so eliminating the per-call property lookup shaves a few
+  microseconds off the render budget. The cache is kept in sync via the
+  existing theme-change callback. `clear_card_cache` ensures the card
+  face cache is reset on every theme change, so reading the cached name
+  is safe.
+
+### Internal
+
+- New `BelAtroRun._applied_purchase_ids: set[str]` field for joker
+  on_purchase idempotency (analogous to `_applied_voucher_ids`). Empty
+  by default; populated lazily by corrupted jokers with non-idempotent
+  on_purchase actions.
+- `build_joker_pip_strip(...) -> str` / `build_synergy_tooltip(...) -> str`
+  public builder API in `belatro/ui/hud.py`; `render_joker_pip_strip` /
+  `render_synergy_tooltip` retained as thin wrappers around the builders.
+
+### Test count baseline
+
+- 1007 (4.7.2 had 1003; +4 in 4.7.3 across `test_render_diff.py`,
+  `test_decks_4_5.py`, `test_joker_contracts.py`, `test_hud_toggle.py`).
+
 ## [4.7.2] - 2026-05-20
 
 Patch release: external-model audit verification pass. A prior audit (pasted

{belote_cli-4.7.2 → belote_cli-4.8.0}/DEVELOPMENT.md

@@ -84,7 +84,7 @@ PYTHONPATH=src mypy --strict src/
 # Linting (0 violations expected)
 ruff check src/ tests/
 
-# Full test suite (1003 tests expected)
+# Full test suite (1007 tests expected)
 PYTHONPATH=src pytest
 ```
 
@@ -143,6 +143,19 @@ once at startup; toggling mid-run has no effect.
   `fg()` / `bg()` per the [no-color.org](https://no-color.org/) spec.
   Bold/dim/underline/reverse/strikethrough and cursor sequences remain
   (they aren't color). Added in 3.9.0. Backed by `src/belote/ansi.py`.
+- `BELOTE_NO_ANIM=1` — short-circuit every 4.8.0 animation helper
+  (`pulse_text`, `float_text`, `tick_bar`, the joker callouts, the shop
+  purchase/reroll feedback, the trust-bar tick-up, the classic-mode
+  trail / winner glow) to its end-state with no perceptible delay.
+  Useful on slow terminals, in CI, or under scripted runs. Read once at
+  import; tests that mutate it must call
+  `belote.ui.anim._refresh_animations_enabled_from_env()` after the
+  patch. Independent of `BELOTE_NO_DIFF` — each lever is its own
+  toggle. Backed by `src/belote/ui/anim.py`.
+- `BELOTE_NO_DIFF=1` — disable the render-diff layer in
+  `belote/ui/render.py::display`; every call paints a full frame
+  instead of only changed rows. Escape hatch for debugging visual
+  artifacts on uncommon terminal emulators.
 
 ## Releasing a New Version
 

{belote_cli-4.7.2 → belote_cli-4.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: belote-cli
-Version: 4.7.2
+Version: 4.8.0
 Summary: A 4-player terminal card game
 Project-URL: Homepage, https://github.com/ElysiumDisc/belote
 Project-URL: Repository, https://github.com/ElysiumDisc/belote
@@ -43,7 +43,7 @@ Description-Content-Type: text/markdown
 
 # Belote – 4-Player Terminal Card Game
 
-Complete implementation of the French card game Belote for the terminal, with a full-screen themed felt table (11 palettes), full card graphics at compass positions (N/W/E/S), vignette and braille pip-texture polish, and an optional decorative outer frame.
+Complete implementation of the French card game Belote for the terminal, with a full-screen themed felt table (12 palettes), full card graphics at compass positions (N/W/E/S), vignette and braille pip-texture polish, and an optional decorative outer frame.
 
 ## BelAtro Expansion
 
@@ -207,13 +207,14 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Dix de Der Heist (4.7.0):** Take a contract and declare a heist before trick 1 — win trick 8 for a `×(1 + interest_rate)` Mult multiplier on your round score; lose it and forfeit your card chips from tricks 1–7. Gated on owning **La Voûte** voucher (`interest_rate > 0`). AI never declares.
 - **Slot-Machine Score Tally (4.7.0):** Per-trick odometer animation replaces the static popup. Chip-bucket fills, mult pulses, total ticks toward target, and a flame row crowns the odometer when you blow past 120% of the blind. Skippable on SPACE / ESC / ENTER. Final readout persists in the HUD between tricks (toggled by `I` alongside the top HUD). Suppressed under Le Brouillard (`hide_hud`) and La Compétition (`separate_scoring`).
 - **Inventory Overlay on V (4.7.0):** Press `V` mid-game to inspect everything you own — jokers (with edition tags + per-edition bonus blurb), vouchers, consumables, permanent chip / mult bonuses, and per-contract planet levels. List view → ↑/↓ navigate, Enter for detail, Esc/V/Q close. Read-only counterpart to the `C` consumables-action tray.
+- **Animation Polish (4.8.0):** Per-joker callouts float above the slot-machine tally as each joker fires, target-crossing pops a `★ TARGET ★` flag, shop purchases pulse + tick the money down, rerolls fade, and the trust bar ticks up between rounds. Belote / Rebelote now get a dramatic 4-row centered stinger. Classic-mode SOUTH plays paint a tactile sparkle trail; the trick winner glows briefly before the trick clears. All animations skip on any key press and respect `BELOTE_NO_ANIM=1` for slow terminals.
 - **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.
 - **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 eleven color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast, Colorblind, Forest Night, Moonlit Tavern, Royal Purple, Emerald Isle) using the `T` key during gameplay.
+- **Customizable Themes:** Switch between twelve 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) using the `T` key during gameplay.
 - **Polished Felt Mat (3.9.4):** The trick mat now has a subtle vignette at its edges, a faint deterministic braille pip-dot texture (fabric-weave feel without intrusive glyphs), and — at standard/spacious terminal sizes — a decorative `╔═══◆═══...═══◆═══╗` outer frame with corner ornaments.
 - **Selection HUD (3.9.4):** Selecting a card in hand now paints a highlighted bar under it AND a centered `► A♠ — Trump ◄` readout below, color-coded by suit / trump / legality.
 - **Hand Sorting:** Strategic "play value" organization (honors grouped together) for better tactical awareness.
@@ -263,7 +264,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 (1003 tests)
+├── tests/             # Comprehensive test suite (1007 tests)
 ├── scripts/           # Performance benchmarks
 ├── pyproject.toml      # Build system and dev dependencies (ruff/mypy)
 ├── LICENSE             # MIT License
@@ -278,14 +279,14 @@ belote/
 PYTHONPATH=src pytest
 ```
 
-Currently **1003 tests** passing with 100% coverage on game-logic modules (4.7.2).
+Currently **1028 tests** passing with 100% coverage on game-logic modules (4.8.0).
 
 ## Technical Integrity
 
 The codebase is strictly validated with the following tools:
 - **mypy**: 0 errors (strict type safety)
 - **ruff**: 0 violations (linting & formatting)
-- **pytest**: 1003/1003 passed
+- **pytest**: 1007/1007 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.7.2 → belote_cli-4.8.0}/README.md

@@ -1,6 +1,6 @@
 # Belote – 4-Player Terminal Card Game
 
-Complete implementation of the French card game Belote for the terminal, with a full-screen themed felt table (11 palettes), full card graphics at compass positions (N/W/E/S), vignette and braille pip-texture polish, and an optional decorative outer frame.
+Complete implementation of the French card game Belote for the terminal, with a full-screen themed felt table (12 palettes), full card graphics at compass positions (N/W/E/S), vignette and braille pip-texture polish, and an optional decorative outer frame.
 
 ## BelAtro Expansion
 
@@ -164,13 +164,14 @@ belote --difficulty hard --target 500 --seed 123 --speed fast
 - **Dix de Der Heist (4.7.0):** Take a contract and declare a heist before trick 1 — win trick 8 for a `×(1 + interest_rate)` Mult multiplier on your round score; lose it and forfeit your card chips from tricks 1–7. Gated on owning **La Voûte** voucher (`interest_rate > 0`). AI never declares.
 - **Slot-Machine Score Tally (4.7.0):** Per-trick odometer animation replaces the static popup. Chip-bucket fills, mult pulses, total ticks toward target, and a flame row crowns the odometer when you blow past 120% of the blind. Skippable on SPACE / ESC / ENTER. Final readout persists in the HUD between tricks (toggled by `I` alongside the top HUD). Suppressed under Le Brouillard (`hide_hud`) and La Compétition (`separate_scoring`).
 - **Inventory Overlay on V (4.7.0):** Press `V` mid-game to inspect everything you own — jokers (with edition tags + per-edition bonus blurb), vouchers, consumables, permanent chip / mult bonuses, and per-contract planet levels. List view → ↑/↓ navigate, Enter for detail, Esc/V/Q close. Read-only counterpart to the `C` consumables-action tray.
+- **Animation Polish (4.8.0):** Per-joker callouts float above the slot-machine tally as each joker fires, target-crossing pops a `★ TARGET ★` flag, shop purchases pulse + tick the money down, rerolls fade, and the trust bar ticks up between rounds. Belote / Rebelote now get a dramatic 4-row centered stinger. Classic-mode SOUTH plays paint a tactile sparkle trail; the trick winner glows briefly before the trick clears. All animations skip on any key press and respect `BELOTE_NO_ANIM=1` for slow terminals.
 - **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.
 - **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 eleven color palettes (Classic Green, Dark Mode, Blue Velvet, Red Casino, Sepia Vintage, High Contrast, Colorblind, Forest Night, Moonlit Tavern, Royal Purple, Emerald Isle) using the `T` key during gameplay.
+- **Customizable Themes:** Switch between twelve 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) using the `T` key during gameplay.
 - **Polished Felt Mat (3.9.4):** The trick mat now has a subtle vignette at its edges, a faint deterministic braille pip-dot texture (fabric-weave feel without intrusive glyphs), and — at standard/spacious terminal sizes — a decorative `╔═══◆═══...═══◆═══╗` outer frame with corner ornaments.
 - **Selection HUD (3.9.4):** Selecting a card in hand now paints a highlighted bar under it AND a centered `► A♠ — Trump ◄` readout below, color-coded by suit / trump / legality.
 - **Hand Sorting:** Strategic "play value" organization (honors grouped together) for better tactical awareness.
@@ -220,7 +221,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 (1003 tests)
+├── tests/             # Comprehensive test suite (1007 tests)
 ├── scripts/           # Performance benchmarks
 ├── pyproject.toml      # Build system and dev dependencies (ruff/mypy)
 ├── LICENSE             # MIT License
@@ -235,14 +236,14 @@ belote/
 PYTHONPATH=src pytest
 ```
 
-Currently **1003 tests** passing with 100% coverage on game-logic modules (4.7.2).
+Currently **1028 tests** passing with 100% coverage on game-logic modules (4.8.0).
 
 ## Technical Integrity
 
 The codebase is strictly validated with the following tools:
 - **mypy**: 0 errors (strict type safety)
 - **ruff**: 0 violations (linting & formatting)
-- **pytest**: 1003/1003 passed
+- **pytest**: 1007/1007 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.7.2 → belote_cli-4.8.0}/pyproject.toml

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

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "4.7.2"
+__version__ = "4.8.0"
 
 __all__ = ["__version__"]

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/ai.py

@@ -290,9 +290,11 @@ class AIPlayer:
         """Decide which card to play."""
         hand = state.hand_of(self.seat)
         legal = legal_cards(state, self.seat)
-        # La Déluge boss promotes 7s/8s of trump above the Jack — every ranking
-        # / point read in this method must respect that flag or the AI will
-        # pick the wrong cards.
+        # La Déluge boss makes 7s and 8s of any suit rank as trump (the two
+        # LOWEST trumps — 7 at rank 8, 8 at rank 9, both scoring 0 points;
+        # see deck.py::trick_rank and ::card_points). Every ranking / point
+        # read in this method must thread `_se` through or the AI under-
+        # values trump cards that should beat them.
         self._se = state.boss_modifiers.seven_eight_trump
 
         # Boss: L'Agent Double (Partner sabotages on 3 random tricks)

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/belatro/core/run_state.py

@@ -104,6 +104,16 @@ class BelAtroRun:
     # future save/load round-trip — gets the same protection automatically.
     _applied_voucher_ids: set[str] = field(default_factory=set)
 
+    # ── Idempotency guard for Joker.on_purchase() ──────────
+    # Corrupted jokers with non-idempotent on_purchase actions (LeDemon's
+    # trust subtraction) record their id here on first apply. Re-application
+    # paths (a future save/load round-trip, replay tooling) consult this set
+    # and short-circuit so a once-paid cost never compounds. Joker on_purchase
+    # actions that are already idempotent (boolean flags like
+    # LeTraitre.partner_throws_trick, LAgentDouble.agent_double_joker) don't
+    # need to consult this set, but adding their id is harmless. 4.7.3.
+    _applied_purchase_ids: set[str] = field(default_factory=set)
+
     # ── Recent-boss tracker (3.9.3 Phase 5) ────────────────
     # Used by the BelAtro main loop to suppress immediate boss repeats in
     # endless mode. The deque holds at most 2 recent boss ids; the selector

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/belatro/core/scoring.py

@@ -407,13 +407,23 @@ class ScoreAccumulator:
                 # of lead (legal_cards forbids trumping while holding lead).
                 # +2 Mult, +$1.
                 if joker_state.get("ghost_lead") and event.trump is not None:
-                    lead_suit = event.cards[0].suit if event.cards else None
+                    lead_card = event.cards[0] if event.cards else None
+                    lead_suit = lead_card.suit if lead_card else None
                     # Under TOUT_ATOUT every card is trump, so no play can be
                     # "void of the led suit" — is_trump_lead resolves to True
                     # and the bonus is correctly gated off.
+                    # Under La Déluge (seven_eight_trump), a 7 or 8 of any
+                    # suit also functions as trump — a 7-led trick is a
+                    # trump-led trick even when lead_suit != event.trump.
+                    se_lead = (
+                        state.boss_modifiers.seven_eight_trump
+                        and lead_card is not None
+                        and lead_card.rank in (Rank.SEVEN, Rank.EIGHT)
+                    )
                     is_trump_lead = (
                         lead_suit == event.trump
                         or event.trump == Suit.TOUT_ATOUT
+                        or se_lead
                     )
                     if lead_suit is not None and not is_trump_lead:
                         seat = event.leader_seat

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/belatro/items/jokers/corrupted.py

@@ -40,7 +40,13 @@ class LeDemon(Joker):
     is_corrupted = True
 
     def on_purchase(self, run: BelAtroRun) -> None:
-        # Degrade trust by 3, making partner play worse
+        # Degrade trust by 3, making partner play worse. 4.7.3: idempotency
+        # guard — without it, a save/load round-trip or replay-resume tool
+        # that re-runs on_purchase on already-owned jokers would compound
+        # the cost. Voucher.apply() solved the same problem in 3.9.3.
+        if self.id in run._applied_purchase_ids:
+            return
+        run._applied_purchase_ids.add(self.id)
         run.partner.trust.value = max(0, run.partner.trust.value - 3)
 
     def on_trick_won(self, event: TrickWonEvent, state: dict[str, Any]) -> JokerResult | None:

{belote_cli-4.7.2 → belote_cli-4.8.0}/src/belote/belatro/main.py

@@ -576,6 +576,11 @@ class BelAtroGame:
         from belote.scoring import score_round
         bd = score_round(final_state)
         trust = self.run.partner.trust
+        # 4.8.0 / B4: snapshot for the trust-bar tick animation. The mutations
+        # in the lock_trust-gated branches below shift this between 0 and 10;
+        # we animate from the pre-block value to the final value after the
+        # block completes so the player sees the change land.
+        pre_trust_value = trust.value
 
         # Phase 2.2: drain pending Tierce charges into the run state.
         pending = final_state._joker_state.get("_pending_tierce_charge", 0)
@@ -668,6 +673,16 @@ class BelAtroGame:
             elif bd.is_capot and bd.taker_team == 0:
                 trust.capot_together()
 
+        # 4.8.0 / B4: animate the trust bar from its pre-round value to its
+        # post-round value. No-op when nothing changed (lock_trust path, or
+        # symmetric mutations that net to zero). Routed through the bar's
+        # tick helper so each intermediate value paints + briefly holds.
+        # `trust_bar` is the local TrustBar instance constructed earlier in
+        # this method (it's also passed into UICallbacks below); `self`
+        # (BelAtroGame) does not have its own trust_bar attribute.
+        if trust.value != pre_trust_value:
+            trust_bar.animate_change(pre_trust_value, self.reader)
+
         # 3.3.0: append a BelAtro-side history entry (the [H] overlay reads
         # `self.run.history` via the override hook installed in `start()`).
         self._record_history_entry(