@arcadialdev/arcality 4.1.3 → 4.1.5

package/tests/_helpers/agentic-runner.bundle.spec.js

@@ -648,7 +648,14 @@ function simpleHash(str) {
 }
 function normalizeBugClassification(value) {
   const text = String(value || "").trim();
-  const allowed = ["[Backend Bug]", "[Frontend Bug]", "[UI Regression]", "[Flaky/Stale Selector]"];
+  const allowed = [
+    "[Backend Bug]",
+    "[Frontend Bug]",
+    "[UI Regression]",
+    "[Flaky/Stale Selector]",
+    "[Interaction Blocked]",
+    "[Validation Error]"
+  ];
   return allowed.find((category) => text.includes(category)) || "";
 }
 async function createAdoTask(title, description, metadata = {}) {
@@ -3457,6 +3464,10 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
               score = 80;
             else if (type === "DROPDOWN")
               score = 70;
+            const isFieldTag = tag === "input" || tag === "textarea" || tag === "select";
+            const isDisabledEl = htmlEl.disabled === true || htmlEl.hasAttribute("disabled") || htmlEl.getAttribute("aria-disabled") === "true";
+            const isReadonlyEl = htmlEl.readOnly === true || htmlEl.hasAttribute("readonly");
+            const isEditableEl = isFieldTag ? !isDisabledEl && !isReadonlyEl : true;
             return {
               idx,
               type,
@@ -3465,7 +3476,10 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
               frameIdx: 0,
               // Placeholder
               selector: `[agent-idx="${idx}"]`,
-              score
+              score,
+              disabled: isDisabledEl,
+              readonly: isReadonlyEl,
+              editable: isEditableEl
             };
           }).filter(Boolean);
         }, { startIdx: globalIdx });
@@ -3585,20 +3599,33 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
   }
   fallbackFailureClassification(failReason, failReasoning = "") {
     const reason = `${failReason} ${failReasoning}`.toLowerCase();
+    if (reason.includes("input_not_editable") || reason.includes("blocked_by_disabled_control") || reason.includes("ui_overlay_blocking") || reason.includes("not_editable") || reason.includes("readonly") || reason.includes("disabled") || reason.includes("overlay")) {
+      return "[Interaction Blocked]";
+    }
+    if (reason.includes("validation_error_unhandled") || reason.includes("validation")) {
+      return "[Validation Error]";
+    }
     if (reason.includes("network") || reason.includes("backend") || reason.includes("server") || reason.includes("internal_error") || reason.includes("500")) {
       return "[Backend Bug]";
     }
     if (reason.includes("stale") || reason.includes("timeout") || reason.includes("selector") || reason.includes("idx")) {
       return "[Flaky/Stale Selector]";
     }
-    if (reason.includes("render") || reason.includes("blank") || reason.includes("ui_validation")) {
+    if (reason.includes("render") || reason.includes("blank") || reason.includes("ui_validation") || reason.includes("expected_element_never_appeared")) {
       return "[UI Regression]";
     }
     return "[Frontend Bug]";
   }
   normalizeFailureClassification(raw) {
     const text = (raw || "").trim();
-    const allowed = ["[Backend Bug]", "[Frontend Bug]", "[UI Regression]", "[Flaky/Stale Selector]"];
+    const allowed = [
+      "[Backend Bug]",
+      "[Frontend Bug]",
+      "[UI Regression]",
+      "[Flaky/Stale Selector]",
+      "[Interaction Blocked]",
+      "[Validation Error]"
+    ];
     return allowed.find((category) => text.includes(category)) || null;
   }
   /**
@@ -3638,7 +3665,7 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
         body: JSON.stringify({
           model: process.env.CLAUDE_MODEL || "claude-4-5-sonnet-latest",
           max_tokens: 32,
-          system: "You classify terminal E2E QA failures. Reply with exactly one category string and no explanation: [Backend Bug], [Frontend Bug], [UI Regression], or [Flaky/Stale Selector].",
+          system: "You classify terminal E2E QA failures. Reply with EXACTLY one category string and no explanation. Categories:\n- [Interaction Blocked]: a target element exists but does not accept the required action (input readonly/disabled, action button disabled, an overlay/modal intercepts clicks).\n- [Validation Error]: the portal rejected the submitted data with a visible validation message that was never resolved.\n- [Backend Bug]: server/network failure, HTTP 500, XHR/fetch error, or a system error surfaced from the backend.\n- [UI Regression]: page/widgets failed to render, blank state, or an expected element never appeared.\n- [Flaky/Stale Selector]: element went stale, timed out, or the selector no longer resolves.\n- [Frontend Bug]: any other client-side defect not covered above.\nPrefer the most specific category. Use the fail_reason field as the strongest signal.",
           messages: [
             {
               role: "user",
@@ -3658,6 +3685,79 @@ ${JSON.stringify(diagnosticPayload, null, 2)}`
       return fallback;
     }
   }
+  /**
+   * DIAGNÓSTICO DE ATASCO (respaldo IA).
+   * Cuando las sondas estáticas no identifican una causa clara, esta llamada analiza el
+   * historial + señales del DOM y devuelve el `fail_reason` más específico posible en lugar
+   * de dejar que todo recaiga en "loop_detected". Devuelve null si no hay IA disponible o falla.
+   */
+  async diagnoseStallWithAI(payload) {
+    const isProxyMode = !!process.env.ARCALITY_API_URL;
+    if (!isProxyMode && !process.env.ANTHROPIC_API_KEY)
+      return null;
+    const allowedReasons = [
+      "input_not_editable",
+      "blocked_by_disabled_control",
+      "validation_error_unhandled",
+      "ui_overlay_blocking",
+      "stale_element",
+      "expected_element_never_appeared",
+      "loop_detected"
+    ];
+    try {
+      const endpointUrl = isProxyMode ? `${process.env.ARCALITY_API_URL}/api/v1/ai/proxy` : "https://api.anthropic.com/v1/messages";
+      const headers = { "Content-Type": "application/json" };
+      if (isProxyMode) {
+        headers["x-api-key"] = process.env.ARCALITY_API_KEY || "";
+        const missionId = process.env.ARCALITY_MISSION_ID || "";
+        if (missionId)
+          headers["x-mission-id"] = missionId;
+      } else {
+        headers["x-api-key"] = process.env.ANTHROPIC_API_KEY;
+        headers["anthropic-version"] = "2023-06-01";
+      }
+      const diagnosticPayload = {
+        mission: payload.mission,
+        loop_type: payload.loop_type || "unknown",
+        loop_targets: payload.loop_targets || [],
+        recent_history: payload.recent_history.slice(-12),
+        dom_signals: payload.dom_signals || {},
+        critical_network_error: this.criticalNetworkError || "None",
+        critical_js_error: this.criticalJsError || "None"
+      };
+      const response = await fetch(endpointUrl, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          model: process.env.CLAUDE_MODEL || "claude-4-5-sonnet-latest",
+          max_tokens: 300,
+          system: 'You are the root-cause diagnostician of an autonomous E2E QA agent that got STUCK repeating actions. Do NOT assume it is a generic loop. Determine WHY the agent could not progress and pick the single most specific fail_reason from this list:\n- input_not_editable: the field the agent had to type into is readonly/disabled and never accepted the value.\n- blocked_by_disabled_control: the button/control the agent must click is disabled (e.g. a submit button stays disabled because the form is invalid).\n- validation_error_unhandled: the portal shows a visible validation/error message rejecting the data, and the agent could not resolve it.\n- ui_overlay_blocking: a modal/overlay/backdrop intercepts the clicks so the intended element is never reached.\n- stale_element: the target element keeps appearing/disappearing or the selector no longer resolves.\n- expected_element_never_appeared: the agent is waiting for an element/result (modal, message, next step) that never renders.\n- loop_detected: ONLY if none of the above fit \u2014 the agent genuinely repeats valid actions with no identifiable blocker.\nReply ONLY with strict JSON: {"fail_reason":"<one of the list>","reasoning":"<one concise sentence in Spanish naming the concrete element/state>"}. No markdown, no extra text.',
+          messages: [
+            {
+              role: "user",
+              content: `Diagnose why this Arcality QA agent got stuck:
+${JSON.stringify(diagnosticPayload, null, 2)}`
+            }
+          ],
+          ...!isProxyMode ? { temperature: 0 } : {}
+        })
+      });
+      if (!response.ok)
+        return null;
+      const data = await response.json();
+      const rawText = (data.content?.[0]?.text || "").trim();
+      const jsonMatch = rawText.match(/\{[\s\S]*\}/);
+      if (!jsonMatch)
+        return null;
+      const parsed = JSON.parse(jsonMatch[0]);
+      const failReason = String(parsed.fail_reason || "").trim();
+      if (!allowedReasons.includes(failReason))
+        return null;
+      return { failReason, reasoning: String(parsed.reasoning || "").trim() };
+    } catch {
+      return null;
+    }
+  }
   /**
    * Busca una acci�n sugerida en la memoria SIN usar tokens.
    * Compara URL, componentes visuales Y palabras clave del prompt.
@@ -3831,9 +3931,16 @@ ${JSON.stringify(diagnosticPayload, null, 2)}`
     const state = await this.getPageState();
     const screenshot = await this.page.screenshot({ type: "png" });
     const base64Img = screenshot.toString("base64");
-    const componentsList = state.components.map(
-      (c) => `IDX:${c.idx} | TYPE:${c.type} | NAME: "${c.name}"${c.value ? ` | VAL:"${c.value}"` : ""} `
-    ).join("\n");
+    const componentsList = state.components.map((c) => {
+      let stateTag = "";
+      if (c.disabled)
+        stateTag = " | STATE:DISABLED (no se puede clicar/escribir)";
+      else if (c.readonly)
+        stateTag = " | STATE:READONLY (no se puede escribir directamente)";
+      else if (c.editable === false && c.type === "FIELD")
+        stateTag = " | STATE:NOT_EDITABLE";
+      return `IDX:${c.idx} | TYPE:${c.type} | NAME: "${c.name}"${c.value ? ` | VAL:"${c.value}"` : ""}${stateTag} `;
+    }).join("\n");
     const rawTools = [
       {
         name: "perform_ui_actions",
@@ -5411,6 +5518,12 @@ function writeBatchMissionResult(payload) {
   } catch {
   }
 }
+function hasVisualAttachment(testInfo) {
+  const attachments = Array.isArray(testInfo?.attachments) ? testInfo.attachments : [];
+  return attachments.some(
+    (att) => typeof att?.contentType === "string" && (att.contentType.startsWith("image/") || att.contentType.startsWith("video/"))
+  );
+}
 (0, import_test.test)("Arcality AI Runner", async ({ page }, testInfo) => {
   import_test.test.setTimeout(12e5);
   const contextDir = process.env.CONTEXT_DIR;
@@ -5494,6 +5607,7 @@ function writeBatchMissionResult(payload) {
   let bugClassification = "";
   let databaseValidationReport = null;
   const missionSummaryPaths = /* @__PURE__ */ new Set();
+  const blockedInteractions = [];
   const updateSavedMissionSummaries = () => {
     for (const summaryPath of missionSummaryPaths) {
       try {
@@ -5513,6 +5627,31 @@ function writeBatchMissionResult(payload) {
       }
     }
   };
+  const attachEvidenceFile = async (name, filePath, contentType, onlyIfMissingVisual = false) => {
+    if (!testInfo || !fs7.existsSync(filePath))
+      return false;
+    if (onlyIfMissingVisual && hasVisualAttachment(testInfo))
+      return false;
+    try {
+      await testInfo.attach(name, { path: filePath, contentType });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const attachFallbackScreenshot = async (name, onlyIfMissingVisual = true) => {
+    if (!testInfo || page.isClosed())
+      return false;
+    if (onlyIfMissingVisual && hasVisualAttachment(testInfo))
+      return false;
+    try {
+      const buffer = await page.screenshot({ type: "png", fullPage: true });
+      await testInfo.attach(name, { body: buffer, contentType: "image/png" });
+      return true;
+    } catch {
+      return false;
+    }
+  };
   const updateSavedMissionClassification = updateSavedMissionSummaries;
   const runPostMissionDatabaseValidations = async () => {
     if (!aiMarkedSuccess || hasCriticalError || databaseValidationReport)
@@ -5929,6 +6068,99 @@ ${readableHistory}`;
   } catch (e) {
     console.warn(`Error buscando patrones: ${e.message}`);
   }
+  const diagnoseStall = async (loopType, loopTargets) => {
+    const targetsStr = loopTargets.join(", ");
+    try {
+      const evidencePath = path8.join(contextDir || ".", `stall-diagnosis-${stepCount}-${Date.now()}.png`);
+      await page.screenshot({ path: evidencePath, fullPage: true }).catch(() => {
+      });
+      await attachEvidenceFile("stall_diagnosis", evidencePath, "image/png");
+    } catch {
+    }
+    const recentBlocks = blockedInteractions.filter((b) => stepCount - b.turn <= 8);
+    const blockedFill = recentBlocks.find((b) => b.action === "fill");
+    if (blockedFill) {
+      return {
+        failReason: "input_not_editable",
+        failReasoning: `El campo "${blockedFill.target}" est\xE1 ${blockedFill.state} y no admiti\xF3 el valor solicitado. Arcality intent\xF3 escribir ah\xED pero el portal no lo permite por dise\xF1o (readonly/disabled), por lo que la misi\xF3n no pudo avanzar. Esto NO es un bucle: es un campo requerido que no acepta entrada directa.`
+      };
+    }
+    const blockedClick = recentBlocks.find((b) => b.action !== "fill");
+    if (blockedClick) {
+      return {
+        failReason: "blocked_by_disabled_control",
+        failReasoning: `El control "${blockedClick.target}" estaba deshabilitado (disabled/aria-disabled) al intentar interactuar. Arcality no pudo avanzar porque el portal mantiene el control bloqueado (ej. un bot\xF3n de acci\xF3n que sigue inhabilitado). No es un bucle sino un control bloqueado.`
+      };
+    }
+    const domSignals = await page.evaluate(() => {
+      const isVisible = (el) => {
+        const r = el.getBoundingClientRect();
+        const s = getComputedStyle(el);
+        return r.width > 0 && r.height > 0 && s.visibility !== "hidden" && s.display !== "none" && s.opacity !== "0";
+      };
+      let validationMsg = "";
+      const errSelectors = '[role="alert"], [aria-invalid="true"], .error, .invalid, .is-invalid, .field-error, .Mui-error, .validation-message, .help-block.error, .text-danger';
+      for (const el of Array.from(document.querySelectorAll(errSelectors))) {
+        if (!isVisible(el))
+          continue;
+        const txt = (el.innerText || "").trim();
+        if (txt && txt.length > 1 && txt.length < 200) {
+          validationMsg = txt;
+          break;
+        }
+      }
+      let overlayLabel = "";
+      const overlaySelectors = '.modal.show, .modal[style*="display: block"], [role="dialog"], .cdk-overlay-backdrop, .overlay, .backdrop, .modal-backdrop, .p-dialog-mask, .mat-dialog-container';
+      for (const el of Array.from(document.querySelectorAll(overlaySelectors))) {
+        if (!isVisible(el))
+          continue;
+        const r = el.getBoundingClientRect();
+        if (r.width >= window.innerWidth * 0.4 && r.height >= window.innerHeight * 0.4) {
+          overlayLabel = (el.className || el.tagName || "overlay").toString().substring(0, 60);
+          break;
+        }
+      }
+      return { validationMsg, overlayLabel };
+    }).catch(() => ({ validationMsg: "", overlayLabel: "" }));
+    if (domSignals.validationMsg) {
+      return {
+        failReason: "validation_error_unhandled",
+        failReasoning: `El portal muestra un mensaje de validaci\xF3n/error visible que no fue resuelto: "${domSignals.validationMsg}". El formulario rechaza los datos y Arcality no logr\xF3 corregirlos, por lo que no pudo continuar. No es un bucle sino una validaci\xF3n de formulario pendiente.`
+      };
+    }
+    if (domSignals.overlayLabel) {
+      return {
+        failReason: "ui_overlay_blocking",
+        failReasoning: `Un overlay/modal ("${domSignals.overlayLabel}") permanece visible y cubre la interfaz, interceptando las interacciones. Arcality repite acciones porque el elemento objetivo queda tapado por esta capa. No es un bucle l\xF3gico sino un overlay que bloquea la UI.`
+      };
+    }
+    if (agent.criticalNetworkError) {
+      return { failReason: "portal_network_error", failReasoning: `Durante el atasco se detect\xF3 un fallo de red del portal: ${agent.criticalNetworkError}` };
+    }
+    if (agent.criticalJsError) {
+      return { failReason: "portal_js_crash", failReasoning: `Durante el atasco se detect\xF3 una excepci\xF3n JavaScript del portal: ${agent.criticalJsError}` };
+    }
+    try {
+      const aiDiag = await agent.diagnoseStallWithAI({
+        mission: prompt,
+        loop_type: loopType,
+        loop_targets: loopTargets,
+        recent_history: history,
+        dom_signals: domSignals
+      });
+      if (aiDiag && aiDiag.failReason && aiDiag.failReason !== "loop_detected") {
+        return {
+          failReason: aiDiag.failReason,
+          failReasoning: aiDiag.reasoning || `Diagn\xF3stico IA del atasco: ${aiDiag.failReason} sobre ${targetsStr}.`
+        };
+      }
+    } catch {
+    }
+    return {
+      failReason: "loop_detected",
+      failReasoning: `Arcality QA repiti\xF3 acciones de tipo ${loopType} sobre ${targetsStr} sin cambios significativos en el DOM y sin una causa de bloqueo identificable (campo/control bloqueado, validaci\xF3n, overlay o error del portal).`
+    };
+  };
   const maxTotalIterations = maxSteps + 50;
   let totalIterations = 0;
   while (!isFinished && stepCount < maxSteps) {
@@ -6265,16 +6497,17 @@ ${patternContext}` : prompt;
         const loopType = isClickLoop ? "click" : "fill";
         const uniqueTargets = isClickLoop ? uniqueClicks : uniqueFills;
         console.warn(`
-\u26A0 Bucle repetitivo de ${loopType} detectado:`);
+\u26A0 Estancamiento detectado (${loopType}). Ejecutando diagn\xF3stico de causa ra\xEDz...`);
         console.warn(`   \xDAltimas acciones: ${lastActions.join(" \u2192 ")}`);
-        response.thought = `\u{1F6D1} ERROR: Bucle repetitivo en ${loopType} sobre: ${Array.from(uniqueTargets).join(", ")}.`;
+        const diagnosis = await diagnoseStall(loopType, Array.from(uniqueTargets));
+        console.warn(`   >> Diagn\xF3stico: ${diagnosis.failReason}`);
+        response.thought = `\u{1F6D1} ${diagnosis.failReason.toUpperCase()}: ${diagnosis.failReasoning}`;
         response.finish = true;
         response.actions = [];
         aiMarkedSuccess = false;
         hasCriticalError = true;
-        failReason = "loop_detected";
-        failReasoning = `Arcality QA entr\xF3 en un bucle l\xF3gico intentando ejecutar la misma acci\xF3n repetidamente sin observar cambios significativos en el DOM.
-Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(uniqueTargets).join(", ")}.`;
+        failReason = diagnosis.failReason;
+        failReasoning = diagnosis.failReasoning;
       } else if ((isClickLoop || isFillLoop) && agentRecovered) {
         console.log(`>>ARCALITY_STATUS>> \u{1F504} Loop candidato detectado pero Arcality se recuper\xF3 en este turno. Continuando misi\xF3n.`);
       }
@@ -6293,6 +6526,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
         console.error(`   >> El portal carg\xF3 el shell (navegaci\xF3n, header) pero los WIDGETS/COMPONENTES quedaron en blanco.`);
         console.error(`   >> Evidencia guardada: ${blankEvidencePath}`);
         console.error(`   >> Tipo: portal_rendering_failure | Esto es un bug del portal, NO de Arcality.`);
+        await attachEvidenceFile("portal_render_failure", blankEvidencePath, "image/png");
         response.thought = `\u{1F6D1} [BUG DEL PORTAL DETECTADO] La p\xE1gina ${blankUrl} carg\xF3 su estructura pero los componentes principales (widgets, tablas, listas) NO se renderizaron. Arcality estuvo esperando ${consecutiveWaits} turnos sin mejora. Esto es un fallo de renderizado del portal.`;
         response.finish = true;
         response.actions = [];
@@ -6393,6 +6627,13 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
             }
             await loc.scrollIntoViewIfNeeded({ timeout: 5e3 }).catch(() => {
             });
+            const ctrlDisabled = await loc.evaluate(
+              (el) => el.disabled === true || el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true"
+            ).catch(() => false);
+            if (ctrlDisabled) {
+              console.log(`    \u{1F6AB} Control "${desc}" est\xE1 disabled al momento del click.`);
+              blockedInteractions.push({ turn: stepCount, action: step.action, target: desc, state: "disabled" });
+            }
             if (step.action === "double_click") {
               await loc.dblclick({ timeout: 4e3, force: true });
             } else {
@@ -6537,9 +6778,22 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
             } else {
               await loc.click({ timeout: 5e3 }).catch(() => {
               });
-              await loc.fill(step.value, { timeout: 1e4, force: true });
-              await loc.press("Tab").catch(() => {
-              });
+              const fillDesc = (step.description || step.selector || "").substring(0, 80);
+              const writeState = await loc.evaluate((el) => ({
+                disabled: el.disabled === true || el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true",
+                readonly: el.readOnly === true || el.hasAttribute("readonly")
+              })).catch(() => ({ disabled: false, readonly: false }));
+              const isEditable = await loc.isEditable({ timeout: 1e3 }).catch(() => !(writeState.disabled || writeState.readonly));
+              if (!isEditable || writeState.disabled || writeState.readonly) {
+                const stateLabel = writeState.disabled ? "disabled" : writeState.readonly ? "readonly" : "not-editable";
+                console.log(`    \u{1F6AB} Campo "${fillDesc}" est\xE1 ${stateLabel}. No se puede escribir "${step.value}". Registrando bloqueo de interacci\xF3n.`);
+                blockedInteractions.push({ turn: stepCount, action: "fill", target: fillDesc, state: stateLabel });
+                history.push(`Turno ${stepCount}: \u{1F6AB} [CAMPO BLOQUEADO] El campo "${fillDesc}" est\xE1 ${stateLabel}; el valor "${step.value}" NO pudo capturarse. Si existe otra forma de entrada v\xE1lida (otro campo, un flujo alterno), \xFAsala. Si no la hay, este es un bloqueo del portal \u2014 NO repitas la misma acci\xF3n.`);
+              } else {
+                await loc.fill(step.value, { timeout: 1e4 });
+                await loc.press("Tab").catch(() => {
+                });
+              }
             }
             await page.waitForTimeout(500);
           } else if (step.action === "wait") {
@@ -6569,6 +6823,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
                     console.error(`   >> ${emptyPanelCount} de ${panelCount} paneles est\xE1n en blanco.`);
                     console.error(`   >> Tipo: portal_rendering_failure | Bug del portal confirmado.`);
                     console.error(`   >> Evidencia: ${blankEvidencePath}`);
+                    await attachEvidenceFile("blank_dashboard_failure", blankEvidencePath, "image/png");
                     hasCriticalError = true;
                     failReason = "portal_rendering_failure";
                     isFinished = true;
@@ -6785,6 +7040,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
   await runPostMissionDatabaseValidations();
   if (aiMarkedSuccess) {
     hasCriticalError = false;
+    await attachFallbackScreenshot("final_success_state", true);
     await persistCollectiveMemory();
     const finalUsedDirectReuse = reusedPatternId !== null && guideIdx !== 999999;
     if (!finalUsedDirectReuse && stepsData.length > 0) {
@@ -6891,13 +7147,28 @@ Evidence: ${JSON.stringify(v.evidence).substring(0, 400)}`,
     console.warn(">>ARCALITY_STATUS>> \u{1F6E1}\uFE0F Escaneo de seguridad omitido porque el navegador o la pesta\xF1a colaps\xF3/cerr\xF3.");
   }
   if (!aiMarkedSuccess && !failReason) {
-    if (stepCount >= maxSteps)
-      failReason = "max_steps_reached";
-    else
-      failReason = "unknown_failure";
+    try {
+      const recentTargets = Array.from(new Set(
+        history.slice(-10).map((h) => (h.match(/(?:click|fill) en "(.+?)"/) || [])[1]).filter(Boolean)
+      ));
+      const diagnosis = await diagnoseStall("mixed", recentTargets);
+      if (diagnosis.failReason && diagnosis.failReason !== "loop_detected") {
+        failReason = diagnosis.failReason;
+        failReasoning = diagnosis.failReasoning;
+        console.log(`>>ARCALITY_STATUS>> \u{1F50E} Diagn\xF3stico de cierre: ${failReason}`);
+      }
+    } catch {
+    }
+    if (!failReason) {
+      if (stepCount >= maxSteps)
+        failReason = "max_steps_reached";
+      else
+        failReason = "unknown_failure";
+    }
   }
   saveMissionResults();
   if (!aiMarkedSuccess) {
+    await attachFallbackScreenshot("final_failure_state", true);
     if (process.env.DEBUG)
       console.log(`>>ARCALITY_STATUS>> \u{1F4CA} Uso total de tokens esta misi\xF3n: IN=${totalMissionUsage.input_tokens} | OUT=${totalMissionUsage.output_tokens} | Cache writes=${totalMissionUsage.cache_creation_input_tokens} | Cache reads=${totalMissionUsage.cache_read_input_tokens}`);
     bugClassification = await agent.classifyFailure(prompt, failReason || "unknown_failure", failReasoning, history);