"""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, }