argusqa-os 9.2.7 → 9.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argusqa-os",
-  "version": "9.2.7",
+  "version": "9.2.9",
   "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.7)
+ * Argus MCP Server (v9.2.9)
  *
  * 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
@@ -28,6 +28,8 @@ import path from 'path';
 import { createMcpClient }                    from './utils/mcp-client.js';
 import { crawlRouteCheap, runCrawl }          from './orchestration/crawl-and-report.js';
 import { runComparison }                      from './orchestration/env-comparison.js';
+import { WatchSession }                       from './orchestration/watch-mode.js';
+import { CdpBrowserAdapter }                  from './adapters/browser.js';
 
 const REPORTS_DIR = path.resolve(process.cwd(), 'reports');
 
@@ -68,6 +70,26 @@ const TOOLS = [
     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: {} },
   },
+  {
+    name: 'argus_watch_snapshot',
+    description: 'Snapshots the currently open Chrome tab without navigating — captures console errors, network failures (4xx/5xx), CORS blocks, and auth failures in one poll. Returns { findings: [{severity, type, message, url}], newConsole, newNetwork }. Use during active development to inspect what is happening on the current page without running a full audit. Requires Chrome on --remote-debugging-port=9222 with a page already open.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'Optional base URL to attribute findings to (default: TARGET_DEV_URL env var). Does not navigate — reads the currently open Chrome tab.' },
+      },
+    },
+  },
+  {
+    name: 'argus_get_context',
+    description: 'Captures everything currently broken on the open Chrome tab and formats it as a diagnostic context for Claude to read and suggest fixes. Does NOT navigate — reads the live tab state after user interactions, in authenticated sessions, or mid-flow. Returns { summary, url, timestamp, critical_issues, warnings, js_errors, network_failures, console_errors, recent_requests } where summary is a plain-English description of what is broken. Use when the app is stuck, throwing errors, or behaving unexpectedly — run this, then paste the output to Claude and ask for fixes. Requires Chrome on --remote-debugging-port=9222.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'Optional base URL to attribute findings to (default: TARGET_DEV_URL env var). Does not navigate — inspects the currently open Chrome tab.' },
+      },
+    },
+  },
 ];
 
 // ── Helpers ───────────────────────────────────────────────────────────────────
@@ -111,6 +133,51 @@ async function handleCompare() {
   });
 }
 
+async function handleWatchSnapshot({ url } = {}) {
+  return withMcp(async (mcp) => {
+    const browser = new CdpBrowserAdapter(mcp);
+    const baseUrl = url ?? process.env.TARGET_DEV_URL ?? 'http://localhost:3000';
+    const session = new WatchSession(browser, baseUrl);
+    const result  = await session.poll();
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+  });
+}
+
+async function handleGetContext({ url } = {}) {
+  return withMcp(async (mcp) => {
+    const browser = new CdpBrowserAdapter(mcp);
+    const baseUrl = url ?? process.env.TARGET_DEV_URL ?? 'http://localhost:3000';
+    const session = new WatchSession(browser, baseUrl);
+    const { findings, newConsole, newNetwork } = await session.poll();
+
+    const critical = findings.filter(f => f.severity === 'critical');
+    const warnings  = findings.filter(f => f.severity === 'warning');
+
+    let summary;
+    if (critical.length === 0 && warnings.length === 0) {
+      summary = `No issues detected on ${baseUrl} — console and network are clean.`;
+    } else if (critical.length > 0) {
+      summary = `${critical.length} critical issue${critical.length > 1 ? 's' : ''} + ${warnings.length} warning${warnings.length !== 1 ? 's' : ''} detected on ${baseUrl}. Focus on critical issues first.`;
+    } else {
+      summary = `${warnings.length} warning${warnings.length !== 1 ? 's' : ''} detected on ${baseUrl}. No critical errors.`;
+    }
+
+    const context = {
+      summary,
+      url:              baseUrl,
+      timestamp:        new Date().toISOString(),
+      critical_issues:  critical,
+      warnings,
+      js_errors:        findings.filter(f => f.type === 'js-error' || f.type === 'unhandled-rejection'),
+      network_failures: findings.filter(f => f.type === 'network-error' || f.type === 'cors-error' || f.type === 'auth-error'),
+      console_errors:   newConsole.filter(m => m.level === 'error' || m.level === 'warning'),
+      recent_requests:  newNetwork.slice(-20),
+    };
+
+    return { content: [{ type: 'text', text: JSON.stringify(context, null, 2) }] };
+  });
+}
+
 async function handleLastReport() {
   if (!fs.existsSync(REPORTS_DIR)) {
     return { content: [{ type: 'text', text: '{"error":"No reports found in reports/"}' }] };
@@ -129,7 +196,7 @@ async function handleLastReport() {
 // ── Server bootstrap ──────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: 'argus', version: '9.2.7' },
+  { name: 'argus', version: '9.2.9' },
   { capabilities: { tools: {} } },
 );
 
@@ -141,7 +208,9 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       case 'argus_audit':       return await handleAudit(req.params.arguments ?? {});
       case 'argus_audit_full':  return await handleAuditFull(req.params.arguments ?? {});
       case 'argus_compare':     return await handleCompare();
-      case 'argus_last_report': return await handleLastReport();
+      case 'argus_last_report':     return await handleLastReport();
+      case 'argus_watch_snapshot':  return await handleWatchSnapshot(req.params.arguments ?? {});
+      case 'argus_get_context':     return await handleGetContext(req.params.arguments ?? {});
       default: throw new Error(`Unknown tool: ${req.params.name}`);
     }
   } catch (err) {