Arcality is a QA agent for web applications that helps teams describe flows in natural language, execute them with resilience, and preserve successful runs as reusable missions with evidence that is easier to review.

What Arcality Gives You

• Natural-language driven QA flows for real web applications
• Reusable local mission files that help teams keep coverage organized
• Visual evidence and execution summaries that are easier to share
• Project-scoped configuration, context, and artifacts
• Optional database corroboration for high-confidence validation

Getting Started

1. Install in your project

npm install @arcadialdev/arcality

2. Initialize your project

npx arcality init

3. Run your first mission

# Open the interactive menu
npx arcality

# Or launch the agent directly
npx arcality run

Update Arcality

npm update @arcadialdev/arcality

Local Project Setup

Arcality stores its project configuration in arcality.config.json and keeps runtime artifacts under .arcality/.

For existing projects, the interactive menu now separates:

• Editar configuracion del proyecto: recalibrates the current local setup
• Reconectar backend / proyecto nuevo: reruns the full onboarding flow

This makes it easier to refine a project without rebuilding everything from zero.

Database Corroboration

Arcality can validate mission outcomes against PostgreSQL during local runs without placing secrets inside mission files.

Recommended approach:

• keep connection data in .env
• keep reusable validation queries in .arcality/db-validations.yaml
• use MCP mode only when your team already has an approved PostgreSQL bridge

The recalibration flow can help you:

• register or update the connection profile
• choose direct PostgreSQL or MCP mode
• run a lightweight health check before leaving setup

QA Context

Arcality can load local business rules from .arcality/qa-context.md and optional governance metadata from .arcality/qa-context.meta.json.

Precedence order:

1. Local QA context file
2. Backend collective memory
3. Base QA heuristics

If your team wants stronger control, governance can be enforced in off, warn, or strict mode.

CLI Commands

| Command | Purpose | | :--- | :--- | | npx arcality | Open the interactive menu | | npx arcality init | Configure a project for first use | | npx arcality run | Launch the agent directly | | npx arcality generate --dry-run | Preview candidate missions | | npx arcality generate --count 5 | Generate a limited mission batch | | npx arcality logs | Review recent mission summaries |

Parallel collections

Arcality can execute multiple saved missions in parallel. Use this only when the target application safely supports concurrent sessions and shared test data will not collide.

Generate missions

npx arcality generate helps teams bootstrap reusable mission files from the current project. It is meant to accelerate authoring, not replace QA judgment.

Product Overview

Arcality is designed to help QA teams move faster without depending on brittle hard-coded automation. It keeps configuration, local context, generated missions, and evidence close to the application under test so teams can evolve coverage in a practical way.