@arcadialdev/arcality 2.4.32 → 2.4.34

package/README.md

@@ -55,6 +55,20 @@ npm run arcality:run
 
 ---
 
+## 💻 CLI Commands Cheatsheet
+
+The Arcality flow is designed to be used globally or project-wide via \`npx\`. Below are all currently supported commands:
+
+| 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 Arcality Cloud. | Prompts for your API Key and Project ID, generates \`arcality.config.json\`, and validates the ADO / Portal connection. |
+| \`npx arcality setup\` | **Dependency Setup**<br/>Downloads browser binaries. | Silently executes the installation of internal Playwright browsers (Chromium) ensuring the local machine can run tests. |
+| \`npx arcality run\` | **Mission Runner (Agent Mode)**<br/>Launches the QA Agent directly. | Skips the interactive menu, scans the _package.json_ ("Ghost Mode"), injects ephemeral _autoskills_, 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, token consumption, and success status. |
+
+---
+
 ## 🛠️ Internal Architecture
 
 Arcality operates on a highly decoupled modular system designed for maximum resilience:

package/bin/arcality.mjs

@@ -14,15 +14,24 @@ const rawArgs = process.argv.slice(2);
 let isRun = false;
 let isInit = false;
 let isSetup = false;
+let isLogs = false;
 
 // 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 (isInit) {
+if (isLogs) {
+    const logsScript = path.join(PACKAGE_ROOT, 'scripts', 'arcality-logs.mjs');
+    spawn('node', [logsScript], {
+        stdio: 'inherit',
+        cwd: process.cwd(),
+        env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }
+    }).on('exit', code => process.exit(code || 0));
+} else if (isInit) {
     const initScript = path.join(PACKAGE_ROOT, 'scripts', 'init.mjs');
     spawn('node', [initScript, ...rawArgs.filter(a => a !== 'init')], {
         stdio: 'inherit',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadialdev/arcality",
-  "version": "2.4.32",
+  "version": "2.4.34",
   "description": "AI-powered QA testing tool — Autonomous web testing agent by Arcadial",
   "main": "index.js",
   "scripts": {

package/playwright.config.js

@@ -7,6 +7,7 @@ module.exports = defineConfig({
   testDir: path.join(__dirname, 'tests', '_helpers'),
   testMatch: ['agentic-runner.bundle.spec.js'],
   reporter: [
+    ['line'],
     [path.join(__dirname, 'tests', '_helpers', 'ArcalityReporter.js'),
      { outputDir: process.env.REPORTS_DIR || path.join(__dirname, 'tests-report') }]
   ],

package/scripts/arcality-logs.mjs

@@ -0,0 +1,76 @@
+#!/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 contextDir = path.join(process.cwd(), "out");
+const centralLog = path.join(contextDir, "arcality-history.log");
+
+console.log(chalk.cyan(`\n🔍 Arcality Logs Viewer`));
+console.log(chalk.gray(`=========================\n`));
+
+if (!fs.existsSync(centralLog)) {
+    console.log(chalk.yellow(`No se encontró un historial de logs en este proyecto.`));
+    console.log(chalk.gray(`(Directorio actual: ${contextDir})\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);
+}

package/src/services/autoskillsService.ts

@@ -0,0 +1,61 @@
+import fs from 'fs';
+import path from 'path';
+
+// Mapeo curado de tecnologías clave a sus skills de pruebas/qa/patrones de autoskills.sh
+// Son recursos muy ligeros en formato Markdown
+const SKILLS_MAP: Record<string, string> = {
+    'next': 'https://skills.sh/vercel-labs/next-skills/next-best-practices/raw',
+    'vue': 'https://skills.sh/antfu/skills/vue-best-practices/raw',
+    'tailwindcss': 'https://skills.sh/giuseppe-trisciuoglio/developer-kit/tailwind-css-patterns/raw',
+    'react': 'https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices/raw',
+    'angular': 'https://skills.sh/angular/skills/angular-developer/raw',
+    'nuxt': 'https://skills.sh/antfu/skills/nuxt/raw',
+    'svelte': 'https://skills.sh/ejirocodes/agent-skills/svelte5-best-practices/raw',
+    'astro': 'https://skills.sh/astrolicious/agent-skills/astro/raw',
+    'prisma': 'https://skills.sh/prisma/skills/prisma-postgres/raw'
+};
+
+export async function detectAndFetchEphemeralSkills(projectRoot: string): Promise<string> {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(pkgPath)) return '';
+
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+        
+        const matchedUrls: string[] = [];
+        const matchedTechs: string[] = [];
+
+        for (const [lib, url] of Object.entries(SKILLS_MAP)) {
+            // Buscamos coincidencia parcial (ej. si usan @angular/core, next, react-dom)
+            const hasLib = Object.keys(deps).some(dep => dep === lib || dep.includes(`/${lib}`));
+            if (hasLib) {
+                 matchedUrls.push(url);
+                 matchedTechs.push(lib);
+            }
+        }
+
+        if (matchedUrls.length === 0) return '';
+
+        console.log(`>>ARCALITY_STATUS>> ⚡ Stack detectado (${matchedTechs.join(', ')}). QA Skills inyectadas en memoria.`);
+
+        // Fetch strings in parallel with simple timeout
+        const skillsPromises = matchedUrls.map(url => {
+            const controller = new AbortController();
+            const id = setTimeout(() => controller.abort(), 2000); // Max 2s per request
+            return fetch(url, { signal: controller.signal })
+                .then(r => r.ok ? r.text() : '')
+                .catch(() => '')
+                .finally(() => clearTimeout(id));
+        });
+
+        const skillsTexts = await Promise.all(skillsPromises);
+        
+        const validTexts = skillsTexts.filter(Boolean);
+        if (validTexts.length === 0) return '';
+
+        return `\n<TECH_STACK_CONTEXT>\nEl proyecto objetivo utiliza las siguientes tecnologías. Usa estas directrices técnicas para entender el DOM, rutas y posibles bugs visuales:\n\n${validTexts.join('\n\n---\n\n')}\n</TECH_STACK_CONTEXT>\n`;
+    } catch {
+       return ''; // Fails silently
+    }
+}

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

@@ -1375,6 +1375,14 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
     } catch (e) {
       console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Error en hook de contexto: ${e.message}`);
     }
+    let autoskillsContext = "";
+    try {
+      const path3 = require("path");
+      const toolsRoot = process.env.ARCALITY_ROOT || path3.join(__dirname, "..", "..");
+      const { detectAndFetchEphemeralSkills } = require(path3.join(toolsRoot, "src", "services", "autoskillsService"));
+      autoskillsContext = await detectAndFetchEphemeralSkills(process.cwd());
+    } catch (e) {
+    }
     const systemPromptBlocks = [
       {
         type: "text",
@@ -1386,6 +1394,7 @@ ${prompt}
 
 ${projectInfo}
 ${skillsContext}
+${autoskillsContext}
 ${memoryContext}
 ${credentialsContext}
 ${memoryBackendContext}`
@@ -2476,23 +2485,28 @@ function captureValidationRule(errorMessage, context) {
           }
         }
       }
+      const effectiveLocalSteps = stepsData.length > 0 ? stepsData : stepsDataBackup;
       const missionData = {
         prompt,
         steps: history,
-        steps_data: stepsData,
+        steps_data: effectiveLocalSteps,
         success: finalSuccess,
         error: hasCriticalError,
         timestamp: Date.now()
       };
       memories.push(missionData);
       fs2.writeFileSync(memoryFile, JSON.stringify(memories, null, 2));
-      console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria guardada: ${stepsData.length} pasos nuevos`);
+      console.log(`>>ARCALITY_STATUS>> \u{1F9E0} Memoria guardada: ${effectiveLocalSteps.length} pasos nuevos`);
     } catch (err) {
       console.error("\u274C Fall\xF3 al guardar memoria:", err);
     }
     try {
       const logPath = path2.join(contextDir, `agent-log-${Date.now()}.json`);
-      fs2.writeFileSync(logPath, JSON.stringify({ prompt, history, steps: stepCount, success: finalSuccess, error: hasCriticalError, usage: totalMissionUsage }, null, 2));
+      fs2.writeFileSync(logPath, JSON.stringify({ prompt, history, steps: stepCount, success: finalSuccess, error: hasCriticalError, usage: totalMissionUsage, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
+      try {
+        fs2.appendFileSync(path2.join(contextDir, "arcality-history.log"), JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), mission: prompt.substring(0, 150), success: finalSuccess, steps: stepCount, usage: totalMissionUsage }) + "\n");
+      } catch (e) {
+      }
     } catch (err) {
     }
   };
@@ -2513,7 +2527,12 @@ function captureValidationRule(errorMessage, context) {
       console.warn(`[CollectiveMemory] \u26A0\uFE0F stepsData vac\xEDo en path de \xE9xito \u2014 intentando usar backup...`);
     }
     const effectiveSteps = stepsData.length > 0 ? stepsData : stepsDataBackup;
-    console.log(`\u{1F9E0} [COLLECTIVE MEMORY] Persistiendo conocimiento (project: ${pid}, steps: ${effectiveSteps.length}, isFailed: ${isFailed})...`);
+    console.log(`
+======================================================`);
+    console.log(`\u{1F9E0} [MEMORIA COLECTIVA - INGESTA DE APRENDIZAJE]`);
+    console.log(`>>arcality>> Persistiendo conocimiento (project: ${pid}, steps: ${effectiveSteps.length}, isFailed: ${isFailed})...`);
+    console.log(`======================================================
+`);
     try {
       const stepsNarrative = effectiveSteps.map((s) => `${s.action_data?.action || "action"} "${s.componentName}" en ${s.url}`).join(" \u2192 ").substring(0, 500);
       if (!isFailed) {
@@ -2703,7 +2722,12 @@ function captureValidationRule(errorMessage, context) {
         response = null;
       } else {
         guideStepCount++;
-        console.log(`>>ARCALITY_STATUS>> \u2728 Gu\xEDa de \xE9xito: Paso validado (Gu\xEDa #${guideStepCount}, NO consume turno IA)`);
+        console.log(`
+======================================================`);
+        console.log(`\u{1F680} [USANDO GU\xCDA DE \xC9XITO - MEMORIA COLECTIVA AHORRANDO TOKENS]`);
+        console.log(`>>arcality>> Paso validado (Gu\xEDa #${guideStepCount}, NO consume turno IA)`);
+        console.log(`======================================================
+`);
       }
     }
     if (!response) {
@@ -2733,7 +2757,12 @@ function captureValidationRule(errorMessage, context) {
         }
       }
     }
-    console.log(`\u{1F9E0} Pensamiento: ${response.thought}`);
+    console.log(`
+======================================================`);
+    console.log(`\u{1F916} [RAZONAMIENTO DEL AGENTE]`);
+    console.log(`${response.thought}`);
+    console.log(`======================================================
+`);
     if (!response.finish && history.length >= 6) {
       const lastSixActions = history.slice(-6);
       const clickActions = lastSixActions.filter((h) => h.includes("click en"));