@deeeed/metamask-harness 0.13.0 → 0.14.0

package/dist/commands/run-engine.js

@@ -18,6 +18,7 @@ import {
   runnerDir
 } from "../paths.js";
 import { captureHelperSupportsRecordSessionSnapshots } from "../recording-target.js";
+import { listRecipeFiles } from "../recipe-files.js";
 import { startRecipeRecording, stopRecipeRecording } from "../run-recording.js";
 import { EXIT } from "./shared.js";
 import {
@@ -152,7 +153,7 @@ function resolveRunRecipeArg(recipeArg, adapter, librarySources) {
   const direct = path.resolve(recipeArg);
   if (isRecipeFile(direct)) return { recipeFile: direct };
   if (!recipeArg.includes("/") && !recipeArg.includes(path.sep)) {
-    const candidates = [`${recipeArg}.${adapter}.recipe.json`, `${recipeArg}.recipe.json`, recipeArg];
+    const candidates = recipeNameCandidates(recipeArg, adapter);
     if (librarySources && librarySources.length > 0) {
       for (const source of librarySources) {
         for (const candidate of candidates) {
@@ -176,17 +177,75 @@ function resolveRunRecipeArg(recipeArg, adapter, librarySources) {
 function libraryRecipeNames(adapter) {
   let entries;
   try {
-    entries = fs.readdirSync(recipePath(""));
+    entries = listRecipeFiles(recipePath(""));
   } catch {
     return [];
   }
   const scopes = ["mobile", "extension", "core"];
-  const names = entries.filter((f) => f.endsWith(".recipe.json")).map((f) => f.slice(0, -".recipe.json".length)).filter((n) => {
+  const names = entries.filter((f) => f.endsWith(".recipe.json")).map((f) => f.slice(0, -".recipe.json".length).replace(/[\\/]/gu, ".")).filter((n) => {
     const scope = n.split(".").pop() ?? "";
     return !scopes.includes(scope) || scope === adapter;
   }).map((n) => n.endsWith(`.${adapter}`) ? n.slice(0, -(adapter.length + 1)) : n);
   return [...new Set(names)].sort();
 }
+function recipeNameCandidates(recipeArg, adapter) {
+  const names = [recipeArg, ...LEGACY_RECIPE_ALIASES[recipeArg] ?? []];
+  const candidates = [];
+  for (const name of names) {
+    candidates.push(...singleRecipeNameCandidates(name, adapter));
+  }
+  return [...new Set(candidates)];
+}
+function singleRecipeNameCandidates(name, adapter) {
+  if (name.endsWith(".recipe.json")) {
+    return uniqueStrings([domainPathForRecipeFile(name), name]);
+  }
+  const bases = uniqueStrings([domainPathForRecipeName(name), name]);
+  const candidates = [];
+  for (const base of bases) {
+    candidates.push(`${base}.${adapter}.recipe.json`, `${base}.recipe.json`, base);
+  }
+  return candidates;
+}
+function domainPathForRecipeFile(name) {
+  const suffix = ".recipe.json";
+  const base = name.slice(0, -suffix.length);
+  return `${domainPathForRecipeName(base)}${suffix}`;
+}
+function domainPathForRecipeName(name) {
+  if (name.includes("/") || name.includes(path.sep)) return name;
+  const dot = name.indexOf(".");
+  return dot > 0 ? `${name.slice(0, dot)}/${name.slice(dot + 1)}` : name;
+}
+function uniqueStrings(values) {
+  return [...new Set(values)];
+}
+const LEGACY_RECIPE_ALIASES = {
+  "action-validation": ["runner.action-validation"],
+  "action-validation.extension.recipe.json": ["runner.action-validation.extension.recipe.json"],
+  "action-validation.mobile.recipe.json": ["runner.action-validation.mobile.recipe.json"],
+  "app-lifecycle-android-smoke": ["app.lifecycle.android-smoke"],
+  "app-lifecycle-android-smoke.mobile.recipe.json": ["app.lifecycle.android-smoke.mobile.recipe.json"],
+  "order-lifecycle": ["perps.order-lifecycle"],
+  "order-lifecycle.core.recipe.json": ["perps.order-lifecycle.core.recipe.json"],
+  "perps-lifecycle": ["perps.lifecycle"],
+  "perps-lifecycle.recipe.json": ["perps.lifecycle.recipe.json"],
+  "perps-performance": ["perps.performance"],
+  "perps-performance-background-resume": ["perps.performance.background-resume"],
+  "perps-performance-background-resume.mobile.recipe.json": ["perps.performance.background-resume.mobile.recipe.json"],
+  "perps-performance-cold-start": ["perps.performance.cold-start"],
+  "perps-performance-cold-start.mobile.recipe.json": ["perps.performance.cold-start.mobile.recipe.json"],
+  "perps-performance-warm-start": ["perps.performance.warm-start"],
+  "perps-performance-warm-start.mobile.recipe.json": ["perps.performance.warm-start.mobile.recipe.json"],
+  "perps-performance.mobile.recipe.json": ["perps.performance.mobile.recipe.json"],
+  "read-markets": ["perps.read-markets"],
+  "read-markets.core.recipe.json": ["perps.read-markets.core.recipe.json"],
+  "smoke": ["runner.smoke"],
+  "smoke.extension.recipe.json": ["runner.smoke.extension.recipe.json"],
+  "smoke.mobile.recipe.json": ["runner.smoke.mobile.recipe.json"],
+  "trading-lifecycle": ["perps.trading-lifecycle"],
+  "trading-lifecycle.core.recipe.json": ["perps.trading-lifecycle.core.recipe.json"]
+};
 async function validateRunRecipeStatic(recipeArg, adapter, options) {
   const librarySources = await resolveMetaMaskLibrarySources(optionString(options, "library"));
   const resolved = resolveRunRecipeArg(recipeArg, adapter, librarySources);

package/dist/commands/run.js

@@ -20,6 +20,7 @@ import {
 } from "./run-engine.js";
 import { handleListExecutables } from "./list-executables.js";
 import { applyDeviceTargeting } from "./device-target.js";
+import { getAdapterSurface } from "../adapters/surface.js";
 async function handleRun({ positional, options }) {
   if (optionFlag(options, "list")) return handleListExecutables("run", options);
   const targetRecipe = positional[0];
@@ -27,6 +28,7 @@ async function handleRun({ positional, options }) {
   if (optionFlag(options, "plan")) return handleRunPlan(targetRecipe, options);
   const { adapter, target } = resolveAdapter(options);
   const json = optionFlag(options, "json");
+  getAdapterSurface(adapter).resolveSlotPorts(target);
   const dtResult = applyDeviceTargeting("run", adapter, options, { gate: true, rerun: "" });
   if ("code" in dtResult) {
     return emitRunUsageError(json, adapter, targetRecipe, dtResult.code, dtResult.message);

package/dist/commands/self-test.js

@@ -26,7 +26,7 @@ async function runSelfTest(options) {
       const manifest = loadActionManifest(adapter);
       const manifestValidation = await validateManifest(manifest);
       const smokeRecipe = recipePath(
-        adapter === "mobile" ? "smoke.mobile.recipe.json" : "smoke.extension.recipe.json"
+        adapter === "mobile" ? "runner/smoke.mobile.recipe.json" : "runner/smoke.extension.recipe.json"
       );
       const artifactsDir = path.join(root, adapter);
       const result = await runRecipe(adapter, smokeRecipe, artifactsDir, runnerDir, void 0, {

package/dist/commands/status.js

@@ -16,8 +16,10 @@ async function handleStatus({ options }) {
     return usageOut(json, "status", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
   }
   assertAdapter(adapter);
-  const devices = adapter === "mobile" ? listConnectedDevices().map((device) => ({ ...device, selected: deviceSelected(device) })) : [];
-  const next = getAdapterSurface(adapter).hints.relaunch;
+  const surface = getAdapterSurface(adapter);
+  surface.resolveSlotPorts(target);
+  const next = surface.hints.relaunch;
+  const devices = adapter === "mobile" ? slotScopedDevices(listConnectedDevices()) : [];
   if (json) {
     const doProbe = !fast && adapter === "mobile" && devices.length > 0;
     if (doProbe) {
@@ -25,7 +27,7 @@ async function handleStatus({ options }) {
       const devicesWithLive = devices.map((d) => mergeDeviceLive(d, liveMap.get(d.id)));
       console.log(
         JSON.stringify(
-          { schemaVersion: 1, command: "status", adapter, target, devices: devicesWithLive, next },
+          { schemaVersion: 1, command: "status", adapter, target, devices: devicesWithLive, next: nextForLive(next, liveMap) },
           null,
           2
         )
@@ -40,13 +42,26 @@ async function handleStatus({ options }) {
   const out = (style, text) => color(style, text, { stream: process.stdout });
   console.log(`${out("label", "status")} ${out("bold", adapter)} ${out("dim", target)}`);
   if (adapter === "mobile") renderDeviceList(devices, out);
-  console.log(`${out("label", "Next:")} ${out("cmd", next)}`);
   if (!fast && adapter === "mobile" && devices.length > 0) {
     const liveMap = await probeMobileLiveState(target, devices);
     renderLiveBlock(devices, liveMap, out);
+    console.log(`${out("label", "Next:")} ${out("cmd", nextForLive(next, liveMap))}`);
+  } else {
+    console.log(`${out("label", "Next:")} ${out("cmd", next)}`);
   }
   return EXIT.ok;
 }
+function nextForLive(fallback, liveMap) {
+  for (const live of liveMap.values()) {
+    if (live.liveState === void 0) return "mm-harness logs";
+  }
+  return fallback;
+}
+function slotScopedDevices(devices) {
+  const withSelection = devices.map((device) => ({ ...device, selected: deviceSelected(device) }));
+  const selected = withSelection.filter((device) => device.selected);
+  return selected.length > 0 ? selected : withSelection;
+}
 function mergeDeviceLive(device, live) {
   if (!live) return device;
   return {

package/dist/mm-harness-cli.js

@@ -90,15 +90,16 @@ Example:
     name: "call",
     summary: "Run one action in isolation as a one-node recipe through the real engine path (fuzzy short names; --arg k=v; same trace/evidence as run).",
     example: "mm-harness call ensure_unlocked",
-    helpText: `mm-harness call <action> [--arg k=v ...] [flags]
+    helpText: `mm-harness call <action> [key=value ...] [--arg k=v ...] [flags]
 
   Run one action in isolation as a one-node recipe through the real engine path.
   Fuzzy short-name: 'ensure_unlocked' resolves to 'metamask.wallet.ensure_unlocked'
-  if unique; ambiguous = exit 2. Actions differ per adapter \u2014 list this checkout's
-  with: mm-harness actions.
+  if unique; ambiguous = exit 2. Pass action fields as key=value shorthand or
+  with --arg k=v. Actions differ per adapter \u2014 list this checkout's with:
+  mm-harness actions.
 
   --list                             List everything invocable for the adapter (actions + flows); no <action> needed
-  --arg k=v                          Action field value (repeatable)
+  --arg k=v                          Action field value (repeatable; equivalent to key=value shorthand)
   --device <udid|serial|name>        Mobile only: target this device (env: IOS_SIMULATOR / ADB_SERIAL). Without it, >1 connected mobile device fails fast and lists them.
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
@@ -110,7 +111,8 @@ Example:
 
 Example (real actions; run mm-harness actions for this checkout's full set):
   mm-harness call ensure_unlocked --adapter extension   # a wallet action (extension/mobile)
-  mm-harness call command --arg cmd="echo hi" --adapter core   # the universal action (all adapters)`
+  mm-harness call navigate page=perps --adapter mobile
+  mm-harness call command cmd="echo hi" --adapter core   # the universal action (all adapters)`
   },
   {
     name: "flows",

package/dist/recipe-files.js

@@ -0,0 +1,14 @@
+import fs from "node:fs";
+import path from "node:path";
+function listRecipeFiles(root, base = "") {
+  const out = [];
+  for (const entry of fs.readdirSync(path.join(root, base), { withFileTypes: true })) {
+    const rel = path.join(base, entry.name);
+    if (entry.isDirectory()) out.push(...listRecipeFiles(root, rel));
+    else if (entry.isFile() && entry.name.endsWith(".recipe.json")) out.push(rel);
+  }
+  return out;
+}
+export {
+  listRecipeFiles
+};

package/docs/architecture.md

@@ -216,7 +216,7 @@ describes **how an agent should work**, it belongs in skills.
 | `adapters/extension/` | Runner-owned Extension launch/live/watch/windows/wallet-state/readiness helpers (orchestration) and verify (recipe) copied into installed harnesses. |
 | `adapters/shared/path-defaults.json` | Single source for default `recipeHarnessRoot` and `recipeRuntimeDir`. |
 | `adapters/shared/harness-path.sh`, `src/paths.ts` | Shell and TypeScript accessors for those defaults plus validation. |
-| `library/recipes/` | Reusable smoke/action-validation recipes only. Task-specific proof recipes stay task-local. |
+| `library/recipes/` | Reusable smoke/runner.action-validation recipes only. Task-specific proof recipes stay task-local. |
 | `library/library.json`, `library/flows/` | Canonical recipe library: minimal, stable flows recipes can `call`. Personal/team libraries shadow it by default — see [Recipe Libraries](recipe-libraries.md). |
 | `docs/` | Runner architecture, contracts, and operational conventions. |
 
@@ -377,7 +377,7 @@ TypeScript or a focused `.mjs` adapter and keep shell as the launcher.
 5. Use official `ui.*` actions and screenshot claims for visible acceptance
    criteria; do not add task-specific `metamask.*` actions for exact copy,
    styling, ticket IDs, or one-off selectors.
-6. Update smoke/action-validation recipes only when the capability is reusable.
+6. Update smoke/runner.action-validation recipes only when the capability is reusable.
 
 ## Standalone use first; farm later
 

package/docs/live-adapter-contract.md

@@ -85,7 +85,7 @@ domain capability useful across many tasks, such as `metamask.perps.start_state`
 `metamask.perps.place_order`, `metamask.perps.close_positions`, or
 `metamask.perps.assert_positions`.
 
-`ui.scroll` is part of the current executable contract and action-validation must
+`ui.scroll` is part of the current executable contract and runner.action-validation must
 prove both normal scrolling and `scroll_into_view` before screenshot capture.
 `ui.gesture` is intentionally not advertised yet; drag/swipe proof must wait
 until the shared runtime and this runner expose and validate that action on both

package/docs/recipe-libraries.md

@@ -101,19 +101,20 @@ each user-visible step takes. The runner has no benchmark verb: timings are just
 the per-node `duration`s in a passing run's `trace.json`, so a flow is comparable
 across runs only when you pin the run (same device, healing off) and keep the node
 graph stable. The repo ships one canonical example,
-`library/recipes/perps-performance.mobile.recipe.json` — unlock → open the Perps
+`library/recipes/perps/performance.mobile.recipe.json` — unlock → open the Perps
 market list → read live state → open a market detail. This walkthrough copies it
 into a library of your own and retargets it to your journey. A peer engineer can
-follow it verbatim; the same steps run as the `perps-performance-recipe` contract
+follow it verbatim; the same steps run as the `perps.performance-recipe` contract
 test.
 
 ### 1. Scaffold a personal library
 
 A library is a directory with a `library.json` marker. Keep reusable `flows/`
-(referenced via `call`) beside a `recipes/` folder for the full flows you run:
+(referenced via `call`) beside a domain-grouped `recipes/` folder for the full
+flows you run:
 
 ```bash
-mkdir -p ~/my-recipes/flows ~/my-recipes/recipes
+mkdir -p ~/my-recipes/flows ~/my-recipes/recipes/my-perps
 cat > ~/my-recipes/library.json <<'JSON'
 { "kind": "recipe-library", "schema_version": 1, "name": "mydev", "owner": "mydev" }
 JSON
@@ -130,8 +131,8 @@ it works headlessly (CI, a scratch checkout) and so the path is unambiguous.
 Copy it out of your runner checkout's `library/recipes/`:
 
 ```bash
-cp library/recipes/perps-performance.mobile.recipe.json \
-   ~/my-recipes/recipes/my-perps-performance.mobile.recipe.json
+cp library/recipes/perps/performance.mobile.recipe.json \
+   ~/my-recipes/recipes/my-perps/performance.mobile.recipe.json
 ```
 
 ### 3. Edit the nodes to your journey
@@ -211,33 +212,35 @@ field on flow catalog entries — not yet in the protocol.
 
 ### 4. Run it and read the timings
 
-Validate statically **by name** first — `run` probes each library source's `recipes/`
-directory in precedence order (personal → team → canonical), so `my-perps-performance`
-resolves from `~/my-recipes/recipes/` without you spelling out the path:
+Validate statically **by name** first — `run` probes each library source's
+`recipes/` directory in precedence order (personal → team → canonical), so
+`my-perps.performance` resolves from
+`~/my-recipes/recipes/my-perps/performance.mobile.recipe.json` without you
+spelling out the path:
 
 ```bash
 # Static validation by NAME — resolves from the personal library via --library.
-mm-harness run my-perps-performance \
+mm-harness run my-perps.performance \
   --library mydev=~/my-recipes --plan --adapter mobile
 
 # Zero-flag personal-library: when ~/my-recipes is placed at
 # $FARMSLOT_HOME/recipe-library (default ~/.farmslot/recipe-library), the runner
 # discovers it automatically and run-by-name works without --library:
-mm-harness run my-perps-performance --plan --adapter mobile
+mm-harness run my-perps.performance --plan --adapter mobile
 
 # Pinned live run — same device, healing OFF, so durations are comparable.
-mm-harness run my-perps-performance \
+mm-harness run my-perps.performance \
   --library mydev=~/my-recipes \
   --adapter mobile --device <serial> --heal off --artifacts-dir artifacts
 
 # Canonical start-state variants — same installed app, no rebuild.
-mm-harness run app-lifecycle-android-smoke \
+mm-harness run app.lifecycle.android-smoke \
   --adapter mobile --device <serial> --heal off --artifacts-dir artifacts/lifecycle-smoke
-mm-harness run perps-performance-warm-start \
+mm-harness run perps.performance.warm-start \
   --adapter mobile --device <serial> --heal off --artifacts-dir artifacts/warm
-mm-harness run perps-performance-background-resume \
+mm-harness run perps.performance.background-resume \
   --adapter mobile --device <serial> --heal off --artifacts-dir artifacts/background
-mm-harness run perps-performance-cold-start \
+mm-harness run perps.performance.cold-start \
   --adapter mobile --device <serial> --heal off --artifacts-dir artifacts/cold
 
 # Per-node durations to diff across runs (trace.json is an array of entries, or
@@ -249,7 +252,7 @@ node -e 'const t=require("./artifacts/trace.json"); \
 A miss with `--library` names the sources that were searched, so you can tell at a
 glance whether a typo or a missing library entry caused the failure.
 
-Run `app-lifecycle-android-smoke` first when validating a new Android slot; it
+Run `app.lifecycle.android-smoke` first when validating a new Android slot; it
 isolates lifecycle control from wallet setup and Perps navigation. The start-state
 variants use the standard outer `app.lifecycle` action. Every
 variant begins with `app.status` so `trace.json` records an idempotent start
@@ -294,5 +297,5 @@ mm-harness run my-perps-with-segment --plan --adapter mobile \
 ```
 
 That resolution — unresolved without the source, `pass` with it — is what the
-`perps-performance-recipe` contract test asserts, alongside the canonical recipe
+`perps.performance-recipe` contract test asserts, alongside the canonical recipe
 resolving by name and the personal mobile copy planning by path and basename.

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

@@ -68,7 +68,7 @@
         },
         "screenshot-after": {
           "action": "ui.screenshot",
-          "path": "screenshots/app-lifecycle-android-smoke.png",
+          "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",

package/library/recipes/{perps-performance.mobile.recipe.json → perps/performance.mobile.recipe.json}

@@ -1,7 +1,7 @@
 {
   "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.",
+  "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",

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

@@ -0,0 +1,39 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask core Perps smoke",
+  "description": "Non-mutating Perps domain smoke for the headless core adapter: instantiates the Perps controller and reads live positions, orders, and account state.",
+  "validate": {
+    "workflow": {
+      "entry": "status",
+      "nodes": {
+        "status": {
+          "action": "app.status",
+          "next": "read-positions",
+          "intent": "Resolve the core checkout and report headless compatibility mode"
+        },
+        "read-positions": {
+          "action": "metamask.perps.read_positions",
+          "mode": "all",
+          "next": "read-orders",
+          "intent": "Read live Perps positions from the headless controller"
+        },
+        "read-orders": {
+          "action": "metamask.perps.read_orders",
+          "mode": "all",
+          "next": "read-account",
+          "intent": "Read live Perps open orders from the headless controller"
+        },
+        "read-account": {
+          "action": "metamask.perps.read_account",
+          "next": "done",
+          "intent": "Read live Perps account state from the headless controller"
+        },
+        "done": {
+          "action": "end",
+          "status": "pass",
+          "intent": "Finish the core Perps smoke"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,51 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask Extension Perps smoke",
+  "description": "Non-mutating Perps domain smoke for MetaMask Extension: verifies CDP, unlocks if needed, opens the Perps page, and reads live Perps positions and orders.",
+  "validate": {
+    "workflow": {
+      "entry": "status",
+      "nodes": {
+        "status": {
+          "action": "app.status",
+          "next": "cdp",
+          "intent": "Resolve the Extension checkout and adapter status before Perps proof"
+        },
+        "cdp": {
+          "action": "cdp.target",
+          "required": true,
+          "timeout_ms": 15000,
+          "next": "ensure-unlocked",
+          "intent": "Confirm the Extension CDP runtime is reachable"
+        },
+        "ensure-unlocked": {
+          "action": "metamask.wallet.ensure_unlocked",
+          "timeout_ms": 45000,
+          "next": "open-perps",
+          "intent": "Ensure the wallet is unlocked before opening Perps"
+        },
+        "open-perps": {
+          "action": "ui.navigate",
+          "page": "perps",
+          "next": "read-positions",
+          "intent": "Open the Perps page through the stable page alias"
+        },
+        "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",
+          "next": "done",
+          "intent": "Read live Perps open orders without mutating account state"
+        },
+        "done": {
+          "action": "end",
+          "status": "pass",
+          "intent": "Finish the Extension Perps smoke"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,51 @@
+{
+  "schema_version": 1,
+  "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.",
+  "validate": {
+    "workflow": {
+      "entry": "status",
+      "nodes": {
+        "status": {
+          "action": "app.status",
+          "next": "cdp",
+          "intent": "Resolve the Mobile checkout and adapter status before Perps proof"
+        },
+        "cdp": {
+          "action": "cdp.target",
+          "required": true,
+          "timeout_ms": 15000,
+          "next": "ensure-unlocked",
+          "intent": "Confirm the React Native debug bridge is reachable"
+        },
+        "ensure-unlocked": {
+          "action": "metamask.wallet.ensure_unlocked",
+          "timeout_ms": 45000,
+          "next": "open-perps",
+          "intent": "Ensure the wallet is unlocked before opening Perps"
+        },
+        "open-perps": {
+          "action": "ui.navigate",
+          "page": "perps",
+          "next": "read-positions",
+          "intent": "Open the Perps market list through the stable page alias"
+        },
+        "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",
+          "next": "done",
+          "intent": "Read live Perps open orders without mutating account state"
+        },
+        "done": {
+          "action": "end",
+          "status": "pass",
+          "intent": "Finish the Mobile Perps smoke"
+        }
+      }
+    }
+  }
+}

package/library/recipes/{action-validation.extension.recipe.json → runner/action-validation.extension.recipe.json}

@@ -8,9 +8,9 @@
       "nodes": {
         "prepare-files": {
           "action": "command",
-          "cmd": "mkdir -p temp/recipe-action-validation && printf 'E2E_ACTION_VALIDATION extension\\n' > temp/recipe-action-validation/probe.txt && printf '{\"platform\":\"extension\",\"ok\":true}\n' > temp/recipe-action-validation/probe.json && printf 'extension log E2E_ACTION_VALIDATION\\n' > temp/recipe-action-validation/validation.log && echo E2E_ACTION_VALIDATION extension",
+          "cmd": "mkdir -p temp/recipe-runner.action-validation && printf 'E2E_ACTION_VALIDATION extension\\n' > temp/recipe-runner.action-validation/probe.txt && printf '{\"platform\":\"extension\",\"ok\":true}\n' > temp/recipe-runner.action-validation/probe.json && printf 'extension log E2E_ACTION_VALIDATION\\n' > temp/recipe-runner.action-validation/validation.log && echo E2E_ACTION_VALIDATION extension",
           "next": "assert-command-exit",
-          "intent": "Prepare action-validation probe files",
+          "intent": "Prepare runner.action-validation probe files",
           "detail": "Create local files used to prove command/assert/log/artifact actions.",
           "flow": "setup"
         },
@@ -35,7 +35,7 @@
         },
         "assert-file": {
           "action": "assert_file",
-          "path": "temp/recipe-action-validation/probe.txt",
+          "path": "temp/recipe-runner.action-validation/probe.txt",
           "contains": "E2E_ACTION_VALIDATION extension",
           "next": "assert-json",
           "intent": "Verify file assertions work",
@@ -44,7 +44,7 @@
         },
         "assert-json": {
           "action": "assert_json",
-          "path": "temp/recipe-action-validation/probe.json",
+          "path": "temp/recipe-runner.action-validation/probe.json",
           "assert": {
             "path": "$.platform",
             "operator": "eq",
@@ -57,7 +57,7 @@
         },
         "watch-logs": {
           "action": "watch_logs",
-          "path": "temp/recipe-action-validation/validation.log",
+          "path": "temp/recipe-runner.action-validation/validation.log",
           "contains": "E2E_ACTION_VALIDATION",
           "next": "index-artifacts",
           "intent": "Verify log watching works",
@@ -68,7 +68,7 @@
           "action": "index_artifacts",
           "artifacts": [
             {
-              "path": "temp/recipe-action-validation/probe.txt",
+              "path": "temp/recipe-runner.action-validation/probe.txt",
               "type": "log",
               "category": "debug",
               "label": "Extension action validation probe"
@@ -173,7 +173,7 @@
         },
         "ui-screenshot-perps": {
           "action": "ui.screenshot",
-          "path": "screenshots/extension-perps-action-validation.png",
+          "path": "screenshots/extension-perps-runner.action-validation.png",
           "timeout_ms": 5000,
           "next": "wallet-navigate-perps",
           "intent": "Capture Perps visual proof",

package/library/recipes/{action-validation.mobile.recipe.json → runner/action-validation.mobile.recipe.json}

@@ -8,9 +8,9 @@
       "nodes": {
         "prepare-files": {
           "action": "command",
-          "cmd": "mkdir -p temp/recipe-action-validation && printf 'E2E_ACTION_VALIDATION mobile\\n' > temp/recipe-action-validation/probe.txt && printf '{\"platform\":\"mobile\",\"ok\":true}\n' > temp/recipe-action-validation/probe.json && printf 'mobile log E2E_ACTION_VALIDATION\\n' > temp/recipe-action-validation/validation.log && echo E2E_ACTION_VALIDATION mobile",
+          "cmd": "mkdir -p temp/recipe-runner.action-validation && printf 'E2E_ACTION_VALIDATION mobile\\n' > temp/recipe-runner.action-validation/probe.txt && printf '{\"platform\":\"mobile\",\"ok\":true}\n' > temp/recipe-runner.action-validation/probe.json && printf 'mobile log E2E_ACTION_VALIDATION\\n' > temp/recipe-runner.action-validation/validation.log && echo E2E_ACTION_VALIDATION mobile",
           "next": "assert-command-exit",
-          "intent": "Prepare action-validation probe files",
+          "intent": "Prepare runner.action-validation probe files",
           "detail": "Create local files used to prove command/assert/log/artifact actions.",
           "flow": "setup"
         },
@@ -35,7 +35,7 @@
         },
         "assert-file": {
           "action": "assert_file",
-          "path": "temp/recipe-action-validation/probe.txt",
+          "path": "temp/recipe-runner.action-validation/probe.txt",
           "contains": "E2E_ACTION_VALIDATION mobile",
           "next": "assert-json",
           "intent": "Verify file assertions work",
@@ -44,7 +44,7 @@
         },
         "assert-json": {
           "action": "assert_json",
-          "path": "temp/recipe-action-validation/probe.json",
+          "path": "temp/recipe-runner.action-validation/probe.json",
           "assert": {
             "path": "$.platform",
             "operator": "eq",
@@ -57,7 +57,7 @@
         },
         "watch-logs": {
           "action": "watch_logs",
-          "path": "temp/recipe-action-validation/validation.log",
+          "path": "temp/recipe-runner.action-validation/validation.log",
           "contains": "E2E_ACTION_VALIDATION",
           "next": "index-artifacts",
           "intent": "Verify log watching works",
@@ -68,7 +68,7 @@
           "action": "index_artifacts",
           "artifacts": [
             {
-              "path": "temp/recipe-action-validation/probe.txt",
+              "path": "temp/recipe-runner.action-validation/probe.txt",
               "type": "log",
               "category": "debug",
               "label": "Mobile action validation probe"
@@ -174,7 +174,7 @@
         },
         "ui-screenshot-wallet": {
           "action": "ui.screenshot",
-          "path": "screenshots/mobile-wallet-action-validation.png",
+          "path": "screenshots/mobile-wallet-runner.action-validation.png",
           "next": "wallet-navigate-perps",
           "intent": "Capture wallet visual proof",
           "detail": "Save a screenshot artifact after generic UI actions.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -69,4 +69,4 @@
     "url": "https://github.com/MetaMask/experimental-metamask-harness/issues"
   },
   "homepage": "https://github.com/MetaMask/experimental-metamask-harness#readme"
-}
+}