Domaine et adaptateur : niveaux, analyses et chance ; cache vidé à chaque calcul

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

engine/engine.c

@@ -252,12 +252,31 @@ check_dice(int die1, int die2)
     return ENGINE_OK;
 }
 
-/* Réglages prédéfinis de gnubg pour un niveau, sans bruit. */
+/*
+ * Vide le cache d'évaluation de gnubg avant chaque calcul : un résultat ne
+ * dépend ainsi que de ses arguments, comme les références (gnubg de bureau,
+ * « clear cache » avant chaque position). Sans cela, une recherche à 2 plis
+ * avec élagage laisse dans le cache des évaluations à 0 pli faites avec les
+ * réseaux d'élagage, rangées sous la même clé que les évaluations à 0 pli
+ * ordinaires (EvalKey, eval.c l. 2302 : l'élagage n'y compte qu'à partir
+ * d'1 pli) ; une chance de jet ou un coup à 0 pli calculé ensuite les
+ * reprendrait (écarts mesurés jusqu'à 2,5e-2, tests/reference/README.md).
+ * Coût mesuré : environ 3 ms par appel sous Node sur le PC.
+ */
+static void
+start_evaluation(void)
+{
+    EvalCacheFlush();
+}
+
+/* Réglages prédéfinis de gnubg pour un niveau, sans bruit ; prépare le
+ * calcul. */
 static engine_status
 eval_context_for_ply(int ply, evalcontext *context)
 {
     if (ply < 0 || ply > ENGINE_MAX_PLY)
         return ENGINE_ERROR_PLY;
+    start_evaluation();
     *context = aecSettings[SETTINGS_0PLY + ply];
     return ENGINE_OK;
 }
@@ -273,12 +292,13 @@ static const char *const level_names[ENGINE_LEVEL_COUNT] = {
     "beginner", "casual", "intermediate", "advanced", "0ply", "1ply", "2ply", "3ply", "4ply"
 };
 
-/* Réglages d'évaluation d'un niveau (bruit compris). */
+/* Réglages d'évaluation d'un niveau (bruit compris) ; prépare le calcul. */
 static engine_status
 eval_context_for_level(int level, evalcontext *context)
 {
     if (level < 0 || level >= ENGINE_LEVEL_COUNT)
         return ENGINE_ERROR_LEVEL;
+    start_evaluation();
     *context = aecSettings[level];
     return ENGINE_OK;
 }
@@ -845,6 +865,7 @@ engine_luck_of(const char *position_id, const char *match_id, int die1, int die2
         status = check_dice(die1, die2);
     if (status != ENGINE_OK)
         return status;
+    start_evaluation();
 
     /* LuckAnalysis (analysis.c l. 252-268) : dés rangés du plus fort au plus
      * faible ; LuckFirst à la position de départ hors doubles. */