@arcadialdev/arcality 2.4.49 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +18 -20
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -29,41 +29,39 @@
29
29
  npm install @arcadialdev/arcality
30
30
  ```
31
31
 
32
- > After install, Arcality **automatically adds the following scripts** to your `package.json`:
32
+ > After install, Arcality automatically adds the following scripts to your `package.json`:
33
33
  > ```json
34
- > "arcality": "arcality run",
35
- > "arcality:init": "arcality init",
36
- > "arcality:run": "arcality run"
34
+ > "dev": "node scripts/gen-and-run.mjs",
35
+ > "postinstall": "node scripts/postinstall.mjs",
36
+ > "setup": "node scripts/setup.mjs",
37
+ > "build:runner": "npx esbuild tests/_helpers/agentic-runner.spec.ts --bundle --platform=node --target=node18 --format=cjs --external:@playwright/test --external:chalk --external:dotenv --external:node-fetch --external:js-yaml --external:axios --external:crypto --external:fs --external:path --outfile=tests/_helpers/agentic-runner.bundle.spec.js",
38
+ > "prepublishOnly": "npm run build:runner"
37
39
  > ```
40
+ >
41
+ > **Current version:** `2.5.0`
38
42
 
39
- ### 2. Initialize your project
40
- Run the setup wizard at the root of your project. Arcality will auto-detect your framework and scaffold the `arcality.config.json`.
41
-
43
+ ### 📦 Updating Arcality
44
+ Run the following to get the latest version:
42
45
  ```bash
43
- npm run arcality:init
46
+ npm update @arcadialdev/arcality
44
47
  ```
45
48
 
46
- ### 3. Run an autonomous mission
47
-
48
- ```bash
49
- # Interactive menu
50
- npm run arcality
49
+ ### ⚙️ Configuration (`arcality.config.json`)
50
+ After initializing with `npm run arcality:init`, a config file is created in the project root. Edit it to set your project name, base URL, and authentication details. The CLI reads this file on every run, ensuring consistent environment variables.
51
51
 
52
- # Direct mission
53
- npm run arcality:run
54
- ```
52
+ ### 🚀 Getting Started (revised)
53
+ 1. **Install** – `npm install @arcadialdev/arcality`
54
+ 2. **Initialize** – `npm run arcality:init`
55
+ 3. **Run a mission** – `npm run dev` (interactive menu) or `npm run dev -- --run "Your prompt"` for direct execution.
55
56
 
56
57
  ---
57
58
 
58
59
  ## 💻 CLI Commands Cheatsheet
59
60
 
60
- The Arcality flow is designed to be used globally or project-wide via \`npx\`. Below are all currently supported commands:
61
+ The Arcality flow is designed to be used globally or project-wide via `npx`. Below are all currently supported commands:
61
62
 
62
63
  | Command | Description | Internal Behavior |
63
64
  | :--- | :--- | :--- |
64
- | \`npx arcality\` | **Interactive Menu**<br/>Launches a visual menu in the terminal to guide the user. | Prompts for the Mission to execute. Ideal for new users who want a guided experience. |
65
- | \`npx arcality init\` | **Initial Configuration**<br/>Connects the current project to Arcality Cloud. | Prompts for your API Key and Project ID, generates \`arcality.config.json\`, and validates the ADO / Portal connection. |
66
- | \`npx arcality setup\` | **Dependency Setup**<br/>Downloads browser binaries. | Silently executes the installation of internal Playwright browsers (Chromium) ensuring the local machine can run tests. |
67
65
  | \`npx arcality run\` | **Mission Runner (Agent Mode)**<br/>Launches the QA Agent directly. | Skips the interactive menu, scans the _package.json_ ("Ghost Mode"), injects ephemeral _autoskills_, and unleashes the AI agent. Ideal for CI/CD. |
68
66
  | \`npx arcality --logs\` | **History Viewer**<br/>Displays test performance and tokens spent. | Reads the local \`arcality-history.log\` and renders a colorful table listing each mission, token consumption, and success status. |
69
67
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@arcadialdev/arcality",
3
- "version": "2.4.49",
3
+ "version": "2.5.0",
4
4
  "description": "El primer ingeniero QA Autónomo integrado al CI/CD. Creado por Arcadial.",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -70,4 +70,4 @@
70
70
  "terminal-image": "^1.1.0",
71
71
  "tsx": "^4.21.0"
72
72
  }
73
- }
73
+ }