@arcadialdev/arcality 3.0.4 → 4.0.0

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

@@ -980,6 +980,34 @@ var sendKeyboardEventTool = {
     required: ["key"]
   }
 };
+var typeSequentiallyTool = {
+  name: "type_sequentially",
+  description: "QA Skill: Type a full text string character by character into a specific field. Use this for masked numeric inputs, OTP/PIN/CLABE/identification codes, virtual-keyboard flows, or whenever the mission explicitly says to type manually, digit by digit, or character by character. Prefer this over repeated clicks when the field is already visible but normal fill may not reflect the mask correctly.",
+  input_schema: {
+    type: "object",
+    properties: {
+      idx: {
+        type: "number",
+        description: "The IDX of the input-like element to focus before typing"
+      },
+      text: {
+        type: "string",
+        description: "The exact text to type sequentially"
+      },
+      delay_ms: {
+        type: "number",
+        description: "Delay between keystrokes in milliseconds (default: 80)",
+        default: 80
+      },
+      clear_first: {
+        type: "boolean",
+        description: "Whether to clear any existing value before typing (default: true)",
+        default: true
+      }
+    },
+    required: ["idx", "text"]
+  }
+};
 var interactNativeControlTool = {
   name: "interact_native_control",
   description: "QA Skill: Interact with native HTML controls that standard click/fill may not handle correctly. This includes: <input type='time'>, <input type='date'>, <input type='datetime-local'>, <input type='color'>, <input type='range'>, <select> with optgroup, and contenteditable elements. This tool uses Playwright's specialized methods (selectOption, fill with format coercion, press sequences) to reliably set values. ALWAYS prefer this tool over manual fill for time/date inputs.",
@@ -1035,6 +1063,7 @@ var qaAdvancedTools = [
   restoreNavigationCheckpointTool,
   createTestEvidenceTool,
   sendKeyboardEventTool,
+  typeSequentiallyTool,
   interactNativeControlTool,
   scrollPageTool
 ];
@@ -1679,6 +1708,112 @@ function isPlaceholderRule(rule) {
 function isRecognizedSection(title) {
   return RECOGNIZED_SECTION_PATTERNS.some((pattern) => pattern.test(title));
 }
+function asTrimmedString(value) {
+  if (typeof value !== "string")
+    return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+function asStringList(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.map((item) => asTrimmedString(item)).filter((item) => Boolean(item));
+}
+function loadQaContextGovernance(projectRoot, contextExists) {
+  const metadataPath = path.join(projectRoot, ".arcality", "qa-context.meta.json");
+  const warnings = [];
+  const emptyResult = {
+    path: metadataPath,
+    exists: false,
+    isValid: false,
+    enforcementMode: getQaContextGovernanceMode(),
+    version: null,
+    updatedBy: null,
+    approvedBy: null,
+    ownerTeam: null,
+    changeSummary: null,
+    effectiveFrom: null,
+    tags: [],
+    warnings
+  };
+  if (!fs.existsSync(metadataPath)) {
+    if (contextExists) {
+      warnings.push("No se encontro qa-context.meta.json. Agrega metadata de gobernanza para versionar responsables y cambios.");
+    }
+    return emptyResult;
+  }
+  try {
+    const raw = fs.readFileSync(metadataPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const metadata = {
+      path: metadataPath,
+      exists: true,
+      isValid: true,
+      enforcementMode: getQaContextGovernanceMode(),
+      version: asTrimmedString(parsed?.version),
+      updatedBy: asTrimmedString(parsed?.updated_by ?? parsed?.updatedBy),
+      approvedBy: asTrimmedString(parsed?.approved_by ?? parsed?.approvedBy),
+      ownerTeam: asTrimmedString(parsed?.owner_team ?? parsed?.ownerTeam),
+      changeSummary: asTrimmedString(parsed?.change_summary ?? parsed?.changeSummary),
+      effectiveFrom: asTrimmedString(parsed?.effective_from ?? parsed?.effectiveFrom),
+      tags: asStringList(parsed?.tags),
+      warnings
+    };
+    if (!metadata.version)
+      warnings.push('qa-context.meta.json no define "version".');
+    if (!metadata.updatedBy)
+      warnings.push('qa-context.meta.json no define "updated_by".');
+    if (!metadata.ownerTeam)
+      warnings.push('qa-context.meta.json no define "owner_team".');
+    if (!metadata.changeSummary)
+      warnings.push('qa-context.meta.json no define "change_summary".');
+    metadata.isValid = warnings.length === 0;
+    return metadata;
+  } catch (error) {
+    warnings.push("qa-context.meta.json no se pudo leer o parsear correctamente.");
+    return {
+      ...emptyResult,
+      exists: true,
+      warnings
+    };
+  }
+}
+function getQaContextGovernanceMode() {
+  const raw = String(process.env.ARCALITY_QA_CONTEXT_GOVERNANCE || "").trim().toLowerCase();
+  if (raw === "off")
+    return "off";
+  if (raw === "strict" || raw === "enforce" || raw === "required")
+    return "strict";
+  if (raw === "warn")
+    return "warn";
+  if (process.env.CI === "true")
+    return "strict";
+  return "warn";
+}
+function getQaContextGovernanceIssues(analysis) {
+  if (!analysis.exists)
+    return [];
+  const issues = [];
+  if (!analysis.governance.exists) {
+    issues.push("Falta el archivo .arcality/qa-context.meta.json para gobernanza del contexto.");
+    return issues;
+  }
+  if (!analysis.governance.version)
+    issues.push("La metadata no define version.");
+  if (!analysis.governance.updatedBy)
+    issues.push("La metadata no define updated_by.");
+  if (!analysis.governance.ownerTeam)
+    issues.push("La metadata no define owner_team.");
+  if (!analysis.governance.changeSummary)
+    issues.push("La metadata no define change_summary.");
+  return issues;
+}
+function shouldBlockOnQaContextGovernance(analysis) {
+  const mode = analysis.governance.enforcementMode;
+  if (mode !== "strict")
+    return false;
+  return getQaContextGovernanceIssues(analysis).length > 0;
+}
 function analyzeQaContext(projectRoot = process.cwd()) {
   const filePath = path.join(projectRoot, ".arcality", "qa-context.md");
   const emptyResult = {
@@ -1690,7 +1825,12 @@ function analyzeQaContext(projectRoot = process.cwd()) {
     ruleCount: 0,
     sectionCount: 0,
     recognizedSectionCount: 0,
+    unrecognizedSectionCount: 0,
     ignoredExampleCount: 0,
+    duplicateRuleCount: 0,
+    lastModifiedAt: null,
+    fingerprint: null,
+    governance: loadQaContextGovernance(projectRoot, false),
     warnings: [],
     status: "missing",
     isValid: false
@@ -1699,12 +1839,16 @@ function analyzeQaContext(projectRoot = process.cwd()) {
     return emptyResult;
   }
   const rawContent = fs.readFileSync(filePath, "utf8");
+  const stat = fs.statSync(filePath);
   const cleanedContent = stripHtmlComments(rawContent);
   const lines = cleanedContent.split(/\r?\n/);
-  const warnings = [];
+  const governance = loadQaContextGovernance(projectRoot, true);
+  const warnings = [...governance.warnings];
   const sections = [];
   let currentSection = null;
   let ignoredExampleCount = 0;
+  let duplicateRuleCount = 0;
+  const seenRules = /* @__PURE__ */ new Set();
   const openSection = (title) => {
     currentSection = {
       title: title.trim(),
@@ -1731,6 +1875,12 @@ function analyzeQaContext(projectRoot = process.cwd()) {
       ignoredExampleCount += 1;
       continue;
     }
+    const dedupeKey = rule.toLowerCase();
+    if (seenRules.has(dedupeKey)) {
+      duplicateRuleCount += 1;
+      continue;
+    }
+    seenRules.add(dedupeKey);
     if (currentSection) {
       currentSection.rules.push(rule);
     }
@@ -1738,6 +1888,7 @@ function analyzeQaContext(projectRoot = process.cwd()) {
   const nonEmptySections = sections.filter((section) => section.rules.length > 0);
   const ruleCount = nonEmptySections.reduce((total, section) => total + section.rules.length, 0);
   const recognizedSectionCount = nonEmptySections.filter((section) => section.recognized).length;
+  const unrecognizedSectionCount = nonEmptySections.length - recognizedSectionCount;
   if (!rawContent.trim()) {
     warnings.push("El archivo existe pero esta vacio.");
   }
@@ -1754,6 +1905,12 @@ function analyzeQaContext(projectRoot = process.cwd()) {
   if (ruleCount > 0 && recognizedSectionCount === 0) {
     warnings.push("Hay reglas, pero ninguna cae en las secciones sugeridas. Revisa la estructura del archivo.");
   }
+  if (duplicateRuleCount > 0) {
+    warnings.push(`Se omitieron ${duplicateRuleCount} regla(s) duplicadas del QA Context.`);
+  }
+  if (unrecognizedSectionCount > 0) {
+    warnings.push(`Hay ${unrecognizedSectionCount} seccion(es) con reglas que no coinciden con la taxonomia sugerida.`);
+  }
   const sanitizedContent = nonEmptySections.map((section) => {
     const rules = section.rules.map((rule) => `- ${rule}`).join("\n");
     return `## ${section.title}
@@ -1775,7 +1932,12 @@ ${rules}`;
     ruleCount,
     sectionCount: nonEmptySections.length,
     recognizedSectionCount,
+    unrecognizedSectionCount,
     ignoredExampleCount,
+    duplicateRuleCount,
+    lastModifiedAt: stat.mtime.toISOString(),
+    fingerprint: `${stat.size}:${stat.mtimeMs}`,
+    governance,
     warnings,
     status,
     isValid: ruleCount > 0
@@ -1793,10 +1955,28 @@ function formatQaContextSummary(analysis) {
   lines.push("QA Context Summary");
   lines.push(`Status: ${analysis.status}`);
   lines.push(`Path: ${analysis.filePath}`);
+  lines.push(`Priority: local qa-context > backend collective memory > base heuristics`);
   lines.push(`Rules loaded: ${analysis.ruleCount}`);
   lines.push(`Sections with rules: ${analysis.sectionCount}`);
   lines.push(`Recognized sections: ${analysis.recognizedSectionCount}`);
+  lines.push(`Unrecognized sections: ${analysis.unrecognizedSectionCount}`);
   lines.push(`Ignored examples/placeholders: ${analysis.ignoredExampleCount}`);
+  lines.push(`Duplicate rules removed: ${analysis.duplicateRuleCount}`);
+  lines.push(`Last modified: ${analysis.lastModifiedAt || "N/A"}`);
+  lines.push(`Fingerprint: ${analysis.fingerprint || "N/A"}`);
+  lines.push(`Governance metadata: ${analysis.governance.exists ? analysis.governance.isValid ? "valid" : "warning" : "missing"}`);
+  lines.push(`Governance enforcement: ${analysis.governance.enforcementMode}`);
+  if (analysis.governance.exists) {
+    lines.push("");
+    lines.push("Governance metadata:");
+    lines.push(`- Version: ${analysis.governance.version || "N/A"}`);
+    lines.push(`- Updated by: ${analysis.governance.updatedBy || "N/A"}`);
+    lines.push(`- Approved by: ${analysis.governance.approvedBy || "N/A"}`);
+    lines.push(`- Owner team: ${analysis.governance.ownerTeam || "N/A"}`);
+    lines.push(`- Effective from: ${analysis.governance.effectiveFrom || "N/A"}`);
+    lines.push(`- Change summary: ${analysis.governance.changeSummary || "N/A"}`);
+    lines.push(`- Tags: ${analysis.governance.tags.length > 0 ? analysis.governance.tags.join(", ") : "N/A"}`);
+  }
   if (analysis.sections.length > 0) {
     lines.push("");
     lines.push("Sections applied:");
@@ -1811,12 +1991,78 @@ function formatQaContextSummary(analysis) {
       lines.push(`- ${warning}`);
     }
   }
+  const governanceIssues = getQaContextGovernanceIssues(analysis);
+  if (governanceIssues.length > 0) {
+    lines.push("");
+    lines.push("Governance issues:");
+    for (const issue of governanceIssues) {
+      lines.push(`- ${issue}`);
+    }
+  }
   if (!analysis.exists) {
     lines.push("");
     lines.push("No local QA Context file was found for this mission.");
   }
   return lines.join("\n");
 }
+function buildEffectiveContextBlock(params) {
+  const { localAnalysis, localPromptBlock, backendContext } = params;
+  const backendRules = backendContext?.rules || [];
+  const backendFields = backendContext?.fields || [];
+  const blocks = [];
+  if (localPromptBlock) {
+    const governanceLines = [
+      `Version: ${localAnalysis.governance.version || "N/A"}`,
+      `Updated by: ${localAnalysis.governance.updatedBy || "N/A"}`,
+      `Approved by: ${localAnalysis.governance.approvedBy || "N/A"}`,
+      `Owner team: ${localAnalysis.governance.ownerTeam || "N/A"}`,
+      `Change summary: ${localAnalysis.governance.changeSummary || "N/A"}`
+    ].join("\n");
+    blocks.push(
+      `<LOCAL_QA_CONTEXT>
+Priority: Highest.
+If any local rule conflicts with backend collective memory, follow the local rule.
+Governance metadata:
+${governanceLines}
+${localPromptBlock}
+</LOCAL_QA_CONTEXT>`
+    );
+  }
+  if (backendRules.length > 0 || backendFields.length > 0) {
+    const backendLines = [];
+    backendLines.push(`<BACKEND_COLLECTIVE_MEMORY>`);
+    backendLines.push(`Priority: Secondary. Use this when local qa-context does not define the rule explicitly.`);
+    if (backendRules.length > 0) {
+      backendLines.push(`Rules:`);
+      for (const rule of backendRules) {
+        backendLines.push(`- [${rule.severity}] ${rule.title}: ${rule.description}`);
+      }
+    }
+    if (backendFields.length > 0) {
+      backendLines.push(`Known fields:`);
+      for (const field of backendFields) {
+        backendLines.push(`- ${field.field_identifier} (${field.field_type}) - Required: ${field.is_required}`);
+      }
+    }
+    backendLines.push(`</BACKEND_COLLECTIVE_MEMORY>`);
+    blocks.push(backendLines.join("\n"));
+  }
+  if (blocks.length === 0)
+    return "";
+  return `
+<CUSTOMER_CONTEXT_POLICY>
+Use customer context with this precedence order:
+1. Local qa-context file
+2. Backend collective memory
+3. Base QA heuristics
+Never ignore a valid local qa-context rule because of a conflicting backend memory entry.
+Local context status: ${localAnalysis.status}
+Local context fingerprint: ${localAnalysis.fingerprint || "N/A"}
+</CUSTOMER_CONTEXT_POLICY>
+
+` + blocks.join("\n\n") + `
+`;
+}
 
 // tests/_helpers/ai-agent-helper.ts
 var qaSecurityTools = [
@@ -1873,7 +2119,7 @@ var AIAgentHelper = class {
   qaContextAnalysisCache = null;
   qaContextPromptCache = "";
   qaContextStatusLogged = false;
-  constructor(page, contextDir = "out", testInfo, knowledgeService) {
+  constructor(page, contextDir, testInfo, knowledgeService) {
     this.page = page;
     this.contextDir = contextDir;
     this.testInfo = testInfo;
@@ -2707,7 +2953,8 @@ ${JSON.stringify(diagnosticPayload, null, 2)}`
     let projectInfo = "";
     try {
       const { getProjectContext } = require("../src/projectInspector");
-      const ctx = getProjectContext(process.cwd());
+      const runtimeProjectRoot = process.env.ARCALITY_PROJECT_ROOT || process.cwd();
+      const ctx = getProjectContext(runtimeProjectRoot);
       projectInfo = `
 \u{1F3D7}\uFE0F PROJECT CONTEXT:
 - Name: ${ctx.name}
@@ -2717,51 +2964,22 @@ ${JSON.stringify(diagnosticPayload, null, 2)}`
 `;
     } catch {
     }
-    let memoryBackendContext = "";
+    let backendContextData = null;
     try {
-      const contextData = await this.knowledgeService.getContext(state.url);
-      if (contextData && (contextData.rules?.length > 0 || contextData.fields?.length > 0)) {
-        memoryBackendContext = `
-\u{1F9E0} BACKEND COLLECTIVE MEMORY FOR THIS PAGE:
-`;
-        if (contextData.rules?.length > 0) {
-          memoryBackendContext += `BUSINESS RULES:
-`;
-          contextData.rules.forEach((r) => memoryBackendContext += `- [${r.severity}] ${r.title}: ${r.description}
-`);
-        }
-        if (contextData.fields?.length > 0) {
-          memoryBackendContext += `KNOWN FIELDS:
-`;
-          contextData.fields.forEach((f) => memoryBackendContext += `- ${f.field_identifier} (${f.field_type}) - Required: ${f.is_required}
-`);
-        }
+      backendContextData = await this.knowledgeService.getContext(state.url);
+      if (backendContextData && (backendContextData.rules?.length > 0 || backendContextData.fields?.length > 0)) {
         if (process.env.DEBUG)
-          console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Contexto de Memoria Colectiva inyectado (${contextData.rules?.length || 0} reglas, ${contextData.fields?.length || 0} campos).`);
+          console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Contexto de Memoria Colectiva inyectado (${backendContextData.rules?.length || 0} reglas, ${backendContextData.fields?.length || 0} campos).`);
       }
     } catch (e) {
       if (process.env.DEBUG)
         console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error en hook de contexto: ${e.message}`);
     }
     let customUserContext = "";
-    try {
-      const fs7 = require("fs");
-      const path7 = require("path");
-      const customContextPath = path7.join(process.cwd(), ".arcality", "qa-context.md");
-      if (false) {
-        const content = fs7.readFileSync(customContextPath, "utf8");
-        customUserContext = `
-<CUSTOMER_BUSINESS_RULES>
-El Ing. de QA o Cliente final ha provisto las siguientes reglas estrictas para este negocio/dominio. DEBES priorizar esta informaci\xF3n sobre todas tus skills base:
-${content}
-</CUSTOMER_BUSINESS_RULES>
-`;
-      }
-    } catch (e) {
-    }
     try {
       if (!this.qaContextAnalysisCache) {
-        const qaContextState = loadQaContextForPrompt(process.cwd());
+        const runtimeProjectRoot = process.env.ARCALITY_PROJECT_ROOT || process.cwd();
+        const qaContextState = loadQaContextForPrompt(runtimeProjectRoot);
         this.qaContextAnalysisCache = qaContextState.analysis;
         this.qaContextPromptCache = qaContextState.promptBlock;
       }
@@ -2777,18 +2995,16 @@ ${content}
             console.log(`>>ARCALITY_STATUS>> QA Context warning: ${warning}`);
           }
         }
+        if (qaContextAnalysis.exists || backendContextData?.rules?.length || backendContextData?.fields?.length) {
+          console.log(`>>ARCALITY_STATUS>> Pol\xEDtica efectiva de contexto: local qa-context > memoria backend > heur\xEDsticas base.`);
+        }
         this.qaContextStatusLogged = true;
       }
-      if (this.qaContextPromptCache) {
-        customUserContext = `
-<CUSTOMER_BUSINESS_RULES>
-El Ing. de QA o Cliente final ha provisto reglas locales para este negocio/dominio. Debes priorizar esta informacion sobre tus heuristicas base cuando exista conflicto.
-${this.qaContextPromptCache}
-</CUSTOMER_BUSINESS_RULES>
-`;
-      } else {
-        customUserContext = "";
-      }
+      customUserContext = buildEffectiveContextBlock({
+        localAnalysis: qaContextAnalysis,
+        localPromptBlock: this.qaContextPromptCache,
+        backendContext: backendContextData
+      });
     } catch (e) {
     }
     const systemPromptBlocks = [
@@ -2851,6 +3067,7 @@ These are NOT optional. You MUST use these tools in these situations:
 | Bug found in application | \`create_test_evidence\` | To document with annotated screenshot |
 | Mission complete | \`create_test_evidence\` | To document the final successful state |
 | Modal/popup blocking page | \`send_keyboard_event\` (Escape) | To close the overlay |
+| Masked numeric/code input, OTP/PIN/CLABE/INE identifier, or prompt says "manualmente", "d\xEDgito por d\xEDgito", "car\xE1cter por car\xE1cter" | \`type_sequentially\` | After ONE focus attempt on the field; do not keep clicking |
 | Time/Date/Color picker field | \`interact_native_control\` | INSTEAD of fill \u2014 native inputs need special handling |
 | Element not found on screen | \`scroll_page\` | To reveal off-screen content |
 | Need to close dropdown/menu | \`send_keyboard_event\` (Escape) | IMMEDIATELY after selecting any option \u2014 MANDATORY |
@@ -2895,7 +3112,13 @@ These are NOT optional. You MUST use these tools in these situations:
 13. **NATIVE CONTROLS**: For \`<input type="time">\`, \`<input type="date">\`, or similar native pickers, NEVER use \`fill\` repeatedly. Use \`interact_native_control\` or \`send_keyboard_event\` instead. If \`fill\` fails once, switch strategy immediately.
 14. **USER-DEFINED BUGS (MANDATORY & IMMEDIATE)**: If the prompt explicitly defines a condition as a bug (e.g., "Si no te deja eliminarla, es un bug de la aplicaci\xF3n", or "If X fails it's a bug"), and you encounter that condition, you MUST call \`report_application_bug\` IMMEDIATELY in that exact same turn. DO NOT perform any intermediate UI actions (such as clicking "Cancelar", closing modals, or navigating away) before calling the tool. Any intermediate UI action will cause you to lose your reasoning context in the next turn and enter an infinite loop. The call to \`report_application_bug\` must take absolute priority over any UI cleanup or close actions. DO NOT dismiss it as "expected business logic" or "referential integrity". The user's definition of a bug OVERRIDES all general reasoning.
 
-15. **FILE UPLOAD FIELDS (MANDATORY PROTOCOL)**: When the current step requires uploading an image or file (a dropzone component with text like "arrastra", "explora", "formatos", "JPEG", "PNG", or an input with aria-label containing "imagen" or "file"):
+15. **MASKED / SEQUENTIAL INPUTS (MANDATORY PROTOCOL)**: If the field is a masked identifier/code input (examples: placeholders like \`000-000-000-0000\`, OTP/PIN boxes, CLABE/account identifiers, ID/INE codes) OR the mission explicitly says "manualmente", "n\xFAmero por n\xFAmero", "d\xEDgito por d\xEDgito", or "car\xE1cter por car\xE1cter":
+   - You get EXACTLY ONE focus attempt: click the field once, or click a nearby keyboard button/icon ONCE if the UI shows one (e.g. "Teclado").
+   - Then you MUST use \`type_sequentially\` with the full string. Do NOT simulate manual typing by repeatedly clicking the field.
+   - If the field still does not accept input after that, use \`inspect_element_details\` on the field or the adjacent keyboard trigger. Never click the same input 3+ times in a row.
+   - For numeric codes, preserve exact length. Count the digits from the mission and type all of them.
+
+16. **FILE UPLOAD FIELDS (MANDATORY PROTOCOL)**: When the current step requires uploading an image or file (a dropzone component with text like "arrastra", "explora", "formatos", "JPEG", "PNG", or an input with aria-label containing "imagen" or "file"):
    - You MUST use the \`fill\` action on the file input with one of the values from the \`# AVAILABLE UPLOAD ASSETS\` section below (format: \`arcasset://<asset_id>\`).
    - If no asset matches the required type, use the value \`"placeholder:image/banner"\` \u2014 the runner will automatically generate a valid placeholder PNG image.
    - **NEVER** report a bug or inability to proceed just because you see a file upload field. You ALWAYS have a fallback.
@@ -2941,7 +3164,9 @@ When a form is divided into numbered steps (e.g., Step 1 \u2192 Step 2 \u2192 St
 
 11. **COMBOBOX KEYBOARD FALLBACK**: If you click a combobox/select field and the dropdown options (\`[li]\`, \`[OPTION]\`) are NOT visible after 1 turn, use this keyboard sequence: a) Click the combobox field ONCE. b) Use \`send_keyboard_event\` with key "ArrowDown" to open the options and highlight the first one. c) Use \`send_keyboard_event\` with key "Enter" to select it. This avoids the toggle problem and works with all dropdown implementations.
 
-12. **ERROR STOP PROTOCOL (CRITICAL)**: If you see a message starting with \`\u{1F6D1} [ERROR_CR\xCDTICO]\` or \`\u{1F6D1} ERROR POST-GUARDADO\`, do NOT assume it is a transient error. You MUST analyze the text. If it says "ya existe" or "duplicado", you MUST change the offending field value (e.g., add a random number) AND click the save button in the SAME turn. Do NOT waste a turn closing the error toast. If you retry without changing any data and the error persists, you MUST use \`report_inability_to_proceed\` immediately. Looping on the same error toast is FORBIDDEN.`,
+12. **SEQUENTIAL CODE INPUT FALLBACK (CRITICAL)**: If you are on a code/identifier step and the UI shows a field like "Identificador", an adjacent "Teclado" button, or a mask such as \`000-000-000-0000\`, NEVER spend multiple turns trying to focus the field. One click is enough. After that, use \`type_sequentially\` with the complete code string. If the keyboard button exists and the first direct focus did not work, click the keyboard button ONCE and then use \`type_sequentially\`.
+
+13. **ERROR STOP PROTOCOL (CRITICAL)**: If you see a message starting with \`\u{1F6D1} [ERROR_CR\xCDTICO]\` or \`\u{1F6D1} ERROR POST-GUARDADO\`, do NOT assume it is a transient error. You MUST analyze the text. If it says "ya existe" or "duplicado", you MUST change the offending field value (e.g., add a random number) AND click the save button in the SAME turn. Do NOT waste a turn closing the error toast. If you retry without changing any data and the error persists, you MUST use \`report_inability_to_proceed\` immediately. Looping on the same error toast is FORBIDDEN.`,
         cache_control: { type: "ephemeral" }
       },
       {
@@ -2955,7 +3180,6 @@ ${skillsContext}
 ${customUserContext}
 ${memoryContext}
 ${credentialsContext}
-${memoryBackendContext}
 ${assetContext}`
       }
     ];
@@ -3534,6 +3758,45 @@ ${report}` });
           } catch (e) {
             toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: `Error sending key: ${e.message}` });
           }
+        } else if (toolName === "type_sequentially") {
+          const { idx, text, delay_ms = 80, clear_first = true } = toolInput;
+          console.log(`>>ARCALITY_STATUS>> \u2328\uFE0F\u270D\uFE0F Type sequentially IDX:${idx} \u2192 "${text}"`);
+          const c = state.components.find((comp) => comp.idx === idx);
+          if (!c) {
+            toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: "Element not found." });
+          } else {
+            try {
+              const frame = this.page.frames()[c.frameIdx];
+              const loc = frame.locator(c.selector).first();
+              await loc.scrollIntoViewIfNeeded({ timeout: 5e3 }).catch(() => {
+              });
+              await loc.focus({ timeout: 3e3 }).catch(async () => {
+                await loc.click({ timeout: 5e3, force: true });
+              });
+              if (clear_first) {
+                await this.page.keyboard.press("Control+a").catch(() => {
+                });
+                await this.page.keyboard.press("Delete").catch(() => {
+                });
+                await this.page.waitForTimeout(100);
+              }
+              await this.page.keyboard.type(String(text), { delay: Math.max(10, Math.min(Number(delay_ms) || 80, 400)) });
+              const finalValue = await loc.evaluate((el) => {
+                if (typeof el.value === "string")
+                  return el.value;
+                if (el.isContentEditable)
+                  return el.innerText || "";
+                return document.activeElement?.value || "";
+              }).catch(() => "");
+              toolResults.push({
+                type: "tool_result",
+                tool_use_id: toolUse.id,
+                content: `\u2705 Sequential typing completed. Current value: "${finalValue}".`
+              });
+            } catch (e) {
+              toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: `Error typing sequentially: ${e.message}` });
+            }
+          }
         } else if (toolName === "interact_native_control") {
           const { idx, control_type, value } = toolInput;
           const c = state.components.find((comp) => comp.idx === idx);
@@ -3944,6 +4207,33 @@ async function readLocatorText(locator) {
   const innerText = await locator.innerText().catch(() => "");
   return typeof innerText === "string" ? innerText.trim() : "";
 }
+async function readHiddenPortalResult(page) {
+  const selectors = [
+    "input#result",
+    'input[name="result"]',
+    'input[readonly][id*="result" i]',
+    'input[readonly][name*="result" i]'
+  ];
+  for (const selector of selectors) {
+    try {
+      const locator = page.locator(selector).first();
+      if (!await locator.count().catch(() => 0))
+        continue;
+      const rawValue = await locator.inputValue().catch(async () => await locator.getAttribute("value"));
+      const raw = typeof rawValue === "string" ? rawValue.trim() : "";
+      if (!raw)
+        continue;
+      const parsed = JSON.parse(raw);
+      const status = String(parsed?.status || parsed?.Status || "").trim().toLowerCase();
+      const message = String(parsed?.message || parsed?.Message || parsed?.detail || parsed?.error || "").trim();
+      if (status) {
+        return { status, message, raw };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
 function writeBatchMissionResult(payload) {
   const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR;
   if (!runDomainDir)
@@ -3961,7 +4251,10 @@ function writeBatchMissionResult(payload) {
 }
 (0, import_test.test)("Arcality AI Runner", async ({ page }, testInfo) => {
   import_test.test.setTimeout(12e5);
-  const contextDir = process.env.CONTEXT_DIR || "out";
+  const contextDir = process.env.CONTEXT_DIR;
+  if (!contextDir) {
+    throw new Error("Missing CONTEXT_DIR. Arcality must run through the CLI wrapper so outputs stay inside the user project .arcality directory.");
+  }
   const activeConfig = process.env.ACTIVE_CONFIG || "Default";
   if (!process.env.BASE_URL && process.env[`${activeConfig}_URL`])
     process.env.BASE_URL = process.env[`${activeConfig}_URL`];
@@ -3988,7 +4281,8 @@ function writeBatchMissionResult(payload) {
   }
   const agent = new AIAgentHelper(page, contextDir, testInfo);
   const prompt = process.env.SMART_PROMPT || "Navega al inicio y verifica que el sitio cargue";
-  const qaContextAnalysis = analyzeQaContext(process.cwd());
+  const runtimeProjectRoot = process.env.ARCALITY_PROJECT_ROOT || process.cwd();
+  const qaContextAnalysis = analyzeQaContext(runtimeProjectRoot);
   if (qaContextAnalysis.exists && qaContextAnalysis.isValid) {
     console.log(`>>ARCALITY_STATUS>> QA Context validado al arranque (${qaContextAnalysis.ruleCount} reglas, ${qaContextAnalysis.sectionCount} secciones).`);
   } else if (qaContextAnalysis.exists) {
@@ -3999,10 +4293,24 @@ function writeBatchMissionResult(payload) {
   } else {
     console.log(`>>ARCALITY_STATUS>> QA Context local no configurado para esta mision.`);
   }
+  if (qaContextAnalysis.governance.exists) {
+    console.log(`>>ARCALITY_STATUS>> QA Context metadata: version=${qaContextAnalysis.governance.version || "N/A"} | updated_by=${qaContextAnalysis.governance.updatedBy || "N/A"} | owner_team=${qaContextAnalysis.governance.ownerTeam || "N/A"}`);
+  }
   await testInfo.attach("qa_context_summary", {
     body: Buffer.from(formatQaContextSummary(qaContextAnalysis), "utf-8"),
     contentType: "text/plain"
   });
+  const governanceIssues = getQaContextGovernanceIssues(qaContextAnalysis);
+  if (governanceIssues.length > 0) {
+    for (const issue of governanceIssues) {
+      console.log(`>>ARCALITY_STATUS>> QA Context governance issue: ${issue}`);
+    }
+  }
+  if (shouldBlockOnQaContextGovernance(qaContextAnalysis)) {
+    throw new Error(
+      `QA Context governance is required for this run (${qaContextAnalysis.governance.enforcementMode}) and is incomplete. Fix .arcality/qa-context.meta.json before continuing.`
+    );
+  }
   const successKeywords = /exitosamente|creado correctamente|guardado correctamente|misión cumplida|registered successfully|created successfully|saved successfully|operación exitosa|registro guardado|successfully|correctly/i;
   const failureKeywords = /\berror\b|falló|failed|no se puede|cannot|unable|ya existe|already exists|existente|exist|inválido|invalid|incorrecto|incorrect|ligado|linked|depende|depends|duplicado|duplicate|repetido|repeated|conflict|reintentar|retry|missing|required|obligatorio|bad request|400|500/i;
   const systemErrorKeywords = /error interno|internal error|intentarlo más tarde|try again later|inténtelo más tarde|servicio no disponible|service unavailable|something went wrong|algo salió mal|ha ocurrido un error inesperado|unexpected error|server error|no se pudo procesar|could not be processed|comuníquese con soporte|contact support/i;
@@ -4150,7 +4458,10 @@ function writeBatchMissionResult(payload) {
       const logPath = path6.join(contextDir, `agent-log-${timestampMs}.json`);
       fs6.writeFileSync(logPath, JSON.stringify(summaryPayload, null, 2));
       missionSummaryPaths.add(logPath);
-      const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR || path6.dirname(contextDir);
+      const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR;
+      if (!runDomainDir) {
+        throw new Error("Missing ARCALITY_RUN_DOMAIN_DIR. Arcality must run through the CLI wrapper so durable logs stay inside the user project .arcality directory.");
+      }
       const durableLogsDir = path6.join(runDomainDir, "logs");
       fs6.mkdirSync(durableLogsDir, { recursive: true });
       const durableLogPath = path6.join(durableLogsDir, `mission-log-${timestampMs}.json`);
@@ -4187,9 +4498,11 @@ function writeBatchMissionResult(payload) {
     const pid = process.env.ARCALITY_PROJECT_ID || "";
     const apiUrl = process.env.ARCALITY_API_URL || "";
     const apiKey = process.env.ARCALITY_API_KEY || "";
-    if (!pid || !apiUrl || !apiKey) {
+    const orgId = process.env.ARCALITY_ORG_ID || "";
+    if (!pid || !apiUrl || !apiKey || !orgId) {
+      console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria Colectiva omitida por configuraci\xF3n incompleta.`);
       if (process.env.DEBUG)
-        console.warn(`[CollectiveMemory] \u26A0\uFE0F Vars faltantes \u2014 project_id='${pid}' api_url='${apiUrl}' api_key='${apiKey ? "OK" : "MISSING"}' \u2192 NO persiste.`);
+        console.warn(`[CollectiveMemory] \u26A0\uFE0F Vars faltantes \u2014 project_id='${pid}' api_url='${apiUrl}' api_key='${apiKey ? "OK" : "MISSING"}' org_id='${orgId || "MISSING"}' \u2192 NO persiste.`);
       return;
     }
     if (collectiveMemoryPersisted && !isFailed) {
@@ -4336,8 +4649,7 @@ function writeBatchMissionResult(payload) {
       const matches = promptKeywords.filter((kw) => patternKeywords.some((pkw) => pkw.includes(kw) || kw.includes(pkw))).length;
       const isVectorMatch = true;
       if (isVectorMatch) {
-        if (process.env.DEBUG)
-          console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria Colectiva detectada (id: ${bestMatch.id}). Descargando a memoria local...`);
+        console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria Colectiva detectada (id: ${bestMatch.id}). Descargando a memoria local...`);
         reusedPatternId = bestMatch.id || "unknown";
         let patternJsonObj = {};
         try {
@@ -4574,6 +4886,35 @@ Detalles de la excepci\xF3n en consola: ${jsError}`;
     }
     if (isFinished)
       break;
+    try {
+      const hiddenResult = await readHiddenPortalResult(page);
+      if (hiddenResult) {
+        const hiddenStatus = hiddenResult.status.toLowerCase();
+        const hiddenMessage = hiddenResult.message || hiddenResult.raw;
+        if (/^(failed|error|invalid|rejected)$/.test(hiddenStatus)) {
+          console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Resultado oculto detectado: "${hiddenStatus}" - ${hiddenMessage.substring(0, 120)}`);
+          hasCriticalError = true;
+          failReason = "portal_hidden_result_error";
+          failReasoning = `El portal public\xF3 un resultado interno oculto indicando fallo: "${hiddenMessage}". Arcality detuvo la misi\xF3n para evitar loops sobre una operaci\xF3n ya rechazada.`;
+          aiMarkedSuccess = false;
+          isFinished = true;
+          history.push(`Turno ${stepCount}: \u{1F6D1} [HIDDEN_RESULT_ERROR] El portal devolvi\xF3 status="${hiddenStatus}" con mensaje "${hiddenMessage.substring(0, 200)}".`);
+          saveMissionResults();
+          break;
+        }
+        if (/^(success|succeeded|ok|completed)$/.test(hiddenStatus)) {
+          console.log(`>>ARCALITY_STATUS>> \u2728 Resultado oculto de \xE9xito detectado: "${hiddenStatus}"`);
+          aiMarkedSuccess = true;
+          hasCriticalError = false;
+          isFinished = true;
+          history.push(`Turno ${stepCount}: \u2705 [HIDDEN_RESULT_SUCCESS] El portal devolvi\xF3 status="${hiddenStatus}".`);
+          await persistCollectiveMemory();
+          saveMissionResults();
+          break;
+        }
+      }
+    } catch {
+    }
     let hasVisibleError = false;
     try {
       const errorEls = await page.locator('.toast, .alert, [role="alert"], [role="status"], .snackbar, .notification, .error-message, .mat-snack-bar-container, [class*="alert"], [class*="toast"]').all();
@@ -4727,7 +5068,7 @@ ${patternContext}` : prompt;
         const loopType = isClickLoop ? "click" : "fill";
         const uniqueTargets = isClickLoop ? uniqueClicks : uniqueFills;
         console.warn(`
-\u26A0 [OUROBOROS SUBSYSTEM: Repetitive ${loopType} loop anomaly detected]:`);
+\u26A0 Bucle repetitivo de ${loopType} detectado:`);
         console.warn(`   \xDAltimas acciones: ${lastActions.join(" \u2192 ")}`);
         response.thought = `\u{1F6D1} ERROR: Bucle repetitivo en ${loopType} sobre: ${Array.from(uniqueTargets).join(", ")}.`;
         response.finish = true;
@@ -4844,7 +5185,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
                 }
                 console.log(`
 \u{1F6D1} [AUTO-STOP] Bloqueando click repetido en "${desc}" (${sameActionCount} veces). Forzando re-evaluaci\xF3n.`);
-                history.push(`Turno ${stepCount}: \u{1F6D1} [AUTO-STOP] El click en "${desc}" fue bloqueado despu\xE9s de ${sameActionCount} repeticiones. Si es un dropdown/combobox que no abre sus opciones, usa send_keyboard_event con key "ArrowDown" para navegar opciones y "Enter" para seleccionar. NO vuelvas a hacer click en el mismo elemento.`);
+                history.push(`Turno ${stepCount}: \u{1F6D1} [AUTO-STOP] El click en "${desc}" fue bloqueado despu\xE9s de ${sameActionCount} repeticiones. Si es un dropdown/combobox que no abre sus opciones, usa send_keyboard_event con key "ArrowDown" y luego "Enter". Si es un input enmascarado o un c\xF3digo/identificador, usa type_sequentially con el valor completo despu\xE9s de UN solo enfoque. NO vuelvas a hacer click en el mismo elemento.`);
                 await page.waitForTimeout(800);
                 break;
               }