DETERMINISTIC BLACKJACK — GUI APPLICATION README
Historical Session Replay v15.10.209
Live Graphical Companion v15.10.140
Updated: 17 September 2026

ACTIVE VERSION BOUNDARY
-----------------------
Historical Replay / Stats: v15.10.209
Live Graphical Companion: v15.10.140
Authoritative CLI backend source: V9.2.52

FINAL REPLAY CHANGE — v15.10.209
--------------------------------
Standalone Historical Replay split settlement presentation now places the overall
hand verdict and the independent DISPLAY SETTLEMENT verdict on two centred lines.
This prevents the integrity verdict being ellipsized when the right-side analysis
panel is visible. No evidence, cards, totals, bankroll, settlement, controller,
reconstruction, pointer, shuffle, or Live Play capture logic changed.

RETAINED v15.10.205 REPAIRS
---------------------------
- Session 12 Hand 2 observed Hybrid Split B reconstructs the authoritative captured
  3S,10H,JD = 23 BUST / LOSS.
- Recovered ASCII-suit card tokens render through the established card parser, so JD
  displays as J♦.
- Historical Replay independently checks whether rendered settlement agrees with the
  retained bankroll movement. Contradictions are flagged; evidence is never changed.
- Frozen-vs-Hybrid split comparison displays the settlement verdict on its own fitted line.

LIVE PLAY BOUNDARY
------------------
Live Graphical Companion remains v15.10.140. The Replay LIVE PLAY button uses
GUI\RUN_LIVE_GUI.bat, the same route as direct Live GUI launch. Live split-hand
capture and settlement processing are unchanged by v15.10.203–v15.10.209.

LAUNCHERS
---------
RUN_REPLAY.bat     — Historical Replay / Stats
RUN_LIVE_GUI.bat   — Live Graphical Companion using sibling CLI backend
Replay LIVE PLAY   — invokes RUN_LIVE_GUI.bat

PACKAGE DISCIPLINE
------------------
CLI/session_evidence remains authoritative and separate.
GUI contains no second output.txt.
No loose .class files are shipped.
Superseded GUI README/UAT/SHA files have been removed from this final package; the
current README, final UAT and current SHA manifest are the operational documents.

FINAL PRESENTATION TIDY — v15.10.209
- Standalone intermediate split-animation explanatory text is wrapped onto two centred lines so the full SPLIT A / SPLIT B message remains visible.
- No evidence, card reconstruction, settlement, bankroll, comparison, or Live Play processing changed.


v15.10.209: Comparison split-result parity only. Frozen reconstructed split sides now expose Split A/B WIN/LOSS/PUSH derived from the already-rendered branch/dealer totals, matching the observed-Hybrid evidence presentation. No settlement or Live Play behaviour changed.


v15.10.209 FINAL UNKNOWN-CARD PROVENANCE GATE
- Completed Replay/comparison hands cannot receive a green DISPLAY SETTLEMENT CONSISTENT status if any displayed card has an unresolved rank.
- Known-rank/unknown-suit evidence (for example 4U or 6?) remains legitimate because suit does not affect blackjack settlement; it is rendered as known rank + unknown suit rather than a wholly unknown card.
- Explicit retained CARD CORRECTION addenda are applied to graphical reconstruction only when session, hand and raw token match. No card is inferred.
- Session 10 Hand 22 #131 therefore uses its retained correction 6?/6U -> 6C.
- Live Play remains v15.10.140 and CLI remains V9.2.50.
