DETERMINISTIC BLACKJACK LIVEPLAY ENVIRONMENT FOLDER STRUCTURE AND APPLICATION GUIDE Current aligned builds: CLI V9.2.15-UAT / GUI v15.10.39 Date: 09 September 2026 PURPOSE ------- This README describes the liveplay folder layout, the role of the CLI and GUI applications, and the evidence locations that must remain stable. It is intentionally an organisation/application guide rather than a detailed blackjack or research-method specification. Scientific interpretation remains governed by the retained session evidence and current frozen programme rules. RECOMMENDED FOLDER STRUCTURE ---------------------------- liveplay\ ├── CLI\ │ ├── output.txt │ ├── LiveBlackjackCompanion_PersonalOrFrozen_OptionalHistory_Ledger.java │ ├── matching LiveBlackjackCompanion...class files │ ├── RUN_CLI.bat │ ├── README_LIVEPLAY_FOLDER_STRUCTURE.txt │ ├── CLI_CONSOLIDATED_UAT_AND_RELEASE_HISTORY_v9_2_15.txt │ ├── CLI_V9_2_15_PERSONAL_STAT_WATCHING_REVEAL_AUDIT.txt │ ├── session_evidence\ │ ├── backups\ │ ├── docs_audit\ │ └── tools\ │ └── GUI\ ├── BlackjackSessionReplay.java ├── BlackjackSessionReplay.jar ├── RUN_LIVE_GUI_UAT.bat ├── RUN_REPLAY.bat ├── GUI_CONSOLIDATED_UAT_AND_RELEASE_HISTORY_v15_10_39.txt └── REPLAY_V15_10_39_PERSONAL_STAT_WATCHING_REVEAL_AUDIT.txt CLI FOLDER ---------- The CLI folder is the authoritative runtime/data location. output.txt The cumulative project/session record. It remains directly in CLI\. session_evidence\ Dedicated formal evidence generated or retained for individual sessions and publication/replay validation. This can include: - blackjack_live_session_.txt - blackjack_shuffle_analysis_.txt - blackjack_preamble_.txt - blackjack_observed_reconstruction_correction_.txt - other explicitly retained session-specific correction/addendum evidence - Sessionplate_structure.zip Sessionplate_structure.zip is NOT an old delivery ZIP. It is the permanent structural reference pack used by the publication workflow and must remain in session_evidence\. Preamble evidence is also authoritative observed-session evidence. A genuine linked preamble is kept separate from the formal Hand 1 sequence and may provide PREAMBLE_START replay context. It must never be appended after an exhausted formal-start card stream merely to extend that replay. backups\ Automatic/manual safety copies of output.txt, including pre-shuffle-analysis outputbackup_SESSION*.txt files. docs_audit\ Historical readme, provenance, lineage, hash, audit and workflow documents. These are organisational/provenance records rather than active runtime state. Preserve this folder; it is not ordinary release clutter. tools\ Separate utilities such as plate/audit workflow tools. THE CLI APPLICATION ------------------- LiveBlackjackCompanion_PersonalOrFrozen_OptionalHistory_Ledger is the authoritative live-session companion/backend. It handles the text/keyboard research workflow, records the session, performs validation, writes formal evidence, and supports Personal and Frozen operation. Current V9.2.15-UAT also contains the Stat-Watching Casual observational policy used by the post-session S analysis and, in Personal mode, the optional post-commit comparison. Important Personal-mode safeguard: - the human commits the wager/action first; - only after an override of Frozen may the program offer the optional Stat-Watching Casual wager/action and mindset; - Stat-Watching uses only information legitimately visible at that decision point; - the reveal cannot retroactively influence the already-committed human choice. When run directly from CLI\ it uses: CLI\output.txt CLI\session_evidence\... CLI\backups\... THE GUI APPLICATION ------------------- The current GUI distribution is intentionally compact. BlackjackSessionReplay.jar contains both the historical replay application and the embedded live graphical companion/backend classes required by RUN_LIVE_GUI_UAT.bat. The GUI folder therefore does NOT require separate copies of: BlackjackLiveGuiUAT.java LiveBlackjackCompanion_PersonalOrFrozen_OptionalHistory_Ledger.java The graphical live companion provides the visual live-play interface: graphical cards, keyboard-first input, bankroll/wager displays, split/double presentation, recent-hand visual memory, Personal-mode interaction, and the accepted live visualisation features. When the live GUI is launched from GUI\, the backend uses ..\CLI\ as its working directory. Therefore direct CLI play and GUI live play share the same authoritative data repository. From GUI\ the important relative location is: ..\CLI\ This means the GUI/backend uses: ..\CLI\output.txt ..\CLI\session_evidence\... ..\CLI\backups\... THE HISTORICAL REPLAY / STATS APPLICATION ----------------------------------------- BlackjackSessionReplay provides graphical historical playback and the retained Memory Lane/statistics views. It reads historical evidence from the authoritative CLI\output.txt and associated retained evidence. It does not create a second GUI-local output.txt. The Stat-Watching Stats Corner is presentation of evidence produced by the authoritative engine. It can show chosen-vs-stay results and cumulative basis-matched comparisons. To preserve readability, Stat-Watching charts are limited to five eligible sessions per graph; additional groups are placed below in the scrollable view rather than compressing the existing graph. RUN BATCH FILES --------------- CLI\RUN_CLI.bat Starts the authoritative text/keyboard CLI companion. GUI\RUN_LIVE_GUI_UAT.bat Starts the graphical live companion directly from the GUI package. GUI\RUN_REPLAY.bat Starts the historical graphical replay/statistics application. PLATE PUBLICATION / PREFLIGHT EVIDENCE -------------------------------------- Before a new session plate is created, the publication request requires the current evidence set to be present and readable. Required for every applicable session: - output.txt - session_evidence\blackjack_live_session_.txt - session_evidence\blackjack_shuffle_analysis_.txt - session_evidence\Sessionplate_structure.zip - the immediately previous accepted Session plate, except for Session 1 Required when applicable: - linked blackjack_preamble_.txt - dedicated observed-reconstruction correction/addendum evidence Session 1 exception: Session 1 has no immediately previous Session plate. Its absence must not stop publication preflight, and no Session 0 plate is to be requested, invented, inferred or substituted. Sessionplate_structure.zip supplies the canonical structural/presentation precedent. Structural references never replace current-session evidence. The current session's retained evidence remains the scientific authority. IMPORTANT ORGANISATIONAL RULES ------------------------------ 1. Keep one authoritative output.txt only: CLI\output.txt. 2. Do not place another output.txt in GUI\. 3. Keep formal per-session evidence in CLI\session_evidence\. 4. Keep Sessionplate_structure.zip in CLI\session_evidence\. 5. Keep genuine preamble evidence in CLI\session_evidence\ and preserve its separate PREAMBLE_START meaning. 6. Keep output backups in CLI\backups\. 7. Keep the active CLI source/classes at the CLI root because both direct CLI use and GUI live play rely on that authoritative backend/data location. 8. Preserve CLI\docs_audit\ as historical provenance/workflow material. 9. GUI\ should normally contain only the files supplied by the current accepted GUI package. Old GUI delivery ZIPs should be archived elsewhere. 10. CLI\ should contain the current CLI package files plus its cumulative output/evidence/organisational folders. Old CLI delivery ZIPs should be archived elsewhere. 11. The consolidated CLI and GUI UAT/release-history TXT files are the running release histories and should be carried forward in future packages. 12. A delivery ZIP may be removed from the live working folder after successful extraction, provided an archive/rollback copy is retained elsewhere if desired. CURRENT PATH ALIGNMENT ---------------------- GUI live backend working directory : ..\CLI\ GUI historical replay data : ..\CLI\output.txt CLI cumulative output : output.txt CLI dedicated session evidence : session_evidence\ CLI permanent plate structure pack : session_evidence\Sessionplate_structure.zip CLI output safety backups : backups\ END OF README