SamilG2's picture
feat: sync deterministic coach module + COACH_MODEL dispatcher from develop
8ccac0b
Raw History Blame Contribute Delete
2.36 kB
"""Modelo Determinístico de Retroalimentación Estratégica — Experimento A (TA-003).
Contraparte del LLM (Experimento B, en modules/llm). Expone la MISMA firma
`comentar(move, clasificacion, history)` para ser intercambiable con Qwen en
routes/comment.py y comparable en el experimento (DO-002).
Pipeline:
historial ─► serie del jugador ─► estado recursivo (Markov)
─► patrón (reglas sobre features) ─► comentario (plantillas)
Es función PURA del historial: mismo input ⇒ mismo output, sin estado global ni
azar (RN-004).
"""
from modules.analysis.classifier import classify
from . import estado as estado_mod
from . import reglas, plantillas, tablero
def _serie_del_jugador(move: dict, clasificacion: str, history: list) -> list[tuple]:
"""Jugadas del MISMO color que la actual, en orden, incluyendo la actual.
La tendencia estratégica se mide sobre las jugadas del propio jugador, no
sobre los plies del rival intercalados.
"""
color = move["color"]
jugadas = [
(h.get("diferencia_cp", 0), classify(h.get("diferencia_cp", 0)), h.get("number", 0))
for h in history if h.get("color") == color
]
jugadas.append((move.get("diferencia_cp", 0), clasificacion, move.get("number", 0)))
return jugadas
def comentar(move: dict, clasificacion: str, history: list | None = None) -> dict:
"""Genera {corto, expandido} para una jugada analizando la secuencia hasta ella.
Args:
move: dict de Stockfish (number, color, diferencia_cp, ...).
clasificacion: categoría de la jugada actual (classify del diferencia_cp).
history: jugadas ANTERIORES de la partida (ambos colores); se filtra el
color propio internamente.
Returns:
{"corto": str, "expandido": str | None}
"""
history = history or []
jugadas = _serie_del_jugador(move, clasificacion, history)
estado = estado_mod.construir(jugadas)
# Reconstrucción del tablero a partir de la secuencia SAN completa (ambos
# colores), para aportar el contexto posicional al patrón.
sans = [h.get("move") for h in history] + [move.get("move")]
feats = tablero.features_tablero(sans, move["color"], move.get("number", 0))
patron = reglas.detectar_patron(estado, clasificacion, feats)
return plantillas.generar(patron, estado)