@arcadialdev/arcality 4.0.0 → 4.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadialdev/arcality",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "El primer ingeniero QA Autónomo integrado al CI/CD. Creado por Arcadial.",
   "main": "index.js",
   "scripts": {

package/scripts/gen-and-run.mjs

@@ -641,7 +641,7 @@ async function waitForEnter(message = 'Presiona Enter para continuar...', option
 }
 
 function getMissionStartPath(missionSpec, collectionMeta = null, fallbackPath = '') {
-    return missionSpec.pagePath || missionSpec.startAt || missionSpec.page || collectionMeta?.defaultPagePath || fallbackPath;
+    return missionSpec.startAt || missionSpec.page || missionSpec.pagePath || collectionMeta?.defaultPagePath || fallbackPath;
 }
 
 function listMissionLogFiles(contextDir) {

package/scripts/generate.mjs

@@ -78,6 +78,19 @@ function matchesPageFilters(routeEntry, filters) {
         return haystacks.some(value => value === normalized || value.includes(normalized));
     });
 }
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+function isLikelyUuidFilter(filter) {
+    return UUID_RE.test(String(filter || '').trim());
+}
+
+function formatRouteExamples(routes, maxItems = 3) {
+    return routes
+        .slice(0, maxItems)
+        .map(entry => `${entry.route} -> ${entry.pagePath}`)
+        .join('\n- ');
+}
+
 
 function limitEntries(entries, count) {
     if (!Number.isFinite(count) || count <= 0) return entries;
@@ -114,6 +127,14 @@ function printSummary(analysis, selectedRoutes, options, generationContext) {
 
     if (selectedRoutes.length === 0) {
         console.log('\nNo candidate routes matched the provided filters.');
+        const uuidFilters = (options.page || []).filter(isLikelyUuidFilter);
+        if (uuidFilters.length > 0) {
+            console.log('Tip: the current --page filter only matches route fragments or page file paths, not backend page IDs or UUIDs.');
+        }
+        if ((options.page || []).length > 0 && analysis.routes.length > 0) {
+            console.log('Try values such as a route (`/checkout`) or a page path fragment (`app/checkout/page.tsx`).');
+            console.log(`Examples:\n- ${formatRouteExamples(analysis.routes)}`);
+        }
         return;
     }
 

package/src/services/collectiveMemoryService.ts

@@ -16,32 +16,32 @@ const getPid = () => process.env.ARCALITY_PROJECT_ID || '';
 const getOrgId = () => process.env.ARCALITY_ORG_ID;
 const getMissionId = () => process.env.ARCALITY_MISSION_ID || EMPTY_GUID;
 
-const EMPTY_GUID = '00000000-0000-0000-0000-000000000000';
-
-let configWarningLogged = false;
-
-function hasRealProjectId(pid: string): boolean {
-    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(): boolean {
+const EMPTY_GUID = '00000000-0000-0000-0000-000000000000';
+
+let configWarningLogged = false;
+
+function hasRealProjectId(pid: string): boolean {
+    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(): boolean {
     const base = getBase();
     const key = getKey();
     const pid = getPid();
     const orgId = getOrgId();
 
-    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 (!hasRealProjectId(pid)) missing.push('ARCALITY_PROJECT_ID');
+    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 (!hasRealProjectId(pid)) missing.push('ARCALITY_PROJECT_ID');
             if (!orgId) missing.push('ARCALITY_ORG_ID');
             
-            if (process.env.DEBUG) console.warn(`[CollectiveMemory] Service disabled. Missing: ${missing.join(', ')}`);
+            if (process.env.DEBUG) console.warn(`[CollectiveMemory] Service disabled. Missing: ${missing.join(', ')}`);
             configWarningLogged = true;
         }
         return false;
@@ -49,7 +49,7 @@ function isConfigured(): boolean {
     return true;
 }
 
-// ─── 1. REGLAS DE UI / NEGOCIO ──────────────────────────────────────────────
+// ������ 1. REGLAS DE UI / NEGOCIO ��������������������������������������������������������������������������������������������
 
 export type RuleType = 'UI_UX' | 'VALIDATION' | 'NAVIGATION' | 'BUSINESS' | 'SECURITY';
 export type Severity = 'critical' | 'important' | 'suggestion';
@@ -85,7 +85,7 @@ export async function pushRule(rule: {
         }
 
         const data = await res.json();
-        if (process.env.DEBUG) console.log(`\x1b[32m[CollectiveMemory] ✅ Regla guardada: "${rule.title}"\x1b[0m`);
+        if (process.env.DEBUG) console.log(`\x1b[32m[CollectiveMemory] �S& Regla guardada: "${rule.title}"\x1b[0m`);
         return data.id ?? null;
     } catch (err: any) {
         if (process.env.DEBUG) console.warn(`[CollectiveMemory] pushRule error: ${err?.message}`);
@@ -93,7 +93,7 @@ export async function pushRule(rule: {
     }
 }
 
-// ─── 2. CATÁLOGO DE CAMPOS ──────────────────────────────────────────────────
+// ������ 2. CATÁLOGO DE CAMPOS ����������������������������������������������������������������������������������������������������
 
 export type FieldType = 'email' | 'password' | 'text' | 'number' | 'select' | 'checkbox' | 'textarea' | 'date';
 
@@ -138,12 +138,12 @@ export async function pushField(field: {
         const data = await res.json();
         return data.id ?? null;
     } catch (err: any) {
-        // Silencioso — fire-and-forget, 'terminated' es esperado al finalizar el proceso
+        // Silencioso � fire-and-forget, 'terminated' es esperado al finalizar el proceso
         return null;
     }
 }
 
-// ─── 3. CONOCIMIENTO / DOCUMENTACIÓN ────────────────────────────────────────
+// ������ 3. CONOCIMIENTO / DOCUMENTACI�N ��������������������������������������������������������������������������������
 
 export type DocType = 'PROCESS' | 'VALIDATION' | 'NAVIGATION' | 'COMPONENT' | 'GENERAL';
 
@@ -176,7 +176,7 @@ export async function pushKnowledge(knowledge: {
         }
 
         const data = await res.json();
-        if (process.env.DEBUG) console.log(`\x1b[32m[CollectiveMemory] ✅ Conocimiento guardado: "${knowledge.title}"\x1b[0m`);
+        if (process.env.DEBUG) console.log(`\x1b[32m[CollectiveMemory] �S& Conocimiento guardado: "${knowledge.title}"\x1b[0m`);
         return data.id ?? null;
     } catch (err: any) {
         if (process.env.DEBUG) console.warn(`[CollectiveMemory] pushKnowledge error: ${err?.message}`);
@@ -184,10 +184,13 @@ export async function pushKnowledge(knowledge: {
     }
 }
 
-// ─── 4. PROMPT EXECUTION PATTERNS ─────────────────────────────────────────────
+// ������ 4. PROMPT EXECUTION PATTERNS ������������������������������������������������������������������������������������������
 
 export async function searchPromptPattern(prompt: string, limit: number = 5): Promise<any[]> {
-    if (!isConfigured()) return [];
+    if (!isConfigured()) {
+        console.warn(`[PatternSearch] Omitido: configuraci�n incompleta para prompt-execution-patterns/search`);
+        return [];
+    }
     try {
         const apiUrl = process.env.ARCALITY_API_URL ? `${process.env.ARCALITY_API_URL}/api/v1/prompt-execution-patterns/search` : `${getBase()}/prompt-execution-patterns/search`;
 
@@ -198,10 +201,11 @@ export async function searchPromptPattern(prompt: string, limit: number = 5): Pr
             limit: limit
         };
 
-        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 debugPatternSearch = process.env.DEBUG === 'true' || process.env.ARCALITY_DEBUG === 'true';
+        console.log(`[PatternSearch] Iniciando b�squeda | prompt_chars=${prompt.length} | limit=${limit} | project_id=${getPid() || 'missing'} | org_id=${getOrgId() || 'missing'}`);
+        if (debugPatternSearch) {
+            console.log(`[PatternSearch] POST ${apiUrl} | prompt_preview="${prompt.substring(0, 80).replace(/\s+/g, ' ')}"`);
+        }
 
         const res = await fetch(apiUrl, {
             method: 'POST',
@@ -213,20 +217,23 @@ export async function searchPromptPattern(prompt: string, limit: number = 5): Pr
         });
 
         if (!res.ok) {
-            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 || []);
-        if (debugPatternSearch) console.log(`[PatternSearch] ${results.length} patrones encontrados.`);
-        return results;
-    } catch (err: any) {
-        if (process.env.DEBUG === 'true' || process.env.ARCALITY_DEBUG === 'true') {
-            console.warn(`[PatternSearch] Error buscando patrones: ${err?.message || 'unknown'}`);
-        }
-        return [];
-    }
-}
+            const responseText = await res.text().catch(() => '');
+            console.warn(`[PatternSearch] Fall� b�squeda | HTTP ${res.status} | endpoint=${apiUrl}${responseText ? ` | body=${responseText.substring(0, 250)}` : ''}`);
+            return [];
+        }
+        const data = await res.json();
+        const results = Array.isArray(data) ? data : (data.matches || data.results || []);
+        console.log(`[PatternSearch] Resultado de b�squeda | matches=${results.length}`);
+        if (debugPatternSearch && results.length > 0) {
+            const bestMatch = results[0] || {};
+            console.log(`[PatternSearch] Mejor match | id=${bestMatch.id || 'unknown'} | prompt="${String(bestMatch.prompt || bestMatch.original_prompt || bestMatch.name || '').substring(0, 120)}"`);
+        }
+        return results;
+    } catch (err: any) {
+        console.warn(`[PatternSearch] Error buscando patrones: ${err?.message || 'unknown'}`);
+        return [];
+    }
+}
 
 export async function savePromptPattern(patternData: any): Promise<boolean> {
     if (!isConfigured()) return false;
@@ -239,7 +246,7 @@ export async function savePromptPattern(patternData: any): Promise<boolean> {
             mission_id: getMissionId(),
             ...patternData
         };
-        if (process.env.DEBUG) console.log(`[PatternSave] 📤 POST ${apiUrl} | org=${payload.organization_id} proj=${payload.project_id} mission=${payload.mission_id}`);
+        if (process.env.DEBUG) console.log(`[PatternSave] �x� POST ${apiUrl} | org=${payload.organization_id} proj=${payload.project_id} mission=${payload.mission_id}`);
 
         const res = await fetch(apiUrl, {
             method: 'POST',
@@ -251,18 +258,18 @@ export async function savePromptPattern(patternData: any): Promise<boolean> {
         });
 
         if (!res.ok) {
-            if (process.env.DEBUG) console.warn(`[PatternSave] ⚠️ HTTP ${res.status} al guardar patrón en ${apiUrl}: ${await res.text().catch(() => '')}`);
+            if (process.env.DEBUG) console.warn(`[PatternSave] �a�️ HTTP ${res.status} al guardar patrón en ${apiUrl}: ${await res.text().catch(() => '')}`);
         } else {
-            if (process.env.DEBUG) console.log(`[PatternSave] ✅ Patrón guardado exitosamente.`);
+            if (process.env.DEBUG) console.log(`[PatternSave] �S& Patrón guardado exitosamente.`);
         }
         return res.ok;
     } catch (err: any) {
-        if (process.env.DEBUG) console.warn(`[PatternSave] ⚠️ Error guardando patrón: ${err?.message || 'unknown'}`);
+        if (process.env.DEBUG) console.warn(`[PatternSave] �a�️ Error guardando patrón: ${err?.message || 'unknown'}`);
         return false;
     }
 }
 
-// ─── HELPER: Obtener campos ya conocidos para deduplicación ─────────────────
+// ������ HELPER: Obtener campos ya conocidos para deduplicación ����������������������������������
 
 export async function getKnownFieldIdentifiers(pathUrl: string): Promise<string[]> {
     if (!isConfigured()) return [];
@@ -278,3 +285,4 @@ export async function getKnownFieldIdentifiers(pathUrl: string): Promise<string[
         return [];
     }
 }
+

package/src/services/missionGenerator.mjs

@@ -81,7 +81,7 @@ function buildMissionVariant(routeEntry, variant, options = {}) {
         name: `${baseName}${variantCode}`,
         prompt,
         page: route,
-        page_path: routeEntry.pagePath,
+        page_path: routeEntry.routeExamplePath || route,
         expected_result: expectedResult,
         tags: normalizeTags([...(routeEntry.tags || []), ...(variant.tags || []), ...((guidance.extraTags) || [])], promptFocus),
         priority: guidance.priorityOverride || variant.priority || routeEntry.priority || 'normal',
@@ -95,6 +95,7 @@ function buildMissionVariant(routeEntry, variant, options = {}) {
             context_status: guidance.contextStatus || { qaContext: 'missing', feasibility: 'missing' },
             route_example_path: routeEntry.routeExamplePath || route,
             route_params: routeEntry.routeParams || [],
+            source_file_path: routeEntry.pagePath,
             route_hash: simpleHash(`${route}|${routeEntry.pagePath}`),
             prompt_hash: simpleHash(prompt)
         }

package/src/services/routeDiscovery.mjs

@@ -221,23 +221,38 @@ function analyzeSourceSignals(sourceFile, route) {
     const fileLower = toPosix(sourceFile).toLowerCase();
     const semanticFileLower = fileLower.replace(/\([^/\\]+\)/g, '');
     const has = (...patterns) => patterns.some(pattern => lower.includes(pattern));
+    const count = (...patterns) => patterns.reduce((total, pattern) => total + (lower.match(new RegExp(pattern, 'g')) || []).length, 0);
     const routeHas = (...patterns) => patterns.some(pattern => routeLower.includes(pattern) || semanticFileLower.includes(pattern));
     const isRouterConfigFile = has('createbrowserrouter', 'useroutes', '<routes', '<route');
     const contextualHas = (...patterns) => {
         if (routeHas(...patterns)) return true;
         return !isRouterConfigFile && has(...patterns);
     };
+    const formControlCount = count(
+        '<input',
+        '<select',
+        '<textarea',
+        'textfield',
+        'inputbase',
+        'autocomplete',
+        'radiogroup',
+        'checkbox'
+    );
+    const hasStepFlow = contextualHas('siguiente', 'continuar', 'anterior', 'atras', 'paso', 'stepper', 'wizard');
+    const hasValidationCopy = contextualHas('campo obligatorio', 'requerido', 'obligatorio', 'valida', 'validacion', 'validation');
 
     const signals = {
-        hasForm: has('<form', 'useform', 'formik', 'react-hook-form', 'zodresolver', 'onsubmit', 'handleSubmit'.toLowerCase()),
+        hasForm: has('<form', 'useform', 'formik', 'react-hook-form', 'zodresolver', 'onsubmit', 'handlesubmit')
+            || formControlCount >= 2
+            || (formControlCount >= 1 && (hasStepFlow || hasValidationCopy)),
         hasTable: has('<table', 'datatable', 'ag-grid', 'tanstack table', 'role="table"', 'role="grid"'),
         hasSearch: contextualHas('search', 'buscar', 'query', 'placeholder="buscar', 'placeholder=\'buscar'),
         hasFilter: contextualHas('filter', 'filtro', 'filtrar'),
         hasCreateAction: contextualHas('crear', 'create', 'nuevo', 'new ', 'agregar', 'add '),
         hasEditAction: contextualHas('editar', 'edit', 'actualizar', 'update'),
-        hasAuth: has('password', 'contraseña', 'iniciar sesión', 'login', 'sign in') || routeHas('login', 'signin', 'auth'),
+        hasAuth: has('password', 'contrase\u00f1a', 'iniciar sesi\u00f3n', 'login', 'sign in') || routeHas('login', 'signin', 'auth'),
         hasCheckout: contextualHas('payment', 'card', 'checkout', 'billing', 'stripe'),
-        hasSettings: has('settings', 'configuración', 'preferencias', 'preferences') || routeHas('settings', 'config', 'preferences'),
+        hasSettings: has('settings', 'configuraci\u00f3n', 'preferencias', 'preferences') || routeHas('settings', 'config', 'preferences'),
         hasUpload: contextualHas('type="file"', "type='file'", 'dropzone', 'upload', 'subir archivo', 'subir imagen'),
         isDynamicRoute: /\[[^\]]+\]/.test(route) || /:\w+/.test(route),
         routeSegments: routeLower.replace(/^\/+/, '').split('/').filter(Boolean),

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

@@ -858,6 +858,25 @@ var assertUrlPatternTool = {
     required: ["pattern"]
   }
 };
+var navigateToUrlTool = {
+  name: "navigate_to_url",
+  description: "QA Skill: Navigate directly to a relative route or absolute URL. Use this whenever the mission mentions a concrete route like '/counter' or when there is no visible menu/link for the target screen. Relative paths are resolved against the current page origin.",
+  input_schema: {
+    type: "object",
+    properties: {
+      target_url: {
+        type: "string",
+        description: "Relative route or absolute URL to open. Examples: '/counter', '/users/123', 'https://example.com/dashboard'."
+      },
+      wait_until: {
+        enum: ["domcontentloaded", "load", "networkidle"],
+        description: "Desired Playwright waitUntil strategy after navigation.",
+        default: "domcontentloaded"
+      }
+    },
+    required: ["target_url"]
+  }
+};
 var measurePagePerformanceTool = {
   name: "measure_page_performance",
   description: "QA Skill: Measure page load time, network requests, and performance metrics (FCP, DOM loaded, total load). Use this to validate performance requirements or SLAs. Returns measured values and PASS/FAIL against optional thresholds.",
@@ -1058,6 +1077,7 @@ var qaAdvancedTools = [
   extractTableDataTool,
   captureConsoleErrorsTool,
   assertUrlPatternTool,
+  navigateToUrlTool,
   measurePagePerformanceTool,
   saveNavigationCheckpointTool,
   restoreNavigationCheckpointTool,
@@ -1497,7 +1517,7 @@ async function pushRule(rule) {
     }
     const data = await res.json();
     if (process.env.DEBUG)
-      console.log(`\x1B[32m[CollectiveMemory] \u2705 Regla guardada: "${rule.title}"\x1B[0m`);
+      console.log(`\x1B[32m[CollectiveMemory] \uFFFDS& Regla guardada: "${rule.title}"\x1B[0m`);
     return data.id ?? null;
   } catch (err) {
     if (process.env.DEBUG)
@@ -1564,7 +1584,7 @@ async function pushKnowledge(knowledge) {
     }
     const data = await res.json();
     if (process.env.DEBUG)
-      console.log(`\x1B[32m[CollectiveMemory] \u2705 Conocimiento guardado: "${knowledge.title}"\x1B[0m`);
+      console.log(`\x1B[32m[CollectiveMemory] \uFFFDS& Conocimiento guardado: "${knowledge.title}"\x1B[0m`);
     return data.id ?? null;
   } catch (err) {
     if (process.env.DEBUG)
@@ -1573,8 +1593,10 @@ async function pushKnowledge(knowledge) {
   }
 }
 async function searchPromptPattern(prompt, limit = 5) {
-  if (!isConfigured())
+  if (!isConfigured()) {
+    console.warn(`[PatternSearch] Omitido: configuraci\uFFFDn incompleta para prompt-execution-patterns/search`);
     return [];
+  }
   try {
     const apiUrl = process.env.ARCALITY_API_URL ? `${process.env.ARCALITY_API_URL}/api/v1/prompt-execution-patterns/search` : `${getBase()}/prompt-execution-patterns/search`;
     const payload = {
@@ -1584,8 +1606,9 @@ async function searchPromptPattern(prompt, limit = 5) {
       limit
     };
     const debugPatternSearch = process.env.DEBUG === "true" || process.env.ARCALITY_DEBUG === "true";
+    console.log(`[PatternSearch] Iniciando b\uFFFDsqueda | prompt_chars=${prompt.length} | limit=${limit} | project_id=${getPid() || "missing"} | org_id=${getOrgId() || "missing"}`);
     if (debugPatternSearch) {
-      console.log(`[PatternSearch] POST ${apiUrl} | prompt_chars=${prompt.length} | limit=${limit}`);
+      console.log(`[PatternSearch] POST ${apiUrl} | prompt_preview="${prompt.substring(0, 80).replace(/\s+/g, " ")}"`);
     }
     const res = await fetch(apiUrl, {
       method: "POST",
@@ -1596,19 +1619,20 @@ async function searchPromptPattern(prompt, limit = 5) {
       body: JSON.stringify(payload)
     });
     if (!res.ok) {
-      if (debugPatternSearch)
-        console.warn(`[PatternSearch] HTTP ${res.status} from ${apiUrl}`);
+      const responseText = await res.text().catch(() => "");
+      console.warn(`[PatternSearch] Fall\uFFFD b\uFFFDsqueda | HTTP ${res.status} | endpoint=${apiUrl}${responseText ? ` | body=${responseText.substring(0, 250)}` : ""}`);
       return [];
     }
     const data = await res.json();
     const results = Array.isArray(data) ? data : data.matches || data.results || [];
-    if (debugPatternSearch)
-      console.log(`[PatternSearch] ${results.length} patrones encontrados.`);
+    console.log(`[PatternSearch] Resultado de b\uFFFDsqueda | matches=${results.length}`);
+    if (debugPatternSearch && results.length > 0) {
+      const bestMatch = results[0] || {};
+      console.log(`[PatternSearch] Mejor match | id=${bestMatch.id || "unknown"} | prompt="${String(bestMatch.prompt || bestMatch.original_prompt || bestMatch.name || "").substring(0, 120)}"`);
+    }
     return results;
   } catch (err) {
-    if (process.env.DEBUG === "true" || process.env.ARCALITY_DEBUG === "true") {
-      console.warn(`[PatternSearch] Error buscando patrones: ${err?.message || "unknown"}`);
-    }
+    console.warn(`[PatternSearch] Error buscando patrones: ${err?.message || "unknown"}`);
     return [];
   }
 }
@@ -1624,7 +1648,7 @@ async function savePromptPattern(patternData) {
       ...patternData
     };
     if (process.env.DEBUG)
-      console.log(`[PatternSave] \u{1F4E4} POST ${apiUrl} | org=${payload.organization_id} proj=${payload.project_id} mission=${payload.mission_id}`);
+      console.log(`[PatternSave] \uFFFDx\uFFFD POST ${apiUrl} | org=${payload.organization_id} proj=${payload.project_id} mission=${payload.mission_id}`);
     const res = await fetch(apiUrl, {
       method: "POST",
       headers: {
@@ -1635,15 +1659,15 @@ async function savePromptPattern(patternData) {
     });
     if (!res.ok) {
       if (process.env.DEBUG)
-        console.warn(`[PatternSave] \u26A0\uFE0F HTTP ${res.status} al guardar patr\xF3n en ${apiUrl}: ${await res.text().catch(() => "")}`);
+        console.warn(`[PatternSave] \uFFFDa\uFFFD\uFE0F HTTP ${res.status} al guardar patr\xF3n en ${apiUrl}: ${await res.text().catch(() => "")}`);
     } else {
       if (process.env.DEBUG)
-        console.log(`[PatternSave] \u2705 Patr\xF3n guardado exitosamente.`);
+        console.log(`[PatternSave] \uFFFDS& Patr\xF3n guardado exitosamente.`);
     }
     return res.ok;
   } catch (err) {
     if (process.env.DEBUG)
-      console.warn(`[PatternSave] \u26A0\uFE0F Error guardando patr\xF3n: ${err?.message || "unknown"}`);
+      console.warn(`[PatternSave] \uFFFDa\uFFFD\uFE0F Error guardando patr\xF3n: ${err?.message || "unknown"}`);
     return false;
   }
 }
@@ -3064,6 +3088,7 @@ These are NOT optional. You MUST use these tools in these situations:
 | Before clicking SAVE/GUARDAR | \`validate_element_state\` | To confirm button is enabled |
 | After successful SAVE | \`extract_table_data\` | To verify record was created |
 | UI is frozen/unresponsive | \`capture_console_errors\` | To check for JS errors |
+| Mission mentions a concrete route like '/counter' and current URL is different, or the route has no visible menu item | \`navigate_to_url\` | IMMEDIATELY instead of improvising clicks |
 | 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 |
@@ -3085,6 +3110,7 @@ These are NOT optional. You MUST use these tools in these situations:
 
 3. **CURRENT STATE > MEMORY**: What you see in CURRENT COMPONENTS is the truth. SUCCESS MEMORY is a guide, not gospel.
 4. **PAGE TRANSITIONS**: If URL contains '/edit' or you see a 'Save' button, you ARE in the edit view. Don't go back.
+5. **DIRECT ROUTE NAVIGATION (CRITICAL)**: If the mission mentions a concrete route such as '/counter', '/dashboard', '/users/123', or the reasoning says "navigate directly", you MUST use \`navigate_to_url\`. Do NOT simulate the browser address bar with clicks on logos, headers, or random navigation links.
 5. **MENUS & DROPDOWNS**:
    - After clicking a toggle/menu, WAIT for the next turn to see options. Never click the same menu icon twice in a row.
    - **DROPDOWN COMPLETION RULE (CRITICAL)**: After clicking an option in a dropdown ('[li]', '[option]'), IF the form requires you to fill MORE subsequent fields in the same section, STOP YOUR TURN AFTER SELECTING the option! Do NOT group the select action with filling the next fields. React/Next.js will re-render the DOM, detaching your cached 'idx' references causing 10000ms timeouts. Wait for the next turn to fill the next fields.
@@ -3510,6 +3536,19 @@ ${history.slice(-25).join("\n") || "None"}`
           const pass = should_match ? match : !match;
           const result = `URL Assertion: ${pass ? "PASS" : "FAIL"} (Current URL: ${url} | Pattern: ${pattern} | Expected match: ${should_match})`;
           toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: result });
+        } else if (toolName === "navigate_to_url") {
+          const { target_url, wait_until = "domcontentloaded" } = toolInput;
+          console.log(`>>ARCALITY_STATUS>> ?? Navegando directamente a: ${target_url}...`);
+          try {
+            const baseUrl = this.page.url() || process.env.BASE_URL || "http://localhost:3000";
+            const fullUrl = new URL(target_url, baseUrl).toString();
+            await this.page.goto(fullUrl, { waitUntil: wait_until, timeout: 15e3 });
+            await this.page.waitForLoadState("networkidle", { timeout: 3e3 }).catch(() => {
+            });
+            toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: `? Navigated to ${fullUrl}. Current URL: ${this.page.url()}` });
+          } catch (e) {
+            toolResults.push({ type: "tool_result", tool_use_id: toolUse.id, content: `Error navigating to URL: ${e.message}` });
+          }
         } else if (toolName === "measure_page_performance") {
           const { thresholds = {} } = toolInput;
           console.log(`>>ARCALITY_STATUS>> \u26A1 Midiendo rendimiento de p\xE1gina...`);
@@ -4234,6 +4273,23 @@ async function readHiddenPortalResult(page) {
   }
   return null;
 }
+function resolveTargetUrl(baseUrl, currentUrl, targetPath) {
+  if (!targetPath)
+    return currentUrl || baseUrl;
+  if (targetPath.startsWith("http://") || targetPath.startsWith("https://"))
+    return targetPath;
+  const referenceUrl = currentUrl || baseUrl;
+  const parsedBase = new URL(baseUrl || referenceUrl);
+  const parsedReference = new URL(referenceUrl);
+  const normalizedTarget = targetPath.trim();
+  if (normalizedTarget.startsWith("/")) {
+    const basePath = parsedBase.pathname.replace(/\/+$/, "");
+    const targetAlreadyIncludesBase = basePath && (normalizedTarget === basePath || normalizedTarget.startsWith(`${basePath}/`));
+    const combinedPath = targetAlreadyIncludesBase ? normalizedTarget : `${basePath}${normalizedTarget}`.replace(/\/{2,}/g, "/");
+    return new URL(`${parsedBase.origin}${combinedPath}`).toString();
+  }
+  return new URL(normalizedTarget, parsedReference).toString();
+}
 function writeBatchMissionResult(payload) {
   const runDomainDir = process.env.ARCALITY_RUN_DOMAIN_DIR;
   if (!runDomainDir)
@@ -4616,16 +4672,18 @@ function writeBatchMissionResult(payload) {
       console.warn(`    \u26A0\uFE0F Login autom\xE1tico omitido o ya autenticado.`);
     }
     if (target !== "/" && !page.url().includes(target)) {
-      const tgtUrl = target.startsWith("http") ? target : base + target;
+      const tgtUrl = resolveTargetUrl(base, page.url(), target);
       if (!tgtUrl.startsWith("http"))
         throw new Error(`URL Inv\xE1lida: "${tgtUrl}"`);
+      console.log(`>>ARCALITY_STATUS>> [Navigation] Navegando a ruta objetivo: ${tgtUrl}`);
       await page.goto(tgtUrl).catch(() => {
       });
     }
   } else {
-    const tgtUrl = target.startsWith("http") ? target : base + target;
+    const tgtUrl = resolveTargetUrl(base, base, target);
     if (!tgtUrl.startsWith("http"))
       throw new Error(`URL Inv\xE1lida: "${tgtUrl}". Por favor proporciona una URL v\xE1lida incluyendo http:// o https://`);
+    console.log(`>>ARCALITY_STATUS>> [Navigation] Abriendo ruta inicial: ${tgtUrl}`);
     await page.goto(tgtUrl);
   }
   await page.waitForLoadState("networkidle");