DETERMINISTIC BLACKJACK — MAXIMUM AGGRESSION POLICY OPTIMISATION
RUNNING RESEARCH GUIDE

Programme start: Phase 3.01
Current documented phase: Phase 3.02

======================================================================
1. WHY THIS NEW PROGRAMME EXISTS
======================================================================
The completed blackjack research established a broad evidence base comparing textbook and non-textbook behaviour, including a deterministic finite six-deck shoe and an intentionally extreme Maximum Aggression player.

The Phase 3.xx programme asks a narrower new question:

Can Maximum Aggression be stabilised into a selective, evidence-driven policy that improves its probability of finishing a fixed 30-hand session with a higher bankroll, without using card counting, hidden information or future-card knowledge?

The immediate target is not to maximise a 2x, 3x or 5x bankroll. First, the programme must determine whether indiscriminate aggression can be made materially more stable. Larger bankroll targets belong to later work only after the policy mechanism is understood and replicated.

======================================================================
2. EVIDENCE BASIS AND HISTORICAL BOUNDARY
======================================================================
PRIMARY DESIGN AUTHORITY
The optimisation programme is driven primarily by the deterministic finite six-deck evidence from Phase 2.xx and by new Phase 3.xx primary/holdout datasets.

SECONDARY HISTORICAL EVIDENCE
Earlier non-depleting/infinite-generator behaviour-profile experiments remain useful for historical comparison, hypothesis generation and corroboration. They do not directly define a new optimisation rule unless the finite-shoe evidence independently supports the same conclusion.

PROGRESSIVE EVIDENCE RULE
As Phase 3.xx develops, newly generated controlled optimisation datasets become the strongest evidence for subsequent policy changes.

======================================================================
3. FROZEN STARTING ARCHITECTURE
======================================================================
The programme initially preserves the established finite-shoe architecture so that old and new evidence remain comparable:

- Six decks / 312-card shoe.
- One deterministic shuffle at the start of each session.
- 30 hands per session.
- 100-unit starting bankroll.
- 1-unit base wager.
- Dealer stands on every 17, including soft 17.
- Natural blackjack pays 3:2.
- One split only; recursive re-splitting is not modelled.
- Doubling after a split is permitted.
- No surrender action exists in the historical engine.
- No in-session reshuffle occurs during the 30-hand session.
- Textbook strategy remains the control/reference.
- Frozen Maximum Aggression remains the extreme baseline.
- Primary cohort: 5,000 paired sessions.
- Independent holdout cohort: 5,000 paired sessions.

HISTORICAL RULE ALIGNMENT AUDIT
A fresh code audit of the preserved Phase 1.29, Phase 2.01 and Phase 2.02 implementations confirms that the optimisation-entry rules above match the actual historical engine. In particular, no blackjack SURRENDER action was implemented; recursive re-splitting was not modelled; doubling after a split was permitted; the dealer stood on all 17 including soft 17; natural blackjack paid 3:2; and Phase 2.02 used one deterministic six-deck shuffle at session start with no in-session reshuffle.

Thirty hands is retained initially as the established experimental horizon. Alternative session lengths may later be examined as a separate sensitivity study; they should not be changed at the same time as the first policy rules.

A realistic interval/penetration reshuffle is also reserved for a later robustness stage. It should not be introduced simultaneously with initial policy optimisation because doing so would make attribution harder.

======================================================================
4. INFORMATION BOUNDARY FOR THE NEW POLICY
======================================================================
The optimiser may eventually use information legitimately visible at the current decision point, including:

- player total and hand composition;
- hard/soft status;
- pair status;
- dealer upcard;
- legal actions;
- previously validated experimental risk/outcome trends associated with those visible states.

The initial programme does NOT give the policy a running count, previous-card-history feature, remaining-rank inventory, hidden-card information or knowledge of future cards.

Historical experimental trends may inform a rule before a new run begins. That is different from adapting a decision during the run because particular ranks have already left the current shoe.

======================================================================
5. REFERENCE POLICIES
======================================================================
TEXTBOOK
The established basic-strategy implementation remains the control/reference policy.

MAXIMUM AGGRESSION
Maximum Aggression is retained as the deliberately extreme boundary condition. Its action precedence is important:

1. If the initial two-card state is split-eligible, SPLIT first.
2. Otherwise, DOUBLE on the first legal decision under the frozen aggressive rule.
3. Continue according to the established Maximum Aggression implementation.

Because the simulator stores 10, J, Q and K as numerical value 10, all initial two-card combinations of these ten-valued ranks are treated as 10+10 for split eligibility. Thus K+J, K+Q, J+Q, 10+K and equivalent combinations are routed to SPLIT before DOUBLE.

======================================================================
6. PHASE 3.01 — FROZEN BASELINE AND OPTIMISATION ENTRY POINT
======================================================================
PURPOSE
Phase 3.01 entered the optimisation programme without changing Maximum Aggression. Its job was to preserve the finite six-deck baseline while adding state-level instrumentation capable of identifying where aggressive decisions cause repeated bankroll damage.

WHAT WAS ADDED
The evidence record was expanded to include visible starting state, hard/soft status, dealer upcard, split-child status, textbook first action for the same visible state, aggressive action, stake, cards consumed, third-card behaviour, hand outcome and bankroll contribution.

WHAT WAS NOT CHANGED
The Maximum Aggression policy itself was not optimised. The six-deck architecture, 30-hand horizon, bankroll start and textbook control remained frozen.

WHY IT MATTERED
The instrumentation made it possible to move away from vague labels such as 'more aggressive' and instead identify adequately sampled visible-state families whose losses replicate in both primary and holdout evidence.

IMPORTANT FOLLOW-UP
Review of the initial state labels raised a question about hard-20 doubles and whether ten-valued combinations such as K+J were being split first. This required an explicit historical/code audit before optimisation could safely begin.

======================================================================
7. PHASE 3.02 — TEN-VALUE SPLIT PRECEDENCE AUDIT
======================================================================
PURPOSE
Phase 3.02 resolved the ten-value split question before making any policy change.

AUDIT RESULT
PASS. The simulator represents 10, J, Q and K as integer value 10. Maximum Aggression evaluates split eligibility before the aggressive double rule. Therefore all initial two-card ten-value combinations are split-eligible and are routed to SPLIT first.

Examples:
10+J -> stored 10+10 -> SPLIT
K+Q  -> stored 10+10 -> SPLIT
J+K  -> stored 10+10 -> SPLIT
Q+Q  -> stored 10+10 -> SPLIT

This behaviour is consistent with the historical baseline. Phase 3.02 clarifies the interpretation rather than changing previous evidence.

BASELINE REPLICATION
PRIMARY
Average ending bankroll — Textbook: 99.956; Maximum Aggression: 78.978.
Positive sessions — Textbook: 48.14%; Maximum Aggression: 2.48%.
Paired winner — Textbook: 95.72%; Maximum Aggression: 3.88%; tie: 0.40%.
Mean cards consumed — Textbook: 165.674; Maximum Aggression: 177.840.

HOLDOUT
Average ending bankroll — Textbook: 99.972; Maximum Aggression: 78.895.
Positive sessions — Textbook: 47.42%; Maximum Aggression: 2.42%.
Paired winner — Textbook: 95.86%; Maximum Aggression: 3.86%; tie: 0.28%.
Mean cards consumed — Textbook: 165.647; Maximum Aggression: 177.749.

STATE-LEVEL CONTEXT
Primary resolved aggressive hands: 171,838; mean net per resolved hand -0.6117; bust rate 35.76%.
Holdout resolved aggressive hands: 171,789; mean net per resolved hand -0.6143; bust rate 35.72%.

The state ranking contains HARD 20 DOUBLE states marked [split-child]. These are not unsplit initial K+J-type hands. Under the one-split limit, a child created by a split may receive another ten-valued card and subsequently reach the aggressive DOUBLE rule.

LAYMAN INTERPRETATION
Phase 3.02 is a quality-control experiment. Before trying to make Maximum Aggression better, it confirms exactly what the aggressive player is already doing. The very poor bankroll result remains replicated in independent primary and holdout cohorts, while the split-precedence ambiguity is removed.

WHAT PHASE 3.02 DOES NOT CLAIM
It does not identify a proven improved policy. It does not use card counting or live shoe-composition information. It does not change the historical Maximum Aggression definition.

NEXT DESIGN — PHASE 3.03
Phase 3.03 should make the first genuine stabilisation change. Only ONE replicated visible-state policy family should be altered, chosen from adequately sampled finite-shoe evidence that shows the same damaging direction in both primary and holdout cohorts.

The purpose is attribution: if bankroll behaviour changes, we should be able to say which policy intervention caused it.

======================================================================
8. DOCUMENTATION AND PUBLICATION WORKFLOW
======================================================================
Each Phase 3.xx experiment should preserve four levels of evidence:

1. Java code — exact implementation.
2. Raw/detailed results and CSV evidence — audit trail.
3. Individual experiment results TXT — concise numerical results plus plain-English explanation.
4. This cumulative Research Guide — the connected scientific narrative across all experiments.

Publication plates are selective. A plate should be created when an experiment establishes an important baseline, milestone, conceptual transition or finding that benefits from visual explanation. Plates should explain why the programme has reached that point, which evidence is being used, what remains frozen, what is being tested and what the evidence means.

======================================================================
END OF GUIDE — CURRENT THROUGH PHASE 3.02
======================================================================
