@arcadialdev/arcality 4.1.4 → 4.1.5

package/package.json

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

package/playwright.config.js

@@ -1,56 +1,56 @@
-// playwright.config.js
-'use strict';
-const { defineConfig, devices } = require('@playwright/test');
-const os = require('os');
-const path = require('path');
-
-// ── Dynamic reporter: JUnit is added when running in CI (Azure DevOps, GitHub Actions) ──
-// The JUnit XML file enables native test result publishing in your pipeline dashboard.
-// In local/interactive mode, the JUnit reporter is skipped — only Arcality's HTML reporter runs.
-const reportsDir = process.env.REPORTS_DIR || path.join(os.tmpdir(), 'arcality', 'reports');
-const playwrightOutputDir = process.env.PLAYWRIGHT_OUTPUT_DIR || path.join(os.tmpdir(), 'arcality', 'playwright-output');
-const isCI = process.env.CI === 'true';
-
-const reporters = [
-    ['line'],
-    [path.join(__dirname, 'tests', '_helpers', 'ArcalityReporter.js'), { outputDir: reportsDir }],
-];
-
-if (isCI) {
-    reporters.push(['junit', { outputFile: path.join(reportsDir, 'results.xml') }]);
-}
-
-module.exports = defineConfig({
-  testDir: path.join(__dirname, 'tests', '_helpers'),
-  testMatch: ['agentic-runner.bundle.spec.js'],
-  reporter: reporters,
-  outputDir: playwrightOutputDir,
-  use: {
-    // ── Dynamic BASE_URL ──
-    // Priority: CLI --base-url flag → arcality.config baseUrl → BASE_URL env → default
-    // This allows pipelines to inject the target environment dynamically:
-    //   arcality --run-all --base-url=https://staging.myapp.com
-    baseURL: process.env.BASE_URL || 'http://localhost:3000',
-    video: 'retain-on-failure',
-    screenshot: 'only-on-failure',
-    trace: 'retain-on-failure',
-    colorScheme: 'dark',
-    // In CI: headless is enforced by Playwright automatically when CI=true
-    headless: isCI ? true : undefined,
-    contextOptions: {
-      reducedMotion: 'reduce',
-    },
-  },
-  projects: [
-    {
-      name: 'AgenticBrowser',
-      use: {
-        ...devices['Desktop Chrome'],
-        channel: 'chrome',
-        viewport: { width: 1440, height: 900 },
-        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 ArcalityAgent/1.0',
-      },
-    },
-  ],
-});
-
+// playwright.config.js
+'use strict';
+const { defineConfig, devices } = require('@playwright/test');
+const os = require('os');
+const path = require('path');
+
+// ── Dynamic reporter: JUnit is added when running in CI (Azure DevOps, GitHub Actions) ──
+// The JUnit XML file enables native test result publishing in your pipeline dashboard.
+// In local/interactive mode, the JUnit reporter is skipped — only Arcality's HTML reporter runs.
+const reportsDir = process.env.REPORTS_DIR || path.join(os.tmpdir(), 'arcality', 'reports');
+const playwrightOutputDir = process.env.PLAYWRIGHT_OUTPUT_DIR || path.join(os.tmpdir(), 'arcality', 'playwright-output');
+const isCI = process.env.CI === 'true';
+
+const reporters = [
+    ['line'],
+    [path.join(__dirname, 'tests', '_helpers', 'ArcalityReporter.js'), { outputDir: reportsDir }],
+];
+
+if (isCI) {
+    reporters.push(['junit', { outputFile: path.join(reportsDir, 'results.xml') }]);
+}
+
+module.exports = defineConfig({
+  testDir: path.join(__dirname, 'tests', '_helpers'),
+  testMatch: ['agentic-runner.bundle.spec.js'],
+  reporter: reporters,
+  outputDir: playwrightOutputDir,
+  use: {
+    // ── Dynamic BASE_URL ──
+    // Priority: CLI --base-url flag → arcality.config baseUrl → BASE_URL env → default
+    // This allows pipelines to inject the target environment dynamically:
+    //   arcality --run-all --base-url=https://staging.myapp.com
+    baseURL: process.env.BASE_URL || 'http://localhost:3000',
+    video: 'on',
+    screenshot: 'only-on-failure',
+    trace: 'retain-on-failure',
+    colorScheme: 'dark',
+    // In CI: headless is enforced by Playwright automatically when CI=true
+    headless: isCI ? true : undefined,
+    contextOptions: {
+      reducedMotion: 'reduce',
+    },
+  },
+  projects: [
+    {
+      name: 'AgenticBrowser',
+      use: {
+        ...devices['Desktop Chrome'],
+        channel: 'chrome',
+        viewport: { width: 1440, height: 900 },
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 ArcalityAgent/1.0',
+      },
+    },
+  ],
+});
+

package/src/arcalityClient.mjs

@@ -1,10 +1,10 @@
 // src/arcalityClient.mjs
 // Client for communicating with Arcality Backend
-// Supports arcality.config (primary) and .env (fallback)
-import fs from 'node:fs';
-import path from 'node:path';
-import { getApiKey, getApiUrl, CONFIG_DIR } from './configLoader.mjs';
-import { isRealProjectId } from './configManager.mjs';
+// Supports arcality.config (primary) and .env (fallback)
+import fs from 'node:fs';
+import path from 'node:path';
+import { getApiKey, getApiUrl, CONFIG_DIR } from './configLoader.mjs';
+import { isRealProjectId } from './configManager.mjs';
 
 // ── Backend config (internal, not user-configurable) ──
 const DAILY_MISSION_LIMIT = 35;
@@ -97,11 +97,11 @@ function getEffectiveApiKey() {
  * Gets the effective Project ID.
  * Priority: arcality.config > ARCALITY_PROJECT_ID env var
  */
-function loadProjectId() {
-    const localConfig = loadArcalityConfig();
-    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID || null;
-    return isRealProjectId(projectId) ? projectId : null;
-}
+function loadProjectId() {
+    const localConfig = loadArcalityConfig();
+    const projectId = localConfig?.projectId || process.env.ARCALITY_PROJECT_ID || null;
+    return isRealProjectId(projectId) ? projectId : null;
+}
 
 // ═══════════════════════════════════════════════════════
 // PUBLIC API
@@ -126,11 +126,11 @@ export async function validateApiKey() {
     const key = getEffectiveApiKey();
 
     if (!key) {
-        return { valid: false, error: 'no_api_key', mode: 'live' };
+        return { valid: false, error: 'no_api_key', mode: 'live' };
     }
 
     if (!key.startsWith('arc_')) {
-        return { valid: false, error: 'invalid_format', mode: 'live' };
+        return { valid: false, error: 'invalid_format', mode: 'live' };
     }
 
     const apiBase = getEffectiveApiBase();
@@ -162,12 +162,12 @@ export async function validateApiKey() {
             return { ...data, valid: true, mode: 'live' };
         } catch (e) {
             const reason = e?.name === 'AbortError' ? 'timeout (5s)' : (e?.message || 'unknown');
-            console.warn(`Backend not available (${apiBase}): ${reason}.`);
-            return { valid: false, error: 'backend_unavailable', mode: 'live', reason };
+            console.warn(`Backend not available (${apiBase}): ${reason}.`);
+            return { valid: false, error: 'backend_unavailable', mode: 'live', reason };
         }
     }
 
-    return { valid: false, error: 'backend_unavailable', mode: 'live' };
+    return { valid: false, error: 'backend_unavailable', mode: 'live' };
 }
 
 /**
@@ -184,10 +184,10 @@ export async function startMission(prompt, targetUrl) {
     // ── LIVE mode ──
     if (apiBase) {
         try {
-            const projectId = process.env.ARCALITY_PROJECT_ID || loadArcalityConfig()?.projectId;
-            if (!isRealProjectId(projectId)) {
-                return { allowed: false, error: 'no_project_id' };
-            }
+            const projectId = process.env.ARCALITY_PROJECT_ID || loadArcalityConfig()?.projectId;
+            if (!isRealProjectId(projectId)) {
+                return { allowed: false, error: 'no_project_id' };
+            }
 
             const controller = new AbortController();
             const timeout = setTimeout(() => controller.abort(), 5000);
@@ -216,13 +216,13 @@ export async function startMission(prompt, targetUrl) {
             return { allowed: true, ...(await res.json()) };
         } catch (e) {
             const reason = e?.name === 'AbortError' ? 'timeout (5s)' : (e?.message || 'unknown');
-            console.warn(`startMission failed (${apiBase}): ${reason}.`);
-            return { allowed: false, error: 'backend_unavailable', reason };
+            console.warn(`startMission failed (${apiBase}): ${reason}.`);
+            return { allowed: false, error: 'backend_unavailable', reason };
         }
     }
 
-    return { allowed: false, error: 'backend_unavailable' };
-}
+    return { allowed: false, error: 'backend_unavailable' };
+}
 
 /**
  * Fetches missions from the backend API.
@@ -234,10 +234,10 @@ export async function fetchMissions(projectId, tags) {
     const key = getEffectiveApiKey();
     if (!key) return { success: false, error: 'no_api_key', missions: [] };
 
-    const apiBase = getEffectiveApiBase();
-    if (!apiBase) {
-        return { success: false, error: 'backend_unavailable', missions: [] };
-    }
+    const apiBase = getEffectiveApiBase();
+    if (!apiBase) {
+        return { success: false, error: 'backend_unavailable', missions: [] };
+    }
 
     try {
         const url = new URL(`${apiBase}/api/v1/projects/${projectId}/missions`);
@@ -277,10 +277,10 @@ export async function fetchMissions(projectId, tags) {
  * @param {'success'|'failed'|'cancelled'} result
  * @param {object} usage - Optional usage statistics directly from the AI
  */
-export async function endMission(missionId, result, usage = null, failReason = null, reportUrl = null, failReasoning = null) {
-    const apiBase = getEffectiveApiBase();
-    if (!apiBase) return { ok: false, error: 'backend_unavailable' };
-    if (!missionId) return { ok: false, error: 'no_mission_id' };
+export async function endMission(missionId, result, usage = null, failReason = null, reportUrl = null, failReasoning = null) {
+    const apiBase = getEffectiveApiBase();
+    if (!apiBase) return { ok: false, error: 'backend_unavailable' };
+    if (!missionId) return { ok: false, error: 'no_mission_id' };
 
     const key = getEffectiveApiKey();
     try {
@@ -306,16 +306,19 @@ function simpleHash(str) {
         hash = ((hash << 5) - hash) + char;
         hash |= 0;
     }
-    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)) || '';
-}
-
-/**
+    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]',
+        '[Interaction Blocked]', '[Validation Error]'
+    ];
+    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.
@@ -324,7 +327,7 @@ function normalizeBugClassification(value) {
  * @param {string} description - Descripción detallada del bug detectado
  * @returns {Promise<{success: boolean, taskUrl?: string, error?: string}>}
  */
-export async function createAdoTask(title, description, metadata = {}) {
+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.`);
@@ -332,7 +335,7 @@ export async function createAdoTask(title, description, metadata = {}) {
     }
 
     const projectId = loadProjectId();
-    if (!isRealProjectId(projectId)) {
+    if (!isRealProjectId(projectId)) {
         if (process.env.DEBUG) console.log(`[ADO] No hay Project ID configurado. Omitiendo creación de Task en Azure DevOps.`);
         return { success: false, error: 'no_project_id' };
     }
@@ -343,26 +346,26 @@ export async function createAdoTask(title, description, metadata = {}) {
         return { success: false, error: 'no_api_key' };
     }
 
-    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
-        });
+    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) {
@@ -398,7 +401,7 @@ export async function createAdoTask(title, description, metadata = {}) {
  */
 export async function getEvidenceSasToken(missionId, projectId) {
     const apiBase = getEffectiveApiBase();
-    if (!apiBase || !missionId || !isRealProjectId(projectId)) return null;
+    if (!apiBase || !missionId || !isRealProjectId(projectId)) return null;
 
     const key = getEffectiveApiKey();
     if (!key) return null;