@arcadialdev/arcality 3.0.3 → 3.0.4

package/package.json

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

package/scripts/gen-and-run.mjs

@@ -609,6 +609,7 @@ async function waitForEnter(message = 'Presiona Enter para continuar...', option
         if (process.stdin.isTTY && process.stdin.setRawMode) {
             process.stdin.setRawMode(false);
         }
+        process.stdin.resume();
 
         const rl = createInterface({
             input: process.stdin,
@@ -2158,6 +2159,8 @@ async function main() {
                 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,
+                ARCALITY_ASSETS_FILE: projectConfig?.assets?.manifestPath || dotEnv.ARCALITY_ASSETS_FILE || process.env.ARCALITY_ASSETS_FILE || path.join(ORIGINAL_CWD, '.arcality', 'assets.json'),
+                ARCALITY_ASSETS_DIR: projectConfig?.assets?.directory || dotEnv.ARCALITY_ASSETS_DIR || process.env.ARCALITY_ASSETS_DIR || path.join(ORIGINAL_CWD, '.arcality', 'assets'),
                 DOMAIN_DIR: process.env.DOMAIN_DIR,
                 MISSIONS_DIR: process.env.MISSIONS_DIR,
                 CONTEXT_DIR: process.env.CONTEXT_DIR,
@@ -2245,7 +2248,18 @@ async function main() {
                 _origProcessExit(1);
             }
 
-            const postProcessSigint = () => console.log(chalk.yellow('\n⏳ Finalizando reporte de telemetría, por favor espera...'));
+            let _postProcessSigintCount = 0;
+            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)'));
+                } else {
+                    console.log(chalk.red('\n🛑 Saliendo forzado por el usuario.'));
+                    process.removeAllListeners('SIGINT');
+                    process.removeAllListeners('SIGTERM');
+                    process.exit(0);
+                }
+            };
             let missionResult = null;
             let finalFailReason = null;
             let finalUsageData = undefined;
@@ -2493,7 +2507,10 @@ async function main() {
                 // ── End Mission — SIEMPRE se llama, independientemente de si la evidencia subió ──
                 try {
                     const { endMission } = await import('../src/arcalityClient.mjs');
-                    await endMission(mission.mission_id, missionResult || 'failed', finalUsageData, finalFailReason, finalReportUrl, finalFailReasoning);
+                    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}`));
                 } catch (e) {
                     if (process.argv.includes('--debug')) console.log(chalk.yellow(`⚠️  Could not end mission in backend: ${e.message}`));
@@ -2519,11 +2536,11 @@ async function main() {
 
                 await new Promise(resolve => setTimeout(resolve, 2000));
 
-                // Ping project after report
-                await pingProject(
-                    process.env.ARCALITY_PROJECT_ID,
-                    process.env.ARCALITY_API_KEY
-                );
+                // Ping project after report (with timeout so it cannot hang the exit path)
+                await Promise.race([
+                    pingProject(process.env.ARCALITY_PROJECT_ID, process.env.ARCALITY_API_KEY),
+                    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
                 process.removeListener('SIGINT', postProcessSigint);

package/src/KnowledgeService.ts

@@ -30,22 +30,22 @@ export interface PortalContextResponse {
     fields: Array<{ field_identifier: string; field_type: string; is_required: boolean }>;
 }
 
-export interface ProjectDto {
-    id: string;
-    name: string;
-    base_url?: string;
-}
-
-function isRealProjectId(projectId?: string | null): boolean {
-    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;
-}
-
-export class KnowledgeService {
+export interface ProjectDto {
+    id: string;
+    name: string;
+    base_url?: string;
+}
+
+function isRealProjectId(projectId?: string | null): boolean {
+    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;
+}
+
+export class KnowledgeService {
     private static instance: KnowledgeService;
     private apiBase: string;
     private apiKey: string;
@@ -89,10 +89,10 @@ export class KnowledgeService {
     }
 
     public getProjectId(): string | null {
-        if (!isRealProjectId(this.projectId)) {
-            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
-        }
-        return isRealProjectId(this.projectId) ? this.projectId : null;
+        if (!isRealProjectId(this.projectId)) {
+            this.projectId = process.env.ARCALITY_PROJECT_ID || null;
+        }
+        return isRealProjectId(this.projectId) ? this.projectId : null;
     }
 
     /**
@@ -107,7 +107,7 @@ export class KnowledgeService {
             const data = await res.json();
             return data.projects || [];
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[KnowledgeService] Error al obtener proyectos: ${e.message}`));
             return [];
         }
     }
@@ -125,7 +125,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            if (process.env.DEBUG) console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
+            if (process.env.DEBUG) console.error(chalk.red(`[KnowledgeService] Falló creación de proyecto: ${e.message}`));
             return null;
         }
     }
@@ -134,8 +134,8 @@ export class KnowledgeService {
      * 2. Ingesta (Post-Percept)
      */
     public async ingest(payload: PortalIngestRequest): Promise<void> {
-        if (!isRealProjectId(payload.project_id)) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
+        if (!isRealProjectId(payload.project_id)) {
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Ingesta cancelada: project_id es inválido.`));
             return;
         }
 
@@ -157,7 +157,7 @@ export class KnowledgeService {
                 }
             }
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error en ingesta: ${e.message}`));
         }
     }
 
@@ -179,7 +179,7 @@ export class KnowledgeService {
             if (!res.ok) return null;
             return await res.json();
         } catch (e: any) {
-            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
+            if (process.env.DEBUG) console.warn(chalk.yellow(`[Knowledge] Error al obtener contexto: ${e.message}`));
             return null;
         }
     }
@@ -207,7 +207,7 @@ export class KnowledgeService {
                     severity
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nueva regla registrada: ${title}`));
         } catch (e) { }
     }
 
@@ -233,7 +233,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo campo catalogado: ${identifier}`));
         } catch (e) { }
     }
 
@@ -259,7 +259,7 @@ export class KnowledgeService {
                     source: "agent_auto"
                 })
             });
-            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
+            if (process.env.DEBUG) console.log(chalk.green(`[Knowledge] Nuevo conocimiento guardado: ${title}`));
         } catch (e) { }
     }
 

package/src/arcalityClient.mjs

@@ -306,10 +306,16 @@ function simpleHash(str) {
         hash = ((hash << 5) - hash) + char;
         hash |= 0;
     }
-    return 'ph_' + Math.abs(hash).toString(36);
-}
-
-/**
+    return 'ph_' + Math.abs(hash).toString(36);
+}
+
+function normalizeBugClassification(value) {
+    const text = String(value || '').trim();
+    const allowed = ['[Backend Bug]', '[Frontend Bug]', '[UI Regression]', '[Flaky/Stale Selector]'];
+    return allowed.find(category => text.includes(category)) || '';
+}
+
+/**
  * Crea una Task en Azure DevOps cuando se detecta un bug en el portal.
  * Si la organización no tiene la integración configurada (HTTP 400) se registra
  * sólo en modo DEBUG y NO interrumpe el flujo del test runner.
@@ -318,7 +324,7 @@ function simpleHash(str) {
  * @param {string} description - Descripción detallada del bug detectado
  * @returns {Promise<{success: boolean, taskUrl?: string, error?: string}>}
  */
-export async function createAdoTask(title, description) {
+export async function createAdoTask(title, description, metadata = {}) {
     const apiBase = getEffectiveApiBase();
     if (!apiBase) {
         if (process.env.DEBUG) console.log(`[ADO] No hay ARCALITY_API_URL configurado. Omitiendo creación de Task en Azure DevOps.`);
@@ -337,19 +343,26 @@ export async function createAdoTask(title, description) {
         return { success: false, error: 'no_api_key' };
     }
 
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 15000);
-
-        const res = await fetch(`${apiBase}/api/v1/integrations/azuredevops/task`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-api-key': key
-            },
-            body: JSON.stringify({ project_id: projectId, title, description }),
-            signal: controller.signal
-        });
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15000);
+        const bugClassification = normalizeBugClassification(metadata?.classification);
+        const taskTitle = bugClassification && !String(title).includes(bugClassification)
+            ? `${bugClassification} ${title}`
+            : title;
+        const taskDescription = bugClassification && !String(description).includes('Clasificacion')
+            ? `**Clasificacion:** ${bugClassification}\n\n${description}`
+            : description;
+
+        const res = await fetch(`${apiBase}/api/v1/integrations/azuredevops/task`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': key
+            },
+            body: JSON.stringify({ project_id: projectId, title: taskTitle, description: taskDescription }),
+            signal: controller.signal
+        });
         clearTimeout(timeout);
 
         if (res.status === 400) {

package/src/configLoader.mjs

@@ -1,10 +1,10 @@
 // src/configLoader.mjs
 // Configuration loader — supports arcality.config (primary) and .env / global config (fallback)
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import dotenv from 'dotenv';
-import { isRealProjectId } from './configManager.mjs';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import dotenv from 'dotenv';
+import { isRealProjectId } from './configManager.mjs';
 
 dotenv.config();
 
@@ -59,22 +59,22 @@ export function loadConfig() {
         ARCALITY_PROJECT_ID: localConfig?.projectId || process.env.ARCALITY_PROJECT_ID,
     };
 
-    if (!config.ARCALITY_API_KEY) {
-        throw new Error('ARCALITY_API_KEY is not defined. Run `arcality init` or set it in your .env file.');
-    }
-
-    if (!isRealProjectId(config.ARCALITY_PROJECT_ID)) {
-        throw new Error('ARCALITY_PROJECT_ID is not connected to a real Arcality project. Run `arcality init`.');
-    }
-
-    return config;
-}
+    if (!config.ARCALITY_API_KEY) {
+        throw new Error('ARCALITY_API_KEY is not defined. Run `arcality init` or set it in your .env file.');
+    }
+
+    if (!isRealProjectId(config.ARCALITY_PROJECT_ID)) {
+        throw new Error('ARCALITY_PROJECT_ID is not connected to a real Arcality project. Run `arcality init`.');
+    }
 
-export function loadProjectId() {
-    const localConfig = loadLocalArcalityConfig();
-    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID;
-    return isRealProjectId(projectId) ? projectId : null;
-}
+    return config;
+}
+
+export function loadProjectId() {
+    const localConfig = loadLocalArcalityConfig();
+    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID;
+    return isRealProjectId(projectId) ? projectId : null;
+}
 
 
 /**
@@ -133,25 +133,25 @@ export function getApiKey() {
     return { key: null, source: 'none' };
 }
 
-/**
- * Loads supported Arcality runtime values into process.env.
- */
-export function setupProcessEnv() {
-    const config = loadGlobalConfig();
-    if (!config) return;
-
-    // Load Arcality API Key
-    getApiKey();
-
-    // Also inject arcality.config values into process.env for backward compat
-    const localConfig = loadLocalArcalityConfig();
+/**
+ * Loads supported Arcality runtime values into process.env.
+ */
+export function setupProcessEnv() {
+    const config = loadGlobalConfig();
+    if (!config) return;
+
+    // Load Arcality API Key
+    getApiKey();
+
+    // Also inject arcality.config values into process.env for backward compat
+    const localConfig = loadLocalArcalityConfig();
     if (localConfig) {
         if (localConfig.apiKey && !process.env.ARCALITY_API_KEY) {
             process.env.ARCALITY_API_KEY = localConfig.apiKey;
         }
-        if (isRealProjectId(localConfig.projectId) && !process.env.ARCALITY_PROJECT_ID) {
-            process.env.ARCALITY_PROJECT_ID = localConfig.projectId;
-        }
+        if (isRealProjectId(localConfig.projectId) && !process.env.ARCALITY_PROJECT_ID) {
+            process.env.ARCALITY_PROJECT_ID = localConfig.projectId;
+        }
         if (localConfig.project?.baseUrl && !process.env.BASE_URL) {
             process.env.BASE_URL = localConfig.project.baseUrl;
         }

package/tests/_helpers/ArcalityReporter.js

@@ -747,6 +747,11 @@ class ArcalityReporter {
             background: var(--brand-soft);
             border-color: rgba(181,108,255,0.26);
         }
+        .tag-bug {
+            color: #b7e4ff;
+            background: rgba(80,170,255,0.12);
+            border-color: rgba(80,170,255,0.3);
+        }
         .tag-retry {
             color: #ffe2a6;
             background: var(--warning-soft);
@@ -941,6 +946,8 @@ class ArcalityReporter {
             const isOpen = this.results.length === 1 || tone === 'failed' || i === 0;
             const successSummary = r.attachments.find(a => a.name === 'success_summary');
             const successText = this.getAttachmentText(successSummary);
+            const bugClassificationAtt = r.attachments.find(a => a.name === 'bug_classification');
+            const bugClassification = (this.getAttachmentText(bugClassificationAtt) || '').trim();
             const evidenceHtml = this.renderVisualEvidence(r.attachments);
             const contextHtml = this.renderTextAttachmentSection(r.attachments, 'qa_context_summary', 'Contexto QA aplicado');
             const securityHtml = this._renderSecuritySection(r.attachments, i);
@@ -954,6 +961,7 @@ class ArcalityReporter {
                                 <div class="test-meta">
                                     <span class="tag tag-status-${tone}">${this.getStatusLabel(r.result.status)}</span>
                                     <span class="tag tag-project">${this.escapeHtml(projectName)}</span>
+                                    ${bugClassification ? `<span class="tag tag-bug">${this.escapeHtml(bugClassification)}</span>` : ''}
                                     ${r.result.retry > 0 ? `<span class="tag tag-retry">Retry #${r.result.retry}</span>` : ''}
                                     <span class="tag">${this.formatDuration(r.result.duration)}</span>
                                 </div>
@@ -972,6 +980,13 @@ class ArcalityReporter {
                                     </div>
                                 ` : ''}
 
+                                ${r.result.error && bugClassification ? `
+                                    <div class="outcome-block error">
+                                        <span class="outcome-label">Clasificacion AI</span>
+                                        <pre class="error-block">${this.escapeHtml(bugClassification)}</pre>
+                                    </div>
+                                ` : ''}
+
                                 ${r.result.error ? `
                                     <div class="outcome-block error">
                                         <span class="outcome-label">Diagnostico del bloqueo</span>