rusty_marvin/docs/ROADMAP.md
Jan-Peter v. Hunnius 09a0777f96 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)
2026-05-25 11:10:52 +02:00

2 KiB
Raw Blame History

Poker AI Testbed & Live Server Roadmap

Phase 2: Simulation Testbed ✅

Remaining for mass simulation

  • Parallel simulation engine (multi-threading)
  • Result visualization (charts/graphs)
  • GUI for configuration of simulations and bots

Phase 4: Bot Framework

Goal: All bot types with playability enhancement

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
  • Genetic algorithm for bot evolution (via configuration files)

Phase 5: "Unit Test" Framework

Goal: Bot behavior can be tested against predefined hands

Hand Replayer

  • Poker Tracker style hands
  • Action comparison to expected outcome
  • Selection of hands from different sources (books)
  • Action likelihoods (multiple replays)

Phase 6: Live Server Infrastructure

Goal: Real-time bot deployment

Server core

  • Network protocol design (TBD: WebSocket, JSON, MQ, etc.)
  • Actions (incl. early fold and table selection), events (incl. table switches and available tables)
  • Client registration and management
  • Game state synchronization
  • Action dispatch system
  • Event logging for analysis of problems

Client adapter system

  • Client factory for different poker environments
  • Screen / protocol scraping adapters
  • Table selection logic
  • Configuration-driven game selection

Phase 7: Integration & Polish

Goal: Production-ready system

Advanced features

  • Real-time strategy adaptation
  • Multi-table coordination
  • Bankroll management
  • Risk adjustment based on results

Optimization and deployment

  • Performance profiling and optimization
  • Error handling and recovery
  • Documentation and examples
  • Deployment scripts and configuration