feat: Supersonic evaluator, Cactus Kev hash, repo split cleanup

Evaluator overhaul:
- Add Supersonic LUT trie evaluator (32M-entry, O(n) hand evaluation)
- Add Cactus Kev perfect-hash 5-card evaluator (prime-product hashing)
- 3-tier evaluation priority: Supersonic → Cactus Kev → Algorithmic
- DashMap-cached 7-card evaluation for lock-free concurrent access
- Rewrite JumpTable around CactusKevEvaluator + DashMap cache

Bot framework:
- Add StrategyBot adapter (Strategy trait → HoldemPlayer)
- Add register_bot_type() for plugin-style bot registration
- Add strategy module with modular composable strategies

Repository split:
- Remove holdem_bots from workspace (moved to private super_marvin repo)
- Remove holdem_bots dependency from holdem_sim
- Update cash_game.toml to use built-in bots only
- Clean up .gitignore (remove stale holdem_bots exclusion)
- Delete plans/ directory (internal planning artifacts)

Documentation:
- Add ARCHITECTURE_SUPERSONIC_EVALUATOR.md
- Add REFERENCES.md
- Update ROADMAP.md and VISION.md
- Remove outdated docs (ACHIEVEMENTS, RAKE, TOURNAMENT_RAKE, meerkat-alignment)
This commit is contained in:
Jan-Peter von Hunnius 2026-05-25 11:10:52 +02:00
parent f81f0579d1
commit 09a0777f96
36 changed files with 6565 additions and 4934 deletions

View file

@ -1,63 +1,33 @@
# Poker AI Testbed & Live Server Roadmap
## Step-by-Step Implementation Plan
### Phase 1: Foundation
**Basic poker engine**
- Game state management
- Game Info and Player Info traits
- Event reporting and action scheme
- Basic game rules (NL/FL/PL)
**Configuration system**
- TOML configuration structures
- Bot parameter configuration
- Game type configurations (Cash/SNG/MTT, buyins, blinds, hands per level, etc.)
- Simulation parameters (hands/tournaments count, buyin thresholds for bots, etc.)
### Phase 2: Simulation Testbed ✅
**Goal:** Mass simulation capability
**Testbed core** ✅
- Tournament/cash game runners ✅
- Result collection and analysis ✅
- Bot interface with early folding capability ✅
- Bot performance metrics & summary ✅
- Simulation and game factories ✅
- Configuration-driven experiment runner ✅
- Seed control for reproducibility ✅
## Phase 2: Simulation Testbed ✅
**Remaining for mass simulation**
- Parallel simulation engine (multi-threading)
- Result visualization (charts/graphs)
- Rebuy/addon support for tournaments
- GUI for configuration of simulations and bots
---
### Phase 3: Bot Framework
## Phase 4: Bot Framework
**Goal:** All bot types with playability enhancement
**Bot core implementations** (partially complete — basic bots exist)
- ~~Generic helper functions for strategies~~ (basic bots done: CallBot, FoldBot, RaiseBot, RandomBot)
- Modular Strategy per stage and game situation
- Rule-based bot with configurable thresholds – port from Java
- Nash equilibrium calculator for SNG endgame – port from Java
- Statistical tracking bot – port from Java
**Bot core implementations** (partially complete)
- Logging of decision-making process
**Advanced bots**
- Nash equilibrium calculator for SNG endgame – port from Java
- Statistical tracking bot – port from Java
- GPU acceleration for mass rollouts
- Hand-reading opponent modeling (possibly with GPU integration)
- Flop playability precomputation & score integration
- Basic reinforcement learning skeleton
- Hybrid bot combining multiple approaches
- Factory for bot and sub-strategy composition
- Genetic algorithm for bot evolution (via configuration files)
---
### Phase 4: "Unit Test" Framework
### Phase 5: "Unit Test" Framework
**Goal:** Bot behavior can be tested against predefined hands
**Hand Replayer**
@ -68,7 +38,7 @@
---
### Phase 5: Live Server Infrastructure
### Phase 6: Live Server Infrastructure
**Goal:** Real-time bot deployment
**Server core**
@ -87,7 +57,7 @@
---
### Phase 6: Integration & Polish
### Phase 7: Integration & Polish
**Goal:** Production-ready system
**Advanced features**