@deeeed/metamask-harness 0.18.0 → 0.19.0

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

@@ -1,26 +1,24 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Core runner smoke",
   "description": "Proves the headless Core runner resolves the checkout, executes generic actions, and writes a valid artifact package.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "package",
-          "intent": "Resolve the Core checkout and report headless readiness"
-        },
-        "package": {
-          "action": "assert_file",
-          "path": "package.json",
-          "next": "done",
-          "intent": "Prove generic project-file assertions work in Core"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "package",
+        "intent": "Resolve the Core checkout and report headless readiness"
+      },
+      "package": {
+        "action": "assert_file",
+        "path": "package.json",
+        "next": "done",
+        "intent": "Prove generic project-file assertions work in Core"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

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

@@ -1,30 +1,29 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Extension v1 runner smoke",
   "description": "Proves the MetaMask Extension runner executes manifest-declared actions and writes a valid artifact package.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Perform status for the recipe"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "cdp",
-          "intent": "Perform fixture for the recipe"
-        },
-        "cdp": {
-          "action": "cdp.target",
-          "next": "done",
-          "intent": "Perform cdp for the recipe"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "fixture",
+        "intent": "Confirm the Extension checkout is ready"
+      },
+      "fixture": {
+        "action": "metamask.wallet.fixture_status",
+        "next": "cdp",
+        "intent": "Confirm the wallet fixture is available"
+      },
+      "cdp": {
+        "action": "cdp.target",
+        "required": true,
+        "next": "done",
+        "intent": "Confirm the Extension runtime is reachable"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

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

@@ -1,30 +1,29 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Mobile v1 runner smoke",
   "description": "Proves the MetaMask Mobile runner executes manifest-declared actions and writes a valid artifact package.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Perform status for the recipe"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "cdp",
-          "intent": "Perform fixture for the recipe"
-        },
-        "cdp": {
-          "action": "cdp.target",
-          "next": "done",
-          "intent": "Perform cdp for the recipe"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "fixture",
+        "intent": "Confirm the Mobile checkout is ready"
+      },
+      "fixture": {
+        "action": "metamask.wallet.fixture_status",
+        "next": "cdp",
+        "intent": "Confirm the wallet fixture is available"
+      },
+      "cdp": {
+        "action": "cdp.target",
+        "require_reachable": true,
+        "next": "done",
+        "intent": "Confirm the Mobile runtime is reachable"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

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

@@ -1,41 +1,39 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Extension wallet smoke",
   "description": "Fixture-backed proof that the Extension wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Confirm the Extension runtime is reachable"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "unlock",
-          "intent": "Confirm the checkout wallet fixture is ready"
-        },
-        "unlock": {
-          "action": "metamask.wallet.ensure_unlocked",
-          "next": "state",
-          "intent": "Ensure the fixture-backed wallet is unlocked"
-        },
-        "state": {
-          "action": "metamask.wallet.read_state",
-          "next": "screenshot",
-          "intent": "Read the current wallet state through the public adapter"
-        },
-        "screenshot": {
-          "action": "ui.screenshot",
-          "path": "screenshots/wallet-smoke.png",
-          "next": "done",
-          "intent": "Capture visual wallet evidence"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "fixture",
+        "intent": "Confirm the Extension runtime is reachable"
+      },
+      "fixture": {
+        "action": "metamask.wallet.fixture_status",
+        "next": "unlock",
+        "intent": "Confirm the checkout wallet fixture is ready"
+      },
+      "unlock": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "next": "state",
+        "intent": "Ensure the fixture-backed wallet is unlocked"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "next": "screenshot",
+        "intent": "Read the current wallet state through the public adapter"
+      },
+      "screenshot": {
+        "action": "ui.screenshot",
+        "path": "screenshots/wallet-smoke.png",
+        "next": "done",
+        "intent": "Record the visible wallet state as evidence"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

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

@@ -1,41 +1,39 @@
 {
-  "schema_version": 1,
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Mobile wallet smoke",
   "description": "Fixture-backed proof that the Mobile wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
-  "validate": {
-    "workflow": {
-      "entry": "status",
-      "nodes": {
-        "status": {
-          "action": "app.status",
-          "next": "fixture",
-          "intent": "Confirm the Mobile runtime is reachable"
-        },
-        "fixture": {
-          "action": "metamask.wallet.fixture_status",
-          "next": "unlock",
-          "intent": "Confirm the checkout wallet fixture is ready"
-        },
-        "unlock": {
-          "action": "metamask.wallet.ensure_unlocked",
-          "next": "state",
-          "intent": "Ensure the fixture-backed wallet is unlocked"
-        },
-        "state": {
-          "action": "metamask.wallet.read_state",
-          "next": "screenshot",
-          "intent": "Read the current wallet state through the public adapter"
-        },
-        "screenshot": {
-          "action": "ui.screenshot",
-          "path": "screenshots/wallet-smoke.png",
-          "next": "done",
-          "intent": "Capture visual wallet evidence"
-        },
-        "done": {
-          "action": "end",
-          "status": "pass"
-        }
+  "workflow": {
+    "entry": "status",
+    "nodes": {
+      "status": {
+        "action": "app.status",
+        "next": "fixture",
+        "intent": "Confirm the Mobile runtime is reachable"
+      },
+      "fixture": {
+        "action": "metamask.wallet.fixture_status",
+        "next": "unlock",
+        "intent": "Confirm the checkout wallet fixture is ready"
+      },
+      "unlock": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "next": "state",
+        "intent": "Ensure the fixture-backed wallet is unlocked"
+      },
+      "state": {
+        "action": "metamask.wallet.read_state",
+        "next": "screenshot",
+        "intent": "Read the current wallet state through the public adapter"
+      },
+      "screenshot": {
+        "action": "ui.screenshot",
+        "path": "screenshots/wallet-smoke.png",
+        "next": "done",
+        "intent": "Record the visible wallet state as evidence"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -20,8 +20,8 @@
   },
   "dependencies": {
     "@farmslot/agent-runtime": "^0.2.0",
-    "@farmslot/protocol": "^0.10.0",
-    "@farmslot/recipe-harness": "^0.8.0",
+    "@farmslot/protocol": "^0.11.0",
+    "@farmslot/recipe-harness": "^0.9.0",
     "commander": "^12.0.0",
     "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",

package/scripts/completions.sh

@@ -29,7 +29,7 @@ _mmh_bin() {
   return 1
 }
 
-_mmh_commands="launch stop logs debug fixtures actions call flows run doctor check checklist recipe-quality install verify cleanup completions"
+_mmh_commands="launch stop logs debug fixtures actions call run doctor check checklist recipe-quality install verify cleanup completions"
 
 # Per-command flags (static, from the mm-harness surface).
 _mmh_flags_for() {
@@ -42,7 +42,6 @@ _mmh_flags_for() {
     checklist) printf '%s' "" ;;
     actions)  printf '%s' "--adapter --action --kind --raw --action-manifest --target --json" ;;
     call)     printf '%s' "--list --arg --adapter --target --artifacts-dir --action-manifest --heal --json" ;;
-    flows)    printf '%s' "--library --json" ;;
     run)      printf '%s' "--list --describe --plan --adapter --artifacts-dir --target --library --cdp-port --heal --record-video --json" ;;
     doctor)   printf '%s' "--adapter --target --fix --json" ;;
     install|verify|cleanup) printf '%s' "--adapter --target --json" ;;
@@ -80,7 +79,6 @@ if [ -n "${BASH_VERSION:-}" ]; then
       fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set generate finalize" -- "$cur")) ;;
       checklist)   [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "mark" -- "$cur")) ;;
       completions) [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "install bash zsh status" -- "$cur")) ;;
-      flows)       [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "list promote" -- "$cur")) ;;
       call)        [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "$(_mmh_actions)" -- "$cur")) ;;
       run)         COMPREPLY=($(compgen -f -- "$cur"; compgen -W "$(_mmh_recipes)" -- "$cur")) ;;
       *)           COMPREPLY=($(compgen -W "$(_mmh_flags_for "$cmd")" -- "$cur")) ;;
@@ -115,7 +113,6 @@ if [ -n "${ZSH_VERSION:-}" ]; then
       fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set generate finalize); compadd -a candidates; } ;;
       checklist)   (( CURRENT == 3 )) && { candidates=(mark); compadd -a candidates; } ;;
       completions) (( CURRENT == 3 )) && { candidates=(install bash zsh status); compadd -a candidates; } ;;
-      flows)       (( CURRENT == 3 )) && { candidates=(list promote); compadd -a candidates; } ;;
       call)        (( CURRENT == 3 )) && { candidates=("${(@f)$(_mmh_actions)}"); compadd -a candidates; } ;;
       run)         candidates=("${(@f)$(_mmh_recipes)}"); compadd -a candidates; _files ;;
       *)           candidates=(${=$(_mmh_flags_for "$cmd")}); compadd -a candidates ;;

package/dist/adapters/extension/harness-freshness.js

@@ -1,39 +0,0 @@
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { recipeHarnessPath, runnerDir } from "../../paths.js";
-async function ensureExtensionHarnessFresh(target) {
-  if (!fs.existsSync(path.join(target, "package.json"))) return;
-  let current;
-  try {
-    const mod = await import(pathToFileURL(path.join(runnerDir, "adapters/shared/harness-source-fingerprint.mjs")).href);
-    current = mod.harnessSourceFingerprint(runnerDir);
-  } catch {
-    return;
-  }
-  const manifestPath = recipeHarnessPath(target, "extension", "manifest.json");
-  const installed = readInstalledFingerprint(manifestPath);
-  if (installed === current) return;
-  const reason = installed === null ? "harness not installed" : "runner changed";
-  try {
-    execFileSync(process.execPath, [path.join(runnerDir, "adapters/extension/inject.mjs"), "--target", target], {
-      stdio: ["ignore", "ignore", "inherit"]
-    });
-    console.error(`\u2192 refreshed extension harness overlay (${reason})`);
-  } catch (error) {
-    const detail = error instanceof Error ? `: ${error.message}` : "";
-    throw new Error(`could not refresh the extension harness overlay (${reason})${detail}`);
-  }
-}
-function readInstalledFingerprint(manifestPath) {
-  try {
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-    return typeof manifest.sourceFingerprint === "string" ? manifest.sourceFingerprint : null;
-  } catch {
-    return null;
-  }
-}
-export {
-  ensureExtensionHarnessFresh
-};

package/dist/commands/flows.js

@@ -1,91 +0,0 @@
-import path from "node:path";
-import { color } from "../cli-color.js";
-import { importRecipeHarnessCli } from "../paths.js";
-import { EXIT } from "./shared.js";
-import { parseArgs, usageError } from "./parse-args.js";
-import { resolveMetaMaskLibrarySources } from "./run-engine.js";
-const FLOWS_SUBCOMMANDS = ["list", "describe", "promote"];
-function stripFrontOnlyFlags(argv) {
-  const out = [];
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--target" || arg === "--library") {
-      i += 1;
-      continue;
-    }
-    if (arg.startsWith("--target=") || arg.startsWith("--library=")) continue;
-    out.push(arg);
-  }
-  return out;
-}
-function serializeLibrarySources(sources) {
-  return sources.map((source) => source.name ? `${source.name}=${source.root}` : source.root).join(":");
-}
-function flowSourceTier(source, index, total) {
-  if (index === total - 1 && source.name === "metamask") return "canonical";
-  if (source.name === "personal") return "personal";
-  return "team";
-}
-function restoreEnv(key, value) {
-  if (value === void 0) delete process.env[key];
-  else process.env[key] = value;
-}
-function libraryEntries(argv) {
-  const entries = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const argument = argv[index];
-    if (argument === "--library") {
-      const value = argv[index + 1];
-      if (value !== void 0) entries.push(value);
-      index += 1;
-    } else if (argument.startsWith("--library=")) {
-      entries.push(argument.slice("--library=".length));
-    }
-  }
-  return entries;
-}
-async function handleFlows(argv) {
-  const { positional } = parseArgs(argv);
-  const subcommand = positional[0];
-  if (subcommand === "describe" && !positional[1]) {
-    throw usageError("flows describe requires <ref>. Next: mm-harness flows list");
-  }
-  if (subcommand !== "describe" && positional[1]) {
-    throw usageError(`flows ${subcommand ?? "list"} does not accept positional ${positional[1]}.`);
-  }
-  const configuredLibraries = libraryEntries(argv);
-  const sources = await resolveMetaMaskLibrarySources(configuredLibraries);
-  if (!sources) {
-    throw usageError(
-      "flows requires @farmslot/recipe-harness >= 0.3.3 (recipe-library support; flows resolve personal > team > canonical). Next: update the dependency and run yarn install."
-    );
-  }
-  const forwarded = stripFrontOnlyFlags(argv);
-  const jsonMode = forwarded.includes("--json");
-  if (!jsonMode) {
-    console.error(color("label", "flows resolve by precedence (highest wins; local shadows canonical):"));
-    sources.forEach((source, index) => {
-      const name = source.name ?? path.basename(source.root);
-      console.error(`  ${index + 1}. ${color("cmd", name)} ${color("dim", `[${flowSourceTier(source, index, sources.length)}]`)}`);
-    });
-  }
-  const resolvedSubcommand = subcommand && FLOWS_SUBCOMMANDS.includes(subcommand) ? subcommand : "list";
-  const forwardedSubcommandIndex = forwarded.indexOf(resolvedSubcommand);
-  const delegatedArgs = forwardedSubcommandIndex === -1 ? forwarded : forwarded.filter((_, index) => index !== forwardedSubcommandIndex);
-  const withSubcommand = [resolvedSubcommand, ...delegatedArgs];
-  const { runRecipeHarnessCli } = await importRecipeHarnessCli();
-  const previousLibraryPath = process.env.RECIPE_LIBRARY_PATH;
-  const previousExitCode = process.exitCode;
-  process.env.RECIPE_LIBRARY_PATH = serializeLibrarySources(sources);
-  process.exitCode = void 0;
-  try {
-    await runRecipeHarnessCli(["flows", ...withSubcommand], { commandName: "mm-harness" });
-    return typeof process.exitCode === "number" ? process.exitCode : EXIT.ok;
-  } finally {
-    restoreEnv("RECIPE_LIBRARY_PATH", previousLibraryPath);
-    process.exitCode = previousExitCode;
-  }
-}
-export {
-  handleFlows
-};

package/library/flows/perps.flows.json

@@ -1,64 +0,0 @@
-{
-  "schema_version": 1,
-  "kind": "recipe-flow-catalog",
-  "owner": "metamask.perps",
-  "flows": {
-    "perps.clean_market_testnet": {
-      "version": 1,
-      "description": "Converge Perps to a clean testnet baseline before a proof window: wallet unlocked, requested market selected, no open positions or orders for that market.",
-      "paramsSchema": {
-        "type": "object",
-        "required": ["market"],
-        "properties": {
-          "market": {
-            "type": "string",
-            "description": "Market symbol to converge, e.g. BTC."
-          },
-          "provider": {
-            "type": "string",
-            "description": "Optional Perps provider, e.g. hyperliquid; omit for the app default."
-          }
-        }
-      },
-      "requiresActions": ["metamask.wallet.ensure_unlocked", "metamask.perps.start_state"],
-      "defaultPhase": "start_state",
-      "defaultRecord": "trace_only",
-      "postcondition": { "path": "$.status", "operator": "eq", "value": "pass" },
-      "workflow": {
-        "entry": "ensure-wallet",
-        "nodes": {
-          "ensure-wallet": {
-            "action": "metamask.wallet.ensure_unlocked",
-            "intent": "Ensure the wallet is unlocked before converging the Perps baseline",
-            "next": "start-state"
-          },
-          "start-state": {
-            "action": "metamask.perps.start_state",
-            "intent": "Converge Perps to a clean {{params.market}} testnet baseline",
-            "profile": "clean_market_testnet",
-            "network": "testnet",
-            "provider": "{{params.provider}}",
-            "market": "{{params.market}}",
-            "positions": { "state": "none", "mode": "matching" },
-            "orders": { "state": "none", "mode": "matching" },
-            "next": "done"
-          },
-          "done": { "action": "end", "status": "pass" }
-        }
-      },
-      "examples": [
-        {
-          "description": "Clean BTC testnet baseline before a visual proof",
-          "node": {
-            "action": "call",
-            "ref": "perps.clean_market_testnet",
-            "params": { "market": "BTC" },
-            "phase": "start_state",
-            "record": "trace_only",
-            "intent": "Converge Perps to a clean BTC testnet baseline before proof"
-          }
-        }
-      ]
-    }
-  }
-}