feat: CricsheetOpponentPolicy — real match data as opponent decisions

Adds a new opponent mode `cricsheet` that samples real Cricsheet ball-by-ball
deliveries as opponent batting/bowling plans. Deliveries are indexed by
(phase, wickets_band, innings_type) for context-aware sampling with progressive
fallback widening (drop innings_type → drop wickets band) when buckets are thin.

- server/opponent_policy.py: CricsheetOpponentPolicy class; runs_batter →
shot_intent mapping; uses format_mapper for bowling line/length; heuristic
fallback for reflect_after_ball; create_opponent_policy accepts cricsheet mode
+ cricsheet_data_path kwarg
- server/cricket_environment.py: pass cricsheet_data_path from options / env var
CRICKET_CRICSHEET_DATA through to create_opponent_policy
- inference.py / train.py: add "cricsheet" to --opponent-mode choices
- illustrations: add 5-over cricsheet baseline run (coherence=0.572, 0% parse errors)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

illustrations/exp_2026-04-25_12-29_inference_5ov_cricsheet_random/README.md

@@ -0,0 +1,24 @@
+## Inference Run: exp_2026-04-25_12-29_inference_5ov_cricsheet_random
+
+**Date**: 2026-04-25 12:29
+
+| Setting | Value |
+|---|---|
+| Model | `random` |
+| API base | `N/A` |
+| Opponent mode | `cricsheet` |
+| Max overs | 5 |
+| Episodes | 3 |
+| Task | `stage2_full` |
+
+### Results
+
+```
+  total_score         : mean=10.667  std=1.528
+  wickets_lost        : mean=1.667  std=0.577
+  total_reward        : mean=-0.789  std=1.041
+  mean_coherence      : mean=0.572  std=0.063
+  parse_error_rate    : mean=0.000  std=0.000
+```
+
+See `run_output.txt` for full verbose episode log.

illustrations/exp_2026-04-25_12-29_inference_5ov_cricsheet_random/run_output.txt

@@ -0,0 +1,181 @@
+# Inference run: exp_2026-04-25_12-29_inference_5ov_cricsheet_random
+timestamp_utc: 2026-04-25T12:29:13.411706
+model: random
+api_base: None
+opponent_mode: cricsheet
+max_overs: 5
+episodes: 3
+task: stage2_full
+eval_pack_id: default
+
+--- Episode 1/3 ---
+  over=0.1 score=0/0 tool=play_delivery r=0.000 | Driven through the covers — dot ball!
+  over=0.2 score=3/0 tool=play_delivery r=0.032 | Played toward midwicket; misfield — three runs.
+  over=0.3 score=3/1 tool=play_delivery r=-0.097 | Lofted toward cover — fielder settles under it. OUT!
+  over=0.3 score=4/1 tool=play_delivery r=0.020 | No-ball called — extra run added and the ball must be replay
+  over=0.4 score=5/1 tool=play_delivery r=0.013 | Driven through the covers — a single!
+  over=0.5 score=5/1 tool=play_delivery r=0.003 | Nudged into the gap — dot ball.
+  over=1.0 score=5/1 tool=play_delivery r=-0.047 | Edge runs toward straight — dot ball.
+  over=1.1 score=6/2 tool=play_delivery r=-0.088 | A thin edge carries behind the wicket — taken cleanly. OUT!
+  over=1.2 score=6/2 tool=play_delivery r=0.003 | Worked off the hips — dot ball.
+  over=1.3 score=7/2 tool=play_delivery r=0.013 | Launched over long-on — a single!
+  over=1.4 score=8/2 tool=play_delivery r=0.013 | Nudged into the gap — a single.
+  over=1.4 score=9/2 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=1.5 score=9/2 tool=play_delivery r=0.003 | Driven through the covers — dot ball!
+  over=2.0 score=9/2 tool=play_delivery r=0.002 | Launched over long-on — dot ball!
+  over=2.0 score=10/2 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=2.1 score=10/2 tool=play_delivery r=0.004 | Worked off the hips — dot ball.
+  over=2.2 score=11/2 tool=play_delivery r=0.013 | Nudged into the gap — a single.
+  over=2.2 score=12/2 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=2.3 score=13/2 tool=play_delivery r=0.013 | Played toward midwicket; gap in midwicket allows a quick sin
+  over=2.4 score=13/2 tool=play_delivery r=0.003 | Defended solidly — dot ball.
+  over=2.5 score=13/3 tool=play_delivery r=-0.097 | A thin edge carries behind the wicket — taken cleanly. OUT!
+  over=3.0 score=13/3 tool=play_delivery r=-0.147 | Left outside off — dot ball.
+  over=3.1 score=19/3 tool=play_delivery r=0.082 | Left outside off — a SIX.
+  over=3.2 score=23/3 tool=play_delivery r=0.063 | Nudged into the gap — a FOUR.
+  over=3.3 score=23/3 tool=play_delivery r=0.002 | Defended solidly — dot ball.
+  over=3.4 score=23/3 tool=play_delivery r=0.003 | Played toward cover; inner fielder at cover saves one — dot 
+  over=3.5 score=25/3 tool=play_delivery r=0.023 | Driven through the covers — two runs!
+  over=4.0 score=26/3 tool=play_delivery r=-0.137 | Defended solidly — a single.
+  over=4.1 score=26/3 tool=play_delivery r=0.003 | Defended solidly — dot ball.
+  over=4.1 score=27/3 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=4.1 score=28/3 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=4.2 score=29/3 tool=play_delivery r=0.013 | Nudged into the gap — a single.
+  over=4.3 score=29/3 tool=play_delivery r=0.003 | Defended solidly — dot ball.
+  over=4.4 score=32/3 tool=play_delivery r=0.033 | Driven through the covers — three runs!
+  over=4.5 score=32/3 tool=play_delivery r=0.003 | Left outside off — dot ball.
+  over=4.5 score=33/3 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=0.0 score=0/0 tool=play_delivery r=-0.060 | Nudged into the gap — dot ball. Innings over. First innings 
+  over=0.1 score=0/0 tool=bowl_delivery r=0.024 | Nudged into the gap — dot ball.
+  over=0.2 score=0/0 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=0.3 score=0/0 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=0.4 score=0/0 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=0.5 score=0/1 tool=bowl_delivery r=0.144 | Pushed into midwicket; sharp fielding creates a run-out. OUT
+  over=1.0 score=1/1 tool=bowl_delivery r=-0.058 | Played toward midwicket; gap in midwicket allows a quick sin
+  over=1.1 score=1/1 tool=bowl_delivery r=0.022 | Defended solidly — dot ball.
+  over=1.2 score=3/1 tool=bowl_delivery r=-0.018 | Worked off the hips — two runs.
+  over=1.3 score=3/1 tool=bowl_delivery r=0.022 | Defended solidly — dot ball.
+  over=1.3 score=4/1 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=1.4 score=4/2 tool=bowl_delivery r=0.143 | Pushed into midwicket; sharp fielding creates a run-out. OUT
+  over=1.5 score=5/2 tool=bowl_delivery r=-0.006 | Driven through the covers — a single!
+  over=2.0 score=5/2 tool=bowl_delivery r=-0.076 | Nudged into the gap — dot ball.
+  over=2.0 score=6/2 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=2.1 score=6/2 tool=bowl_delivery r=0.024 | Worked off the hips — dot ball.
+  over=2.2 score=6/2 tool=bowl_delivery r=0.024 | Driven through the covers — dot ball!
+  over=2.3 score=6/2 tool=bowl_delivery r=0.023 | Worked off the hips — dot ball.
+  over=2.4 score=6/2 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=2.4 score=7/2 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=2.5 score=7/2 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=3.0 score=7/2 tool=bowl_delivery r=-0.126 | Worked off the hips — dot ball.
+  over=3.1 score=7/2 tool=bowl_delivery r=0.024 | Played toward cover; inner fielder at cover saves one — dot 
+  over=3.2 score=7/2 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=3.3 score=7/2 tool=bowl_delivery r=0.024 | Worked off the hips — dot ball.
+  over=3.4 score=8/2 tool=bowl_delivery r=-0.006 | Played toward midwicket; misfield — a single.
+  over=3.5 score=8/2 tool=bowl_delivery r=0.023 | Worked off the hips — dot ball.
+  over=4.0 score=9/2 tool=bowl_delivery r=-0.157 | Launched over long-on — a single!
+  over=4.1 score=9/2 tool=bowl_delivery r=0.023 | Played toward cover; inner fielder at cover saves one — dot 
+  over=4.2 score=9/2 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=4.3 score=9/2 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=4.4 score=10/2 tool=bowl_delivery r=-0.006 | Launched over long-on — a single!
+  over=4.4 score=11/2 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=4.4 score=12/2 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=4.5 score=12/2 tool=bowl_delivery r=0.024 | Driven through the covers — dot ball!
+  over=5.0 score=12/2 tool=bowl_delivery r=1.213 | Driven through the covers — dot ball! Match over. Result: WI
+Episode   1/3 | Score:  12/2 (5 ov) | Reward: -1.748 | Coherence: 0.606 | Adapt: 0.614 | ParseErr: 0.0%
+
+--- Episode 2/3 ---
+  over=0.1 score=1/0 tool=bowl_delivery r=-0.010 | Nudged into the gap — a single.
+  over=0.2 score=1/0 tool=bowl_delivery r=0.023 | Defended solidly — dot ball.
+  over=0.2 score=2/0 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=0.3 score=2/0 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=0.4 score=2/0 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=0.5 score=3/0 tool=bowl_delivery r=-0.007 | Played toward cover; deep fielder at deep_cover cuts off bou
+  over=1.0 score=4/0 tool=bowl_delivery r=-0.056 | Defended solidly — a single.
+  over=1.1 score=6/0 tool=bowl_delivery r=-0.016 | Launched over long-on — two runs!
+  over=1.2 score=7/0 tool=bowl_delivery r=-0.007 | Played toward point; inner fielder at point saves one — a si
+  over=1.3 score=7/0 tool=bowl_delivery r=0.023 | Edge runs toward midwicket — dot ball.
+  over=1.4 score=8/0 tool=bowl_delivery r=-0.007 | Defended solidly — a single.
+  over=1.5 score=8/1 tool=bowl_delivery r=0.144 | Yorker at the stumps beats the swing and crashes into the ba
+  over=2.0 score=8/1 tool=bowl_delivery r=0.024 | Driven through the covers — dot ball!
+  over=2.1 score=8/1 tool=bowl_delivery r=0.024 | Nudged into the gap — dot ball.
+  over=2.2 score=8/1 tool=bowl_delivery r=0.024 | Worked off the hips — dot ball.
+  over=2.3 score=8/1 tool=bowl_delivery r=0.024 | Nudged into the gap — dot ball.
+  over=2.4 score=8/1 tool=bowl_delivery r=0.024 | Driven through the covers — dot ball!
+  over=2.5 score=8/2 tool=bowl_delivery r=0.144 | Yorker at the stumps beats the swing and crashes into the ba
+  over=3.0 score=9/3 tool=bowl_delivery r=-0.037 | Lofted toward long_on — fielder settles under it. OUT!
+  over=3.1 score=9/3 tool=bowl_delivery r=0.023 | Edge runs toward midwicket — dot ball.
+  over=3.2 score=9/3 tool=bowl_delivery r=0.023 | Launched over long-on — dot ball!
+  over=3.3 score=9/3 tool=bowl_delivery r=0.023 | Launched over long-on — dot ball!
+  over=3.4 score=9/3 tool=bowl_delivery r=0.022 | Nudged into the gap — dot ball.
+  over=3.5 score=9/4 tool=bowl_delivery r=0.143 | Lofted toward long_on — fielder settles under it. OUT!
+  over=4.0 score=9/4 tool=bowl_delivery r=-0.127 | Defended solidly — dot ball.
+  over=4.1 score=9/4 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=4.2 score=9/4 tool=bowl_delivery r=0.024 | Launched over long-on — dot ball!
+  over=4.3 score=10/4 tool=bowl_delivery r=-0.008 | Worked off the hips — a single.
+  over=4.4 score=10/4 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=4.5 score=10/4 tool=bowl_delivery r=0.024 | Driven through the covers — dot ball!
+  over=0.0 score=0/0 tool=bowl_delivery r=0.250 | Worked off the hips — dot ball. Innings over. First innings 
+  over=0.1 score=0/0 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=0.2 score=4/0 tool=play_delivery r=0.063 | Launched over long-on — a FOUR!
+  over=0.3 score=4/0 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=0.4 score=4/1 tool=play_delivery r=-0.097 | A thin edge carries behind the wicket — taken cleanly. OUT!
+  over=0.5 score=4/1 tool=play_delivery r=0.003 | Driven through the covers — dot ball!
+  over=0.5 score=5/1 tool=play_delivery r=0.020 | No-ball called — extra run added and the ball must be replay
+  over=1.0 score=9/1 tool=play_delivery r=0.013 | Launched over long-on — a FOUR!
+  over=1.1 score=9/1 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=1.2 score=10/1 tool=play_delivery r=0.013 | Driven through the covers — a single!
+  over=1.3 score=10/1 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=1.4 score=11/2 tool=play_delivery r=1.279 | Turned to leg — sharp catch at short fine leg. OUT! Match ov
+Episode   2/3 | Score:  11/2 (1 ov) | Reward:  0.318 | Coherence: 0.612 | Adapt: 0.617 | ParseErr: 0.0%
+
+--- Episode 3/3 ---
+  over=0.1 score=0/0 tool=play_delivery r=0.000 | Worked off the hips — dot ball.
+  over=0.2 score=0/0 tool=play_delivery r=0.000 | Nudged into the gap — dot ball.
+  over=0.2 score=1/0 tool=play_delivery r=0.020 | Wide delivery — extra run added. Ball to be replayed.
+  over=0.3 score=1/0 tool=play_delivery r=0.000 | Edge runs toward midwicket — dot ball.
+  over=0.4 score=1/0 tool=play_delivery r=0.003 | Driven through the covers — dot ball!
+  over=0.5 score=1/0 tool=play_delivery r=0.002 | Nudged into the gap — dot ball.
+  over=1.0 score=1/1 tool=play_delivery r=-0.147 | Pushed at it — inside edge onto stumps. OUT!
+  over=1.1 score=1/1 tool=play_delivery r=0.001 | Launched over long-on — dot ball!
+  over=1.2 score=1/1 tool=play_delivery r=0.003 | Defended solidly — dot ball.
+  over=1.3 score=2/1 tool=play_delivery r=0.011 | Played toward midwicket; gap in midwicket allows a quick sin
+  over=1.4 score=3/1 tool=play_delivery r=0.013 | Nudged into the gap — a single.
+  over=1.5 score=3/1 tool=play_delivery r=0.003 | Nudged into the gap — dot ball.
+  over=2.0 score=3/1 tool=play_delivery r=0.002 | Driven through the covers — dot ball!
+  over=2.1 score=3/1 tool=play_delivery r=0.002 | Driven through the covers — dot ball!
+  over=2.2 score=3/2 tool=play_delivery r=-0.097 | Turned to leg — sharp catch at short fine leg. OUT!
+  over=2.3 score=3/2 tool=play_delivery r=0.003 | Driven through the covers — dot ball!
+  over=2.4 score=3/2 tool=play_delivery r=0.003 | Driven through the covers — dot ball!
+  over=2.5 score=3/2 tool=play_delivery r=0.003 | Nudged into the gap — dot ball.
+  over=3.0 score=3/2 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=3.1 score=3/2 tool=play_delivery r=0.002 | Left outside off — dot ball.
+  over=3.2 score=7/2 tool=play_delivery r=0.062 | Defended solidly — a FOUR.
+  over=3.3 score=7/2 tool=play_delivery r=0.003 | Nudged into the gap — dot ball.
+  over=3.4 score=7/2 tool=play_delivery r=0.002 | Left outside off — dot ball.
+  over=3.5 score=7/2 tool=play_delivery r=0.002 | Defended solidly — dot ball.
+  over=4.0 score=7/2 tool=play_delivery r=0.003 | Launched over long-on — dot ball!
+  over=4.1 score=7/2 tool=play_delivery r=0.002 | Defended solidly — dot ball.
+  over=4.2 score=8/2 tool=play_delivery r=0.012 | Left outside off — a single.
+  over=4.3 score=8/2 tool=play_delivery r=0.003 | Worked off the hips — dot ball.
+  over=4.4 score=8/2 tool=play_delivery r=0.002 | Left outside off — dot ball.
+  over=4.5 score=8/2 tool=play_delivery r=0.003 | Worked off the hips — dot ball.
+  over=0.0 score=0/0 tool=play_delivery r=-0.217 | Edge runs toward straight — dot ball. Innings over. First in
+  over=0.1 score=2/1 tool=bowl_delivery r=0.104 | Lofted toward point — fielder settles under it. OUT!
+  over=0.2 score=3/1 tool=bowl_delivery r=-0.007 | Played toward point; deep fielder at deep_cover cuts off bou
+  over=0.3 score=3/1 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=0.4 score=3/1 tool=bowl_delivery r=0.023 | Played toward point; inner fielder at point saves one — dot 
+  over=0.4 score=4/1 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=0.4 score=5/1 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=0.5 score=5/1 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=1.0 score=7/1 tool=bowl_delivery r=-0.066 | Driven through the covers — two runs!
+  over=1.1 score=7/1 tool=bowl_delivery r=0.023 | Driven through the covers — dot ball!
+  over=1.1 score=8/1 tool=bowl_delivery r=-0.040 | Wide delivery — extra run added. Ball to be replayed.
+  over=1.2 score=9/1 tool=bowl_delivery r=0.180 | Played toward cover; misfield — a single. Match over. Result
+Episode   3/3 | Score:   9/1 (1 ov) | Reward: -0.937 | Coherence: 0.500 | Adapt: 0.521 | ParseErr: 0.0%
+
+=== Summary ===
+  total_score         : mean=10.667  std=1.528
+  wickets_lost        : mean=1.667  std=0.577
+  total_reward        : mean=-0.789  std=1.041
+  mean_coherence      : mean=0.572  std=0.063
+  parse_error_rate    : mean=0.000  std=0.000

inference.py

@@ -475,7 +475,7 @@ def main():
     parser.add_argument("--env-url", default=os.environ.get("CRICKET_CAPTAIN_ENV_URL", "ws://localhost:8000"))
     parser.add_argument("--eval-pack-id", default=os.environ.get("CRICKET_EVAL_PACK_ID", "default"))
     parser.add_argument("--opponent-mode", default=os.environ.get("CRICKET_OPPONENT_MODE", "llm_live"),
-                        choices=["heuristic", "llm_live", "llm_cached"])
+                        choices=["heuristic", "llm_live", "llm_cached", "cricsheet"])
     parser.add_argument("--api-base", default=None)
     parser.add_argument("--api-key", default=None)
     parser.add_argument("--verbose", action="store_true")

server/cricket_environment.py

@@ -146,6 +146,7 @@ class CricketEnvironment(Environment):
         self._eval_pack_id = eval_pack_id
         self._opponent_mode = options.get("opponent_mode", os.environ.get("CRICKET_OPPONENT_MODE", "llm_live"))
         opponent_cache_path = options.get("opponent_cache_path", os.environ.get("CRICKET_OPPONENT_CACHE"))
+        cricsheet_data_path = options.get("cricsheet_data_path", os.environ.get("CRICKET_CRICSHEET_DATA"))
         
         start_state = options.get("start_state", GameState.TOSS)
         
@@ -199,7 +200,9 @@ class CricketEnvironment(Environment):
         self._current_batter = dict(DEFAULT_BATTERS[0])   # striker
         self._non_striker = dict(DEFAULT_BATTERS[1])      # non-striker
         self._current_bowler = _default_bowler_for_type(self._bowler_type)
-        self._opponent = create_opponent_policy(self._opponent_mode, self._rng, opponent_cache_path)
+        self._opponent = create_opponent_policy(
+            self._opponent_mode, self._rng, opponent_cache_path, cricsheet_data_path
+        )
         # Load roster for the agent's team
         agent_team = options.get("agent_team", os.environ.get("CRICKET_AGENT_TEAM", "india"))
         self._agent_roster = load_team_roster(agent_team)

server/opponent_policy.py

@@ -9,7 +9,9 @@ from __future__ import annotations
 
 import json
 import os
+import pickle
 import random
+from collections import defaultdict
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Protocol
@@ -245,12 +247,132 @@ class LLMOpponentPolicy:
             return None
 
 
-def create_opponent_policy(mode: str, rng: random.Random, cache_path: str | None = None) -> OpponentPolicy:
+_RUNS_TO_INTENT = {0: "defensive", 1: "single", 2: "rotate", 3: "rotate", 4: "boundary", 6: "six"}
+_DEFAULT_OUTCOMES_PATH = os.path.join(
+    os.path.dirname(__file__), "..", "data", "processed", "ball_outcomes_odi_v1.pkl"
+)
+
+
+class CricsheetOpponentPolicy:
+    """Opponent policy driven by real Cricsheet ball-by-ball data.
+
+    Deliveries are indexed by (phase, wickets_band, innings_type) — loose enough
+    to always find matches, specific enough to respect match context.  A random
+    sample from the matching bucket drives the batting/bowling plan; the heuristic
+    fallback covers gaps.
+    """
+
+    mode = "cricsheet"
+
+    def __init__(
+        self,
+        fallback: OpponentPolicy,
+        rng: random.Random,
+        data_path: str | os.PathLike[str] | None = None,
+    ):
+        self._fallback = fallback
+        self._rng = rng
+        self._index: dict[tuple, list[dict]] = defaultdict(list)
+        path = Path(data_path or _DEFAULT_OUTCOMES_PATH)
+        if path.exists():
+            with path.open("rb") as f:
+                records: list[dict] = pickle.load(f)
+            for rec in records:
+                key = (
+                    rec.get("phase", "middle"),
+                    _wickets_band(rec.get("wickets_before", 0)),
+                    rec.get("innings_type", "first"),
+                )
+                self._index[key].append(rec)
+
+    def _sample(self, context: dict[str, Any]) -> dict[str, Any] | None:
+        phase = context.get("phase", "middle").lower()
+        wickets = int(context.get("wickets", 0))
+        innings_type = context.get("innings_type", "first")
+        key = (phase, _wickets_band(wickets), innings_type)
+        bucket = self._index.get(key)
+        if not bucket:
+            # Widen: drop innings_type
+            bucket = self._index.get((phase, _wickets_band(wickets), "first"))
+        if not bucket:
+            # Widen further: drop wickets band
+            all_phase = [r for k, v in self._index.items() if k[0] == phase for r in v]
+            bucket = all_phase or None
+        return self._rng.choice(bucket) if bucket else None
+
+    def batting_plan(self, context: dict[str, Any]) -> dict[str, Any]:
+        rec = self._sample(context)
+        if rec is None:
+            return self._fallback.batting_plan(context)
+        runs = rec.get("runs_batter", 0)
+        wicket = rec.get("wicket", False)
+        if wicket:
+            intent = self._rng.choice(["boundary", "six"])  # risky shot that got out
+        else:
+            intent = _RUNS_TO_INTENT.get(runs, "single" if runs > 0 else "defensive")
+        aggression = _intent_aggression(intent)
+        return {
+            "shot_intent": intent,
+            "target_area": self._rng.choice(_zones_for_intent(intent)),
+            "risk": "high" if intent in {"boundary", "six"} else "balanced",
+            "aggression": aggression,
+            "batter_role": f"cricsheet_{rec.get('phase','mid')}",
+            "rationale": (
+                f"Cricsheet sample: {runs}r wicket={wicket} "
+                f"phase={rec.get('phase')} wkts={rec.get('wickets_before')}."
+            ),
+        }
+
+    def bowling_plan(self, context: dict[str, Any]) -> dict[str, Any]:
+        rec = self._sample(context)
+        if rec is None:
+            return self._fallback.bowling_plan(context)
+        over = int(context.get("over", 0))
+        max_overs = context.get("max_overs")
+        bowler_type = rec.get("bowler_type") or "pace"
+        strategy = get_bowling_strategy(over, max_overs)
+        return {
+            "bowler_type": bowler_type,
+            "line": strategy.get("line", "outside off"),
+            "length": strategy.get("length", "good length"),
+            "delivery_type": strategy.get("delivery_type", "stock"),
+            "field_setting": strategy.get("field_setting", "Balanced"),
+            "bowler_role": f"cricsheet_{bowler_type}",
+            "rationale": (
+                f"Cricsheet sample: {bowler_type} bowler "
+                f"phase={rec.get('phase')} wkts={rec.get('wickets_before')}."
+            ),
+        }
+
+    def reflect_after_ball(self, context: dict[str, Any], outcome: dict[str, Any]) -> dict[str, Any]:
+        return self._fallback.reflect_after_ball(context, outcome)
+
+
+def _wickets_band(wickets: int) -> str:
+    if wickets <= 2:
+        return "0-2"
+    if wickets <= 5:
+        return "3-5"
+    return "6-9"
+
+
+def _intent_aggression(intent: str) -> float:
+    return {"leave": 0.05, "defensive": 0.15, "single": 0.35, "rotate": 0.45, "boundary": 0.75, "six": 0.90}.get(intent, 0.40)
+
+
+def create_opponent_policy(
+    mode: str,
+    rng: random.Random,
+    cache_path: str | None = None,
+    cricsheet_data_path: str | None = None,
+) -> OpponentPolicy:
     fallback = HeuristicOpponentPolicy(rng=rng)
     if mode == "llm_live":
         return LLMOpponentPolicy(fallback=fallback)
     if mode == "llm_cached" and cache_path:
         return CachedOpponentPolicy(cache_path=cache_path, fallback=fallback)
+    if mode == "cricsheet":
+        return CricsheetOpponentPolicy(fallback=fallback, rng=rng, data_path=cricsheet_data_path)
     return fallback
 
 

train.py

@@ -909,7 +909,7 @@ def main():
     smoke.add_argument("--max-steps", type=int, default=240, dest="max_steps")
     smoke.add_argument("--log-steps", type=int, default=30, dest="log_steps")
     smoke.add_argument("--eval-pack-id", default=None, dest="eval_pack_id")
-    smoke.add_argument("--opponent-mode", default=None, choices=["heuristic", "llm_live", "llm_cached"], dest="opponent_mode")
+    smoke.add_argument("--opponent-mode", default=None, choices=["heuristic", "llm_live", "llm_cached", "cricsheet"], dest="opponent_mode")
     smoke.add_argument("--opponent-cache-path", default=None, dest="opponent_cache_path")
     smoke.add_argument("--output", default=None)
     smoke.add_argument("--seed", type=int, default=42)