@deeeed/metamask-harness 0.10.0 → 0.12.0

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

@@ -0,0 +1,72 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask Mobile Perps performance flow - cold process start",
+  "description": "Measured Perps flow from a deterministic cold-process start state. Setup force-stops/terminates the installed app, relaunches it through the Expo dev-client deep link without rebuilding, and unlocks if needed. startState records the stable status. The measured workflow is only Perps list -> state -> BTC detail.",
+  "startState": {
+    "action": "app.status",
+    "intent": "Record the stable run start status after cold-start setup",
+    "detail": "Read-only start-state marker after lifecycle and wallet setup have completed."
+  },
+  "validate": {
+    "workflow": {
+      "setup": [
+        {
+          "id": "terminate-app",
+          "action": "app.lifecycle",
+          "command": "terminate",
+          "settle_ms": 3000,
+          "intent": "Terminate the installed app process before measuring cold start",
+          "detail": "Uses adb force-stop on Android or simctl terminate on iOS simulator; it does not uninstall or rebuild."
+        },
+        {
+          "id": "launch-app",
+          "action": "app.lifecycle",
+          "command": "launch",
+          "settle_ms": 15000,
+          "intent": "Launch the installed app through the Expo dev-client deep link",
+          "detail": "Uses the selected device, Metro port, and installed package; it does not rebuild."
+        },
+        {
+          "id": "ensure-unlocked",
+          "action": "metamask.wallet.ensure_unlocked",
+          "intent": "Unlock the wallet before timing the Perps journey",
+          "detail": "Unlock only if the app is currently locked so the first measured node starts from a stable, signed-in state."
+        }
+      ],
+      "entry": "open-perps-list",
+      "nodes": {
+        "open-perps-list": {
+          "action": "ui.navigate",
+          "page": "perps",
+          "intent": "Open the Perps market list screen",
+          "detail": "Navigate to the Perps markets list via the stable page alias; its node duration measures market-list render time.",
+          "flow": "perps",
+          "next": "read-positions"
+        },
+        "read-positions": {
+          "action": "metamask.perps.read_positions",
+          "intent": "Read the live Perps positions shown on the market list",
+          "detail": "Read live Perps positions through the controller; its node duration measures how long live account state takes to resolve.",
+          "flow": "perps",
+          "next": "open-market-detail"
+        },
+        "open-market-detail": {
+          "action": "ui.navigate",
+          "page": "perps-market",
+          "market": "BTC",
+          "intent": "Open the BTC Perps market detail screen",
+          "detail": "Navigate to the BTC market detail via the stable page alias; its node duration measures market-detail render time.",
+          "flow": "perps",
+          "next": "end"
+        },
+        "end": {
+          "action": "end",
+          "status": "pass",
+          "intent": "Finish the cold-start Perps performance flow",
+          "detail": "Terminal node; trace.json holds setup plus measured Perps node durations.",
+          "flow": "complete"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,64 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask Mobile Perps performance flow - warm foreground start",
+  "description": "Measured Perps flow from a deterministic warm-foreground start state. Setup foregrounds the already installed app through the Expo dev-client deep link without rebuilding and unlocks if needed. startState records the stable status. The measured workflow is only Perps list -> state -> BTC detail.",
+  "startState": {
+    "action": "app.status",
+    "intent": "Record the stable run start status after warm foreground setup",
+    "detail": "Read-only start-state marker after lifecycle and wallet setup have completed."
+  },
+  "validate": {
+    "workflow": {
+      "setup": [
+        {
+          "id": "foreground-app",
+          "action": "app.lifecycle",
+          "command": "foreground",
+          "settle_ms": 10000,
+          "intent": "Foreground the installed app through the Expo dev-client deep link",
+          "detail": "Uses the selected device, Metro port, and installed package; it does not rebuild."
+        },
+        {
+          "id": "ensure-unlocked",
+          "action": "metamask.wallet.ensure_unlocked",
+          "intent": "Unlock the wallet before timing the Perps journey",
+          "detail": "Unlock only if the app is currently locked so the first measured node starts from a stable, signed-in state."
+        }
+      ],
+      "entry": "open-perps-list",
+      "nodes": {
+        "open-perps-list": {
+          "action": "ui.navigate",
+          "page": "perps",
+          "intent": "Open the Perps market list screen",
+          "detail": "Navigate to the Perps markets list via the stable page alias; its node duration measures market-list render time.",
+          "flow": "perps",
+          "next": "read-positions"
+        },
+        "read-positions": {
+          "action": "metamask.perps.read_positions",
+          "intent": "Read the live Perps positions shown on the market list",
+          "detail": "Read live Perps positions through the controller; its node duration measures how long live account state takes to resolve.",
+          "flow": "perps",
+          "next": "open-market-detail"
+        },
+        "open-market-detail": {
+          "action": "ui.navigate",
+          "page": "perps-market",
+          "market": "BTC",
+          "intent": "Open the BTC Perps market detail screen",
+          "detail": "Navigate to the BTC market detail via the stable page alias; its node duration measures market-detail render time.",
+          "flow": "perps",
+          "next": "end"
+        },
+        "end": {
+          "action": "end",
+          "status": "pass",
+          "intent": "Finish the warm-start Perps performance flow",
+          "detail": "Terminal node; trace.json holds setup plus measured Perps node durations.",
+          "flow": "complete"
+        }
+      }
+    }
+  }
+}

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

@@ -1,18 +1,24 @@
 {
   "schema_version": 1,
   "title": "MetaMask Mobile Perps performance flow",
-  "description": "Canonical measured flow for MetaMask Mobile Perps: unlock, open the Perps market list, read live state, and open a market's detail — one node per user-visible step so operators can diff per-node durations across runs. Timings live in trace.json as each node's duration; there is no built-in benchmark verb. Run pinned so numbers are comparable: `mm-harness run perps-performance --device <serial> --heal off`. Optional testnet order placement is intentionally omitted: the recipe DSL has no cheap skippable/conditional node, so a live order would make the flow destructive and non-repeatable; add metamask.perps.place_order + close in a personal copy when you want to measure the trade path.",
+  "description": "Canonical measured flow for MetaMask Mobile Perps: setup unlocks the wallet, startState records the stable status, then the measured workflow opens the Perps market list, reads live state, and opens a market detail. Timings live in trace.json as each node's duration; there is no built-in benchmark verb. Run pinned so numbers are comparable: `mm-harness run perps-performance --device <serial> --heal off`. Optional testnet order placement is intentionally omitted because a live order would make the flow destructive and non-repeatable; add metamask.perps.place_order + close in a personal copy when you want to measure the trade path.",
+  "startState": {
+    "action": "app.status",
+    "intent": "Record the stable run start status after wallet setup",
+    "detail": "Read-only start-state marker so every trace states the adapter, checkout shape, and runner compatibility before measured Perps actions."
+  },
   "validate": {
     "workflow": {
-      "entry": "ensure-unlocked",
-      "nodes": {
-        "ensure-unlocked": {
+      "setup": [
+        {
+          "id": "ensure-unlocked",
           "action": "metamask.wallet.ensure_unlocked",
           "intent": "Unlock the wallet before timing the Perps journey",
-          "detail": "Unlock only if the app is currently locked so the first measured node starts from a stable, signed-in state.",
-          "flow": "setup",
-          "next": "open-perps-list"
-        },
+          "detail": "Unlock only if the app is currently locked so the first measured node starts from a stable, signed-in state."
+        }
+      ],
+      "entry": "open-perps-list",
+      "nodes": {
         "open-perps-list": {
           "action": "ui.navigate",
           "page": "perps",
@@ -41,7 +47,7 @@
           "action": "end",
           "status": "pass",
           "intent": "Finish the measured Perps performance flow",
-          "detail": "Terminal node; the passing run's trace.json holds the per-node durations to diff across runs.",
+          "detail": "Terminal node; the passing run's trace.json holds the setup, startState, and measured per-node durations to diff across runs.",
           "flow": "complete"
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -18,7 +18,7 @@
   "dependencies": {
     "@farmslot/agent-runtime": "^0.1.0",
     "@farmslot/protocol": "^0.7.3",
-    "@farmslot/recipe-harness": "^0.3.3",
+    "@farmslot/recipe-harness": "^0.4.0",
     "commander": "^12.0.0",
     "viem": "^2.54.3"
   },
@@ -69,4 +69,4 @@
     "url": "https://github.com/MetaMask/experimental-metamask-harness/issues"
   },
   "homepage": "https://github.com/MetaMask/experimental-metamask-harness#readme"
-}
+}