@deeeed/metamask-harness 0.14.5 → 0.15.0

package/library/manifests/extension.action-manifest.json

@@ -118,7 +118,7 @@
           },
           "hash": {
             "type": "string",
-            "description": "Raw extension hash, e.g. #/?tab=perps."
+            "description": "Raw extension hash, e.g. #/perps-home."
           },
           "path": {
             "type": "string",
@@ -148,7 +148,7 @@
           "description": "Fallback to a raw extension hash when no alias exists",
           "node": {
             "action": "ui.navigate",
-            "hash": "#/?tab=perps",
+            "hash": "#/perps-home",
             "intent": "Open a raw extension route"
           }
         }
@@ -190,6 +190,24 @@
     },
     "ui.wait_for": {
       "description": "Wait for a UI condition through the Extension CDP adapter.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": { "const": "ui.wait_for" },
+          "selector": { "type": "string" },
+          "text": { "type": "string" },
+          "expected": {
+            "type": "string",
+            "enum": ["present", "absent", "visible", "hidden", "not_present"]
+          },
+          "visible": {
+            "type": "boolean",
+            "description": "Convenience alias: true means expected=visible; false means expected=absent."
+          },
+          "timeout_ms": { "type": "number" }
+        },
+        "required": ["action"]
+      },
       "examples": [
         {
           "node": {
@@ -197,11 +215,20 @@
             "text": "Perps",
             "intent": "Wait for visible Extension text"
           }
+        },
+        {
+          "node": {
+            "action": "ui.wait_for",
+            "selector": "[data-testid=example]",
+            "visible": false,
+            "timeout_ms": 2000,
+            "intent": "Prove an Extension element is absent"
+          }
         }
       ]
     },
     "ui.screenshot": {
-      "description": "Capture visual evidence through capture-helper snapshot; the runner registers the screenshot artifact automatically. CDP/DOM-raster fallback is not valid Extension evidence.",
+      "description": "Capture registered visual evidence through capture-helper, bounded Chrome-native capture, or an explicitly labeled computed-style DOM raster fallback. Always read the resulting PNG; artifact metadata records the provider.",
       "examples": [
         {
           "node": {
@@ -1717,15 +1744,8 @@
             }
           },
           "page": {
-            "oneOf": [
-              {
-                "type": "string"
-              },
-              {
-                "const": false
-              }
-            ],
-            "description": "Final page target; false skips navigation for teardown."
+            "type": "string",
+            "description": "Initial Perps page target; omit it to use the profile or market default. Extension start_state always enters Perps before convergence."
           },
           "positions": {
             "oneOf": [

package/library/manifests/mobile.action-manifest.json

@@ -191,6 +191,20 @@
     },
     "ui.wait_for": {
       "description": "Wait for a mounted React Native testID/test_id. Optional text validates text returned by that testID; text alone is not supported on Mobile.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": { "const": "ui.wait_for" },
+          "test_id": { "type": "string" },
+          "text": { "type": "string" },
+          "expected": {
+            "type": "string",
+            "enum": ["present", "absent", "hidden", "not_present"]
+          },
+          "timeout_ms": { "type": "number" }
+        },
+        "required": ["action", "test_id"]
+      },
       "examples": [
         {
           "node": {
@@ -199,11 +213,19 @@
             "expected": "present",
             "intent": "Wait for a React Native testID to be mounted"
           }
+        },
+        {
+          "node": {
+            "action": "ui.wait_for",
+            "test_id": "conditional-banner",
+            "expected": "absent",
+            "intent": "Prove a React Native testID is not mounted"
+          }
         }
       ]
     },
     "ui.screenshot": {
-      "description": "Capture visual evidence through the platform adapter; the runner registers the screenshot artifact automatically.",
+      "description": "Capture registered PNG evidence with xcrun simctl on iOS or adb screencap on Android. Artifact metadata records the native provider, command mode, and selected device; invalid or empty PNG output fails before registration.",
       "examples": [
         {
           "node": {
@@ -676,7 +698,7 @@
       ]
     },
     "metamask.perps.start_state": {
-      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that composes reusable domain operations before the proof window.",
+      "description": "Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that first restores the fixture-backed unlocked wallet, then composes reusable domain operations before the proof window.",
       "examples": [
         {
           "description": "Clean BTC testnet market state",
@@ -1689,7 +1711,7 @@
     {
       "name": "metamask.perps.start_state",
       "owner": "metamask",
-      "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that composes reusable domain operations before the proof window.",
+      "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that first restores the fixture-backed unlocked wallet, then composes reusable domain operations before the proof window.",
       "schema": {
         "type": "object",
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.14.5",
+  "version": "0.15.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -16,9 +16,9 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/agent-runtime": "^0.1.1",
-    "@farmslot/protocol": "^0.7.6",
-    "@farmslot/recipe-harness": "^0.4.3",
+    "@farmslot/agent-runtime": "^0.2.0",
+    "@farmslot/protocol": "^0.8.0",
+    "@farmslot/recipe-harness": "^0.5.0",
     "commander": "^12.0.0",
     "viem": "^2.54.3",
     "ws": "8.21.0"

package/scripts/completions.sh

@@ -29,7 +29,7 @@ _mmh_bin() {
   return 1
 }
 
-_mmh_commands="launch stop logs debug fixtures actions call flows run doctor install verify cleanup completions"
+_mmh_commands="launch stop logs debug fixtures actions call flows run doctor check checklist recipe-quality install verify cleanup completions"
 
 # Per-command flags (static, from the mm-harness surface).
 _mmh_flags_for() {
@@ -38,7 +38,8 @@ _mmh_flags_for() {
     stop)     printf '%s' "--port --target --json" ;;
     logs)     printf '%s' "--full --events --source --adapter --target --json" ;;
     debug)    printf '%s' "--worker --dev-menu --adapter --target --json" ;;
-    fixtures) printf '%s' "--fixture --adapter --target --json" ;;
+    fixtures) printf '%s' "--from --dev --force --fixture --adapter --target --json" ;;
+    checklist) printf '%s' "" ;;
     actions)  printf '%s' "--adapter --action --kind --raw --action-manifest --target --json" ;;
     call)     printf '%s' "--arg --adapter --target --artifacts-dir --action-manifest --heal --json" ;;
     flows)    printf '%s' "--library --json" ;;
@@ -76,7 +77,8 @@ if [ -n "${BASH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "ios android" -- "$cur")) ;;
-      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "sync set" -- "$cur")) ;;
+      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")) ;;
@@ -110,7 +112,8 @@ if [ -n "${ZSH_VERSION:-}" ]; then
 
     case "$cmd" in
       launch)      (( CURRENT == 3 )) && { candidates=(ios android); compadd -a candidates; } ;;
-      fixtures)    (( CURRENT == 3 )) && { candidates=(sync set); compadd -a candidates; } ;;
+      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; } ;;