@deeeed/metamask-harness 0.42.0 → 0.43.0

package/library/actions/mobile/platform/bridge.mjs

@@ -8,6 +8,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import bridgeErrors from '../../../../adapters/mobile/bridge-runtime/lib/bridge-errors.cjs';
 import brokerModule from '../../../../adapters/mobile/bridge-runtime/lib/cdp-broker.cjs';
+import configModule from '../../../../adapters/mobile/bridge-runtime/lib/config.cjs';
 import { resolveMobileToolPath } from './tool-paths.mjs';
 
 const {
@@ -18,6 +19,7 @@ const {
   parseErrorMarker,
 } = bridgeErrors;
 const { brokerSocketPath } = brokerModule;
+const { resolvePort } = configModule;
 
 // Re-exported so the TS adapter classifies on the same code constants without a
 // second import path into the cjs bridge-runtime.
@@ -434,6 +436,7 @@ export async function bridgeCommand(input, args) {
   const env = await bridgeEnv(input);
   const brokerSocket = brokerSocketPath(
     path.dirname(resolveBridgeLockPath(input, env)),
+    resolvePort(env, input.context.projectRoot),
   );
   if (adapterActionActive && !existsSync(brokerSocket)) {
     env.CDP_BRIDGE_LOCK_OWNER_PID = await acquireActionBridgeLock(input, env);

package/library/manifests/extension.action-manifest.json

@@ -1207,6 +1207,91 @@
       },
       "execution_capabilities": []
     },
+    "app.performance_capture": {
+      "description": "Capture bounded CDP renderer frame metrics and separately labelled JavaScript work across Recipe Protocol v1 node boundaries.",
+      "examples": [
+        {
+          "action": "app.performance_capture",
+          "phase": "start",
+          "id": "homepage-scroll",
+          "max_duration_ms": 300000,
+          "intent": "Start the bounded UI smoothness window",
+          "next": "exercise-flow"
+        },
+        {
+          "action": "app.performance_capture",
+          "phase": "end",
+          "id": "homepage-scroll",
+          "artifact_path": "performance/homepage-scroll.json",
+          "html_path": "performance/homepage-scroll.html",
+          "intent": "End and index the UI smoothness window",
+          "next": "assert-performance"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "phase": {
+            "type": "string",
+            "enum": ["start", "end"]
+          },
+          "id": { "type": "string" },
+          "max_duration_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum accepted at runtime: 3600000 ms."
+          },
+          "artifact_path": { "type": "string" },
+          "html_path": { "type": "string" }
+        },
+        "required": ["phase", "id"],
+        "additionalProperties": false
+      },
+      "execution_capabilities": ["host-read-export"]
+    },
+    "app.performance_assert": {
+      "description": "Assert a previously indexed app.performance_capture summary without hiding unavailable or partial source coverage.",
+      "examples": [
+        {
+          "action": "app.performance_assert",
+          "id": "homepage-scroll",
+          "artifact_path": "performance/homepage-scroll.json",
+          "required_status": ["complete", "partial"],
+          "minimum_frame_count": 1,
+          "require_native_ui_when_supported": true,
+          "required_node_ids": ["scroll-homepage"],
+          "intent": "Assert the indexed UI smoothness summary",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "artifact_path": { "type": "string" },
+          "required_status": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["complete", "partial", "unavailable"]
+            }
+          },
+          "minimum_frame_count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Minimum MetaMask renderer frame count. JavaScript task count cannot satisfy this assertion."
+          },
+          "require_native_ui_when_supported": { "type": "boolean" },
+          "required_node_ids": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      },
+      "execution_capabilities": ["host-read-export"]
+    },
     "app.status": {
       "description": "Report the adapter's static status — platform, project root, resolved checkout shape, and headless compatibility mode (no live route or account).",
       "examples": [

package/library/manifests/mobile.action-manifest.json

@@ -1219,6 +1219,103 @@
       },
       "execution_capabilities": []
     },
+    "app.performance_capture": {
+      "description": "Capture bounded CDP native UI frame metrics and separately labelled JavaScript work across Recipe Protocol v1 node boundaries.",
+      "examples": [
+        {
+          "action": "app.performance_capture",
+          "phase": "start",
+          "id": "homepage-scroll",
+          "max_duration_ms": 300000,
+          "intent": "Start the bounded UI smoothness window",
+          "next": "exercise-flow"
+        },
+        {
+          "action": "app.performance_capture",
+          "phase": "end",
+          "id": "homepage-scroll",
+          "artifact_path": "performance/homepage-scroll.json",
+          "html_path": "performance/homepage-scroll.html",
+          "intent": "End and index the UI smoothness window",
+          "next": "assert-performance"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "phase": {
+            "type": "string",
+            "enum": ["start", "end"]
+          },
+          "id": {
+            "type": "string"
+          },
+          "max_duration_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum accepted at runtime: 3600000 ms."
+          },
+          "artifact_path": {
+            "type": "string"
+          },
+          "html_path": {
+            "type": "string"
+          }
+        },
+        "required": ["phase", "id"],
+        "additionalProperties": false
+      },
+      "execution_capabilities": ["host-read-export"]
+    },
+    "app.performance_assert": {
+      "description": "Assert a previously indexed app.performance_capture summary without hiding unavailable or partial source coverage.",
+      "examples": [
+        {
+          "action": "app.performance_assert",
+          "id": "homepage-scroll",
+          "artifact_path": "performance/homepage-scroll.json",
+          "required_status": ["complete", "partial"],
+          "minimum_frame_count": 1,
+          "require_native_ui_when_supported": true,
+          "required_node_ids": ["scroll-homepage"],
+          "intent": "Assert the indexed UI smoothness summary",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "artifact_path": {
+            "type": "string"
+          },
+          "required_status": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["complete", "partial", "unavailable"]
+            }
+          },
+          "minimum_frame_count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Minimum native UI frame count. JavaScript task count cannot satisfy this assertion."
+          },
+          "require_native_ui_when_supported": {
+            "type": "boolean"
+          },
+          "required_node_ids": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      },
+      "execution_capabilities": ["host-read-export"]
+    },
     "app.status": {
       "description": "Report the adapter's static status — platform, project root, resolved checkout shape, and headless compatibility mode (no live route or account).",
       "examples": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"

package/scripts/site-contrast.mjs

@@ -272,6 +272,18 @@ function findChrome() {
 }
 
 async function startChrome() {
+  let lastError;
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      return await startChromeOnce();
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError;
+}
+
+async function startChromeOnce() {
   const binary = findChrome();
   const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'site-contrast-'));
   const child = spawn(
@@ -279,6 +291,7 @@ async function startChrome() {
     [
       '--headless=new',
       '--disable-gpu',
+      '--disable-dev-shm-usage',
       '--no-first-run',
       '--no-default-browser-check',
       '--remote-debugging-port=0',
@@ -290,35 +303,38 @@ async function startChrome() {
 
   // Chrome writes the chosen port to DevToolsActivePort once it is listening.
   const portFile = path.join(userDataDir, 'DevToolsActivePort');
-  const port = await waitFor(() => {
-    if (!fs.existsSync(portFile)) return null;
-    const line = fs.readFileSync(portFile, 'utf8').split('\n')[0].trim();
-    return line ? Number(line) : null;
-  }, 15000, 'Chrome did not report a debugging port');
-
-  const version = await getJson(`http://127.0.0.1:${port}/json/version`);
-  return {
-    endpoint: version.webSocketDebuggerUrl,
-    port,
-    close: async () => {
-      child.kill();
-      // Chrome holds the profile dir open until it exits; removing it early
-      // fails with ENOTEMPTY. Wait for exit, and never fail the gate on cleanup.
-      await new Promise((done) => {
-        if (child.exitCode !== null || child.signalCode !== null) return done();
-        const timer = setTimeout(done, 5000);
-        child.once('exit', () => {
-          clearTimeout(timer);
-          done();
-        });
+  const close = async () => {
+    child.kill();
+    // Chrome holds the profile dir open until it exits; removing it early
+    // fails with ENOTEMPTY. Wait for exit, and never fail the gate on cleanup.
+    await new Promise((done) => {
+      if (child.exitCode !== null || child.signalCode !== null) return done();
+      const timer = setTimeout(done, 5000);
+      child.once('exit', () => {
+        clearTimeout(timer);
+        done();
       });
-      try {
-        fs.rmSync(userDataDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
-      } catch {
-        /* a leftover temp profile is not worth failing a contrast run over */
-      }
-    },
+    });
+    try {
+      fs.rmSync(userDataDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
+    } catch {
+      /* a leftover temp profile is not worth failing a contrast run over */
+    }
   };
+
+  try {
+    const port = await waitFor(() => {
+      if (!fs.existsSync(portFile)) return null;
+      const line = fs.readFileSync(portFile, 'utf8').split('\n')[0].trim();
+      return line ? Number(line) : null;
+    }, 15000, 'Chrome did not report a debugging port');
+
+    const version = await getJson(`http://127.0.0.1:${port}/json/version`);
+    return { endpoint: version.webSocketDebuggerUrl, port, close };
+  } catch (error) {
+    await close();
+    throw error;
+  }
 }
 
 async function auditPage(browserEndpoint, url) {