argusqa-os 9.2.5 → 9.2.7

package/README.md

@@ -10,11 +10,15 @@ Automated browser testing pipeline that catches bugs, compares environments, and
 
 ## MCP Quick Start
 
-Add to your `.mcp.json` (or ask Claude Code: `claude mcp add argus -- npx -y argusqa-os`):
+Add both servers to your `.mcp.json`:
 
 ```json
 {
   "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    },
     "argus": {
       "command": "npx",
       "args": ["-y", "argusqa-os"]
@@ -23,6 +27,25 @@ Add to your `.mcp.json` (or ask Claude Code: `claude mcp add argus -- npx -y arg
 }
 ```
 
+Or register via the Claude Code CLI:
+
+```bash
+claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest
+claude mcp add argus -- npx -y argusqa-os
+```
+
+Set your target URL and start Chrome with remote debugging:
+
+```bash
+# .env
+TARGET_DEV_URL=http://localhost:3000
+
+# Start Chrome (required — Argus drives this instance via CDP)
+# macOS:   open -a "Google Chrome" --args --remote-debugging-port=9222 --headless=new
+# Windows: "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --headless=new
+# Linux:   google-chrome --remote-debugging-port=9222 --headless=new --no-sandbox
+```
+
 Then ask Claude (or any MCP client):
 
 ```
@@ -38,7 +61,7 @@ Run argus_audit on http://localhost:3000
 | `argus_compare` | Diff dev vs staging side-by-side — screenshots, findings delta, environment regressions |
 | `argus_last_report` | Return the last saved report JSON from the most recent audit |
 
-> **Requires**: Node.js ≥ 20.19, Chrome running with `--remote-debugging-port=9222`, and the [`chrome-devtools-mcp`](https://www.npmjs.com/package/chrome-devtools-mcp) MCP server registered alongside Argus.
+> **Requires**: Node.js ≥ 20.19, Chrome (desktop or headless), and the `chrome-devtools-mcp` server registered alongside Argus (shown above).
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argusqa-os",
-  "version": "9.2.5",
+  "version": "9.2.7",
   "mcpName": "io.github.ironclawdevs27/argus",
   "description": "Argus — AI-powered automated dev-testing platform using Chrome DevTools MCP and Claude Code",
   "keywords": [

package/src/mcp-server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Argus MCP Server (v9.2.3)
+ * Argus MCP Server (v9.2.7)
  *
  * Exposes Argus as an MCP server so Claude (or any MCP client) can call
  * argus_audit, argus_audit_full, argus_compare, and argus_last_report
@@ -36,36 +36,36 @@ const REPORTS_DIR = path.resolve(process.cwd(), 'reports');
 const TOOLS = [
   {
     name: 'argus_audit',
-    description: 'Run a fast QA audit on a URL. Detects JavaScript errors, unhandled promise rejections, network failures (4xx/5xx), API frequency loops, CSS cascade issues, SEO problems, security vulnerabilities, content quality issues, and accessibility violations. Returns findings as JSON grouped by severity (critical/warning/info).',
+    description: 'Fast QA audit on a URL via Chrome DevTools Protocol. Runs 8 analyzers in one pass: JS errors, unhandled rejections, network failures (4xx/5xx), API frequency loops, CSS cascade issues, SEO violations, security header checks, and accessibility. Returns { findings: [{severity, type, message, url}], summary: {critical, warning, info} }. Use for CI smoke tests and pre-deploy gates. For Lighthouse scoring and memory leak detection, use argus_audit_full. Requires Chrome running with --remote-debugging-port=9222.',
     inputSchema: {
       type: 'object',
       properties: {
-        url:      { type: 'string',  description: 'Full URL to audit (e.g. http://localhost:3000/checkout)' },
-        critical: { type: 'boolean', description: 'Treat this route as critical — console errors become critical severity', default: false },
+        url:      { type: 'string',  description: 'Full URL to audit, including protocol and path (e.g. http://localhost:3000/checkout). Must be reachable by the running Chrome instance.' },
+        critical: { type: 'boolean', description: 'When true, console.error calls are escalated to critical severity. Set true for business-critical routes (login, checkout, dashboard) where any error is a blocker.', default: false },
       },
       required: ['url'],
     },
   },
   {
     name: 'argus_audit_full',
-    description: 'Run a deep QA pass on a URL using all analyzers — Lighthouse performance/accessibility scoring, responsive layout checks across mobile/tablet/desktop viewports, memory leak detection via heap snapshot, hover-state bug detection, and accessibility tree snapshot. Returns a full JSON report with findings grouped by severity.',
+    description: 'Deep QA audit — extends argus_audit with Lighthouse performance/accessibility scoring, responsive layout checks across 4 viewports (320/768/1280/1920px), memory leak detection via heap snapshot, hover-state regression detection, and accessibility tree snapshot. Returns full JSON report with findings by severity, Lighthouse scores, and layout overflow details. Use when argus_audit passes clean but visual or performance regressions are suspected. Requires Chrome running with --remote-debugging-port=9222.',
     inputSchema: {
       type: 'object',
       properties: {
-        url:      { type: 'string',  description: 'Full URL to audit (e.g. https://example.com/dashboard)' },
-        critical: { type: 'boolean', description: 'Mark this route as critical — console errors are escalated to critical severity', default: false },
+        url:      { type: 'string',  description: 'Full URL to audit, including protocol and path (e.g. https://example.com/dashboard). Must be reachable by the running Chrome instance.' },
+        critical: { type: 'boolean', description: 'When true, console.error calls are escalated to critical severity. Set true for business-critical routes (login, checkout, dashboard) where any error is a blocker.', default: false },
       },
       required: ['url'],
     },
   },
   {
     name: 'argus_compare',
-    description: 'Snapshot and diff two environments (dev vs staging) side-by-side. Navigates both URLs, captures screenshots, runs the full analyzer suite on each, then diffs the findings to surface regressions — things that appear in staging but not dev, or changed severity. Configure the two target URLs via TARGET_DEV_URL and TARGET_STAGING_URL environment variables before starting the server.',
+    description: 'Diffs dev vs staging environments side-by-side. Navigates both URLs, captures screenshots, and runs the full analyzer suite on each, then surfaces regressions — findings present in staging but not dev, or with changed severity. Returns { regressions: [{type, devSeverity, stagingSeverity}], screenshots, summary }. Run before promoting a build to staging to catch environment-specific bugs. Set TARGET_DEV_URL and TARGET_STAGING_URL env vars before starting the server; omit TARGET_STAGING_URL to run CSS-analysis-only mode.',
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'argus_last_report',
-    description: 'Return the most recent Argus JSON report from the reports/ directory.',
+    description: 'Returns the most recent Argus JSON report from the reports/ directory. Report includes a findings array and severity summary (critical/warning/info counts). Returns { "error": "No reports found in reports/" } when no audits have been run yet. Use to retrieve prior results without re-running a scan, or to pipe findings into another analysis tool.',
     inputSchema: { type: 'object', properties: {} },
   },
 ];
@@ -129,7 +129,7 @@ async function handleLastReport() {
 // ── Server bootstrap ──────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: 'argus', version: '9.2.5' },
+  { name: 'argus', version: '9.2.7' },
   { capabilities: { tools: {} } },
 );