@deeeed/metamask-harness 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,13 +1,24 @@
 # Changelog
 
-## 0.5.0 - 2026-07-05
+## 0.5.1 - 2026-07-05
 
-Minor release: thin Runway provisioning (harness-owned slot provisioning with a shared artifact cache) plus compiled-dist packaging.
+Fresh-install hotfixes found in live validation of 0.5.0.
+
+### Fixed
+- **First launch on a provisioned slot targets the slot's own simulator** — the mobile resolution ladder now reads the `runway-provision.json` baseline (simulator name/udid, watcher port, slot id) when `agentic-runtime.json` doesn't exist yet, and boots that simulator. Previously a provisioned-but-unprepared slot degraded to the simctl `booted` alias, missed the installed dev client, and guessed the wrong Metro port.
+- **`call` works from published installs** — library actions load harness helpers through a dist-preferring bridge instead of importing `src/index.ts` (node refuses to type-strip `.ts` under `node_modules`). The bridge is deliberately narrow (paths + run-recording) to avoid an import cycle through `adapters.ts`.
+- **deps-not-ready guidance matches the caller's state** — on a checkout without node_modules the taught command now leads with `yarn install --immutable` (yarn cannot run scripts at all on a bare checkout), and always ends with the launch re-run.
 
+## Unreleased
+
+### Changed
+- **resolve-farmslot-ports is TypeScript-first** — pool/context/formula port resolution lives in self-contained `adapters/shared/resolve-farmslot-ports-core.mjs` (works from runner and injected overlay copies); `src/adapters/resolve-farmslot-ports.ts` re-exports it for `slot-ports.ts`. `resolve-farmslot-ports.mjs` is the node leaf; `resolve-farmslot-ports.sh` remains a thin bash-compat wrapper for sourced callers.
+
+## 0.5.0 - 2026-07-05
+Minor release: thin Runway provisioning (harness-owned slot provisioning with a shared artifact cache) plus compiled-dist packaging.
 ### Added
 - **`mm-harness provision runway`** — provisions a mobile slot with exactly: resolve the latest Runway (expo-dev-build) artifact, download it ONCE into a shared machine cache (`~/.cache/metamask-harness/runway/<runId>/`, sha256+size integrity, corrupt entries re-downloaded, never a slot failure), create the simulator if missing, install the dev client on it. Zero yarn/deps/Metro — those stay dispatch-time (lazy, presence-authoritative readiness unchanged). `install --runway` is the overlay-path equivalent (covered by its own contract test). Baseline recorded so doctor reports provisioned-but-deps-pending as a normal state.
 - **Compiled `dist/` for published installs** — the npm tarball ships esbuild-compiled JS; `npm i -g` installs run the dist entry (~0.21s cold vs ~0.37s tsx). Source checkouts without `dist/` keep the tsx dev path; `bin/mm-harness` prefers dist when present. Packaging contract test (pack → global install → dist entry runs).
-
 ### Changed
 - Runway provisioning callers (farm installer, mobile-farm `runway` prepare profile) delegate to the harness; the profile no longer runs a deps phase and a contract test enforces that.
 
@@ -50,6 +61,9 @@ Minor release: the adapter-surface architecture plus the day's feature wave (0.3
 - Add `mm-harness provision runway ios --resolve-only` to return Runway run/revision/artifact metadata without touching simulator, cache, download, install, or baseline state.
 - **Dist publish path** — `npm run build` compiles `src/` to `dist/`; `npm pack` / global install runs the compiled CLI entry (`dist/mm-harness-cli.js`) while a source checkout without `dist/` keeps the tsx+src dev path. Contracts: `packaging-dist-install`, `packaging-dev-checkout`.
 
+### Changed
+- **Leaf stderr hints use mm-harness verbs** — Metro/webpack compact-log prefixes, log-tail hints, and speed-ladder copy now point at `mm-harness logs`, `mm-harness doctor`, `mm-harness launch`, and `mm-harness install` instead of retired `recipe *` commands. Contract: `leaf-branding-retired`.
+
 ### Fixed
 - `mm-harness provision runway ios` now routes through the same Runway provisioning surface as `install --runway`, so overlay dispatch accepts the compatibility command instead of rejecting it as an unsupported harness action.
 - Runway provisioning now accepts farm context flags (`--slot`, `--watcher-port`, `--runtime-dir`), records slot/watcher/runtime-dir baselines correctly, ignores stale provision baselines unless the app is still installed on the simulator, and emits rerunnable `Next:` commands from the actual invocation.

package/adapters/extension/inject.mjs

@@ -108,6 +108,8 @@ copyFile(path.join(runnerDir, 'adapters/extension/ensure-browser.sh'), path.join
 copyFile(path.join(runnerDir, 'adapters/shared/harness-path.sh'), path.join(harnessDir, 'scripts/lib/harness-path.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/activate-repo-node.sh'), path.join(harnessDir, 'scripts/lib/activate-repo-node.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports.sh'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports.sh'));
+copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports.mjs'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports.mjs'));
+copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports-core.mjs'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports-core.mjs'));
 copyFile(path.join(runnerDir, 'adapters/shared/path-defaults.json'), path.join(harnessDir, 'scripts/lib/path-defaults.json'));
 copyFile(path.join(runnerDir, 'adapters/shared/json-field.sh'), path.join(harnessDir, 'scripts/lib/json-field.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/log-tui.mjs'), path.join(harnessDir, 'scripts/lib/log-tui.mjs'));

package/adapters/extension/refresh-build.sh

@@ -97,7 +97,7 @@ elif command -v activate_repo_node >/dev/null 2>&1; then
     exit 1
   }
 else
-  echo "[refresh] activate-repo-node.sh missing from harness; run: recipe sync" >&2
+  echo "[refresh] activate-repo-node.sh missing from harness; run: mm-harness install" >&2
   exit 1
 fi
 
@@ -186,5 +186,5 @@ kill "$BUILD_PID" 2>/dev/null || true
 wait "$BUILD_PID" 2>/dev/null || true
 trap - EXIT
 
-echo "[refresh] Build refreshed and frozen — run: recipe reopen"
+echo "[refresh] Build refreshed and frozen — run: mm-harness launch"
 echo "[refresh] Log kept at: $LOG"

package/adapters/extension/start-watch.sh

@@ -82,7 +82,7 @@ elif command -v activate_repo_node >/dev/null 2>&1; then
     exit 1
   }
 else
-  echo "[recipe-harness] activate-repo-node.sh missing from harness; run: recipe sync" >&2
+  echo "[recipe-harness] activate-repo-node.sh missing from harness; run: mm-harness install" >&2
   exit 1
 fi
 if [ -z "$WATCHER_PORT" ]; then
@@ -233,7 +233,7 @@ for _lib in "$SCRIPT_DIR/lib" "$SCRIPT_DIR/../shared"; do
 done
 unset _lib
 echo "[recipe-harness] Starting yarn start (watcher-port=${WATCHER_PORT:-default})"
-echo "[recipe-harness] compact build view - full log: $watch_log (recipe logs --full)"
+echo "[recipe-harness] compact build view - full log: $watch_log (mm-harness logs --full)"
 started_pid=""
 # Launch the watcher detached writing to the log; the tmux window is a read-only tail viewer.
 path_prefix="${REPO_NODE_PATH_PREFIX:-}"

package/adapters/manifest.json

@@ -308,12 +308,28 @@
     },
     {
       "id": "lib/resolve-farmslot-ports",
-      "entry": "adapters/shared/resolve-farmslot-ports.sh",
-      "kind": "lib",
+      "entry": "adapters/shared/resolve-farmslot-ports.mjs",
+      "kind": "node",
       "purpose": "Resolve CDP + watcher ports from farmslot pool JSON by repo path, else 6660+N / 9010+N.",
-      "inputs": "resolve_extension_runtime_ports <repo>",
+      "inputs": "resolve-farmslot-ports.mjs resolve_extension_runtime_ports <repo>",
       "outputs": "CDP_PORT / WATCHER_PORT / SLOT_ID lines on stdout"
     },
+    {
+      "id": "lib/resolve-farmslot-ports-core",
+      "entry": "adapters/shared/resolve-farmslot-ports-core.mjs",
+      "kind": "lib",
+      "purpose": "Self-contained pool/context/formula port resolution imported by the node leaf and TS surface.",
+      "inputs": "ESM import from resolve-farmslot-ports.mjs or resolve-farmslot-ports.ts",
+      "outputs": "resolveFarmslotPortsByRepo and related functions"
+    },
+    {
+      "id": "lib/resolve-farmslot-ports-sh",
+      "entry": "adapters/shared/resolve-farmslot-ports.sh",
+      "kind": "lib",
+      "purpose": "Bash-compat sourced wrapper over resolve-farmslot-ports.mjs for stop-metro and legacy callers.",
+      "inputs": "source + resolve_* / apply_resolved_* function calls",
+      "outputs": "KEY=VALUE lines on stdout; env vars via apply_resolved_*"
+    },
     {
       "id": "lib/sync-wallet-fixture",
       "entry": "adapters/shared/sync-wallet-fixture.sh",

package/adapters/mobile/start-metro.sh

@@ -102,7 +102,7 @@ CLEAR_SUFFIX=""
 
 printf 'Starting Metro on port %s (workers=%s%s)\n' \
   "$PORT" "$METRO_WORKERS" "${CLEAR:+, clear}" >&2
-printf '(Full log: %s — recipe logs | recipe logs --full)\n' "$LOG_FILE" >&2
+printf '(Full log: %s — mm-harness logs | mm-harness logs --full)\n' "$LOG_FILE" >&2
 
 # Metro runs detached, writing to the log. The tmux window is a read-only tail.
 (

package/adapters/mobile/verify.sh

@@ -296,7 +296,7 @@ if (checked === 0) {
   const parts = [];
   if (drifted.length) parts.push('behind runner: ' + drifted.join(', '));
   if (missing.length) parts.push('absent in repo: ' + missing.join(', '));
-  process.stdout.write(JSON.stringify({ name, status: 'warn', detail: parts.join('; ') + ' — rerun mm-harness install --force-overlay or recipe sync to refresh the in-repo HUD/AgenticService from the runner' }));
+  process.stdout.write(JSON.stringify({ name, status: 'warn', detail: parts.join('; ') + ' — rerun mm-harness install --force-overlay or mm-harness fixtures sync to refresh the in-repo HUD/AgenticService from the runner' }));
 } else {
   process.stdout.write(JSON.stringify({ name, status: 'pass' }));
 }

package/adapters/shared/activate-repo-node.sh

@@ -134,7 +134,7 @@ activate_repo_node() {
 require_repo_node() {
   local target="${1:-.}"
   if ! command -v activate_repo_node >/dev/null 2>&1; then
-    echo "[env] activate-repo-node.sh is not sourced; reinstall the harness (recipe sync)" >&2
+    echo "[env] activate-repo-node.sh is not sourced; reinstall the harness (mm-harness install)" >&2
     return 1
   fi
   activate_repo_node "$target" || {

package/adapters/shared/cli-ux.sh

@@ -67,7 +67,7 @@ recipe_instant_hint() {
   local message="$1"
   [ "${RECIPE_PROGRESS_JSON:-}" = "1" ] && return 0
   [ -t 2 ] || return 0
-  local prefix="${RECIPE_CLI_PREFIX:-recipe}"
+  local prefix="${RECIPE_CLI_PREFIX:-mm-harness}"
   printf '%s: %s\n' \
     "$(recipe_color label "$prefix")" \
     "$(recipe_color dim "$message")" >&2
@@ -92,7 +92,7 @@ recipe_done() {
 recipe_failure_playbook() {
   local verb="$1" reason="$2"
   shift 2
-  local log_path="" artifact="" prefix="${RECIPE_CLI_PREFIX:-recipe}"
+  local log_path="" artifact="" prefix="${RECIPE_CLI_PREFIX:-mm-harness}"
   while [ "$#" -gt 0 ]; do
     case "$1" in
       --log) log_path="$2"; shift 2 ;;
@@ -106,31 +106,32 @@ recipe_failure_playbook() {
     "$(recipe_color cmd "$verb")" \
     "$(recipe_color err failed)" \
     "$(recipe_color warn "$reason")" >&2
-  printf '%s\n' "$(recipe_color label next:)" >&2
+  printf '%s\n' "$(recipe_color label "next:")" >&2
   case "$verb" in
     rebuild|up|watch)
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs --full")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix doctor")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix sync")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs --full")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness doctor")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness install")" >&2
       ;;
     refresh)
-      printf '  %s\n' "$(recipe_color cmd "$prefix watch")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix rebuild")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness launch")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness launch --build")" >&2
       ;;
     metro|ios|android|setup-wallet)
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs --full")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix up")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs --full")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness launch")" >&2
       ;;
     *)
-      printf '  %s\n' "$(recipe_color cmd "$prefix status")" >&2
-      printf '  %s\n' "$(recipe_color cmd "$prefix logs")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness doctor")" >&2
+      printf '  %s\n' "$(recipe_color cmd "mm-harness logs")" >&2
       ;;
   esac
   [ -n "$log_path" ] && printf '%s\n' "$(recipe_color path "log: $log_path")" >&2
   [ -n "$artifact" ] && printf '%s\n' "$(recipe_color path "artifact: $artifact")" >&2
+  return 0
 }
 
 recipe_check_harness_stale() {
@@ -152,12 +153,12 @@ recipe_check_harness_stale() {
 
 recipe_warn_harness_stale() {
   local adapter="$1" root="$2" harness_root="$3" runner_root="$4"
-  local prefix="${RECIPE_CLI_PREFIX:-recipe}"
+  local prefix="${RECIPE_CLI_PREFIX:-mm-harness}"
   if recipe_check_harness_stale "$adapter" "$root" "$harness_root" "$runner_root"; then
     printf '%s: %s - run: %s\n' \
       "$(recipe_color label "$prefix")" \
       "$(recipe_color warn 'harness scripts are stale')" \
-      "$(recipe_color cmd "$prefix sync")" >&2
+      "$(recipe_color cmd "mm-harness install")" >&2
     return 1
   fi
   return 0
@@ -190,7 +191,7 @@ recipe_try_farmslot_fixture_sync() {
 recipe_sync_wallet_fixture() {
   local root="$1" runtime_dir="$2" cdp_port="${3:-}" seed_script="${4:-}" farmslot_slot="${5:-}"
   local canonical="$root/$runtime_dir/wallet-fixture.json"
-  local candidate resolved prefix="${RECIPE_CLI_PREFIX:-recipe}"
+  local candidate resolved prefix="${RECIPE_CLI_PREFIX:-mm-harness}"
 
   mkdir -p "$root/$runtime_dir"
   if [ -f "$canonical" ]; then
@@ -239,10 +240,10 @@ recipe_sync_wallet_fixture() {
 recipe_speed_ladder() {
   cat >&2 <<'EOF'
 Speed ladder:
-  FAST (seconds):  recipe watch -> recipe refresh
-  SLOW (minutes):  recipe rebuild
-  INSPECT:         recipe status | recipe ports | recipe logs | recipe logs --full | recipe debug
-  PROOF:           recipe run <recipe.json>
-  SYNC CONTEXT:    recipe sync
+  FAST (seconds):  mm-harness launch (extension quick relaunch)
+  SLOW (minutes):  mm-harness launch --build
+  INSPECT:         mm-harness doctor | mm-harness logs | mm-harness logs --full | mm-harness debug
+  PROOF:           mm-harness run <recipe.json>
+  SYNC CONTEXT:    mm-harness fixtures sync
 EOF
 }

package/adapters/shared/log-tui.mjs

@@ -153,9 +153,9 @@ function readNewContent(file, offset) {
 
 function renderHeader(label, logPath, title) {
   return [
-    `${color('label', 'recipe', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('bold', title || label, { stream: process.stderr })}`,
-    `${color('label', 'recipe', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('path', `full log: ${logPath}`, { stream: process.stderr })}`,
-    `${color('label', 'recipe', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('comment', 'full stream: recipe logs --full', { stream: process.stderr })}`,
+    `${color('label', 'mm-harness', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('bold', title || label, { stream: process.stderr })}`,
+    `${color('label', 'mm-harness', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('path', `full log: ${logPath}`, { stream: process.stderr })}`,
+    `${color('label', 'mm-harness', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('comment', 'full stream: mm-harness logs --full', { stream: process.stderr })}`,
     '',
   ];
 }
@@ -232,7 +232,7 @@ async function watchLog(options) {
       renderCompact({ label, logPath, events, quiet: mode === 'quiet' });
       if (mode !== 'quiet') {
         const elapsed = Math.round((Date.now() - started) / 1000);
-        process.stderr.write(`${color('label', 'recipe', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('ok', `build complete (${elapsed}s)`, { stream: process.stderr })}\n`);
+        process.stderr.write(`${color('label', 'mm-harness', { stream: process.stderr })} ${color('dim', '|', { stream: process.stderr })} ${color('ok', `build complete (${elapsed}s)`, { stream: process.stderr })}\n`);
       }
       return 0;
     }

package/adapters/shared/open-debug.mjs

@@ -221,7 +221,7 @@ async function openExtensionDevtools(cdpPort, targetKind, shouldOpen) {
       error: 'cdp-unreachable',
       inspectUrl,
       configureHint,
-      hint: `Start the extension runtime first (recipe reopen). Then open chrome://inspect and add ${configureHint}.`,
+      hint: `Start the extension runtime first (mm-harness launch). Then open chrome://inspect and add ${configureHint}.`,
       detail: error instanceof Error ? error.message : String(error),
     };
   }

package/adapters/shared/resolve-farmslot-ports-core.mjs

@@ -0,0 +1,196 @@
+// Farmslot pool + slot-suffix port resolution — pure JS for runner and overlay leaves.
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const coreDir = path.dirname(fileURLToPath(import.meta.url));
+
+function pathDefault(key) {
+  for (const candidate of [
+    path.join(coreDir, 'path-defaults.json'),
+    path.join(coreDir, '../../adapters/shared/path-defaults.json'),
+  ]) {
+    if (!fs.existsSync(candidate)) continue;
+    const value = JSON.parse(fs.readFileSync(candidate, 'utf8'))[key];
+    if (value) return value;
+  }
+  throw new Error(`Missing path default: ${key}`);
+}
+
+function recipeRuntimeDir() {
+  return process.env.RECIPE_RUNTIME_DIR || pathDefault('recipeRuntimeDir');
+}
+
+export function formatKvLines(kv) {
+  const lines = [];
+  if (kv.CDP_PORT !== undefined) lines.push(`CDP_PORT=${kv.CDP_PORT}`);
+  if (kv.WATCHER_PORT !== undefined) lines.push(`WATCHER_PORT=${kv.WATCHER_PORT}`);
+  if (kv.SLOT_ID) lines.push(`SLOT_ID=${kv.SLOT_ID}`);
+  if (kv.IOS_SIMULATOR) lines.push(`IOS_SIMULATOR=${kv.IOS_SIMULATOR}`);
+  return lines.length ? `${lines.join('\n')}\n` : '';
+}
+
+export function realRepoPath(repo) {
+  if (!repo) return null;
+  try {
+    return fs.realpathSync(repo);
+  } catch {
+    return null;
+  }
+}
+
+export function inferSlotSuffix(repo) {
+  const base = path.basename(repo);
+  const m = /-(\d+)$/u.exec(base);
+  return m ? m[1] : null;
+}
+
+function scoreSlot(slot, slotSuffix) {
+  const resources = slot.resources ?? {};
+  const cdp = resources.browser?.cdp_port;
+  const port = resources['dev-server']?.port;
+  const session = slot.session ?? '';
+  const slotId = slot.id ?? '';
+  let score = 0;
+  if (cdp !== undefined) score += 100;
+  if (port !== undefined) score += 10;
+  if (slotSuffix) {
+    if (session === `mme-${slotSuffix}`) score += 50;
+    if (slotId.endsWith(`mme-${slotSuffix}`) || slotId.includes(`-mme-${slotSuffix}`)) score += 40;
+  }
+  if (!slotId.toLowerCase().includes('demo')) score += 5;
+  return [score, cdp, port, slotId];
+}
+
+export function resolveFarmslotPortsByRepo(repo) {
+  const realRepo = realRepoPath(repo);
+  if (!realRepo) return null;
+
+  const slotSuffix = inferSlotSuffix(realRepo);
+  const roots = [];
+  if (process.env.FARMSLOT_ROOT) roots.push(process.env.FARMSLOT_ROOT);
+  roots.push(path.join(os.homedir(), 'dev', 'farmslot'));
+
+  for (const root of roots) {
+    if (!root || !fs.existsSync(path.join(root, 'pool'))) continue;
+    const poolDir = path.join(root, 'pool');
+    let best = null;
+
+    for (const name of fs.readdirSync(poolDir).sort()) {
+      if (!name.endsWith('.json') || name.includes('.bak.')) continue;
+      let data;
+      try {
+        data = JSON.parse(fs.readFileSync(path.join(poolDir, name), 'utf8'));
+      } catch {
+        continue;
+      }
+      for (const slot of data.slots ?? []) {
+        const slotRepo = slot.repo ?? '';
+        if (!slotRepo) continue;
+        let slotReal;
+        try {
+          slotReal = fs.realpathSync(slotRepo);
+        } catch {
+          continue;
+        }
+        if (slotReal !== realRepo) continue;
+        const scored = scoreSlot(slot, slotSuffix);
+        if (!best || scored[0] > best[0]) best = scored;
+      }
+    }
+
+    if (best) {
+      const [, cdp, port, slotId] = best;
+      return formatKvLines({
+        ...(cdp !== undefined ? { CDP_PORT: cdp } : {}),
+        ...(port !== undefined ? { WATCHER_PORT: port } : {}),
+        ...(slotId ? { SLOT_ID: slotId } : {}),
+      });
+    }
+  }
+  return null;
+}
+
+export function resolveDefaultExtensionPorts(repo) {
+  const n = inferSlotSuffix(repo);
+  if (!n) return null;
+  return formatKvLines({
+    CDP_PORT: 6660 + Number(n),
+    WATCHER_PORT: 9010 + Number(n),
+    SLOT_ID: `local-extension-${n}`,
+  });
+}
+
+export function resolveExtensionRuntimePorts(repo) {
+  return resolveFarmslotPortsByRepo(repo) ?? resolveDefaultExtensionPorts(repo) ?? '';
+}
+
+export function resolveMobileSlotDefaults(repo) {
+  const n = inferSlotSuffix(repo);
+  if (!n) return null;
+  return formatKvLines({
+    WATCHER_PORT: 8060 + Number(n),
+    IOS_SIMULATOR: `mm-${n}`,
+    SLOT_ID: `local-mobile-${n}`,
+  });
+}
+
+export function resolveMobileRuntimeContext(repo) {
+  const ctxPath = path.join(repo, recipeRuntimeDir(), 'agentic-runtime.json');
+  if (fs.existsSync(ctxPath)) {
+    try {
+      const c = JSON.parse(fs.readFileSync(ctxPath, 'utf8'));
+      if (c.simulator || c.metroPort) {
+        return formatKvLines({
+          ...(c.metroPort !== undefined ? { WATCHER_PORT: c.metroPort } : {}),
+          ...(c.simulator ? { IOS_SIMULATOR: c.simulator } : {}),
+          ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
+        });
+      }
+    } catch {
+      /* unreadable context falls through to the provision baseline */
+    }
+  }
+  return resolveMobileProvisionBaseline(repo);
+}
+
+// A provisioned-but-unprepared slot has no agentic-runtime.json yet, but the
+// provision baseline records the same authoritative simulator/port identity —
+// without it, a fresh slot's first launch degrades to the simctl `booted`
+// alias and misses the installed dev client entirely.
+function resolveMobileProvisionBaseline(repo) {
+  const basePath = path.join(repo, recipeRuntimeDir(), 'runway-provision.json');
+  if (!fs.existsSync(basePath)) return null;
+  try {
+    const c = JSON.parse(fs.readFileSync(basePath, 'utf8'));
+    const simulator = c.simulator?.name || c.simulator?.udid;
+    if (!simulator && c.watcherPort === undefined) return null;
+    return formatKvLines({
+      ...(c.watcherPort !== undefined ? { WATCHER_PORT: c.watcherPort } : {}),
+      ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
+      ...(c.slotId ? { SLOT_ID: c.slotId } : {}),
+    });
+  } catch {
+    return null;
+  }
+}
+
+export function resolveMobileRuntimePorts(repo) {
+  return (
+    resolveMobileRuntimeContext(repo)
+    ?? resolveFarmslotPortsByRepo(repo)
+    ?? resolveMobileSlotDefaults(repo)
+    ?? ''
+  );
+}
+
+export const cliFns = {
+  resolve_farmslot_ports_by_repo: resolveFarmslotPortsByRepo,
+  resolve_default_extension_ports: resolveDefaultExtensionPorts,
+  resolve_extension_runtime_ports: (repo) => resolveExtensionRuntimePorts(repo) || null,
+  resolve_mobile_runtime_context: resolveMobileRuntimeContext,
+  resolve_mobile_slot_defaults: resolveMobileSlotDefaults,
+  resolve_mobile_runtime_ports: (repo) => resolveMobileRuntimePorts(repo) || null,
+};

package/adapters/shared/resolve-farmslot-ports.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Node leaf for port resolution — self-contained for runner and injected overlay copies.
+
+import { cliFns } from './resolve-farmslot-ports-core.mjs';
+
+const [, , fn, repo] = process.argv;
+if (!fn || fn === '-h' || fn === '--help') {
+  process.stderr.write('Usage: resolve-farmslot-ports.mjs <fn> <repo>\n');
+  process.exit(fn ? 0 : 2);
+}
+
+const handler = cliFns[fn];
+if (!handler) {
+  process.stderr.write(`resolve-farmslot-ports: unknown fn: ${fn}\n`);
+  process.exit(2);
+}
+
+const out = handler(repo ?? '.');
+if (!out?.trim()) process.exit(1);
+process.stdout.write(out.endsWith('\n') ? out : `${out}\n`);

package/adapters/shared/resolve-farmslot-ports.sh

@@ -1,4 +1,5 @@
-# resolve-farmslot-ports.sh — resolve CDP + watcher ports for an extension checkout
+#!/usr/bin/env bash
+# resolve-farmslot-ports.sh — bash-compat wrapper over resolve-farmslot-ports.mjs
 #
 # Farmslot pool JSON is authoritative when a slot repo matches; otherwise fall back
 # to the local-extension-N formula (6660+N / 9010+N).
@@ -8,85 +9,15 @@
 #   resolve_extension_runtime_ports /path/to/metamask-extension-N
 #     -> prints CDP_PORT=... WATCHER_PORT=... SLOT_ID=... lines
 
-resolve_farmslot_ports_by_repo() {
-  local repo="$1"
-  local farmslot_root="${FARMSLOT_ROOT:-}"
-  [ -n "$repo" ] || return 1
-  repo="$(cd "$repo" && pwd -P)"
-
-  local root candidate match
-  for root in "$farmslot_root" "$HOME/dev/farmslot"; do
-    [ -n "$root" ] && [ -d "$root/pool" ] || continue
-    match="$(POOL_ROOT="$root" REPO_TARGET="$repo" python3 - <<'PY'
-import glob, json, os, re, sys
-
-pool_root = os.environ["POOL_ROOT"]
-repo = os.path.realpath(os.environ["REPO_TARGET"])
-base = os.path.basename(repo)
-slot_suffix = None
-m = re.search(r"-(\d+)$", base)
-if m:
-    slot_suffix = m.group(1)
-
-def score_slot(slot):
-    resources = slot.get("resources") or {}
-    cdp = (resources.get("browser") or {}).get("cdp_port")
-    port = (resources.get("dev-server") or {}).get("port")
-    session = slot.get("session") or ""
-    slot_id = slot.get("id") or ""
-    score = 0
-    if cdp is not None:
-        score += 100
-    if port is not None:
-        score += 10
-    if slot_suffix:
-        if session == f"mme-{slot_suffix}":
-            score += 50
-        if slot_id.endswith(f"mme-{slot_suffix}") or f"-mme-{slot_suffix}" in slot_id:
-            score += 40
-    if "demo" not in slot_id.lower():
-        score += 5
-    return score, cdp, port, slot_id
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+_RESOLVE_PORTS_MJS="$SCRIPT_DIR/resolve-farmslot-ports.mjs"
 
-best = None
-for path in sorted(glob.glob(os.path.join(pool_root, "pool", "*.json"))):
-    if ".bak." in os.path.basename(path):
-        continue
-    try:
-        data = json.load(open(path, encoding="utf-8"))
-    except Exception:
-        continue
-    for slot in data.get("slots") or []:
-        slot_repo = slot.get("repo") or ""
-        if not slot_repo:
-            continue
-        try:
-            if os.path.realpath(slot_repo) != repo:
-                continue
-        except Exception:
-            continue
-        scored = score_slot(slot)
-        if best is None or scored[0] > best[0]:
-            best = scored
-
-if best is None:
-    sys.exit(1)
+_resolve_ports_cli() {
+  node "$_RESOLVE_PORTS_MJS" "$1" "${2:-.}"
+}
 
-_, cdp, port, slot_id = best
-if cdp is not None:
-    print(f"CDP_PORT={cdp}")
-if port is not None:
-    print(f"WATCHER_PORT={port}")
-if slot_id:
-    print(f"SLOT_ID={slot_id}")
-sys.exit(0)
-PY
-)" || continue
-    [ -n "$match" ] || continue
-    printf '%s\n' "$match"
-    return 0
-  done
-  return 1
+resolve_farmslot_ports_by_repo() {
+  _resolve_ports_cli resolve_farmslot_ports_by_repo "$1"
 }
 
 infer_extension_slot_suffix() {
@@ -100,27 +31,18 @@ infer_extension_slot_suffix() {
 }
 
 resolve_default_extension_ports() {
-  local repo="$1" n
-  n="$(infer_extension_slot_suffix "$repo" || true)"
-  [ -n "$n" ] || return 1
-  printf 'CDP_PORT=%s\n' "$((6660 + n))"
-  printf 'WATCHER_PORT=%s\n' "$((9010 + n))"
-  printf 'SLOT_ID=local-extension-%s\n' "$n"
+  _resolve_ports_cli resolve_default_extension_ports "$1"
 }
 
 resolve_extension_runtime_ports() {
-  local repo="${1:-.}"
-  if resolve_farmslot_ports_by_repo "$repo"; then
-    return 0
-  fi
-  resolve_default_extension_ports "$repo"
+  _resolve_ports_cli resolve_extension_runtime_ports "${1:-.}"
 }
 
 apply_resolved_extension_ports() {
   local repo="${1:-.}" line key val from_pool=false resolved=""
-  if resolved="$(resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
+  if resolved="$(_resolve_ports_cli resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
     from_pool=true
-  elif resolved="$(resolve_default_extension_ports "$repo" 2>/dev/null)"; then
+  elif resolved="$(_resolve_ports_cli resolve_default_extension_ports "$repo" 2>/dev/null)"; then
     from_pool=false
   else
     return 0
@@ -143,52 +65,23 @@ apply_resolved_extension_ports() {
   done <<< "$resolved"
 }
 
-# Mobile slot defaults: derive Metro port + iOS simulator name from directory suffix.
-# Port formula: 8060 + N (slot 1 → 8061). iOS simulator: mm-N.
-# Mirrors the extension convention (6660+N / 9010+N) for multi-slot mobile farms.
 resolve_mobile_slot_defaults() {
-  local repo="$1" n
-  n="$(infer_extension_slot_suffix "$repo" || true)"
-  [ -n "$n" ] || return 1
-  printf 'WATCHER_PORT=%s\n' "$((8060 + n))"
-  printf 'IOS_SIMULATOR=mm-%s\n' "$n"
-  printf 'SLOT_ID=local-mobile-%s\n' "$n"
+  _resolve_ports_cli resolve_mobile_slot_defaults "$1"
 }
 
-# Slot context the orchestrator's prepare wrote INTO the checkout — the
-# authoritative device/port mapping for this repo (survives pool renames that
-# break any naming formula). Highest-priority detection source.
 resolve_mobile_runtime_context() {
-  local repo="$1" ctx
-  ctx="$repo/${RECIPE_RUNTIME_DIR:-temp/recipe/runtime}/agentic-runtime.json"
-  [ -f "$ctx" ] || return 1
-  node -e '
-    try {
-      const c = JSON.parse(require("fs").readFileSync(process.argv[1], "utf8"));
-      if (!c.simulator && !c.metroPort) process.exit(1);
-      if (c.metroPort) console.log(`WATCHER_PORT=${c.metroPort}`);
-      if (c.simulator) console.log(`IOS_SIMULATOR=${c.simulator}`);
-      if (c.slotId) console.log(`SLOT_ID=${c.slotId}`);
-    } catch { process.exit(1); }
-  ' "$ctx" 2>/dev/null
+  _resolve_ports_cli resolve_mobile_runtime_context "$1"
 }
 
 resolve_mobile_runtime_ports() {
-  local repo="${1:-.}"
-  if resolve_mobile_runtime_context "$repo"; then
-    return 0
-  fi
-  if resolve_farmslot_ports_by_repo "$repo"; then
-    return 0
-  fi
-  resolve_mobile_slot_defaults "$repo"
+  _resolve_ports_cli resolve_mobile_runtime_ports "${1:-.}"
 }
 
 apply_resolved_mobile_ports() {
   local repo="${1:-.}" line key val from_pool=false resolved=""
-  if resolved="$(resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
+  if resolved="$(_resolve_ports_cli resolve_farmslot_ports_by_repo "$repo" 2>/dev/null)"; then
     from_pool=true
-  elif resolved="$(resolve_mobile_slot_defaults "$repo" 2>/dev/null)"; then
+  elif resolved="$(_resolve_ports_cli resolve_mobile_slot_defaults "$repo" 2>/dev/null)"; then
     from_pool=false
   else
     return 0
@@ -209,4 +102,4 @@ apply_resolved_mobile_ports() {
         ;;
     esac
   done <<< "$resolved"
-}
+}

package/dist/adapters/mobile/runtime-decision.js

@@ -103,6 +103,8 @@ async function decideMobileReadiness(target, options = {}) {
   const fast = options.preflightMode === "fast";
   const report = await computeMobileReadiness(resolved, options, fast);
   if (fast && report.decision === "install") {
+    const hasNodeModules = fs.existsSync(path.join(resolved, "node_modules"));
+    const standalone = hasNodeModules ? "`yarn setup:expo --no-build-ios --no-build-android`" : "`yarn install --immutable && yarn setup:expo --no-build-ios --no-build-android`";
     return {
       ...report,
       decision: "blocked",
@@ -111,7 +113,7 @@ async function decideMobileReadiness(target, options = {}) {
         "Fast preflight found dependencies not ready and does not install them (the orchestrator deps phase owns installation).",
         ...report.reasons
       ],
-      userAction: "run the slot deps/prepare phase; standalone: `yarn setup:expo --no-build-ios --no-build-android` in the checkout, or `mm-harness launch <platform> --build` to install and build",
+      userAction: `run the slot deps/prepare phase; standalone: ${standalone} in the checkout, then re-run \`mm-harness launch <platform>\``,
       actions: []
     };
   }

package/dist/adapters/resolve-farmslot-ports.js

@@ -0,0 +1,22 @@
+import {
+  formatKvLines,
+  inferSlotSuffix,
+  realRepoPath,
+  resolveDefaultExtensionPorts,
+  resolveExtensionRuntimePorts,
+  resolveFarmslotPortsByRepo,
+  resolveMobileRuntimeContext,
+  resolveMobileRuntimePorts,
+  resolveMobileSlotDefaults
+} from "../../adapters/shared/resolve-farmslot-ports-core.mjs";
+export {
+  formatKvLines,
+  inferSlotSuffix,
+  realRepoPath,
+  resolveDefaultExtensionPorts,
+  resolveExtensionRuntimePorts,
+  resolveFarmslotPortsByRepo,
+  resolveMobileRuntimeContext,
+  resolveMobileRuntimePorts,
+  resolveMobileSlotDefaults
+};

package/dist/adapters/slot-ports.js

@@ -2,7 +2,13 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { readRuntimeContextField, resolveRuntimeContextPath } from "../harness.js";
-import { recipeRuntimeDir, runnerDir } from "../paths.js";
+import { recipeRuntimeDir } from "../paths.js";
+import {
+  resolveDefaultExtensionPorts,
+  resolveFarmslotPortsByRepo,
+  resolveMobileRuntimeContext,
+  resolveMobileSlotDefaults
+} from "./resolve-farmslot-ports.js";
 function applyKVLines(output, overwrite) {
   for (const line of output.split("\n")) {
     const m = /^([A-Z_]+)=(.+)$/u.exec(line.trim());
@@ -31,31 +37,19 @@ function applyKVLines(output, overwrite) {
     }
   }
 }
-function sourceResolve(fn, target) {
-  const resolveScript = path.join(runnerDir, "adapters/shared/resolve-farmslot-ports.sh");
-  try {
-    return execFileSync("bash", ["-c", `source "${resolveScript}" && ${fn} "${target}"`], {
-      encoding: "utf8",
-      timeout: 5e3,
-      stdio: ["ignore", "pipe", "ignore"]
-    });
-  } catch {
-    return "";
-  }
-}
 function resolveMobileSlotPorts(target) {
-  const ctxOut = sourceResolve("resolve_mobile_runtime_context", target);
-  if (ctxOut.trim()) {
+  const ctxOut = resolveMobileRuntimeContext(target);
+  if (ctxOut?.trim()) {
     applyKVLines(ctxOut, true);
     return;
   }
-  const poolOut = sourceResolve("resolve_farmslot_ports_by_repo", target);
-  if (poolOut.trim()) {
+  const poolOut = resolveFarmslotPortsByRepo(target);
+  if (poolOut?.trim()) {
     applyKVLines(poolOut, true);
     return;
   }
-  const defOut = sourceResolve("resolve_mobile_slot_defaults", target);
-  if (defOut.trim()) applyKVLines(defOut, false);
+  const defOut = resolveMobileSlotDefaults(target);
+  if (defOut?.trim()) applyKVLines(defOut, false);
 }
 function resolveExtensionSlotPorts(target) {
   const contextPath = resolveRuntimeContextPath(target);
@@ -70,13 +64,13 @@ function resolveExtensionSlotPorts(target) {
     process.env["RECIPE_WATCHER_PORT"] = dev;
   }
   if (process.env["CDP_PORT"]) return;
-  const poolOut = sourceResolve("resolve_farmslot_ports_by_repo", target);
-  if (poolOut.trim()) {
+  const poolOut = resolveFarmslotPortsByRepo(target);
+  if (poolOut?.trim()) {
     applyKVLines(poolOut, true);
     return;
   }
-  const defOut = sourceResolve("resolve_default_extension_ports", target);
-  if (defOut.trim()) applyKVLines(defOut, false);
+  const defOut = resolveDefaultExtensionPorts(target);
+  if (defOut?.trim()) applyKVLines(defOut, false);
 }
 function stopExtensionWatcher(target) {
   const runtimeAbs = path.join(target, recipeRuntimeDir());

package/library/actions/core/perps/_controller.mjs

@@ -8,7 +8,7 @@ import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
 // this adapter under the bundled tsx (see commandFor/importsSourceTypescript in
 // src/live-adapter-contract.ts). The core adapter dynamic-imports the perps
 // controller TypeScript at runtime, so it MUST run under tsx, not plain node.
-import { walletFixturePath } from '../../../../src/index.ts';
+import { walletFixturePath } from '../../harness-exports.mjs';
 
 // Shared headless instantiation for the MetaMask `core` adapter.
 //

package/library/actions/extension/platform/cdp.mjs

@@ -11,7 +11,7 @@ import {
   recipeHarnessPath,
   walletFixturePath,
   captureActiveRecipeRecordingSnapshot,
-} from '../../../../src/index.ts';
+} from '../../harness-exports.mjs';
 
 // Resolve the Farmslot harness through normal package dependencies by default.
 // Local Farmslot source is only a dev override handled by src/paths.ts.

package/library/actions/extension/wallet/ensure_unlocked.mjs

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
-import { walletFixturePath } from '../../../../src/index.ts';
+import { walletFixturePath } from '../../harness-exports.mjs';
 
 async function fixturePassword(projectRoot) {
   const candidates = [

package/library/actions/harness-exports.mjs

@@ -0,0 +1,27 @@
+// Bridge from library actions to the harness path/recording helpers. Published
+// installs load the compiled dist (node cannot type-strip .ts under
+// node_modules); source checkouts without dist fall back to src. Deliberately
+// narrow — importing the package entry here would close an import cycle
+// through src/adapters.ts (which imports these actions) and deadlock.
+const packageRoot = new URL('../../', import.meta.url);
+
+async function load(distRelative, srcRelative) {
+  try {
+    return await import(new URL(distRelative, packageRoot).href);
+  } catch {
+    return await import(new URL(srcRelative, packageRoot).href);
+  }
+}
+
+const paths = await load('dist/paths.js', 'src/paths.ts');
+const recording = await load('dist/run-recording.js', 'src/run-recording.ts');
+
+export const {
+  importRecipeHarnessRuntimeBrowserExtension,
+  importRecipeHarnessRuntimeCdp,
+  extensionIdPath,
+  recipeHarnessPath,
+  walletFixturePath,
+} = paths;
+
+export const { captureActiveRecipeRecordingSnapshot } = recording;

package/library/actions/mobile/wallet/ensure_unlocked.mjs

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { bridgeCommand, runAdapter } from '../platform/bridge.mjs';
-import { walletFixturePath } from '../../../../src/index.ts';
+import { walletFixturePath } from '../../harness-exports.mjs';
 
 async function fixturePassword(projectRoot) {
   const candidates = [

package/library/actions/mobile/wallet/setup.mjs

@@ -3,7 +3,7 @@ import { spawn } from 'node:child_process';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { bridgeCommand, bridgeEnv, runAdapter } from '../platform/bridge.mjs';
-import { walletFixturePath } from '../../../../src/index.ts';
+import { walletFixturePath } from '../../harness-exports.mjs';
 
 async function fixtureProfile(projectRoot) {
   const candidates = [

package/package.json

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

package/src/adapters/mobile/runtime-decision.ts

@@ -201,6 +201,13 @@ export async function decideMobileReadiness(
   // mid-launch is inverted authority. Surface a teaching block, not an implicit
   // setup, so a runway preflight never re-does the orchestrator's deps work.
   if (fast && report.decision === 'install') {
+    // A checkout without node_modules cannot even run yarn scripts (yarn exits
+    // with "Couldn't find the node_modules state file"), so the taught command
+    // must lead with the install when that is the caller's actual state.
+    const hasNodeModules = fs.existsSync(path.join(resolved, 'node_modules'));
+    const standalone = hasNodeModules
+      ? '`yarn setup:expo --no-build-ios --no-build-android`'
+      : '`yarn install --immutable && yarn setup:expo --no-build-ios --no-build-android`';
     return {
       ...report,
       decision: 'blocked',
@@ -210,7 +217,7 @@ export async function decideMobileReadiness(
         ...report.reasons,
       ],
       userAction:
-        'run the slot deps/prepare phase; standalone: `yarn setup:expo --no-build-ios --no-build-android` in the checkout, or `mm-harness launch <platform> --build` to install and build',
+        `run the slot deps/prepare phase; standalone: ${standalone} in the checkout, then re-run \`mm-harness launch <platform>\``,
       actions: [],
     };
   }

package/src/adapters/resolve-farmslot-ports.ts

@@ -0,0 +1,13 @@
+// TypeScript surface for slot-port resolution — delegates to the self-contained core leaf.
+
+export {
+  formatKvLines,
+  inferSlotSuffix,
+  realRepoPath,
+  resolveDefaultExtensionPorts,
+  resolveExtensionRuntimePorts,
+  resolveFarmslotPortsByRepo,
+  resolveMobileRuntimeContext,
+  resolveMobileRuntimePorts,
+  resolveMobileSlotDefaults,
+} from '../../adapters/shared/resolve-farmslot-ports-core.mjs';

package/src/adapters/slot-ports.ts

@@ -8,7 +8,13 @@ import fs from 'node:fs';
 import path from 'node:path';
 
 import { readRuntimeContextField, resolveRuntimeContextPath } from '../harness.ts';
-import { recipeRuntimeDir, runnerDir } from '../paths.ts';
+import { recipeRuntimeDir } from '../paths.ts';
+import {
+  resolveDefaultExtensionPorts,
+  resolveFarmslotPortsByRepo,
+  resolveMobileRuntimeContext,
+  resolveMobileSlotDefaults,
+} from './resolve-farmslot-ports.ts';
 
 // Apply KEY=VALUE lines from slot resolution to process.env.
 // overwrite=true → pool/context match, always overrides existing env.
@@ -42,19 +48,6 @@ export function applyKVLines(output: string, overwrite: boolean): void {
   }
 }
 
-function sourceResolve(fn: string, target: string): string {
-  const resolveScript = path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports.sh');
-  try {
-    return execFileSync('bash', ['-c', `source "${resolveScript}" && ${fn} "${target}"`], {
-      encoding: 'utf8',
-      timeout: 5000,
-      stdio: ['ignore', 'pipe', 'ignore'],
-    });
-  } catch {
-    return '';
-  }
-}
-
 // Resolve mobile slot port/simulator: the slot context the orchestrator wrote
 // into the checkout wins first, then the farmslot pool (both overwrite env),
 // then the slot-suffix formula (only fills unset vars). Called before explicit
@@ -62,20 +55,20 @@ function sourceResolve(fn: string, target: string): string {
 export function resolveMobileSlotPorts(target: string): void {
   // The checkout's own runtime context is authoritative — it names the exact
   // simulator/port this slot was prepared with, surviving pool renames.
-  const ctxOut = sourceResolve('resolve_mobile_runtime_context', target);
-  if (ctxOut.trim()) {
+  const ctxOut = resolveMobileRuntimeContext(target);
+  if (ctxOut?.trim()) {
     applyKVLines(ctxOut, true);
     return;
   }
   // Pool match always wins — overwrite whatever is in the environment.
-  const poolOut = sourceResolve('resolve_farmslot_ports_by_repo', target);
-  if (poolOut.trim()) {
+  const poolOut = resolveFarmslotPortsByRepo(target);
+  if (poolOut?.trim()) {
     applyKVLines(poolOut, true);
     return;
   }
   // Formula match only fills unset vars (never overrides explicit env/pool).
-  const defOut = sourceResolve('resolve_mobile_slot_defaults', target);
-  if (defOut.trim()) applyKVLines(defOut, false);
+  const defOut = resolveMobileSlotDefaults(target);
+  if (defOut?.trim()) applyKVLines(defOut, false);
 }
 
 // Resolve extension slot ports the same way as mobile: the checkout's runtime
@@ -97,13 +90,13 @@ export function resolveExtensionSlotPorts(target: string): void {
     process.env['RECIPE_WATCHER_PORT'] = dev;
   }
   if (process.env['CDP_PORT']) return;
-  const poolOut = sourceResolve('resolve_farmslot_ports_by_repo', target);
-  if (poolOut.trim()) {
+  const poolOut = resolveFarmslotPortsByRepo(target);
+  if (poolOut?.trim()) {
     applyKVLines(poolOut, true);
     return;
   }
-  const defOut = sourceResolve('resolve_default_extension_ports', target);
-  if (defOut.trim()) applyKVLines(defOut, false);
+  const defOut = resolveDefaultExtensionPorts(target);
+  if (defOut?.trim()) applyKVLines(defOut, false);
 }
 
 // Kill the harness-owned webpack watcher for this checkout: pid file first,