@deeeed/metamask-harness 0.92.29 → 0.92.31

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 ## Unreleased
 
+## 0.92.31 - 2026-10-19
+
+### Changed
+
+- Action manifests resolve through the shared Farmslot runtime catalog. Pins `@farmslot/recipe-cli` 0.23.8. As before, a selected library's manifest that declares an official action or an observer is refused, a plugin's own and its parent plugin's actions keep their library as their source, and official actions are labelled `official` and listed first. What changes:
+  - A library's `manifests/shared.action-manifest.json`, and an action manifest a library maps in `recipe-library.json` `actions`, now declare actions for the adapter, as in `farmslot`.
+  - Resolving actions reads and validates the whole library (`recipe-library.json`, its `requires` and its files) and records each source's digest, so a plan's custom-action `adapterOrigin.digest` changes. A library that declares `requires` on `@farmslot/recipe-cli` is now refused by `actions` too, as `run` and `call` already did.
+  - A plugin's own custom actions are listed before those of the parent it extends, and the plugin's declaration wins when both declare the same action.
+  - A library selected under the name `personal` is labelled `team`; the default personal library is still `personal`.
+  - An empty `observers` list is omitted from the resolved manifest.
+  - An invalid or unreadable action manifest, from a library or a task, reports the shared message (`Action manifest <file> is invalid: …` or `… is unreadable: …`). An official-action conflict now says `libraries may declare namespaced custom actions only`.
+  - Resolving actions takes about 20 ms longer (library digests); `call <TAB>` completion pays it too.
+- Launch `Next:` hints use the shared Farmslot shell quoting: a target path, simulator name or serial containing `,` or `%` is now quoted, and a `'` is written as `'\''`. Both forms are valid shell. Internal copies of SDK helpers (`shellQuote`, `assertAdapter`), the unused JSONL progress emitter and a stale second command registry are removed, and `provision` and `install --runway` share one Runway output path; their output is unchanged.
+
+## 0.92.30 - 2026-10-18
+
+### Fixed
+
+- Mobile Android recordings: after `adb screenrecord` restarts its segment (the 150 s roll or the 180 s limit), the next proof node now gets the same 1 s lead-in as the first one. Before, a node that started right after the roll fell outside both segments, so its claim stayed weak. Pins `@farmslot/adapter-rn` 0.22.29.
+
 ## 0.92.29 - 2026-10-18
 
 ### Fixed

package/adapters/manifest.json

@@ -560,9 +560,9 @@
       "id": "lib/cli-ux",
       "entry": "adapters/shared/cli-ux.sh",
       "kind": "lib",
-      "purpose": "Shared bash UX helpers: progress, log-tui watch, failure playbooks, harness stale warnings.",
+      "purpose": "Shared bash UX helpers: log-tui watch, failure playbooks, harness stale warnings.",
       "inputs": "sourced by adapters that invoke recipe CLI commands",
-      "outputs": "recipe_progress / recipe_watch_rebuild_log / recipe_failure_playbook functions"
+      "outputs": "recipe_watch_rebuild_log / recipe_failure_playbook functions"
     },
     {
       "id": "lib/log-tui",

package/adapters/shared/cli-ux.sh

@@ -25,19 +25,6 @@ recipe_color() {
   esac
 }
 
-recipe_progress_script() {
-  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() {
   printf '%s' "${RECIPE_LOG_TUI_SCRIPT:-${RECIPE_RUNNER_ROOT:?}/adapters/shared/log-tui.mjs}"
 }
@@ -91,22 +78,6 @@ recipe_instant_hint() {
     "$(recipe_color dim "$message")" >&2
 }
 
-recipe_progress() {
-  local verb="$1" phase="$2" message="$3" elapsed="${4:-}"
-  local args=(emit --command "$verb" --phase "$phase" --message "$message")
-  [ -n "$elapsed" ] && args+=(--elapsed-ms "$elapsed")
-  [ "${RECIPE_PROGRESS_JSON:-}" = "1" ] && args+=(--json)
-  node "$(recipe_progress_script)" "${args[@]}" || true
-}
-
-recipe_done() {
-  local verb="$1" status="$2" message="$3" elapsed="${4:-}"
-  local args=(done --command "$verb" --status "$status" --message "$message")
-  [ -n "$elapsed" ] && args+=(--elapsed-ms "$elapsed")
-  [ "${RECIPE_PROGRESS_JSON:-}" = "1" ] && args+=(--json)
-  node "$(recipe_progress_script)" "${args[@]}" || true
-}
-
 recipe_failure_playbook() {
   local verb="$1" reason="$2"
   shift 2

package/dist/adapters/extension/launch.js

@@ -1,12 +1,11 @@
 import path from "node:path";
-import { colorHumanMessage, EXIT, spawnScript } from "@farmslot/recipe-cli/harness";
+import { colorHumanMessage, EXIT, spawnScript, shellQuoteArg } from "@farmslot/recipe-cli/harness";
 import {
   extensionDepsBlock,
   extensionRuntimeReusable,
   installExtensionDeps,
   launchExtension
 } from "../../commands/launch/extension.js";
-import { shellQuote } from "../../commands/launch/quote.js";
 import {
   fixtureFeatureFlags,
   sameFeatureFlags,
@@ -73,7 +72,7 @@ const extensionLaunchProfile = {
     if (remoteFlagSpec !== void 0 && watch) {
       return {
         message: "--remote-flag cannot be applied with --watch: the watcher never re-creates the dist snapshot that carries the pin.",
-        userAction: `mm-harness launch --adapter extension --remote-flag ${remoteFlagSpec} --target ${shellQuote(target)}`
+        userAction: `mm-harness launch --adapter extension --remote-flag ${remoteFlagSpec} --target ${shellQuoteArg(target)}`
       };
     }
     return void 0;
@@ -148,7 +147,7 @@ const extensionLaunchProfile = {
         recoverable: false,
         // The next step must leave the artifact alone: a --build here would replace
         // the artifact under validation with a source build.
-        userAction: Object.keys(fixtureFeatureFlags(walletFixturePath(target))).length > 0 ? `remove remoteFeatureFlags from ${shellQuote(walletFixturePath(target))}, then: mm-harness launch --adapter extension --target ${shellQuote(target)}` : `mm-harness launch --adapter extension --target ${shellQuote(target)}`,
+        userAction: Object.keys(fixtureFeatureFlags(walletFixturePath(target))).length > 0 ? `remove remoteFeatureFlags from ${shellQuoteArg(walletFixturePath(target))}, then: mm-harness launch --adapter extension --target ${shellQuoteArg(target)}` : `mm-harness launch --adapter extension --target ${shellQuoteArg(target)}`,
         exitCode: EXIT.infra,
         originalError: output.trim() || void 0
       };
@@ -159,7 +158,7 @@ const extensionLaunchProfile = {
         code: "EXTENSION_PRODUCT_CONFIG_REQUIRED",
         message: block?.message ?? "Extension product configuration was not ready when the build started.",
         recoverable: false,
-        userAction: block?.userAction ?? `mm-harness launch --adapter extension --target ${shellQuote(target)}`,
+        userAction: block?.userAction ?? `mm-harness launch --adapter extension --target ${shellQuoteArg(target)}`,
         exitCode: EXIT.infra
       };
     }
@@ -168,7 +167,7 @@ const extensionLaunchProfile = {
         code: "EXTENSION_BROWSER_REQUIRED",
         message: "the checkout Playwright browser is not installed; system Chrome is not a compatible unpacked-extension fallback. Installing the browser cache requires user approval.",
         recoverable: false,
-        userAction: `ask the user for approval, then run: cd ${shellQuote(target)} && yarn playwright install chromium`,
+        userAction: `ask the user for approval, then run: cd ${shellQuoteArg(target)} && yarn playwright install chromium`,
         exitCode: EXIT.infra
       };
     }
@@ -177,7 +176,7 @@ const extensionLaunchProfile = {
         code: output.includes("EXTENSION_BACKGROUND_UNRESPONSIVE:") ? "EXTENSION_BACKGROUND_UNRESPONSIVE" : "EXTENSION_STARTUP_UNVERIFIED",
         message: "Extension startup is not healthy; inspect the background error before restarting or resetting wallet state.",
         recoverable: false,
-        userAction: `mm-harness logs --target ${shellQuote(target)} --full`,
+        userAction: `mm-harness logs --target ${shellQuoteArg(target)} --full`,
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       };
@@ -187,7 +186,7 @@ const extensionLaunchProfile = {
         code: "EVM_RPC_EXECUTION_FAILED",
         message: "Background RPC fetch failed during JavaScript execution; this does not establish an Infura authentication or connectivity failure.",
         recoverable: false,
-        userAction: `mm-harness logs --target ${shellQuote(target)} --full`,
+        userAction: `mm-harness logs --target ${shellQuoteArg(target)} --full`,
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       };
@@ -197,7 +196,7 @@ const extensionLaunchProfile = {
         code: "EVM_RPC_UNREACHABLE",
         message: "EVM RPC readiness failed; Infura configured does not mean RPC reachable.",
         recoverable: false,
-        userAction: `Check the effective INFURA_PROJECT_ID from the environment, .metamaskprodrc, or ${shellQuote(path.join(target, ".metamaskrc"))}, then rerun: mm-harness launch --verify --target ${shellQuote(target)}`,
+        userAction: `Check the effective INFURA_PROJECT_ID from the environment, .metamaskprodrc, or ${shellQuoteArg(path.join(target, ".metamaskrc"))}, then rerun: mm-harness launch --verify --target ${shellQuoteArg(target)}`,
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       };
@@ -237,7 +236,7 @@ const extensionLaunchProfile = {
       message: pinned.message,
       recoverable: false,
       // A rebuild re-creates the snapshot; the flag is repeated only when one was asked for.
-      userAction: `mm-harness launch --adapter extension --build${spec ? ` --remote-flag ${spec}` : ""} --target ${shellQuote(target)}`,
+      userAction: `mm-harness launch --adapter extension --build${spec ? ` --remote-flag ${spec}` : ""} --target ${shellQuoteArg(target)}`,
       exitCode: EXIT.runtime
     };
   },

package/dist/adapters/mobile/launch.js

@@ -1,9 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
-import { recipeRuntimePath, EXIT, str, writeInteractiveProgress } from "@farmslot/recipe-cli/harness";
+import { recipeRuntimePath, EXIT, str, writeInteractiveProgress, shellQuoteArg } from "@farmslot/recipe-cli/harness";
 import { applyDeviceTargeting } from "../../commands/device-target.js";
 import { launchMobile } from "../../commands/launch/mobile.js";
-import { shellQuote } from "../../commands/launch/quote.js";
 const METRO_RESTARTED = "metro.restarted";
 function mobileProvisioningBlocked(output) {
   return /open-device: configured iOS simulator '.+' does not exist|open-device: no MetaMask bundle found|fast mode requires an installed (?:iOS dev client|Android dev client)/u.test(output);
@@ -20,8 +19,8 @@ function mobileBridgeTargetMissing(output) {
 function mobileProvisionCommand(target, platformTarget) {
   const platform = platformTarget === "android" ? "android" : "ios";
   const device = platform === "ios" ? process.env.SIM_UDID || process.env.IOS_SIMULATOR : process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || process.env.ANDROID_DEVICE;
-  const parts = ["mm-harness", "provision", "runway", platform, "--adapter", "mobile", "--target", shellQuote(target)];
-  if (device) parts.push("--device", shellQuote(device));
+  const parts = ["mm-harness", "provision", "runway", platform, "--adapter", "mobile", "--target", shellQuoteArg(target)];
+  if (device) parts.push("--device", shellQuoteArg(device));
   return parts.join(" ");
 }
 function isIosSimulatorUdid(value) {
@@ -90,7 +89,7 @@ const mobileLaunchProfile = {
         ok: false,
         code: "DEVICE_WRONG_PLATFORM",
         message: `--device ${device} did not resolve to an Android device for launch android.`,
-        userAction: `mm-harness status --target ${shellQuote(target)} --all-devices --json`
+        userAction: `mm-harness status --target ${shellQuoteArg(target)} --all-devices --json`
       };
     }
     if (platformTarget === "ios" && device && !process.env.IOS_SIMULATOR) {
@@ -98,7 +97,7 @@ const mobileLaunchProfile = {
         ok: false,
         code: "DEVICE_WRONG_PLATFORM",
         message: `--device ${device} did not resolve to an iOS simulator for launch ios.`,
-        userAction: `mm-harness status --target ${shellQuote(target)} --all-devices --json`
+        userAction: `mm-harness status --target ${shellQuoteArg(target)} --all-devices --json`
       };
     }
     return void 0;
@@ -154,7 +153,7 @@ const mobileLaunchProfile = {
         code: "MOBILE_DEVICE_AMBIGUOUS",
         message: `more than one iOS simulator matches ${ambiguousIosSimulator}.`,
         recoverable: false,
-        userAction: `mm-harness status --adapter mobile --target ${shellQuote(target)} --all-devices --json`,
+        userAction: `mm-harness status --adapter mobile --target ${shellQuoteArg(target)} --all-devices --json`,
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       });
@@ -164,7 +163,7 @@ const mobileLaunchProfile = {
         code: "MOBILE_DEVICE_NOT_FOUND",
         message: `the configured iOS simulator ${missingIosSimulator} no longer exists.`,
         recoverable: false,
-        userAction: `mm-harness status --adapter mobile --target ${shellQuote(target)} --all-devices --json`,
+        userAction: `mm-harness status --adapter mobile --target ${shellQuoteArg(target)} --all-devices --json`,
         exitCode: EXIT.runtime,
         originalError: output.trim() || void 0
       });

package/dist/commands/core-readiness.js

@@ -1,6 +1,7 @@
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
+import { shellQuote } from "@farmslot/recipe-cli/harness";
 import { resolveLiveTsx } from "../live-tsx.js";
 const requireFromHarness = createRequire(import.meta.url);
 const CORE_RUNTIME_DEPS = ["immer"];
@@ -64,9 +65,6 @@ function readYarnNodeLinker(target) {
     return void 0;
   }
 }
-function shellQuote(value) {
-  return `'${value.replace(/'/gu, `'\\''`)}'`;
-}
 export {
   coreDependencyBlock
 };

package/dist/commands/launch/device.js

@@ -1,6 +1,6 @@
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
-import { color, colorHumanMessage, recipeRuntimePath, handleHarness, EXIT, flag, str, checkHealBounds, ensureOverlay, newHealState } from "@farmslot/recipe-cli/harness";
+import { color, colorHumanMessage, recipeRuntimePath, handleHarness, EXIT, flag, str, checkHealBounds, ensureOverlay, newHealState, shellQuoteArg } from "@farmslot/recipe-cli/harness";
 import { walletFixturePath } from "../../paths.js";
 import { getAdapterSurface } from "../../adapters/surface.js";
 import {
@@ -10,7 +10,6 @@ import {
   remoteFlagRequestFor
 } from "../../feature-flags.js";
 import { webDappOnlyLaunchFlags } from "@farmslot/adapter-web/web-dapp";
-import { shellQuote } from "./quote.js";
 async function runDeviceLaunch(context, profile) {
   const { adapter, options, target, heal, jsonOutput, machine, stream, usage } = context;
   const webDappOnly = webDappOnlyLaunchFlags(options);
@@ -268,7 +267,7 @@ function launchPass(launch, profile, state, remoteFlags) {
 }
 function launchFail(launch, profile, state, failure) {
   const { adapter, platformTarget, target, stream, tier } = launch;
-  const userAction = failure.userAction ?? `mm-harness doctor --fix --adapter ${adapter} --target ${shellQuote(target)} --json`;
+  const userAction = failure.userAction ?? `mm-harness doctor --fix --adapter ${adapter} --target ${shellQuoteArg(target)} --json`;
   if (stream.enabled) {
     for (const mutation of state.mutations) stream.mutation(mutation);
     for (const recovery of state.recovered) stream.recovery(recovery);

package/dist/commands/overlay.js

@@ -4,6 +4,7 @@ import {
   shellQuoteArg
 } from "@farmslot/recipe-cli/harness";
 import { getAdapterSurface } from "../adapters/surface.js";
+import { runRunwayProvision } from "./provision.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)
@@ -40,7 +41,7 @@ async function handleRunwayInstall(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, {
+  return runRunwayProvision(surface, adapter, target, {
     json,
     platform: argValue(forward, "--platform") ?? "ios",
     branch: argValue(forward, "--branch"),
@@ -56,29 +57,15 @@ async function handleRunwayInstall(adapter, target, forward, json) {
     force: hasArg(forward, "--force"),
     resolveOnly: hasArg(forward, "--resolve-only"),
     rerunCommand
+  }, {
+    command: "mm-harness install --runway",
+    failed: "runway install failed",
+    resolved: `Runway app for ${adapter}`,
+    installed: "installed Runway app",
+    subject: `for ${adapter}`,
+    cacheFallback: "skip",
+    quoteTarget: shellQuoteArg
   });
-  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)];

package/dist/commands/provision.js

@@ -1,5 +1,4 @@
-import { contextAdapter, adapterDetectNext, usageOut, applyWatcherPortOption, optionFlag, optionString, shellQuote, shellQuoteArg, targetPath } from "@farmslot/recipe-cli/harness";
-import { assertAdapter } from "../paths.js";
+import { assertAdapter, contextAdapter, adapterDetectNext, usageOut, applyWatcherPortOption, optionFlag, optionString, shellQuote, shellQuoteArg, targetPath } from "@farmslot/recipe-cli/harness";
 import { getAdapterSurface } from "../adapters/surface.js";
 async function handleProvision({ positional, options, rawArgv }) {
   applyWatcherPortOption(options);
@@ -18,7 +17,7 @@ async function handleProvision({ positional, options, rawArgv }) {
   const rerunCommand = provisionRerunCommand(rawArgv, options, adapter, target);
   const platform = optionString(options, "platform") ?? optionString(options, "devicePlatform") ?? (positional[0] === "runway" ? positional[1] : positional[0]) ?? "ios";
   surface.runwayProvision.before?.(target, { json, platform, resolveOnly: optionFlag(options, "resolveOnly") });
-  const result = await surface.runwayProvision.run(target, {
+  return runRunwayProvision(surface, adapter, target, {
     json,
     platform,
     branch: optionString(options, "branch"),
@@ -34,27 +33,38 @@ async function handleProvision({ positional, options, rawArgv }) {
     force: optionFlag(options, "force"),
     resolveOnly: optionFlag(options, "resolveOnly"),
     rerunCommand
+  }, {
+    command: "mm-harness provision",
+    failed: "provision failed",
+    resolved: adapter,
+    installed: "provisioned",
+    subject: adapter,
+    cacheFallback: "unknown",
+    quoteTarget: shellQuote
   });
+}
+async function runRunwayProvision(surface, adapter, target, options, labels) {
+  const result = await surface.runwayProvision.run(target, options);
   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 ?? platform)} --adapter ${adapter} --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuoteArg(provisionedDevice)}` : "") : void 0;
+  const next = result.status === "pass" && surface.runwayProvision.launchNext && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? options.platform)} --adapter ${adapter} --target ${labels.quoteTarget(target)}` + (provisionedDevice ? ` --device ${shellQuoteArg(provisionedDevice)}` : "") : void 0;
   const output = next ? { ...result, next } : result;
-  if (json) {
+  if (options.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 ${adapter} ${result.platform ?? ""} run=${artifact?.runId ?? "unknown"} revision=${artifact?.revision ?? "unknown"} artifact=${artifact?.artifactName ?? "unknown"}`);
+      console.error(`\u2713 resolved ${labels.resolved} ${result.platform ?? ""} run=${artifact?.runId ?? "unknown"} revision=${artifact?.revision ?? "unknown"} artifact=${artifact?.artifactName ?? "unknown"}`);
     } else {
-      const action = result.skipped ? "already provisioned" : "provisioned";
-      console.error(`\u2713 ${action} ${adapter} ${result.platform ?? ""} simulator=${simulator?.name ?? "unknown"} udid=${simulator?.udid ?? "unknown"} cache=${cache?.status ?? "unknown"}`);
+      const action = result.skipped ? "already provisioned" : labels.installed;
+      console.error(`\u2713 ${action} ${labels.subject} ${result.platform ?? ""} simulator=${simulator?.name ?? "unknown"} udid=${simulator?.udid ?? "unknown"} cache=${cache?.status ?? labels.cacheFallback}`);
     }
     if (next) console.error(`  Next: ${next}`);
   } else {
-    console.error(`\u2717 mm-harness provision: ${result.error?.message ?? "provision failed"}
-  Next: ${result.error?.userAction ?? rerunCommand}`);
+    console.error(`\u2717 ${labels.command}: ${result.error?.message ?? labels.failed}
+  Next: ${result.error?.userAction ?? options.rerunCommand}`);
   }
   return result.exitCode;
 }
@@ -129,5 +139,6 @@ function findRawOption(rawArgv, flags) {
   return void 0;
 }
 export {
-  handleProvision
+  handleProvision,
+  runRunwayProvision
 };

package/dist/engine.js

@@ -1,4 +1,3 @@
-import path from "node:path";
 import { getAdapterSurface } from "./adapters/surface.js";
 import { consoleClassifier } from "./console-classifier.js";
 import {
@@ -9,18 +8,13 @@ import {
   loadTrustedMutationBase,
   validateTrustedMutationPlan
 } from "./funding-execution-context.js";
-import { resolveActionManifest, validateManifest } from "./manifest.js";
-import { LIBRARY_ACTION_NAMESPACE, runnerDir } from "./paths.js";
+import { BUNDLED_LIBRARY, resolveActionManifest, validateManifest } from "./manifest.js";
 import { metaMaskActionExecutionCapabilities } from "./recipe-security.js";
 async function loadEngineMutation({ cli, adapter, ...run }) {
   return await loadTrustedMutationBase({ ...fundingOptionsFromCli(cli), ...run }) ?? (getAdapterSurface(adapter).actions.trustedMutation === true ? fixturePolicyMutationBase({ artifactsDir: run.artifactsDir, rootRecipe: run.rootRecipe }) : void 0);
 }
 const metaMaskEngine = {
-  bundledLibrary: {
-    name: "metamask",
-    root: path.resolve(runnerDir, "library"),
-    actionNamespace: LIBRARY_ACTION_NAMESPACE
-  },
+  bundledLibrary: BUNDLED_LIBRARY,
   resolveActionManifest,
   validateManifest,
   actionCapabilities: metaMaskActionExecutionCapabilities,

package/dist/manifest.js

@@ -1,8 +1,8 @@
-import fs from "node:fs";
 import path from "node:path";
 import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
+import { createRuntimeRecipeCatalog } from "@farmslot/recipe-cli/harness";
 import { getAdapterSurface } from "./adapters/surface.js";
-import { manifestPath, readJson, importRecipeProtocol, runnerDir } from "./paths.js";
+import { LIBRARY_ACTION_NAMESPACE, manifestPath, readJson, importRecipeProtocol, runnerDir } from "./paths.js";
 function loadMetaMaskMobileActionManifest() {
   return asActionManifest(readJson(manifestPath("mobile")));
 }
@@ -24,155 +24,38 @@ class ActionManifestError extends Error {
     this.userAction = `fix the ${adapter} action manifest the message names, then rerun`;
   }
 }
+const BUNDLED_LIBRARY = {
+  name: "metamask",
+  root: path.resolve(runnerDir, "library"),
+  actionNamespace: LIBRARY_ACTION_NAMESPACE
+};
 async function resolveActionManifest(adapter, overridePath, librarySources, taskActionRoot) {
   try {
-    return await resolveActionManifestSources(adapter, overridePath, librarySources, taskActionRoot);
+    const catalog = createRuntimeRecipeCatalog({ runtime: getAdapterSurface(adapter), bundledLibrary: BUNDLED_LIBRARY });
+    return officialActions(
+      await catalog.resolveActionManifest(adapter, overridePath, librarySources, taskActionRoot),
+      !overridePath
+    );
   } catch (error) {
-    throw error instanceof ActionManifestError ? error : new ActionManifestError(adapter, error);
+    throw new ActionManifestError(adapter, error);
   }
 }
-async function resolveActionManifestSources(adapter, overridePath, librarySources, taskActionRoot) {
-  if (overridePath) {
-    const manifestPath2 = path.resolve(overridePath);
-    const implementationRoot = path.resolve(
-      taskActionRoot ?? defaultImplementationRoot(manifestPath2)
-    );
-    const manifest = loadActionManifest(adapter, manifestPath2);
-    await validateManifest(manifest);
-    return {
-      manifest,
-      actionSources: await describeManifestSources(manifest, {
-        name: "task",
-        tier: "task",
-        manifestPath: manifestPath2,
-        implementationRoot,
-        trust: "unknown"
-      })
-    };
-  }
-  const surfaceActions = getAdapterSurface(adapter).actions;
-  const canonicalPath = path.resolve(surfaceActions.manifestPath());
-  const canonicalRoot = path.dirname(path.dirname(canonicalPath));
-  const bundledRoot = path.resolve(runnerDir, "library");
-  const canonicalName = canonicalRoot === bundledRoot ? "metamask" : path.basename(canonicalRoot);
-  const sources = librarySources?.length ? librarySources : [{ name: canonicalName, root: canonicalRoot }];
-  const manifests = [];
-  for (const source of sources) {
-    const file = path.resolve(source.root, "manifests", `${adapter}.action-manifest.json`);
-    if (!fs.existsSync(file)) continue;
-    const manifest = asActionManifest(readJson(file));
-    await validateManifest(manifest);
-    manifests.push({ source, file, manifest });
-  }
-  for (const declared of surfaceActions.manifestPaths?.() ?? []) {
-    const file = path.resolve(declared);
-    if (file === canonicalPath || manifests.some((entry) => entry.file === file)) continue;
-    const manifest = asActionManifest(readJson(file));
-    await validateManifest(manifest);
-    const root = path.dirname(path.dirname(file));
-    const source = sources.find((candidate) => path.resolve(candidate.root) === root) ?? { name: path.basename(root), root };
-    manifests.push({ source, file, manifest });
-  }
-  if (!manifests.some((entry) => entry.file === canonicalPath)) {
-    const manifest = loadActionManifest(adapter);
-    await validateManifest(manifest);
-    manifests.push({
-      source: { name: canonicalName, root: canonicalRoot },
-      file: canonicalPath,
-      manifest
-    });
-  }
-  const canonical = manifests.find((entry) => entry.file === canonicalPath);
-  if (!canonical) throw new Error(`No ${adapter} action manifest could be resolved.`);
-  const isBundled = (entry) => path.resolve(entry.source.root) === bundledRoot;
-  const bundledParents = manifests.filter((entry) => entry !== canonical && isBundled(entry));
-  const official = new Set(OFFICIAL_RECIPE_ACTIONS);
-  const mergedActions = {};
-  const actionSources = /* @__PURE__ */ new Map();
-  for (const entry of [canonical, ...bundledParents]) {
-    for (const [name, action] of Object.entries(actionsOf(entry.manifest))) {
-      if (!official.has(name) || name in mergedActions) continue;
-      mergedActions[name] = action;
-      actionSources.set(name, { name: "official", tier: "official", manifestPath: entry.file });
-    }
-  }
-  const observers = bundledParents.length ? [canonical, ...bundledParents].flatMap((entry) => entry.manifest.observers ?? []).filter((observer, index, all) => all.findIndex((other) => other.ref === observer.ref) === index) : canonical.manifest.observers;
-  const custom = /* @__PURE__ */ new Set();
-  const ordered = [
-    ...manifests.filter((entry) => entry.file !== canonicalPath),
-    canonical
-  ];
-  for (const entry of ordered) {
-    const isCanonical = entry.file === canonicalPath;
-    const bundled = isBundled(entry);
-    if (!isCanonical && !bundled && entry.manifest.observers?.length) {
-      throw new Error(
-        `Library manifest ${entry.file} declares observers, but external library observers are not executable; remove observers or use an explicit task action manifest.`
-      );
-    }
-    const sourceName = bundled ? "metamask" : entry.source.name ?? path.basename(entry.source.root);
-    const tier = bundled ? "canonical" : sourceName === "personal" ? "personal" : "team";
-    const implementationRoot = path.join(entry.source.root, "actions");
-    const sourceInfo = {
-      name: sourceName,
-      tier,
-      manifestPath: entry.file,
-      implementationRoot,
-      trust: entry.source.provenance?.trust ?? (bundled ? "trusted" : "unknown")
-    };
-    for (const [name, action] of Object.entries(actionsOf(entry.manifest))) {
-      if (official.has(name)) {
-        if (!isCanonical && !bundled) {
-          throw new Error(
-            `Library action ${name} from ${entry.file} conflicts with an official action; team libraries may declare namespaced custom actions only.`
-          );
-        }
-        continue;
-      }
-      if (custom.has(name)) {
-        const existing = actionSources.get(name);
-        if (existing && existing.name !== sourceName) {
-          existing.shadows = [...existing.shadows ?? [], sourceName];
-        }
-        continue;
-      }
-      custom.add(name);
-      mergedActions[name] = action;
-      actionSources.set(name, { ...sourceInfo });
+const OFFICIAL = new Set(OFFICIAL_RECIPE_ACTIONS);
+function officialActions({ manifest, actionSources }, listFirst) {
+  const names = Object.keys(manifest.actions);
+  for (const name of names) {
+    const source = actionSources.get(name);
+    if (OFFICIAL.has(name) && source) {
+      actionSources.set(name, { name: "official", tier: "official", manifestPath: source.manifestPath });
     }
   }
+  if (!listFirst) return { manifest, actionSources };
+  const ordered = [...names.filter((name) => OFFICIAL.has(name)), ...names.filter((name) => !OFFICIAL.has(name))];
   return {
-    manifest: {
-      $schema: canonical.manifest.$schema,
-      actions: mergedActions,
-      ...observers ? { observers } : {}
-    },
+    manifest: { ...manifest, actions: Object.fromEntries(ordered.map((name) => [name, manifest.actions[name]])) },
     actionSources
   };
 }
-function actionsOf(manifest) {
-  return manifest.actions;
-}
-async function describeManifestSources(manifest, customSource) {
-  const official = new Set(OFFICIAL_RECIPE_ACTIONS);
-  const sources = /* @__PURE__ */ new Map();
-  for (const name of Object.keys(actionsOf(manifest))) {
-    if (official.has(name)) {
-      sources.set(name, {
-        name: "official",
-        tier: "official",
-        manifestPath: customSource.manifestPath
-      });
-      continue;
-    }
-    sources.set(name, { ...customSource });
-  }
-  return sources;
-}
-function defaultImplementationRoot(selectedManifestPath) {
-  const manifestDirectory = path.dirname(selectedManifestPath);
-  return path.basename(manifestDirectory) === "manifests" ? path.join(path.dirname(manifestDirectory), "actions") : path.join(manifestDirectory, "actions");
-}
 async function validateManifest(manifest) {
   const { validateRecipeActionManifestDocument } = await importRecipeProtocol();
   const result = validateRecipeActionManifestDocument(manifest);
@@ -188,6 +71,7 @@ function asActionManifest(value) {
 }
 export {
   ActionManifestError,
+  BUNDLED_LIBRARY,
   loadActionManifest,
   loadMetaMaskCoreActionManifest,
   loadMetaMaskExtensionActionManifest,

package/dist/paths.js

@@ -1,8 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { recipeRuntimeDir, recipeRuntimePath } from "@farmslot/recipe-cli/harness";
-import { adapterRegistry } from "./adapters/registry.js";
+import { assertAdapter, recipeRuntimeDir, recipeRuntimePath } from "@farmslot/recipe-cli/harness";
 const runnerDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 function walletFixturePath(projectRoot) {
   return recipeRuntimePath(projectRoot, "wallet-fixture.json");
@@ -67,16 +66,6 @@ function holdsSlotPool(candidate) {
     }
   });
 }
-function assertAdapter(adapter) {
-  const ids = adapterRegistry.list();
-  if (ids.length === 0) {
-    throw new Error("internal: no adapters are registered yet; import src/adapters/surface.ts before validating an adapter");
-  }
-  if (typeof adapter !== "string" || !adapterRegistry.has(adapter)) {
-    const choices = ids.length > 1 ? `${ids.slice(0, -1).join(", ")}, or ${ids.at(-1)}` : ids.join("");
-    throw new Error(`Adapter must be ${choices}.`);
-  }
-}
 function manifestPath(adapter) {
   assertAdapter(adapter);
   return path.join(runnerDir, "library/manifests", `${adapter}.action-manifest.json`);
@@ -156,7 +145,6 @@ function isMissingPackageError(error, packageName) {
 }
 export {
   LIBRARY_ACTION_NAMESPACE,
-  assertAdapter,
   extensionIdPath,
   harnessSlotPoolDir,
   importMetaMaskNativeUiProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.92.29",
+  "version": "0.92.31",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -22,13 +22,13 @@
   },
   "dependencies": {
     "@farmslot/adapter-node": "0.1.39",
-    "@farmslot/adapter-rn": "0.22.28",
+    "@farmslot/adapter-rn": "0.22.29",
     "@farmslot/adapter-sdk": "0.18.5",
     "@farmslot/adapter-web": "0.10.20",
     "@farmslot/agent-runtime": "0.29.5",
     "@farmslot/handoff": "0.3.2",
     "@farmslot/protocol": "0.55.0",
-    "@farmslot/recipe-cli": "0.23.6",
+    "@farmslot/recipe-cli": "0.23.8",
     "@farmslot/recipe-runner": "0.39.5",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",

package/dist/cli-commands.js

@@ -1,240 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { listRecipeFiles } from "./recipe-files.js";
-const SPEC = {
-  shim: [
-    { name: "sync", desc: "Copy fixture, write slot context, install harness", flags: ["--dry-run", "--no-install"] },
-    { name: "help", aliases: ["-h", "--help"], desc: "Show usage" }
-  ],
-  shared: [
-    { name: "help", desc: "Load version-matched recipe guidance (help review composes the review guide)", args: ["review"], flags: ["--json", "--adapter", "--target", "--domain"] },
-    { name: "review", desc: "Materialize a review checklist composed from the base review and a team library", args: ["checklist"], flags: ["--domain", "--since", "--base", "--out", "--adapter", "--target", "--json"] },
-    { name: "domain", desc: "Which team library owns the change (declared value, else owned-paths.json)", flags: ["--domain", "--base", "--adapter", "--target", "--json"] },
-    { name: "pr-body", desc: "Render the publishable PR body: pr-description.md plus the recipe and run sections built from artifacts", args: ["render", "<task-dir>"], flags: ["--command", "--out", "--json"] },
-    { name: "config", desc: "Per-engineer locations and optional advisor settings", args: ["list", "path", "get", "set", "unset"], flags: ["--json"] },
-    { name: "tutorial", desc: "Open the visual recipe tutorial", flags: ["--json", "--no-open"] },
-    { name: "setup-base", desc: "Bootstrap numbered product checkouts", flags: ["--dir", "--counts", "--only", "--dry-run", "--force", "--json", "--show-config", "--reset-config", "--skip-harness-update"] },
-    { name: "status", desc: "Home status + next commands", flags: ["--json", "--fast", "--watch", "--task"] },
-    { name: "ports", desc: "Slot ports and runtime paths", flags: ["--json"] },
-    { name: "up", desc: "Decide + run minimum work to reach ready", flags: ["--json", "--dry-run"] },
-    { name: "sync", desc: "Refresh harness + canonicalize wallet fixture", flags: ["--json"] },
-    { name: "pin", desc: "Copy this install into an immutable store for a task to run", flags: ["--json"] },
-    { name: "logs", aliases: ["tail"], desc: "Compact build events or full log", flags: ["--full", "-f", "--window", "--events", "--source", "--json"] },
-    { name: "debug", aliases: ["devtools", "inspect"], desc: "Open DevTools UI", flags: ["--json", "--no-open"] },
-    { name: "reload", desc: "Reload the connected app runtime", flags: ["--json"] },
-    { name: "fixtures", desc: "Manage the canonical wallet fixture (sync/set/reset/generate)", args: ["sync", "set", "reset", "generate"], flags: ["--fixture", "--out", "--adapter", "--target", "--device", "--json"] },
-    { name: "actions", desc: "List runnable recipe actions", flags: ["--json", "--matrix", "--categories", "--category", "--action", "--library"] },
-    { name: "doctor", desc: "Check harness/orchestration health", flags: ["--json", "--target", "--adapter", "--runtime-dir", "--expect-live", "--print-ready", "--cdp-port", "--device"] },
-    { name: "run", desc: "Execute a proof recipe (path or library name, e.g. run perps.smoke)", args: ["recipe.json|name"], flags: ["--list", "--device", "--plan", "--proof"] },
-    { name: "execution-template", desc: "Discover and materialize shared agent checklists", args: ["list", "materialize", "lint", "new"], flags: ["--dir", "--domain-dir", "--project-worker", "--project-name", "--package-templates", "--package-id", "--flow", "--run-mode", "--platform", "--domain", "--id", "--provenance", "--include-shadowed", "--no-include-shadowed", "--title", "--force", "--json"] },
-    { name: "recipe-quality", desc: "Build canonical quality or request optional recipe planning/advice", args: ["build", "plan", "advise", "advisor-status"], flags: ["--input", "--output", "--recipe", "--task", "--evidence", "--params", "--adapter", "--library", "--advisor", "--advisor-model", "--advisor-stages", "--json"] },
-    { name: "interactive", aliases: ["menu"], desc: "Interactive command menu" },
-    { name: "prepare", desc: "Run the readiness chain and write the readiness record", flags: ["--target", "--platform", "--mobile-platform", "--artifacts-dir", "--runtime-dir", "--json"] },
-    { name: "task", desc: "Create a task directory from a shared execution template", args: ["init"], flags: ["--flow", "--run-mode", "--platform", "--template", "--title", "--task-text", "--task-file", "--ticket", "--source-ref", "--surface", "--project", "--repo", "--attempt-id", "--var", "--task-dir-label", "--mode-preamble", "--addendum-file", "--mark-command", "--dir", "--domain-dir", "--project-worker", "--project-name", "--package-templates", "--package-id", "--domain", "--json"] },
-    { name: "runtime-status", desc: "Structured runtime status JSON", flags: ["--json", "--target", "--cdp-port", "--runtime-dir"] }
-  ],
-  extension: [
-    { name: "decision", aliases: ["decide"], desc: "Runtime decision (what next?)" },
-    { name: "update", aliases: ["sync-runtime"], desc: "Perform recommended runtime action" },
-    { name: "ready", aliases: ["ensure-ready"], desc: "Ensure one healthy extension home tab" },
-    { name: "watch", aliases: ["start-watch", "watcher"], desc: "Start/reuse webpack watcher", flags: ["--full", "-f"] },
-    { name: "stop", aliases: ["stop-watch", "stop-watcher"], desc: "Stop this checkout watcher" },
-    { name: "rebuild", aliases: ["reset", "reopen", "browser", "launch", "full-launch", "runtime-launch", "build", "build:once", "build-once", "refresh-once"], desc: "Clean webpack + browser launch", flags: ["--json", "--dry-run", "--full"] },
-    { name: "sidepanel", desc: "Side panel helper", args: ["cycle", "open", "close", "toggle", "status"] },
-    { name: "prepare", flags: ["--target", "--cdp-port", "--runtime-dir", "--validate"] },
-    { name: "debug", args: ["page", "worker"], flags: ["--json", "--no-open"] },
-    { name: "reload", desc: "Reload the live Extension UI over CDP", flags: ["--json"] }
-  ],
-  mobile: [
-    { name: "ios", aliases: ["start"], desc: "Start Metro + launch iOS dev client" },
-    { name: "android", desc: "Start Metro + launch Android dev client" },
-    { name: "setup:ios", desc: "iOS launch + wallet fixture setup" },
-    { name: "setup:android", desc: "Android launch + wallet fixture setup" },
-    { name: "stop", desc: "Stop Metro for this slot" },
-    { name: "app-status", aliases: ["bridge-status"], desc: "Bridge/runtime status" },
-    { name: "route", aliases: ["get-route"], desc: "Current navigation route" },
-    { name: "navigate", desc: "Navigate by route name", args: ["RouteName"] },
-    { name: "back", aliases: ["go-back"], desc: "Navigate back" },
-    { name: "unlock", desc: "Unlock with fixture password", args: ["password"] },
-    { name: "setup-wallet", aliases: ["wallet-setup"], desc: "Apply wallet fixture", args: ["fixture.json"] },
-    { name: "accounts", aliases: ["list-accounts"], desc: "List accounts" },
-    { name: "select-account", aliases: ["switch-account"], desc: "Switch account", args: ["address"] },
-    { name: "screenshot", desc: "Capture simulator/device screenshot", args: ["path"] },
-    { name: "dev-menu", aliases: ["devmenu"], desc: "Open RN developer menu", flags: ["--json", "--no-open"] },
-    { name: "prepare", flags: ["--target", "--platform", "--preflight-mode", "--port", "--simulator", "--adb-serial", "--runtime-dir", "--wallet-setup", "--wallet-fixture"] },
-    { name: "debug", flags: ["--json", "--no-open", "--action"] },
-    { name: "reload", desc: "Reload the app without restarting Metro", flags: ["--json"] }
-  ]
-};
-const GLOBAL_FLAGS = ["--json", "--dry-run", "--full", "-f", "--help", "-h", "--no-open", "--no-color"];
-function mergeCommands(adapter) {
-  const byName = /* @__PURE__ */ new Map();
-  const add = (cmd) => {
-    const existing = byName.get(cmd.name);
-    if (!existing) {
-      byName.set(cmd.name, {
-        ...cmd,
-        aliases: [...cmd.aliases || []],
-        flags: [...cmd.flags || []],
-        args: [...cmd.args || []]
-      });
-      return;
-    }
-    existing.aliases = [.../* @__PURE__ */ new Set([...existing.aliases || [], ...cmd.aliases || []])];
-    existing.flags = [.../* @__PURE__ */ new Set([...existing.flags || [], ...cmd.flags || []])];
-    existing.args = [.../* @__PURE__ */ new Set([...existing.args || [], ...cmd.args || []])];
-    if (!existing.desc && cmd.desc) existing.desc = cmd.desc;
-  };
-  for (const cmd of SPEC.shared) add(cmd);
-  for (const cmd of SPEC[adapter] || []) add(cmd);
-  return [...byName.values()];
-}
-function commandTokens(adapter, { includeAliases = true } = {}) {
-  const tokens = /* @__PURE__ */ new Set();
-  for (const cmd of mergeCommands(adapter)) {
-    tokens.add(cmd.name);
-    if (includeAliases) for (const alias of cmd.aliases || []) tokens.add(alias);
-  }
-  return [...tokens].sort();
-}
-function shimCommandTokens() {
-  const tokens = /* @__PURE__ */ new Set();
-  for (const cmd of SPEC.shim) {
-    tokens.add(cmd.name);
-    for (const alias of cmd.aliases || []) tokens.add(alias);
-  }
-  return [...tokens].sort();
-}
-function lookupCommand(adapter, token) {
-  for (const cmd of mergeCommands(adapter)) {
-    if (cmd.name === token) return cmd;
-    if ((cmd.aliases || []).includes(token)) return cmd;
-  }
-  for (const cmd of SPEC.shim) {
-    if (cmd.name === token) return cmd;
-    if ((cmd.aliases || []).includes(token)) return cmd;
-  }
-  return null;
-}
-function flagsForPosition(adapter, commandToken) {
-  const cmd = lookupCommand(adapter, commandToken);
-  const flags = new Set(GLOBAL_FLAGS);
-  if (cmd) for (const flag of cmd.flags || []) flags.add(flag);
-  return [...flags].sort();
-}
-function argsForPosition(adapter, commandToken, argIndex) {
-  const cmd = lookupCommand(adapter, commandToken);
-  if (!cmd?.args?.length) return [];
-  const value = cmd.args[Math.max(0, argIndex)];
-  return value ? [value] : cmd.args;
-}
-const RUN_RECIPE_DIRS = [
-  (adapter, root) => path.join(root, "temp/recipe/harness", adapter, "runner/recipes"),
-  (adapter, root) => path.join(root, "temp/agentic/recipe-harness", adapter, "runner/recipes")
-];
-function listRunRecipes(adapter, root, cwd = process.cwd()) {
-  const byBase = /* @__PURE__ */ new Map();
-  for (const resolveDir of RUN_RECIPE_DIRS) {
-    const dir = resolveDir(adapter, root);
-    if (!fs.existsSync(dir)) continue;
-    for (const rel of listRecipeFiles(dir)) {
-      if (byBase.has(rel)) continue;
-      byBase.set(rel, path.join(dir, rel));
-    }
-  }
-  return [...byBase.values()].map((abs) => path.relative(cwd, abs)).sort();
-}
-function usage() {
-  process.stderr.write(`Usage:
-  cli-commands dump --adapter extension|mobile|shim [--aliases]
-  cli-commands describe --adapter extension|mobile|shim
-  cli-commands flags --adapter <adapter> --command <name>
-  cli-commands args --adapter <adapter> --command <name> [--index <n>]
-  cli-commands run-recipes --adapter extension|mobile --root <repo> [--cwd <dir>]
-  cli-commands global-flags
-`);
-}
-async function main() {
-  const { parseArgs: parseArgsUtil } = await import("node:util");
-  const { values, positionals } = parseArgsUtil({
-    allowPositionals: true,
-    args: process.argv.slice(2),
-    options: {
-      adapter: { type: "string" },
-      command: { type: "string" },
-      aliases: { type: "boolean", default: true },
-      index: { type: "string", default: "0" },
-      root: { type: "string" },
-      cwd: { type: "string" }
-    }
-  });
-  const command = positionals[0];
-  if (!command || command === "--help" || command === "-h") {
-    usage();
-    process.exit(command ? 0 : 2);
-  }
-  if (command === "global-flags") {
-    process.stdout.write(`${GLOBAL_FLAGS.join("\n")}
-`);
-    return;
-  }
-  const adapter = values.adapter;
-  if (!adapter && command !== "global-flags") {
-    usage();
-    process.exit(2);
-  }
-  if (command === "dump") {
-    process.stdout.write(`${commandTokens(adapter, { includeAliases: values.aliases }).join("\n")}
-`);
-    return;
-  }
-  if (command === "describe") {
-    const rows = adapter === "shim" ? SPEC.shim : mergeCommands(adapter);
-    for (const cmd of rows) {
-      const aliases = (cmd.aliases || []).join("|");
-      const label = aliases ? `${cmd.name}|${aliases}` : cmd.name;
-      process.stdout.write(`${label}	${cmd.desc || cmd.name}
-`);
-    }
-    return;
-  }
-  if (command === "flags") {
-    process.stdout.write(`${flagsForPosition(adapter, values.command || "").join("\n")}
-`);
-    return;
-  }
-  if (command === "args") {
-    const index = Number.parseInt(values.index, 10) || 0;
-    process.stdout.write(`${argsForPosition(adapter, values.command || "", index).join("\n")}
-`);
-    return;
-  }
-  if (command === "run-recipes") {
-    const root = values.root ? path.resolve(values.root) : process.cwd();
-    const cwd = values.cwd ? path.resolve(values.cwd) : process.cwd();
-    process.stdout.write(`${listRunRecipes(adapter, root, cwd).join("\n")}
-`);
-    return;
-  }
-  usage();
-  process.exit(2);
-}
-const _filename = fileURLToPath(import.meta.url);
-const isMain = process.argv[1] && path.resolve(process.argv[1]) === _filename;
-if (isMain) {
-  main().catch((error) => {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-    process.exit(1);
-  });
-}
-export {
-  SPEC,
-  argsForPosition,
-  commandTokens,
-  flagsForPosition,
-  listRunRecipes,
-  lookupCommand,
-  shimCommandTokens
-};

package/dist/commands/launch/quote.js

@@ -1,7 +0,0 @@
-function shellQuote(value) {
-  if (/^[A-Za-z0-9_./:@%+=,-]+$/u.test(value)) return value;
-  return `'${value.replace(/'/gu, `'"'"'`)}'`;
-}
-export {
-  shellQuote
-};

package/dist/progress.js

@@ -1,94 +0,0 @@
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { color } from "@farmslot/recipe-cli/harness";
-function shouldEmitJson(explicit) {
-  if (explicit) return true;
-  const env = process.env.RECIPE_PROGRESS_JSON;
-  return env === "1" || env === "true";
-}
-function emitProgress(event, { json = false } = {}) {
-  const payload = {
-    schemaVersion: 1,
-    type: "progress",
-    ts: (/* @__PURE__ */ new Date()).toISOString(),
-    ...event
-  };
-  if (json || shouldEmitJson(false)) {
-    process.stderr.write(`${JSON.stringify(payload)}
-`);
-    return;
-  }
-  const stream = process.stderr;
-  const prefix = color("label", "recipe", { stream });
-  if (payload.phase === "done") {
-    const statusStyle = payload.status === "pass" ? "ok" : "err";
-    const statusWord = payload.status === "pass" ? "done" : "failed";
-    const cmd2 = payload.command ? color("cmd", `${payload.command}`, { stream }) : "";
-    const elapsed2 = Number.isFinite(payload.elapsedMs) ? color("comment", ` (${Math.round(payload.elapsedMs / 1e3)}s)`, { stream }) : "";
-    process.stderr.write(`${prefix}: ${cmd2} ${color(statusStyle, statusWord, { stream })} ${payload.message || ""}${elapsed2}
-`);
-    return;
-  }
-  const cmd = payload.command ? `${color("cmd", payload.command, { stream })}: ` : "";
-  const phase = payload.phase ? `${color("accent", `[${payload.phase}]`, { stream })} ` : "";
-  const elapsed = Number.isFinite(payload.elapsedMs) ? color("comment", ` (${Math.round(payload.elapsedMs / 1e3)}s)`, { stream }) : "";
-  process.stderr.write(`${prefix}: ${cmd}${phase}${payload.message || ""}${elapsed}
-`);
-}
-function usage() {
-  console.error(`Usage:
-  progress emit --command <name> --phase <id> --message <text> [--elapsed-ms <n>] [--json]
-  progress done --command <name> --status pass|fail --message <text> [--elapsed-ms <n>] [--json]`);
-}
-async function main() {
-  const [command, ...rest] = process.argv.slice(2);
-  if (!command || command === "--help" || command === "-h") {
-    usage();
-    process.exit(command ? 0 : 2);
-  }
-  const { values } = parseArgs({
-    args: rest,
-    options: {
-      command: { type: "string" },
-      phase: { type: "string" },
-      message: { type: "string" },
-      status: { type: "string" },
-      "elapsed-ms": { type: "string" },
-      json: { type: "boolean", default: false }
-    },
-    allowPositionals: false
-  });
-  const elapsedMs = values["elapsed-ms"] ? Number.parseInt(values["elapsed-ms"], 10) : void 0;
-  const json = values.json || shouldEmitJson(false);
-  if (command === "emit") {
-    emitProgress({
-      command: values.command || "recipe",
-      phase: values.phase || "working",
-      message: values.message || "",
-      elapsedMs: Number.isFinite(elapsedMs) ? elapsedMs : void 0
-    }, { json });
-    return;
-  }
-  if (command === "done") {
-    emitProgress({
-      command: values.command || "recipe",
-      phase: "done",
-      status: values.status || "pass",
-      message: values.message || "",
-      elapsedMs: Number.isFinite(elapsedMs) ? elapsedMs : void 0
-    }, { json });
-    return;
-  }
-  usage();
-  process.exit(2);
-}
-const isMain = process.argv[1] && path.resolve(process.argv[1]) === path.resolve(import.meta.filename ?? "");
-if (isMain) {
-  main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  });
-}
-export {
-  emitProgress
-};

package/dist/recipe-files.js

@@ -1,14 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-function listRecipeFiles(root, base = "") {
-  const out = [];
-  for (const entry of fs.readdirSync(path.join(root, base), { withFileTypes: true })) {
-    const rel = path.join(base, entry.name);
-    if (entry.isDirectory()) out.push(...listRecipeFiles(root, rel));
-    else if (entry.isFile() && entry.name.endsWith(".recipe.json")) out.push(rel);
-  }
-  return out;
-}
-export {
-  listRecipeFiles
-};