SamilG2's picture
feat: sync deterministic coach module + COACH_MODEL dispatcher from develop
8ccac0b
Raw History Blame Contribute Delete
8.25 kB
"""Generación de lenguaje natural por plantillas (Experimento A — TA-003).
Cada patrón detectado mapea a un par de comentarios deterministas en español
(neutro, tuteo) con tono de entrenador y SIN recomendar jugadas (la mejor jugada
la muestra Stockfish por separado en la UI). Dos niveles:
- corto: 1–2 líneas, siempre visible junto al avatar.
- expandido: contexto de las jugadas previas que llevaron a este momento.
Categoría académica: NLG basada en plantillas (template-based generation).
"""
_PLANTILLAS = {
"caida_brusca": {
"corto": "Venías llevando bien la partida y aquí rompes el ritmo; cuidado con regalar lo que construiste.",
"expandido": "Tus últimas jugadas venían siendo sólidas, pero esta marca una caída brusca respecto a ese nivel. No es un problema de toda la partida sino un descuido puntual: frena, respira y retoma el plan que te venía funcionando.",
},
"deterioro_sostenido": {
"corto": "Llevas {racha} jugadas cediendo terreno de forma sostenida; esta agrava el patrón.",
"expandido": "No es un error aislado: tu evaluación viene bajando jugada tras jugada (ya acumulas {imprecisiones} imprecisiones y {errores} errores en la partida). La tendencia es de deterioro progresivo, así que conviene cortar la inercia y reordenar la posición antes de que el desgaste se vuelva decisivo.",
},
"rey_sin_enrocar": {
"corto": "Tu rey lleva varias jugadas sin enrocar y quedó expuesto en el centro.",
"expandido": "Vienes demorando el enroque y tu rey sigue en el centro, donde es vulnerable. Antes de seguir con otros planes, ponlo a salvo: la seguridad del rey es una prioridad de la apertura, y este error lo confirma.",
},
"sin_desarrollo": {
"corto": "Tus piezas siguen dormidas; llevas jugadas sin sacarlas al juego.",
"expandido": "Las jugadas previas descuidaron el desarrollo: tus caballos y alfiles siguen en casa. Sin piezas activas cuesta crear amenazas o defenderte; prioriza sacar las menores en vez de mover lo mismo dos veces.",
},
"cede_centro": {
"corto": "Vienes cediendo el control del centro jugada tras jugada.",
"expandido": "A lo largo de las últimas jugadas fuiste perdiendo presencia en el centro (d4/e4/d5/e5). Quien domina el centro dicta el juego; recupera esas casillas con peones o piezas antes de que tu rival se asiente ahí.",
},
"avance_enroque": {
"corto": "Estás empujando los peones que protegen a tu rey y debilitas su refugio.",
"expandido": "Adelantar los peones delante del rey enrocado abre líneas hacia tu propia posición. Salvo que sea un ataque muy concreto, conviene no tocar ese escudo de peones: cada avance deja huecos que el rival puede aprovechar.",
},
"dama_temprano": {
"corto": "Sacaste la dama demasiado pronto; el rival gana tiempo atacándola.",
"expandido": "Mover la dama temprano la expone: tu rival desarrolla sus piezas con tempo, atacándola y ganando ritmo. Mejor desarrolla primero caballos y alfiles, y reserva la dama para cuando la posición lo pida.",
},
"pieza_repetida": {
"corto": "Moviste la misma pieza otra vez en lugar de desarrollar nuevas.",
"expandido": "En la apertura cada tiempo cuenta. Volver a mover una pieza ya desarrollada, mientras otras siguen en casa, te hace perder ritmo de desarrollo. Saca una pieza nueva al juego en vez de reacomodar la misma.",
},
"caballo_borde": {
"corto": "Llevaste el caballo al borde, donde controla muy pocas casillas.",
"expandido": "Un caballo en la columna del borde (a/h) domina menos casillas que en el centro y suele quedar mal colocado. Salvo que vaya a una buena casilla concreta, conviene dirigir los caballos hacia el centro del tablero.",
},
"error_en_final": {
"corto": "En el final cada imprecisión pesa el doble, y aquí estás soltando ventaja.",
"expandido": "Estás en la fase final, donde los márgenes de error son mínimos y cada concesión cuesta caro. Una imprecisión que en el medio juego sería recuperable, en el final puede definir el resultado: juega con más cuidado y calcula hasta el final.",
},
"hallazgo": {
"corto": "Gran recurso táctico: encontraste algo por encima de tu línea habitual.",
"expandido": "Esta jugada destaca sobre el resto de tu partida: detectaste un recurso táctico que mejora claramente tu posición. Buen ojo; ese tipo de hallazgos son los que inclinan partidas parejas.",
},
"recuperacion": {
"corto": "Buena reacción: estás recuperando el control después de un tramo flojo.",
"expandido": "Después de unas jugadas por debajo de tu nivel, retomas el rumbo y tu evaluación vuelve a mejorar. Mantén esta concentración: salir de un mal tramo sin hundirte es una señal de solidez.",
},
"solidez": {
"corto": "Jugada sólida, mantienes el plan sin sobresaltos.",
"expandido": "Vienes sosteniendo un nivel parejo, sin concesiones importantes. No hay mucho que corregir aquí: sigue con la misma claridad de plan y sin apurarte.",
},
# Fallback por tipo de jugada (cuando no hay un patrón fuerte): evita el
# comentario genérico idéntico mencionando qué clase de jugada fue.
"leve_captura": {
"corto": "Esta captura no termina de favorecerte; cambiaste sin mejorar tu posición.",
"expandido": "Cambiar piezas no es malo en sí, pero aquí la captura entrega algo de ventaja sin una compensación clara. Antes de cambiar, fíjate si el cambio te conviene o si ayuda más al rival.",
},
"leve_peon": {
"corto": "Este avance de peón no aporta mucho y cede algo de precisión.",
"expandido": "Los avances de peón son permanentes: no se vuelven atrás y dejan casillas débiles. Este no mejora tu posición; en general conviene priorizar desarrollo y seguridad antes de mover peones sin un plan concreto.",
},
"leve_pieza": {
"corto": "Mueves la pieza, pero la jugada cede algo de precisión; quizá había algo mejor.",
"expandido": "La jugada no es grave, pero tu pieza queda algo menos activa de lo posible. Busca casillas donde tus piezas presionen el centro o las debilidades del rival, no solo una casilla cómoda.",
},
"leve_enroque": {
"corto": "El enroque no era el momento más preciso, aunque la posición sigue jugable.",
"expandido": "Enrocar casi siempre es bueno, pero el timing importa: aquí había algo un poco más exacto primero. De todos modos poner el rey a salvo rara vez es un error serio.",
},
"leve_otro": {
"corto": "Esta jugada cede algo de precisión, pero la partida sigue equilibrada.",
"expandido": "Es una pequeña concesión dentro de una partida que venías manejando bien. No es para alarmarse: registra el detalle y vuelve a tu plan en la próxima jugada.",
},
"desviacion_leve": {
"corto": "Esta jugada cede algo de precisión, pero la partida sigue equilibrada.",
"expandido": "Es una pequeña concesión dentro de una partida que venías manejando bien. No es para alarmarse: registra el detalle y vuelve a tu plan en la próxima jugada.",
},
"neutro": {
"corto": "Mantienes el equilibrio de la posición.",
"expandido": "La partida sigue su curso sin cambios estratégicos relevantes en este momento. Sigue atento a la evolución de la posición.",
},
}
_FALLBACK = {"corto": "Jugada registrada.", "expandido": None}
def generar(patron: str, estado) -> dict:
"""Rellena la plantilla del patrón con los valores del estado acumulado.
Devuelve {corto, expandido}. La interpolación usa solo enteros del estado
(racha, errores…), así que el texto es totalmente determinista.
"""
plantilla = _PLANTILLAS.get(patron, _FALLBACK)
ctx = {
"racha": estado.racha,
"errores": estado.errores,
"imprecisiones": estado.imprecisiones,
"fase": estado.fase,
}
expandido = plantilla["expandido"]
return {
"corto": plantilla["corto"].format(**ctx),
"expandido": expandido.format(**ctx) if expandido else None,
}