@deeeed/metamask-harness 0.6.3 → 0.7.1

package/dist/mm-harness-cli.js

@@ -18,6 +18,7 @@ const REAL = [
 
   List the action vocabulary + field schemas for the checkout adapter.
 
+  --action <name>                    Describe one action; fuzzy-resolves like call (short or full name)
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --raw                              Dump raw action registry JSON
@@ -25,6 +26,7 @@ const REAL = [
 
 Example:
   mm-harness actions --adapter mobile
+  mm-harness actions --adapter mobile --action assert_orders
   mm-harness actions --adapter extension --raw`
   },
   {
@@ -41,6 +43,7 @@ Example:
     core       headless \u2014 no dev server to stop (teaching error)
 
   --port <port>                      Dev-server port (default: the checkout's slot context)
+  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -59,11 +62,13 @@ Example:
   if unique; ambiguous = exit 2. 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)
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Where to write evidence (default: temp dir)
   --action-manifest <path>           Override the action manifest
+  --library <name=path>              Add/override a recipe-library source (repeatable)
   --heal <off|infra-only|auto>       Healing policy (default: infra-only); auto-ensures the overlay
   --json                             Machine-readable output
 
@@ -96,10 +101,13 @@ Example:
 
   Validate + run a recipe and write evidence (summary / trace / artifacts).
 
+  --list                             List everything invocable for the adapter (actions + flows); no <recipe> needed
   --plan                             Validate + print execution plan, touching nothing. Exit 5 if invalid.
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Where to write evidence (required unless --plan)
+  --action-manifest <path>           Override the action manifest
+  --library <name=path>              Add/override a recipe-library source (repeatable)
   --heal <off|infra-only|auto>       Healing policy (default: infra-only); auto-ensures the overlay
   --json                             Machine-readable output
   --record-video=full-run            Record a video of the run
@@ -118,13 +126,17 @@ Example:
   sections so there is no hunting for files.
 
   --fix                              Repair the overlay/runtime-context WITHOUT launching (no fixture reseed); --json adds fixed[]/failed[]
+  --expect-live                      Exit 0 iff the runtime is live (extension: watcher+CDP; mobile: Metro+bridge; core: deps), non-zero + teaching escape otherwise
+  --cdp-port <port>                  Extension CDP port for the liveness probe (env: CDP_PORT / RECIPE_CDP_PORT)
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
+  --runtime-dir <dir>                Runtime dir containing agentic-runtime.json (relative to target)
   --json                             Machine-readable output
 
 Example:
   mm-harness doctor
   mm-harness doctor --fix --json
+  mm-harness doctor --adapter extension --target /path/to/checkout --cdp-port 6662 --expect-live
   mm-harness doctor --adapter mobile --target /path/to/checkout`
   },
   {
@@ -238,6 +250,7 @@ Example:
   --runway                           Post-launch runway check (mobile only; teaching error elsewhere)
   --watch                            Persistent webpack watcher then relaunch (extension only)
   --sidepanel | --fullscreen         Extension display mode (default --fullscreen)
+  --url <dapp-url>                    Open a dapp in the main tab beside the sidepanel (extension only)
   --heal <off|infra-only|auto>       Healing policy (default auto); bounds always enforced
   --device <udid|name>               Target simulator/device (env: IOS_SIMULATOR / ADB_SERIAL)
   --cdp-port <port>                  Extension CDP port (env: CDP_PORT / RECIPE_CDP_PORT)
@@ -261,6 +274,7 @@ Example:
   Teaching error if nothing is running (points at launch).
 
   --full                             Raw log tail (default = compact) (env: RECIPE_LOG_UI)
+  --window                           (Re)open the read-only tmux tail window for the resolved dev-server port (leaves the process untouched)
   --events <n>                       Compact event count (default 10) (env: RECIPE_LOG_EVENTS)
   --source <label>                   Log source per adapter \u2014 mobile: metro|app (default metro);
                                      extension: webpack|watcher|rebuild|app (default webpack).
@@ -271,7 +285,8 @@ Example:
 
 Example:
   mm-harness logs
-  mm-harness logs --full`
+  mm-harness logs --full
+  mm-harness logs --window`
   },
   {
     name: "debug",

package/dist/paths.js

@@ -47,6 +47,9 @@ function recipeWatchLogCandidates() {
 }
 function resolveLocalProtocolRoot() {
   const candidates = [
+    // Orchestrator-neutral name is primary; FARMSLOT_ROOT stays a back-compat alias
+    // for one release (the installer injects METAMASK_RUNNER_PROTOCOL_ROOT).
+    process.env.METAMASK_RUNNER_PROTOCOL_ROOT,
     process.env.FARMSLOT_ROOT,
     readConfiguredProtocolRoot(),
     findProtocolRoot(runnerDir),
@@ -59,7 +62,7 @@ function resolveRequiredLocalProtocolRoot(reason) {
   const root = resolveLocalProtocolRoot();
   if (!root) {
     throw new Error(
-      `${reason} requires a local protocol/runtime checkout. Set FARMSLOT_ROOT or create .farmslot-root for this dev-only path.`
+      `${reason} requires a local protocol/runtime checkout. Set METAMASK_RUNNER_PROTOCOL_ROOT (or the legacy FARMSLOT_ROOT), or create .farmslot-root for this dev-only path.`
     );
   }
   return root;

package/package.json

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