Skip to content

CLAUDE.md

Latest commit

 

History

History
67 lines (52 loc) · 2.65 KB

CLAUDE.md

File metadata and controls

67 lines (52 loc) · 2.65 KB

CLAUDE.md

Commands

All commands via mise:

mise check               # Run all checks (format, clippy, tests, TOML lint)
mise check:test:nextest  # Run tests only
mise check:test:nextest test_name  # Run single test by name
mise check:test:docs     # Run doc tests
mise check:clippy        # Lint only
mise check:fmt           # Format check only

mise fix                 # Fix all formatting and lint issues

mise bench <target>      # Run benchmark (arena, rank, iter, parse, etc.)
mise fuzz <target>       # Run fuzz target for 60s (add --timeout 0 for infinite)
mise mutants             # Find missing test coverage

Fuzz Targets as Secondary Checks

After mise check passes, fuzz targets provide good secondary validation:

  • cfr_mixed_agents - tests CFRAgent and historian
  • replay_agent / multi_replay_agent - tests game replay
  • config_agent - tests config-driven agents
  • rank_seven - tests hand ranking
  • rank_omaha - tests Omaha hand ranking

Architecture

rs-poker is a Rust poker library

Modules

  • core/: Card, Suit, Value, Hand, Rank, Deck. Bitset representations (CardBitSet/u64, PlayerBitSet/u16) for O(1) ops.
  • holdem/: StartingHand, range parsing ("KQo+", "99+"), Monte Carlo helpers, outs.
  • arena/: Multi-agent simulation (feature-gated):
    • GameState: Round state machine (preflop → flop → turn → river → showdown)
    • HoldemSimulationBuilder: Builder pattern for constructing simulations
    • Agent trait: Implement act(&self, &GameState) -> AgentAction; must be Clone
    • Historian trait: Event recording (VecHistorian, DirectoryHistorian, StatsTrackingHistorian)
    • AgentGenerator/HistorianGenerator: Factory traits for multi-simulation use
    • cfr/: Counterfactual Regret Minimization solver (arena allocation, nodes in Vec by index)
  • open_hand_history/: OHH format import/export
  • simulated_icm/: Tournament ICM calculations

Feature Flags

default = ["arena", "serde", "omaha", "open-hand-history"]
arena                      # Multi-agent simulation
serde                      # JSON serialization
omaha                      # Omaha (PLO4/PLO5/PLO6/PLO7) hand evaluation
open-hand-history          # OHH format support
arena-test-util            # Testing helpers with approx comparisons
open-hand-history-test-util  # OHH testing helpers

Conventions

  • All clippy warnings denied: #![deny(clippy::all)]
  • Error handling via thiserror with domain-specific enums (never use bare String for errors, even across thread boundaries)
  • Test utilities in test_util modules
  • Benchmarks in benches/, fuzzing in fuzz/
  • Bitset representations critical for performance