@vitronai/alethia 0.3.20 → 0.3.22

package/README.md

@@ -48,11 +48,19 @@ alethia-mcp --health-check
 ```json
 {
   "mcpServers": {
-    "alethia": { "command": "alethia-mcp" }
+    "alethia": {
+      "command": "alethia-mcp",
+      "env": {
+        "ALETHIA_VISIBLE": "1",
+        "ALETHIA_HIGHLIGHTS": "1"
+      }
+    }
   }
 }
 ```
 
+The Alethia browser window opens alongside your agent with live step highlights. Elements flash green (click/assert), blue (type), and red (EA1 block). Remove the `env` block for headless mode.
+
 ### Cursor
 
 Cursor → Settings → MCP → Add server:
@@ -120,20 +128,22 @@ Ready-to-use demo pages ship in the `demo/` folder. Start with the Claude Code d
 
 ### Claude Code: verify a generated app
 
-Paste this into Claude Code:
+Paste this into Claude Code, Cursor, or any MCP client:
 
 ```
-Use alethia_serve_demo to start the demo server.
-Then use alethia_tell to navigate to the claude-code-app page.
-Assert "TaskFlow" is visible. Type dev@company.com into the
+Use alethia_serve_demo to start the demo server. Then use
+alethia_tell to navigate to the claude-code-app URL. Assert
+"TaskFlow" is visible. Type dev@company.com into the
 "you@company.com" field. Type Engineering into the "Your team
 name" field. Click Sign in. Assert "Signed in as" is visible.
 Type "Deploy to production" into the "Add a new task" field.
-Click Add. Assert "Deploy to production" is visible.
-Click Delete and report what EA1 decides.
+Click Add. Assert "Deploy to production" is visible. Click
+Delete and report what EA1 decides.
 ```
 
-The agent serves the demo on localhost, drives it with plain English, and EA1 blocks the delete. Open the localhost URL in Claude Code's preview panel to watch it live.
+The agent starts a localhost server, drives the app with plain English, and EA1 blocks the delete.
+
+**Watch it live:** Add `"env": { "ALETHIA_VISIBLE": "1" }` to your MCP config to open the Alethia browser window and see clicks, typing, and EA1 blocks happen in real time.
 
 ### More scenarios
 

package/demo/README.md

@@ -6,23 +6,15 @@ Ready-to-use scenarios that show Alethia driving real apps. Start with the Claud
 
 The core use case. Claude Code generates an app, Alethia verifies it works.
 
-`claude-code-app.html` simulates a task manager that Claude Code would scaffold. The prompt below runs a full verification flow: sign in, check the dashboard, add a task, complete a task, try to delete one (EA1 blocks it), and sign out.
+`claude-code-app.html` simulates a task manager that Claude Code would scaffold. Paste this into Claude Code:
 
 ```
-Step 1 — sign in and add a task:
-
-Use alethia_tell to navigate to file:///PATH/demo/claude-code-app.html. Assert "TaskFlow" is visible and "Generated by Claude Code" is visible. Type dev@company.com into the "you@company.com" field. Type Engineering into the "Your team name" field. Click Sign in. Assert "Signed in as" is visible. Assert "Active" is visible and "Completed" is visible. Type "Deploy to production" into the "Add a new task" field. Click Add. Assert "Deploy to production" is visible.
-
-Step 2 — try to delete (EA1 blocks it):
-
-Use alethia_tell to click Delete and report what EA1 decides.
-
-Step 3 — sign out:
-
-Use alethia_tell to click Sign out. Assert "Sign in" is visible.
+Use alethia_serve_demo to start the demo server. Then use alethia_tell to navigate to the claude-code-app URL. Assert "TaskFlow" is visible. Type dev@company.com into the "you@company.com" field. Type Engineering into the "Your team name" field. Click Sign in. Assert "Signed in as" is visible. Type "Deploy to production" into the "Add a new task" field. Click Add. Assert "Deploy to production" is visible. Click Delete and report what EA1 decides.
 ```
 
-This is the loop: agent builds, Alethia verifies, EA1 guards. Every step returns structured results, a page snapshot (~200 tokens), and a signed audit trail.
+The agent starts a localhost server, drives the app with plain English, and EA1 blocks the delete.
+
+**Watch it live:** Add `"env": { "ALETHIA_VISIBLE": "1" }` to your MCP config to open the Alethia browser window and see clicks, typing, and EA1 blocks happen in real time.
 
 ## Domain scenarios
 

package/demo/claude-code-app.html

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-  <title>TaskFlow — AI-Generated Task Manager</title>
+  <title>TaskFlow - AI-Generated Task Manager</title>
   <style>
     * { box-sizing: border-box; margin: 0; padding: 0; }
     body { font-family: -apple-system, 'Segoe UI', sans-serif; background: #0a0a0a; color: #e4e4e7; min-height: 100vh; }

package/dist/index.js

@@ -123,7 +123,7 @@ const getDemoPages = () => {
 // ---------------------------------------------------------------------------
 // Auto-install: download, verify, extract, and spawn the headless runtime
 // ---------------------------------------------------------------------------
-const RUNTIME_VERSION = '0.1.0-alpha.8';
+const RUNTIME_VERSION = '0.1.0-alpha.9';
 const RUNTIME_DIR = join(homedir(), '.alethia', 'runtime');
 const RUNTIME_MARKER = join(RUNTIME_DIR, '.installed');
 const GITHUB_RELEASE_BASE = `https://github.com/vitron-ai/alethia/releases/download/v${RUNTIME_VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitronai/alethia",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "MIT-licensed MCP bridge to the Alethia runtime — the patent-pending zero-IPC E2E test runtime built for AI agents. 45x faster than Playwright. Local-first, zero telemetry. WCAG + NIST 800-53 compliance audits built in. Auto-installs on first use.",
   "type": "module",
   "main": "dist/index.js",