Files
chess-endgame-trainer/lib/chesstrainer/endgames/tablebase/router.ex
T
owenrees cb35351f8c Wire Fathom into the local tablebase backend (#30)
Add Backend.Fathom: probes positions with five or fewer pieces via the Fathom NIF, maps WDL/DTZ to the trainer structs (flipping per-move perspective), generates SAN, sorts moves best-first, and falls back to Lichess on any failure. The local directory is configured with TABLEBASE_PATH; local answers are no longer cached.

Add Tablebase.normalize_wdl/1 and flip/1, plus tests for the WDL mapping, SAN, checkmate, fallback, and a cache-free end-to-end local probe.
2026-11-03 14:23:46 +01:00

49 lines
1.6 KiB
Elixir

defmodule Chesstrainer.Endgames.Tablebase.Router do
@moduledoc """
Chooses a tablebase backend by piece count.
Positions with five or fewer pieces go to the local slot; six or seven go to
the remote slot. The local slot currently points at Lichess until the local
Syzygy backend lands, so this ships without changing today's behaviour.
Positions with eight or more pieces are beyond every tablebase and are
rejected without a network call.
"""
alias Chesstrainer.Endgames.Tablebase
alias Chesstrainer.Endgames.Tablebase.Backend.Fathom, as: FathomBackend
alias Chesstrainer.Endgames.Tablebase.Backend.Lichess
alias Chesstrainer.FEN
@max_local_pieces 5
@max_pieces 7
@local_backend FathomBackend
@remote_backend Lichess
@spec backend(String.t()) :: {:ok, module()} | {:error, :not_covered | :invalid_endgame}
def backend(fen) do
case FEN.piece_count(fen) do
count when is_integer(count) and count <= @max_local_pieces -> {:ok, @local_backend}
count when is_integer(count) and count <= @max_pieces -> {:ok, @remote_backend}
count when is_integer(count) -> {:error, :not_covered}
_ -> {:error, :invalid_endgame}
end
end
@doc """
True when the position is answered by the remote (Lichess) backend.
"""
@spec remote?(String.t()) :: boolean()
def remote?(fen), do: backend(fen) == {:ok, @remote_backend}
@spec probe(String.t()) ::
{:ok, Tablebase.t()} | {:cooldown, non_neg_integer()} | {:error, term()}
def probe(fen) do
case backend(fen) do
{:ok, backend} -> backend.probe(fen)
{:error, reason} -> {:error, reason}
end
end
end