@deeeed/metamask-harness 0.5.0 → 0.6.0

package/adapters/shared/cli-ux.sh

@@ -26,7 +26,16 @@ recipe_color() {
 }
 
 recipe_progress_script() {
-  printf '%s' "${RECIPE_PROGRESS_SCRIPT:-${RECIPE_RUNNER_ROOT:?}/src/progress.ts}"
+  if [ -n "${RECIPE_PROGRESS_SCRIPT:-}" ]; then
+    printf '%s' "$RECIPE_PROGRESS_SCRIPT"
+    return 0
+  fi
+  local root="${RECIPE_RUNNER_ROOT:?}"
+  if [ -f "$root/dist/progress.js" ]; then
+    printf '%s' "$root/dist/progress.js"
+  else
+    printf '%s' "$root/src/progress.ts"
+  fi
 }
 
 recipe_log_tui_script() {
@@ -34,7 +43,16 @@ recipe_log_tui_script() {
 }
 
 recipe_version_script() {
-  printf '%s' "${RECIPE_VERSION_SCRIPT:-${RECIPE_RUNNER_ROOT:?}/src/cli-version.ts}"
+  if [ -n "${RECIPE_VERSION_SCRIPT:-}" ]; then
+    printf '%s' "$RECIPE_VERSION_SCRIPT"
+    return 0
+  fi
+  local root="${RECIPE_RUNNER_ROOT:?}"
+  if [ -f "$root/dist/cli-version.js" ]; then
+    printf '%s' "$root/dist/cli-version.js"
+  else
+    printf '%s' "$root/src/cli-version.ts"
+  fi
 }
 
 recipe_log_ui_mode() {
@@ -67,7 +85,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 +110,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 +124,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 +171,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 +209,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 +258,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/ensure-runner-deps.sh

@@ -21,7 +21,32 @@ deps_ready() {
   [ -f "$RUNNER_DIR/node_modules/@farmslot/recipe-harness/package.json" ]
 }
 
+# Library actions import @deeeed/metamask-harness by package name; a source checkout
+# is not npm-installed into its own node_modules, so symlink self for resolution.
+ensure_self_package_link() {
+  local link="$RUNNER_DIR/node_modules/@deeeed/metamask-harness"
+  /bin/mkdir -p "$RUNNER_DIR/node_modules/@deeeed"
+  if [ ! -e "$link" ]; then
+    ln -sf "$RUNNER_DIR" "$link"
+  fi
+}
+
+ensure_dev_package_condition() {
+  if [ -f "$RUNNER_DIR/dist/index.js" ]; then
+    return 0
+  fi
+  if [ ! -f "$RUNNER_DIR/src/index.ts" ]; then
+    return 0
+  fi
+  case " ${NODE_OPTIONS:-} " in
+    *" --conditions=development "*) return 0 ;;
+  esac
+  export NODE_OPTIONS="${NODE_OPTIONS:+$NODE_OPTIONS }--conditions=development"
+}
+
 if deps_ready; then
+  ensure_self_package_link
+  ensure_dev_package_condition
   exit 0
 fi
 
@@ -39,6 +64,8 @@ if [ -n "$PROTOCOL_ROOT" ] && [ -f "$RUNNER_DIR/scripts/link-local-farmslot.mjs"
     FARMSLOT_ROOT="$(cd "$PROTOCOL_ROOT" && pwd -P)" \
       node "$RUNNER_DIR/scripts/link-local-farmslot.mjs" >&2 || true
     if deps_ready; then
+      ensure_self_package_link
+      ensure_dev_package_condition
       exit 0
     fi
   fi
@@ -54,3 +81,6 @@ if ! deps_ready; then
   echo "mm-harness: runner dependencies still missing after npm install: $RUNNER_DIR" >&2
   exit 1
 fi
+
+ensure_self_package_link
+ensure_dev_package_condition

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/reap-checkout-metros.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# reap-checkout-metros.sh — kill EVERY Metro/Expo bundler bound to a given
+# checkout, regardless of port. Port-scoped stop leaks a bundler whenever a
+# launch drifts ports or fails to record its pid; this sweeps them by checkout
+# path so `stop` fully cleans up and `launch` starts from zero.
+#
+#   reap_checkout_metros <checkout-abs-path> [keep-pid]
+# keep-pid (optional): a pid to spare (the bundler just started/handled).
+reap_checkout_metros() {
+  local repo="$1" keep="${2:-}" reaped=""
+  [ -n "$repo" ] || return 0
+  # Match the bundler's argv: `expo start` / metro under this checkout. ps argv
+  # embeds the cwd-launched command; expo/metro run with the repo on the path.
+  local pid args
+  while IFS= read -r pid; do
+    [ -n "$pid" ] || continue
+    [ "$pid" = "$keep" ] && continue
+    args="$(ps -o args= -p "$pid" 2>/dev/null || true)"
+    # Anchor to a path boundary so /repos/mm-1 does not match /repos/mm-10.
+    case "$args" in
+      *"$repo/"*|*"$repo "*) : ;;  # argv references this checkout
+      *) continue ;;
+    esac
+    case "$args" in
+      *"expo start"*|*"metro"*|*"react-native/cli"*|*"@react-native-community/cli"*)
+        kill "$pid" 2>/dev/null && reaped="$reaped $pid" ;;
+    esac
+  done <<LIST
+$(pgrep -f "expo start|metro" 2>/dev/null)
+LIST
+  if [ -n "$reaped" ]; then
+    printf 'Reaped leaked Metro bundler(s) for this checkout:%s\n' "$reaped" >&2
+  fi
+  return 0
+}
+
+# detect_checkout_metros <checkout-abs-path> — print pids of every metro/expo
+# bundler bound to the checkout, one per line, WITHOUT killing. Powers doctor's
+# orphan visibility so leaked bundlers are surfaced without a launch.
+detect_checkout_metros() {
+  local repo="$1" pid args
+  [ -n "$repo" ] || return 0
+  while IFS= read -r pid; do
+    [ -n "$pid" ] || continue
+    args="$(ps -o args= -p "$pid" 2>/dev/null || true)"
+    case "$args" in *"$repo/"*|*"$repo "*) : ;; *) continue ;; esac
+    case "$args" in
+      *"expo start"*|*"metro"*|*"react-native/cli"*|*"@react-native-community/cli"*) printf '%s\n' "$pid" ;;
+    esac
+  done <<LIST
+$(pgrep -f "expo start|metro" 2>/dev/null)
+LIST
+}

package/adapters/shared/recipe-harness-root.mjs

@@ -0,0 +1,23 @@
+// recipe-harness-root.mjs — overlay harness root path for node leaves (no src/ import).
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const runnerDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+
+function validateRelative(name, value) {
+  if (!value || path.isAbsolute(value)) {
+    throw new Error(`${name} must be a non-empty relative path: ${value}`);
+  }
+  return value;
+}
+
+function readDefaults() {
+  const defaultsPath = path.join(runnerDir, 'adapters/shared/path-defaults.json');
+  const parsed = JSON.parse(fs.readFileSync(defaultsPath, 'utf8'));
+  return validateRelative('recipeHarnessRoot', parsed.recipeHarnessRoot || 'temp/recipe/harness');
+}
+
+export function recipeHarnessRoot() {
+  return validateRelative('RECIPE_HARNESS_ROOT', process.env.RECIPE_HARNESS_ROOT || readDefaults());
+}

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

@@ -0,0 +1,205 @@
+// 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 simulator = resources['ios-sim']?.simulator;
+  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, simulator];
+}
+
+export function resolveFarmslotPortsByRepo(repo) {
+  const realRepo = realRepoPath(repo);
+  if (!realRepo) return null;
+
+  const slotSuffix = inferSlotSuffix(realRepo);
+  const roots = [];
+  // A slot checkout lives at <workspace>/repos/<slot>; that workspace's own
+  // pool is the authoritative one for this repo — machine-global fallbacks
+  // (env root, dev checkout) apply only when the repo is not workspace-shaped.
+  if (path.basename(path.dirname(realRepo)) === 'repos') {
+    roots.push(path.join(path.dirname(path.dirname(realRepo)), 'farmslot'));
+  }
+  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, simulator] = best;
+      return formatKvLines({
+        ...(cdp !== undefined ? { CDP_PORT: cdp } : {}),
+        ...(port !== undefined ? { WATCHER_PORT: port } : {}),
+        ...(slotId ? { SLOT_ID: slotId } : {}),
+        ...(simulator ? { IOS_SIMULATOR: simulator } : {}),
+      });
+    }
+  }
+  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 != null && c.metroPort !== '')) {
+        return formatKvLines({
+          ...(c.metroPort != null && c.metroPort !== '' ? { 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;
+    const watcherPort = c.watcherPort != null && c.watcherPort !== '' ? c.watcherPort : undefined;
+    if (!simulator && watcherPort === undefined) return null;
+    return formatKvLines({
+      ...(watcherPort !== undefined ? { WATCHER_PORT: 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`);