Ustagammon/docs/plans/2026-11-12-retours-joueurs-2.md

Retours des joueurs, 2e lot : Crawford sur la barre, abandon

• Date : 2026-11-12
• Étape : 1 (retours des joueurs relayés par Pierre)
• Statut : prévu (après 1h et 1i, et les maquettes de la session « identité »)
• Exécutant : sous-agent general-purpose, dans un worktree

Objectif

Deux retours de joueurs relayés par Pierre le 2026-11-12 :

• « il serait bien que le Crawford soit en évidence sur la barre plutôt » ;
• « possibilité de pouvoir abandonner (un petit drapeau ?) si on sait qu'on va perdre, et pouvoir proposer simple, gammon, backgammon sans que l'ordinateur ne se fasse arnaquer (il refuse un simple si on sait qu'il y aura gammon par exemple) ».

Consignes

Respecter les ADR 0005, 0007, 0008, 0011 et 0013. Suivre les règles et les maquettes de la session « identité », qui seront ajoutées dans docs/identite/charte/.

1. Crawford sur la barre. L'indication de la partie Crawford est placée sur la barre du plateau, en portrait et en paysage, à l'endroit fixé par la charte.

2. Abandon, côté moteur.

   • La décision d'accepter ou de refuser un abandon (simple, gammon ou backgammon) reprend le code de GNU Backgammon de bureau qui répond à un abandon proposé par l'humain : évaluation de la position, équité de l'abandon (getResignation, getResignEquity ou leurs équivalents dans gnubg 1.08.003), comparaison à l'équité de la partie continuée. Les sources sont citées fichier et ligne.
   • Ces fichiers ne sont pas dans la copie : porter le code dans engine.c, comme pour la chance en 1a, sans modifier engine/gnubg/.
   • Exposer la décision par engine.h, engine-cli et l'adaptateur.
   • Ajouter des positions de référence comparées à gnubg de bureau (Docker), avec au moins :
     • un simple refusé parce que le gammon est probable ;
     • un simple accepté ;
     • un gammon accepté ;
     • un cas de match.

3. Abandon, côté domaine.

   • Un événement d'abandon, proposé puis accepté ou refusé, rétrocompatible : migration testée (ADR 0007).
   • Fin de partie avec les points selon la valeur de l'abandon et le videau.
   • Prise en compte dans le match (score, Crawford), le bilan, la progression et l'export SGF (convention de gnubg pour l'abandon).

4. Abandon, côté interface.

   • Le drapeau, la feuille de choix et la réponse de l'ordinateur, selon la charte.
   • Messages dans le ton du maître, ajoutés à docs/maitre/phrases.md ou à une source sœur.

5. Aide et glossaire.

   • Fiche « Abandon » (resign).
   • Scénarios Gherkin avec dés imposés : abandon accepté, abandon refusé, abandon en match.

Tests : make lint, make test, make test-browser (suite complète), avec captures pour la recette design.

Critères de réussite

• Sur une position de référence où le gammon est probable, un abandon simple est refusé, comme dans gnubg de bureau.
• Un abandon accepté termine la partie avec les bons points.
• Les trois commandes passent.

Résultat

À remplir à la clôture.