from modules.analysis.classifier import classify from modules.transcription.validator import translate_move_en_es # El entrenador SOLO comenta el patrón estratégico. La mejor jugada y la # evaluación numérica las muestra Stockfish por separado en la UI, así que el # modelo NO debe mencionarlas (de hecho no se las pasamos en el prompt). SYSTEM = ( "Eres un entrenador de ajedrez serio y didáctico, con un registro claro y " "profesional, como un buen profesor. Comentas las jugadas de tu alumno " "hablándole de 'tú' en una o dos oraciones precisas, explicando con rigor " "pero en lenguaje accesible la idea estratégica detrás de la jugada (control " "del centro, seguridad del rey, actividad de las piezas, iniciativa, " "estructura de peones). Mantén un tono sobrio y respetuoso: SIN exclamaciones " "efusivas, SIN emojis y SIN jerga ni coloquialismos. La prioridad es que la " "explicación sea correcta, concisa y fácil de entender. " "Reglas estrictas: responde SIEMPRE en español (nunca en otro idioma); NO " "menciones números ni evaluaciones; NO recomiendes ninguna jugada " "alternativa; nada de muletillas. Lo esencial es la idea estratégica " "expresada con claridad." ) # Clasificaciones que cuentan como "mala jugada" para detectar tendencia. _MALAS = {"Imprecisión", "Error"} _BUENAS = {"Brillante", "Excelente", "Buena"} def _tendencia(history: list, max_n: int = 4) -> str: """Resume la tendencia reciente en lenguaje natural (sin tokens de jugadas). En vez de pasar el historial crudo (que el modelo copiaba textual), le damos una señal de alto nivel: si viene fallando o jugando bien. Así el comentario considera la tendencia sin filtrar nombres de jugadas. """ recientes = [classify(h.get("diferencia_cp", 0)) for h in history[-max_n:]] if not recientes: return "Tendencia: es de las primeras jugadas, aún no hay patrón." malas = sum(1 for c in recientes if c in _MALAS) if malas >= 2: return "Tendencia: el jugador viene cometiendo varias imprecisiones seguidas." if malas == 0 and all(c in _BUENAS for c in recientes): return "Tendencia: el jugador venía jugando con precisión." return "Tendencia: el juego venía equilibrado, sin un patrón marcado." def _fase(numero: int) -> str: """Fase aproximada de la partida según el número de jugada. Señal simple y CONSISTENTE entre entrenamiento e inferencia, para que el modelo no hable de 'el final' en pleno medio juego (bug observado en la v1).""" if numero <= 10: return "apertura" if numero <= 25: return "medio juego" return "final" def build(move: dict, clasificacion: str, history: list | None = None) -> str: color_str = "Blancas" if move["color"] == "white" else "Negras" # La jugada llega en SAN inglés (board.san); el modelo debe verla en español # para no mezclar idiomas en su respuesta. jugada_es = translate_move_en_es(move["move"]) return ( f"{_tendencia(history or [])}\n" f"Fase: {_fase(move.get('number', 0))}.\n" f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. " f"Explica en una oración el mérito o el problema estratégico de esta jugada." ) # ── EXPANDIDO (botón "Explicar" / texto largo) ──────────────────────────────── # Rol distinto al corto: aquí SÍ puede nombrar la mejor jugada (que entrega # Stockfish) y explicar el porqué en 2-4 oraciones. Regla dura: solo la jugada # que se le pasa, nunca inventar. Es un SYSTEM aparte para no mezclar reglas # contradictorias con el corto. SYSTEM_EXPANDIDO = ( "Eres el mismo entrenador de ajedrez, serio y didáctico, y ahora EXPLICAS el " "error con calma y en palabras SENCILLAS, pensando en un jugador principiante o " "intermedio que quiere entender qué hizo mal. En 2 a 4 oraciones: (1) expón con " "claridad qué problema tuvo su jugada, (2) indícale qué jugada era mejor —solo la " "que se te indica— y por qué le convenía, y (3) cierra con una lección breve y " "fácil de recordar. Evita tecnicismos innecesarios; usa lenguaje cotidiano pero " "preciso. Reglas CRÍTICAS: usa ÚNICAMENTE la jugada que se te indica como mejor " "jugada (NUNCA inventes otra); y si se te dan datos de lo que esa jugada logra (a " "qué pieza ataca, qué casilla domina...), úsalos TAL CUAL y NO añadas piezas, " "casillas ni amenazas que no se te hayan dado. No menciones evaluaciones " "numéricas. Responde SIEMPRE en español, nunca en otro idioma. Mantén un tono " "sobrio y profesional, sin exclamaciones ni jerga; lo primero es que el alumno " "ENTIENDA su error." ) def build_expandido(move: dict, clasificacion: str, history: list | None = None, mejor_es: str | None = None, detalle: str | None = None) -> str: color_str = "Blancas" if move["color"] == "white" else "Negras" # La jugada jugada llega en SAN inglés; se traduce para que coincida con la # mejor jugada (mejor_es) y el modelo no mezcle notaciones/idiomas. jugada_es = translate_move_en_es(move["move"]) base = ( f"{_tendencia(history or [])}\n" f"Fase: {_fase(move.get('number', 0))}.\n" f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. " ) if clasificacion == "Brillante": return base + "Explica con palabras sencillas por qué esta jugada fue tan buena." if mejor_es: dato = f", que {detalle}" if detalle else "" return base + ( f"La mejor jugada era {mejor_es}{dato}. Explica con palabras sencillas " f"qué estuvo mal en tu jugada, por qué {mejor_es} era mejor (usa ese " f"dato), y deja una lección corta y fácil de recordar." ) return base + ( "Explica con palabras sencillas qué estuvo mal en esta jugada, qué idea " "era mejor, y deja una lección corta." )