# Match, niveaux et réglages (1c)

- **Date** : 2026-11-03
- **Étape** : 1c (`docs/etape-1.md`)
- **Statut** : fait (2026-11-09), en attente de vérification
- **Exécutant** : sous-agent general-purpose, dans un worktree

## Objectif

Choisir sa partie : partie libre ou match en N points, avec les règles de
Crawford et de Jacoby, contre l'ordinateur au niveau voulu.

## Consignes

ADR 0007, 0008. Le moteur expose depuis 1a les niveaux de gnubg
(`levelMove`, `levelCubeDecision`) et accepte les matchs dans son API C.

1. **Domaine** : longueur de match, score, règle de Crawford (partie Crawford
   et suivantes, calculées par le moteur via le Match ID), règle de Jacoby en
   partie libre ; enchaînement des manches d'un match jusqu'à sa fin ; le
   journal d'événements reste rétrocompatible (les parties existantes se
   rechargent).
2. **Adaptateur** : `EngineCube` étendu au match (score, longueur, Crawford)
   ou remplacé par le Match ID, sans casser les appels existants.
3. **Niveau de l'ordinateur** : ses coups et ses décisions de videau au niveau
   choisi. Reprendre de `ComputerTurn` (gnubg, `play.c`) les règles de
   déroulement non reprises en 1a : pré-filtre « fenêtre de marché » et double
   facultatif à 0 pli, avec citation des sources.
4. **Écran de nouvelle partie** (maquettes de la session « identité » si
   disponibles, sinon sobre et conforme à la charte) : type de partie, niveau
   (noms montrés au joueur à proposer simplement : Débutant, Amateur,
   Intermédiaire, Avancé, Expert, Champion — correspondance avec les niveaux
   de gnubg documentée), conseil du maître activé ou non. Par défaut : partie
   libre, Intermédiaire, conseil activé. Le réglage est mémorisé.
5. Affichage du score de match et de la partie Crawford sur le plateau.
6. Scénarios Gherkin (match en 3 points jusqu'au bout avec dés imposés,
   Crawford, Jacoby) et fiches du glossaire (match, Crawford, Jacoby si
   absentes). `make lint`, `make test`, `make test-browser` (un match court).

## Critères de réussite

Un match en 3 points se joue jusqu'au bout, au niveau choisi, avec Crawford
appliqué ; les trois commandes passent.

## Résultat

2026-11-09, branche `match-et-reglages` (sur `accueil-tutoriel-aide` puis
`main` fusionnées).

**Fait**

1. **Moteur** (une seule recompilation, `engine.c` et `engine-cli/main.c`) :
   `engine_level_double_decision` et `engine_level_take_decision` reprennent
   `ComputerTurn` (gnubg, `play.c` l. 1312-1398 et 1139-1235) : accès au
   videau et videau < 4096, pré-filtre « fenêtre de marché » (évaluation sans
   videau à un pli de moins, `GetDoublePointDeadCube`), double facultatif
   seulement à 0 pli avec plus de 0,001 de gain, réponse au double selon la
   décision (castors joués comme une prise). `engine_match_after_game` :
   score, fin du match, partie Crawford suivante (`play.c` l. 1817-1820 ;
   partie Crawford déjà jouée lue comme gnubg, l. 303 et 4277). engine-cli :
   `double`, `take`, `aftergame`, `matchid` étendu aux matchs. Tests dans
   `tests/test_engine.sh`.
2. **Domaine** : `Match`, `MatchAfterGame` (`match.ts`), niveaux montrés
   (`level.ts` : Débutant beginner, Amateur casual, Intermédiaire
   intermediate, Avancé advanced, Expert 0ply, Champion 2ply ; documenté
   dans `docs/glossaire/niveau-de-jeu.md`). `Game` : niveau et match portés
   par `GameStarted`, ordinateur par `levelMove`/`levelDouble`/`levelTake`,
   `GameEnded.match` donné par le moteur, `nextGame` pour la partie suivante.
   `EngineCube` étendu au match (vu du joueur au trait) ; le Match ID est
   écrit par le moteur, liens de position compris. Chaque partie d'un match
   est une partie enregistrée à part.
3. **Format** : événements en version 2, migration testée des journaux de la
   version 1 (niveau 2 plis explicite) ; résumé avec `match` facultatif ;
   quatre réglages nouveaux avec valeur par défaut. Amendement de l'ADR 0007.
4. **Écran `#/nouvelle-partie`** (charte 1c) : segments partie libre/match,
   longueurs 3/5/7/11, phrases et liens Crawford/Jacoby, six barres de
   niveau, conseil du maître, barre d'action collée en bas ; choix gardés.
   Ouvert par le menu (lien), l'accueil et la fin de partie ; « Partie
   suivante » dans un match qui continue. Adresse ajoutée à l'ADR 0013.
5. **Score** : ligne « Match en N points · partie Crawford », pastilles dans
   les bandeaux, case « sur N » dans la colonne de commandes en paysage,
   texte pour le lecteur d'écran ; videau caché pendant la partie Crawford ;
   panneau de fin de partie et de fin de match.
6. **Tests** : `jouer-un-match.feature` (niveau, match en 3 points jusqu'au
   bout avec dés imposés, Crawford, Jacoby), `match.test.ts`, tests du
   domaine (match, migration), `tests/browser/match.mjs` (écran, match en
   3 points joué par l'interface jusqu'au bout, rechargement en cours de
   match ; captures dans `build/browser-shots/match/`). `play.mjs` adapté au
   passage par l'écran « Nouvelle partie ».

**Écarts**

- Le moteur C a changé (fonctions ajoutées, rien de gnubg modifié).
- Le « conseil du maître » n'est qu'un réglage gardé : il n'existe pas
  encore (1d).
- « Mes parties » liste chaque partie d'un match séparément, sans afficher
  le match ; le résumé porte pourtant `match` pour le faire plus tard.
- Le numéro de la partie dans le match n'est pas gardé (SGF : `game:0`).
- Longueur par défaut d'un match : 5 points (la charte ne la fixe pas).

**Suites** : affichage du match dans « Mes parties » ; recette design des
captures ; essai sur le Fairphone 4 (temps du niveau Champion).