@arcadialdev/arcality 2.2.0 → 2.2.1

package/README.md

@@ -1,30 +1,96 @@
-# 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="https://raw.githubusercontent.com/microsoft/playwright/main/packages/playwright-core/src/server/chromium/test-results/favicon.ico" width="80" 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)
+  [![Playwright Powered](https://img.shields.io/badge/Powered_by-Playwright-2EAD33?style=for-the-badge&logo=playwright)](https://playwright.dev)
+  [![AI Core](https://img.shields.io/badge/AI_Core-Anthropic_Claude-D97757?style=for-the-badge&logo=anthropic)](https://anthropic.com)
+</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 Anthropic's Claude and Playwright, 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 LLM Gateway (`AIAgentHelper`):** Handles bidirectional communication with Anthropic. 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 (e.g., *Playwright Best Practices*, *E2E Testing Expert*) directly into the System Prompt to enforce strict QA policies.
+5. **The Reporter:** A custom Playwright 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.1",
   "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",