@deeeed/metamask-harness 0.18.0 → 0.19.0

package/library/recipes/perps/order-lifecycle.core.recipe.json

@@ -1,77 +1,81 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask core headless Perps order lifecycle",
   "description": "Proves the headless `core` adapter places and cancels a REAL resting Perps LIMIT order on HyperLiquid testnet through the full signing path: a default viem signer backs the perps controller's wallet adapter, the active HyperLiquid testnet provider is initialized, a BTC limit BUY 30% below mid is placed (does not fill — rests on the book), asserted open, then canceled and asserted gone. Leaves the account FLAT — no open orders and no open positions. No CDP, bridge, or UI.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "start_flat",
-          "intent": "Resolve the core checkout and report headless compatibility mode"
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "start_flat",
+        "intent": "Resolve the core checkout and report headless compatibility mode"
+      },
+      "start_flat": {
+        "action": "metamask.perps.start_state",
+        "market": "BTC",
+        "positions": {
+          "state": "none"
         },
-        "start_flat": {
-          "action": "metamask.perps.start_state",
-          "market": "BTC",
-          "positions": { "state": "none" },
-          "orders": { "state": "none" },
-          "network": "testnet",
-          "timeout_ms": 45000,
-          "next": "place_order",
-          "intent": "Converge BTC testnet baseline to flat (no positions, no orders) before the proof window"
+        "orders": {
+          "state": "none"
         },
-        "place_order": {
-          "action": "metamask.perps.place_order",
-          "market": "BTC",
-          "side": "long",
-          "order_type": "limit",
-          "offset_pct": -30,
-          "notional": "11",
-          "leverage": 2,
-          "network": "testnet",
-          "timeout_ms": 45000,
-          "next": "assert_open",
-          "intent": "Place a resting BTC limit BUY 30% below mid via the headless controller (real signed limit order to HL testnet; does not fill)"
+        "network": "testnet",
+        "timeout_ms": 45000,
+        "next": "place_order",
+        "intent": "Converge BTC testnet baseline to flat (no positions, no orders) before the proof window"
+      },
+      "place_order": {
+        "action": "metamask.perps.place_order",
+        "market": "BTC",
+        "side": "long",
+        "order_type": "limit",
+        "offset_pct": -30,
+        "notional": "11",
+        "leverage": 2,
+        "timeout_ms": 45000,
+        "next": "assert_open",
+        "intent": "Place a resting BTC limit BUY 30% below mid via the headless controller (real signed limit order to HL testnet; does not fill)"
+      },
+      "assert_open": {
+        "action": "metamask.perps.assert_orders",
+        "market": "BTC",
+        "state": "open",
+        "timeout_ms": 30000,
+        "next": "cancel_order",
+        "intent": "Assert the BTC resting limit order opened"
+      },
+      "cancel_order": {
+        "action": "metamask.perps.close_orders",
+        "market": "BTC",
+        "timeout_ms": 45000,
+        "next": "assert_none",
+        "intent": "Cancel the BTC resting limit order via the headless controller (real signed cancel to HL testnet)"
+      },
+      "assert_none": {
+        "action": "metamask.perps.assert_orders",
+        "market": "BTC",
+        "state": "none",
+        "timeout_ms": 30000,
+        "next": "teardown_flat",
+        "intent": "Assert the BTC order canceled — no open orders remain"
+      },
+      "teardown_flat": {
+        "action": "metamask.perps.teardown_state",
+        "market": "BTC",
+        "positions": {
+          "state": "none"
         },
-        "assert_open": {
-          "action": "metamask.perps.assert_orders",
-          "market": "BTC",
-          "state": "open",
-          "timeout_ms": 30000,
-          "next": "cancel_order",
-          "intent": "Assert the BTC resting limit order opened"
+        "orders": {
+          "state": "none"
         },
-        "cancel_order": {
-          "action": "metamask.perps.close_orders",
-          "market": "BTC",
-          "network": "testnet",
-          "timeout_ms": 45000,
-          "next": "assert_none",
-          "intent": "Cancel the BTC resting limit order via the headless controller (real signed cancel to HL testnet)"
-        },
-        "assert_none": {
-          "action": "metamask.perps.assert_orders",
-          "market": "BTC",
-          "state": "none",
-          "timeout_ms": 30000,
-          "next": "teardown_flat",
-          "intent": "Assert the BTC order canceled — no open orders remain"
-        },
-        "teardown_flat": {
-          "action": "metamask.perps.teardown_state",
-          "market": "BTC",
-          "positions": { "state": "none" },
-          "orders": { "state": "none" },
-          "network": "testnet",
-          "timeout_ms": 45000,
-          "next": "done",
-          "intent": "Restore BTC testnet baseline to flat after the proof (leave the shared account clean)"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+        "network": "testnet",
+        "timeout_ms": 45000,
+        "next": "done",
+        "intent": "Restore BTC testnet baseline to flat after the proof (leave the shared account clean)"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

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

@@ -1,71 +1,55 @@
 {
-  "schema_version": 1,
-  "title": "MetaMask Mobile Perps performance flow - background resume",
-  "description": "Measured Perps flow from a deterministic background-resume start state. Setup sends the installed app to the background, foregrounds 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 background-resume setup",
-    "detail": "Read-only start-state marker after lifecycle and wallet setup have completed."
-  },
-  "validate": {
-    "workflow": {
-      "setup": [
-        {
-          "id": "background-app",
-          "action": "app.lifecycle",
-          "command": "background",
-          "settle_ms": 3000,
-          "intent": "Put the installed app in the background before measuring resume",
-          "detail": "On Android this sends HOME to the selected device. On iOS simulator this foregrounds Settings through the shared outer adapter."
-        },
-        {
-          "id": "foreground-app",
-          "action": "app.lifecycle",
-          "command": "foreground",
-          "settle_ms": 15000,
-          "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 background-resume Perps performance flow",
-          "detail": "Terminal node; trace.json holds setup plus measured Perps node durations.",
-          "flow": "complete"
-        }
+  "$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/perps/performance.cold-start.mobile.recipe.json

@@ -1,71 +1,55 @@
 {
-  "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"
-        }
+  "$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/perps/performance.mobile.recipe.json

@@ -1,55 +1,41 @@
 {
-  "schema_version": 1,
-  "title": "MetaMask Mobile Perps performance flow",
-  "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": {
-      "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."
-        }
-      ],
-      "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. Mobile has no read_markets action, so read_positions is the canonical read of on-screen live state.",
-          "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 measured Perps performance flow",
-          "detail": "Terminal node; the passing run's trace.json holds the setup, startState, and measured per-node durations to diff across runs.",
-          "flow": "complete"
-        }
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "MetaMask Mobile Perps performance recipe",
+  "description": "Canonical measured MetaMask Mobile Perps recipe. The graph unlocks the wallet, records stable status, opens the market list, reads live state, and opens market detail. Timings live in trace.json. Run pinned so numbers are comparable: `mm-harness run perps.performance --device <serial> --heal off`. Testnet order placement is omitted to keep the recipe repeatable and non-destructive.",
+  "workflow": {
+    "entry": "ensure-unlocked",
+    "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 wallet setup",
+        "next": "open-perps-list"
+      },
+      "ensure-unlocked": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Unlock the wallet before timing the Perps journey",
+        "next": "start-state"
       }
     }
   }

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

@@ -1,63 +1,48 @@
 {
-  "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"
-        }
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "MetaMask Mobile Perps performance recipe — warm foreground start",
+  "description": "Measured Perps recipe from a deterministic warm foreground state. The graph foregrounds the installed app without rebuilding, unlocks if needed, then records Perps list, state, and BTC detail timings.",
+  "workflow": {
+    "entry": "foreground-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 warm foreground 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": 10000,
+        "intent": "Foreground the installed app through the Expo dev-client deep link",
+        "next": "ensure-unlocked"
       }
     }
   }