@deeeed/metamask-harness 0.17.1 → 0.17.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.17.2 - 2026-07-15
+
+### Fixed
+
+- Passive update discovery now runs in a detached, once-daily registry probe, so fast commands populate the cache without adding latency or contaminating machine output.
+
+## 0.17.1 - 2026-07-15
+
 ### Fixed
 
 - Extension `debug` now uses Chrome's native DevTools command for the active slot target and opens directly on Console; `debug --worker` targets the service worker without creating a frontend browser tab.
@@ -20,8 +28,6 @@
 - Removed compatibility-only runtime-start fields, hidden `live` execution, removed-command handlers, undomained recipe aliases, flat/non-ESM action lookup, old port-resolver filenames, duplicate Extension launcher naming, obsolete fixture search locations, and the alternate Mobile product-source bridge. Mobile install now requires the current product-owned bridge and writes metadata only.
 - Removed the historical CLI migration/spec documents; current behavior is documented in the README, cheatsheet, architecture, and human QA checklist.
 
-## 0.17.1 - 2026-07-14
-
 ### Fixed
 
 - Human recipe results now print an absolute-path artifact inventory and expand run-scoped application diagnostics inline; single-action calls show the same `CLEAN`/`REVIEW` diagnostics instead of requiring another query.

package/adapters/shared/update-check-worker.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+
+const [cacheFile, timeoutText, endpointOverride] = process.argv.slice(2);
+const timeoutMs = Number.parseInt(timeoutText ?? '', 10);
+const endpoint = endpointOverride
+  ?? 'https://registry.npmjs.org/-/package/%40deeeed%2Fmetamask-harness/dist-tags';
+
+async function main() {
+  if (!cacheFile || !Number.isInteger(timeoutMs) || timeoutMs < 1) return;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(endpoint, { signal: controller.signal });
+    if (!response.ok) return;
+    const data = await response.json();
+    if (!data || typeof data.latest !== 'string' || data.latest.length === 0) return;
+    let lastCheck = Date.now();
+    try {
+      const cached = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+      if (typeof cached.lastCheck === 'number') lastCheck = cached.lastCheck;
+    } catch {
+      // The parent may have exited before creating the cache; recreate it below.
+    }
+    fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
+    const temporary = `${cacheFile}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, JSON.stringify({ lastCheck, latest: data.latest }));
+    fs.renameSync(temporary, cacheFile);
+  } catch {
+    // Passive checks are intentionally silent; the explicit update command teaches failures.
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+await main();

package/dist/commands/update.js

@@ -1,4 +1,4 @@
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -6,7 +6,7 @@ import { runnerDir } from "../paths.js";
 import { EXIT, flag, parseFlags } from "./shared.js";
 const PACKAGE_NAME = "@deeeed/metamask-harness";
 const NUDGE_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-const NUDGE_FETCH_TIMEOUT_MS = 300;
+const NUDGE_FETCH_TIMEOUT_MS = 2e3;
 function currentVersion() {
   try {
     const pkg = JSON.parse(fs.readFileSync(path.join(runnerDir, "package.json"), "utf8"));
@@ -56,24 +56,6 @@ function fetchLatest(timeoutMs) {
   if (!latest) return { error: { kind: "unreachable", message: "npm returned no dist-tag for latest" } };
   return { latest };
 }
-async function fetchLatestAsync(timeoutMs) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const url = `https://registry.npmjs.org/-/package/${encodeURIComponent(PACKAGE_NAME)}/dist-tags`;
-    const res = await fetch(url, { signal: controller.signal });
-    if (!res.ok) return { error: { kind: "unreachable", message: `registry returned HTTP ${res.status}` } };
-    const data = await res.json();
-    const latest = data["latest"];
-    if (!latest) return { error: { kind: "unreachable", message: "npm registry returned no latest dist-tag" } };
-    return { latest };
-  } catch (err) {
-    const msg = err.name === "AbortError" ? `registry fetch timed out after ${timeoutMs}ms` : err.message;
-    return { error: { kind: "unreachable", message: msg } };
-  } finally {
-    clearTimeout(timer);
-  }
-}
 function teachFailure(json, current, code, message, userAction) {
   if (json) {
     console.log(
@@ -211,23 +193,28 @@ function nudgeDisabled() {
 function nudgeLine(current, latest) {
   return isNewer(latest, current) ? `mm-harness ${current} \u2192 ${latest} available \xB7 run: mm-harness update` : null;
 }
-async function maybeNudge(now = Date.now()) {
+function maybeNudge(now = Date.now()) {
   if (nudgeDisabled()) return;
   const file = cacheFile();
   const cache = readCache(file);
   const current = currentVersion();
-  let latest = cache?.latest ?? "";
   process.once("exit", () => {
-    const line = nudgeLine(current, latest);
+    const line = nudgeLine(current, cache?.latest ?? "");
     if (line) process.stderr.write(`${line}
 `);
   });
   if (!cache || now - cache.lastCheck >= NUDGE_INTERVAL_MS) {
-    writeCache(file, { lastCheck: now, latest });
-    const fetched = await fetchLatestAsync(NUDGE_FETCH_TIMEOUT_MS);
-    if (fetched.latest) {
-      latest = fetched.latest;
-      writeCache(file, { lastCheck: now, latest });
+    writeCache(file, { lastCheck: now, latest: cache?.latest ?? "" });
+    const worker = path.join(runnerDir, "adapters", "shared", "update-check-worker.mjs");
+    if (!fs.existsSync(worker)) return;
+    try {
+      const child = spawn(
+        process.execPath,
+        [worker, file, String(NUDGE_FETCH_TIMEOUT_MS)],
+        { detached: true, stdio: "ignore" }
+      );
+      child.unref();
+    } catch {
     }
   }
 }

package/dist/mm-harness-cli.js

@@ -696,7 +696,7 @@ program.command("completions").description("Install/print bundled shell tab-comp
 });
 const NUDGE_SKIP = ["update", "completions", "completion-candidates"];
 if (rawArgv.length > 0 && !NUDGE_SKIP.includes(rawArgv[0])) {
-  setImmediate(() => void maybeNudge());
+  maybeNudge();
 }
 function hasPassthroughHelp(argv) {
   const divider = argv.indexOf("--");

package/package.json

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