@deeeed/metamask-harness 0.91.2 → 0.91.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.91.4 - 2026-10-13
+
+### Fixed
+
+- Mobile `stop` now exits nonzero after Metro/helper cleanup because the initial app/device state is not recorded and restoration cannot be verified. This corrects a false success report; it does not add automatic simulator shutdown or claim that device cleanup completed. Restore and verify device state through its lifecycle owner.
+
+## 0.91.3 - 2026-10-13
+
+### Fixed
+
+- Give Mobile `perps.smoke` executable `smoke` and `cleanup` proof targets for live conformance. Assert live controller reads, bind a HUD screenshot to the smoke, and observe wallet home in teardown, including after a failed smoke.
+
 ## 0.91.2 - 2026-10-13
 
 ### Added

package/dist/adapters/mobile/surface.js

@@ -1,4 +1,4 @@
-import { recipeRuntimePath, shellQuote, writeInteractiveProgress } from "@farmslot/recipe-cli/harness";
+import { EXIT, recipeRuntimePath, shellQuote, writeInteractiveProgress } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { defineAdapter } from "@farmslot/adapter-sdk";
@@ -60,9 +60,10 @@ const mobileSurface = defineAdapter({
       const args = ["--target", target];
       if (process.env.WATCHER_PORT) args.push("--port", process.env.WATCHER_PORT);
       const result = spawnSync("bash", [leaf, ...args], { encoding: "utf8" });
-      const status = result.status ?? 1;
+      const metroStatus = result.status ?? 1;
+      const status = metroStatus === 0 ? EXIT.runtime : metroStatus;
       const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
-      const summary = status === 0 ? `stopped Metro dev server for ${target}` : `failed to stop Metro for ${target}`;
+      const summary = metroStatus === 0 ? `Metro cleanup completed for ${target}, but Mobile app/device restoration is unverified: no initial state is recorded. Restore and verify the device through its lifecycle owner.` : `failed to stop Metro for ${target}`;
       return { kind: "stopped", status, summary, output };
     }
   },

package/library/recipes/mobile/perps/smoke-observation.recipe.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "MetaMask Mobile Perps smoke observation",
+  "description": "Observe live Perps positions and orders and capture the current screen. Caller opens Perps before this read-only proof.",
+  "workflow": {
+    "entry": "read-positions",
+    "nodes": {
+      "read-positions": {
+        "action": "metamask.perps.read_positions",
+        "next": "assert-positions",
+        "intent": "Read live Perps positions without changing account state"
+      },
+      "assert-positions": {
+        "action": "assert_output",
+        "source": "read-positions",
+        "assert": {
+          "all": [
+            {
+              "path": "$.source",
+              "operator": "eq",
+              "value": "mobile-perps-controller"
+            },
+            {
+              "path": "$.count",
+              "operator": "gte",
+              "value": 0
+            },
+            {
+              "path": "$.positions",
+              "operator": "not_null"
+            }
+          ]
+        },
+        "next": "read-orders",
+        "intent": "Verify the live controller returned Perps positions"
+      },
+      "read-orders": {
+        "action": "metamask.perps.read_orders",
+        "next": "assert-orders",
+        "intent": "Read live Perps orders without changing account state"
+      },
+      "assert-orders": {
+        "action": "assert_output",
+        "source": "read-orders",
+        "assert": {
+          "all": [
+            {
+              "path": "$.source",
+              "operator": "eq",
+              "value": "mobile-perps-controller-open-orders"
+            },
+            {
+              "path": "$.count",
+              "operator": "gte",
+              "value": 0
+            },
+            {
+              "path": "$.orders",
+              "operator": "not_null"
+            }
+          ]
+        },
+        "next": "capture",
+        "intent": "Verify the live controller returned Perps orders"
+      },
+      "capture": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-smoke.png",
+        "next": "done",
+        "intent": "Keep a view of the Perps screen after verifying live account reads"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/library/recipes/mobile/perps/smoke.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Mobile Perps smoke",
-  "description": "Non-mutating Perps domain smoke for MetaMask Mobile: verifies the live bridge, unlocks if needed, opens the Perps market list, and reads live Perps positions and orders.",
+  "description": "Non-mutating Perps domain smoke for debug-enabled MetaMask Mobile: unlock if needed, open Perps, assert live positions and orders, and retain a HUD screenshot. Teardown observes wallet home. Does not close positions or stop the app.",
   "workflow": {
     "entry": "status",
     "nodes": {
@@ -27,23 +27,64 @@
       "open-perps": {
         "action": "ui.navigate",
         "page": "perps",
-        "next": "read-positions",
+        "next": "observe-perps",
         "intent": "Show the Perps market list"
       },
-      "read-positions": {
-        "action": "metamask.perps.read_positions",
-        "next": "read-orders",
-        "intent": "Read live Perps positions without mutating account state"
-      },
-      "read-orders": {
-        "action": "metamask.perps.read_orders",
+      "observe-perps": {
+        "action": "call",
+        "ref": "perps.smoke-observation",
+        "proves": [
+          "smoke"
+        ],
         "next": "done",
-        "intent": "Read live Perps open orders without mutating account state"
+        "intent": "Verify live Perps reads and capture the screen with its intent HUD"
       },
       "done": {
         "action": "end",
         "status": "pass"
+      },
+      "cleanup-home": {
+        "action": "ui.navigate",
+        "page": "home",
+        "next": "cleanup-state",
+        "intent": "Return wallet home after Perps smoke"
+      },
+      "cleanup-state": {
+        "action": "metamask.wallet.read_state",
+        "next": "cleanup-assert",
+        "intent": "Observe the wallet route after returning home"
+      },
+      "cleanup-assert": {
+        "action": "assert_output",
+        "source": "cleanup-state",
+        "assert": {
+          "path": "$.route.name",
+          "operator": "eq",
+          "value": "WalletView"
+        },
+        "proves": [
+          "cleanup"
+        ],
+        "next": "cleanup-done",
+        "intent": "Verify wallet home was reached during cleanup"
+      },
+      "cleanup-done": {
+        "action": "end",
+        "status": "pass"
       }
+    },
+    "teardown": "cleanup-home"
+  },
+  "proofTargets": [
+    {
+      "id": "smoke",
+      "claim": "The live Mobile Perps controller returns positions and open orders.",
+      "proofMode": "state"
+    },
+    {
+      "id": "cleanup",
+      "claim": "The wallet reports WalletView after returning home from Perps.",
+      "proofMode": "state"
     }
-  }
+  ]
 }

package/package.json

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