Derive canonical material Key from the FEN

The Endgame key is now a canonical, colour-agnostic material signature derived
from the FEN instead of a hand-typed field: each side's pieces, strongest side
first by material value (e.g. "KQ v KR"). This fixes the seed ordering
inconsistency and guarantees the key always matches the position.

- Add Chesstrainer.Key.from_fen/1.
- Compute the key in the Endgame changeset; drop the manual input and its
  regex validation.
- Index endgames.key and derive keys in the seeds.
- Document the Key term and the decision (ADR 0003).

Closes #13
This commit is contained in:
2026-11-02 09:22:01 +01:00
parent cd2e7f0164
commit ca65207baa
12 changed files with 258 additions and 47 deletions
+10
View File
@@ -0,0 +1,10 @@
# Canonical, colour-agnostic material Key for endgames
An endgame's `key` is derived from its FEN rather than typed by hand, as the
material signature of the start position: each side's pieces, strongest side
first by material value (`Q=9, R=5, B=3, N=3, P=1`) and colour-agnostic, so
`KQ v KR` is the same key whichever colour has the queen. Bishop square colour
is not encoded. We chose this over a white-vs-black ordering or a free-text key
so endgames with the same material group together regardless of colour, and so
the key can never drift from the position; side-to-move and outcome stay in the
`color` and `result` fields.