@arcadialdev/arcality 3.0.2 → 3.0.3

package/README.md

@@ -66,12 +66,18 @@ The Arcality flow is designed to be used globally or project-wide via `npx`. Bel
 | Command | Description | Internal Behavior |
 | :--- | :--- | :--- |
 | `npx arcality` | **Interactive Menu**<br/>Launches a visual menu in the terminal to guide the user. | Prompts for the Mission to execute. Ideal for new users who want a guided experience. |
-| `npx arcality init` | **Initial Configuration**<br/>Connects the current project to Arcadial. | Prompts for your API Key and Project ID, generates `arcality.config.json`, and validates the portal connection. |
-| `npx arcality run` | **Mission Runner (Agent Mode)**<br/>Launches the QA Agent directly. | Skips the interactive menu, scans the _package.json_ ("Ghost Mode"), and unleashes the AI agent. Ideal for CI/CD. |
-| `npx arcality --logs` | **History Viewer**<br/>Displays test performance and tokens spent. | Reads the local `arcality-history.log` and renders a colorful table listing each mission and success status. |
-
-
----
+| `npx arcality init` | **Initial Configuration**<br/>Connects the current project to Arcadial. | Prompts for your API Key and Project ID, generates `arcality.config.json`, and validates the portal connection. |
+| `npx arcality run` | **Mission Runner (Agent Mode)**<br/>Launches the QA Agent directly. | Skips the interactive menu, scans the _package.json_ ("Ghost Mode"), and unleashes the AI agent. Ideal for CI/CD. |
+| `npx arcality logs` | **Mission Logs**<br/>Shows the last 3 executed missions in a concise QA-friendly format. | Reads the local `.arcality/out` mission summaries and displays result, failure reason, last relevant steps, and report path. |
+
+### Parallel collection execution
+
+When running a saved collection from the interactive CLI, Arcality can execute multiple missions at the same time. The default is `3` simultaneous missions and the maximum allowed value is `5`.
+
+Parallel execution opens multiple independent browser sessions. Arcality cannot validate the tested portal's internal session rules, user lock policies, shared test data constraints, or limits for multiple logins with the same account. If the portal does not support parallel sessions safely, run the collection sequentially with concurrency `1`.
+
+
+---
 
 ## 🛠️ Internal Architecture
 

package/bin/arcality.mjs

@@ -19,16 +19,17 @@ let isRunAll = false; // CI/CD mode: runs all missions from API headlessly
 
 // Buscamos los comandos en cualquier posición para evitar filtros de NPM en Windows
 rawArgs.forEach(arg => {
-    if (arg === 'run') isRun = true;
-    if (arg === 'init') isInit = true;
-    if (arg === 'setup') isSetup = true;
-    if (arg === '--logs') isLogs = true;
-    if (arg === '--run-all') isRunAll = true;
-});
+    if (arg === 'run') isRun = true;
+    if (arg === 'init') isInit = true;
+    if (arg === 'setup') isSetup = true;
+    if (arg === 'logs') isLogs = true;
+    if (arg === '--logs') isLogs = true;
+    if (arg === '--run-all') isRunAll = true;
+});
 
 if (isLogs) {
-    const logsScript = path.join(PACKAGE_ROOT, 'scripts', 'arcality-logs.mjs');
-    spawn('node', [logsScript], {
+    const logsScript = path.join(PACKAGE_ROOT, 'scripts', 'arcality-logs.mjs');
+    spawn('node', [logsScript, ...rawArgs.filter(a => a !== 'logs' && a !== '--logs')], {
         stdio: 'inherit',
         cwd: process.cwd(),
         env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }

package/package.json

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

package/playwright.config.js

@@ -6,23 +6,25 @@ 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(__dirname, 'tests-report');
-const isCI = process.env.CI === 'true';
+const reportsDir = process.env.REPORTS_DIR || path.join(__dirname, 'tests-report');
+const playwrightOutputDir = process.env.PLAYWRIGHT_OUTPUT_DIR || path.join(reportsDir, '..', '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') }]);
+}
 
-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,
-  use: {
+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:

package/scripts/arcality-logs.mjs

@@ -1,93 +1,167 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import chalk from "chalk";
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const PROJECT_ROOT = process.env.ARCALITY_ROOT || path.join(__dirname, "..");
-
-const rootOutDir = path.join(process.cwd(), ".arcality", "out");
-
-// Buscar el archivo arcality-history.log recursivamente (o tomar el más reciente si hay varios reportes)
-let centralLog = null;
-const findLogRecursively = (dir) => {
-    if (!fs.existsSync(dir)) return;
-    const files = fs.readdirSync(dir);
-    for (const file of files) {
-        const fullPath = path.join(dir, file);
-        if (fs.statSync(fullPath).isDirectory()) {
-            findLogRecursively(fullPath);
-        } else if (file === "arcality-history.log") {
-            // Guardamos el primero que encontremos, asumiendo que es el contexto activo
-            if (!centralLog) centralLog = fullPath;
-        }
-    }
-};
-
-findLogRecursively(rootOutDir);
-
-console.log(chalk.cyan(`\n🔍 Arcality Logs Viewer`));
-console.log(chalk.gray(`=========================\n`));
-
-if (!centralLog || !fs.existsSync(centralLog)) {
-    console.log(chalk.yellow(`No se encontró un historial de logs en este proyecto.`));
-    console.log(chalk.gray(`(Directorio buscado: ${rootOutDir})\n`));
-    console.log(`Ejecuta algunas misiones de prueba primero usando el comando arcality.\n`);
-    process.exit(0);
-}
-
-try {
-    const rawData = fs.readFileSync(centralLog, 'utf8');
-    const lines = rawData.split('\n').filter(l => l.trim().length > 0);
-    
-    if (lines.length === 0) {
-        console.log(chalk.yellow(`El archivo de historial de misiones está vacío.\n`));
-        process.exit(0);
-    }
-
-    console.log(chalk.bold(`Registros encontrados: `) + chalk.cyan(lines.length));
-    console.log(chalk.gray(`Mostrando los últimos 20 resultados:`));
-    console.log();
-
-    const recentLines = lines.slice(-20);
-    let totalInput = 0;
-    let totalOutput = 0;
-    
-    recentLines.forEach((line, index) => {
-        try {
-            const data = JSON.parse(line);
-            
-            // Icono según resultado
-            const statusIcon = data.success ? chalk.green('✅') : chalk.red('❌');
-            
-            // Fecha bonita
-            const date = new Date(data.ts).toLocaleString();
-            
-            // Contabilizar tokens
-            const inT = data.usage?.input_tokens || 0;
-            const caT = data.usage?.cache_creation_input_tokens || 0;
-            const crT = data.usage?.cache_read_input_tokens || 0;
-            const totalIn = inT + caT + crT;
-            const totalOut = data.usage?.output_tokens || 0;
-            
-            totalInput += totalIn;
-            totalOutput += totalOut;
-            
-            const costStr = chalk.yellow(`[IN: ${totalIn} | OUT: ${totalOut}]`);
-            const targetStr = data.target ? chalk.gray(` @ ${data.target}`) : '';
-            
-            console.log(`${statusIcon} ${chalk.blue(date)} ${costStr}`);
-            console.log(`   ${chalk.white(data.mission)}${targetStr}`);
-            console.log(`   ${chalk.gray(`Pasos dados: ${data.steps}`)}\n`);
-        } catch (e) {
-            console.log(chalk.red(`⚠️ Error parseando línea: ${line.substring(0, 50)}...\n`));
-        }
-    });
-
-    console.log(chalk.gray(`--------------------------------------------------\n`));
-    
-} catch (err) {
-    console.error(chalk.red(`❌ Ocurrió un error al leer los logs:`), err.message);
-}
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+
+const MAX_RUNS = 3;
+const rootOutDir = path.join(process.cwd(), ".arcality", "out");
+
+function walk(dir, results = []) {
+    if (!fs.existsSync(dir)) return results;
+
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walk(fullPath, results);
+            continue;
+        }
+
+        if (
+            /^mission-log-\d+\.json$/.test(entry.name) ||
+            /^agent-log-\d+\.json$/.test(entry.name) ||
+            entry.name === "mission-result.json"
+        ) {
+            results.push(fullPath);
+        }
+    }
+
+    return results;
+}
+
+function readRun(file) {
+    try {
+        const data = JSON.parse(fs.readFileSync(file, "utf8"));
+        const stat = fs.statSync(file);
+        const parsedTime = Number.isFinite(Number(data.timestamp))
+            ? Number(data.timestamp)
+            : Date.parse(data.timestamp || data.ts || "");
+
+        return {
+            file,
+            data,
+            time: Number.isFinite(parsedTime) ? parsedTime : stat.mtimeMs,
+        };
+    } catch {
+        return null;
+    }
+}
+
+function oneLine(value) {
+    return String(value || "").replace(/\s+/g, " ").trim();
+}
+
+function truncate(value, max = 180) {
+    const text = oneLine(value);
+    return text.length > max ? `${text.slice(0, max - 3)}...` : text;
+}
+
+function formatDate(time) {
+    return new Date(time).toLocaleString("es-MX", {
+        dateStyle: "short",
+        timeStyle: "short",
+    });
+}
+
+function formatReason(reason) {
+    const reasons = {
+        max_steps_reached: "Se alcanzo el limite de pasos configurado.",
+        unknown_failure: "La mision termino sin una confirmacion clara de exito.",
+        timeout_or_crash: "La ejecucion se detuvo o el navegador fallo.",
+        user_canceled: "La mision fue cancelada por el usuario.",
+        missing_mission_log: "No se encontro el resumen tecnico de la mision.",
+    };
+
+    return reasons[reason] || reason || "Sin motivo registrado.";
+}
+
+function getHistory(data) {
+    if (Array.isArray(data.history)) return data.history;
+    if (Array.isArray(data.steps)) return data.steps;
+    return [];
+}
+
+function cleanStep(step) {
+    return oneLine(step)
+        .replace(/^>>ARCALITY_STATUS>>\s*/i, "")
+        .replace(/^Turno\s+\d+:\s*/i, "")
+        .replace(/^Paso\s+\d+:\s*/i, "");
+}
+
+function reportPathFor(data) {
+    const reportDir = data.report_dir || data.reportPath || data.reportsDir || "";
+    if (!reportDir) return "";
+
+    const indexPath = path.join(reportDir, "index.html");
+    return fs.existsSync(indexPath) ? indexPath : reportDir;
+}
+
+const files = walk(rootOutDir);
+const runs = files
+    .map(readRun)
+    .filter(Boolean)
+    .sort((a, b) => b.time - a.time);
+
+const uniqueRuns = [];
+const seen = new Set();
+for (const run of runs) {
+    const key = `${run.data.timestamp || run.time}:${run.data.prompt || run.data.mission || ""}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    uniqueRuns.push(run);
+    if (uniqueRuns.length >= MAX_RUNS) break;
+}
+
+console.log(chalk.cyan("\nArcality Logs"));
+console.log(chalk.gray("=============\n"));
+
+if (uniqueRuns.length === 0) {
+    console.log(chalk.yellow("No se encontraron misiones recientes en este proyecto."));
+    console.log(chalk.gray(`Directorio revisado: ${rootOutDir}`));
+    console.log("Ejecuta una mision con arcality run y vuelve a consultar arcality logs.\n");
+    process.exit(0);
+}
+
+console.log(chalk.gray(`Mostrando las ultimas ${uniqueRuns.length} misiones ejecutadas.\n`));
+
+uniqueRuns.forEach((run, index) => {
+    const { data, time } = run;
+    const success = data.success === true;
+    const status = success ? chalk.green("EXITOSA") : chalk.red("FALLIDA");
+    const mission = data.prompt || data.mission || "Mision sin nombre";
+    const targetParts = [data.target, data.target_path].filter(Boolean);
+    const target = targetParts.length > 0 ? targetParts.join("") : "";
+    const stepsCount = Number.isFinite(Number(data.steps)) ? Number(data.steps) : getHistory(data).length;
+    const reportPath = reportPathFor(data);
+    const history = getHistory(data)
+        .map(cleanStep)
+        .filter(Boolean)
+        .filter(step => !/uso total de tokens|memoria guardada|patternsearch/i.test(step));
+
+    console.log(chalk.bold(`${index + 1}. ${status}`) + chalk.gray(`  ${formatDate(time)}`));
+    console.log(`   Mision: ${chalk.white(truncate(mission, 220))}`);
+    if (target) console.log(`   Inicio: ${chalk.gray(truncate(target, 180))}`);
+    console.log(`   Pasos: ${chalk.cyan(String(stepsCount || 0))}`);
+
+    if (!success) {
+        console.log(`   Motivo: ${chalk.yellow(truncate(formatReason(data.fail_reason), 220))}`);
+        if (data.fail_reasoning) {
+            console.log(`   Analisis: ${chalk.yellow(truncate(data.fail_reasoning, 260))}`);
+        }
+    }
+
+    const recentSteps = history.slice(-5);
+    if (recentSteps.length > 0) {
+        console.log("   Ultimos pasos:");
+        for (const step of recentSteps) {
+            console.log(`     - ${truncate(step, 180)}`);
+        }
+    } else {
+        console.log(`   Ultimos pasos: ${chalk.gray("No hay pasos detallados disponibles.")}`);
+    }
+
+    if (reportPath) {
+        console.log(`   Reporte: ${chalk.gray(reportPath)}`);
+    }
+
+    console.log("");
+});