xonecode 0.38.15 → 0.38.31

package/dist/agent/motores/trueforge/sesionTrueforge.js

@@ -25,7 +25,7 @@
  */
 import { TOPE_DE_PREGUNTAS_CONTESTADAS_SOLAS, opcionRecomendada } from "../../../core/modoDeEscritura.js";
 import { claseDeTrabajo } from "../../../core/esfuerzo.js";
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import winston from "winston";
 import { AgentThread, AgentThreadOrchestrator, EventType, NOOP_AGENT_TRACING, askUserQuestion, contextCompaction, dynamicSubAgents } from "./trueforge.js";
@@ -37,7 +37,7 @@ import { sumarPorModelo } from "../../../core/actos.js";
 import { ColaDeEventos, entrelazar } from "../../../core/entrelazar.js";
 import { modeloExternoParaTrueforge } from "./modeloExterno.js";
 import { diferenciasDelContraste, metricasDeTrueforge } from "./metricasTrueforge.js";
-import { respuestaEnChinoSinPedirlo, textoDeReescritura } from "../../../core/idiomaDeLaRespuesta.js";
+import { respuestaEnChinoSinPedirlo, TOPE_DE_RECORDATORIOS_DE_IDIOMA, textoDeReescritura, textoDeRecordatorioDeIdioma, textoEnInglesSinPedirlo, } from "../../../core/idiomaDeLaRespuesta.js";
 import { cambiosQueSeVerifican, huellaDeErrores, repartirHallazgos, textoDeReparacion, tocaCriticarPantalla, TOPE_REPARACIONES } from "../../turno/verificacion.js";
 import { correrTurno } from "../../../core/turno.js";
 import { createTokenTracker } from "../../../vendor/tokenTracking.js";
@@ -45,7 +45,9 @@ import { MAX_APPROVAL_ROUNDS } from "../../../vendor/hitl.js";
 import { artefactosNuevos, backendDeAgente, entornoDeLaShellDelProyecto, fotoDeArtefactos, lectorDelDispositivoDeSesion, scriptsDeLasSkills } from "../../grafo/proyecto.js";
 import { carpetaDeHotswap } from "../../../core/hotswap.js";
 import { cargarAgentes } from "../../subagentes/agentesEnDisco.js";
-import { fichaDeAgente, promptDeAgente, recibeMarcarCriterios, repartirSkills } from "../../../core/agentes.js";
+import { bloqueDeAprendido, NOMBRE_APUNTAR_APRENDIZAJE, USO_DE_APRENDIDO_EXTERNO, USO_DE_APUNTAR_APRENDIZAJE } from "../../../core/aprendido.js";
+import { crearApuntarAprendizaje, leerAprendido } from "../../grafo/aprendido.js";
+import { fichaDeAgente, promptDeAgente, recibeMarcarCriterios, recibeNucleoDeTrabajo, repartirSkills, skillsConLasDeQuienLlama, textoDeCarpetasDeLaSesion, textoDeTrabajoSinLlamar } from "../../../core/agentes.js";
 import { PERFIL_DEL_ORQUESTADOR, promptOrquestador } from "../../grafo/xoneAgent.js";
 import { permisosDe, seDetieneEn, TEXTO_HITL } from "../../grafo/perfiles.js";
 import { cambioDe } from "../../turno/interrupts.js";
@@ -65,6 +67,7 @@ import { avisoDeReparto } from "../../../core/repartoDeEncargo.js";
 import { leerTareasDelPlan, RUTA_DE_TASKS } from "../../../core/tareasDelPlan.js";
 import { esDeLaMaqueta } from "../../../core/stitch.js";
 import { recibeConectores } from "../../../core/conectores.js";
+import { crearConvertirAP, NOMBRE_CONVERTIR_A_P, recibeConvertirAP } from "./convertirAP.js";
 import { buscarMaqueta, medirContraMaqueta, resumenDeMedida, textoDeMedidaAutomatica, ultimaCaptura } from "./medidaAutomatica.js";
 import { anotarEscritura, capacidadDeInformesDeHijos, esEscrituraBinaria, escrituraConExito, textoDelInforme } from "./informesDeHijos.js";
 import { crearDiagnosticoDeTools } from "../../turno/diagnosticoDeTools.js";
@@ -72,7 +75,8 @@ import { encenderTrazaDeErrores } from "../../trazaDeErroresEnDisco.js";
 import { anotarPaso } from "../../../core/trazaDeErrores.js";
 import { entornoConDepuracion } from "../../turno/depuracion.js";
 import { detalleDe, parametrosDe } from "../../turno/resumenDeTool.js";
-import { lineaDeComprobacion, soloDocumentacion, TOPE_DE_COMPROBACIONES_AL_JUEZ } from "../../../core/entrega.js";
+import { lineaDeComprobacion, omisionExplicada, soloDocumentacion, TOPE_DE_COMPROBACIONES_AL_JUEZ } from "../../../core/entrega.js";
+import { bloqueantesDelInforme } from "../../../core/geometriaDePantalla.js";
 import { apartarMemoria, cargarMemoria, fotoSaneada, guardarMemoria, saldarColgadas, textoDeInterrupcion, textoDeMemoriaDescartada } from "./memoriaTrueforge.js";
 import { crearNota, sobrantes } from "./notas.js";
 import { crearMemoriaDeEspecialistas } from "./memoriaDeEspecialistas.js";
@@ -126,6 +130,22 @@ const BUCLE_DE_CALIDAD = [
     "repite. Para cuando la distancia estructural baje del 10 % en vertical y en horizontal y el crítico no señale diferencias de forma con el diseño, o tras TRES vueltas, y",
     "di lo que sigue faltando en vez de darlo por hecho.",
 ].join("\n");
+/**
+ * Cuando quien MAQUETA es un hijo de Claude Code con ejecución, el bucle lo hace ÉL: despliega, captura, compara con la
+ * maqueta y corrige (`textoDeTrabajoSinLlamar`). Medido en Maset: el orquestador, con `BUCLE_DE_CALIDAD`, volvía a pasar el
+ * crítico y le encargaba otra vuelta —y otra al diseñador por un SVG—, y cada vuelta era un Claude Code NUEVO que releía
+ * todo: unos quince minutos cada una, con las piezas ya bien. Dos bucles uno encima de otro.
+ */
+export function textoDeMaquetadorExterno(nombres) {
+    return [
+        `${nombres.join(", ")} corre en Claude Code con su shell: despliega, captura, COMPARA con la maqueta y CORRIGE él mismo hasta`,
+        "cumplir. Con él: dale en UN encargo el diseño, la tabla de recursos y el criterio; a su vuelta pasa el crítico UNA vez, y solo",
+        "vuelve a encargarle si queda algo BLOQUEANTE (una pieza que falta, algo tapado o fuera de pantalla) o que él no comprobó. Las",
+        "diferencias de detalle van en tu resumen final, no en otra vuelta: cada vuelta suya empieza de cero. Si un recurso del",
+        "diseñador está mal (proporción, color, un icono equivocado), díselo a él y que lo corrija en esa misma vuelta: puede escribir en",
+        "`icons/`, y otra ronda diseñador → desarrollador cuesta dos arranques.",
+    ].join("\n");
+}
 /**
  * Lo que el orquestador tiene que saber para DELEGAR en ESTE motor. Su prompt es el de siempre
  * (`promptOrquestador`), que habla de `task` y de la ficha que va en su descripción: aquí la
@@ -161,6 +181,41 @@ export const SIN_HABLAR_DEL_HARNESS = "CON QUIÉN HABLAS: con un desarrollador d
     "DE ANÁLISIS…), la foto o el contexto que te llega al empezar, ni lo que vas a medir o no: cuéntale lo que encontraste, " +
     "lo que hiciste en su proyecto y lo que necesitas de él. Si pregunta cómo trabajas, entonces sí.";
 /** Lo que recibe el agente en modo autónomo cuando pregunta sin marcar ninguna opción como recomendada. */
+/**
+ * Al raíz de una TAREA DE FONDO (`trabajoSinPersona`). Preguntar no está prohibido —la pregunta se contesta sola con su
+ * recomendada, y pasado el tope aparca la tarea—, pero cada una es una parada: se le pide decidir antes. Y como nadie
+ * ha visto el trabajo, la respuesta final es lo que la persona leerá: un resumen con lo que decidió sin preguntar.
+ */
+export const TRABAJO_SIN_PERSONA = [
+    "TAREA DE FONDO: trabajas SIN nadie delante; la persona leerá el resultado cuando acabes.",
+    "- Resuelve tú las dudas: elige la opción más razonable con lo que dicen el encargo, el plan y el proyecto, y sigue.",
+    "  Pregunta solo si sin la respuesta no puedes hacer nada útil; si preguntas, marca tu opción recomendada con",
+    "  `(Recommended)`: se contestará sola con ella.",
+    "- Tu RESPUESTA FINAL es el resumen de la tarea, en tres apartados: lo que cambiaste (cada fichero y para qué), las",
+    "  DECISIONES que tomaste tú sin preguntar (cada duda, lo que elegiste y por qué) y lo que no pudiste comprobar o",
+    "  queda pendiente.",
+].join("\n");
+/**
+ * Lo aprendido, para el ORQUESTADOR: lo que hay apuntado y cuándo apuntar él. Le toca sobre todo lo que le cuente un
+ * hijo de motor externo en su apartado «Aprendido:» (ese hijo no tiene la tool).
+ */
+export function textoDeAprendidoDelRaiz(lista) {
+    return [
+        bloqueDeAprendido(lista),
+        `${USO_DE_APUNTAR_APRENDIZAJE} Y si un especialista te devuelve un apartado «Aprendido:», apúntalo tú.`,
+    ]
+        .filter((l) => l !== undefined)
+        .join("\n");
+}
+/**
+ * La respuesta a una pregunta del agente cuando nadie la contesta y tenía opción recomendada. No es la opción a secas:
+ * medido en Maset, con solo «Opción A (Recommended)» el agente cerraba diciendo «lo decidiste tú», como si la hubiera
+ * elegido la persona. Es SU recomendación aplicada, y así tiene que contarla.
+ */
+export function respuestaAutonomaRecomendada(elegida) {
+    return (`Nadie ha contestado (modo autónomo): se aplica TU opción recomendada, «${elegida}». No la eligió el usuario: ` +
+        "cuéntala en tu respuesta final entre las decisiones que tomaste tú sin preguntar.");
+}
 export const RESPUESTA_AUTONOMA_SIN_RECOMENDADA = "Modo autónomo: no hay nadie a quien preguntar. Decide tú con lo que dicen el encargo y el plan, sigue, y di en tu respuesta final qué elegiste y por qué.";
 /** Un comando que saca una captura de pantalla del aparato. */
 export const COMANDO_DE_CAPTURA = /xone-captura-android|xone-hotswap\s+shot\b|\bscreencap\b/;
@@ -328,6 +383,11 @@ export function notaDeDelegacion(agentes, opciones = {}) {
         "entiende `create_sub_agent` y `name`. Las fichas de los especialistas:",
         ...agentes.map((a) => `- ${a.nombre}: ${fichaDeAgente(a, opciones)}`),
         ...(opciones.conComparacion === true ? ["", BUCLE_DE_CALIDAD] : []),
+        // Si quien maqueta corre en Claude Code con su shell, el bucle es SUYO: el orquestador no lo repite encima.
+        ...(() => {
+            const externos = agentes.filter((a) => a.motor === "claude-code" && a.ejecucion === true && !a.soloLectura).map((a) => a.nombre);
+            return opciones.conComparacion === true && externos.length > 0 ? ["", textoDeMaquetadorExterno(externos)] : [];
+        })(),
         ...(opciones.conEsperas === true
             ? [
                 "",
@@ -380,6 +440,13 @@ const LIMITES_DE = {
  */
 export const USO_DE_XONE_ATRIBUTOS = "Para saber si un atributo XML existe en un nodo (coll, group, frame, prop) y qué hace, pregunta PRIMERO a `xone_atributos`: " +
     "contesta en una línea desde las tablas de la skill. Lee la referencia de la skill solo si no lo encuentra, o si necesitas ejemplos o matices.";
+/**
+ * CUÁNDO convertir las medidas de una maqueta, por lo mismo que `USO_DE_XONE_ATRIBUTOS`: una tool nombrada solo en la
+ * lista no se usa. Medido en Maset: con la regla en la skill, el desarrollador copió los px de la maqueta como `p` y los
+ * iconos salieron unas 2,6 veces más pequeños.
+ */
+export const USO_DE_CONVERTIR_A_P = "Los px de una maqueta (su code.html, su imagen) NO son p: toda medida que copies de ella —anchos, altos, márgenes, " +
+    "paddings, tamaño de iconos— pasa ANTES por `convertir_a_p`, todas de una vez, y escribes lo que devuelve.";
 export function notaDeTools(nombres, limite) {
     return `NOTA DEL HARNESS: aunque tu identidad diga lo contrario, NO tienes las mismas tools que quien te delega. Tienes ${nombres
         .map((n) => `\`${n}\``)
@@ -437,6 +504,25 @@ function preguntaDeLaFoto(foto) {
     };
 }
 const claveDe = (hilo, id) => `${hilo}:${id}`;
+/**
+ * ¿Cambió algún fichero del proyecto (fuera de `.xonecode/`) después de `desde`? Por la hora de modificación del disco,
+ * que es lo que vale para los dos motores: un hijo de Claude Code escribe con sus tools y no pasa por las nuestras. Lo
+ * que no se puede mirar no cuenta como cambio.
+ */
+export function cambioDespuesDe(raiz, desde) {
+    for (const virtual of ficherosDelProyecto(raiz)) {
+        if (virtual.startsWith("/.xonecode/"))
+            continue;
+        try {
+            if (statSync(join(raiz, virtual)).mtimeMs > desde)
+                return true;
+        }
+        catch {
+            // Borrado entre medias, o sin permiso: no se afirma nada.
+        }
+    }
+    return false;
+}
 /**
  * `agregarNota` no vive todavía en `SesionReal` (IXCODE-4, Task 6 se la añade ahí como opcional,
  * compartida con deepagents): se ensancha el tipo de retorno AQUÍ, en vez de esperar a esa task,
@@ -554,6 +640,9 @@ export async function abrirSesionTrueforge(opciones) {
     let capturasDelTurno = [];
     /** Lo que dieron las comprobaciones visuales del turno, una línea cada una, para el juez de QA (`ResultadoDeTurno`). */
     let comprobacionesDelTurno = [];
+    let bloqueantesVisualesDelTurno = [];
+    // Cuándo llegó esa crítica: si el proyecto cambia DESPUÉS, sus bloqueantes ya no son la pantalla final (`cambioDespuesDe`).
+    let horaDeLaUltimaCritica;
     const anotarComprobacion = (linea) => {
         comprobacionesDelTurno = [...comprobacionesDelTurno, linea].slice(-TOPE_DE_COMPROBACIONES_AL_JUEZ);
     };
@@ -577,6 +666,30 @@ export async function abrirSesionTrueforge(opciones) {
     const detencion = crearControlDeDetencion(HILO_RAIZ);
     /** Tool calls tiradas por DETENER en la sesión: si se queda en cero, el filtro es solo red. */
     let llamadasTiradasPorDetener = 0;
+    /**
+     * **El recordatorio del idioma**, para el raíz que escribe en INGLÉS entre herramientas (`textoEnInglesSinPedirlo`,
+     * medido en Maset). Lo pone el turno al cerrarse un mensaje suyo, y entra como mensaje de usuario antes de su siguiente
+     * llamada —la del raíz, no la de un hijo—; como mucho `TOPE_DE_RECORDATORIOS_DE_IDIOMA` por turno.
+     */
+    let recordatorioDeIdioma;
+    let recordatoriosEnElTurno = 0;
+    const capacidadDeIdioma = {
+        nombre: "idioma",
+        tools: [],
+        capability: {
+            preLLMProcessors: [
+                {
+                    async *processPreLLM() {
+                        const texto = recordatorioDeIdioma;
+                        if (texto === undefined)
+                            return;
+                        recordatorioDeIdioma = undefined;
+                        yield { type: "internal.agent.context.append", context: [{ role: "user", content: texto }], output: [] };
+                    },
+                },
+            ],
+        },
+    };
     const capacidadDeNotasDeLaSesion = capacidadDeNotas(notas, {
         detencion,
         nombreDe: (h) => quienEs.get(h) ?? h,
@@ -783,6 +896,8 @@ export async function abrirSesionTrueforge(opciones) {
         ...herramientasDeJuicio(),
         ...(carpeta === undefined ? [] : [crearTraerDeLaMaquina({ carpeta, alEscribir: anotarArtefacto })]),
         ...traerDeStitch(),
+        // Lo aprendido: el orquestador también apunta, sobre todo lo que le cuenta un hijo de motor externo (que no tiene la tool).
+        crearApuntarAprendizaje({ raiz, quien: "orquestador" }),
         ...(opciones.puedeProponerTareas === true
             ? [crearProponerTareas((p) => void propuestasPorAnunciar.push(p))]
             : []),
@@ -820,11 +935,23 @@ export async function abrirSesionTrueforge(opciones) {
             : []),
         // Fondos SVG: pura y sin red, sin puerto; a quien escribe el proyecto, como deepagents.
         ...(recibeGenerarFondo(agente) ? [crearGenerarFondoSvg()] : []),
+        // Las medidas de una maqueta a `p`: pura, a quien escribe el proyecto. La resolución la lee del app.xml de la raíz.
+        ...(recibeConvertirAP(agente)
+            ? [
+                crearConvertirAP({
+                    raiz,
+                    ...(carpeta === undefined ? {} : { artefactos: carpeta }),
+                    ...(opciones.adjuntos === undefined ? {} : { adjuntos: opciones.adjuntos }),
+                }),
+            ]
+            : []),
         // ¿Cambió la zona tras el toque? Al conductor, que es quien saca las capturas: comprueba una
         // ACCIÓN suya, no juzga la pantalla (eso sigue siendo del crítico y de `comparar_capturas`).
         ...(carpeta !== undefined && agente.ejecucion === true
             ? [crearDiferenciaDeCapturas({ leerArtefacto: async (nombre) => readFileSync(join(carpeta, nombre)) })]
             : []),
+        // Lo aprendido del proyecto y del aparato, para los encargos siguientes: a quien trabaja (`recibeNucleoDeTrabajo`).
+        ...(recibeNucleoDeTrabajo(agente) ? [crearApuntarAprendizaje({ raiz, quien: agente.nombre })] : []),
         // Y marcar en el plan lo comprobado, con el reparto de deepagents (`recibeMarcarCriterios`).
         ...(recibeMarcarCriterios(agente) ? [crearMarcarCriteriosDelPlan({ raiz })] : []),
         // El BUCLE del desarrollador: quien puede llamar al de pruebas también tiene el crítico y la medida, para
@@ -890,13 +1017,18 @@ export async function abrirSesionTrueforge(opciones) {
          * su nombre; el entorno de NUESTRA shell; y la lectura de ESTAS dos carpetas de la sesión, que
          * es donde sus scripts dejan las capturas. Codex y OpenCode siguen sin shell.
          */
-        const ejecucion = agente.ejecucion === true && motor === "claude-code" && carpeta !== undefined
+        const conEjecucion = agente.ejecucion === true && motor === "claude-code" && carpeta !== undefined;
+        // Con ejecución, también las skills de a quien llamaría: no puede llamarlo, así que lo hace él (`skillsConLasDeQuienLlama`).
+        const delHijo = conEjecucion ? { ...agente, skills: skillsConLasDeQuienLlama(agente, especialistas()) } : agente;
+        const ejecucion = conEjecucion
             ? {
-                scripts: scriptsDeLasSkills(raiz, agente.skills),
+                scripts: scriptsDeLasSkills(raiz, delHijo.skills),
                 entorno: entornoDeLaShellDelProyecto(raiz, carpeta),
                 lecturas: [carpeta, carpetaDeHotswap(carpeta)],
             }
             : undefined;
+        // Las carpetas de la sesión se LEEN aunque no ejecute: es donde el orquestador le deja la maqueta y las capturas.
+        const lecturasDeSesion = motor === "claude-code" && carpeta !== undefined ? [carpeta, carpetaDeHotswap(carpeta)] : undefined;
         /**
          * Lo que sus comandos dejen en `/artefactos/` se ANUNCIA al volver, con la MISMA foto que nuestra
          * shell (`fotoDeArtefactos`): por nuestra shell se anunciaba y por la suya no, y una captura
@@ -929,12 +1061,23 @@ export async function abrirSesionTrueforge(opciones) {
                     peticion: () => ({
                         motor,
                         cwd: raiz,
-                        instrucciones: `${promptDeAgente(agente, repartirSkills(agente, disponibles))}\n\n${inventarioDelProyecto(ficherosDelProyecto(raiz))}`,
+                        instrucciones: [
+                            promptDeAgente(delHijo, repartirSkills(delHijo, disponibles)),
+                            ...(conEjecucion && (agente.llama ?? []).length > 0 ? [textoDeTrabajoSinLlamar(agente.llama ?? [], carpeta)] : []),
+                            ...(lecturasDeSesion === undefined ? [] : [textoDeCarpetasDeLaSesion(lecturasDeSesion[0], lecturasDeSesion[1])]),
+                            ...[bloqueDeAprendido(leerAprendido(raiz))].filter((b) => b !== undefined),
+                            USO_DE_APRENDIDO_EXTERNO,
+                            inventarioDelProyecto(ficherosDelProyecto(raiz)),
+                        ].join("\n\n"),
                         tarea: params.request.input,
                         ...(agente.modelo === undefined ? {} : { modelo: agente.modelo }),
                         permitirEscritura: !agente.soloLectura,
                         agente: agente.nombre,
+                        skills: repartirSkills(delHijo, disponibles).suyas,
                         ...(ejecucion === undefined ? {} : { ejecucion }),
+                        ...(lecturasDeSesion === undefined ? {} : { lecturas: lecturasDeSesion }),
+                        // El esfuerzo de su `.md`, que Claude Code aplica como `effort`; los otros dos no tienen dónde recibirlo.
+                        ...(motor === "claude-code" && agente.esfuerzo !== undefined ? { esfuerzo: agente.esfuerzo } : {}),
                     }),
                     senal: () => aborto?.signal,
                 }),
@@ -1006,6 +1149,8 @@ export async function abrirSesionTrueforge(opciones) {
             notas: capacidadDeNotasDeLaSesion,
             puedeLlamar: (a) => conBucleDelDesarrollador && (a.llama?.length ?? 0) > 0,
             informes: capacidadDeInformes,
+            // Una tarea de fondo no tiene a quién preguntar: sus escrituras locales no esperan al control de la librería.
+            ...(opciones.trabajoSinPersona === true ? { escribeSinPreguntar: true } : {}),
             vueltas: (a) => a.ejecucion === true
                 ? capacidadDeAvisoDeVueltas({ vueltasDe: (hilo) => capturasDeCadaHilo.get(hilo) ?? 0, umbrales: UMBRALES_DE_CAPTURAS, texto: textoDeCapturas })
                 : conBucleDelDesarrollador && (a.llama?.length ?? 0) > 0
@@ -1025,7 +1170,11 @@ export async function abrirSesionTrueforge(opciones) {
         const nota = [
             notaDeTools(nombres, agente === undefined ? LIMITE_DEL_GENERICO : LIMITES_DE[clase]),
             ...(nombres.includes(NOMBRE_ATRIBUTOS_XONE) ? [USO_DE_XONE_ATRIBUTOS] : []),
+            ...(nombres.includes(NOMBRE_CONVERTIR_A_P) ? [USO_DE_CONVERTIR_A_P] : []),
+            ...(nombres.includes(NOMBRE_APUNTAR_APRENDIZAJE) ? [USO_DE_APUNTAR_APRENDIZAJE] : []),
         ].join("\n");
+        // Lo aprendido en encargos anteriores, leído AHORA (otro encargo pudo apuntar algo hace un momento).
+        const aprendido = bloqueDeAprendido(leerAprendido(raiz));
         const instrucciones = agente === undefined
             ? `${IDIOMA_DEL_ESPECIALISTA}\n\n${nota} Contesta con lo que encuentres y dónde.`
             : [
@@ -1035,6 +1184,7 @@ export async function abrirSesionTrueforge(opciones) {
                 "",
                 nota,
                 anuncioDeSkills(agente, catalogo),
+                ...(aprendido === undefined ? [] : ["", aprendido]),
                 ...(conBucleDelDesarrollador && (agente.llama?.length ?? 0) > 0 ? ["", textoDelBucle(agente.llama ?? [], { conCritica: carpeta !== undefined, conFuentes: opciones.fuentes !== undefined })] : []),
             ]
                 .filter((l) => l !== undefined)
@@ -1130,7 +1280,7 @@ export async function abrirSesionTrueforge(opciones) {
         hijosConMemoria.clear();
         const definicion = {
             modelClient: llm,
-            instruction: [IDIOMA_DE_LA_RESPUESTA, SIN_HABLAR_DEL_HARNESS, promptOrquestador(especialistas()), notaDeDelegacion(especialistas(), { conIconos: opciones.iconos !== undefined, conFuentes: opciones.fuentes !== undefined, conComparacion: carpeta !== undefined, conMemoria: conMemoriaDeEspecialistas, conBucle: conBucleDelDesarrollador, conEsperas }), opciones.puedeProponerTareas === true ? REPARTIR_EN_TAREAS : ""].filter((l) => l !== "").join("\n\n"),
+            instruction: [IDIOMA_DE_LA_RESPUESTA, SIN_HABLAR_DEL_HARNESS, promptOrquestador(especialistas()), notaDeDelegacion(especialistas(), { conIconos: opciones.iconos !== undefined, conFuentes: opciones.fuentes !== undefined, conComparacion: carpeta !== undefined, conMemoria: conMemoriaDeEspecialistas, conBucle: conBucleDelDesarrollador, conEsperas }), opciones.puedeProponerTareas === true ? REPARTIR_EN_TAREAS : "", opciones.trabajoSinPersona === true ? TRABAJO_SIN_PERSONA : "", textoDeAprendidoDelRaiz(leerAprendido(raiz))].filter((l) => l !== "").join("\n\n"),
             // Por TURNO, porque el raíz se rehace desde su foto al final de cada uno (ver `turno`).
             iterationLimit: LIMITE_DE_LLAMADAS_DEL_RAIZ,
         };
@@ -1149,6 +1299,7 @@ export async function abrirSesionTrueforge(opciones) {
                     capacidadDeFecha(),
                     capacidadDeNotasDeLaSesion,
                     capacidadDeInformes,
+                    capacidadDeIdioma,
                 ]),
                 /**
                  * **La conversación se RESUME a un umbral que depende de la ventana del modelo**
@@ -1354,6 +1505,12 @@ export async function abrirSesionTrueforge(opciones) {
                 // Las comprobaciones VISUALES, para el juez: lo que dijeron, medido aquí y no contado por el agente.
                 if (llamada !== undefined && (llamada.nombre === NOMBRE_COMPARAR_CAPTURAS || llamada.nombre === "xone_critica_visual") && typeof evento.content === "string") {
                     anotarComprobacion(lineaDeComprobacion(llamada.nombre, detalleDe(llamada.nombre, llamada.args), evento.content));
+                    // Lo BLOQUEANTE de la ÚLTIMA crítica: es el estado final de la pantalla, y el cierre de una tarea lo pone en
+                    // su `## CRITICAL` (`bloqueantesDelInforme`).
+                    if (llamada.nombre === "xone_critica_visual") {
+                        bloqueantesVisualesDelTurno = bloqueantesDelInforme(evento.content);
+                        horaDeLaUltimaCritica = Date.now();
+                    }
                 }
                 const chars = typeof evento.content === "string" ? evento.content.length : 0;
                 diagnostico?.resultado?.(llamada?.nombre, llamada === undefined ? undefined : detalleDe(llamada.nombre, llamada.args), chars);
@@ -1476,6 +1633,8 @@ export async function abrirSesionTrueforge(opciones) {
                 throw new Error("la sesión está cerrada");
             const t0 = Date.now();
             cancelado = false;
+            recordatoriosEnElTurno = 0;
+            recordatorioDeIdioma = undefined;
             detencion.reiniciar();
             const instantanea = await tomarInstantanea(raiz, opciones.entorno.git);
             const tope = opciones.topeDeRondas ?? MAX_APPROVAL_ROUNDS;
@@ -1486,6 +1645,8 @@ export async function abrirSesionTrueforge(opciones) {
             externosDelTurno = 0;
             capturasDelTurno = [];
             comprobacionesDelTurno = [];
+            bloqueantesVisualesDelTurno = [];
+            horaDeLaUltimaCritica = undefined;
             /** El encargo de ESTE turno tal cual se pidió, y el mismo con la última pregunta y su
              *  respuesta al lado, que es lo que se juzga y se repara (ver `flujo`). Ausente = no consta. */
             let encargoDelTurno;
@@ -1531,7 +1692,7 @@ export async function abrirSesionTrueforge(opciones) {
                          * recomendada, la otra no— y no se contestó ninguna, se enseñó solo la primera y la segunda se perdió. Con
                          * tope, para que no dé vueltas.
                          */
-                        if (preguntas.length > 0 && opciones.sinAprobacion?.() === true && preguntasSolas + preguntas.length <= TOPE_DE_PREGUNTAS_CONTESTADAS_SOLAS) {
+                        if (preguntas.length > 0 && (opciones.trabajoSinPersona === true || opciones.sinAprobacion?.() === true) && preguntasSolas + preguntas.length <= TOPE_DE_PREGUNTAS_CONTESTADAS_SOLAS) {
                             preguntasSolas += preguntas.length;
                             const respuestas = [];
                             for (const q of preguntas) {
@@ -1543,7 +1704,7 @@ export async function abrirSesionTrueforge(opciones) {
                                     type: "user.tool_response",
                                     thread_id: q.hilo,
                                     tool_call_id: q.id,
-                                    content: elegida ?? RESPUESTA_AUTONOMA_SIN_RECOMENDADA,
+                                    content: elegida === undefined ? RESPUESTA_AUTONOMA_SIN_RECOMENDADA : respuestaAutonomaRecomendada(elegida),
                                 });
                             }
                             lote = respuestas;
@@ -1719,8 +1880,17 @@ export async function abrirSesionTrueforge(opciones) {
                             mensajeCerrado = false;
                             ultimoMensaje += evento.texto;
                         }
-                        else if (evento.tipo !== "razonamiento")
+                        else if (evento.tipo !== "razonamiento") {
+                            // Un mensaje del raíz se CIERRA aquí: si salió en inglés y el usuario no escribe en inglés, su siguiente
+                            // llamada lleva el recordatorio (`capacidadDeIdioma`). Sin reescribir lo dicho.
+                            if (!mensajeCerrado &&
+                                recordatoriosEnElTurno < TOPE_DE_RECORDATORIOS_DE_IDIOMA &&
+                                textoEnInglesSinPedirlo(ultimoMensaje, encargoDelTurno ?? peticion)) {
+                                recordatoriosEnElTurno += 1;
+                                recordatorioDeIdioma = textoDeRecordatorioDeIdioma(encargoDelTurno ?? peticion);
+                            }
                             mensajeCerrado = true;
+                        }
                         yield evento;
                     }
                     /**
@@ -1811,6 +1981,9 @@ export async function abrirSesionTrueforge(opciones) {
                      */
                     let observacionesVisuales = [];
                     if (carpeta !== undefined &&
+                        // Si el turno ya pasó `xone_critica_visual` (con la maqueta), este, que mira la captura SOLA, sobra y la
+                        // contradice: medido en Maset, tomó por defecto la franja granate con su punto verde, que ES del diseño.
+                        horaDeLaUltimaCritica === undefined &&
                         tocaCriticarPantalla({ hayCritico: opciones.criticaVisual !== undefined, capturas: capturasDelTurno.length, yaDisparo: visualYaDisparo, intento })) {
                         visualYaDisparo = true;
                         const captura = capturasDelTurno[capturasDelTurno.length - 1];
@@ -2000,7 +2173,20 @@ export async function abrirSesionTrueforge(opciones) {
                 verificador: veredicto,
                 pendientes: sinResolver,
                 ...(cortadoPorTope ? { topeAgotado: tope } : {}),
+                // La pregunta que deja ESTE turno: la de un turno anterior se consume al empezar (`enEspera`).
+                ...(preguntaEnEspera === undefined ? {} : { preguntaPendiente: consultaDe(preguntaEnEspera.args).pregunta }),
                 ...(comprobacionesDelTurno.length === 0 ? {} : { comprobacionesVisuales: comprobacionesDelTurno }),
+                // Lo que su respuesta final EXPLICA (lo nombra) no es crítico: va aparte (`omisionExplicada`).
+                ...(() => {
+                    const explicadas = bloqueantesVisualesDelTurno.filter((b) => omisionExplicada(b, respuestaDeLaPasada));
+                    const sinExplicar = bloqueantesVisualesDelTurno.filter((b) => !explicadas.includes(b));
+                    // Si el proyecto cambió DESPUÉS de esa crítica, lo que vio ya no es la pantalla final: no es crítico.
+                    const desfasada = sinExplicar.length > 0 && horaDeLaUltimaCritica !== undefined && cambioDespuesDe(raiz, horaDeLaUltimaCritica);
+                    return {
+                        ...(sinExplicar.length === 0 ? {} : desfasada ? { bloqueantesDesfasados: sinExplicar } : { bloqueantesVisuales: sinExplicar }),
+                        ...(explicadas.length === 0 ? {} : { omisionesExplicadas: explicadas }),
+                    };
+                })(),
                 ...(hallazgosDelTurno.length === 0 ? {} : { hallazgos: hallazgosDelTurno }),
                 ...(preexistentesDelTurno === undefined ? {} : { preexistentes: preexistentesDelTurno }),
                 ...(motivoSinVerificar === undefined ? {} : { motivoSinVerificar }),