@deeeed/metamask-harness 0.15.0 → 0.15.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.15.1 - 2026-07-13
+
+### Fixed
+
+- `doctor --fix` recovery `nextActions` (numbered fixture choices, overlay install, runtime-context retry) now embed the resolved `--adapter` and absolute `--target`, shell-quoted, so each command works verbatim from any cwd. They are also prefixed with the resolved `bin/mm-harness` executable path, so they work in task-local installs where `mm-harness` is not on PATH.
+
 ## 0.15.0 - 2026-07-13
 
 ### Changed

package/bin/mm-harness

@@ -50,6 +50,13 @@ if [ -n "${MM_HARNESS_BIN:-}" ]; then
   fi
 fi
 
+# Internal executable identity (not part of the public env surface): the CLI
+# embeds this in emitted recovery commands so they run verbatim even when
+# mm-harness is not on PATH (task-local installs). Set AFTER the MM_HARNESS_BIN
+# delegation above so the final executable entered always overwrites any
+# inherited/stale value with its own resolved self path.
+export MM_HARNESS_EXECUTABLE="$SCRIPT_DIR/$(basename "$SOURCE")"
+
 ENTRY_TS="$RUNNER_DIR/src/mm-harness-cli.ts"
 ENTRY_DIST="$RUNNER_DIR/dist/mm-harness-cli.js"
 

package/dist/commands/doctor.js

@@ -4,7 +4,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { color } from "../cli-color.js";
 import { createDoctorReport, fixtureSummary, renderRuntimeContext, requiredDoctorCheckSummary } from "../doctor.js";
-import { detectAdapter } from "../harness.js";
+import { detectAdapter, resolveRuntimeContextPath } from "../harness.js";
 import { assertAdapter, runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { ensureMobilePerpsEnvironment, mobilePerpsEnvironment } from "../adapters/mobile/perps-env.js";
@@ -27,6 +27,7 @@ import {
   applyRuntimeDirOption,
   optionFlag,
   optionString,
+  shellQuote,
   targetPath
 } from "./parse-args.js";
 function applyDoctorRuntimePorts(options) {
@@ -95,7 +96,7 @@ async function handleDoctor({ options }) {
       lock.release();
     }
     const result2 = createDoctorReport(adapter, target, manifestValidation, actionManifestPath);
-    const nextActions = doctorFixNextActions(failed, result2.fixture);
+    const nextActions = doctorFixNextActions(failed, result2.fixture, adapter, target);
     const status = result2.status === "pass" && failed.length === 0 ? "pass" : "fail";
     if (json) console.log(JSON.stringify({ ...result2, status, fixed, failed, nextActions }, null, 2));
     else {
@@ -215,15 +216,21 @@ function doctorRuntimeCheck(runtime, error, expectLive) {
     detail: runtime?.reasons.join(" | ") || "Runtime readiness probe returned no result."
   };
 }
-function doctorFixNextActions(failed, fixture) {
+function doctorFixNextActions(failed, fixture, adapter, target) {
   const actions = [];
+  const executable = process.env.MM_HARNESS_EXECUTABLE ? shellQuote(process.env.MM_HARNESS_EXECUTABLE) : "mm-harness";
+  const scope = `--adapter ${adapter} --target ${shellQuote(target)}`;
   if (failed.includes("wallet-fixture")) {
     const force = fixture.status === "invalid" || fixture.status === "incomplete" ? " --force" : "";
-    actions.push(`1) mm-harness fixtures init --from <path>${force}   # existing team/test fixture`);
-    actions.push(`2) mm-harness fixtures init --dev${force}           # disposable public test wallet; never real funds`);
+    actions.push(`1) ${executable} fixtures init --from <path>${force} ${scope}   # existing team/test fixture`);
+    actions.push(`2) ${executable} fixtures init --dev${force} ${scope}           # disposable public test wallet; never real funds`);
   }
-  if (failed.includes("runtime-context")) actions.push("inspect temp/recipe/runtime/agentic-runtime.json, then retry mm-harness doctor --fix");
-  if (failed.includes("overlay")) actions.push("mm-harness install --target .");
+  if (failed.includes("runtime-context")) {
+    actions.push(
+      `inspect ${shellQuote(resolveRuntimeContextPath(target))}, then retry ${executable} doctor --fix ${scope}`
+    );
+  }
+  if (failed.includes("overlay")) actions.push(`${executable} install ${scope}`);
   return actions;
 }
 function emitExpectLiveVerdict(adapter, target, runtime, verdict) {
@@ -389,6 +396,7 @@ function readTextSnapshot(file) {
   }
 }
 export {
+  doctorFixNextActions,
   ensureExtensionPerpsBuildFlag,
   handleDoctor
 };

package/package.json

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