Files
holdem_poker/assets/cards/6_of_clubs.svg
T
thejayman77 479be1f6b9 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

112 lines
6.9 KiB
XML

<?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"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
version="1.1"
width="360"
height="540"
id="svg20298">
<defs
id="defs20300">
<inkscape:path-effect
effect="spiro"
id="path-effect17935-89" />
<inkscape:path-effect
effect="spiro"
id="path-effect17939-8" />
<inkscape:path-effect
effect="spiro"
id="path-effect17935-8-7" />
<inkscape:path-effect
effect="spiro"
id="path-effect17939-6-0" />
<inkscape:path-effect
effect="spiro"
id="path-effect17935-9-8-2-5-09-4-0" />
<inkscape:path-effect
effect="spiro"
id="path-effect17935-9-8-2-5-09-4-1-8" />
<inkscape:path-effect
effect="spiro"
id="path-effect17935-9-8-2-5-08" />
<inkscape:path-effect
effect="spiro"
id="path-effect17935-9-8-2-5-0-8" />
</defs>
<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.27291)"
id="g3062">
<rect
width="359"
height="539"
rx="29.944447"
ry="29.944447"
x="0.5"
y="512.86218"
id="rect6472-61"
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,20 0,10 c 0,5.54 4.46,10 10,10 5.54,0 10,-4.46 10,-10 l 0,-10 c 0,-5.54 -4.46,-10 -10,-10 -1.82264,0 -3.53152,0.49855 -5,1.34375 l 0,-11.34375 c 0,-2.77 2.23,-5 5,-5 2.77,0 5,2.23 5,5 l 0,1 5,0 0,-1 c 0,-5.54 -4.46,-10 -10,-10 z m 0,25 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,-10 c 0,-2.77 2.23,-5 5,-5 z"
id="rect3163-7-1-7-3-1-8"
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,-20.00004 0,-10 c 0,-5.54 -4.46,-10 -10,-10 -5.54,0 -10,4.46 -10,10 l 0,10 c 0,5.54004 4.46,10.00004 10,10.00004 1.82264,0 3.53152,-0.4985 5,-1.3437 l 0,11.3437 c 0,2.77 -2.23,5 -5,5 -2.77,0 -5,-2.23 -5,-5 l 0,-1 -5,0 0,1 c 0,5.54 4.46,10 10,10 z m 0,-25 c -2.77,0 -5,-2.23 -5,-5.00004 l 0,-10 c 0,-2.77 2.23,-5 5,-5 2.77,0 5,2.23 5,5 l 0,10 c 0,2.77004 -2.23,5.00004 -5,5.00004 z"
id="rect3163-7-1-7-3-1-9-2"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 95,613.36218 c 2,4 7,10 12,10 9,0 13,-8 13,-18 0,-10 -4,-19 -13,-19 -5,0 -8,5 -11,8 -1,1 -2,0 -1,-1 3,-3 8,-11 8,-18 0,-8 -5,-18 -13,-18 -8,0 -13,10 -13,18 0,7 5,15 8,18 1,1 0,2 -1,1 -3,-3 -6,-8 -11,-8 -9,0 -13,9 -13,19 0,10 4,18 13,18 5,0 10,-6 12,-10 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-119"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 275,613.36218 c 2,4 7,10 12,10 9,0 13,-8 13,-18 0,-10 -4,-19 -13,-19 -5,0 -8,5 -11,8 -1,1 -2,0 -1,-1 3,-3 8,-11 8,-18 0,-8 -5,-18 -13,-18 -8,0 -13,10 -13,18 0,7 5,15 8,18 1,1 0,2 -1,1 -3,-3 -6,-8 -11,-8 -9,0 -13,9 -13,19 0,10 4,18 13,18 5,0 10,-6 12,-10 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-1-7"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 95,793.36218 c 2,4 7,10 12,10 9,0 13,-8 13,-18 0,-10 -4,-19 -13,-19 -5,0 -8,5 -11,8 -1,1 -2,0 -1,-1 3,-3 8,-11 8,-18 0,-8 -5,-18 -13,-18 -8,0 -13,10 -13,18 0,7 5,15 8,18 1,1 0,2 -1,1 -3,-3 -6,-8 -11,-8 -9,0 -13,9 -13,19 0,10 4,18 13,18 5,0 10,-6 12,-10 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-62"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 275,793.36218 c 2,4 7,10 12,10 9,0 13,-8 13,-18 0,-10 -4,-19 -13,-19 -5,0 -8,5 -11,8 -1,1 -2,0 -1,-1 3,-3 8,-11 8,-18 0,-8 -5,-18 -13,-18 -8,0 -13,10 -13,18 0,7 5,15 8,18 1,1 0,2 -1,1 -3,-3 -6,-8 -11,-8 -9,0 -13,9 -13,19 0,10 4,18 13,18 5,0 10,-6 12,-10 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-4-9"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 95,951.3622 c 2,-4 7,-10 12,-10 9,0 13,8 13,18 0,10 -4,19 -13,19 -5,0 -8,-5 -11,-8 -1,-1 -2,0 -1,1 3,3 8,11 8,18 0,8 -5,18 -13,18 -8,0 -13,-10 -13,-18 0,-7 5,-15 8,-18 1,-1 0,-2 -1,-1 -3,3 -6,8 -11,8 -9,0 -13,-9 -13,-19 0,-10 4,-18 13,-18 5,0 10,6 12,10 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-0-5"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 275,951.3622 c 2,-4 7,-10 12,-10 9,0 13,8 13,18 0,10 -4,19 -13,19 -5,0 -8,-5 -11,-8 -1,-1 -2,0 -1,1 3,3 8,11 8,18 0,8 -5,18 -13,18 -8,0 -13,-10 -13,-18 0,-7 5,-15 8,-18 1,-1 0,-2 -1,-1 -3,3 -6,8 -11,8 -9,0 -13,-9 -13,-19 0,-10 4,-18 13,-18 5,0 10,6 12,10 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-9-2"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 32.5,630.36218 c 1,2 3.5,5 6,5 4.5,0 6.5,-4 6.5,-9 0,-5 -2,-9.5 -6.5,-9.5 -2.5,0 -4,2.5 -5.5,4 -0.5,0.5 -1,0 -0.5,-0.5 1.5,-1.5 4,-5.5 4,-9 0,-4 -2.5,-9 -6.5,-9 -4,0 -6.5,5 -6.5,9 0,3.5 2.5,7.5 4,9 0.5,0.5 0,1 -0.5,0.5 -1.5,-1.5 -3,-4 -5.5,-4 -4.5,0 -6.5,4.5 -6.5,9.5 0,5 2,9 6.5,9 2.5,0 5,-3 6,-5 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-1-4"
style="fill:#000000;fill-opacity:1;stroke:none" />
<path
d="m 332.5,934.36218 c 1,-2 3.5,-5 6,-5 4.5,0 6.5,4 6.5,9 0,5 -2,9.5 -6.5,9.5 -2.5,0 -4,-2.5 -5.5,-4 -0.5,-0.5 -1,0 -0.5,0.5 1.5,1.5 4,5.5 4,9 0,4 -2.5,9 -6.5,9 -4,0 -6.5,-5 -6.5,-9 0,-3.5 2.5,-7.5 4,-9 0.5,-0.5 0,-1 -0.5,-0.5 -1.5,1.5 -3,4 -5.5,4 -4.5,0 -6.5,-4.5 -6.5,-9.5 0,-5 2,-9 6.5,-9 2.5,0 5,3 6,5 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-1-8-0"
style="fill:#000000;fill-opacity:1;stroke:none" />
</g>
</g>
</svg>