argusqa-os 9.2.0 → 9.2.2

package/.mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "argus": {
-      "command": "node",
-      "args": ["src/mcp-server.js"]
+      "command": "npx",
+      "args": ["-y", "argusqa-os"]
     }
   }
 }

package/README.md

@@ -4,6 +4,42 @@
 
 Automated browser testing pipeline that catches bugs, compares environments, and sends rich reports to Slack (or generates a self-contained HTML dashboard when Slack is not configured) — powered by Chrome DevTools MCP and Claude Code.
 
+---
+
+## MCP Quick Start
+
+Add to your `.mcp.json` (or ask Claude Code: `claude mcp add argus -- npx -y argusqa-os`):
+
+```json
+{
+  "mcpServers": {
+    "argus": {
+      "command": "npx",
+      "args": ["-y", "argusqa-os"]
+    }
+  }
+}
+```
+
+Then ask Claude (or any MCP client):
+
+```
+Run argus_audit on http://localhost:3000
+```
+
+**Four tools are exposed:**
+
+| Tool | What it does |
+| --- | --- |
+| `argus_audit` | Fast QA pass — JS errors, network failures, accessibility, SEO, security, CSS, content |
+| `argus_audit_full` | Deep QA pass — adds Lighthouse scoring, responsive layout checks across 4 viewports, memory leak detection via heap snapshot, hover-state bug detection, and accessibility tree snapshot |
+| `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.
+
+---
+
 The `landing/` directory contains the product landing page (React + Vite + Tailwind + Framer Motion) with Supabase-backed waitlist and enterprise contact forms. Live at **[argus-qa.com](https://argus-qa.com)** (deployed via Cloudflare Pages; background video served from Cloudflare R2). See [landing/README.md](landing/README.md) for setup.
 
 <div align="center">
@@ -284,7 +320,7 @@ Argus watches your running application and automatically surfaces issues that te
 | **Slack Notifications** | Rich Block Kit reports with inline screenshots routed to `#bugs-critical`, `#bugs-warnings`, `#bugs-digest` |
 | **Slash Command** | `/argus-retest <url>` triggers an on-demand test from any Slack channel |
 | **CI Integration** | GitHub Actions workflow runs daily at 6 AM UTC and on every push to `main` |
-| **MCP Server (AI-callable Argus)** | Register Argus as an MCP server via `.mcp.json`; Claude (or any MCP client) can call `argus_audit`, `argus_audit_full`, `argus_compare`, `argus_last_report` directly from a conversation — no CLI, no terminal required (`npm run mcp-server`) |
+| **MCP Server (AI-callable Argus)** | Register Argus as an MCP server via `.mcp.json`; Claude (or any MCP client) can call `argus_audit`, `argus_audit_full`, `argus_compare`, `argus_last_report` directly from a conversation — no CLI, no terminal required. Published to npm as **[argusqa-os](https://www.npmjs.com/package/argusqa-os)** — add via `{ "command": "npx", "args": ["-y", "argusqa-os"] }` in `.mcp.json` |
 
 Works with **React + SCSS**, CSS Modules, CSS-in-JS (styled-components / emotion), and plain HTML/CSS apps.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argusqa-os",
-  "version": "9.2.0",
+  "version": "9.2.2",
   "description": "Argus — AI-powered automated dev-testing platform using Chrome DevTools MCP and Claude Code",
   "keywords": [
     "mcp",

package/src/mcp-server.js

@@ -129,7 +129,7 @@ async function handleLastReport() {
 // ── Server bootstrap ──────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: 'argus', version: '9.2.0' },
+  { name: 'argus', version: '9.2.2' },
   { capabilities: { tools: {} } },
 );
 

package/src/utils/logger.js

@@ -24,14 +24,15 @@ function usePrettyOutput() {
 
 function createLogger() {
   const level = process.env.ARGUS_LOG_LEVEL ?? 'info';
+  // Always write to stderr — stdout is reserved for the MCP stdio JSON-RPC channel.
   if (usePrettyOutput()) {
     try {
-      return pino({ level, transport: { target: 'pino-pretty', options: { colorize: true } } });
+      return pino({ level, transport: { target: 'pino-pretty', options: { colorize: true, destination: 2 } } });
     } catch {
       // pino-pretty not installed or failed to load — fall back to JSON
     }
   }
-  return pino({ level });
+  return pino({ level }, process.stderr);
 }
 
 export const logger = createLogger();