fix(docs): refresh stale README example numbers against the live engine - Quick start (3 goblins vs 2 orcs, seed 1): 96.2%/962 band [94.4%,98.0%], monsters 3.6%/36, 2 draws, 6.6 rounds; Exemple verifie (1 goblin vs 2 orcs): 33.0% band [28.5%,37.5%], 6 draws, 7.1 rounds, prose adjusted to the new distribution; dev test count 1596 -> 1634

This commit is contained in:
2026-09-19 17:18:31 +02:00
parent ba5eb4c95f
commit 9a087a444b
+16 -12
View File
@@ -72,10 +72,10 @@ players : 3 combatants
monsters : 2 combatants
1000 combats simulés (seed 1, plafond 100 rounds)
Victoires players : 91.4% (914) — bande 3σ : [88.7%, 94.1%]
Victoires monsters : 8.6% (86) — bande 3σ : [5.9%, 11.3%]
Nuls : 0.0% (0)
Rounds moyens : 6.0
Victoires players : 96.2% (962) — bande 3σ : [94.4%, 98.0%]
Victoires monsters : 3.6% (36) — bande 3σ : [1.8%, 5.4%]
Nuls : 0.2% (2)
Rounds moyens : 6.6
```
## Utilisation de la CLI
@@ -159,13 +159,17 @@ confiance à 3σ calculée en forme fermée (modèle binomial) :
immobiles, camps inaccessibles…).
Exemple vérifié — 1 gobelin (players) contre 2 orcs (monsters), 1000 runs,
seed 1 : players 22,0 %, bande 3σ [18,1 % ; 25,9 %], 0 nuls, 5,2 rounds moyens.
Sans ligne de visée depuis la zone de départ, l'archer gobelin doit contourner
le mur central avant de tirer ; mais avec l'économie d'action activée, les orcs
parcourent toute leur vitesse (30 ft) puis frappent dans le même tour — le
gobelin solitaire ne peut plus les distancer et tombe vite en mêlée sous les
2d4+4 des falchions. C'est ce déséquilibre de cadence qui penche fortement le
face-à-face à 1 contre 2 du côté des monstres.
seed 1 : players 33,0 %, bande 3σ [28,5 % ; 37,5 %], 6 nuls (0,6 %), 7,1 rounds
moyens. Sans ligne de visée depuis la zone de départ, l'archer gobelin doit
contourner le mur central avant de tirer ; mais avec l'économie d'action
activée, les orcs parcourent toute leur vitesse (30 ft) puis frappent dans le
même tour — le gobelin solitaire ne peut plus les distancer durablement et
finit par tomber en mêlée sous les 2d4+4 des falchions. Il parvient parfois à
en coucher un avant : ces duels inégaux prolongés, et les rares combats de
kiting menés jusqu'au plafond de rounds (les 6 nuls), expliquent que sa part
dise atteigne tout de même un tiers des combats. C'est ce déséquilibre de
cadence qui penche nettement le face-à-face à 1 contre 2 du côté des monstres
(deux tiers des combats).
## Formats de données
@@ -1902,7 +1906,7 @@ Limites de sorts (conformance D6-D9, documentées plutôt que bricolées) :
La gate de validation complète (tests + lint + types) :
```bash
uv run pytest -q # 1596 tests
uv run pytest -q # 1634 tests
uv run ruff check src tests
uv run basedpyright src # mode strict
```