@deeeed/metamask-harness 0.14.5 → 0.14.7

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Changelog
 
-## Unreleased
+## 0.14.7 - 2026-07-10
+
+### Changed
+- `doctor --print-ready` now implies the exit-coded live probe — Farmslot `health_check` hooks need only `--print-ready`, not `--expect-live --print-ready`.
+- Mobile `--print-ready` uses bridge `walletState` (unlocked + live bridge), not React Navigation route names; mobile `ready_indicator` is `OK`.
+- Removed `metamask-recipe` install symlinks from adapter inject paths (no compat aliases).
+- `doctor --print-ready` rejects `--json` (stdout is reserved for the Farmslot indicator line).
+
+### Fixed
+- Mobile `surface.runtimeStatus` infers Android from `ADB_SERIAL` / `ANDROID_SERIAL` when present.
+
+## 0.14.6 - 2026-07-10
+
+### Added
+- `mm-harness doctor --print-ready` — Farmslot `health_check` mode: prints `health.ready_indicator` on stdout (`extension`/`mobile`: `OK`; `core`: `ready`).
+- `doctor --expect-live` — exit-coded liveness gate without indicator output (prepare recovery and other pass/fail callers).
 
 ## 0.14.5 - 2026-07-10
 

package/dist/adapters/mobile/surface.js

@@ -12,7 +12,8 @@ const mobileSurface = {
   },
   async runtimeStatus(target) {
     const watcherPort = process.env.WATCHER_PORT ? parseInt(process.env.WATCHER_PORT, 10) : void 0;
-    const report = await mobileRuntimeStatus(target, { watcherPort });
+    const platform = process.env.ADB_SERIAL || process.env.ANDROID_SERIAL ? "android" : "ios";
+    const report = await mobileRuntimeStatus(target, { watcherPort, platform });
     const runwayProvisioned = hasRunwayProvisionBaseline(target);
     const depsPending = runwayProvisioned && report.checks?.deps?.status !== "current";
     return {

package/dist/cli-commands.js

@@ -16,7 +16,7 @@ const SPEC = {
     { name: "debug", aliases: ["devtools", "inspect"], desc: "Open DevTools UI", flags: ["--json", "--no-open"] },
     { name: "fixtures", desc: "Manage the canonical wallet fixture (sync/set/generate)", args: ["sync", "set", "generate"], flags: ["--fixture", "--out", "--adapter", "--target", "--device", "--json"] },
     { name: "actions", desc: "List runnable recipe actions", flags: ["--json"] },
-    { name: "doctor", desc: "Check harness/orchestration health", flags: ["--json", "--target", "--adapter", "--runtime-dir", "--expect-live", "--cdp-port", "--device"] },
+    { name: "doctor", desc: "Check harness/orchestration health", flags: ["--json", "--target", "--adapter", "--runtime-dir", "--expect-live", "--print-ready", "--cdp-port", "--device"] },
     { name: "run", desc: "Execute a proof recipe (path or library name, e.g. run perps.smoke)", args: ["recipe.json|name"], flags: ["--list", "--device"] },
     { name: "recipe-quality", desc: "Build the recipe-quality artifact from compact JSON", args: ["build"], flags: ["--input", "--output", "--json"] },
     { name: "interactive", aliases: ["menu"], desc: "Interactive command menu" },

package/dist/commands/doctor.js

@@ -15,6 +15,7 @@ import {
   renderMobileDeviceList,
   renderMobileLiveBlock
 } from "./mobile-device-view.js";
+import { farmslotReadyIndicator } from "./farmslot-ready.js";
 import { ADAPTER_DETECT_NEXT, EXIT, usageOut } from "./shared.js";
 import {
   actionManifestPathOption,
@@ -40,7 +41,8 @@ async function handleDoctor({ options }) {
   applyRuntimeDirOption(options);
   const target = targetPath(options);
   const json = optionFlag(options, "json");
-  const expectLive = optionFlag(options, "expectLive");
+  const printReady = optionFlag(options, "printReady");
+  const expectLive = optionFlag(options, "expectLive") || printReady;
   const allDevices = optionFlag(options, "allDevices");
   const platformOption = optionString(options, "platform");
   const explicitAdapter = optionString(options, "adapter") ?? (platformOption === "ios" || platformOption === "android" ? "mobile" : platformOption);
@@ -49,6 +51,14 @@ async function handleDoctor({ options }) {
     return usageOut(json, "doctor", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
   }
   assertAdapter(adapter);
+  if (printReady && json) {
+    return usageOut(
+      json,
+      "doctor",
+      "--print-ready owns stdout for Farmslot health_check; drop --json (use --expect-live --json for the doctor envelope)",
+      "mm-harness doctor --print-ready --adapter <adapter> --target <path>"
+    );
+  }
   const actionManifestPath = actionManifestPathOption(options, adapter);
   const manifest = loadActionManifest(adapter, optionString(options, "actionManifest"));
   const manifestValidation = await validateManifest(manifest);
@@ -80,7 +90,20 @@ async function handleDoctor({ options }) {
   const liveView = deviceView ? await mobileDeviceLiveView(target, deviceView) : null;
   const devices = liveView?.devicesWithLive ?? deviceView?.devices ?? [];
   const additionalReachableDevices = liveView?.additionalReachableDevices ?? [];
-  if (expectLive) return emitExpectLive(adapter, target, runtime, result, orphanMetros, capture, devices, additionalReachableDevices, json);
+  if (expectLive) {
+    return emitExpectLive(
+      adapter,
+      target,
+      runtime,
+      result,
+      orphanMetros,
+      capture,
+      devices,
+      additionalReachableDevices,
+      json,
+      printReady
+    );
+  }
   if (json) console.log(JSON.stringify({ ...result, runtime, orphanMetros, capture, devices, additionalReachableDevices }, null, 2));
   else {
     const out = (style, text) => color(style, text, { stream: process.stdout });
@@ -119,8 +142,28 @@ async function handleDoctor({ options }) {
   }
   return result.status === "pass" ? 0 : 1;
 }
-function emitExpectLive(adapter, target, runtime, result, orphanMetros, capture, devices, additionalReachableDevices, json) {
+function emitExpectLiveVerdict(adapter, target, runtime, verdict) {
+  const out = (style, text) => color(style, text, { stream: process.stderr });
+  const detail = runtime ? `${runtime.decision}${runtime.reasonCode ? ` (${runtime.reasonCode})` : ""}` : "runtime probe unavailable";
+  console.error(`${out("err", verdict)} ${out("bold", adapter)} ${detail} ${out("dim", target)}`);
+  for (const reason of runtime?.reasons ?? []) console.error(`  ${out("dim", reason)}`);
+  console.error(`  Next: ${getAdapterSurface(adapter).hints.relaunch}`);
+}
+function emitExpectLive(adapter, target, runtime, result, orphanMetros, capture, devices, additionalReachableDevices, json, printReady) {
   const live = runtime?.decision === "ready";
+  if (printReady) {
+    if (live) {
+      const indicator = farmslotReadyIndicator(adapter, devices);
+      if (indicator) {
+        console.log(indicator);
+        return EXIT.ok;
+      }
+      emitExpectLiveVerdict(adapter, target, runtime, "not-ready");
+      return EXIT.runtime;
+    }
+    emitExpectLiveVerdict(adapter, target, runtime, "not-live");
+    return EXIT.runtime;
+  }
   if (json) {
     console.log(JSON.stringify({ ...result, runtime, orphanMetros, capture, devices, additionalReachableDevices }, null, 2));
     return live ? EXIT.ok : EXIT.runtime;
@@ -130,10 +173,7 @@ function emitExpectLive(adapter, target, runtime, result, orphanMetros, capture,
     console.log(`${out("ok", "live")} ${out("bold", adapter)} runtime ready`);
     return EXIT.ok;
   }
-  const detail = runtime ? `${runtime.decision}${runtime.reasonCode ? ` (${runtime.reasonCode})` : ""}` : "runtime probe unavailable";
-  console.error(`${out("err", "not-live")} ${out("bold", adapter)} ${detail} ${out("dim", target)}`);
-  for (const reason of runtime?.reasons ?? []) console.error(`  ${out("dim", reason)}`);
-  console.error(`  Next: ${getAdapterSurface(adapter).hints.relaunch}`);
+  emitExpectLiveVerdict(adapter, target, runtime, "not-live");
   return EXIT.runtime;
 }
 function captureHelperHealth() {

package/dist/commands/farmslot-ready.js

@@ -0,0 +1,25 @@
+function selectedDevice(devices) {
+  return devices.find((d) => d.selected) ?? devices[0];
+}
+function mobileWalletReady(device) {
+  if (device.liveState === "no-bridge" || device.liveState === "bridge-absent") return false;
+  return device.walletState === "unlocked";
+}
+function farmslotReadyIndicator(adapter, devices) {
+  switch (adapter) {
+    case "extension":
+      return "OK";
+    case "core":
+      return "ready";
+    case "mobile": {
+      const device = selectedDevice(devices);
+      if (!device) return "";
+      return mobileWalletReady(device) ? "OK" : "";
+    }
+    default:
+      return "";
+  }
+}
+export {
+  farmslotReadyIndicator
+};

package/dist/commands/parse-args.js

@@ -29,6 +29,7 @@ function parseArgs(argv, command) {
     "force",
     "resolveOnly",
     "expectLive",
+    "printReady",
     "fast",
     "allDevices",
     "help"

package/dist/mm-harness-cli.js

@@ -171,19 +171,20 @@ 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
+  --expect-live                      Exit-coded liveness gate only (human verdict on stderr). Use without --print-ready when callers need pass/fail without a Farmslot indicator line
+  --print-ready                      Farmslot health_check mode: implies --expect-live and prints health.ready_indicator on stdout (extension/mobile: OK; core: ready)
   --cdp-port <port>                  Extension CDP port for the liveness probe (env: CDP_PORT / RECIPE_CDP_PORT)
   --device <udid|serial|name>        Mobile only: target this device (env: IOS_SIMULATOR / ADB_SERIAL). doctor reports the connected devices; it never gates on ambiguity.
   --all-devices                      Mobile only: show every connected device instead of the slot-scoped target
   --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
+  --json                             Machine-readable output (incompatible with --print-ready)
 
 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 extension --target /path/to/checkout --cdp-port 6662 --print-ready
   mm-harness doctor --adapter mobile --target /path/to/checkout`
   },
   {

package/package.json

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