@deeeed/metamask-harness 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.6.2 - 2026-07-06
+
+### Added
+- **`-v` / `--version`** prints the mm-harness version.
+
+### Fixed
+- **`logs` now streams live and shows the file path** — it captured output via spawnSync (never shown for a `tail -F` that doesn't exit), so `logs`/`logs --full` looked dead. New spawnInherit hands the terminal to the follow; the resolved log path + `tail -f`/`less +F` hints print upfront so you can page it yourself. Honors the test override seam.
+- **`debug` resolves the checkout's own port** (slot context → pool → formula) like launch/stop/doctor — bare `mm-harness debug` no longer 'fetch failed' against the wrong port.
+
 ## 0.6.1 - 2026-07-06
 
 Fresh-install fixes found live on a published-0.6.0 install.
@@ -10,6 +19,7 @@ Fresh-install fixes found live on a published-0.6.0 install.
 
 ### Internal
 - Reap-checkout-metros test hardened against a SIGTERM timing flake (polls for exit).
+
 ## 0.6.0 - 2026-07-06
 
 Minor release: CLI hardening (decomposed, single-parser, dist-only) plus a
@@ -41,6 +51,7 @@ independently cross-reviewed.
   `ensure_unlocked` fails teaching `fixtures set` on an un-onboarded wallet instead
   of vacuously passing (mobile + extension); `provision --json` usage errors emit the
   standard envelope; deps-not-ready teaches a command that works on a bare checkout.
+
 ## 0.5.1 - 2026-07-05
 
 Fresh-install hotfixes found in live validation of 0.5.0.

package/dist/commands/debug.js

@@ -11,6 +11,7 @@ async function handleDebug(argv) {
   if (!adapter) return usageOut(json, "debug", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
   const surface = getAdapterSurface(adapter);
   if (surface.headless) return usageOut(json, "debug", "core is headless; there is no debug console.", surface.hints.relaunch);
+  surface.resolveSlotPorts(target);
   const worker = flag(options, "worker");
   const devMenu = flag(options, "devMenu");
   if (adapter === "mobile" && worker) {

package/dist/commands/logs.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { ADAPTER_DETECT_NEXT, EXIT, flag, parseFlags, resolveAdapter, spawnScript, str, targetOf, usageOut } from "./shared.js";
+import { ADAPTER_DETECT_NEXT, EXIT, flag, parseFlags, resolveAdapter, spawnInherit, str, targetOf, usageOut } from "./shared.js";
 const LOGS_BOOLEANS = /* @__PURE__ */ new Set(["full", "json"]);
 async function handleLogs(argv) {
   const { options } = parseFlags(argv, LOGS_BOOLEANS);
@@ -43,30 +43,28 @@ async function handleLogs(argv) {
       surface.hints.launch
     );
   }
+  if (json) {
+    console.log(JSON.stringify({ schemaVersion: 1, command: "logs", adapter, source, logFile, exitCode: EXIT.ok }, null, 2));
+    return EXIT.ok;
+  }
+  process.stderr.write(
+    `${source} log: ${logFile}
+  tail it yourself: tail -f ${logFile}   \xB7   page it: less +F ${logFile}
+  following below (Ctrl-C to stop) \u2026
+`
+  );
   const full = flag(options, "full");
   if (full) {
-    const result2 = spawnScript("tail", ["-n", "+1", "-F", logFile], target, json);
-    return result2.status === 0 ? EXIT.ok : EXIT.runtime;
+    return spawnInherit("tail", ["-n", "+1", "-F", logFile], target) === 0 ? EXIT.ok : EXIT.runtime;
   }
   const logTui = path.join(runnerDir, "adapters/shared/log-tui.mjs");
   const eventCount = process.env.RECIPE_LOG_EVENTS ?? "20";
   const uiMode = process.env.RECIPE_LOG_UI_MODE ?? "compact";
-  const result = spawnScript(
+  return spawnInherit(
     process.execPath,
     [logTui, "tail", "--log", logFile, "--events", eventCount, "--follow", "--mode", uiMode],
-    target,
-    json
-  );
-  if (json) {
-    console.log(
-      JSON.stringify(
-        { schemaVersion: 1, command: "logs", adapter, source, logFile, exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
-        null,
-        2
-      )
-    );
-  }
-  return result.status === 0 ? EXIT.ok : EXIT.runtime;
+    target
+  ) === 0 ? EXIT.ok : EXIT.runtime;
 }
 export {
   handleLogs

package/dist/commands/shared.js

@@ -85,6 +85,27 @@ function spawnScript(script, args, cwd, json, env) {
   if (!json && output) process.stderr.write(output);
   return { status: result.status ?? 1, output };
 }
+function spawnInherit(script, args, cwd) {
+  const isNodeScript = script === process.execPath && args.length > 0;
+  const stem = (isNodeScript ? path.basename(args[0]) : path.basename(script)).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
+  const override = process.env[`MM_HARNESS_SCRIPT_BIN_${stem}`];
+  const bin = override ?? script;
+  const directArgs = override !== void 0 && isNodeScript ? args.slice(1) : args;
+  const { bin: invokeBin, args: spawnArgs } = resolveLeafInvoke(bin, directArgs);
+  const result = spawnSync(invokeBin, spawnArgs, { cwd, stdio: "inherit", env: process.env });
+  if (result.error) {
+    const leaf = isNodeScript ? path.basename(args[0]) : path.basename(script);
+    const code = result.error.code ?? "ESPAWN";
+    process.stderr.write(
+      `leaf could not start: ${leaf} (${code})
+  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the leaf is missing or not executable
+`
+    );
+    return 1;
+  }
+  if (result.status !== null) return result.status;
+  return result.signal === "SIGINT" || result.signal === "SIGTERM" ? 0 : 1;
+}
 function spawnScriptStreaming(script, args, cwd, env) {
   const isNodeScript = script === process.execPath && args.length > 0;
   const stem = isNodeScript ? path.basename(args[0]).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase() : path.basename(script).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
@@ -149,6 +170,7 @@ export {
   flag,
   parseFlags,
   resolveAdapter,
+  spawnInherit,
   spawnScript,
   spawnScriptStreaming,
   str,

package/dist/mm-harness-cli.js

@@ -469,8 +469,15 @@ function translateActionsRaw(argv) {
   const withJson = rest.includes("--json") ? rest : [...rest, "--json"];
   return ["manifest", ...withJson];
 }
+const pkgVersion = (() => {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8")).version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+})();
 const program = new Command();
-program.name("mm-harness").description("the MetaMask recipe harness: launch the app, prove behavior, manage the runtime overlay").helpOption("-h, --help", "Show grouped help").showHelpAfterError("(run `mm-harness --help` for the full surface)").configureHelp({ formatHelp: () => groupedHelp() });
+program.name("mm-harness").description("the MetaMask recipe harness: launch the app, prove behavior, manage the runtime overlay").version(pkgVersion, "-v, --version", "Print the mm-harness version").helpOption("-h, --help", "Show grouped help").showHelpAfterError("(run `mm-harness --help` for the full surface)").configureHelp({ formatHelp: () => groupedHelp() });
 for (const command of REAL) {
   program.command(command.name).description(command.summary).allowUnknownOption().helpOption("-h, --help", "Show command help").configureHelp({ formatHelp: () => `${command.helpText}
 ` }).argument("[args...]").action(async () => {

package/package.json

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