@arcadialdev/arcality 2.2.0

package/bin/arcality.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// bin/arcality.mjs — Entry point for the 'arcality' global command
+// Registered as "bin" in package.json → npm creates the global symlink
+
+import { fileURLToPath } from 'url';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+const args = process.argv.slice(2);
+const subcommand = args[0];
+
+// ── Subcommand: arcality init ──
+if (subcommand === 'init') {
+    const initScript = path.join(PACKAGE_ROOT, 'scripts', 'init.mjs');
+    const child = spawn('node', [initScript, ...args.slice(1)], {
+        stdio: 'inherit',
+        cwd: process.cwd(), // Run in the user's project directory
+        env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }
+    });
+    child.on('exit', code => process.exit(code || 0));
+
+// ── Subcommand: arcality run ──
+} else if (subcommand === 'run') {
+    const mainScript = path.join(PACKAGE_ROOT, 'scripts', 'gen-and-run.mjs');
+    const child = spawn('node', [mainScript, '--agent', ...args.slice(1)], {
+        stdio: 'inherit',
+        cwd: process.cwd(),
+        env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }
+    });
+    child.on('exit', code => process.exit(code || 0));
+
+// ── Subcommand: arcality setup (legacy) ──
+} else if (subcommand === 'setup') {
+    const setupScript = path.join(PACKAGE_ROOT, 'scripts', 'setup.mjs');
+    const child = spawn('node', [setupScript, ...args.slice(1)], {
+        stdio: 'inherit',
+        cwd: PACKAGE_ROOT,
+        env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }
+    });
+    child.on('exit', code => process.exit(code || 0));
+
+// ── Subcommand: arcality version ──
+} else if (subcommand === '--version' || subcommand === '-v') {
+    const fs = await import('node:fs');
+    try {
+        const pkg = JSON.parse(fs.default.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+        console.log(`arcality v${pkg.version}`);
+    } catch {
+        console.log('arcality (version unknown)');
+    }
+
+// ── Subcommand: arcality help ──
+} else if (subcommand === '--help' || subcommand === '-h' || subcommand === 'help') {
+    const fs = await import('node:fs');
+    let version = 'unknown';
+    try {
+        const pkg = JSON.parse(fs.default.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+        version = pkg.version || 'unknown';
+    } catch { }
+
+    console.log(`
+  Arcality v${version} — AI-powered QA Testing Agent
+
+  Usage:
+    arcality init                 Configure project & create arcality.config
+    arcality run [prompt]         Run the autonomous agent
+    arcality                      Open interactive menu
+    arcality setup                Legacy setup (API keys + Chromium)
+    arcality --version            Show version
+    arcality --help               Show this help
+    `);
+
+// ── Default: interactive menu (gen-and-run.mjs) ──
+} else {
+    const mainScript = path.join(PACKAGE_ROOT, 'scripts', 'gen-and-run.mjs');
+    const child = spawn('node', [mainScript, ...args], {
+        stdio: 'inherit',
+        cwd: process.cwd(),
+        env: { ...process.env, ARCALITY_ROOT: PACKAGE_ROOT }
+    });
+    child.on('exit', code => process.exit(code || 0));
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@arcadialdev/arcality",
+  "version": "2.2.0",
+  "description": "AI-powered QA testing tool — Autonomous web testing agent by Arcadial",
+  "main": "index.js",
+  "scripts": {
+    "dev": "node scripts/gen-and-run.mjs",
+    "arcality": "node scripts/gen-and-run.mjs",
+    "postinstall": "node scripts/postinstall.mjs",
+    "setup": "node scripts/setup.mjs"
+  },
+  "bin": {
+    "arcality": "bin/arcality.mjs"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "src/",
+    "tests/_helpers/",
+    ".agents/",
+    "playwright.config.ts",
+    ".env.example",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Azlopez1/arcality.git"
+  },
+  "keywords": [
+    "qa",
+    "testing",
+    "ai",
+    "playwright",
+    "autonomous",
+    "arcadial"
+  ],
+  "author": "Arcadial",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/Azlopez1/arcality/issues"
+  },
+  "homepage": "https://github.com/Azlopez1/arcality#readme",
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/node": "^25.0.9",
+    "@types/prompts": "^2.4.9",
+    "tsx": "^4.21.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "@inquirer/prompts": "^8.2.0",
+    "@playwright/test": "^1.57.0",
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "dotenv": "^17.2.3",
+    "figlet": "^1.9.4",
+    "js-yaml": "^4.1.1",
+    "node-fetch": "^3.3.2",
+    "prompts": "^2.4.2",
+    "terminal-image": "^1.1.0"
+  }
+}

package/playwright.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  reporter: [
+    ['./tests/_helpers/ArcalityReporter.ts', { outputDir: process.env.REPORTS_DIR || 'tests-report' }]
+  ],
+  use: {
+    video: 'on',
+    trace: 'retain-on-failure',
+  },
+});

package/scripts/cleanup-qmsdev.mjs

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import path from 'path';
+
+const baseDir = 'c:/Users/apulido/OneDrive - Block Networks/Documentos/Arcadial Projects/Char.Dev/out/qmsDev';
+const nestedDir = path.join(baseDir, 'context', 'qmsDev');
+const targetContextDir = path.join(baseDir, 'context');
+const targetMissionsDir = path.join(baseDir, 'missions');
+
+function cleanup() {
+    if (!fs.existsSync(nestedDir)) {
+        console.log('Nested directory not found, skipping.');
+        return;
+    }
+
+    const files = fs.readdirSync(nestedDir);
+
+    files.forEach(file => {
+        const filePath = path.join(nestedDir, file);
+        if (file.startsWith('agent-log-')) {
+            console.log(`Moving ${file} to context/`);
+            fs.renameSync(filePath, path.join(targetContextDir, file));
+        } else if (file === 'memoria-agente.json') {
+            const targetMemory = path.join(targetContextDir, 'memoria-agente.json');
+            if (fs.existsSync(targetMemory)) {
+                console.log('Merging memoria-agente.json...');
+                const mainMemory = JSON.parse(fs.readFileSync(targetMemory, 'utf8'));
+                const nestedMemory = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+                const combined = [...mainMemory, ...nestedMemory];
+                fs.writeFileSync(targetMemory, JSON.stringify(combined, null, 2));
+                fs.unlinkSync(filePath);
+            } else {
+                console.log('Moving memoria-agente.json...');
+                fs.renameSync(filePath, targetMemory);
+            }
+        } else if (file === 'saved_missions') {
+            const missions = fs.readdirSync(filePath);
+            missions.forEach(m => {
+                if (m.endsWith('.yaml') || m.endsWith('.yml')) {
+                    console.log(`Moving mission ${m} to missions/`);
+                    fs.renameSync(path.join(filePath, m), path.join(targetMissionsDir, m));
+                }
+            });
+            fs.rmdirSync(filePath, { recursive: true });
+        } else if (fs.statSync(filePath).isFile()) {
+            console.log(`Moving other file ${file} to context/`);
+            fs.renameSync(filePath, path.join(targetContextDir, file));
+        }
+    });
+
+    // Try to remove the empty nested dir
+    try {
+        if (fs.readdirSync(nestedDir).length === 0) {
+            fs.rmdirSync(nestedDir);
+            console.log('Removed empty nested directory.');
+        } else {
+            console.warn('Nested directory not empty, keeping it.');
+        }
+    } catch (e) {
+        console.error('Error removing nested dir:', e.message);
+    }
+}
+
+cleanup();

package/scripts/discover-view.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import fs from 'node:fs';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+
+const targetPath = process.argv[2] || '/';
+const isWin = process.platform === 'win32';
+const cmd = isWin ? 'npx.cmd' : 'npx';
+const testFile = 'tests/_helpers/discover-view.spec.ts';
+
+function parseDotEnvFile(p) {
+  try {
+    const raw = fs.readFileSync(p, 'utf8');
+    const lines = raw.split(/\r?\n/);
+    const out = {};
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) continue;
+      const idx = trimmed.indexOf('=');
+      if (idx === -1) continue;
+      let k = trimmed.slice(0, idx).trim();
+      let v = trimmed.slice(idx + 1).trim();
+      if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) v = v.slice(1, -1);
+      out[k] = v;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
+
+const fileEnv = parseDotEnvFile(path.join(process.cwd(), '.env'));
+const env = { ...process.env, ...fileEnv, TARGET_PATH: targetPath };
+
+const args = ['playwright', 'test', testFile, '--project=chromium'];
+// Debug printing removed to avoid leaking placeholders; command is spawned directly
+
+const child = spawn(cmd, args, {
+  stdio: 'inherit',
+  shell: isWin,
+  env,
+});
+
+child.on('exit', (code) => {
+  process.exit(code ?? 0);
+});
+
+child.on('error', (err) => {
+  console.error('Failed to run playwright:', err);
+  process.exit(1);
+});

package/scripts/extract-view.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import fs from 'node:fs';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+
+const targetPath = process.argv[2] || '/';
+const isWin = process.platform === 'win32';
+const cmd = isWin ? 'npx.cmd' : 'npx';
+
+// Use POSIX-style forward slashes so Playwright reliably matches the file on all platforms
+const testFile = 'tests/_helpers/extract-view.spec.ts';
+
+function parseDotEnvFile(p) {
+  try {
+    const raw = fs.readFileSync(p, 'utf8');
+    const lines = raw.split(/\r?\n/);
+    const out = {};
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) continue;
+      const idx = trimmed.indexOf('=');
+      if (idx === -1) continue;
+      let k = trimmed.slice(0, idx).trim();
+      let v = trimmed.slice(idx + 1).trim();
+      if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) v = v.slice(1, -1);
+      out[k] = v;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
+
+const fileEnv = parseDotEnvFile(path.join(process.cwd(), '.env'));
+const env = { ...process.env, ...fileEnv, TARGET_PATH: targetPath };
+
+const args = ['playwright', 'test', testFile, '--project=chromium', '--headed'];
+
+// Debug printing removed to avoid leaking placeholders; command is spawned directly
+
+const child = spawn(cmd, args, {
+  stdio: 'inherit',
+  shell: isWin,
+  env,
+});
+
+child.on('exit', (code) => {
+  // DESACTIVADO POR PETICIÓN DE USUARIO: Evitar pantallas extras/consolas
+  /*
+  try {
+    const showCmd = isWin ? 'npx.cmd' : 'npx';
+    spawn(showCmd, ['playwright', 'show-report'], { stdio: 'ignore', shell: isWin, detached: true });
+  } catch (e) {
+    // ignore
+  }
+  */
+  process.exit(code ?? 0);
+});
+
+child.on('error', (err) => {
+  console.error('Failed to run playwright:', err);
+  process.exit(1);
+});