Initial commit: Hold'em engine, bots, and simulation harness

Kotlin Multiplatform engine (JVM target only for now; androidTarget and iosArm64 slot in without touching commonMain). Core: - HandEvaluator: single-pass 5-7 card evaluation, ~24M evals/sec. Verified exhaustively against published frequencies for all 2,598,960 five-card hands. - Equity: Monte Carlo with ties split. PreflopChart ranks the 169 starting hands using all-in equity plus an explicit playability adjustment, so looseness means "plays the top N%". - Table: no-limit betting rounds, side pots, odd-chip splits, uncalled-bet refunds, and incomplete (short all-in) raises that correctly do not reopen betting. Bots: - SkillLevel and PlayStyle are orthogonal axes. Skill drives decision quality (rollout accuracy, pot-odds discipline, position awareness, error rate); style drives bluffing, sandbagging, aggression, tightness. - BotMood gives tilt that persists between hands and decays. - OpponentModel lets Advanced/Expert exploit habitual bettors. - MathBot emits a DecisionTrace of the numbers behind each decision, which the coach will later hand to an LLM to narrate. The LLM never does poker maths. Simulator: - 2,200-3,400 hands/sec. Deck RNG is separate from bot RNGs so rollout counts cannot shift the deal. - Controlled skill-ladder test asserts the difficulty gradient is monotonic: 73.9 / 53.9 / 27.6 / -155.4 bb/100 over 50k hands. Assets: 52 CC0 English-pattern card faces plus generated backs. Tests: 30 passing (evaluator, table rules, pre-flop chart). Known open: win-rate magnitudes ~10x realistic and several profiles looser than their labels. Tuning, not correctness. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-25 04:36:03 -04:00
commit 479be1f6b9
82 changed files with 54638 additions and 0 deletions
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   version="1.1"
+   width="360"
+   height="540"
+   id="svg20298">
+  <defs
+     id="defs20300" />
+  <metadata
+     id="metadata20303">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     transform="translate(-151.42857,-248.08929)"
+     id="layer1">
+    <g
+       transform="translate(151.42857,-264.27289)"
+       id="g3035-5">
+      <rect
+         width="359"
+         height="539"
+         rx="29.944447"
+         ry="29.944447"
+         x="0.5"
+         y="512.86218"
+         id="rect6472-34"
+         style="fill:#ffffff;stroke:#000000;stroke-width:0.99999976" />
+      <path
+         d="m 30,542.36208 c -5.54,0 -10,4.46 -10,10 l 0,5 5,0 0,-5 c 0,-2.77 2.23,-5 5,-5 2.77,0 5,2.23 5,5 l 0,5 c 0,2.77 -2.23,5 -5,5 l -5,0 0,5 5,0 c 2.77,0 5,2.23 5,5 l 0,10 c 0,2.77 -2.23,5 -5,5 -2.77,0 -5,-2.23 -5,-5 l 0,-5 -5,0 0,5 c 0,5.54 4.46,10 10,10 5.54,0 10,-4.46 10,-10 l 0,-10 c 0,-3.0036 -1.32295,-5.67 -3.40625,-7.5 2.0833,-1.83 3.40625,-4.4964 3.40625,-7.5 l 0,-5 c 0,-5.54 -4.46,-10 -10,-10 z"
+         id="rect3163-5-1-4-3-4-0-3"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 330,1022.3622 c 5.54,0 10,-4.46 10,-10 l 0,-5 -5,0 0,5 c 0,2.77 -2.23,5 -5,5 -2.77,0 -5,-2.23 -5,-5 l 0,-5 c 0,-2.77 2.23,-5 5,-5 l 5,0 0,-5.00002 -5,0 c -2.77,0 -5,-2.23 -5,-5.00002 l 0,-10 c 0,-2.77 2.23,-5 5,-5 2.77,0 5,2.23 5,5 l 0,5 5,0 0,-5 c 0,-5.54 -4.46,-10 -10,-10 -5.54,0 -10,4.46 -10,10 l 0,10 c 0,3.00362 1.32295,5.67002 3.40625,7.50004 -2.0833,1.83 -3.40625,4.4964 -3.40625,7.5 l 0,5 c 0,5.54 4.46,10 10,10 z"
+         id="rect3163-5-1-4-3-4-0-4-21"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 185,613.36218 c 1,4 5,14 12,14 9,0 13,-8 13,-18 0,-7 -2.57895,-11.61229 -5,-17 -2.57788,-5.73673 -6.37932,-10.85741 -10,-16 -4.6453,-6.5979 -15,-19 -15,-19 0,0 -10.3547,12.4021 -15,19 -3.62068,5.14259 -7.42212,10.26327 -10,16 -2.42105,5.38771 -5,10 -5,17 0,10 4,18 13,18 7,0 11,-10 12,-14 1,-1 1,0 1,1 -1,8 -1,10 -2,16 -1,6 -4,17 -4,17 5,-2 15,-2 20,0 0,0 -3,-11 -4,-17 -1,-6 -1,-8 -2,-16 0,-1 0,-2 1,-1 z"
+         id="path3037-7-13"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 185,793.36218 c 1,4 5,14 12,14 9,0 13,-8 13,-18 0,-7 -2.57895,-11.61229 -5,-17 -2.57788,-5.73673 -6.37932,-10.85741 -10,-16 -4.6453,-6.5979 -15,-19 -15,-19 0,0 -10.3547,12.4021 -15,19 -3.62068,5.14259 -7.42212,10.26327 -10,16 -2.42105,5.38771 -5,10 -5,17 0,10 4,18 13,18 7,0 11,-10 12,-14 1,-1 1,0 1,1 -1,8 -1,10 -2,16 -1,6 -4,17 -4,17 5,-2 15,-2 20,0 0,0 -3,-11 -4,-17 -1,-6 -1,-8 -2,-16 0,-1 0,-2 1,-1 z"
+         id="path3037-7-1-2"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 185,951.3622 c 1,-4 5,-14 12,-14 9,0 13,8 13,18 0,7 -2.57895,11.61229 -5,17 -2.57788,5.73673 -6.37932,10.85741 -10,16 -4.6453,6.5979 -15,19 -15,19 0,0 -10.3547,-12.4021 -15,-19 -3.62068,-5.14259 -7.42212,-10.26327 -10,-16 -2.42105,-5.38771 -5,-10 -5,-17 0,-10 4,-18 13,-18 7,0 11,10 12,14 1,1 1,0 1,-1 -1,-8 -1,-10 -2,-16 -1,-6 -4,-17.00002 -4,-17.00002 5,2 15,2 20,0 0,0 -3,11.00002 -4,17.00002 -1,6 -1,8 -2,16 0,1 0,2 1,1 z"
+         id="path3037-7-7-5"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 32.5,630.36218 c 0.5,2 2.5,7 6,7 4.5,0 6.5,-4 6.5,-9 0,-3.5 -1.289475,-5.80614 -2.5,-8.5 -1.28894,-2.86836 -3.18966,-5.4287 -5,-8 -2.32265,-3.29895 -7.5,-9.5 -7.5,-9.5 0,0 -5.17735,6.20105 -7.5,9.5 -1.81034,2.5713 -3.71106,5.13164 -5,8 -1.210525,2.69386 -2.5,5 -2.5,8.5 0,5 2,9 6.5,9 3.5,0 5.5,-5 6,-7 0.5,-0.5 0.5,0 0.5,0.5 -0.5,4 -0.5,5 -1,8 -0.5,3 -2,8.5 -2,8.5 2.5,-1 7.5,-1 10,0 0,0 -1.5,-5.5 -2,-8.5 -0.5,-3 -0.5,-4 -1,-8 0,-0.5 0,-1 0.5,-0.5 z"
+         id="path3037-7-4-35"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+      <path
+         d="m 332.5,934.36218 c 0.5,-2 2.5,-7 6,-7 4.5,0 6.5,4 6.5,9 0,3.5 -1.28947,5.80614 -2.5,8.5 -1.28894,2.86836 -3.18966,5.4287 -5,8 -2.32265,3.29895 -7.5,9.5 -7.5,9.5 0,0 -5.17735,-6.20105 -7.5,-9.5 -1.81034,-2.5713 -3.71106,-5.13164 -5,-8 -1.21053,-2.69386 -2.5,-5 -2.5,-8.5 0,-5 2,-9 6.5,-9 3.5,0 5.5,5 6,7 0.5,0.5 0.5,0 0.5,-0.5 -0.5,-4 -0.5,-5 -1,-8 -0.5,-3 -2,-8.5 -2,-8.5 2.5,1 7.5,1 10,0 0,0 -1.5,5.5 -2,8.5 -0.5,3 -0.5,4 -1,8 0,0.5 0,1 0.5,0.5 z"
+         id="path3037-7-4-4-1"
+         style="fill:#000000;fill-opacity:1;stroke:none" />
+    </g>
+  </g>
+</svg>