"""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)