# PokerExpert — Full Technical, Strategy & Product Reference (`llms-full.txt`)

- **Canonical URL**: https://pokerexpert.app
- **Publisher**: Biwada LLC (`greg@biwada.com`)
- **Platforms**: iOS (Web PWA & App Store pipeline), Android (Google Play & Web PWA), Desktop Web
- **Offline Capability**: 100% client-side poker, AI persona, and Monte Carlo EV engine (`engine_local.js` + `sw.js` precache). Zero cloud latency, works in airplane mode.
- **Gambling Policy**: 18+ educational poker math trainer only. Zero real-money gambling, zero cash-outs, zero paid virtual chips.

---

## 1. Problem Solved by PokerExpert

Most poker players do not lose money in 100bb heads-up GTO solver Equilibrium spots—they lose stacks in **multi-way live $1/$2, $1/$3, $2/$5, and weekly home games** featuring:
1. Loose **Calling Stations** who peel wide flops and fold only when missed draws brick,
2. **Maniacs & Tilted (`STEAMING`) players** firing 2x–3x overbets,
3. **4-Card PLO, 5-Card Big O, and Double-Board Bomb Pots** where top two pair or non-nut flushes get quartered or scooped, and
4. **200bb Button Straddle pots** where Stack-to-Pot Ratio (SPR) shifts one-pair hands from stack-off value into thin bluff-catchers.

Traditional social poker apps (*WSOP*, *Zynga*) train bad habits with unrealistic play-money shoves and aggressive virtual-chip microtransactions, while cloud GTO solver suites cost **$69–$129/month**, require constant internet connectivity, and rarely let casual-to-serious live players actually *play full hands* against calibrated clones of their real-life friends.

---

## 2. Complete Variant & Table Matrix

| Parameter | Supported Options in PokerExpert |
| :--- | :--- |
| **Hole Cards** | `2-Card No-Limit Hold'em (NLH)`, `4-Card Pot-Limit Omaha (PLO)`, `5-Card Big O / 5-Card PLO` (strictly enforces exact 2-from-hand + 3-from-board Omaha rule) |
| **Community Boards** | `Single Board (1 Board)` or `Double Board (2 Simultaneous Boards — 50/50 split pot evaluation)` |
| **Action Formats** | Standard Blinds, `200bb Button Straddles`, `Single-Board Bomb Pots`, `Double-Board Bomb Pots` (skip preflop straight to multi-way ante flop) |
| **Table Sizes** | `2-Max (Heads-Up)` up to `9-Max / 10-Max Full Ring` (auto-caps seat count on 5-card double-board formats to preserve exact 52-card deck conservation) |
| **Chip Conservation** | Strictly audited conservation invariant across main pots, multi-way side pots, odd-chip remainder distribution, and split-board quartering |

---

## 3. Adaptive Human-Like AI Opponent Engine

Instead of evaluating postflop strength purely on static 5-card made-hand rank, PokerExpert runs `<0.2ms` analytical hand + board texture profiling (`evaluatePostflopHandProfile`):
- **Made-Hand Nuance**: Distinguishes disguised pocket sets (`33` on `K-8-3`) from exposed board trips (`A-3` on `3-3-K`), nut flushes from vulnerable baby flushes, and clean PLO two-pair/sets from dead hand-trips (`AAAx`).
- **Draw & Wrap Intelligence**: Computes exact flush draws (nut vs. non-nut), open-ended straight draws (OESD), combo draws, and **11-to-20 out PLO / Big O monster wraps** so opponents semi-bluff and call pot-odds-appropriate bets instead of folding strong draws.
- **Street Narrative & Position Memory**: Tracks `preflop_aggressor_seat` (in-position continuation bets vs. out-of-position checking to the raiser, plus recreational Calling Station small "donk leads"), arms flop check-raise traps with disguised sets/nut flushes, and fires bare `A♠` nut-flush blocker bluffs on monotone/3-flush rivers.
- **Dynamic Session Tilt (`COOL` / `HEATER` / `STEAMING`)**: After losing big pots or getting bluffed, volatile archetypes visibly shift into `STEAMING` mood—widening VPIP, raising bluff frequency, and loosening bluff-catching thresholds just like real live players.

---

## 4. Deterministic 1,200-Rollout Move Math & EV Grading

Every Hero decision can be inspected pre-action or post-action via **Move Math**:
- **Zero-Jitter Seeded Monte Carlo**: Uses FNV-1a hashing + `mulberry32` PRNG seeded on `(heroHand, board1, board2, pot, toCall)` across 1,200 full runouts (including 2-board scoop + half-pot split equity) so re-opening Move Math on the same spot produces `0.00%` random drift.
- **Metrics Shown**:
  - Exact **Equity %** (Scoop % + Split % on Double Boards)
  - **Pot Odds %** required to continue
  - **Minimum Defense Frequency (`MDF = Pot / (Pot + Bet)`)**
  - Expected Value (`$EV`) of **Fold**, **Check/Call**, and **33% / 50% / 75% / 100% Pot Raises**
  - **Adverse-Selection Overbet Grading**: Evaluates custom bet sizes directly so `5x–10x` pot overbet punts with medium-strength 1-pair hands are accurately flagged as `-EV BLUNDER`s when opponents fold worse hands and call only with nutted holdings.

---

## 5. Deep-Linkable Spot Drills (`https://pokerexpert.app/?drill=<id>`)

1. `https://pokerexpert.app/?drill=river_bluff_catcher` — **River Bluff-Catcher (Free)**: Heads-up on the River facing an 18bb polarized bet; apply MDF and pot odds.
2. `https://pokerexpert.app/?drill=deep_straddle_wars` — **200bb Straddle Wars (Free)**: Deep-stack live cash pot with active Button Straddle and high postflop SPR.
3. `https://pokerexpert.app/?drill=three_bet_cbet_lab` — **3-Bet Pot Flop Lab (Free)**: In position holding `QQ` in a heads-up 3-bet pot on a dynamic two-tone `J♠ 8♠ 4♦` board.
4. `https://pokerexpert.app/?drill=bomb_pot_gauntlet` — **Bomb Pot Gauntlet**: 4-Card PLO Double-Board Bomb Pot; practice nut redraws and avoiding getting quartered.
5. `https://pokerexpert.app/?drill=big_o_scoop_hunt` — **Big O Scoop Hunt**: 5-Card PLO Double-Board Pot-Limit Bomb Pot; navigate multi-way nut wraps and two-board scoop equity.
6. `https://pokerexpert.app/?drill=wet_turn_combo_barrel` — **Multi-Way Combo Turn**: 3-way wet turn holding `A♠ J♠` nut-flush + gutshot combo draw facing a lead and call.
7. `https://pokerexpert.app/?drill=monotone_blocker_bluff` — **Monotone Nut-Blocker**: 3-spade river holding the bare `A♠` nut blocker after a tight regular checks.
8. `https://pokerexpert.app/?drill=tilted_maniac_trap` — **Punish Steaming Maniac**: Heads-up holding `AK` top pair top kicker against a `STEAMING` opponent firing an overbet lead.

---

## 6. Pricing & Data Privacy Summary

- **Free Tier**: `$0` forever — Unlimited Hold'em cash play, Friend Profiler & table-link sharing, 3 Core Drills, 3 daily Move Math unlocks (+ up to 2 optional rewarded 5-hand Taste Passes/day).
- **Pro Tier**: `$4.99/mo`, `$24.99/yr`, or `$49.99` Lifetime Unlock (plus a contextual `$19.99` Year-1 Coaching Intro offer).
- **Privacy**: Zero mandatory registration or cloud account. Hand history, EV analytics, and friend rosters stay in local device storage and can be wiped in 1 tap (`Menu -> Session Leaks & EV -> Reset Session`).