Key the tablebase cache by position instead of full FEN (#28)

Add FEN.position_key/1 (board, side, castling and en-passant; clocks dropped) and have Tablebase.new/1 key cache reads and writes on it, so transpositions and clock-only differences share an entry. The Lichess category is a position property, so dropping the clocks is safe.

Update the cache docs and tests, and give the play fixture's after_first/after_losing distinct positions since they previously differed only by the halfmove clock.
This commit is contained in:
2026-11-03 13:09:45 +01:00
parent 515196857f
commit 3fadd4397c
6 changed files with 96 additions and 14 deletions
+7 -4
View File
@@ -1,17 +1,20 @@
defmodule Chesstrainer.Endgames.Tablebase.Cache do
@moduledoc """
A cache of tablebases by FEN.
A cache of tablebases keyed by position.
The key is a FEN's position fields (see `Chesstrainer.FEN.position_key/1`), so
transpositions and clock-only differences share an entry.
"""
alias Chesstrainer.Cache
@table :tablebase
def put(fen, tablebase), do: Cache.put(@table, fen, tablebase)
def put(key, tablebase), do: Cache.put(@table, key, tablebase)
def get(fen), do: Cache.get(@table, fen)
def get(key), do: Cache.get(@table, key)
def delete(fen), do: Cache.delete(@table, fen)
def delete(key), do: Cache.delete(@table, key)
def show, do: Cache.show(@table)
def size, do: Cache.size(@table)
end