@deeeed/metamask-harness 0.34.0 → 0.34.2

package/library/recipes/mobile/perps/performance.homepage.android-cold-disk-cache.recipe.json

@@ -57,6 +57,8 @@
       },
       "unlock-after-restart": {
         "action": "metamask.wallet.ensure_unlocked",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 90000,
         "intent": "Restore the fixture wallet after the cold process launch",
         "next": "open-wallet-home-after"
       },
@@ -108,17 +110,33 @@
       "finish-performance-capture": {
         "action": "metamask.perps.capture_performance",
         "phase": "end",
+        "artifact_prefix": "logs/homepage-order-cold-disk-cache",
         "required_stages": [
           "disk_cache_hydrated",
           "viewport_demand",
           "socket_received",
+          "subscriber_delivery",
           "react_commit",
           "next_frame_checkpoint"
         ],
         "required_lifecycles": ["cold_disk_cache"],
-        "required_sources": ["disk_cache", "fresh_socket"],
+        "required_sources": ["fresh_socket"],
         "required_fresh_content_variants": ["orders"],
-        "intent": "Preserve and validate the cold disk-cache measurement cohort",
+        "first_fresh_delivery_requirements": [
+          {
+            "stream": "positions",
+            "lifecycle": "cold_disk_cache",
+            "subscriber_throttle_ms": 5000,
+            "max_socket_to_subscriber_ms": 1000
+          },
+          {
+            "stream": "orders",
+            "lifecycle": "cold_disk_cache",
+            "subscriber_throttle_ms": 5000,
+            "max_socket_to_subscriber_ms": 1000
+          }
+        ],
+        "intent": "Require cache hydration, fresh visible order content, and immediate first-fresh positions/orders delivery",
         "next": "cleanup-order"
       },
       "cleanup-order": {

package/library/recipes/mobile/perps/performance.homepage.android-cold-no-cache.recipe.json

@@ -48,6 +48,8 @@
       },
       "unlock-wallet": {
         "action": "metamask.wallet.ensure_unlocked",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 90000,
         "intent": "Unlock the fixture wallet after the cold process launch",
         "next": "open-wallet-home"
       },

package/library/recipes/mobile/perps/performance.homepage.cold-position-sample.recipe.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Homepage Perps cold no-cache position sample",
+  "description": "Clears only persisted Perps performance caches, reproduces a process-cold Homepage position, and measures production-like Perps timing from the first usable Wallet Home frame with the device performance clock. Metro, splash, bridge readiness, unlock, and recipe orchestration are excluded from the Perps metric.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "description": "Existing fixture account that owns the position."
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC",
+        "description": "Exact visible position market symbol."
+      },
+      "sample_id": {
+        "type": "string",
+        "default": "sample",
+        "description": "Artifact-local sample identifier."
+      },
+      "snapshot_port": {
+        "type": "number",
+        "default": 3000,
+        "description": "Host port for the explicitly configured local Terminal global snapshot endpoint."
+      }
+    },
+    "required": ["account"]
+  },
+  "workflow": {
+    "entry": "ensure-wallet",
+    "nodes": {
+      "ensure-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 180000,
+        "intent": "Reuse the existing unlocked fixture wallet without replacing it",
+        "next": "select-account"
+      },
+      "select-account": {
+        "action": "metamask.wallet.select_account",
+        "name": "{{params.account}}",
+        "cdp_timeout_ms": 30000,
+        "intent": "Pin the device-owned fixture account before the measured cold restart",
+        "next": "assert-position"
+      },
+      "assert-position": {
+        "action": "metamask.perps.assert_positions",
+        "market": "{{params.market}}",
+        "state": "open",
+        "timeout_ms": 30000,
+        "intent": "Prove the real position exists before process termination",
+        "next": "open-wallet-home"
+      },
+      "open-wallet-home": {
+        "action": "ui.navigate",
+        "page": "home",
+        "timeout_ms": 30000,
+        "intent": "Persist Wallet Home as the route restored by the cold launch",
+        "next": "clear-perps-caches"
+      },
+      "clear-perps-caches": {
+        "action": "metamask.perps.clear_performance_caches",
+        "intent": "Remove only persisted Perps market and user snapshots before the measured cold launch",
+        "next": "prepare-local-snapshot-endpoint"
+      },
+      "prepare-local-snapshot-endpoint": {
+        "action": "metamask.perps.prepare_local_snapshot_endpoint",
+        "port": "{{params.snapshot_port}}",
+        "intent": "Make the configured local Terminal v2 endpoint reachable on physical Android without an external command node",
+        "next": "cold-restart"
+      },
+      "cold-restart": {
+        "action": "app.lifecycle",
+        "command": "restart",
+        "settle_ms": 0,
+        "runtime_ready_timeout_ms": 90000,
+        "timeout_ms": 120000,
+        "intent": "Create a process-cold app state without rebuilding or resetting wallet state; this node is setup and is not part of the Perps metric",
+        "next": "measure-visible-perps"
+      },
+      "measure-visible-perps": {
+        "action": "metamask.perps.measure_homepage_visible",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 180000,
+        "scroll_test_id": "wallet-screen",
+        "from_test_id": "wallet-screen",
+        "offset": 600,
+        "poll_interval_ms": 1000,
+        "visible_event_stage": "first_visible_recorded",
+        "visible_event_grace_ms": 1500,
+        "animated": true,
+        "target_test_id": "homepage-section-title-perps",
+        "required_present_test_id": "perps-position-row-{{params.market}}",
+        "timeout_ms": 30000,
+        "intent": "Confirm the restored wallet is usable and immediately measure the direct-CDP transition to visible Perps position content without returning control to the recipe runner",
+        "next": "wait-position"
+      },
+      "wait-position": {
+        "action": "ui.wait_for",
+        "test_id": "perps-position-row-{{params.market}}",
+        "expected": "present",
+        "timeout_ms": 60000,
+        "intent": "Prove the real market position row remains rendered after the measured Perps transition",
+        "next": "capture-position"
+      },
+      "capture-position": {
+        "action": "ui.screenshot",
+        "path": "screenshots/cold-position-{{params.sample_id}}.png",
+        "intent": "Preserve native proof that meaningful Perps content is visibly rendered after the fixed viewport demand",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/performance.homepage.ios-background-reconnect.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "iOS Homepage Perps long-background reconnect proof",
-  "description": "Keeps the existing no-order simulator fixture, backgrounds longer than the connection grace period, then validates resident-to-fresh trending content at the visible Homepage endpoint.",
+  "description": "Keeps the existing simulator wallet and position, backgrounds longer than the connection grace period, then validates resident-to-fresh position content at the visible Homepage endpoint.",
   "workflow": {
     "entry": "ensure-wallet",
     "nodes": {
@@ -19,7 +19,7 @@
       },
       "wait-perps-before": {
         "action": "ui.wait_for",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "expected": "present",
         "intent": "Require the Perps section before backgrounding",
         "timeout_ms": 30000,
@@ -27,7 +27,7 @@
       },
       "show-perps-before": {
         "action": "ui.scroll",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "scroll_into_view": true,
         "animated": true,
         "settle": true,
@@ -53,12 +53,13 @@
         "command": "foreground",
         "settle_ms": 10000,
         "runtime_ready_timeout_ms": 60000,
+        "require_process_continuity": true,
         "intent": "Restore the same process and require a reconnect",
         "next": "wait-perps-after"
       },
       "wait-perps-after": {
         "action": "ui.wait_for",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "expected": "present",
         "intent": "Confirm the Perps section remains available after reconnect",
         "timeout_ms": 30000,
@@ -66,7 +67,7 @@
       },
       "show-perps-after": {
         "action": "ui.scroll",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "scroll_into_view": true,
         "animated": true,
         "settle": true,
@@ -97,7 +98,7 @@
         ],
         "required_lifecycles": ["background_reconnect"],
         "required_sources": ["resident_state", "fresh_socket"],
-        "required_fresh_content_variants": ["trending"],
+        "required_fresh_content_variants": ["positions"],
         "intent": "Require the long-background visible reconnect cohort",
         "next": "done"
       },

package/library/recipes/mobile/perps/performance.homepage.ios-cold-no-cache.recipe.json

@@ -43,15 +43,15 @@
       },
       "wait-perps-section": {
         "action": "ui.wait_for",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "expected": "present",
-        "intent": "Require the Perps section after cold launch",
+        "intent": "Require the selected account's Perps position after cold launch",
         "timeout_ms": 30000,
         "next": "show-perps-section"
       },
       "show-perps-section": {
         "action": "ui.scroll",
-        "test_id": "homepage-section-title-perps",
+        "test_id": "homepage-perps-positions",
         "scroll_into_view": true,
         "animated": true,
         "settle": true,
@@ -82,8 +82,8 @@
         ],
         "required_lifecycles": ["cold_no_cache"],
         "required_sources": ["fresh_socket"],
-        "required_fresh_content_variants": ["trending"],
-        "intent": "Require cold-no-cache lifecycle and fresh visible trending content",
+        "required_fresh_content_variants": ["positions"],
+        "intent": "Require cold-no-cache lifecycle and the fresh visible position",
         "next": "done"
       },
       "done": {

package/package.json

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

package/adapters/mobile/metro-config.cjs

@@ -1,93 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const { createRequire } = require('node:module');
-const path = require('node:path');
-const { pathToFileURL } = require('node:url');
-
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function appendBlockList(blockList, pattern) {
-  if (Array.isArray(blockList)) return [...blockList, pattern];
-  return blockList instanceof RegExp ? [blockList, pattern] : [pattern];
-}
-
-function blockListFlags(blockList) {
-  const first = Array.isArray(blockList) ? blockList[0] : blockList;
-  return first instanceof RegExp ? first.flags : '';
-}
-
-function resolveExpoConfigLoader(projectRoot) {
-  const requireFromProject = createRequire(path.join(projectRoot, 'package.json'));
-  let requireUtilsPath;
-  try {
-    requireUtilsPath = requireFromProject.resolve('@expo/require-utils');
-  } catch (error) {
-    if (error?.code !== 'MODULE_NOT_FOUND') throw error;
-    return null;
-  }
-  const { loadModuleSync } = requireFromProject(requireUtilsPath);
-  return typeof loadModuleSync === 'function' ? loadModuleSync : null;
-}
-
-async function loadProductConfig(configPath, baseConfig, projectRoot) {
-  let loaded;
-  const expoConfigLoader = resolveExpoConfigLoader(projectRoot);
-  if (expoConfigLoader) {
-    loaded = expoConfigLoader(configPath);
-  } else {
-    try {
-      loaded = require(configPath);
-    } catch (error) {
-      if (error?.code !== 'ERR_REQUIRE_ESM') throw error;
-      loaded = await import(pathToFileURL(configPath).href);
-    }
-  }
-
-  const moduleValue = await loaded;
-  const exported =
-    moduleValue?.__esModule ||
-    moduleValue?.[Symbol.toStringTag] === 'Module'
-      ? moduleValue.default
-      : moduleValue;
-  const config = await exported;
-  return typeof config === 'function' ? config(baseConfig) : config;
-}
-
-module.exports = async function harnessMetroConfig(baseConfig) {
-  const projectRoot = path.resolve(
-    process.env.MM_HARNESS_METRO_PROJECT_ROOT || process.cwd(),
-  );
-  const productConfigPath = path.resolve(
-    process.env.MM_HARNESS_METRO_BASE_CONFIG ||
-      path.join(projectRoot, 'metro.config.js'),
-  );
-  let productConfig = baseConfig;
-  if (fs.existsSync(productConfigPath)) {
-    productConfig = await loadProductConfig(
-      productConfigPath,
-      baseConfig,
-      projectRoot,
-    );
-  }
-
-  const tempRoot = path.join(projectRoot, 'temp');
-  const existingBlockList =
-    productConfig.resolver?.blockList ?? baseConfig.resolver?.blockList;
-  const tempPattern = new RegExp(
-    `^${escapeRegExp(tempRoot)}(?:${escapeRegExp(path.sep)}|$)`,
-    blockListFlags(existingBlockList),
-  );
-  return {
-    ...productConfig,
-    resolver: {
-      ...productConfig.resolver,
-      blockList: appendBlockList(
-        existingBlockList,
-        tempPattern,
-      ),
-    },
-  };
-};