@arcadialdev/arcality 2.2.3 → 2.2.5

package/README.md

@@ -23,33 +23,34 @@
 
 ## 🚀 Getting Started
 
-### 1. Installation
-Install the CLI tool globally or as a dev dependency via NPM:
-```bash
-# Using npm
-npm install -g @arcadialdev/arcality
+### 1. Install in your project
 
-# Or use npx directly without installing
-npx @arcadialdev/arcality init
+```bash
+npm install @arcadialdev/arcality
 ```
 
-### 2. Initialization
-Run the setup wizard at the root of your frontend or backend repository (e.g., Next.js, Vite). Arcality will auto-detect your framework and scaffold the necessary configurations.
+> After install, Arcality **automatically adds the following scripts** to your `package.json`:
+> ```json
+> "arcality":       "arcality run",
+> "arcality:init":  "arcality init",
+> "arcality:run":   "arcality run"
+> ```
+
+### 2. Initialize your project
+Run the setup wizard at the root of your project. Arcality will auto-detect your framework and scaffold the `arcality.config.json`.
 
 ```bash
-arcality init
+npm run arcality:init
 ```
-*This command creates the `arcality.config.json` inside your project and connects you to the internal Arcadial AI Proxy.*
 
-### 3. Running an Agent Mission
-Start an autonomous mission by feeding the agent a natural language prompt.
+### 3. Run an autonomous mission
 
 ```bash
-# Interactive GUI Mode
-arcality run
+# Interactive menu
+npm run arcality
 
-# CI/CD / Headless Mode
-arcality run --agent "Login with test credentials, navigate to Dashboard, and ensure the Welcome widget is visible."
+# Direct mission
+npm run arcality:run
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadialdev/arcality",
-  "version": "2.2.3",
+  "version": "2.2.5",
   "description": "AI-powered QA testing tool — Autonomous web testing agent by Arcadial",
   "main": "index.js",
   "scripts": {
@@ -18,6 +18,7 @@
     "src/",
     "tests/_helpers/",
     ".agents/",
+    "public/",
     "playwright.config.ts",
     "README.md"
   ],

package/scripts/gen-and-run.mjs

@@ -711,8 +711,15 @@ async function main() {
                 console.log(chalk.gray(`\n>> ARCALITY_PROJECT_ID: ${finalProjectId}`));
             }
 
+            // Always use Arcality's own Playwright to avoid version conflicts with user's project
+            const playwrightBin = process.platform === 'win32'
+                ? path.join(PROJECT_ROOT, 'node_modules', '.bin', 'playwright.cmd')
+                : path.join(PROJECT_ROOT, 'node_modules', '.bin', 'playwright');
+
+            const configFile = path.join(PROJECT_ROOT, 'playwright.config.ts');
+
             try {
-                await run("npx", ["playwright", "test", "tests/_helpers/agentic-runner.spec.ts", "--headed"], {
+                await run(playwrightBin, ["test", "tests/_helpers/agentic-runner.spec.ts", "--headed", `--config=${configFile}`], {
                     env: mergedEnv,
                     onStatus: (msg) => s.message(msg)
                 });
@@ -783,7 +790,7 @@ async function main() {
                 await run("node", ["scripts/rebrand-report.mjs"]).catch(() => { });
 
                 const reportDir = process.env.REPORTS_DIR || 'tests-report';
-                const arcalityPath = path.resolve(PROJECT_ROOT, reportDir, 'index.html');
+                const arcalityPath = path.resolve(reportDir, 'index.html');
 
                 if (globalReportProcess) {
                     try {

package/scripts/postinstall.mjs

@@ -1,63 +1,77 @@
-#!/usr/bin/env node
-// scripts/postinstall.mjs — Post-install hook
-// Se ejecuta automáticamente después de 'npm install -g @arcadial/arcality'
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-
-const CONFIG_DIR = path.join(os.homedir(), '.arcality');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
-
-// Leer versión del package.json
-let version = 'unknown';
-try {
-    const pkgPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    version = pkg.version || 'unknown';
-} catch { }
-
-console.log('');
-console.log('  ╔══════════════════════════════════════════╗');
-console.log(`  ║   ARCALITY v${version.padEnd(10)} — Instalado ✅    ║`);
-console.log('  ╚══════════════════════════════════════════╝');
-console.log('');
-
-// Crear directorio de config si no existe
-if (!fs.existsSync(CONFIG_DIR)) {
-    fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    console.log(`  📁 Directorio creado: ${CONFIG_DIR}`);
-}
-
-// Si no hay config, crear una por defecto (sin key)
-if (!fs.existsSync(CONFIG_FILE)) {
-    const defaultConfig = {
-        api_key: '',
-        version: version,
-        installed_at: new Date().toISOString()
-    };
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(defaultConfig, null, 2), 'utf8');
-    console.log(`  📝 Config creada: ${CONFIG_FILE}`);
-    console.log('');
-    console.log('  🔑 Para configurar tu API Key, ejecuta:');
-    console.log('');
-    console.log('     arcality setup');
-    console.log('');
-} else {
-    // Actualizar versión en config existente
-    try {
-        let raw = fs.readFileSync(CONFIG_FILE, 'utf8');
-        if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
-        const config = JSON.parse(raw);
-        config.version = version;
-        config.updated_at = new Date().toISOString();
-        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
-        console.log(`  ✅ Config actualizada (v${version})`);
-    } catch { }
-}
-
-console.log('  📌 Próximos pasos:');
-console.log('     1. arcality setup            → Configura tu API Key y navegador');
-console.log('     2. arcality                   → Abre el menú principal');
-console.log('     3. arcality --agent "misión"  → Ejecuta directamente');
-console.log('');
+#!/usr/bin/env node
+// scripts/postinstall.mjs — Post-install hook
+// Runs automatically after 'npm install @arcadialdev/arcality'
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.arcality');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+// Read version from package.json
+let version = 'unknown';
+try {
+    const pkgPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    version = pkg.version || 'unknown';
+} catch { }
+
+// ── Create global config dir if missing ──
+if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+if (!fs.existsSync(CONFIG_FILE)) {
+    const defaultConfig = { api_key: '', version, installed_at: new Date().toISOString() };
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(defaultConfig, null, 2), 'utf8');
+} else {
+    try {
+        let raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+        if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
+        const config = JSON.parse(raw);
+        config.version = version;
+        config.updated_at = new Date().toISOString();
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
+    } catch { }
+}
+
+// ── Inject `arcality` npm scripts into user's project package.json ──
+const userPkgPath = path.join(process.cwd(), 'package.json');
+let scriptsInjected = false;
+
+if (fs.existsSync(userPkgPath)) {
+    try {
+        let raw = fs.readFileSync(userPkgPath, 'utf8');
+        if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1);
+        const pkg = JSON.parse(raw);
+
+        // Only inject if not already there
+        if (!pkg.scripts?.['arcality'] && !pkg.scripts?.['arcality:run']) {
+            pkg.scripts = pkg.scripts || {};
+            pkg.scripts['arcality'] = 'arcality run';
+            pkg.scripts['arcality:init'] = 'arcality init';
+            pkg.scripts['arcality:run'] = 'arcality run';
+            fs.writeFileSync(userPkgPath, JSON.stringify(pkg, null, 2), 'utf8');
+            scriptsInjected = true;
+        }
+    } catch { /* silently skip if user's package.json is unreadable */ }
+}
+
+// ── Banner ──
+console.log('');
+console.log('  ╔══════════════════════════════════════════════╗');
+console.log(`  ║   ARCALITY v${version.padEnd(10)} — Installed ✅      ║`);
+console.log('  ╚══════════════════════════════════════════════╝');
+console.log('');
+
+if (scriptsInjected) {
+    console.log('  ⚡ Scripts added to your package.json automatically!');
+    console.log('');
+}
+
+console.log('  📌 How to use Arcality:');
+console.log('');
+console.log('     npm run arcality:init   → Configure this project');
+console.log('     npm run arcality:run    → Launch an autonomous test mission');
+console.log('     npm run arcality        → Open the interactive menu');
+console.log('');

package/scripts/rebrand-report.mjs

@@ -1,5 +1,11 @@
 import fs from 'fs';
 import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// The tool root: always the parent of the scripts/ folder
+const ARCALITY_ROOT = process.env.ARCALITY_ROOT || path.resolve(__dirname, '..');
 
 async function rebrandReport() {
     // Definir directorios objetivo: El reporte personalizado, el nativo anidado y el reporte interno
@@ -10,7 +16,7 @@ async function rebrandReport() {
         'playwright-internal-report'
     ];
 
-    const logoPngPath = path.join('public', 'logo.png');
+    const logoPngPath = path.join(ARCALITY_ROOT, 'public', 'logo.png');
     let logoBase64 = '';
 
     // Preparar Logo Arcality