@deeeed/metamask-harness 0.18.0 → 0.19.0

package/library/recipes/app/lifecycle.android-smoke.mobile.recipe.json

@@ -1,86 +1,68 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Mobile Android lifecycle smoke",
-  "description": "Isolated on-device proof for the standard outer app.lifecycle action on Android. Setup cold-relaunches the installed app through the Expo dev-client deep link without rebuilding and proves the React Native bridge is reachable. The main workflow then backgrounds the installed app, foregrounds it again, proves the bridge is reachable after resume, and captures a screenshot.",
-  "startState": {
-    "action": "app.status",
-    "intent": "Record the stable run start status after setup relaunch",
-    "detail": "Read-only start-state marker after setup has made the Android bridge reachable."
-  },
-  "validate": {
-    "workflow": {
-      "setup": [
-        {
-          "id": "terminate-before",
-          "action": "app.lifecycle",
-          "platform": "android",
-          "command": "terminate",
-          "settle_ms": 3000,
-          "intent": "Terminate the installed Android app before lifecycle smoke",
-          "detail": "Force-stops stale foreground instances that may have no React Native debug target."
-        },
-        {
-          "id": "launch-before",
-          "action": "app.lifecycle",
-          "platform": "android",
-          "command": "launch",
-          "settle_ms": 15000,
-          "intent": "Launch the installed Android app through the Expo dev-client deep link from a cold process",
-          "detail": "Uses the selected adb serial, Metro port, and installed package; it does not rebuild."
-        },
-        {
-          "id": "bridge-before",
-          "action": "cdp.target",
-          "require_reachable": true,
-          "intent": "Confirm the mobile React Native debug bridge is reachable after setup relaunch",
-          "detail": "This proves setup can recover a missing Android bridge target before the background-resume proof."
-        }
-      ],
-      "entry": "background-app",
-      "nodes": {
-        "background-app": {
-          "action": "app.lifecycle",
-          "platform": "android",
-          "command": "background",
-          "settle_ms": 1000,
-          "intent": "Put the selected Android device on the launcher",
-          "detail": "Uses adb HOME through the shared Farmslot lifecycle adapter.",
-          "flow": "lifecycle",
-          "next": "foreground-app"
-        },
-        "foreground-app": {
-          "action": "app.lifecycle",
-          "platform": "android",
-          "command": "foreground",
-          "settle_ms": 15000,
-          "intent": "Foreground the installed Android app through the Expo dev-client deep link",
-          "detail": "Uses the selected adb serial, Metro port, and installed package; it does not rebuild.",
-          "flow": "lifecycle",
-          "next": "bridge-after"
-        },
-        "bridge-after": {
-          "action": "cdp.target",
-          "require_reachable": true,
-          "intent": "Confirm the mobile React Native debug bridge recovered after foregrounding",
-          "detail": "This is the capability gate before running Perps recipes that depend on CDP/bridge control.",
-          "flow": "lifecycle",
-          "next": "screenshot-after"
-        },
-        "screenshot-after": {
-          "action": "ui.screenshot",
-          "path": "screenshots/app.lifecycle.android-smoke.png",
-          "intent": "Capture the app after Android lifecycle foreground",
-          "detail": "Visual proof that the selected device is displaying the relaunched app.",
-          "flow": "evidence",
-          "next": "end"
-        },
-        "end": {
-          "action": "end",
-          "status": "pass",
-          "intent": "Finish the isolated Android lifecycle smoke",
-          "detail": "If this passes, lifecycle is proven independently of wallet and Perps actions.",
-          "flow": "complete"
-        }
+  "description": "Isolated on-device proof for the standard app.lifecycle action on Android. The graph cold-relaunches the installed app without rebuilding, proves the React Native bridge is reachable, backgrounds and foregrounds the app, proves bridge recovery, and captures a screenshot.",
+  "workflow": {
+    "entry": "terminate-before",
+    "nodes": {
+      "background-app": {
+        "action": "app.lifecycle",
+        "platform": "android",
+        "command": "background",
+        "settle_ms": 1000,
+        "intent": "Put the selected Android device on the launcher",
+        "next": "foreground-app"
+      },
+      "foreground-app": {
+        "action": "app.lifecycle",
+        "platform": "android",
+        "command": "foreground",
+        "settle_ms": 15000,
+        "intent": "Foreground the installed Android app through the Expo dev-client deep link",
+        "next": "bridge-after"
+      },
+      "bridge-after": {
+        "action": "cdp.target",
+        "require_reachable": true,
+        "intent": "Confirm the mobile React Native debug bridge recovered after foregrounding",
+        "next": "screenshot-after"
+      },
+      "screenshot-after": {
+        "action": "ui.screenshot",
+        "path": "screenshots/app.lifecycle.android-smoke.png",
+        "intent": "Record the foreground app state as evidence",
+        "next": "end"
+      },
+      "end": {
+        "action": "end",
+        "status": "pass"
+      },
+      "start-state": {
+        "action": "app.status",
+        "intent": "Record the stable run start status after setup relaunch",
+        "next": "background-app"
+      },
+      "bridge-before": {
+        "action": "cdp.target",
+        "require_reachable": true,
+        "intent": "Confirm the mobile React Native debug bridge is reachable after setup relaunch",
+        "next": "start-state"
+      },
+      "launch-before": {
+        "action": "app.lifecycle",
+        "platform": "android",
+        "command": "launch",
+        "settle_ms": 15000,
+        "intent": "Launch the installed Android app through the Expo dev-client deep link from a cold process",
+        "next": "bridge-before"
+      },
+      "terminate-before": {
+        "action": "app.lifecycle",
+        "platform": "android",
+        "command": "terminate",
+        "settle_ms": 3000,
+        "intent": "Terminate the installed Android app before lifecycle smoke",
+        "next": "launch-before"
       }
     }
   }

package/library/recipes/perps/clean-market-testnet.core.recipe.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Clean Perps testnet market",
+  "description": "Converge one Core Perps testnet market to no matching open position or order.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "market"
+    ],
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "ETH",
+        "description": "Perps market symbol to clean."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "clean-market",
+    "nodes": {
+      "clean-market": {
+        "action": "metamask.perps.start_state",
+        "intent": "Converge Core Perps to a clean testnet market",
+        "profile": "clean_market_testnet",
+        "network": "testnet",
+        "market": "{{params.market}}",
+        "positions": {
+          "state": "none",
+          "mode": "matching"
+        },
+        "orders": {
+          "state": "none",
+          "mode": "matching"
+        },
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/perps/clean-market-testnet.recipe.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Clean Perps testnet market",
+  "description": "Converge one Perps testnet market to an unlocked wallet with no matching open position or order.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+      "market"
+    ],
+    "properties": {
+      "market": {
+        "type": "string",
+        "default": "ETH",
+        "description": "Perps market symbol to clean."
+      }
+    }
+  },
+  "workflow": {
+    "entry": "ensure-wallet",
+    "nodes": {
+      "ensure-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Ensure the wallet is unlocked before cleaning the Perps market",
+        "next": "clean-market"
+      },
+      "clean-market": {
+        "action": "metamask.perps.start_state",
+        "intent": "Converge Perps to a clean testnet market",
+        "profile": "clean_market_testnet",
+        "network": "testnet",
+        "market": "{{params.market}}",
+        "positions": {
+          "state": "none",
+          "mode": "matching"
+        },
+        "orders": {
+          "state": "none",
+          "mode": "matching"
+        },
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/perps/lifecycle.recipe.json

@@ -1,193 +1,149 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Perps lifecycle smoke",
   "description": "Reusable Recipe v1 smoke that proves a deterministic Perps prestate, opens a small ETH testnet position, verifies it, closes it, and tears down to a clean state.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "intent": "Read runner compatibility status",
-          "detail": "Confirm the selected MetaMask adapter is connected before trading.",
-          "flow": "setup",
-          "next": "fixture"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "intent": "Verify wallet fixture availability",
-          "detail": "Check the preseeded wallet fixture required for deterministic Perps validation.",
-          "flow": "setup",
-          "next": "wallet-setup"
-        },
-        "wallet-setup": {
-          "action": "metamask.wallet.setup",
-          "intent": "Ensure wallet fixture setup is ready",
-          "detail": "Confirm onboarding and fixture state before controlling the app.",
-          "flow": "wallet",
-          "next": "wallet-unlock"
-        },
-        "wallet-unlock": {
-          "action": "metamask.wallet.ensure_unlocked",
-          "intent": "Ensure the wallet is unlocked",
-          "detail": "Unlock only if the app is currently locked.",
-          "flow": "wallet",
-          "next": "select-account"
-        },
-        "select-account": {
-          "action": "metamask.wallet.select_account",
-          "address": "0x8dc623e964475d4d669da601fd15ea9125469003",
-          "intent": "Select the validation account",
-          "detail": "Use the deterministic testnet account shared by mobile and extension.",
-          "flow": "wallet",
-          "next": "wallet-read-state"
-        },
-        "wallet-read-state": {
-          "action": "metamask.wallet.read_state",
-          "intent": "Capture wallet state proof",
-          "detail": "Record selected account/network state before the Perps lifecycle.",
-          "flow": "wallet",
-          "next": "navigate-perps"
-        },
-        "navigate-perps": {
-          "action": "ui.navigate",
-          "intent": "Navigate to Perps with raw platform routing",
-          "detail": "Mobile consumes route=PerpsMarketListView; extension consumes hash=#/?tab=perps.",
-          "flow": "perps setup",
-          "next": "navigate-market",
-          "route": "PerpsMarketListView",
-          "hash": "#/?tab=perps"
-        },
-        "navigate-market": {
-          "action": "ui.navigate",
-          "intent": "Open the ETH Perps market with raw platform routing",
-          "detail": "Mobile consumes route=params; extension consumes hash=#/perps/market/ETH.",
-          "flow": "perps setup",
-          "next": "start-state",
-          "route": "PerpsMarketDetails",
-          "params": {
-            "market": {
-              "symbol": "ETH"
-            }
-          },
-          "hash": "#/perps/market/ETH"
-        },
-        "start-state": {
-          "action": "metamask.perps.start_state",
-          "profile": "clean_market_testnet",
-          "market": "ETH",
-          "positions": {
-            "state": "none",
-            "mode": "matching"
-          },
-          "orders": {
-            "state": "none",
-            "mode": "matching"
-          },
-          "page": "market",
-          "intent": "Prepare clean ETH testnet Perps state",
-          "detail": "Close existing ETH testnet positions and orders before the smoke lifecycle starts.",
-          "flow": "perps setup",
-          "next": "assert-clean-position",
-          "tutorial": {
-            "completed": true
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "intent": "Read runner compatibility status",
+        "next": "fixture"
+      },
+      "fixture": {
+        "action": "metamask.wallet.fixture_status",
+        "intent": "Verify wallet fixture availability",
+        "next": "wallet-setup"
+      },
+      "wallet-setup": {
+        "action": "metamask.wallet.setup",
+        "intent": "Ensure wallet fixture setup is ready",
+        "next": "wallet-unlock"
+      },
+      "wallet-unlock": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Ensure the wallet is unlocked",
+        "next": "select-account"
+      },
+      "select-account": {
+        "action": "metamask.wallet.select_account",
+        "address": "0x8dc623e964475d4d669da601fd15ea9125469003",
+        "intent": "Select the validation account",
+        "next": "wallet-read-state"
+      },
+      "wallet-read-state": {
+        "action": "metamask.wallet.read_state",
+        "intent": "Capture wallet state proof",
+        "next": "navigate-perps"
+      },
+      "navigate-perps": {
+        "action": "ui.navigate",
+        "intent": "Show the Perps home surface",
+        "next": "navigate-market",
+        "route": "PerpsMarketListView",
+        "hash": "#/?tab=perps"
+      },
+      "navigate-market": {
+        "action": "ui.navigate",
+        "intent": "Show the ETH Perps market details",
+        "next": "start-state",
+        "route": "PerpsMarketDetails",
+        "params": {
+          "market": {
+            "symbol": "ETH"
           }
         },
-        "assert-clean-position": {
-          "action": "metamask.perps.assert_positions",
-          "market": "ETH",
+        "hash": "#/perps/market/ETH"
+      },
+      "start-state": {
+        "action": "metamask.perps.start_state",
+        "profile": "clean_market_testnet",
+        "market": "ETH",
+        "positions": {
           "state": "none",
-          "intent": "Confirm ETH position state is clean",
-          "detail": "Assert lifecycle starts with no ETH Perps position.",
-          "flow": "perps setup",
-          "next": "assert-clean-orders"
+          "mode": "matching"
         },
-        "assert-clean-orders": {
-          "action": "metamask.perps.assert_orders",
-          "market": "ETH",
+        "orders": {
           "state": "none",
-          "intent": "Confirm ETH order state is clean",
-          "detail": "Assert lifecycle starts with no ETH Perps orders.",
-          "flow": "perps setup",
-          "next": "place-order"
-        },
-        "place-order": {
-          "action": "metamask.perps.place_order",
-          "market": "ETH",
-          "side": "long",
-          "amount": "11",
-          "leverage": 3,
-          "intent": "Open a small ETH 3x long position",
-          "detail": "Place an approximately $11 real testnet market order through the Perps controller.",
-          "flow": "perps lifecycle",
-          "next": "assert-open"
-        },
-        "assert-open": {
-          "action": "metamask.perps.assert_positions",
-          "market": "ETH",
-          "state": "open",
-          "intent": "Confirm the ETH position opened",
-          "detail": "Verify the lifecycle created a real position before cleanup.",
-          "flow": "perps lifecycle",
-          "next": "read-orders"
-        },
-        "read-orders": {
-          "action": "metamask.perps.read_orders",
-          "market": "ETH",
-          "intent": "Read ETH orders before cleanup",
-          "detail": "Collect order state proof before lifecycle teardown.",
-          "flow": "perps lifecycle",
-          "next": "close-orders"
-        },
-        "close-orders": {
-          "action": "metamask.perps.close_orders",
-          "market": "ETH",
-          "intent": "Close ETH orders from the lifecycle",
-          "detail": "Cancel any open ETH orders selected by the recipe parameters.",
-          "flow": "perps teardown",
-          "next": "close-position"
-        },
-        "close-position": {
-          "action": "metamask.perps.close_positions",
-          "market": "ETH",
-          "intent": "Close the ETH lifecycle position",
-          "detail": "Close the position created by this smoke and wait for clean state.",
-          "flow": "perps teardown",
-          "next": "assert-closed"
-        },
-        "assert-closed": {
-          "action": "metamask.perps.assert_positions",
-          "market": "ETH",
+          "mode": "matching"
+        },
+        "page": "market",
+        "intent": "Prepare clean ETH testnet Perps state",
+        "next": "assert-clean-position"
+      },
+      "assert-clean-position": {
+        "action": "metamask.perps.assert_positions",
+        "market": "ETH",
+        "state": "none",
+        "intent": "Confirm ETH position state is clean",
+        "next": "assert-clean-orders"
+      },
+      "assert-clean-orders": {
+        "action": "metamask.perps.assert_orders",
+        "market": "ETH",
+        "state": "none",
+        "intent": "Confirm ETH order state is clean",
+        "next": "place-order"
+      },
+      "place-order": {
+        "action": "metamask.perps.place_order",
+        "market": "ETH",
+        "side": "long",
+        "amount": "11",
+        "leverage": 3,
+        "intent": "Open a small ETH 3x long position",
+        "next": "assert-open"
+      },
+      "assert-open": {
+        "action": "metamask.perps.assert_positions",
+        "market": "ETH",
+        "state": "open",
+        "intent": "Confirm the ETH position opened",
+        "next": "read-orders"
+      },
+      "read-orders": {
+        "action": "metamask.perps.read_orders",
+        "market": "ETH",
+        "intent": "Read ETH orders before cleanup",
+        "next": "close-orders"
+      },
+      "close-orders": {
+        "action": "metamask.perps.close_orders",
+        "market": "ETH",
+        "intent": "Close ETH orders from the lifecycle",
+        "next": "close-position"
+      },
+      "close-position": {
+        "action": "metamask.perps.close_positions",
+        "market": "ETH",
+        "intent": "Close the ETH lifecycle position",
+        "next": "assert-closed"
+      },
+      "assert-closed": {
+        "action": "metamask.perps.assert_positions",
+        "market": "ETH",
+        "state": "none",
+        "intent": "Confirm ETH position cleanup completed",
+        "next": "teardown-state"
+      },
+      "teardown-state": {
+        "action": "metamask.perps.teardown_state",
+        "market": "ETH",
+        "positions": {
           "state": "none",
-          "intent": "Confirm ETH position cleanup completed",
-          "detail": "Assert no ETH position remains after lifecycle cleanup.",
-          "flow": "perps teardown",
-          "next": "teardown-state"
+          "mode": "matching"
         },
-        "teardown-state": {
-          "action": "metamask.perps.teardown_state",
-          "market": "ETH",
-          "positions": {
-            "state": "none",
-            "mode": "matching"
-          },
-          "orders": {
-            "state": "none",
-            "mode": "matching"
-          },
-          "page": "home",
-          "intent": "Return Perps to globally clean home state",
-          "detail": "Close remaining ETH positions and orders so the lifecycle leaves its selected market clean.",
-          "flow": "perps teardown",
-          "next": "done"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass",
-          "intent": "Finish Perps lifecycle smoke",
-          "detail": "The recipe opened and closed a real ETH testnet position.",
-          "flow": "complete"
-        }
+        "orders": {
+          "state": "none",
+          "mode": "matching"
+        },
+        "page": "home",
+        "intent": "Return Perps to globally clean home state",
+        "next": "done"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }