"""Hechos REALES de la mejor jugada (TA-002, expandido anclado a la posición). Calcula, con python-chess sobre la posición real, qué logra la `mejor_jugada` de Stockfish: si desarrolla, si va al centro, qué pieza rival ataca/captura, si da jaque o enroca. Devuelve una frase corta en español que el LLM usa como DATO (no inventa nada: todo sale del tablero). Se reconstruye la posición ANTES de la jugada del jugador (a partir del historial SAN), que es justo donde aplica la mejor jugada (Stockfish la calcula ahí). """ from __future__ import annotations import chess _PIEZA_ES = { chess.PAWN: "peón", chess.KNIGHT: "caballo", chess.BISHOP: "alfil", chess.ROOK: "torre", chess.QUEEN: "dama", chess.KING: "rey", } _HOME_MINOR = { chess.WHITE: {chess.B1, chess.G1, chess.C1, chess.F1}, chess.BLACK: {chess.B8, chess.G8, chess.C8, chess.F8}, } _CENTRO = {chess.D4, chess.E4, chess.D5, chess.E5} def _reconstruir(sans: list[str]) -> chess.Board | None: board = chess.Board() for san in sans: if not san: return None try: board.push_san(san) except (ValueError, AssertionError): return None return board def describe_best_move(history_sans: list[str], mejor_en: str | None, color_str: str) -> str | None: """Frase factual ('desarrolla tu caballo al centro y ataca el peón rival de e5') de lo que logra la mejor jugada. None si no se puede calcular —el expandido cae entonces a una explicación genérica.""" if not mejor_en: return None board = _reconstruir(list(history_sans)) if board is None: return None color = chess.WHITE if color_str == "white" else chess.BLACK if board.turn != color: # la posición debe estar al turno del jugador return None try: move = board.parse_san(mejor_en) except (ValueError, AssertionError): return None pieza = board.piece_at(move.from_square) if pieza is None: return None es_enroque = board.is_castling(move) es_captura = board.is_capture(move) and not board.is_en_passant(move) cap_tipo = board.piece_at(move.to_square).piece_type if es_captura else None desarrolla = (pieza.piece_type in (chess.KNIGHT, chess.BISHOP) and move.from_square in _HOME_MINOR[color]) board.push(move) da_jaque = board.is_check() dest = move.to_square central = dest in _CENTRO # Pieza rival más valiosa que la jugada ataca desde su nueva casilla. atacadas = [] for sq in board.attacks(dest): p = board.piece_at(sq) if p and p.color != color and p.piece_type != chess.KING: atacadas.append((p.piece_type, sq)) atacadas.sort(key=lambda t: t[0], reverse=True) # dama > torre > menor > peón # ── Redacción factual ───────────────────────────────────────────────────── if es_enroque: return "pone tu rey a salvo enrocando" nombre = _PIEZA_ES.get(pieza.piece_type, "pieza") if desarrolla and central: base = f"desarrolla tu {nombre} al centro" elif desarrolla: base = f"desarrolla tu {nombre}" elif central: base = f"lleva tu {nombre} al centro" else: base = f"coloca tu {nombre} en {chess.square_name(dest)}" extras = [] if cap_tipo is not None: extras.append(f"captura el {_PIEZA_ES.get(cap_tipo, 'pieza')} rival") elif atacadas: tipo, sq = atacadas[0] extras.append(f"ataca el {_PIEZA_ES.get(tipo, 'pieza')} rival de {chess.square_name(sq)}") if da_jaque: extras.append("da jaque") return base + (" y " + " y ".join(extras) if extras else "")