HedgeEm Feature Specification

This is the golden source feature catalogue for Texas HedgeEm. Every feature is documented here before it appears in code, and updated whenever behaviour is discovered, corrected, or extended. Each feature document contains:

Business Rule — plain English, readable by a product manager or regulator
Technical Design — implementation details, algorithms, data structures, coordinates
Mathematics — formulas with worked examples where applicable
Acceptance Criteria — testable statements, each mapped to a Playwright assertion
Version Parity — implementation status across JS / TypeScript / UMA

Mintlify Integration

This directory lives at mintlify-docs/feature-docs/ and is published as the Feature Docs tab at hedgeem-api.qeetoto.com.

Parity Status Legend

Symbol	Meaning
✅	Verified — implemented and Playwright-tested
⚠️	Partial — implemented but known discrepancies
❌	Missing — not yet implemented
⬜	Not yet audited
N/A	Not applicable to this version

Version Parity Matrix

Feature ID	Feature	Phase	JS	TypeScript	UMA	V7	Jira
F001	Hand count rules	1	⬜	✅	✅	⬜	HEDGE-133
F002	Deck management	1	⬜	⬜	✅	⬜	HEDGE-133
F003	Community cards	1	⬜	✅	✅	⬜	HEDGE-133
F004	Game stages	1	⬜	✅	✅	⬜	HEDGE-133
F005	Hand evaluation	1	⬜	⬜	✅	⬜	HEDGE-133
F006	Odds calculation	1	⬜	⬜	✅	⬜	HEDGE-133
F007	RTP margin application	1	⬜	⬜	⬜	⬜	HEDGE-133
F008	Hand status	1	⬜	✅	✅	⬜	HEDGE-133
F010	Chip denominations	2	⬜	✅	✅	✅	HEDGE-50
F011	Bet placement	2	⬜	✅	✅	✅	HEDGE-50
F012	Bet cancellation	2	⬜	✅	✅	⬜	HEDGE-50
F013	Multi-hand betting	2	⬜	✅	✅	✅	HEDGE-50
F014	Multi-stage betting	2	⬜	⬜	✅	✅	HEDGE-133
F015	Payout calculation	2	⬜	✅	⚠️	✅	HEDGE-136
F016	Credits wallet	2	⬜	✅	⬜	✅	HEDGE-50, HEDGE-187
F020	Deal button / auto-deal on load	3	✅	✅	✅	✅	HEDGE-134
F021	Advance button	3	⬜	✅	⬜	✅	HEDGE-133
F022	Card display	3	⬜	✅	⬜	✅	HEDGE-135
F023	Hand panels	3	⬜	✅	⬜	✅	HEDGE-133
F024	Odds display	3	⬜	✅	⬜	✅	HEDGE-133
F025	Dead hand display	3	⬜	✅	⬜	✅	HEDGE-133
F026	Cant-lose display	3	⬜	✅	⬜	⬜	HEDGE-133
F027	Win display	3	⬜	✅	⬜	✅	HEDGE-133
F028	Bottom bar	3	⬜	✅	⬜	✅	HEDGE-133
F029	Chip selector UI	3	⬜	✅	⬜	✅	HEDGE-133
F030	Hand count config	4	⬜	⬜	⬜	⬜	HEDGE-80
F031	API vs local data	4	⬜	⬜	⬜	⬜	HEDGE-83
F032	RTP config	4	⬜	⬜	⬜	⬜	HEDGE-133
F033	Rounding algorithms	4	⬜	⬜	⬜	⬜	HEDGE-133
F040	Menu screen	4	⬜	⬜	⬜	⬜	HEDGE-78
F041	Help screen	4	⬜	⬜	⬜	⬜	HEDGE-78
F042	Config/settings screen	4	⬜	⬜	⬜	⬜	HEDGE-82
F043	Config and sound controls bar	3	✅	⬜	✅	✅	HEDGE-78, HEDGE-79
F044	Info modal (i + ? tabs)	3	⬜	⬜	✅	⬜	HEDGE-78
F045	Deal animation (hole cards fly from shuffler)	3	⬜	❌	✅	⬜	HEDGE-173
F046	Deal sound effects (per-card dealing_cards SFX)	3	⬜	✅	✅	⬜	HEDGE-174
F047	Fast Play config (2× animation speed)	3	⬜	✅	✅	⬜	HEDGE-175
F048	Coin spill animation (win payout burst)	3	⬜	✅	✅	⚠️	HEDGE-176
F049	Win level system (scaled sound & title by win/bet multiplier)	3	⬜	✅	✅	⬜	HEDGE-227
F050	Landscape layout	3	⬜	✅	⬜	⬜	HEDGE-133
F051	Portrait layout	3	⬜	✅	⬜	⬜	HEDGE-70
F052	Device themes	5	⬜	⬜	⬜	⬜	HEDGE-133
F060	Sound effects	4	⬜	⬜	❌	✅	HEDGE-142
F061	Background music	4	⬜	⬜	❌	✅	HEDGE-142
F070	UMA GDK integration	5	N/A	N/A	⚠️	N/A	HEDGE-145
F071	Wallet integration	5	N/A	✅	⬜	⬜	HEDGE-133, HEDGE-187
F072	Localisation	5	⬜	⬜	⬜	⬜	HEDGE-133
F083	Skill-based bonus rounds	4	❌	❌	❌	⬜	TBD
F084	Multi-level progressive jackpots	4	❌	❌	❌	⬜	TBD
F090	Horse name nicknames (169-hand table)	3	N/A	N/A	N/A	❌	HEDGE-178
F091	Betting slip panel (ruled paper, per-stage records, merge, dead ✕)	3	N/A	N/A	N/A	✅	HEDGE-180
F092	Horse name gradient band in info panel	3	N/A	N/A	N/A	✅	HEDGE-181
F093	Floating hand label on horse (FLOP/TURN/RIVER)	3	N/A	N/A	N/A	✅	HEDGE-182
F094	Previous odds struck-through in info panel	3	N/A	N/A	N/A	✅	HEDGE-183
F095	Bet by clicking horse body on track	3	N/A	N/A	N/A	✅	HEDGE-184
F096	Play sound on bet placement (one-shot neigh SFX)	3	N/A	N/A	N/A	✅	—
F097	Draws cards in 3D perspective (CSS rotateX tilt)	2	N/A	N/A	N/A	✅	HEDGE-214
F198v7	Scrolling procedural dirt track (animated SVG tiles)	3	N/A	N/A	N/A	✅	HEDGE-220
F199v7	Dynamic scrolling fences with rAF engine	3	N/A	N/A	N/A	✅	HEDGE-221
F200v7	Community cards scroll in sync with fences	3	N/A	N/A	N/A	✅	HEDGE-222
F201v7	In-race horse position randomness (sinusoidal oscillation)	3	N/A	N/A	N/A	✅	HEDGE-223
F202v7	Auto-run on bugle end — horses gallop to HOLE positions without player input	3	N/A	N/A	N/A	✅	—
F203v7	Bet-placement horse pop animation (scale bounce)	3	N/A	N/A	N/A	✅	—
F204v7	Eliminated horse scroll-off with upside-down flip	3	N/A	N/A	N/A	✅	—
F205v7	Probability-based horse positioning (logarithmic, 20–80%/90% range)	3	N/A	N/A	N/A	✅	—
F206v7	River hand description — full long form (e.g. “Two pair, Queens over Nines”)	3	N/A	N/A	N/A	✅	HEDGE-33
F207v7	Winner sprint at race end — winner(s) lerp to finish line; draws neck-and-neck; non-winners freeze	3	N/A	N/A	N/A	✅	—
F208v7	Smooth horse position transitions — no rank-order clamping; sort lerp by current position	3	N/A	N/A	N/A	✅	—
F209v7	Horse elimination uses percentWinOrDraw — horses that can still tie are never eliminated early	3	N/A	N/A	N/A	✅	—
F210v7	Server-side progressive card/odds disclosure (TableClient, HEDGE-33) — bc1–bc5 blank at deal, revealed stage by stage via POST /advance	4	N/A	N/A	N/A	✅	HEDGE-33
F055	Demo hand panel (QA forced deals via ?demo)	4	⬜	✅	✅	⬜	HEDGE-228
F103	Game loading screen (progress bar)	3	✅	✅	✅	✅	HEDGE-224
F104	Hidden odds debug panel (win%, draw%, odds chain)	3	✅	N/A	✅	✅	HEDGE-225
F100	Lobby page & authentication gate	3	⬜	✅	N/A	N/A	HEDGE-190
F101	Compliance bar (18+, GAMSTOP, GC, session timer, wallet)	3	N/A	✅	N/A	N/A	HEDGE-190
F102	Two-balance wallet (account vs seat)	5	N/A	✅	⬜	⬜	HEDGE-187

Phase Progress

Phase	Scope	Status
0 — Foundation	Repo structure, Playwright infrastructure	🔄 In Progress
1 — Core Game Engine	F001–F008	⬜ Backlog
2 — Betting	F010–F016	⬜ Backlog
3 — UI & Presentation	F020–F029, F050–F051	⬜ Backlog
4 — Config, Navigation & Audio	F030–F033, F040–F042, F060–F061, F083–F084	⬜ Backlog
5 — UMA Port	F052, F070–F072	⬜ Backlog
5+ — Platform & Lobby	F100–F102	🔄 In Progress
6 — Regulatory & Compliance	F080+	⬜ Backlog

Source Documents

Document	Location	Ingested
Texas HedgeEm Game Concept v0.3	`Dropbox/hedgeem/Documentation/design_and_description/hedgeem_game_concept.docx`	✅ 2026-04-05

Open Items — Simon Actions

Confirm jurisdiction for regulatory compliance documentation (Phase 6)
Provide SQLite DB file for schema extraction (HEDGE-29)
Confirm RTP configuration range and operator parameters (Phase 4/6)
Specify bonus round types and skill mechanics (F083)
Specify jackpot trigger events and accumulation model (F084)
Confirm rounding algorithm(s) in use in JS server (F033)

Playwright Test Coverage

Run feature tests against a specific version:

# TypeScript (standalone_reference_client, default)
VERSION=ts npx playwright test --project=features

# JavaScript reference client (live)
VERSION=js npx playwright test --project=features

# UMA client (Phase 5)
VERSION=uma npx playwright test --project=features

Shared test infrastructure: tests/shared/ Feature specs: tests/features/F0XX-feature-name.spec.ts

Overview

Game Engine

Betting

UI

Config

Bonus

V7 Horse Race

Platform

Lobby

HedgeEm Feature Specification — Index

HedgeEm Feature Specification

Mintlify Integration

Parity Status Legend

Version Parity Matrix

Phase Progress

Source Documents

Open Items — Simon Actions

Playwright Test Coverage

​HedgeEm Feature Specification

​Mintlify Integration

​Parity Status Legend

​Version Parity Matrix

​Phase Progress

​Source Documents

​Open Items — Simon Actions

​Playwright Test Coverage

HedgeEm Feature Specification

Mintlify Integration

Parity Status Legend

Version Parity Matrix

Phase Progress

Source Documents

Open Items — Simon Actions

Playwright Test Coverage