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
+26
View File
@@ -40,6 +40,32 @@ defmodule Chesstrainer.FEN do
end
end
@doc """
Returns the position key for a FEN: the board, side to move, castling and
en-passant fields, with the halfmove and fullmove clocks dropped.
A tablebase answer depends only on the position, so two FENs that differ only
in their clocks resolve to the same position key and share a cache entry.
## Examples
iex> Chesstrainer.FEN.position_key("8/8/3k4/8/8/3K1R2/8/8 w - - 0 1")
"8/8/3k4/8/8/3K1R2/8/8 w - -"
iex> Chesstrainer.FEN.position_key("8/8/3k4/8/8/3K1R2/8/8 w - - 37 99")
"8/8/3k4/8/8/3K1R2/8/8 w - -"
"""
@spec position_key(String.t()) :: String.t()
def position_key(fen) when is_binary(fen) do
case String.split(fen) do
[board, active, castling, en_passant | _] ->
Enum.join([board, active, castling, en_passant], " ")
_ ->
String.trim(fen)
end
end
@doc """
Counts the pieces on the board, or returns `nil` if the board field is not a
well-formed FEN board.