@arcadialdev/arcality 4.1.0 → 4.1.2

package/scripts/gen-and-run.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // scripts/gen-and-run.mjs
-// Main Arcality CLI loop — v3 Single Configuration Mode
+// Main Arcality CLI loop — v3 Single Configuration Mode
 // Reads from arcality.config instead of multi-config .env approach.
 
 import 'dotenv/config';
@@ -30,14 +30,14 @@ import {
 // Load global config at startup (injects keys into process.env)
 setupProcessEnv();
 
-// ── WINDOWS FIX: Interceptar Ctrl+C antes que cmd.exe ──
-// En Windows, `arcality` se ejecuta vía arcality.cmd (creado por npm para el campo bin).
-// cmd.exe intercepta Ctrl+C y muestra "¿Desea terminar el trabajo por lotes (S/N)?".
-// Al presionar S, mata el árbol de procesos antes de que nuestro finally pueda correr.
+// ── WINDOWS FIX: Interceptar Ctrl+C antes que cmd.exe ──
+// En Windows, `arcality` se ejecuta vía arcality.cmd (creado por npm para el campo bin).
+// cmd.exe intercepta Ctrl+C y muestra "¿Desea terminar el trabajo por lotes (S/N)?".
+// Al presionar S, mata el árbol de procesos antes de que nuestro finally pueda correr.
 //
-// La solución: setRawMode(true) hace que Node capture los bytes del teclado directamente,
+// La solución: setRawMode(true) hace que Node capture los bytes del teclado directamente,
 // ANTES de que cmd.exe los procese. Al detectar Ctrl+C (byte 0x03) lo convertimos en
-// un SIGINT de Node — cmd.exe nunca lo ve y nunca muestra el prompt.
+// un SIGINT de Node — cmd.exe nunca lo ve y nunca muestra el prompt.
 if (process.stdin.isTTY && process.stdin.setRawMode) {
     try {
         process.stdin.setRawMode(true);
@@ -63,7 +63,7 @@ const ORIGINAL_CWD = process.cwd();
 const COLLECTION_DEFAULT_CONCURRENCY = 3;
 const COLLECTION_MAX_CONCURRENCY = 5;
 
-// ── Load arcality.config if present ──
+// ── Load arcality.config if present ──
 let projectConfig = loadProjectConfig(ORIGINAL_CWD) || loadProjectConfig(PROJECT_ROOT);
 if (projectConfig) {
     if (!isRealProjectId(projectConfig.projectId)) {
@@ -164,9 +164,9 @@ function setupEnvironment() {
     try {
         const pkg = JSON.parse(fs.readFileSync(path.join(PROJECT_ROOT, 'package.json'), 'utf8'));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-        if (deps['next']) techStack = 'Next.js 🚀';
-        else if (deps['vite']) techStack = 'Vite âš¡';
-        else if (deps['react-scripts']) techStack = 'Create React App ⚛️';
+        if (deps['next']) techStack = 'Next.js 🚀';
+        else if (deps['vite']) techStack = 'Vite ⚡';
+        else if (deps['react-scripts']) techStack = 'Create React App ⚛️';
     } catch { }
 
     // Override with arcality.config detection if available
@@ -284,7 +284,8 @@ function normalizeMissionSpec(rawMission, filePath = '') {
         priority: String(mission.priority || '').trim(),
         tags: normalizeStringList(mission.tags),
         timeout: Number.isFinite(Number(mission.timeout)) ? Number(mission.timeout) : null,
-        credentialId: String(mission.credential_id || mission.credentialId || '').trim()
+        credentialId: String(mission.credential_id || mission.credentialId || '').trim(),
+        dbValidations: Array.isArray(mission.db_validations) ? mission.db_validations : (Array.isArray(mission.dbValidations) ? mission.dbValidations : [])
     };
 }
 
@@ -427,7 +428,7 @@ async function selectSavedMissionSource({ libraryDir, projectDir, rootDir }) {
     let source = sources[0];
     if (sources.length > 1) {
         const selectedSource = await select({
-            message: '¿De dónde quieres abrir la misión?',
+            message: '¿De dónde quieres abrir la misión?',
             options: sources.map(item => ({
                 label: `${item.label}${item.description ? ` - ${item.description}` : ''}`,
                 value: item.key
@@ -439,7 +440,7 @@ async function selectSavedMissionSource({ libraryDir, projectDir, rootDir }) {
 
     if (source.key === 'root') {
         const selectedFile = await select({
-            message: 'Elige la misión guardada:',
+            message: 'Elige la misión guardada:',
             options: source.files.map(file => ({ label: file, value: file }))
         });
         if (isCancel(selectedFile)) return null;
@@ -456,7 +457,7 @@ async function selectSavedMissionSource({ libraryDir, projectDir, rootDir }) {
     const selectedMission = await selectMissionYaml(
         source.dir,
         `Elige la carpeta de ${source.label.toLowerCase()}:`,
-        'Elige la misión guardada:'
+        'Elige la misión guardada:'
     );
 
     if (!selectedMission) return null;
@@ -558,6 +559,22 @@ expected_result: "El registro nuevo aparece en la tabla Timesheet - Hoy."
 # Optional placeholder for future centralized credentials.
 credential_id: ""
 #
+# db_validations:
+# Optional post-mission database corroboration. Each query_id must exist in .arcality/db-validations.yaml.
+# Supports exists and exact field checks against the first returned row.
+db_validations: []
+# Example:
+# db_validations:
+#   - name: timesheet_creado_en_bd
+#     query_id: timesheet_by_description
+#     params:
+#       description: "Timesheet QA 001"
+#     expect:
+#       exists: true
+#       fields:
+#         status: "ACTIVE"
+#
+#
 # hooks:
 # Reserved for future before/after automation hooks.
 # hooks:
@@ -640,6 +657,23 @@ async function waitForEnter(message = 'Presiona Enter para continuar...', option
     });
 }
 
+function getSingleEmptyQueryParamName(urlString) {
+    if (!urlString) return null;
+
+    try {
+        const parsed = new URL(String(urlString));
+        const emptyParams = [];
+
+        for (const [key, value] of parsed.searchParams.entries()) {
+            if (!String(value || '').trim()) emptyParams.push(key);
+        }
+
+        return emptyParams.length === 1 ? emptyParams[0] : null;
+    } catch {
+        return null;
+    }
+}
+
 function getMissionStartPath(missionSpec, collectionMeta = null, fallbackPath = '') {
     return missionSpec.startAt || missionSpec.page || missionSpec.pagePath || collectionMeta?.defaultPagePath || fallbackPath;
 }
@@ -1114,7 +1148,8 @@ async function runCollectionBatch({
             ARCALITY_RUN_REPORTS_DIR: mission.reportsDir,
             ARCALITY_RUN_PLAYWRIGHT_OUTPUT_DIR: mission.playwrightOutputDir,
             ARCALITY_COLLECTION_RUN_ID: runId,
-            ARCALITY_COLLECTION_MISSION_SLUG: mission.slug
+            ARCALITY_COLLECTION_MISSION_SLUG: mission.slug,
+            ARCALITY_DB_VALIDATIONS_JSON: mission.missionSpec.dbValidations.length > 0 ? JSON.stringify(mission.missionSpec.dbValidations) : ''
         };
 
         if (runnerPrebuilt) {
@@ -1214,20 +1249,20 @@ function showBanner() {
     } catch { }
 
     const sentinelAscii = `
- █████  ██████   ██████  █████  ██      ██ ████████ ██    ██ 
-██   ██ ██   ██ ██      ██   ██ ██      ██    ██     ██  ██  
-███████ ██████  ██      ███████ ██      ██    ██      ████   
-██   ██ ██   ██ ██      ██   ██ ██      ██    ██       ██    
-██   ██ ██   ██  ██████ ██   ██ ███████ ██    ██       ██    `;
+ █████  ██████   ██████  █████  ██      ██ ████████ ██    ██ 
+██   ██ ██   ██ ██      ██   ██ ██      ██    ██     ██  ██  
+███████ ██████  ██      ███████ ██      ██    ██      ████   
+██   ██ ██   ██ ██      ██   ██ ██      ██    ██       ██    
+██   ██ ██   ██  ██████ ██   ██ ███████ ██    ██       ██    `;
 
     intro(chalk.gray(sentinelAscii));
 
     note(
-        chalk.gray('◉ Motor de Observación: ') + chalk.bold.white('EN LÍNEA') + '\n' +
-        chalk.gray('◉ Módulo de Recuperación de UI: ') + chalk.bold.white('ACTIVO') + '\n' +
-        chalk.gray('◉ Lógica Forense:     ') + chalk.bold.white('ACTIVA') + '\n' +
-        chalk.gray('─'.repeat(50)) + '\n' +
-        chalk.gray('Versión del Sistema: ') + chalk.white(`v${version}`),
+        chalk.gray('◉ Motor de Observación: ') + chalk.bold.white('EN LÍNEA') + '\n' +
+        chalk.gray('◉ Módulo de Recuperación de UI: ') + chalk.bold.white('ACTIVO') + '\n' +
+        chalk.gray('◉ Lógica Forense:     ') + chalk.bold.white('ACTIVA') + '\n' +
+        chalk.gray('─'.repeat(50)) + '\n' +
+        chalk.gray('Versión del Sistema: ') + chalk.white(`v${version}`),
         'Estado Central de Arcality'
     );
 
@@ -1236,8 +1271,8 @@ function showBanner() {
     // Show arcality.config status instead of multi-config switching
     const hasConfig = !!projectConfig;
     const configStatus = hasConfig
-        ? chalk.green('◉ Sincronización Establecida')
-        : chalk.red('⚠ Desconectado — Ejecuta `arcality init`');
+        ? chalk.green('◉ Sincronización Establecida')
+        : chalk.red('⚠ Desconectado — Ejecuta `arcality init`');
 
     const { key: apiKeyVal, source: apiKeySource } = getApiKey();
     const apiKeyDisplay = apiKeyVal
@@ -1246,7 +1281,7 @@ function showBanner() {
 
     const infoLines = [
         chalk.gray('Nodo Objetivo: ') + chalk.white(process.env.NODE_ENV ?? 'development'),
-        chalk.gray('Token de Autenticación:  ') + apiKeyDisplay,
+        chalk.gray('Token de Autenticación:  ') + apiKeyDisplay,
         chalk.gray('Stack:  ') + chalk.white(techStack),
     ];
 
@@ -1256,10 +1291,10 @@ function showBanner() {
             chalk.gray('ID de Identidad: ') + chalk.white(projectConfig.projectId || 'N/A'),
         );
     } else {
-        infoLines.push(chalk.gray('Configuración:      ') + configStatus);
+        infoLines.push(chalk.gray('Configuración:      ') + configStatus);
     }
 
-    note(infoLines.join('\n'), 'Telemetría del Objetivo');
+    note(infoLines.join('\n'), 'Telemetría del Objetivo');
 }
 
 const ARCALITY_BRAIN_URL = "https://api.anthropic.com/v1/messages";
@@ -1389,7 +1424,7 @@ function run(cmd, args, options = {}) {
         // properly wraps arguments with spaces in quotes natively for CreateProcessW on Windows.
         //
         // CRITICAL (Windows): stdin MUST be 'ignore' (not 'inherit') to prevent cmd.exe from
-        // showing the "¿Desea terminar el trabajo por lotes (S/N)?" prompt on Ctrl+C.
+        // showing the "¿Desea terminar el trabajo por lotes (S/N)?" prompt on Ctrl+C.
         // When stdin is 'inherit', cmd.exe intercepts Ctrl+C at the console level and kills
         // the entire process tree before our SIGINT handler can run, bypassing the finally block.
         const p = spawn(cmd, args, {
@@ -1438,9 +1473,9 @@ function run(cmd, args, options = {}) {
                 fs.writeFileSync(lastRunLog, outputBuffer);
             } catch (e) { }
 
-            // code===0 → clean success
-            // code===null + signal → killed by signal (Ctrl+C) — treat as non-fatal so finally runs
-            // code===1 → test failed (Playwright returns 1 on test failure) — also non-fatal
+            // code===0 → clean success
+            // code===null + signal → killed by signal (Ctrl+C) — treat as non-fatal so finally runs
+            // code===1 → test failed (Playwright returns 1 on test failure) — also non-fatal
             if (code === 0 || signal !== null || code === 1) resolve();
             else {
                 if (isDebug) console.error(chalk.red(`\n[DEBUG] Process exited with code ${code}`));
@@ -1464,7 +1499,7 @@ function runNpmScript(args, options = {}) {
 
 /**
  * Ping the project to register activity.
- * Uses internal API URL — not user-configurable.
+ * Uses internal API URL — not user-configurable.
  */
 async function pingProject(projectId, apiKey) {
     if (!projectId || !apiKey) return;
@@ -1479,7 +1514,7 @@ async function pingProject(projectId, apiKey) {
 async function main() {
     process.chdir(PROJECT_ROOT);
 
-    // Backward compat: initialize .env if ACTIVE_CONFIG missing (legacy)
+    // Read local .env only for user-managed variables that may still exist.
     let initialEnv = parseDotEnvFile(path.join(PROJECT_ROOT, '.env'));
     const envProjectId = initialEnv.ARCALITY_PROJECT_ID || process.env.ARCALITY_PROJECT_ID;
     if (envProjectId && !isRealProjectId(envProjectId)) {
@@ -1489,16 +1524,6 @@ async function main() {
         process.exit(1);
     }
 
-    if (!projectConfig && !initialEnv.ACTIVE_CONFIG) {
-        updateDotEnvFile({
-            ACTIVE_CONFIG: 'Default',
-            SAVED_CONFIGS: 'Default',
-            Default_URL: initialEnv.BASE_URL || '',
-            Default_USER: initialEnv.LOGIN_USER || '',
-            Default_PASS: initialEnv.LOGIN_PASSWORD || ''
-        });
-        initialEnv = parseDotEnvFile(path.join(PROJECT_ROOT, '.env'));
-    }
 
     const argv = process.argv.slice(2);
     let initialDiscoverPath = null;
@@ -1570,6 +1595,7 @@ async function main() {
         let collectionConcurrency = firstRun ? initialCollectionConcurrency : null;
         let skipSavePrompt = firstRun ? initialSkipSavePrompt : false;
         let batchMode = firstRun ? initialBatchMode : false;
+        let missionDbValidations = [];
 
         let skipMenu = (firstRun && (prompt || agentMode || smartMode || runAllMode || templateMode)) || agentMode || runAllMode || templateMode;
         if (agentMode) skipMenu = true; // Hard-lock: No menu in agent mode
@@ -1579,7 +1605,7 @@ async function main() {
         if (!skipMenu) {
             showBanner();
             try {
-                // ── Build menu options (single config mode) ──
+                // ── Build menu options (single config mode) ──
                 const missionsDir = process.env.MISSIONS_DIR;
                 const savedMissionCollections = listMissionCollections(missionsDir);
 
@@ -1601,38 +1627,40 @@ async function main() {
                 const rootYamlFiles = rootMissionFiles;
 
                 const options = [
-                    { label: 'â—‰  Desplegar Arcality (Prompt)', value: 'agent' },
-                    ...(savedMissionCollections.length ? [{ label: '▶  Ejecutar colección completa', value: 'run_collection' }] : []),
-                    ...(savedMissionCollections.length ? [{ label: '⟳  Lanzar Misión Archivada (.yaml)', value: 'launch_saved' }] : []),
-                    ...(yamlOutputCollections.length ? [{ label: '⟶  Activar Modo GUÍA (Reusar YAML)', value: 'reuse_yaml' }] : []),
-                    ...(rootYamlFiles.length ? [{ label: '📂  Cargar Matriz de Patrones (YAML Raíz)', value: 'yaml_list' }] : []),
-                    { label: '📄  Generar templates YAML', value: 'generate_templates' },
-                    { label: 'â—Ž  Recalibrar Sistema (init)', value: 'reconfigure' },
-                    { label: '✕  Terminar Proceso', value: 'exit' }
+                    { label: 'Ejecutar mision', value: 'agent' },
+                    ...(savedMissionCollections.length ? [{ label: 'Ejecutar coleccion de misiones', value: 'run_collection' }] : []),
+                    ...(savedMissionCollections.length ? [{ label: 'Ejecutar YAML guardado (.yaml)', value: 'launch_saved' }] : []),
+                    ...(yamlOutputCollections.length ? [{ label: 'Reusar YAML generado', value: 'reuse_yaml' }] : []),
+                    ...(rootYamlFiles.length ? [{ label: 'Abrir YAML desde la raiz', value: 'yaml_list' }] : []),
+                    { label: 'Descubrir rutas y generar misiones', value: 'generate_missions' },
+                    { label: 'Crear plantillas YAML base', value: 'generate_templates' },
+                    { label: 'Editar configuracion actual', value: 'reconfigure' },
+                    { label: 'Configurar o reconectar proyecto', value: 'full_reconfigure' },
+                    { label: 'Salir de Arcality', value: 'exit' }
                 ];
 
                 const menuOptions = options
                     .filter(option => !['launch_saved', 'reuse_yaml', 'yaml_list'].includes(option.value))
                     .map(option => option.value === 'generate_templates'
-                        ? { ...option, label: '◫  Generar plantillas de misión' }
+                        ? { ...option, label: 'Crear plantillas YAML base' }
                         : option
                     );
 
                 if (hasSavedMissionSources) {
                     const insertIndex = Math.min(menuOptions.length, 2);
                     menuOptions.splice(insertIndex, 0, {
-                        label: '◌  Abrir misión guardada',
+                        label: 'Ejecutar mision guardada',
                         value: 'open_saved_mission'
                     });
                 }
 
                 const action = await select({
-                    message: '¿Qué te gustaría hacer?',
+                    message: '¿Qué te gustaría hacer?',
                     options: menuOptions
                 });
 
                 if (isCancel(action) || action === 'exit') {
-                    outro(chalk.cyan('¡Hasta luego!'));
+                    outro(chalk.cyan('¡Hasta luego!'));
                     break;
                 }
 
@@ -1652,11 +1680,43 @@ async function main() {
                     const yamlContent = fs.readFileSync(selectedMission.fullPath, 'utf8');
                     const missionSpec = normalizeMissionSpec(loadYaml(yamlContent), selectedMission.fullPath);
                     prompt = missionSpec.prompt || yamlContent;
+                    missionDbValidations = missionSpec.dbValidations;
                     discoverPath = getMissionStartPath(
                         missionSpec,
                         readCollectionMeta(path.dirname(selectedMission.fullPath), selectedMission.collection)
                     );
                     agentMode = true;
+                } else if (action === 'generate_missions') {
+                    const generateScript = path.join(PROJECT_ROOT, 'scripts', 'generate.mjs');
+                    const generationMode = await select({
+                        message: 'Como quieres usar la autogeneracion?',
+                        options: [
+                            { label: 'Solo vista previa (sin archivos)', value: 'dry_run' },
+                            { label: 'Generar archivos YAML ahora', value: 'write_yaml' },
+                            { label: 'Cancelar', value: 'cancel' }
+                        ]
+                    });
+                    if (isCancel(generationMode) || generationMode === 'cancel') continue;
+
+                    try {
+                        await new Promise((resolve, reject) => {
+                            const childArgs = generationMode === 'dry_run'
+                                ? [generateScript, '--dry-run']
+                                : [generateScript];
+                            const child = spawn('node', childArgs, {
+                                stdio: 'inherit',
+                                cwd: ORIGINAL_CWD,
+                                env: { ...process.env, ARCALITY_ROOT: PROJECT_ROOT }
+                            });
+                            child.on('exit', code => code === 0 ? resolve() : reject(new Error(`Generate exited with ${code}`)));
+                            child.on('error', reject);
+                        });
+                    } catch (e) {
+                        console.log(chalk.red(`\nAutogeneracion fallida: ${e.message}`));
+                    }
+
+                    await waitForEnter('Presiona Enter para volver al menu...');
+                    continue;
                 } else if (action === 'generate_templates') {
                     const createdMain = ensureMissionTemplates(missionsDir);
                     const yamlDir = projectConfig ? getYamlOutputDir(projectConfig, ORIGINAL_CWD) : null;
@@ -1671,7 +1731,30 @@ async function main() {
                     await waitForEnter('Presiona Enter para volver al menu...');
                     continue;
                 } else if (action === 'reconfigure') {
-                    // Launch arcality init in the user's project directory
+                    const editorScript = path.join(PROJECT_ROOT, 'scripts', 'edit-config.mjs');
+                    try {
+                        await new Promise((resolve, reject) => {
+                            const child = spawn('node', [editorScript], {
+                                stdio: 'inherit',
+                                cwd: ORIGINAL_CWD,
+                                env: { ...process.env, ARCALITY_ROOT: PROJECT_ROOT }
+                            });
+                            child.on('exit', code => code === 0 ? resolve() : reject(new Error(`Config editor exited with ${code}`)));
+                            child.on('error', reject);
+                        });
+
+                        projectConfig = loadProjectConfig(ORIGINAL_CWD) || loadProjectConfig(PROJECT_ROOT);
+                        if (projectConfig) {
+                            injectConfigToEnv(projectConfig);
+                        }
+                        setupEnvironment();
+
+                    } catch (e) {
+                        console.log(chalk.red(`\nConfig update failed: ${e.message}`));
+                        await new Promise(r => setTimeout(r, 3000));
+                    }
+                    continue;
+                } else if (action === 'full_reconfigure') {
                     const initScript = path.join(PROJECT_ROOT, 'scripts', 'init.mjs');
                     try {
                         await new Promise((resolve, reject) => {
@@ -1683,18 +1766,15 @@ async function main() {
                             child.on('exit', code => code === 0 ? resolve() : reject(new Error(`Init exited with ${code}`)));
                             child.on('error', reject);
                         });
-                        
-                        // ── REFRESH CONFIG ──
-                        // Recargar el archivo que init.mjs acaba de escribir
+
                         projectConfig = loadProjectConfig(ORIGINAL_CWD) || loadProjectConfig(PROJECT_ROOT);
                         if (projectConfig) {
                             injectConfigToEnv(projectConfig);
                         }
                         setupEnvironment();
-                        
+
                     } catch (e) {
-                        // Mostrar el error claramente antes de que console.clear() lo borre
-                        console.log(chalk.red(`\n❌ Reconfigure failed: ${e.message}`));
+                        console.log(chalk.red(`\nReconnect failed: ${e.message}`));
                         await new Promise(r => setTimeout(r, 3000));
                     }
                     continue;
@@ -1709,6 +1789,7 @@ async function main() {
                     const yamlContent = fs.readFileSync(selectedMission.fullPath, 'utf8');
                     const missionSpec = normalizeMissionSpec(loadYaml(yamlContent), selectedMission.fullPath);
                     prompt = missionSpec.prompt || yamlContent;
+                    missionDbValidations = missionSpec.dbValidations;
                     discoverPath = getMissionStartPath(missionSpec, readCollectionMeta(path.dirname(selectedMission.fullPath), selectedMission.collection));
                     agentMode = true;
                 } else if (action === 'reuse_yaml') {
@@ -1723,6 +1804,7 @@ async function main() {
                     const yamlContent = fs.readFileSync(selectedMission.fullPath, 'utf8');
                     const missionSpec = normalizeMissionSpec(loadYaml(yamlContent), selectedMission.fullPath);
                     prompt = missionSpec.prompt || yamlContent;
+                    missionDbValidations = missionSpec.dbValidations;
                     discoverPath = getMissionStartPath(missionSpec, readCollectionMeta(path.dirname(selectedMission.fullPath), selectedMission.collection));
                     agentMode = true;
                 } else if (action === 'yaml_list') {
@@ -1735,6 +1817,7 @@ async function main() {
                     const yamlContent = fs.readFileSync(path.join(PROJECT_ROOT, sel), 'utf8');
                     const missionSpec = normalizeMissionSpec(loadYaml(yamlContent), path.join(PROJECT_ROOT, sel));
                     prompt = missionSpec.prompt || yamlContent;
+                    missionDbValidations = missionSpec.dbValidations;
                     discoverPath = getMissionStartPath(missionSpec);
                     agentMode = true;
                 }
@@ -1765,7 +1848,7 @@ async function main() {
             if (!batchCollection && process.stdin.isTTY) {
                 const availableCollections = listMissionCollections(process.env.MISSIONS_DIR);
                 const selectedBatchCollection = await select({
-                    message: 'Elige la colección a ejecutar:',
+                    message: 'Elige la colección a ejecutar:',
                     options: [
                         { label: `Todas las colecciones (${availableCollections.length})`, value: '__ALL__' },
                         ...availableCollections.map(collection => ({
@@ -1823,16 +1906,16 @@ async function main() {
         if (agentMode) {
             if (!prompt || prompt.trim().length < 4) {
                 const p = await text({
-                    message: chalk.cyan('🤖 Misión para Arcality (Requerida):'),
+                    message: chalk.cyan('🤖 Misión para Arcality (Requerida):'),
                     placeholder: 'Ej., Llena el formulario de registro con datos aleatorios',
                     validate: v => {
-                        if (!v || !v.trim()) return 'La misión es requerida para iniciar.';
-                        if (v.trim().length < 4) return 'La misión debe ser más descriptiva (mínimo 4 caracteres).';
+                        if (!v || !v.trim()) return 'La misión es requerida para iniciar.';
+                        if (v.trim().length < 4) return 'La misión debe ser más descriptiva (mínimo 4 caracteres).';
                     }
                 });
 
                 if (isCancel(p)) {
-                    cancel('Misión cancelada. Regresando al menú principal...');
+                    cancel('Misión cancelada. Regresando al menú principal...');
                     agentMode = false;
                     prompt = "";
                     skipMenu = false;
@@ -1843,9 +1926,10 @@ async function main() {
 
             if (!discoverPath) {
                 const knownBaseUrl = projectConfig?.project?.baseUrl || process.env.BASE_URL;
+                const emptyQueryParamName = getSingleEmptyQueryParamName(knownBaseUrl);
                 const promptMsg = knownBaseUrl
-                    ? `🌐 URL Completa de Navegación (relative to ${knownBaseUrl}):`
-                    : '🌐 URL Completa de Navegación (ej., http://localhost:3000/):';
+                    ? `🌐 URL Completa de Navegación (relative to ${knownBaseUrl}). Deja vacío para usarla tal cual${emptyQueryParamName ? ` o escribe solo el valor de "${emptyQueryParamName}"` : ''}:`
+                    : '🌐 URL Completa de Navegación (ej., http://localhost:3000/):';
 
                 const d = await text({
                     message: chalk.cyan(promptMsg),
@@ -1857,13 +1941,13 @@ async function main() {
                 });
 
                 if (isCancel(d)) {
-                    cancel('Misión abortada. Regresando al menú...');
+                    cancel('Misión abortada. Regresando al menú...');
                     agentMode = false;
                     prompt = "";
                     skipMenu = false;
                     continue;
                 }
-                discoverPath = d;
+                discoverPath = typeof d === 'string' ? d.trim() : d;
             }
         }
 
@@ -1873,7 +1957,7 @@ async function main() {
             const libDotEnv = parseDotEnvFile(path.join(PROJECT_ROOT, '.env'));
             const dotEnv = { ...userDotEnv, ...libDotEnv };
 
-            // ── API Key and Quota Validation ──
+            // ── API Key and Quota Validation ──
             const { validateApiKey, startMission: requestMission } = await import('../src/arcalityClient.mjs');
 
             const validation = await validateApiKey();
@@ -1887,13 +1971,13 @@ async function main() {
             }
             if (!validation.valid) {
                 const errorMessages = {
-                    'no_api_key': '🔑 API Key no encontrada.\n   Configúrala vía `arcality init` o en .env (ARCALITY_API_KEY)',
-                    'invalid_format': '🔑 API Key inválida. Debe comenzar con "arc_"',
-                    'invalid_api_key': '🔑 API Key no reconocida por el servidor',
-                    'plan_expired': '💳 Tu plan ha expirado',
+                    'no_api_key': '🔑 API Key no encontrada.\n   Configúrala vía `arcality init` o en .env (ARCALITY_API_KEY)',
+                    'invalid_format': '🔑 API Key inválida. Debe comenzar con "arc_"',
+                    'invalid_api_key': '🔑 API Key no reconocida por el servidor',
+                    'plan_expired': '💳 Tu plan ha expirado',
                     'backend_unavailable': 'No se pudo conectar con Arcality. La herramienta requiere conexion al backend para validar la cuenta.'
                 };
-                note(chalk.red(errorMessages[validation.error] || `Error: ${validation.error}`), '❌ Autenticación');
+                note(chalk.red(errorMessages[validation.error] || `Error: ${validation.error}`), '❌ Autenticación');
                 agentMode = false;
                 prompt = "";
                 skipMenu = false;
@@ -1902,11 +1986,11 @@ async function main() {
 
             // Show plan info
             const modeLabel = validation.mode === 'mock' ? chalk.gray('[sandbox]') : chalk.cyanBright('[live-net]');
-            const dailyLimitDisplay = validation.daily_limit === -1 ? '∞' : (validation.daily_limit || 35);
-            const remainingDisplay = validation.remaining >= 999999 ? '∞' : validation.remaining;
+            const dailyLimitDisplay = validation.daily_limit === -1 ? '∞' : (validation.daily_limit || 35);
+            const remainingDisplay = validation.remaining >= 999999 ? '∞' : validation.remaining;
             note(
-                chalk.gray('Conexión: ') + chalk.cyanBright('SECURE ') + modeLabel + '\n' +
-                chalk.gray('Autorización: ') + chalk.white(validation.plan || 'internal') + '\n' +
+                chalk.gray('Conexión: ') + chalk.cyanBright('SECURE ') + modeLabel + '\n' +
+                chalk.gray('Autorización: ') + chalk.white(validation.plan || 'internal') + '\n' +
                 chalk.gray('Misiones:   ') + chalk.white(`${validation.daily_used || 0}/${dailyLimitDisplay}`) + '\n' +
                 chalk.gray('Reservas:   ') + chalk.white(remainingDisplay),
                 'Enlace Arcality'
@@ -1944,15 +2028,15 @@ async function main() {
                         const projects = data.projects || [];
 
                         const projOptions = projects.map(p => ({ label: p.name || p.Name, value: p.id || p.Id }));
-                        projOptions.push({ label: 'âž• Crear nuevo proyecto', value: 'new' });
+                        projOptions.push({ label: '➕ Crear nuevo proyecto', value: 'new' });
 
                         const projSelection = await select({
-                            message: chalk.cyan('Elige un proyecto para esta misión:'),
+                            message: chalk.cyan('Elige un proyecto para esta misión:'),
                             options: projOptions
                         });
 
                         if (isCancel(projSelection)) {
-                            cancel('Misión abortada.');
+                            cancel('Misión abortada.');
                             agentMode = false; prompt = ""; skipMenu = false; continue;
                         }
 
@@ -1978,9 +2062,9 @@ async function main() {
                                     note(chalk.red('El backend no devolvio un Project ID valido.'), 'Proyecto no conectado');
                                     selectedProjectId = null;
                                 }
-                                if (selectedProjectId) note(chalk.green(`✅ Proyecto creado: ${newName}`));
+                                if (selectedProjectId) note(chalk.green(`✅ Proyecto creado: ${newName}`));
                             } else {
-                                note(chalk.red(`❌ Falló al crear proyecto.`));
+                                note(chalk.red(`❌ Falló al crear proyecto.`));
                             }
                         } else {
                             selectedProjectId = projSelection;
@@ -2013,8 +2097,12 @@ async function main() {
                 continue;
             }
 
-            // ── Start Mission ──
-            const mission = await requestMission(prompt, discoverPath || '/');
+            // ── Start Mission ──
+            const effectiveBaseUrl = projectConfig?.project?.baseUrl || dotEnv.BASE_URL || process.env.BASE_URL || '';
+            const missionTargetUrl = discoverPath === '' && effectiveBaseUrl
+                ? effectiveBaseUrl
+                : (discoverPath || '/');
+            const mission = await requestMission(prompt, missionTargetUrl);
             if (!mission.allowed) {
                 if (mission.error === 'mission_limit_exceeded') {
                     note(
@@ -2044,19 +2132,19 @@ async function main() {
 
             const s = spinner();
             if (!process.argv.includes('--debug')) {
-                s.start(`â—‰ [ARCALITY INICIADO] Ejecutando directiva: "${prompt}" ${chalk.gray(`(${mission.daily_used}/${mission.daily_limit})`)}`);
+                s.start(`◉ [ARCALITY INICIADO] Ejecutando directiva: "${prompt}" ${chalk.gray(`(${mission.daily_used}/${mission.daily_limit})`)}`);
             } else {
-                console.log(chalk.cyan(`\nâ—‰ [ARCALITY INICIADO] Ejecutando directiva: "${prompt}" ${chalk.gray(`(${mission.daily_used}/${mission.daily_limit})`)}`));
+                console.log(chalk.cyan(`\n◉ [ARCALITY INICIADO] Ejecutando directiva: "${prompt}" ${chalk.gray(`(${mission.daily_used}/${mission.daily_limit})`)}`));
             }
 
             const finalProjectId = process.env.ARCALITY_PROJECT_ID || selectedProjectId;
 
-            // ── Cancelación Manual (Ctrl+C) — Estrategia bulletproof ──
+            // ── Cancelación Manual (Ctrl+C) — Estrategia bulletproof ──
             // El problema: @clack/prompts registra su propio SIGINT handler cada tick del spinner,
             // que llama a process.exit(0) directamente. removeAllListeners() no es suficiente porque
-            // Clack lo re-registra en cada frame de animación.
+            // Clack lo re-registra en cada frame de animación.
             //
-            // La solución: interceptar process.exit() antes de que Clack lo llame,
+            // La solución: interceptar process.exit() antes de que Clack lo llame,
             // y usar prependListener para que NUESTRO handler siempre se ejecute primero.
 
             let activeChildProcess = null;
@@ -2068,18 +2156,18 @@ async function main() {
             const _origProcessExit = process.exit.bind(process);
             process.exit = (code) => {
                 if (_missionActive) {
-                    // Clack (u otra lib) está intentando matar el proceso — lo bloqueamos.
-                    // Nuestro cancelHandler ya habrá sido invocado vía prependListener.
-                    // El proceso se cerrará naturalmente cuando el child process termine.
+                    // Clack (u otra lib) está intentando matar el proceso — lo bloqueamos.
+                    // Nuestro cancelHandler ya habrá sido invocado vía prependListener.
+                    // El proceso se cerrará naturalmente cuando el child process termine.
                     return;
                 }
                 _origProcessExit(code);
             };
 
-            // ── RESTORE RAW MODE FOR WINDOWS FIX ──
-            // @clack/prompts pausea stdin y desactiva raw mode al terminar un menú.
-            // Debemos reactivarlo aquí para que nuestro interceptor global de Ctrl+C
-            // siga funcionando durante toda la misión.
+            // ── RESTORE RAW MODE FOR WINDOWS FIX ──
+            // @clack/prompts pausea stdin y desactiva raw mode al terminar un menú.
+            // Debemos reactivarlo aquí para que nuestro interceptor global de Ctrl+C
+            // siga funcionando durante toda la misión.
             if (process.stdin.isTTY && process.stdin.setRawMode) {
                 try {
                     process.stdin.setRawMode(true);
@@ -2090,21 +2178,21 @@ async function main() {
             const cancelHandler = () => {
                 sigintCount++;
                 if (sigintCount > 3) {
-                    console.log(chalk.red('\n🛑 Forzando salida inmediata...'));
+                    console.log(chalk.red('\n🛑 Forzando salida inmediata...'));
                     _missionActive = false;
                     _origProcessExit(1);
                     return;
                 }
 
                 if (userCanceledMission) {
-                    console.log(chalk.yellow('\n⏳ Cancelación en progreso, esperando reporte... (Ctrl+C x4 para forzar cierre)'));
+                    console.log(chalk.yellow('\n⏳ Cancelación en progreso, esperando reporte... (Ctrl+C x4 para forzar cierre)'));
                     return;
                 }
                 userCanceledMission = true;
 
-                console.log(chalk.yellow('\n\n⚠️  [ARCALITY] Directiva abortada por el operador.'));
+                console.log(chalk.yellow('\n\n⚠️  [ARCALITY] Directiva abortada por el operador.'));
                 if (!process.argv.includes('--debug')) {
-                    try { s.stop(chalk.yellow('⚠️  Directiva abortada.')); } catch { /* ignore */ }
+                    try { s.stop(chalk.yellow('⚠️  Directiva abortada.')); } catch { /* ignore */ }
                 }
 
                 // Terminar el proceso hijo de Playwright directamente (Windows-safe)
@@ -2136,8 +2224,8 @@ async function main() {
                 } catch { /* silencioso */ }
 
                 console.log(chalk.gray('   >> Esperando que Playwright cierre y genere el reporte...'));
-                // Playwright también recibe el SIGINT nativamente desde la terminal Windows
-                // y cerrará su proceso limpiamente, lo que resolverá la Promise del run() → finally
+                // Playwright también recibe el SIGINT nativamente desde la terminal Windows
+                // y cerrará su proceso limpiamente, lo que resolverá la Promise del run() → finally
             };
 
             // prependListener asegura que nuestro handler se ejecuta ANTES que el de Clack
@@ -2145,19 +2233,20 @@ async function main() {
             process.prependListener('SIGTERM', cancelHandler);
 
 
-            // Build env for the runner — merge arcality.config values.
-            // ARCALITY_API_URL must be explicit — it comes from the library's internal config,
+            // Build env for the runner — merge arcality.config values.
+            // ARCALITY_API_URL must be explicit — it comes from the library's internal config,
             // not from the user's project .env, so we inject it directly via getApiUrl().
             const fallbackBaseUrl = (!projectConfig && discoverPath?.startsWith('http')) ? discoverPath : undefined;
 
             const mergedEnv = {
                 ...dotEnv,
                 ...process.env,
-                ARCALITY_API_URL: getApiUrl(),          // Internal URL — always injected explicitly
+                ARCALITY_ROOT: PROJECT_ROOT,
+                ARCALITY_API_URL: getApiUrl(),          // Internal URL — always injected explicitly
                 ARCALITY_PROJECT_ID: finalProjectId,
                 ARCALITY_PROJECT_ROOT: ORIGINAL_CWD,
-                ARCALITY_MISSION_ID: mission.mission_id || mission.missionId || mission.MissionId || '',  // ← Propagate mission_id to every proxy call
-                ARCALITY_ORG_ID: validation.organization_id || validation.organizationId || validation.OrganizationId || process.env.ARCALITY_ORG_ID || '',  // ← Propagate org_id for pattern persistence
+                ARCALITY_MISSION_ID: mission.mission_id || mission.missionId || mission.MissionId || '',  // ← Propagate mission_id to every proxy call
+                ARCALITY_ORG_ID: validation.organization_id || validation.organizationId || validation.OrganizationId || process.env.ARCALITY_ORG_ID || '',  // ← Propagate org_id for pattern persistence
                 BASE_URL: projectConfig?.project?.baseUrl || dotEnv.BASE_URL || process.env.BASE_URL || fallbackBaseUrl || 'http://localhost:3000',
                 LOGIN_USER: projectConfig?.auth?.username || dotEnv.LOGIN_USER || process.env.LOGIN_USER,
                 LOGIN_PASSWORD: projectConfig?.auth?.password || dotEnv.LOGIN_PASSWORD || process.env.LOGIN_PASSWORD,
@@ -2168,7 +2257,8 @@ async function main() {
                 CONTEXT_DIR: process.env.CONTEXT_DIR,
                 REPORTS_DIR: process.env.REPORTS_DIR,
                 SMART_PROMPT: prompt,
-                TARGET_PATH: discoverPath || '/'
+                TARGET_PATH: discoverPath ?? '/',
+                ARCALITY_DB_VALIDATIONS_JSON: missionDbValidations.length > 0 ? JSON.stringify(missionDbValidations) : (process.env.ARCALITY_DB_VALIDATIONS_JSON || process.env.ARCALITY_DB_VALIDATIONS || '')
             };
 
             if (finalProjectId) {
@@ -2176,17 +2266,17 @@ async function main() {
                 console.log(chalk.gray(`>> ARCALITY_ORG_ID: ${mergedEnv.ARCALITY_ORG_ID || 'NONE'}`));
             }
 
-            // ── Resolve execution paths ──
+            // ── Resolve execution paths ──
             // tsx and playwright are HOISTED to ORIGINAL_CWD/node_modules when installed via npm.
             // We run from ORIGINAL_CWD so relative paths for playwright work.
             // For the test file and config (inside the arcality package), we use absolute paths.
             //
-            // KEY: tsx loader uses file:// URL (pathToFileURL) so spaces encode as %20 — no quoting needed.
+            // KEY: tsx loader uses file:// URL (pathToFileURL) so spaces encode as %20 — no quoting needed.
 
             const testFile = path.join(PROJECT_ROOT, 'tests', '_helpers', 'agentic-runner.spec.ts');
             const configFile = path.join(PROJECT_ROOT, 'playwright.config.js');
 
-            // Resolve playwright CLI — CRITICAL singleton alignment:
+            // Resolve playwright CLI — CRITICAL singleton alignment:
             //
             // @playwright/test uses `playwright` internally. When npm detects a version mismatch
             // between the top-level `playwright` and what `@playwright/test` needs, it installs
@@ -2194,15 +2284,15 @@ async function main() {
             //
             // Playwright's test runner tracks the active suite via a module-level singleton
             // (currentSuite). If the CLI uses a DIFFERENT playwright instance than the one
-            // @playwright/test loaded, their singletons are out of sync → "did not expect test()
+            // @playwright/test loaded, their singletons are out of sync → "did not expect test()
             // to be called here".
             //
             // Fix: ALWAYS prefer the playwright nested INSIDE @playwright/test, because that is
             // guaranteed to be the same instance that @playwright/test uses for its internals.
             //
             // Resolution priority:
-            //   1. <project>/@playwright/test/node_modules/playwright/cli.js  ← nested (safe)
-            //   2. <project>/playwright/cli.js                                 ← sibling top-level
+            //   1. <project>/@playwright/test/node_modules/playwright/cli.js  ← nested (safe)
+            //   2. <project>/playwright/cli.js                                 ← sibling top-level
             //   (repeated for ORIGINAL_CWD and PROJECT_ROOT)
             let playwrightCli;
             try {
@@ -2221,9 +2311,9 @@ async function main() {
 
                 if (!testRunnerPath) throw resolveError;
 
-                const testRunnerDir = path.dirname(testRunnerPath); // → .../node_modules/@playwright/test/
+                const testRunnerDir = path.dirname(testRunnerPath); // → .../node_modules/@playwright/test/
 
-                // Priority 1: playwright nested INSIDE @playwright/test — same singleton as the package uses
+                // Priority 1: playwright nested INSIDE @playwright/test — same singleton as the package uses
                 const nestedCli = path.join(testRunnerDir, 'node_modules', 'playwright', 'cli.js');
                 // Priority 2: playwright as a top-level sibling (clean installs, versions aligned)
                 const siblingCli = path.join(testRunnerDir, '..', '..', 'playwright', 'cli.js');
@@ -2242,7 +2332,7 @@ async function main() {
                     console.log(chalk.gray(`[DEBUG] Using playwright CLI: ${playwrightCli}`));
                 }
             } catch (e) {
-                console.error(chalk.red('\n[FATAL] Núcleo de Playwright no encontrado. Asegúrate de que @playwright/test esté instalado.'));
+                console.error(chalk.red('\n[FATAL] Núcleo de Playwright no encontrado. Asegúrate de que @playwright/test esté instalado.'));
                 console.error(chalk.red(e.message));
                 console.error(chalk.yellow('\nConsejo: Ejecuta `npm install @playwright/test` en tu directorio de proyecto.'));
                 _missionActive = false;
@@ -2254,9 +2344,9 @@ async function main() {
             const postProcessSigint = () => {
                 _postProcessSigintCount++;
                 if (_postProcessSigintCount === 1) {
-                    console.log(chalk.yellow('\n⏳ Finalizando reporte de telemetría, por favor espera... (Ctrl+C de nuevo para salir ya)'));
+                    console.log(chalk.yellow('\n⏳ Finalizando reporte de telemetría, por favor espera... (Ctrl+C de nuevo para salir ya)'));
                 } else {
-                    console.log(chalk.red('\n🛑 Saliendo forzado por el usuario.'));
+                    console.log(chalk.red('\n🛑 Saliendo forzado por el usuario.'));
                     process.removeAllListeners('SIGINT');
                     process.removeAllListeners('SIGTERM');
                     process.exit(0);
@@ -2274,20 +2364,20 @@ async function main() {
                 }
             } else
 
-            // ── Auto-compilar el runner antes de ejecutar Playwright para asegurar que los cambios de rama/merge estén aplicados ──
+            // ── Auto-compilar el runner antes de ejecutar Playwright para asegurar que los cambios de rama/merge estén aplicados ──
             try {
                 if (!process.argv.includes('--debug')) {
-                    s.message('⚙️  Compilando agente de pruebas (Arcality Runner)...');
+                    s.message('⚙️  Compilando agente de pruebas (Arcality Runner)...');
                 } else {
-                    console.log(chalk.cyan('⚙️  Compilando agente de pruebas (Arcality Runner)...'));
+                    console.log(chalk.cyan('⚙️  Compilando agente de pruebas (Arcality Runner)...'));
                 }
                 await ensureRunnerBundle({ debug: process.argv.includes('--debug') });
             } catch (err) {
-                console.warn(chalk.yellow(`\n⚠️  Advertencia: No se pudo auto-compilar el runner: ${err.message}`));
+                console.warn(chalk.yellow(`\n⚠️  Advertencia: No se pudo auto-compilar el runner: ${err.message}`));
             }
 
             try {
-                // No test file path is passed — playwright.config.js uses testMatch:'agentic-runner.spec.ts'
+                // No test file path is passed — playwright.config.js uses testMatch:'agentic-runner.spec.ts'
                 // This eliminates the Windows regex path issue permanently on any user's machine.
                 await run('node', [
                     '--no-warnings',
@@ -2299,7 +2389,7 @@ async function main() {
                     cwd: PROJECT_ROOT,
                     env: mergedEnv,
                     onStatus: (msg) => { if (!process.argv.includes('--debug')) s.message(msg); else console.log(chalk.gray(`>> Status: ${msg}`)); },
-                    onSpawn: (child) => { activeChildProcess = child; }  // ← Capturar referencia para cancelHandler
+                    onSpawn: (child) => { activeChildProcess = child; }  // ← Capturar referencia para cancelHandler
                 });
 
                 process.removeAllListeners('SIGINT');
@@ -2310,11 +2400,11 @@ async function main() {
                 if (userCanceledMission) {
                     missionResult = 'canceled';
                     finalFailReason = 'user_canceled';
-                    // Detener el spinner explícitamente antes de salir
+                    // Detener el spinner explícitamente antes de salir
                     if (!process.argv.includes('--debug')) {
-                        try { s.stop(chalk.yellow('⚠️  Misión cancelada por el usuario.')); } catch { }
+                        try { s.stop(chalk.yellow('⚠️  Misión cancelada por el usuario.')); } catch { }
                     }
-                    return; // El handler ya tomó el control, finally se ejecutará
+                    return; // El handler ya tomó el control, finally se ejecutará
                 }
 
                 const persistedMissionResult = readMissionResult(
@@ -2346,24 +2436,24 @@ async function main() {
                 if (!process.argv.includes('--debug')) s.stop(chalk.green('\u2705 Mision completada exitosamente.'));
                 else console.log(chalk.green('\u2705 Mision completada exitosamente.'));
 
-                // ── Ping Project ──
+                // ── Ping Project ──
                 await pingProject(finalProjectId, process.env.ARCALITY_API_KEY);
 
-                // ── Save Mission YAML ──
+                // ── Save Mission YAML ──
                 let saveDecision = 'no';
                 if (!skipSavePrompt && !batchMode) {
                     saveDecision = await select({
-                        message: '¿Quieres guardar esta misión para ejecutarla de nuevo más tarde?',
+                        message: '¿Quieres guardar esta misión para ejecutarla de nuevo más tarde?',
                         options: [
-                            { label: '✅ Sí, guardar como YAML', value: 'yes' },
-                            { label: '❌ No, gracias', value: 'no' }
+                            { label: '✅ Sí, guardar como YAML', value: 'yes' },
+                            { label: '❌ No, gracias', value: 'no' }
                         ]
                     });
                 }
 
                 if (saveDecision === 'yes') {
                     const name = await text({
-                        message: 'Nombre de la misión (ej., login_valido):',
+                        message: 'Nombre de la misión (ej., login_valido):',
                         placeholder: 'my_mission',
                         validate: v => v.length < 3 ? 'Nombre muy corto' : undefined
                     });
@@ -2420,9 +2510,9 @@ async function main() {
                             fs.mkdirSync(yamlOutputTargetDir, { recursive: true });
                             const yamlPathOutput = path.join(yamlOutputTargetDir, `${safeName}.yaml`);
                             fs.writeFileSync(yamlPathOutput, yamlData);
-                            note(chalk.green(`✅ Misión guardada en: ${yamlPathOutput}`), 'Persistencia Arcality');
+                            note(chalk.green(`✅ Misión guardada en: ${yamlPathOutput}`), 'Persistencia Arcality');
                         } else {
-                            note(chalk.green(`✅ Misión guardada en: ${yamlPathMissions}`), 'Persistencia Arcality');
+                            note(chalk.green(`✅ Misión guardada en: ${yamlPathMissions}`), 'Persistencia Arcality');
                         }
                     }
                 }
@@ -2454,7 +2544,7 @@ async function main() {
                 if (userCanceledMission) {
                     missionResult = 'canceled';
                     finalFailReason = 'user_canceled';
-                    finalFailReasoning = 'La misión fue detenida manualmente por el operador (Ctrl+C). Esto no es una falla técnica del sistema.';
+                    finalFailReasoning = 'La misión fue detenida manualmente por el operador (Ctrl+C). Esto no es una falla técnica del sistema.';
                     await new Promise(r => setTimeout(r, 800));
                 }
 
@@ -2463,9 +2553,9 @@ async function main() {
 
                 const sRep = spinner();
                 if (!process.argv.includes('--debug')) {
-                    sRep.start('📊 Generando reporte...');
+                    sRep.start('📊 Generando reporte...');
                 } else {
-                    console.log('📊 Generando reporte...');
+                    console.log('📊 Generando reporte...');
                 }
 
                 await run("node", [path.join(PROJECT_ROOT, "scripts/rebrand-report.mjs")]).catch(() => { });
@@ -2496,7 +2586,7 @@ async function main() {
                     }
                 } catch(e) {}
 
-                // ── Upload Evidence (solo si NO fue cancelado por usuario) ──
+                // ── Upload Evidence (solo si NO fue cancelado por usuario) ──
                 if (missionResult !== 'canceled') {
                     try {
                         const { getEvidenceSasToken } = await import('../src/arcalityClient.mjs');
@@ -2510,7 +2600,7 @@ async function main() {
 
                         if (sasData && actualSasUrl && actualBasePath) {
                             if (!process.argv.includes('--debug')) {
-                                sRep.start('☁️  Subiendo evidencia a Azure...');
+                                sRep.start('☁️  Subiendo evidencia a Azure...');
                             }
                             process.removeAllListeners('SIGINT');
                             process.removeAllListeners('SIGTERM');
@@ -2524,26 +2614,26 @@ async function main() {
                                 finalReportUrl = `${parsedSas.origin}${parsedSas.pathname}/${actualBasePath}/index.html`;
                             } catch(e) {}
 
-                            if (!process.argv.includes('--debug')) sRep.stop(chalk.green('✅ Evidencia subida exitosamente.'));
+                            if (!process.argv.includes('--debug')) sRep.stop(chalk.green('✅ Evidencia subida exitosamente.'));
                         }
                     } catch (e) {
-                        if (process.argv.includes('--debug')) console.log(chalk.yellow(`⚠️  Could not upload evidence: ${e.message}`));
-                        if (!process.argv.includes('--debug')) sRep.stop(chalk.yellow('⚠️  Fallo al subir evidencia.'));
+                        if (process.argv.includes('--debug')) console.log(chalk.yellow(`⚠️  Could not upload evidence: ${e.message}`));
+                        if (!process.argv.includes('--debug')) sRep.stop(chalk.yellow('⚠️  Fallo al subir evidencia.'));
                     }
                 } else {
-                    console.log(chalk.gray('   >> Saltando subida de evidencia (la misión fue cancelada).'));
+                    console.log(chalk.gray('   >> Saltando subida de evidencia (la misión fue cancelada).'));
                 }
 
-                // ── End Mission — SIEMPRE se llama, independientemente de si la evidencia subió ──
+                // ── End Mission — SIEMPRE se llama, independientemente de si la evidencia subió ──
                 try {
                     const { endMission } = await import('../src/arcalityClient.mjs');
                     await Promise.race([
                         endMission(mission.mission_id, missionResult || 'failed', finalUsageData, finalFailReason, finalReportUrl, finalFailReasoning),
                         new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 8000))
                     ]);
-                    if (process.argv.includes('--debug')) console.log(chalk.gray(`[DEBUG] endMission called → result: ${missionResult}, failReason: ${finalFailReason}`));
+                    if (process.argv.includes('--debug')) console.log(chalk.gray(`[DEBUG] endMission called → result: ${missionResult}, failReason: ${finalFailReason}`));
                 } catch (e) {
-                    if (process.argv.includes('--debug')) console.log(chalk.yellow(`⚠️  Could not end mission in backend: ${e.message}`));
+                    if (process.argv.includes('--debug')) console.log(chalk.yellow(`⚠️  Could not end mission in backend: ${e.message}`));
                 }
 
                 if (globalReportProcess) {
@@ -2558,10 +2648,10 @@ async function main() {
                 }
 
                 if (!batchMode && fs.existsSync(arcalityPath)) {
-                    console.log(chalk.blue(`🌐 Abriendo Reporte de Arcality: ${arcalityPath}`));
+                    console.log(chalk.blue(`🌐 Abriendo Reporte de Arcality: ${arcalityPath}`));
                     openLocalFile(arcalityPath);
                 } else if (!fs.existsSync(arcalityPath)) {
-                    console.log(chalk.yellow(`⚠️  Reporte no generado (la prueba pudo haber fallado antes de completarse).`));
+                    console.log(chalk.yellow(`⚠️  Reporte no generado (la prueba pudo haber fallado antes de completarse).`));
                 }
 
                 await new Promise(resolve => setTimeout(resolve, 2000));
@@ -2572,7 +2662,7 @@ async function main() {
                     new Promise(resolve => setTimeout(resolve, 5000))
                 ]);
 
-                // Limpiar handlers del post-proceso ANTES de esperar Enter, ya que toda la telemetría y reportes ya finalizaron
+                // Limpiar handlers del post-proceso ANTES de esperar Enter, ya que toda la telemetría y reportes ya finalizaron
                 process.removeListener('SIGINT', postProcessSigint);
                 process.removeListener('SIGTERM', postProcessSigint);
 
@@ -2584,10 +2674,10 @@ async function main() {
                 }
 
                 if (false && !batchMode) {
-                    // Esperar Enter para regresar al menú
+                    // Esperar Enter para regresar al menú
                     // Usamos escucha directa de stdin (raw mode) porque @clack/text
-                    // no procesa Enter correctamente cuando setRawMode(true) está activo.
-                    console.log(chalk.gray('\n   Presiona Enter para regresar al menú...'));
+                    // no procesa Enter correctamente cuando setRawMode(true) está activo.
+                    console.log(chalk.gray('\n   Presiona Enter para regresar al menú...'));
                     await new Promise(resolve => {
                         const onKey = (key) => {
                             const keyStr = String(key);
@@ -2599,7 +2689,7 @@ async function main() {
                                     process.stdin.setRawMode(false);
                                 }
                                 // FIX: pausar stdin si vamos a salir para que el event loop no se quede colgado.
-                                // Si volvemos al menú, no lo pausamos (para evitar el bug de exit en clack).
+                                // Si volvemos al menú, no lo pausamos (para evitar el bug de exit en clack).
                                 if (skipMenu) {
                                     process.stdin.pause();
                                 }
@@ -2612,22 +2702,22 @@ async function main() {
                             }
                         };
 
-                        // ── BUGFIX: @clack/prompts llama explícitamente a process.stdin.pause()
+                        // ── BUGFIX: @clack/prompts llama explícitamente a process.stdin.pause()
                         // al terminar cada select()/text(). En Node.js, agregar un listener 'data'
-                        // a un stream EXPLÍCITAMENTE pausado NO lo reactiva automáticamente.
-                        // Resultado: el event loop queda vacío y el proceso termina antes de que
+                        // a un stream EXPLÍCITAMENTE pausado NO lo reactiva automáticamente.
+                        // Resultado: el event loop queda vacío y el proceso termina antes de que
                         // el usuario pueda presionar Enter.
-                        // Solución: llamar resume() explícitamente antes de registrar el listener.
+                        // Solución: llamar resume() explícitamente antes de registrar el listener.
                         if (process.stdin.isTTY && process.stdin.setRawMode) {
                             process.stdin.setRawMode(true); // raw mode para capturar Enter inmediatamente
                         }
-                        process.stdin.resume(); // ← CRÍTICO: reactiva stdin para mantener el event loop vivo
+                        process.stdin.resume(); // ← CRÍTICO: reactiva stdin para mantener el event loop vivo
                         process.stdin.on('data', onKey);
                     });
                 }
 
                 if (skipMenu) {
-                    outro(chalk.cyan('¡Misión terminada! Hasta luego.'));
+                    outro(chalk.cyan('¡Misión terminada! Hasta luego.'));
                     return;
                 }