@arcadialdev/arcality 2.2.0 → 2.2.2

package/README.md

@@ -1,30 +1,94 @@
-# Arcality
-Herramienta QA para pruebas de UI con IA
-
-Meta 1.0.0: 
- - Start CLI (interactive test chooser): `arcality` or `npm run arcality` (see [package.json](package.json)).
- - Run Playwright directly: `npx playwright test` or `npx playwright test <path/to/spec>`.
- - Auto-generate + run spec (uses Ollama model): `node scripts/gen-and-run.mjs "<prompt>"` or run without args to execute last generated spec (see [scripts/gen-and-run.mjs](scripts/gen-and-run.mjs)).
- - .env management: the CLI will prompt and write `.env` when missing via [src/envSetup.ts](src/envSetup.ts).
-
-Important: the project reads configuration from the repository `.env` automatically. Do NOT pass `BASE_URL`, `LOGIN_USER`, or `LOGIN_PASSWORD` on the command line — the CLI, scripts, and tests load these values from `.env` internally. Example correct commands (no credentials in the command):
-
-```powershell
-node .\scripts\discover-view.mjs /categories
-node .\scripts\extract-view.mjs /categories
-node .\scripts\gen-and-run.mjs --discover /categories "Crear una categoría de ejemplo"
-```
-
-If `.env` is missing, the interactive setup in `src/envSetup.ts` will prompt to create it; otherwise the tools will use values found in `.env`.
-
-Meta 1.0.1:
--Hacer personalizable el login, sin depender de Id directamente
--Tener el test de creación de categoría
--Tener el test de creación de marca
--Tener el test de creación de producto
-
-Meta 1.0.2:
--Pedir la URL inicial, usuario y contraseña para .env
--Implementar una prueba de ZeroSteps
--Crear un template para leer YAML
--Leer un YAML y convertir en el template
+<div align="center">
+  <img src="./public/logo-arcadial-blanco.png" width="120" alt="Arcality Logo" />
+  <br>
+  <h1>Arcality Engine</h1>
+  <p><b>Autonomous AI-Powered E2E Web Testing Agent</b></p>
+  
+  [![NPM Version](https://img.shields.io/npm/v/@arcadialdev/arcality?color=c084fc&label=NPM&style=for-the-badge)](https://www.npmjs.com/package/@arcadialdev/arcality)
+</div>
+
+<br>
+
+**Arcality** is an enterprise-grade autonomous testing agent designed by Arcadial. It replaces brittle, hard-coded UI automation with an intelligent, self-healing agent that understands natural language. Powered by our proprietary AI Cognitive Core and Headless Execution Engine, Arcality navigates web portals, fills forms dynamically, and verifies business logic without requiring you to write a single line of test code.
+
+## ✨ Core Capabilities
+
+- 🧠 **Cognitive Execution Pipeline:** Arcality doesn't just click coordinates. It parses the DOM tree into an accessibility-focused abstraction, allowing it to "see" your application identically to a human user.
+- 🛡️ **Self-Healing & Forensic Debugging:** When elements shift or modals block the screen, Arcality doesn't instantly crash. It utilizes injected *E2E Expert Protocols* to debug the DOM, wait for networks, and gracefully recover.
+- ♻️ **YAML Persistence:** Once the Agent figures out how to successfully complete a prompt, the deterministic solution is saved locally as an optimized `.yaml` mission for lightning-fast regression testing in CI/CD.
+- 📊 **Agentic Diagnostics HTML Report:** Forget raw stack traces. Arcality generates beautiful, dark-mode `index.html` reports focusing entirely on **Agent Cognitive Process** and visual attachments. 
+- 🧰 **Project-Centric Architecture:** Runs seamlessly locally with `arcality.config.json`. No messy global `.env` files required. 
+
+---
+
+## 🚀 Getting Started
+
+### 1. Installation
+Install the CLI tool globally or as a dev dependency via NPM:
+```bash
+# Using npm
+npm install -g @arcadialdev/arcality
+
+# Or use npx directly without installing
+npx @arcadialdev/arcality init
+```
+
+### 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.
+
+```bash
+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.
+
+```bash
+# Interactive GUI Mode
+arcality run
+
+# CI/CD / Headless Mode
+arcality run --agent "Login with test credentials, navigate to Dashboard, and ensure the Welcome widget is visible."
+```
+
+---
+
+## 🛠️ Internal Architecture
+
+Arcality operates on a highly decoupled modular system designed for maximum resilience:
+
+1. **The CLI Wrapper:** A Node.js CLI that orchestrates Playwright subprocesses, parses configurations (`arcality.config.json`), and manages the CLI spinner aesthetic using `@clack/prompts`.
+2. **The Vision Engine:** Instead of capturing raw DOM, Arcality strips out CSS/JS noise and builds an `Interactive Component Tree` using `aria-labels` and `roles`.
+3. **The Cognitive Gateway (`AIAgentHelper`):** Handles bidirectional communication with the central AI Brain. It uses advanced recursive Tool Calling to perform `UI actions` (click, type, scroll) and `Forensic actions` (capture_console_errors).
+4. **Skill Injection (`.agents/skills/`):** At runtime, the agent injects external E2E standards directly into the System Prompt to enforce strict QA policies and intelligent locator strategies.
+5. **The Reporter:** A custom execution reporter (`ArcalityReporter.ts`) that filters out robotic hooks and renders the Agent's pure cognitive decision tree into an HTML dashboard.
+
+---
+
+## 📁 Configuration (`arcality.config.json`)
+
+When you run `arcality init`, a configuration is generated in your project root. 
+```json
+{
+  "project": {
+    "name": "PortalAdminQA",
+    "baseUrl": "https://dev.arcadial.lat",
+    "frameworkDetected": "Next.js"
+  },
+  "auth": {
+    "username": "qa_user",
+    "credentialsSource": "env"
+  },
+  "runtime": {
+    "yamlOutputDir": "./.arcality"
+  }
+}
+```
+*All reports, saved YAML missions, and runtime context are cleanly isolated inside your project's `./.arcality/` output directory.*
+
+---
+
+<div align="center">
+  <p>Built with ❤️ by the QA Intelligence team at <b>Arcadial</b>.</p>
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadialdev/arcality",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "AI-powered QA testing tool — Autonomous web testing agent by Arcadial",
   "main": "index.js",
   "scripts": {
@@ -27,7 +27,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Azlopez1/arcality.git"
+    "url": "https://dev.azure.com/arcadial/_git/ArcalityQA"
   },
   "keywords": [
     "qa",
@@ -41,9 +41,9 @@
   "license": "ISC",
   "type": "commonjs",
   "bugs": {
-    "url": "https://github.com/Azlopez1/arcality/issues"
+    "url": "https://dev.azure.com/arcadial/_git/ArcalityQA"
   },
-  "homepage": "https://github.com/Azlopez1/arcality#readme",
+  "homepage": "https://dev.azure.com/arcadial/_git/ArcalityQA",
   "devDependencies": {
     "@types/figlet": "^1.7.0",
     "@types/node": "^25.0.9",