@deeeed/metamask-harness 0.29.1 → 0.29.3

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.29.3 - 2026-08-01
+
+### Fixed
+
+- Preserve immutable harness snapshots during runner dependency bootstrap by installing from the repository's pinned Yarn lock without build scripts or inherited product Yarn settings, while recognizing dependencies hoisted by `npx`.
+
+## 0.29.2 - 2026-08-01
+
+### Changed
+
+- Upgrade `@farmslot/recipe-harness` to 0.11.1 so iOS lifecycle terminate and restart remain idempotent when Simulator reports that it found nothing to terminate.
+
 ## 0.29.1 - 2026-08-01
 
 ### Added

package/adapters/manifest.json

@@ -414,7 +414,7 @@
       "id": "lib/ensure-runner-deps",
       "entry": "adapters/shared/ensure-runner-deps.sh",
       "kind": "lib",
-      "purpose": "Idempotent install of runner npm deps (@farmslot/recipe-harness) for cloned checkouts with no node_modules; uses npm so parent product .yarnrc.yml does not block install.",
+      "purpose": "Idempotent install of runner dependencies from its immutable Yarn lock; isolates runner settings so parent product .yarnrc.yml does not block install.",
       "inputs": "ensure-runner-deps.sh [RUNNER_DIR]; env FARMSLOT_ROOT / METAMASK_RUNNER_PROTOCOL_ROOT optional local link target",
       "outputs": "installed node_modules in RUNNER_DIR; exit 0 when deps ready"
     },

package/adapters/shared/ensure-runner-deps.sh

@@ -1,10 +1,9 @@
 #!/usr/bin/env bash
-# ensure-runner-deps.sh — idempotent install of runner npm dependencies.
+# ensure-runner-deps.sh — idempotent install of runner dependencies.
 #
 # Source checkout runs TypeScript via Node/tsx and imports @farmslot/recipe-harness.
-# Cloned runner checkouts under product temp/ often have no node_modules; parent
-# product repos may ship a .yarnrc.yml that the runner's pinned Yarn rejects, so
-# use npm here (not yarn install).
+# Cloned runner checkouts under product temp/ often have no node_modules, so use
+# the runner's pinned Yarn release and immutable lockfile.
 #
 # Usage: ensure-runner-deps.sh [RUNNER_DIR]
 # Env:   FARMSLOT_ROOT / METAMASK_RUNNER_PROTOCOL_ROOT — optional local link target
@@ -73,22 +72,31 @@ if [ -n "$PROTOCOL_ROOT" ] && [ -f "$RUNNER_DIR/scripts/link-local-farmslot.mjs"
   fi
 fi
 
-echo "mm-harness: installing runner dependencies via npm in $RUNNER_DIR" >&2
+echo "mm-harness: installing runner dependencies via Yarn in $RUNNER_DIR" >&2
 (
   cd "$RUNNER_DIR"
   umask 022
-  npm_config_cache="${MM_HARNESS_NPM_CACHE:-${TMPDIR:-/tmp}/mm-harness-npm-cache-${UID:-$(id -u)}}" \
-    npm install --ignore-scripts >&2
+  COREPACK_BIN="$(type -P corepack || true)"
+  if [ -z "$COREPACK_BIN" ]; then
+    echo "mm-harness: Corepack is required to install runner dependencies" >&2
+    echo "Next: npm install -g corepack && corepack enable" >&2
+    exit 1
+  fi
+  YARN_RC_FILENAME=.mm-harness-runner.yml \
+    YARN_NODE_LINKER=node-modules \
+    YARN_ENABLE_GLOBAL_CACHE=false \
+    YARN_CACHE_FOLDER="$RUNNER_DIR/.yarn/cache" \
+    "$COREPACK_BIN" yarn install --immutable --mode=skip-build >&2
 )
 
-# npm may replace the local protocol links with registry packages. Restore the
+# Yarn may replace the local protocol links with registry packages. Restore the
 # explicit co-development override after the complete dependency tree exists.
 if [ -n "$PROTOCOL_ROOT" ] && [ -f "$RUNNER_DIR/scripts/link-local-farmslot.mjs" ]; then
   FARMSLOT_ROOT="$PROTOCOL_ROOT" node "$RUNNER_DIR/scripts/link-local-farmslot.mjs" >&2
 fi
 
 if ! deps_ready; then
-  echo "mm-harness: runner dependencies still missing after npm install: $RUNNER_DIR" >&2
+  echo "mm-harness: runner dependencies still missing after Yarn install: $RUNNER_DIR" >&2
   exit 1
 fi
 

package/adapters/shared/runner-deps-ready.mjs

@@ -13,10 +13,17 @@ if (!runnerDir) process.exit(1);
 const pkg = JSON.parse(
   fs.readFileSync(path.join(runnerDir, 'package.json'), 'utf8'),
 );
+const requireFromRunner = createRequire(path.join(runnerDir, 'package.json'));
+const installedPackageSuffix = path.join(
+  'node_modules',
+  ...pkg.name.split('/'),
+);
+const acceptsHoistedDependencies = path
+  .resolve(runnerDir)
+  .endsWith(`${path.sep}${installedPackageSuffix}`);
 
 let dependencyVersionSatisfies;
 try {
-  const requireFromRunner = createRequire(path.join(runnerDir, 'package.json'));
   const helperPath = requireFromRunner.resolve(
     '@farmslot/recipe-harness/runtime/deps-readiness',
   );
@@ -52,17 +59,29 @@ function isOverrideLink(packageDir) {
   }
 }
 
+function resolveInstalledPackage(name) {
+  const moduleDirs = acceptsHoistedDependencies
+    ? (requireFromRunner.resolve.paths(name) ?? [])
+    : [path.join(runnerDir, 'node_modules')];
+  for (const moduleDir of moduleDirs) {
+    const packageDir = path.join(moduleDir, ...name.split('/'));
+    const installedPath = path.join(packageDir, 'package.json');
+    if (fs.existsSync(installedPath)) {
+      return {
+        packageDir,
+        installed: JSON.parse(fs.readFileSync(installedPath, 'utf8')),
+      };
+    }
+  }
+  return null;
+}
+
 const invalid = Object.entries(pkg.dependencies ?? {}).filter(
   ([name, request]) => {
-    const packageDir = path.join(
-      runnerDir,
-      'node_modules',
-      ...name.split('/'),
-    );
-    const installedPath = path.join(packageDir, 'package.json');
-    if (!fs.existsSync(installedPath)) return true;
-    if (isOverrideLink(packageDir)) return false;
-    const installed = JSON.parse(fs.readFileSync(installedPath, 'utf8'));
+    const resolved = resolveInstalledPackage(name);
+    if (!resolved) return true;
+    if (isOverrideLink(resolved.packageDir)) return false;
+    const { installed } = resolved;
     return !dependencyVersionSatisfies(installed.version, request);
   },
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.29.1",
+  "version": "0.29.3",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -23,7 +23,7 @@
     "@farmslot/agent-runtime": "^0.5.0",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "^0.15.0",
-    "@farmslot/recipe-harness": "^0.11.0",
+    "@farmslot/recipe-harness": "^0.11.1",
     "commander": "^12.0.0",
     "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",