Veit F. 422fa5b3ab feat: implement bot intelligence system with 8 archetypes and coaching

Add personality-driven bots with 8 archetypes (Nit, TAG, LAG, Maniac, Calling Station, Loose Fish, Old Man, Monster TAG) across 5 skill levels.

Includes:

- Three-layer decision pipeline (base strategy → personality filter → skill noise)

- Decision timer system with archetype-specific timeout defaults

- Observation tracking engine (VPIP, PFR, Fold-to-CBet, WTSD, bet sizing, timing tells)

- Player classification engine with weighted scoring and confidence scaling

- Table setup UI with visual seat editor and quick presets

- Info display system with 4 visibility levels

- Teaching coach with post-hand analysis and real-time suggestions

Archives bot-intelligence change and syncs all 8 delta specs to main specs.

2026-05-17 22:41:09 +02:00

3.1 KiB

Raw Blame History

Decision Timer

Purpose

Enforces sequential turn order with configurable countdown timers, adding realism and pressure to bot and human decision-making.

ADDED Requirements

Requirement: Sequential action timer with countdown display

The system SHALL enforce sequential turn order where each active player receives an independent countdown timer. The timer duration SHALL be configurable (5-30 seconds, default 10s). A visual countdown indicator SHALL be displayed for the current acting player. When the timer reaches zero, the system SHALL execute a timeout action.

Scenario: Timer counts down for current player

WHEN it is Bot #2's turn to act and timer is set to 10s
THEN a countdown from 10 to 0 is displayed, then turn advances to next active player

Scenario: Timer expires triggers timeout action

WHEN a bot's timer reaches zero before the bot makes a decision
THEN the system executes the bot's archetype-appropriate timeout default action

Requirement: Archetype-specific timeout defaults

The system SHALL define a default timeout action per archetype: Nit folds, TAG checks or folds, LAG calls, Maniac raises, Calling Station calls, Loose Fish calls, Old Man calls, Monster TAG checks. The timeout action SHALL be recorded in the action history and counted as a mistake for skill assessment.

Scenario: Nit times out by folding

WHEN a Nit bot's timer expires during a betting round
THEN the bot folds and the turn advances to the next active player

Scenario: Maniac times out by raising

WHEN a Maniac bot's timer expires and raising is a valid action
THEN the bot makes a raise and the turn advances

Requirement: Optional human player timer

The system SHALL support three human timer modes: "Same as bots" (human gets same duration as bot timer), "No limit" (human has unlimited time), or "Custom" (player specifies duration). In No Limit mode, no countdown is displayed for the human. Timer mode SHALL be configurable in table setup.

Scenario: Human plays with no timer

WHEN human timer is set to "No limit" and it is the human's turn
THEN no countdown appears and the human may take unlimited time to decide

Scenario: Human shares bot timer duration

WHEN human timer is set to "Same as bots" with 10s bot timer
THEN the human has a 10-second countdown when it is their turn

Requirement: Timing data recorded for observation

The system SHALL record the decision time (in seconds) for every action taken by every player. The recorded timing data SHALL be available to the observation tracking system and classification engine. Decision time SHALL be measured from when the timer starts for a player to when they commit an action.

Scenario: Fast action is recorded

WHEN Bot #3 calls within 1.5 seconds of their timer starting
THEN the action history records decision_time: 1.5 for that action

Scenario: Slow hesitation is recorded

WHEN Bot #5 takes 8.2 seconds to decide before folding
THEN the action history records decision_time: 8.2 for that fold

3.1 KiB Raw Blame History