argusqa-os 9.4.0 → 9.4.2

package/README.md

@@ -227,7 +227,7 @@ All network findings carry an `origin` field (`'first-party'` / `'third-party'`)
 
 | Severity | Bug / Issue | Detection Method |
 | --- | --- | --- |
-| 🔴 Critical | > 100 detached DOM nodes in V8 heap — severe leak | `take_memory_snapshot` → parse flat nodes array for "Detached Xxx" names |
+| 🔴 Critical | > 100 detached DOM nodes in V8 heap — severe leak | `take_heapsnapshot` → parse flat nodes array for "Detached Xxx" names |
 | 🟡 Warning | > 10 detached DOM nodes in V8 heap — probable leak | Same snapshot parse, lower threshold |
 | 🟡 Warning | Heap grew > 2 MB after navigate-away + navigate-back — probable per-load leak | `performance.memory.usedJSHeapSize` delta across round-trip (soft — GC-dependent) |
 
@@ -328,7 +328,7 @@ Argus watches your running application and automatically surfaces issues that te
 | **Accessibility Snapshot Analysis** | Calls `take_snapshot` then `evaluate_script`; flags interactive elements missing accessible names, unlabelled form controls, duplicate landmark regions, heading level skips, and `aria-expanded` buttons with missing/broken `aria-controls` |
 | **Keyboard Focus Analysis** | Tab-walks every focusable element (up to 20 steps); detects `focus_visible_missing` (button/link with `outline:0` and no `box-shadow` fallback — keyboard users cannot see where focus is) |
 | **Chrome DevTools Issues Panel** | Queries `list_console_messages({ types: ['issue'] })` for the Issues panel namespace, which is entirely separate from `console.error`; catches CSP violations and deprecated API usage (verified) — additional Chrome-surfaced types (CORS blocks, mixed content, cookie misconfiguration, low-contrast) are classified when present |
-| **Mobile CPU Throttling** | Applies 4× CPU throttle (`emulate_cpu({ throttlingRate: 4 })`) during ≤768px responsive breakpoints — finds layout reflow and animation jank that only manifests under realistic mobile CPU pressure |
+| **Mobile CPU Throttling** | Applies 4× CPU throttle (`emulate({ cpuThrottlingRate: 4 })`) during ≤768px responsive breakpoints — finds layout reflow and animation jank that only manifests under realistic mobile CPU pressure |
 | **Origin-Tagged Network Findings** | All network error and timing findings carry `origin: 'first-party' \| 'third-party'` so operators can triage critical first-party failures without digging through third-party CDN noise |
 | **Historical Baselines** | Saves finding keys after each run; subsequent runs only alert on *new* issues; trend summary in Slack digest |
 | **Flakiness Detection** | Crawls each route twice per run; findings in both runs are confirmed (original severity); findings in only one run are marked flaky (`severity: info`, `:zap: _flaky_` label) |
@@ -972,7 +972,7 @@ argus/
 | CSS analysis | Script injected via `evaluate_script` | Runs in page context so it sees the live computed styles, CSS Modules hashes, and React fiber properties |
 | Responsive viewport | `emulate` (not `resize_page`) | `resize_page` only resizes the browser window and does not update CSS viewport width — `emulate` is the correct API |
 | Viewport width measurement | `document.documentElement.clientWidth` | After `emulate` with mobile flag, `window.innerWidth` returns the legacy layout viewport (~952px), not the device width |
-| V8 heap snapshot | `take_memory_snapshot({ filePath })` → read from disk | The MCP tool writes JSON to disk (not inline); parse with `JSON.parse(fs.readFileSync(filePath))` then delete the temp file |
+| V8 heap snapshot | `take_heapsnapshot({ filePath })` → read from disk | The MCP tool writes JSON to disk (not inline); parse with `JSON.parse(fs.readFileSync(filePath))` then delete the temp file |
 | Detached DOM detection | Walk flat `nodes` array for "Detached " prefix in strings table | Chrome serializes detached elements as "Detached HTMLDivElement" etc.; secondary check on `detachedness === 2` (Chrome 90+) |
 | Baseline finding key | `type::message[:100]::status` | Excludes timestamps and dynamic URL path IDs; message truncated to 100 chars to handle slight wording variations; `::status` suffix only added when non-null |
 | Baseline alert filter | `isNew === true` (strict) | Only findings explicitly marked new by `applyBaseline` are dispatched to Slack — prevents stale re-dispatch if baseline-manager is not called (fails silently rather than spamming) |

package/package.json

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

package/src/adapters/browser.js

@@ -27,7 +27,7 @@ export class CdpBrowserAdapter {
   evaluate(fn)             { return this._mcp.evaluate_script({ function: fn }); }
   snapshot()               { return this._mcp.take_snapshot(); }
   screenshot(opts = {})    { return this._mcp.take_screenshot(opts); }
-  heapSnapshot(opts = {})  { return this._mcp.take_memory_snapshot(opts); }
+  heapSnapshot(opts = {})  { return this._mcp.take_heapsnapshot(opts); }
 
   // ── Interactions ────────────────────────────────────────────────────────────
   // click is intentionally NOT retried — it is not idempotent (submits forms,
@@ -46,7 +46,7 @@ export class CdpBrowserAdapter {
 
   // ── Viewport ────────────────────────────────────────────────────────────────
   emulate(viewport)        { return this._mcp.emulate({ viewport }); }
-  emulateCpu(rate)         { return this._mcp.emulate_cpu({ throttlingRate: rate }); }
+  emulateCpu(rate)         { return this._mcp.emulate({ cpuThrottlingRate: rate }); }
   resize(w, h)             { return this._mcp.resize_page({ width: w, height: h }); }
 
   // ── Network & performance ───────────────────────────────────────────────────

package/src/mcp-server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Argus MCP Server (v9.4.0)
+ * Argus MCP Server (v9.4.2)
  *
  * Exposes Argus as an MCP server so Claude (or any MCP client) can call
  * argus_audit, argus_audit_full, argus_compare, argus_last_report, and
@@ -138,11 +138,23 @@ async function handleAudit({ url, critical = false, cache = false }) {
     return { content: [{ type: 'text', text: JSON.stringify({ ...result, _cached: true, _cachedAt: new Date(ts).toISOString() }, null, 2) }] };
   }
   return withMcp(async (mcp) => {
-    const parsed  = new URL(url);
-    const route   = { path: parsed.pathname + parsed.search + parsed.hash, name: 'audit', critical };
-    const findings = await crawlRouteCheap(route, parsed.origin, mcp);
-    if (cache) cacheAudit(url, findings);
-    return { content: [{ type: 'text', text: JSON.stringify(findings, null, 2) }] };
+    const parsed = new URL(url);
+    const route  = { path: parsed.pathname + parsed.search + parsed.hash, name: 'audit', critical };
+    const raw    = await crawlRouteCheap(route, parsed.origin, mcp);
+    const findings = Array.isArray(raw.errors) ? raw.errors : [];
+    const result = {
+      findings,
+      summary: {
+        critical: findings.filter(f => f.severity === 'critical').length,
+        warning:  findings.filter(f => f.severity === 'warning').length,
+        info:     findings.filter(f => f.severity === 'info').length,
+      },
+      url:        raw.url,
+      pageTitle:  raw.pageTitle,
+      screenshot: raw.screenshot,
+    };
+    if (cache) cacheAudit(url, result);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
   });
 }
 
@@ -271,7 +283,7 @@ async function handleLastReport() {
 // ── Server bootstrap ──────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: 'argus', version: '9.4.0' },
+  { name: 'argus', version: '9.4.2' },
   { capabilities: { tools: {} } },
 );
 

package/src/utils/mcp-client.js

@@ -251,13 +251,12 @@ export async function createMcpClient() {
     performance_start_trace: (args) => tool('performance_start_trace', args),
     performance_stop_trace: (args) => tool('performance_stop_trace', args),
     performance_analyze_insight: (args) => tool('performance_analyze_insight', args),
-    take_memory_snapshot: (args) => tool('take_memory_snapshot', args),
+    take_heapsnapshot: (args) => tool('take_heapsnapshot', args),
     lighthouse_audit: (args) => tool('lighthouse_audit', args),
     handle_dialog: (args) => tool('handle_dialog', args),
     drag: (args) => tool('drag', args),
     upload_file: (args) => tool('upload_file', args),
     select_option: (args) => tool('select_option', args),
-    emulate_cpu: (args) => tool('emulate_cpu', args),
     emulate_network: (args) => tool('emulate_network', args),
     close,
   };

package/src/utils/memory-analyzer.js

@@ -2,7 +2,7 @@
  * ARGUS Memory Analyzer (v3 Phase B1)
  *
  * Two detection surfaces:
- *   1. Detached DOM nodes — via take_memory_snapshot (saves snapshot to disk, parsed here)
+ *   1. Detached DOM nodes — via take_heapsnapshot (saves snapshot to disk, parsed here)
  *      Nodes removed from the live DOM but still referenced in JS are retained
  *      in the V8 heap as "Detached HTMLXxx" objects, causing memory pressure.
  *   2. Heap size growth — via performance.memory across navigate-away + navigate-back
@@ -11,7 +11,7 @@
  * Called as a standalone function after crawlRoute, like analyzeResponsive.
  * The function always leaves the browser navigated to the target URL.
  *
- * Note: take_memory_snapshot requires a filePath argument — it writes the V8
+ * Note: take_heapsnapshot requires a filePath argument — it writes the V8
  * heap snapshot JSON to disk. We read and parse it, then delete the temp file.
  */
 
@@ -115,7 +115,7 @@ async function getHeapSize(browser) {
 
 /**
  * Take a V8 heap snapshot, save it to a temp file, parse it, and delete the file.
- * take_memory_snapshot writes the snapshot JSON to disk (filePath is required).
+ * take_heapsnapshot writes the snapshot JSON to disk (filePath is required).
  *
  * @param {object} browser - CdpBrowserAdapter
  * @returns {Promise<{ detachedNodeCount: number, totalNodeCount: number|null } | null>}
@@ -153,7 +153,7 @@ async function captureAndParseSnapshot(browser) {
  * Analyse a URL for memory leaks.
  *
  * Detection 1 — Detached DOM nodes (hard, deterministic):
- *   Navigate to url → wait → take_memory_snapshot to disk → parse for "Detached Xxx" nodes.
+ *   Navigate to url → wait → take_heapsnapshot to disk → parse for "Detached Xxx" nodes.
  *   Detached nodes are DOM elements removed from the live tree but still referenced
  *   in JS (e.g. stashed in a closure, array, or event handler), preventing GC.
  *