@deeeed/metamask-harness 0.40.0 → 0.41.0

package/package.json

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

package/library/recipes/mobile/perps/performance.background-resume.recipe.json

@@ -1,56 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "MetaMask Mobile Perps performance recipe — background resume",
-  "description": "Measured Perps recipe from a deterministic background-resume state. The graph backgrounds and foregrounds the installed app without rebuilding, unlocks if needed, then records Perps list, state, and BTC detail timings.",
-  "workflow": {
-    "entry": "background-app",
-    "nodes": {
-      "open-perps-list": {
-        "action": "ui.navigate",
-        "page": "perps",
-        "intent": "Open the Perps market list screen",
-        "next": "read-positions"
-      },
-      "read-positions": {
-        "action": "metamask.perps.read_positions",
-        "intent": "Read the live Perps positions shown on the market list",
-        "next": "open-market-detail"
-      },
-      "open-market-detail": {
-        "action": "ui.navigate",
-        "page": "perps-market",
-        "market": "BTC",
-        "intent": "Open the BTC Perps market detail screen",
-        "next": "end"
-      },
-      "end": {
-        "action": "end",
-        "status": "pass"
-      },
-      "start-state": {
-        "action": "app.status",
-        "intent": "Record the stable run start status after background-resume setup",
-        "next": "open-perps-list"
-      },
-      "ensure-unlocked": {
-        "action": "metamask.wallet.ensure_unlocked",
-        "intent": "Unlock the wallet before timing the Perps journey",
-        "next": "start-state"
-      },
-      "foreground-app": {
-        "action": "app.lifecycle",
-        "command": "foreground",
-        "settle_ms": 15000,
-        "intent": "Foreground the installed app through the Expo dev-client deep link",
-        "next": "ensure-unlocked"
-      },
-      "background-app": {
-        "action": "app.lifecycle",
-        "command": "background",
-        "settle_ms": 3000,
-        "intent": "Put the installed app in the background before measuring resume",
-        "next": "foreground-app"
-      }
-    }
-  }
-}

package/library/recipes/mobile/perps/performance.cold-start.recipe.json

@@ -1,56 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "MetaMask Mobile Perps performance recipe — cold process start",
-  "description": "Measured Perps recipe from a deterministic cold-process state. The graph terminates and relaunches the installed app without rebuilding, unlocks if needed, then records Perps list, state, and BTC detail timings.",
-  "workflow": {
-    "entry": "terminate-app",
-    "nodes": {
-      "open-perps-list": {
-        "action": "ui.navigate",
-        "page": "perps",
-        "intent": "Open the Perps market list screen",
-        "next": "read-positions"
-      },
-      "read-positions": {
-        "action": "metamask.perps.read_positions",
-        "intent": "Read the live Perps positions shown on the market list",
-        "next": "open-market-detail"
-      },
-      "open-market-detail": {
-        "action": "ui.navigate",
-        "page": "perps-market",
-        "market": "BTC",
-        "intent": "Open the BTC Perps market detail screen",
-        "next": "end"
-      },
-      "end": {
-        "action": "end",
-        "status": "pass"
-      },
-      "start-state": {
-        "action": "app.status",
-        "intent": "Record the stable run start status after cold-start setup",
-        "next": "open-perps-list"
-      },
-      "ensure-unlocked": {
-        "action": "metamask.wallet.ensure_unlocked",
-        "intent": "Unlock the wallet before timing the Perps journey",
-        "next": "start-state"
-      },
-      "launch-app": {
-        "action": "app.lifecycle",
-        "command": "launch",
-        "settle_ms": 15000,
-        "intent": "Launch the installed app through the Expo dev-client deep link",
-        "next": "ensure-unlocked"
-      },
-      "terminate-app": {
-        "action": "app.lifecycle",
-        "command": "terminate",
-        "settle_ms": 3000,
-        "intent": "Terminate the installed app process before measuring cold start",
-        "next": "launch-app"
-      }
-    }
-  }
-}

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

@@ -1,159 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "Android Homepage Perps reconnect visible performance proof",
-  "description": "Establishes a visible live order on Wallet Home, backgrounds the physical Android app beyond the 20-second connection grace period, restores it, and validates the reconnect-to-fresh-visible pipeline.",
-  "workflow": {
-    "entry": "prepare-open-order",
-    "nodes": {
-      "prepare-open-order": {
-        "action": "metamask.perps.start_state",
-        "profile": "open_order_testnet",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "perps_home",
-        "side": "short",
-        "orders": {
-          "state": "open",
-          "mode": "matching",
-          "market": "ETH",
-          "side": "short",
-          "notional": 10,
-          "leverage": 2,
-          "timeout_ms": 90000
-        },
-        "positions": false,
-        "intent": "Prepare a deterministic live order before the reconnect proof",
-        "timeout_ms": 120000,
-        "next": "open-wallet-home"
-      },
-      "open-wallet-home": {
-        "action": "ui.navigate",
-        "page": "home",
-        "intent": "Open Wallet Home before the connection expires",
-        "timeout_ms": 30000,
-        "next": "wait-content-mounted"
-      },
-      "wait-content-mounted": {
-        "action": "ui.wait_for",
-        "test_id": "homepage-perps-positions",
-        "expected": "present",
-        "intent": "Confirm the data-backed Homepage section is rendered",
-        "timeout_ms": 30000,
-        "next": "show-content"
-      },
-      "show-content": {
-        "action": "ui.scroll",
-        "test_id": "homepage-perps-positions",
-        "scroll_into_view": true,
-        "animated": true,
-        "settle": true,
-        "intent": "Make the live order reviewable before disconnecting",
-        "timeout_ms": 30000,
-        "next": "wait-order-before"
-      },
-      "wait-order-before": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "visible",
-        "intent": "Prove the same live order is visible before reconnect",
-        "timeout_ms": 30000,
-        "next": "start-performance-capture"
-      },
-      "start-performance-capture": {
-        "action": "metamask.perps.capture_performance",
-        "phase": "start",
-        "intent": "Start the evidence window immediately before the long background interval",
-        "next": "background-app"
-      },
-      "background-app": {
-        "action": "app.lifecycle",
-        "command": "background",
-        "settle_ms": 25000,
-        "intent": "Keep the app inactive beyond the connection grace period",
-        "next": "foreground-app"
-      },
-      "foreground-app": {
-        "action": "app.lifecycle",
-        "command": "foreground",
-        "settle_ms": 15000,
-        "intent": "Restore the installed app and allow stream recovery",
-        "next": "wait-content-after"
-      },
-      "wait-content-after": {
-        "action": "ui.wait_for",
-        "test_id": "homepage-perps-positions",
-        "expected": "present",
-        "intent": "Confirm the Homepage Perps state remains rendered after reconnect",
-        "timeout_ms": 30000,
-        "next": "show-content-after"
-      },
-      "show-content-after": {
-        "action": "ui.scroll",
-        "test_id": "homepage-perps-positions",
-        "scroll_into_view": true,
-        "animated": true,
-        "settle": true,
-        "intent": "Make the recovered data directly reviewable",
-        "timeout_ms": 30000,
-        "next": "wait-order-after"
-      },
-      "wait-order-after": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "visible",
-        "intent": "Prove the live order is displayed after stream recovery",
-        "timeout_ms": 30000,
-        "next": "capture-after"
-      },
-      "capture-after": {
-        "action": "ui.screenshot",
-        "path": "screenshots/homepage-order-after-reconnect.png",
-        "intent": "Preserve reviewer-visible reconnect proof",
-        "next": "settle-frame"
-      },
-      "settle-frame": {
-        "action": "wait",
-        "duration_ms": 2500,
-        "intent": "Allow the fresh visible frame checkpoint to finish",
-        "next": "finish-performance-capture"
-      },
-      "finish-performance-capture": {
-        "action": "metamask.perps.capture_performance",
-        "phase": "end",
-        "required_stages": [
-          "viewport_demand",
-          "socket_received",
-          "react_commit",
-          "next_frame_checkpoint"
-        ],
-        "required_lifecycles": ["background_reconnect"],
-        "required_sources": ["resident_state", "fresh_socket"],
-        "required_fresh_content_variants": ["orders"],
-        "intent": "Preserve and validate the reconnect measurement cohort",
-        "next": "cleanup-order"
-      },
-      "cleanup-order": {
-        "action": "metamask.perps.teardown_state",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "home",
-        "positions": false,
-        "orders": {
-          "state": "none",
-          "mode": "matching",
-          "market": "ETH",
-          "timeout_ms": 60000
-        },
-        "intent": "Cancel the deterministic testnet order after evidence capture",
-        "timeout_ms": 90000,
-        "next": "done"
-      },
-      "done": {
-        "action": "end",
-        "status": "pass"
-      }
-    }
-  }
-}

package/library/recipes/mobile/perps/performance.homepage.android-background-short.recipe.json

@@ -1,157 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "Android Homepage Perps short-background visible performance proof",
-  "description": "Establishes a visible live order on Wallet Home, backgrounds the physical Android app for less than the 20-second reconnect threshold, restores it, and correlates the resumed frame with run-scoped performance evidence.",
-  "workflow": {
-    "entry": "prepare-open-order",
-    "nodes": {
-      "prepare-open-order": {
-        "action": "metamask.perps.start_state",
-        "profile": "open_order_testnet",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "perps_home",
-        "side": "short",
-        "orders": {
-          "state": "open",
-          "mode": "matching",
-          "market": "ETH",
-          "side": "short",
-          "notional": 10,
-          "leverage": 2,
-          "timeout_ms": 90000
-        },
-        "positions": false,
-        "intent": "Prepare a deterministic live order before the lifecycle proof",
-        "timeout_ms": 120000,
-        "next": "open-wallet-home"
-      },
-      "open-wallet-home": {
-        "action": "ui.navigate",
-        "page": "home",
-        "intent": "Open Wallet Home before the lifecycle transition",
-        "timeout_ms": 30000,
-        "next": "wait-content-mounted"
-      },
-      "wait-content-mounted": {
-        "action": "ui.wait_for",
-        "test_id": "homepage-perps-positions",
-        "expected": "present",
-        "intent": "Confirm the data-backed Homepage section is rendered",
-        "timeout_ms": 30000,
-        "next": "show-content"
-      },
-      "show-content": {
-        "action": "ui.scroll",
-        "test_id": "homepage-perps-positions",
-        "scroll_into_view": true,
-        "animated": true,
-        "settle": true,
-        "intent": "Make the order card available before the app leaves the foreground",
-        "timeout_ms": 30000,
-        "next": "wait-order-before"
-      },
-      "wait-order-before": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "visible",
-        "intent": "Prove the same live order is visible before the lifecycle transition",
-        "timeout_ms": 30000,
-        "next": "start-performance-capture"
-      },
-      "start-performance-capture": {
-        "action": "metamask.perps.capture_performance",
-        "phase": "start",
-        "intent": "Start the evidence window immediately before backgrounding",
-        "next": "background-app"
-      },
-      "background-app": {
-        "action": "app.lifecycle",
-        "command": "background",
-        "settle_ms": 3000,
-        "intent": "Leave the app inactive for less than the reconnect grace period",
-        "next": "foreground-app"
-      },
-      "foreground-app": {
-        "action": "app.lifecycle",
-        "command": "foreground",
-        "settle_ms": 10000,
-        "intent": "Restore the same installed app and wallet session",
-        "next": "wait-content-after"
-      },
-      "wait-content-after": {
-        "action": "ui.wait_for",
-        "test_id": "homepage-perps-positions",
-        "expected": "present",
-        "intent": "Confirm the Homepage Perps state survived the short background interval",
-        "timeout_ms": 30000,
-        "next": "show-content-after"
-      },
-      "show-content-after": {
-        "action": "ui.scroll",
-        "test_id": "homepage-perps-positions",
-        "scroll_into_view": true,
-        "animated": true,
-        "settle": true,
-        "intent": "Make the restored data directly reviewable after foregrounding",
-        "timeout_ms": 30000,
-        "next": "wait-order-after"
-      },
-      "wait-order-after": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "visible",
-        "intent": "Prove the live order remains displayed after the short resume",
-        "timeout_ms": 30000,
-        "next": "capture-after"
-      },
-      "capture-after": {
-        "action": "ui.screenshot",
-        "path": "screenshots/homepage-order-after-short-background.png",
-        "intent": "Preserve reviewer-visible short-resume proof",
-        "next": "settle-frame"
-      },
-      "settle-frame": {
-        "action": "wait",
-        "duration_ms": 2500,
-        "intent": "Allow the visible frame checkpoint to finish",
-        "next": "finish-performance-capture"
-      },
-      "finish-performance-capture": {
-        "action": "metamask.perps.capture_performance",
-        "phase": "end",
-        "required_stages": [
-          "viewport_demand",
-          "react_commit",
-          "next_frame_checkpoint"
-        ],
-        "required_lifecycles": ["background_short"],
-        "required_sources": ["resident_state", "fresh_socket"],
-        "intent": "Preserve and validate the short-background measurement cohort",
-        "next": "cleanup-order"
-      },
-      "cleanup-order": {
-        "action": "metamask.perps.teardown_state",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "home",
-        "positions": false,
-        "orders": {
-          "state": "none",
-          "mode": "matching",
-          "market": "ETH",
-          "timeout_ms": 60000
-        },
-        "intent": "Cancel the deterministic testnet order after evidence capture",
-        "timeout_ms": 90000,
-        "next": "done"
-      },
-      "done": {
-        "action": "end",
-        "status": "pass"
-      }
-    }
-  }
-}

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

@@ -1,165 +0,0 @@
-{
-  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "Android Homepage Perps cold disk-cache visible performance proof",
-  "description": "Creates a deterministic visible order, restarts the Android process without clearing app data, and validates disk-cache-to-fresh visible content after cold launch.",
-  "workflow": {
-    "entry": "prepare-open-order",
-    "nodes": {
-      "prepare-open-order": {
-        "action": "metamask.perps.start_state",
-        "profile": "open_order_testnet",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "perps_home",
-        "side": "short",
-        "orders": {
-          "state": "open",
-          "mode": "matching",
-          "market": "ETH",
-          "side": "short",
-          "notional": 10,
-          "leverage": 2,
-          "timeout_ms": 90000
-        },
-        "positions": false,
-        "intent": "Prepare a persisted live order before cold process launch",
-        "timeout_ms": 120000,
-        "next": "open-wallet-home"
-      },
-      "open-wallet-home": {
-        "action": "ui.navigate",
-        "page": "home",
-        "intent": "Open Wallet Home so the Perps disk cache is current",
-        "timeout_ms": 30000,
-        "next": "wait-order-before"
-      },
-      "wait-order-before": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "present",
-        "intent": "Prove the persisted order exists before restart",
-        "timeout_ms": 30000,
-        "next": "start-performance-capture"
-      },
-      "start-performance-capture": {
-        "action": "metamask.perps.capture_performance",
-        "phase": "start",
-        "intent": "Start the evidence window before the process restart",
-        "next": "restart-app"
-      },
-      "restart-app": {
-        "action": "app.lifecycle",
-        "command": "restart",
-        "settle_ms": 15000,
-        "intent": "Cold-restart the app while preserving persisted app data",
-        "next": "unlock-after-restart"
-      },
-      "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"
-      },
-      "open-wallet-home-after": {
-        "action": "ui.navigate",
-        "page": "home",
-        "intent": "Return to Wallet Home after unlocking the cold-started process",
-        "timeout_ms": 30000,
-        "next": "wait-content-after"
-      },
-      "wait-content-after": {
-        "action": "ui.wait_for",
-        "test_id": "homepage-perps-positions",
-        "expected": "present",
-        "intent": "Confirm Wallet Home restores data-backed Perps content after cold launch",
-        "timeout_ms": 30000,
-        "next": "show-content-after"
-      },
-      "show-content-after": {
-        "action": "ui.scroll",
-        "test_id": "homepage-perps-positions",
-        "scroll_into_view": true,
-        "animated": true,
-        "settle": true,
-        "intent": "Bring the cold-start Perps content into the viewport",
-        "timeout_ms": 30000,
-        "next": "wait-order-after"
-      },
-      "wait-order-after": {
-        "action": "ui.wait_for",
-        "text": "Limit short",
-        "expected": "visible",
-        "intent": "Prove the same live order is visible after cold launch",
-        "timeout_ms": 30000,
-        "next": "capture-after"
-      },
-      "capture-after": {
-        "action": "ui.screenshot",
-        "path": "screenshots/homepage-order-after-cold-start.png",
-        "intent": "Preserve reviewer-visible cold-start proof",
-        "next": "settle-frame"
-      },
-      "settle-frame": {
-        "action": "wait",
-        "duration_ms": 2500,
-        "intent": "Allow the fresh visible frame checkpoint to finish",
-        "next": "finish-performance-capture"
-      },
-      "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": ["fresh_socket"],
-        "required_fresh_content_variants": ["orders"],
-        "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": {
-        "action": "metamask.perps.teardown_state",
-        "provider": "hyperliquid",
-        "network": "testnet",
-        "market": "ETH",
-        "page": "home",
-        "positions": false,
-        "orders": {
-          "state": "none",
-          "mode": "matching",
-          "market": "ETH",
-          "timeout_ms": 60000
-        },
-        "intent": "Cancel the deterministic testnet order after evidence capture",
-        "timeout_ms": 90000,
-        "next": "done"
-      },
-      "done": {
-        "action": "end",
-        "status": "pass"
-      }
-    }
-  }
-}