@deeeed/metamask-harness 0.78.0 → 0.80.0

package/dist/commands/fixtures.js

@@ -4,9 +4,8 @@ import path from "node:path";
 import { runnerDir, walletFixturePath } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { fixtureFileSummary, fixtureSummary } from "../doctor.js";
-import { acquireCheckoutLock } from "../checkout-lock.js";
+import { acquireCheckoutLock, adapterDetectNext, checkoutBusyOut, EXIT, flag, parseFlags, resolveFlagsAdapter, scriptOverride, spawnScript, spawnScriptStreaming, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 import { applyDeviceTargeting } from "./device-target.js";
-import { ADAPTER_DETECT_NEXT, checkoutBusyOut, EXIT, flag, parseFlags, resolveAdapter, scriptOverride, spawnScript, spawnScriptStreaming, str, targetOf, usageOut } from "./shared.js";
 import { FeatureFlagSpecError, fixtureFeatureFlags, parseRemoteFlagSpec } from "../feature-flags.js";
 const FIXTURES_BOOLEANS = /* @__PURE__ */ new Set(["dev", "force", "json"]);
 const FIXTURE_STREAM_TIMEOUT_MS = 12e4;
@@ -39,9 +38,9 @@ function fixturesStatus(options) {
     );
   }
   const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
+  const adapter = resolveFlagsAdapter(options, target);
   if (!adapter) {
-    return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
+    return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }
   const canonical = walletFixturePath(target);
   const summary = fixtureSummary(target, adapter);
@@ -115,9 +114,9 @@ async function handleFixturesLocked(argv) {
     );
   }
   const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
+  const adapter = resolveFlagsAdapter(options, target);
   if (!adapter) {
-    return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
+    return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }
   const surface = getAdapterSurface(adapter);
   surface.resolveSlotPorts(target);

package/dist/commands/help.js

@@ -1,9 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
-import { color } from "../cli-color.js";
-import { detectAdapter } from "../harness.js";
-import { optionString, parseArgs, targetPath } from "./parse-args.js";
+import { color, detectAdapter, optionString, parseArgs, targetPath } from "@farmslot/recipe-cli/harness";
 import { handleHelpReview } from "./review.js";
+import "../adapters/surface.js";
 const UNSCOPED_NEXT = "cd into a MetaMask checkout or pass --adapter <mobile|extension|core|terminal>";
 function validHelpLine(value) {
   return typeof value === "string" || Boolean(value && typeof value.text === "string" && Array.isArray(value.adapters) && value.adapters.length > 0 && value.adapters.every((adapter) => ["mobile", "extension", "core", "terminal"].includes(adapter)));
@@ -70,7 +69,7 @@ function renderRecipeHelp(topic, harnessVersion, adapter) {
 `;
 }
 function handleHelp(argv, context) {
-  const parsed = parseArgs(argv, "help");
+  const parsed = parseArgs(argv);
   if (parsed.positional[0] === "review") return handleHelpReview(argv, context.harnessVersion);
   const target = targetPath(parsed.options);
   const adapter = optionString(parsed.options, "adapter") ?? detectAdapter(target) ?? "unscoped";

package/dist/commands/launch/device.js

@@ -1,15 +1,8 @@
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
-import { color, colorHumanMessage } from "../../cli-color.js";
-import { handleHarness } from "../../harness.js";
-import { recipeRuntimePath, walletFixturePath } from "../../paths.js";
+import { color, colorHumanMessage, recipeRuntimePath, handleHarness, EXIT, flag, str, checkHealBounds, ensureOverlay, newHealState } from "@farmslot/recipe-cli/harness";
+import { walletFixturePath } from "../../paths.js";
 import { getAdapterSurface } from "../../adapters/surface.js";
-import { EXIT, flag, str } from "../shared.js";
-import {
-  checkHealBounds,
-  ensureOverlay,
-  newHealState
-} from "../../heal-bounds.js";
 import {
   FeatureFlagSpecError,
   fixtureFeatureFlags,
@@ -131,7 +124,7 @@ async function runDeviceLaunch(context, profile) {
   if (heal === "off") {
     return launch.fail(state, {
       code: "LAUNCH_FAILED",
-      message: `launch ${adapter}${launch.mobileTarget ? ` ${launch.mobileTarget}` : ""} failed (healing off)`,
+      message: `launch ${adapter}${launch.platformTarget ? ` ${launch.platformTarget}` : ""} failed (healing off)`,
       recoverable: false,
       exitCode: EXIT.infra
     });
@@ -166,7 +159,7 @@ async function runDeviceLaunch(context, profile) {
   if (retryReadinessFailure) return launch.fail(state, retryReadinessFailure);
   return launch.fail(state, {
     code: "SAME_RECOVERY_TWICE",
-    message: `launch ${adapter}${launch.mobileTarget ? ` ${launch.mobileTarget}` : ""} failed again after ${recovery.code} recovery \u2014 refusing to loop.`,
+    message: `launch ${adapter}${launch.platformTarget ? ` ${launch.platformTarget}` : ""} failed again after ${recovery.code} recovery \u2014 refusing to loop.`,
     recoverable: false,
     exitCode: EXIT.bounded,
     originalError: attempt.output.trim() || void 0
@@ -231,7 +224,7 @@ async function settleLaunch(launch, profile, state, sidepanelRecoveryAllowed, pr
   return launchPass(launch, profile, state, proven.flags);
 }
 function launchPass(launch, profile, state, remoteFlags) {
-  const { adapter, mobileTarget, target, stream, tier } = launch;
+  const { adapter, platformTarget, target, stream, tier } = launch;
   if (stream.enabled) {
     for (const mutation of state.mutations) stream.mutation(mutation);
     for (const recovery of state.recovered) stream.recovery(recovery);
@@ -269,13 +262,13 @@ function launchPass(launch, profile, state, remoteFlags) {
     const tierNote = tier === "quick" ? "quick relaunch, no native build" : tier;
     const devNote = process.env.MM_HARNESS_BIN ? ` ${color("dim", "[dev: MM_HARNESS_BIN]")}` : "";
     console.error(
-      `${color("ok", "\u2713")} launch ${adapter}${mobileTarget ? ` ${mobileTarget}` : ""} \u2014 ${color("ok", profile.deviceLabel(launch))} \xB7 ${tierNote} \xB7 app + bridge ready${devNote}`
+      `${color("ok", "\u2713")} launch ${adapter}${platformTarget ? ` ${platformTarget}` : ""} \u2014 ${color("ok", profile.deviceLabel(launch))} \xB7 ${tierNote} \xB7 app + bridge ready${devNote}`
     );
   }
   return EXIT.ok;
 }
 function launchFail(launch, profile, state, failure) {
-  const { adapter, mobileTarget, target, stream, tier } = launch;
+  const { adapter, platformTarget, target, stream, tier } = launch;
   const userAction = failure.userAction ?? `mm-harness doctor --fix --adapter ${adapter} --target ${shellQuote(target)} --json`;
   if (stream.enabled) {
     for (const mutation of state.mutations) stream.mutation(mutation);
@@ -289,7 +282,7 @@ function launchFail(launch, profile, state, failure) {
     });
     stream.complete("fail", failure.exitCode, {
       adapter,
-      platform: mobileTarget ?? null,
+      platform: platformTarget ?? null,
       tier,
       recovered: state.recovered,
       mutations: state.mutations,
@@ -304,7 +297,7 @@ function launchFail(launch, profile, state, failure) {
           schemaVersion: 1,
           command: "launch",
           adapter,
-          platform: mobileTarget ?? null,
+          platform: platformTarget ?? null,
           tier,
           status: "fail",
           phase: state.attemptedRecoveries.length ? "recover" : "launch",
@@ -328,7 +321,7 @@ function launchFail(launch, profile, state, failure) {
     );
   } else {
     console.error(colorHumanMessage(
-      `\u2717 launch ${adapter}${mobileTarget ? ` ${mobileTarget}` : ""} failed
+      `\u2717 launch ${adapter}${platformTarget ? ` ${platformTarget}` : ""} failed
   ${failure.message}` + (failure.originalError ? `
   --- original failure ---
 ${failure.originalError}` : "") + `

package/dist/commands/launch/extension.js

@@ -6,14 +6,9 @@ import path from "node:path";
 import {
   depsCheck,
   recordDepsBaseline
-} from "@farmslot/recipe-harness/runtime/deps-readiness";
-import { colorHumanMessage } from "../../cli-color.js";
-import {
-  importRecipeHarnessRuntimeCdp,
-  recipeHarnessPath,
-  recipeRuntimeDir,
-  runnerDir
-} from "../../paths.js";
+} from "@farmslot/recipe-runner/runtime/deps-readiness";
+import { colorHumanMessage, recipeHarnessPath, recipeRuntimeDir, EXIT, spawnScriptStreaming } from "@farmslot/recipe-cli/harness";
+import { importRecipeHarnessRuntimeCdp, runnerDir } from "../../paths.js";
 import { extensionIdFromKey } from "../../adapters/extension/extension-id.js";
 import {
   EXTENSION_PRODUCT_CONFIG_FINGERPRINT_FILENAME,
@@ -29,7 +24,6 @@ import {
 import { checkExtensionRuntimeHealth } from "../../adapters/extension/runtime.js";
 import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
 import { isExtensionWatcherLive, stopExtensionWatcher } from "../../adapters/slot-ports.js";
-import { EXIT, spawnScriptStreaming } from "../shared.js";
 import { readExtensionPinnedFlags } from "../../adapters/extension/feature-flags.js";
 import { sameFeatureFlags } from "../../feature-flags.js";
 const { CdpSession } = await importRecipeHarnessRuntimeCdp();

package/dist/commands/launch/mobile.js

@@ -1,3 +1,4 @@
+import { EXIT } from "@farmslot/recipe-cli/harness";
 import { prepareMobile } from "../../adapters/mobile/prepare.js";
 import {
   mobileSourceCheck,
@@ -7,7 +8,6 @@ import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
 import { pinMobileFeatureFlags } from "../../adapters/mobile/feature-flags.js";
 import { toRemoteFlagSpec } from "../../feature-flags.js";
 import { clearMobileReleaseArtifactState } from "../../adapters/mobile/release-artifact-state.js";
-import { EXIT } from "../shared.js";
 async function launchMobile(target, mobileTarget, tier, json, restartApp = false, clearMetro = false, remoteFlags) {
   clearMobileReleaseArtifactState(target);
   await ensureHarnessFresh(target, "mobile");

package/dist/commands/list-executables.js

@@ -2,9 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { resolveActionManifest } from "../manifest.js";
 import { importRecipeProtocol } from "../paths.js";
-import { color } from "../cli-color.js";
-import { EXIT } from "./shared.js";
-import { optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "./parse-args.js";
+import { color, EXIT, optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "@farmslot/recipe-cli/harness";
 import { actionDomain, describeManifestActions, renderHumanActionCatalog } from "./manifest.js";
 import { shortActionNames } from "@farmslot/recipe-cli";
 import {

package/dist/commands/logs.js

@@ -1,16 +1,16 @@
+import { adapterDetectNext, EXIT, flag, parseFlags, resolveFlagsAdapter, spawnInherit, spawnScript, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 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, spawnInherit, spawnScript, str, targetOf, usageOut } from "./shared.js";
 const LOGS_BOOLEANS = /* @__PURE__ */ new Set(["full", "json", "window"]);
 async function handleLogs(argv) {
   const { options } = parseFlags(argv, LOGS_BOOLEANS);
   const json = flag(options, "json");
   const target = targetOf(options);
-  const adapter = resolveAdapter(options, target);
+  const adapter = resolveFlagsAdapter(options, target);
   if (!adapter) {
-    return usageOut(json, "logs", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
+    return usageOut(json, "logs", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }
   const surface = getAdapterSurface(adapter);
   if (surface.headless) {

package/dist/commands/manifest.js

@@ -1,22 +1,11 @@
 import { resolveActionManifest } from "../manifest.js";
-import { color } from "../cli-color.js";
-import { EXIT } from "./shared.js";
-import {
-  isRecord,
-  optionFlag,
-  optionString,
-  optionStrings,
-  resolveAdapter,
-  shellQuoteArg
-} from "./parse-args.js";
+import { closest, color, isSensitiveKey, redactStructuredValue, EXIT, isRecord, optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "@farmslot/recipe-cli/harness";
 import { resolveMetaMaskLibrarySources } from "./run-engine.js";
-import { isSensitiveKey, redactStructuredValue } from "../command-journal.js";
 import {
   OFFICIAL_RECIPE_ACTIONS,
   officialRecipeActionCapabilities
 } from "@farmslot/protocol";
 import { metaMaskActionExecutionCapabilities } from "../recipe-security.js";
-import { closest } from "../command-contract.js";
 import {
   actionCapabilityMatrix,
   actionCategory,

package/dist/commands/mobile-device-view.js

@@ -1,6 +1,8 @@
 import { execFileSync } from "node:child_process";
-import { resolveMobileToolPath } from "../../library/actions/mobile/platform/tool-paths.mjs";
-import { listConnectedDevices } from "../devices.js";
+import {
+  listConnectedDevices,
+  resolveMobileToolPath
+} from "@farmslot/adapter-rn";
 import { renderDeviceList, scopedDevices } from "./device-target.js";
 import { probeMobileLiveState } from "./status-probe.js";
 function mobileDeviceView(allDevices) {

package/dist/commands/overlay.js

@@ -0,0 +1,110 @@
+import {
+  argValue,
+  hasArg,
+  shellQuoteArg
+} from "@farmslot/recipe-cli/harness";
+import { getAdapterSurface } from "../adapters/surface.js";
+const USAGE = `mm-harness \u2014 install and validate the MetaMask recipe runtime in a checkout.
+
+Run it from inside a MetaMask checkout; the platform (mobile | extension | core | terminal)
+is auto-detected from the repo. Pass --platform only to override.
+
+Commands (one copy-pasteable example each):
+  install   Install the recipe harness runtime overlay into the checkout.
+              mm-harness install
+  verify    Check the harness/runtime is present and healthy (no app launch).
+              mm-harness verify
+  cleanup   Remove the installed harness overlay and restore the checkout.
+              mm-harness cleanup
+
+Options:
+  --platform <mobile|extension|core|terminal>   Override auto-detection (alias: --adapter).
+  --target <repo>                      Checkout to operate on (default: current dir).
+  --json                               Machine-readable summary for agents/scripts.
+  -- <args>                            Forward the rest verbatim to the underlying
+                                       script, e.g. -- --platform ios --preflight-mode fast
+                                       (mobile) or -- --cdp-port 6665 (extension).
+
+Examples:
+  mm-harness install                          # inside a checkout, auto-detected
+  mm-harness verify --platform extension
+  mm-harness cleanup --target ../metamask-mobile
+
+core supports install, verify, and cleanup (headless; no live).`;
+const overlayCommandOptions = {
+  usage: USAGE,
+  install: ({ adapter, target, forward, json }) => hasArg(forward, "--runway") ? handleRunwayInstall(adapter, target, forward, json) : void 0
+};
+async function handleRunwayInstall(adapter, target, forward, json) {
+  const rerunCommand = runwayInstallRerunCommand(adapter, target, forward, json);
+  const surface = getAdapterSurface(adapter);
+  const runtimeDir = argValue(forward, "--runtime-dir");
+  const watcherPort = argValue(forward, "--watcher-port");
+  const result = await surface.runwayProvision.run(target, {
+    json,
+    platform: argValue(forward, "--platform") ?? "ios",
+    branch: argValue(forward, "--branch"),
+    defaultBranch: argValue(forward, "--default-branch"),
+    run: argValue(forward, "--run"),
+    cacheRoot: argValue(forward, "--cache-root"),
+    simulator: argValue(forward, "--simulator") ?? argValue(forward, "--device"),
+    runtime: argValue(forward, "--runtime"),
+    deviceType: argValue(forward, "--device-type"),
+    slot: argValue(forward, "--slot"),
+    watcherPort,
+    runtimeDir,
+    force: hasArg(forward, "--force"),
+    resolveOnly: hasArg(forward, "--resolve-only"),
+    rerunCommand
+  });
+  const provisionedSimulator = typeof result.simulator === "object" && result.simulator ? result.simulator : void 0;
+  const provisionedDevice = typeof provisionedSimulator?.udid === "string" ? provisionedSimulator.udid : typeof provisionedSimulator?.name === "string" ? provisionedSimulator.name : void 0;
+  const next = result.status === "pass" && surface.runwayProvision.launchNext && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? "ios")} --adapter ${adapter} --target ${shellQuoteArg(target)}` + (provisionedDevice ? ` --device ${shellQuoteArg(provisionedDevice)}` : "") : void 0;
+  const output = next ? { ...result, next } : result;
+  if (json) {
+    console.log(JSON.stringify(output, null, 2));
+  } else if (result.status === "pass") {
+    const cache = typeof result.cache === "object" && result.cache ? result.cache : void 0;
+    const simulator = provisionedSimulator;
+    const artifact = typeof result.artifact === "object" && result.artifact ? result.artifact : void 0;
+    if (result.resolveOnly) {
+      console.error(`\u2713 resolved Runway app for ${adapter} ${result.platform ?? ""} run=${artifact?.runId ?? "unknown"} revision=${artifact?.revision ?? "unknown"} artifact=${artifact?.artifactName ?? "unknown"}`);
+    } else {
+      const action = result.skipped ? "already provisioned" : "installed Runway app";
+      console.error(`\u2713 ${action} for ${adapter} ${result.platform ?? ""} simulator=${simulator?.name ?? "unknown"} udid=${simulator?.udid ?? "unknown"} cache=${cache?.status ?? "skip"}`);
+    }
+    if (next) console.error(`  Next: ${next}`);
+  } else {
+    console.error(`\u2717 mm-harness install --runway: ${result.error?.message ?? "runway install failed"}
+  Next: ${result.error?.userAction ?? rerunCommand}`);
+  }
+  return result.exitCode;
+}
+function runwayInstallRerunCommand(adapter, target, forward, json) {
+  const parts = ["mm-harness", "install", "--runway", "--adapter", adapter, "--target", shellQuoteArg(target)];
+  const valueFlags = [
+    "--platform",
+    "--branch",
+    "--default-branch",
+    "--run",
+    "--cache-root",
+    "--simulator",
+    "--device",
+    "--slot",
+    "--watcher-port",
+    "--runtime-dir",
+    "--runtime",
+    "--device-type"
+  ];
+  for (const flag of valueFlags) {
+    const value = argValue(forward, flag);
+    if (value) parts.push(flag, shellQuoteArg(value));
+  }
+  if (hasArg(forward, "--force")) parts.push("--force");
+  if (hasArg(forward, "--resolve-only")) parts.push("--resolve-only");
+  if (json) parts.push("--json");
+  return parts.join(" ");
+}
+export {
+  overlayCommandOptions
+};

package/dist/commands/pin.js

@@ -1,3 +1,4 @@
+import { EXIT } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -6,7 +7,6 @@ import os from "node:os";
 import path from "node:path";
 import { isPin, PIN_MARKER } from "../harness-pin.js";
 import { runnerDir } from "../paths.js";
-import { EXIT } from "./shared.js";
 const PACKAGE_NAME = "@deeeed/metamask-harness";
 const STALE_STAGING_MS = 30 * 60 * 1e3;
 const RUNNER_STATE = /* @__PURE__ */ new Set([".omc", ".omx"]);

package/dist/commands/pr-body.js

@@ -1,10 +1,10 @@
+import { optionFlag, optionString, parseArgs, usageError } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
 import { BODY_FILE, renderPrBody } from "../pr-body/render.js";
-import { optionFlag, optionString, parseArgs, usageError } from "./parse-args.js";
 const USAGE = "Usage: mm-harness pr-body render <task-dir> [--command <text>] [--out <file>] [--json]";
 async function handlePrBody(argv) {
-  const parsed = parseArgs(argv, "pr-body");
+  const parsed = parseArgs(argv);
   const [action, taskArg] = parsed.positional;
   if (action !== "render" || !taskArg) throw usageError(USAGE);
   const taskDir = path.resolve(taskArg);

package/dist/commands/prepare.js

@@ -1,20 +1,15 @@
-import { acquireCheckoutLock, trackCheckoutChild } from "../checkout-lock.js";
-import { recordCommandStage } from "../command-journal.js";
+import { acquireCheckoutLock, trackCheckoutChild, recordCommandStage, color, stripAnsi, harnessExecutable, recipeRuntimeDir, detectAdapter, optionFlag, optionString, parseArgs, targetPath, usageError, EXIT } from "@farmslot/recipe-cli/harness";
 import { spawn } from "node:child_process";
-import { OperationOutputTail } from "@farmslot/recipe-harness/runtime/operation";
+import { OperationOutputTail } from "@farmslot/recipe-runner/runtime/operation";
 import fs from "node:fs";
 import path from "node:path";
 import {
   READINESS_RECORD
 } from "@farmslot/protocol";
-import { color, stripAnsi } from "../cli-color.js";
 import { runnerProvenance } from "../doctor.js";
-import { detectAdapter } from "../harness.js";
 import { adapterRegistry } from "../adapters/registry.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { harnessExecutable, PREPARE_PROGRESS_ARTIFACT, recipeRuntimeDir } from "../paths.js";
-import { optionFlag, optionString, parseArgs, targetPath, usageError } from "./parse-args.js";
-import { EXIT } from "./shared.js";
+import { PREPARE_PROGRESS_ARTIFACT } from "../paths.js";
 import { formatDuration } from "./status-watch.js";
 import { FeatureFlagSpecError, parseRemoteFlagSpec } from "../feature-flags.js";
 const USAGE = "mm-harness prepare [--target <checkout>] [--platform mobile|extension|core] [--mobile-platform ios|android] [--clear-metro] [--artifacts-dir <dir>] [--json]";
@@ -282,7 +277,7 @@ function resolvePlatform(requested, target) {
   );
 }
 async function handlePrepare(argv) {
-  const { options } = parseArgs(argv, "prepare");
+  const { options } = parseArgs(argv);
   const target = targetPath(options);
   if (!fs.existsSync(target)) return handlePrepareLocked(argv);
   const lock = acquireCheckoutLock(target, "prepare");
@@ -298,11 +293,11 @@ async function handlePrepare(argv) {
   }
 }
 async function handlePrepareLocked(argv) {
-  const { options } = parseArgs(argv, "prepare");
+  const { options } = parseArgs(argv);
   const json = optionFlag(options, "json");
   const target = targetPath(options);
   const surface = resolvePlatform(optionString(options, "platform"), target);
-  const platform = surface.adapter;
+  const platform = surface.id;
   const artifactsDir = path.resolve(
     optionString(options, "artifactsDir") ?? path.join(target, recipeRuntimeDir())
   );

package/dist/commands/provision.js

@@ -1,27 +1,18 @@
-import { detectAdapter } from "../harness.js";
+import { detectAdapter, adapterDetectNext, usageOut, applyWatcherPortOption, optionFlag, optionString, shellQuote, shellQuoteArg, targetPath } from "@farmslot/recipe-cli/harness";
 import { assertAdapter } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { ADAPTER_DETECT_NEXT, usageOut } from "./shared.js";
-import {
-  applyWatcherPortOption,
-  optionFlag,
-  optionString,
-  shellQuote,
-  shellQuoteArg,
-  targetPath
-} from "./parse-args.js";
 async function handleProvision({ positional, options, rawArgv }) {
   applyWatcherPortOption(options);
   const json = optionFlag(options, "json");
   const target = targetPath(options);
   const adapter = optionString(options, "adapter") ?? detectAdapter(target);
   if (!adapter) {
-    return usageOut(json, "provision", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
+    return usageOut(json, "provision", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }
   try {
     assertAdapter(adapter);
   } catch (error) {
-    return usageOut(json, "provision", error instanceof Error ? error.message : String(error), ADAPTER_DETECT_NEXT);
+    return usageOut(json, "provision", error instanceof Error ? error.message : String(error), adapterDetectNext());
   }
   const surface = getAdapterSurface(adapter);
   const rerunCommand = provisionRerunCommand(rawArgv, options, adapter, target);

package/dist/commands/recipe-advice.js

@@ -1,10 +1,9 @@
+import { CliError, isRecord, optionFlag, optionString, usageError, EXIT } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
 import { adviseRecipe } from "../recipe-assistance.js";
 import { resolveAdvisorPolicy } from "../advisor-policy.js";
 import { RECIPE_ADVICE_RUBRIC, RECIPE_PLANNING_RUBRIC } from "../recipe-assistance-rubric.js";
-import { CliError, isRecord, optionFlag, optionString, usageError } from "./parse-args.js";
-import { EXIT } from "./shared.js";
 async function handleRecipeAdvice(options, mode = "review") {
   try {
     return await runRecipeAdvice(options, mode);

package/dist/commands/recipe-quality.js

@@ -1,10 +1,9 @@
+import { EXIT, usageOut, optionFlag, optionString, parseArgs } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
 import {
   buildRecipeQualityArtifact
 } from "@farmslot/agent-runtime";
-import { EXIT, usageOut } from "./shared.js";
-import { optionFlag, optionString, parseArgs } from "./parse-args.js";
 const BUILD_USAGE = "mm-harness recipe-quality build --input <compact.json> --output <path> [--json]";
 const SHORTHAND_USAGE = "mm-harness recipe-quality build --input <compact.json> --output <path> [--json]\n  Shorthand: mm-harness recipe-quality --input <compact.json> --output <path> [--json]\n  Note: apply the quality bar from mm-harness help, then build its compact verdict here.";
 function errorMessage(error) {
@@ -34,7 +33,7 @@ function invalidOut(json, message, source) {
   return EXIT.validation;
 }
 async function handleRecipeQuality(argv) {
-  const { positional, options } = parseArgs(argv, "recipe-quality");
+  const { positional, options } = parseArgs(argv);
   const json = optionFlag(options, "json");
   const action = positional[0];
   if (action === "advise" || action === "plan" || action === "advisor-status") {

package/dist/commands/resolve-extension.js

@@ -1,11 +1,5 @@
+import { adapterOption, optionFlag, optionString, parsePort, targetPath } from "@farmslot/recipe-cli/harness";
 import { resolveExtensionId } from "../adapters/extension/extension-id.js";
-import {
-  adapterOption,
-  optionFlag,
-  optionString,
-  parsePort,
-  targetPath
-} from "./parse-args.js";
 async function handleResolveExtension({ options }) {
   const adapter = adapterOption(options);
   if (adapter !== "extension") throw new Error("resolve-extension currently applies to the extension adapter.");

package/dist/commands/review.js

@@ -1,6 +1,6 @@
+import { detectAdapter, optionFlag, optionString, parseArgs, targetPath, usageError } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
-import { detectAdapter } from "../harness.js";
 import { runnerDir } from "../paths.js";
 import {
   configPath,
@@ -15,7 +15,7 @@ import {
   resolveReference,
   defaultBaseRef
 } from "../review/knowledge.js";
-import { optionFlag, optionString, parseArgs, targetPath, usageError } from "./parse-args.js";
+import "../adapters/surface.js";
 const EXIT_OK = 0;
 let cachedHarnessVersion;
 function harnessVersion() {
@@ -54,7 +54,7 @@ function resolveReviewContext(options, { fetch = true } = {}) {
   return context;
 }
 function handleHelpReview(argv, harnessVersion2) {
-  const parsed = parseArgs(argv, "help");
+  const parsed = parseArgs(argv);
   const context = resolveReviewContext(parsed.options, { fetch: false });
   const input = {
     adapter: context.adapter,
@@ -73,7 +73,7 @@ function handleHelpReview(argv, harnessVersion2) {
   return EXIT_OK;
 }
 async function handleReview(argv, version = harnessVersion()) {
-  const parsed = parseArgs(argv, "review");
+  const parsed = parseArgs(argv);
   const subcommand = parsed.positional[0];
   if (subcommand !== "checklist") {
     throw usageError("Usage: mm-harness review checklist [--domain <name>] [--since <sha>] [--base <ref>] [--out <file>] [--json]");