@arcadialdev/arcality 3.0.1 → 3.0.3

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

@@ -28,6 +28,24 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/configManager.mjs
+function isRealProjectId2(projectId) {
+  const id = String(projectId || "").trim();
+  if (!id)
+    return false;
+  if (id === "undefined" || id === "null")
+    return false;
+  if (/^(local|mock)_/i.test(id))
+    return false;
+  if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id))
+    return false;
+  return true;
+}
+var init_configManager = __esm({
+  "src/configManager.mjs"() {
+  }
+});
+
 // src/configLoader.mjs
 function getApiUrl() {
   return "https://arcalityqadev.arcadial.lat";
@@ -63,6 +81,7 @@ var init_configLoader = __esm({
     import_node_path = __toESM(require("node:path"), 1);
     import_node_os = __toESM(require("node:os"), 1);
     import_dotenv = __toESM(require("dotenv"), 1);
+    init_configManager();
     import_dotenv.default.config();
     CONFIG_DIR = import_node_path.default.join(import_node_os.default.homedir(), ".arcality");
     CONFIG_FILE = import_node_path.default.join(CONFIG_DIR, "config.json");
@@ -80,44 +99,6 @@ __export(arcalityClient_exports, {
   startMission: () => startMission,
   validateApiKey: () => validateApiKey
 });
-function getTodayKey() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-function loadLocalUsage() {
-  try {
-    if (import_node_fs2.default.existsSync(USAGE_FILE)) {
-      return JSON.parse(import_node_fs2.default.readFileSync(USAGE_FILE, "utf8"));
-    }
-  } catch {
-  }
-  return {};
-}
-function saveLocalUsage(usage) {
-  try {
-    if (!import_node_fs2.default.existsSync(CONFIG_DIR)) {
-      import_node_fs2.default.mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-    import_node_fs2.default.writeFileSync(USAGE_FILE, JSON.stringify(usage, null, 2), "utf8");
-  } catch {
-  }
-}
-function getLocalDailyUsage() {
-  const usage = loadLocalUsage();
-  const today = getTodayKey();
-  return usage[today] || 0;
-}
-function incrementLocalUsage() {
-  const usage = loadLocalUsage();
-  const today = getTodayKey();
-  usage[today] = (usage[today] || 0) + 1;
-  const keys = Object.keys(usage).sort().reverse();
-  const cleaned = {};
-  for (const k of keys.slice(0, 7)) {
-    cleaned[k] = usage[k];
-  }
-  saveLocalUsage(cleaned);
-  return cleaned[today];
-}
 function loadArcalityConfig() {
   try {
     const configPath = import_node_path2.default.join(process.cwd(), "arcality.config");
@@ -143,17 +124,16 @@ function getEffectiveApiKey() {
 }
 function loadProjectId() {
   const localConfig = loadArcalityConfig();
-  if (localConfig?.projectId)
-    return localConfig.projectId;
-  return process.env.ARCALITY_PROJECT_ID || null;
+  const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID || null;
+  return isRealProjectId2(projectId) ? projectId : null;
 }
 async function validateApiKey() {
   const key = getEffectiveApiKey();
   if (!key) {
-    return { valid: false, error: "no_api_key", mode: "mock" };
+    return { valid: false, error: "no_api_key", mode: "live" };
   }
   if (!key.startsWith("arc_")) {
-    return { valid: false, error: "invalid_format", mode: "mock" };
+    return { valid: false, error: "invalid_format", mode: "live" };
   }
   const apiBase = getEffectiveApiBase();
   if (apiBase) {
@@ -183,18 +163,11 @@ async function validateApiKey() {
       return { ...data, valid: true, mode: "live" };
     } catch (e) {
       const reason = e?.name === "AbortError" ? "timeout (5s)" : e?.message || "unknown";
-      console.warn(`\u26A0\uFE0F  Backend not available (${apiBase}): ${reason}. Using local mode.`);
+      console.warn(`Backend not available (${apiBase}): ${reason}.`);
+      return { valid: false, error: "backend_unavailable", mode: "live", reason };
     }
   }
-  const dailyUsed = getLocalDailyUsage();
-  return {
-    valid: true,
-    mode: "mock",
-    plan: "internal",
-    daily_used: dailyUsed,
-    daily_limit: DAILY_MISSION_LIMIT,
-    remaining: Math.max(0, DAILY_MISSION_LIMIT - dailyUsed)
-  };
+  return { valid: false, error: "backend_unavailable", mode: "live" };
 }
 async function startMission(prompt, targetUrl) {
   const key = getEffectiveApiKey();
@@ -204,6 +177,9 @@ async function startMission(prompt, targetUrl) {
   if (apiBase) {
     try {
       const projectId = process.env.ARCALITY_PROJECT_ID || loadArcalityConfig()?.projectId;
+      if (!isRealProjectId2(projectId)) {
+        return { allowed: false, error: "no_project_id" };
+      }
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), 5e3);
       const res = await fetch(`${apiBase}/api/v1/missions/start`, {
@@ -230,32 +206,11 @@ async function startMission(prompt, targetUrl) {
       return { allowed: true, ...await res.json() };
     } catch (e) {
       const reason = e?.name === "AbortError" ? "timeout (5s)" : e?.message || "unknown";
-      console.warn(`\u26A0\uFE0F  startMission failed (${apiBase}): ${reason}. Falling back to mock mode.`);
+      console.warn(`startMission failed (${apiBase}): ${reason}.`);
+      return { allowed: false, error: "backend_unavailable", reason };
     }
   }
-  const dailyUsed = getLocalDailyUsage();
-  if (dailyUsed >= DAILY_MISSION_LIMIT) {
-    const tomorrow = /* @__PURE__ */ new Date();
-    tomorrow.setDate(tomorrow.getDate() + 1);
-    tomorrow.setHours(0, 0, 0, 0);
-    return {
-      allowed: false,
-      error: "mission_limit_exceeded",
-      daily_used: dailyUsed,
-      daily_limit: DAILY_MISSION_LIMIT,
-      remaining: 0,
-      resets_at: tomorrow.toISOString()
-    };
-  }
-  const newCount = incrementLocalUsage();
-  return {
-    allowed: true,
-    mode: "mock",
-    mission_id: `mock_${Date.now().toString(36)}`,
-    daily_used: newCount,
-    daily_limit: DAILY_MISSION_LIMIT,
-    remaining: DAILY_MISSION_LIMIT - newCount
-  };
+  return { allowed: false, error: "backend_unavailable" };
 }
 async function fetchMissions(projectId, tags) {
   const key = getEffectiveApiKey();
@@ -263,7 +218,7 @@ async function fetchMissions(projectId, tags) {
     return { success: false, error: "no_api_key", missions: [] };
   const apiBase = getEffectiveApiBase();
   if (!apiBase) {
-    return { success: true, mode: "mock", missions: [] };
+    return { success: false, error: "backend_unavailable", missions: [] };
   }
   try {
     const url = new URL(`${apiBase}/api/v1/projects/${projectId}/missions`);
@@ -295,8 +250,10 @@ async function fetchMissions(projectId, tags) {
 }
 async function endMission(missionId, result, usage = null, failReason = null, reportUrl = null, failReasoning = null) {
   const apiBase = getEffectiveApiBase();
-  if (!apiBase || !missionId)
-    return { ok: true };
+  if (!apiBase)
+    return { ok: false, error: "backend_unavailable" };
+  if (!missionId)
+    return { ok: false, error: "no_mission_id" };
   const key = getEffectiveApiKey();
   try {
     await fetch(`${apiBase}/api/v1/missions/${missionId}/end`, {
@@ -328,7 +285,7 @@ async function createAdoTask(title, description) {
     return { success: false, error: "no_api_url" };
   }
   const projectId = loadProjectId();
-  if (!projectId) {
+  if (!isRealProjectId2(projectId)) {
     if (process.env.DEBUG)
       console.log(`[ADO] No hay Project ID configurado. Omitiendo creaci\xF3n de Task en Azure DevOps.`);
     return { success: false, error: "no_project_id" };
@@ -377,7 +334,7 @@ async function createAdoTask(title, description) {
 }
 async function getEvidenceSasToken(missionId, projectId) {
   const apiBase = getEffectiveApiBase();
-  if (!apiBase || !missionId)
+  if (!apiBase || !missionId || !isRealProjectId2(projectId))
     return null;
   const key = getEffectiveApiKey();
   if (!key)
@@ -404,13 +361,13 @@ async function getEvidenceSasToken(missionId, projectId) {
     return null;
   }
 }
-var import_node_fs2, import_node_path2, DAILY_MISSION_LIMIT, USAGE_FILE, ArcalityClient;
+var import_node_fs2, import_node_path2, USAGE_FILE, ArcalityClient;
 var init_arcalityClient = __esm({
   "src/arcalityClient.mjs"() {
     import_node_fs2 = __toESM(require("node:fs"), 1);
     import_node_path2 = __toESM(require("node:path"), 1);
     init_configLoader();
-    DAILY_MISSION_LIMIT = 35;
+    init_configManager();
     USAGE_FILE = import_node_path2.default.join(CONFIG_DIR, "usage.json");
     ArcalityClient = class {
       constructor(apiKey) {
@@ -821,6 +778,18 @@ var path4 = __toESM(require("path"));
 // src/KnowledgeService.ts
 var crypto = __toESM(require("crypto"));
 var import_chalk = __toESM(require("chalk"));
+function isRealProjectId(projectId) {
+  const id = String(projectId || "").trim();
+  if (!id)
+    return false;
+  if (id === "undefined" || id === "null")
+    return false;
+  if (/^(local|mock)_/i.test(id))
+    return false;
+  if (/^0{8}-0{4}-0{4}-0{4}-0{12}$/i.test(id))
+    return false;
+  return true;
+}
 var KnowledgeService = class _KnowledgeService {
   static instance;
   apiBase;
@@ -859,10 +828,10 @@ var KnowledgeService = class _KnowledgeService {
     this.projectId = id;
   }
   getProjectId() {
-    if (!this.projectId || this.projectId === "undefined" || this.projectId === "null") {
+    if (!isRealProjectId(this.projectId)) {
       this.projectId = process.env.ARCALITY_PROJECT_ID || null;
     }
-    return this.projectId;
+    return isRealProjectId(this.projectId) ? this.projectId : null;
   }
   /**
    * 1. Gestión de Proyectos
@@ -877,7 +846,8 @@ var KnowledgeService = class _KnowledgeService {
       const data = await res.json();
       return data.projects || [];
     } catch (e) {
-      console.warn(import_chalk.default.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
+      if (process.env.DEBUG)
+        console.warn(import_chalk.default.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
       return [];
     }
   }
@@ -895,7 +865,8 @@ var KnowledgeService = class _KnowledgeService {
         return null;
       return await res.json();
     } catch (e) {
-      console.error(import_chalk.default.red(`[KnowledgeService] Fall\xF3 creaci\xF3n de proyecto: ${e.message}`));
+      if (process.env.DEBUG)
+        console.error(import_chalk.default.red(`[KnowledgeService] Fall\xF3 creaci\xF3n de proyecto: ${e.message}`));
       return null;
     }
   }
@@ -903,8 +874,9 @@ var KnowledgeService = class _KnowledgeService {
    * 2. Ingesta (Post-Percept)
    */
   async ingest(payload) {
-    if (!payload.project_id || payload.project_id === "undefined") {
-      console.warn(import_chalk.default.yellow(`[Knowledge] Ingesta cancelada: project_id es inv\xE1lido.`));
+    if (!isRealProjectId(payload.project_id)) {
+      if (process.env.DEBUG)
+        console.warn(import_chalk.default.yellow(`[Knowledge] Ingesta cancelada: project_id es inv\xE1lido.`));
       return;
     }
     try {
@@ -925,7 +897,8 @@ var KnowledgeService = class _KnowledgeService {
         }
       }
     } catch (e) {
-      console.warn(import_chalk.default.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
+      if (process.env.DEBUG)
+        console.warn(import_chalk.default.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
     }
   }
   /**
@@ -948,7 +921,8 @@ var KnowledgeService = class _KnowledgeService {
         return null;
       return await res.json();
     } catch (e) {
-      console.warn(import_chalk.default.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
+      if (process.env.DEBUG)
+        console.warn(import_chalk.default.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
       return null;
     }
   }
@@ -977,7 +951,8 @@ var KnowledgeService = class _KnowledgeService {
           severity
         })
       });
-      console.log(import_chalk.default.green(`[Knowledge] Nueva regla registrada: ${title}`));
+      if (process.env.DEBUG)
+        console.log(import_chalk.default.green(`[Knowledge] Nueva regla registrada: ${title}`));
     } catch (e) {
     }
   }
@@ -1004,7 +979,8 @@ var KnowledgeService = class _KnowledgeService {
           source: "agent_auto"
         })
       });
-      console.log(import_chalk.default.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
+      if (process.env.DEBUG)
+        console.log(import_chalk.default.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
     } catch (e) {
     }
   }
@@ -1031,7 +1007,8 @@ var KnowledgeService = class _KnowledgeService {
           source: "agent_auto"
         })
       });
-      console.log(import_chalk.default.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
+      if (process.env.DEBUG)
+        console.log(import_chalk.default.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
     } catch (e) {
     }
   }
@@ -1052,23 +1029,33 @@ var getOrgId = () => process.env.ARCALITY_ORG_ID;
 var getMissionId = () => process.env.ARCALITY_MISSION_ID || EMPTY_GUID;
 var EMPTY_GUID = "00000000-0000-0000-0000-000000000000";
 var configWarningLogged = false;
+function hasRealProjectId(pid) {
+  if (!pid || pid === EMPTY_GUID)
+    return false;
+  if (/^(local|mock)_/i.test(pid))
+    return false;
+  if (pid === "undefined" || pid === "null")
+    return false;
+  return true;
+}
 function isConfigured() {
   const base = getBase();
   const key = getKey();
   const pid = getPid();
   const orgId = getOrgId();
-  if (!base || !key || !pid || pid === EMPTY_GUID || !orgId) {
+  if (!base || !key || !hasRealProjectId(pid) || !orgId) {
     if (!configWarningLogged) {
       const missing = [];
       if (!base)
         missing.push("ARCALITY_API_URL");
       if (!key)
         missing.push("ARCALITY_API_KEY");
-      if (!pid || pid === EMPTY_GUID)
+      if (!hasRealProjectId(pid))
         missing.push("ARCALITY_PROJECT_ID");
       if (!orgId)
         missing.push("ARCALITY_ORG_ID");
-      console.warn(`[CollectiveMemory] Service disabled. Missing: ${missing.join(", ")}`);
+      if (process.env.DEBUG)
+        console.warn(`[CollectiveMemory] Service disabled. Missing: ${missing.join(", ")}`);
       configWarningLogged = true;
     }
     return false;
@@ -1188,8 +1175,10 @@ async function searchPromptPattern(prompt, limit = 5) {
       prompt,
       limit
     };
-    console.log(`[PatternSearch] \u{1F50D} Buscando patrones en: ${apiUrl}`);
-    console.log(`[PatternSearch] \u{1F4E6} Payload: ${JSON.stringify(payload, null, 2)}`);
+    const debugPatternSearch = process.env.DEBUG === "true" || process.env.ARCALITY_DEBUG === "true";
+    if (debugPatternSearch) {
+      console.log(`[PatternSearch] POST ${apiUrl} | prompt_chars=${prompt.length} | limit=${limit}`);
+    }
     const res = await fetch(apiUrl, {
       method: "POST",
       headers: {
@@ -1199,15 +1188,19 @@ async function searchPromptPattern(prompt, limit = 5) {
       body: JSON.stringify(payload)
     });
     if (!res.ok) {
-      console.warn(`[PatternSearch] HTTP ${res.status} from ${apiUrl}`);
+      if (debugPatternSearch)
+        console.warn(`[PatternSearch] HTTP ${res.status} from ${apiUrl}`);
       return [];
     }
     const data = await res.json();
     const results = Array.isArray(data) ? data : data.matches || data.results || [];
-    console.log(`[PatternSearch] \u2705 ${results.length} patrones encontrados.`);
+    if (debugPatternSearch)
+      console.log(`[PatternSearch] ${results.length} patrones encontrados.`);
     return results;
   } catch (err) {
-    console.warn(`[PatternSearch] \u26A0\uFE0F Error buscando patrones: ${err?.message || "unknown"}`);
+    if (process.env.DEBUG === "true" || process.env.ARCALITY_DEBUG === "true") {
+      console.warn(`[PatternSearch] Error buscando patrones: ${err?.message || "unknown"}`);
+    }
     return [];
   }
 }
@@ -2261,10 +2254,12 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
           contextData.fields.forEach((f) => memoryBackendContext += `- ${f.field_identifier} (${f.field_type}) - Required: ${f.is_required}
 `);
         }
-        console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Contexto de Memoria Colectiva inyectado (${contextData.rules?.length || 0} reglas, ${contextData.fields?.length || 0} campos).`);
+        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).`);
       }
     } catch (e) {
-      console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error en hook de contexto: ${e.message}`);
+      if (process.env.DEBUG)
+        console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error en hook de contexto: ${e.message}`);
     }
     let customUserContext = "";
     try {
@@ -3445,6 +3440,31 @@ function captureValidationRule(errorMessage, context) {
   }).catch(() => {
   });
 }
+async function readLocatorText(locator) {
+  const textContent = await locator.textContent().catch(() => null);
+  if (typeof textContent === "string") {
+    const normalized = textContent.trim();
+    if (normalized)
+      return normalized;
+  }
+  const innerText = await locator.innerText().catch(() => "");
+  return typeof innerText === "string" ? innerText.trim() : "";
+}
+function writeBatchMissionResult(payload) {
+  const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR;
+  if (!runDomainDir)
+    return;
+  try {
+    if (!fs5.existsSync(runDomainDir)) {
+      fs5.mkdirSync(runDomainDir, { recursive: true });
+    }
+    fs5.writeFileSync(
+      path5.join(runDomainDir, "mission-result.json"),
+      JSON.stringify(payload, null, 2)
+    );
+  } catch {
+  }
+}
 (0, import_test.test)("Arcality AI Runner", async ({ page }, testInfo) => {
   import_test.test.setTimeout(12e5);
   const contextDir = process.env.CONTEXT_DIR || "out";
@@ -3588,15 +3608,55 @@ function captureValidationRule(errorMessage, context) {
       };
       memories.push(missionData);
       fs5.writeFileSync(memoryFile2, JSON.stringify(memories, null, 2));
-      console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria guardada: ${cleanSteps.length} pasos limpios (${rawSteps.length - cleanSteps.length} corruptos filtrados)`);
+      if (process.env.DEBUG)
+        console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria guardada: ${cleanSteps.length} pasos limpios (${rawSteps.length - cleanSteps.length} corruptos filtrados)`);
     } catch (err) {
       console.error("\u274C Fall\xF3 al guardar memoria:", err);
     }
     try {
-      const logPath = path5.join(contextDir, `agent-log-${Date.now()}.json`);
-      fs5.writeFileSync(logPath, JSON.stringify({ prompt, history, steps: stepCount, success: finalSuccess, error: hasCriticalError, fail_reason: failReason, fail_reasoning: failReasoning, usage: totalMissionUsage, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
+      const timestampIso = (/* @__PURE__ */ new Date()).toISOString();
+      const timestampMs = Date.now();
+      const summaryPayload = {
+        prompt,
+        history,
+        steps: stepCount,
+        success: finalSuccess,
+        error: hasCriticalError,
+        fail_reason: failReason,
+        fail_reasoning: failReasoning,
+        usage: totalMissionUsage,
+        target: process.env.BASE_URL || "",
+        target_path: process.env.TARGET_PATH || "",
+        report_dir: process.env.REPORTS_DIR || "",
+        timestamp: timestampIso
+      };
+      const logPath = path5.join(contextDir, `agent-log-${timestampMs}.json`);
+      fs5.writeFileSync(logPath, JSON.stringify(summaryPayload, null, 2));
+      const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR || path5.dirname(contextDir);
+      const durableLogsDir = path5.join(runDomainDir, "logs");
+      fs5.mkdirSync(durableLogsDir, { recursive: true });
+      fs5.writeFileSync(
+        path5.join(durableLogsDir, `mission-log-${timestampMs}.json`),
+        JSON.stringify(summaryPayload, null, 2)
+      );
+      writeBatchMissionResult(summaryPayload);
       try {
-        fs5.appendFileSync(path5.join(contextDir, "arcality-history.log"), JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), mission: prompt.substring(0, 150), success: finalSuccess, steps: stepCount, usage: totalMissionUsage }) + "\n");
+        const historyLine = JSON.stringify({
+          ts: timestampIso,
+          mission: prompt.substring(0, 150),
+          success: finalSuccess,
+          steps: stepCount,
+          fail_reason: failReason,
+          report_dir: process.env.REPORTS_DIR || ""
+        }) + "\n";
+        fs5.appendFileSync(
+          path5.join(contextDir, "arcality-history.log"),
+          historyLine
+        );
+        fs5.appendFileSync(
+          path5.join(durableLogsDir, "arcality-history.log"),
+          historyLine
+        );
       } catch (e) {
       }
     } catch (err) {
@@ -3618,7 +3678,8 @@ function captureValidationRule(errorMessage, context) {
       return;
     }
     if (!isFailed && stepsData.length === 0 && stepsDataBackup.length === 0) {
-      console.warn(`[CollectiveMemory] \u26A0\uFE0F stepsData vac\xEDo en path de \xE9xito \u2014 intentando usar backup...`);
+      if (process.env.DEBUG)
+        console.warn(`[CollectiveMemory] \u26A0\uFE0F stepsData vac\xEDo en path de \xE9xito \u2014 intentando usar backup...`);
     }
     const baseSteps = stepsData.length > 0 ? stepsData : stepsDataBackup;
     const effectiveSteps = baseSteps.filter((step) => {
@@ -3629,11 +3690,15 @@ function captureValidationRule(errorMessage, context) {
       }
       return true;
     });
-    console.log(`
+    if (process.env.DEBUG)
+      console.log(`
 ======================================================`);
-    console.log(`\u{1F9E0} [ARCHIVE SUBSYSTEM - KNOWLEDGE INGESTION]`);
-    console.log(`>>arcality>> Saving telemetry (project: ${pid}, steps: ${effectiveSteps.length}, isFailed: ${isFailed})...`);
-    console.log(`======================================================
+    if (process.env.DEBUG)
+      console.log(`\u{1F9E0} [ARCHIVE SUBSYSTEM - KNOWLEDGE INGESTION]`);
+    if (process.env.DEBUG)
+      console.log(`>>arcality>> Saving telemetry (project: ${pid}, steps: ${effectiveSteps.length}, isFailed: ${isFailed})...`);
+    if (process.env.DEBUG)
+      console.log(`======================================================
 `);
     try {
       const stepsNarrative = effectiveSteps.map((s) => `${s.action_data?.action || "action"} "${s.componentName}" en ${s.url}`).join(" \u2192 ").substring(0, 500);
@@ -3644,9 +3709,9 @@ function captureValidationRule(errorMessage, context) {
           title: `Flujo exitoso: ${prompt.substring(0, 100)}`,
           content: stepsNarrative || prompt.substring(0, 500)
         });
-        if (knowledgeId)
+        if (process.env.DEBUG && knowledgeId)
           console.log(`\u{1F9E0} [COLLECTIVE MEMORY] \u2705 Knowledge guardado: ${knowledgeId}`);
-        else
+        else if (process.env.DEBUG)
           console.warn(`[CollectiveMemory] \u26A0\uFE0F pushKnowledge retorn\xF3 null (revisar HTTP status arriba)`);
         const uniqueUrls = [...new Set(effectiveSteps.map((s) => s.url).filter(Boolean))];
         if (uniqueUrls.length > 1) {
@@ -3656,7 +3721,7 @@ function captureValidationRule(errorMessage, context) {
             description: `Arcality naveg\xF3 ${uniqueUrls.length} p\xE1ginas: ${uniqueUrls.join(" \u2192 ").substring(0, 400)}`,
             severity: "suggestion"
           });
-          if (ruleId)
+          if (process.env.DEBUG && ruleId)
             console.log(`\u{1F9E0} [COLLECTIVE MEMORY] \u2705 Regla NAVIGATION guardada: ${ruleId}`);
         }
         const submitStep = effectiveSteps.find(
@@ -3669,7 +3734,7 @@ function captureValidationRule(errorMessage, context) {
             description: `Flujo exitoso incluy\xF3 guardado/creaci\xF3n. Pasos: ${stepsNarrative.substring(0, 400)}`,
             severity: "important"
           });
-          if (ruleId2)
+          if (process.env.DEBUG && ruleId2)
             console.log(`\u{1F9E0} [COLLECTIVE MEMORY] \u2705 Regla UI_UX guardada: ${ruleId2}`);
         }
       } else {
@@ -3679,13 +3744,14 @@ function captureValidationRule(errorMessage, context) {
           description: `Arcality no pudo completar: "${prompt.substring(0, 200)}". \xDAltimos pasos: ${stepsNarrative.substring(0, 300)}`,
           severity: "important"
         });
-        if (failRuleId)
+        if (process.env.DEBUG && failRuleId)
           console.log(`\u{1F9E0} [COLLECTIVE MEMORY] \u2705 Regla de fallo guardada: ${failRuleId}`);
-        else
+        else if (process.env.DEBUG)
           console.warn(`[CollectiveMemory] \u26A0\uFE0F No se pudo persistir misi\xF3n fallida`);
       }
     } catch (err) {
-      console.warn(`[CollectiveMemory] \u274C Error inesperado en persistCollectiveMemory: ${err?.message}`);
+      if (process.env.DEBUG)
+        console.warn(`[CollectiveMemory] \u274C Error inesperado en persistCollectiveMemory: ${err?.message}`);
     }
   };
   console.log(`
@@ -3750,7 +3816,8 @@ function captureValidationRule(errorMessage, context) {
       const matches = promptKeywords.filter((kw) => patternKeywords.some((pkw) => pkw.includes(kw) || kw.includes(pkw))).length;
       const isVectorMatch = true;
       if (isVectorMatch) {
-        console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria Colectiva detectada (id: ${bestMatch.id}). Descargando a memoria local...`);
+        if (process.env.DEBUG)
+          console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria Colectiva detectada (id: ${bestMatch.id}). Descargando a memoria local...`);
         reusedPatternId = bestMatch.id || "unknown";
         let patternJsonObj = {};
         try {
@@ -3869,7 +3936,7 @@ ${readableHistory}`;
         let foundSuccessToast = false;
         for (const el of feedbackEls) {
           if (await el.isVisible().catch(() => false)) {
-            const txt = await el.innerText().catch(() => "");
+            const txt = await readLocatorText(el);
             if (successKeywords.test(txt.toLowerCase())) {
               foundSuccessToast = true;
               console.log(`>>ARCALITY_STATUS>> \u2728 Auto-Success: Toast de \xE9xito detectado: "${txt.substring(0, 60)}"`);
@@ -3894,7 +3961,7 @@ ${readableHistory}`;
       if (btnCount > 0) {
         const firstBtn = finalSaveBtn.first();
         if (await firstBtn.isVisible().catch(() => false) && await firstBtn.isEnabled().catch(() => false)) {
-          const btnText = await firstBtn.innerText().catch(() => "");
+          const btnText = await readLocatorText(firstBtn);
           const isModalOpen = await page.locator('[role="dialog"], .modal, .mat-dialog-container').first().isVisible().catch(() => false);
           if (!isModalOpen) {
             console.log(`
@@ -3907,7 +3974,7 @@ ${readableHistory}`;
             let proactiveSuccess = false;
             for (const fb of postSaveFb) {
               if (await fb.isVisible().catch(() => false)) {
-                const fbTxt = await fb.innerText().catch(() => "");
+                const fbTxt = await readLocatorText(fb);
                 if (successKeywords.test(fbTxt)) {
                   console.log(`>>ARCALITY_STATUS>> \u2728 [PROACTIVE FINISH] \xC9xito confirmado por toast: "${fbTxt.substring(0, 60)}"`);
                   proactiveSuccess = true;
@@ -3933,7 +4000,7 @@ ${readableHistory}`;
       const initialToasts = await page.locator('.toast, .alert, [role="status"], [role="alert"]').all();
       for (const t of initialToasts) {
         if (await t.isVisible().catch(() => false)) {
-          lastSeenSuccessToast = await t.innerText().catch(() => "");
+          lastSeenSuccessToast = await readLocatorText(t);
           if (lastSeenSuccessToast)
             console.log(`>>ARCALITY_STATUS>> \u{1F4A1} Nota: Ignorando mensaje preexistente: "${lastSeenSuccessToast.substring(0, 30)}..."`);
         }
@@ -3967,7 +4034,7 @@ Detalles de la excepci\xF3n en consola: ${jsError}`;
       const systemToastEls = await page.locator('.toast, .alert, [role="alert"], [role="status"], .snackbar, .notification, .error-message, .mat-snack-bar-container').all();
       for (const el of systemToastEls) {
         if (await el.isVisible().catch(() => false)) {
-          const sysErrTxt = await el.innerText().catch(() => "");
+          const sysErrTxt = await readLocatorText(el);
           if (sysErrTxt && systemErrorKeywords.test(sysErrTxt)) {
             console.error(`
 \u{1F6D1} [SYSTEM ERROR DETECTADO] El portal report\xF3 un error de sistema no recuperable en UI:`);
@@ -3992,7 +4059,7 @@ Detalles de la excepci\xF3n en consola: ${jsError}`;
       const errorEls = await page.locator('.toast, .alert, [role="alert"], [role="status"], .snackbar, .notification, .error-message, .mat-snack-bar-container, [class*="alert"], [class*="toast"]').all();
       for (const el of errorEls) {
         if (await el.isVisible().catch(() => false)) {
-          const errTxt = await el.innerText().catch(() => "");
+          const errTxt = await readLocatorText(el);
           if (errTxt && failureKeywords.test(errTxt.toLowerCase())) {
             hasVisibleError = true;
             break;
@@ -4022,7 +4089,7 @@ Detalles de la excepci\xF3n en consola: ${jsError}`;
         const errorEls = await page.locator('.toast, .alert, [role="alert"], [role="status"], .snackbar, .notification, .error-message, .mat-snack-bar-container, [class*="alert"], [class*="toast"]').all();
         for (const el of errorEls) {
           if (await el.isVisible().catch(() => false)) {
-            const errTxt = await el.innerText().catch(() => "");
+            const errTxt = await readLocatorText(el);
             if (errTxt && failureKeywords.test(errTxt.toLowerCase())) {
               const isDuplicateError = /repetido|duplicado|ya existe|already exists/i.test(errTxt);
               const correctionHint = isDuplicateError ? `\u{1F6D1} ACCI\xD3N REQUERIDA: El valor que ingresaste ya existe en el sistema. DEBES regresar al campo que caus\xF3 el error y cambiar su valor por uno \xDANICO (agrega un sufijo como _${Date.now().toString().slice(-4)} o un n\xFAmero aleatorio). NO intentes guardar sin cambiar el valor primero.` : `\u{1F6D1} ANOMAL\xCDA UI DETECTADA: El sistema mostr\xF3 un error de validaci\xF3n. DIRECTIVA PARA ARCALITY: Si este error significa que la misi\xF3n no puede completarse (ej. un bug del sistema o un estado bloqueado), DEBES usar 'finish: true' inmediatamente y explicar el problema. Si es un simple error de formato de datos, corrige los datos y reintenta.`;
@@ -4196,7 +4263,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
               const isCriticalSuccess = textLower.includes("exitosamente") || textLower.includes("guardado") || textLower.includes("creado") || textLower.includes("success") || textLower.includes("correctamente") || textLower.includes("misi\xF3n cumplida");
               const isCriticalFeedback = isCriticalFailure || isCriticalSuccess;
               if (!isCriticalFeedback && step.type && ["span", "p", "label", "i", "svg", "img"].includes(step.type)) {
-                const elementText = await loc.innerText().catch(() => "");
+                const elementText = await readLocatorText(loc);
                 const elementTextLower = elementText.toLowerCase();
                 if (failureKeywords.test(elementTextLower)) {
                   console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Feedback de ERROR en elemento peque\xF1o: "${elementTextLower.substring(0, 50)}..."`);
@@ -4288,7 +4355,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
               let foundSuccessPost = false;
               for (const fb of postSubmitFeedback) {
                 if (await fb.isVisible().catch(() => false)) {
-                  const fbText = await fb.innerText().catch(() => "");
+                  const fbText = await readLocatorText(fb);
                   const postSuccessKw = /exitosamente|creado correctamente|guardado correctamente|operación exitosa|registro guardado|saved successfully|created successfully/i;
                   if (postSuccessKw.test(fbText)) {
                     console.log(`>>ARCALITY_STATUS>> \u2728 \xC9xito visual detectado en toast: "${fbText.substring(0, 60)}"`);
@@ -4341,7 +4408,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
                 let hasPostNavError = false;
                 for (const alertEl of postNavAlerts) {
                   if (await alertEl.isVisible().catch(() => false)) {
-                    const alertTxt = await alertEl.innerText().catch(() => "");
+                    const alertTxt = await readLocatorText(alertEl);
                     if (failureKeywords.test(alertTxt.toLowerCase())) {
                       hasPostNavError = true;
                       console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error en alerta post-guardado: "${alertTxt.substring(0, 60)}"`);
@@ -4413,7 +4480,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
                   const panels = await page.locator("igc-dockmanager [slot]").all();
                   let emptyPanelCount = 0;
                   for (const panel of panels.slice(0, 6)) {
-                    const txt = (await panel.innerText().catch(() => "")).trim();
+                    const txt = await readLocatorText(panel);
                     const isVisible = await panel.isVisible().catch(() => false);
                     if (isVisible && txt.length < 10)
                       emptyPanelCount++;
@@ -4534,7 +4601,8 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
     }
     if (response.finish) {
       if (!containsError) {
-        console.log(">>ARCALITY_STATUS>> \u2705 Arcality solicit\xF3 finalizar misi\xF3n.");
+        if (process.env.DEBUG)
+          console.log(">>ARCALITY_STATUS>> \u2705 Arcality solicit\xF3 finalizar misi\xF3n.");
         isFinished = true;
         if (!response.actions || response.actions.length === 0) {
           stepsData.push({
@@ -4554,7 +4622,7 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
         let hasVisibleFailure = false;
         for (const el of finishFeedbackEls) {
           if (await el.isVisible().catch(() => false)) {
-            const txt = await el.innerText().catch(() => "");
+            const txt = await readLocatorText(el);
             if (failureKeywords.test(txt.toLowerCase())) {
               hasVisibleFailure = true;
               console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error detectado en toast/alerta: "${txt.substring(0, 60)}"`);
@@ -4592,8 +4660,10 @@ Acci\xF3n bloqueada: Bucle de tipo ${loopType} sobre los elementos ${Array.from(
     if (stepCount > 2) {
       const allFeedback = await feedbackLocator.all();
       for (const fb of allFeedback) {
-        if (await fb.isVisible()) {
-          const rawTxt = await fb.innerText();
+        if (await fb.isVisible().catch(() => false)) {
+          const rawTxt = await readLocatorText(fb);
+          if (!rawTxt)
+            continue;
           const txt = rawTxt.toLowerCase();
           if (systemErrorKeywords.test(rawTxt)) {
             console.error(`
@@ -4735,7 +4805,8 @@ Evidence: ${JSON.stringify(v.evidence).substring(0, 400)}`,
             });
           }
         } catch (e) {
-          console.warn(">>ARCALITY_STATUS>> \u26A0\uFE0F Fall\xF3 persistir hallazgos de seguridad en Memoria Colectiva.");
+          if (process.env.DEBUG)
+            console.warn(">>ARCALITY_STATUS>> \u26A0\uFE0F Fall\xF3 persistir hallazgos de seguridad en Memoria Colectiva.");
         }
       } else {
         console.log(`>>ARCALITY_STATUS>> \u{1F6E1}\uFE0F Escaneo de seguridad completado. No se encontraron problemas.`);
@@ -4754,7 +4825,8 @@ Evidence: ${JSON.stringify(v.evidence).substring(0, 400)}`,
   }
   saveMissionResults();
   if (!aiMarkedSuccess) {
-    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}`);
+    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}`);
     await persistCollectiveMemory(true).catch(() => {
     });
     let finalErrorMsg = `Misi\xF3n no completada o finalizada con errores.
@@ -4773,7 +4845,8 @@ ${failReasoning}
 `;
     throw new Error(finalErrorMsg);
   } else {
-    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}`);
+    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}`);
   }
   if (fs5.existsSync(contextDir)) {
     try {