Files
chess-endgame-trainer/lib/mix/tasks/themes.derive_material.ex
T
owenrees 946fc38756 Derive disjoint material family themes from each endgame's Key (#193)
Every endgame now belongs to exactly one material family derived from its Key:
pawn, rook, rook and pawn, queen, queen and pawn, minor piece, minor piece and
pawn, basic mate, king and pawn, or bare king other. The bare-king families are
split out because those positions teach a mating or promotion technique rather
than a general material class.

Family membership is objective, so a derivation pass owns links to its themes:
refreshing rewrites them as derived and removes a curated link that contradicts
the family, while technique themes are untouched. Re-running is idempotent.

A mix task applies the mapping to the whole library. Seeds add the king
technique themes for later human tagging.

Closes #186
2026-11-17 21:18:11 +01:00

32 lines
900 B
Elixir

defmodule Mix.Tasks.Themes.DeriveMaterial do
use Mix.Task
@shortdoc "Tags every endgame with its material family theme"
@moduledoc """
Derives each endgame's material family from its Key and stores the result as
a derived theme.
mix themes.derive_material
Every endgame belongs to exactly one family, so the themes partition the
library. Re-running is idempotent: only derived links are replaced, and
curated or community links are untouched.
Positions that are kings only, or that have no Key, are reported as skipped.
"""
@impl Mix.Task
def run(_args) do
Mix.Task.run("app.start")
%{tagged: tagged, skipped: skipped, themes: themes} =
Chesstrainer.Endgames.MaterialThemes.derive()
Mix.shell().info(
"Material themes: #{themes} themes, #{tagged} endgames tagged, " <>
"#{skipped} skipped (kings only or no Key)."
)
end
end