@deeeed/metamask-harness 0.89.0 → 0.91.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## Unreleased
 
+## 0.91.0 - 2026-10-12
+
+- Support Extension `ui.navigate page=settings` through the visible account menu and verify the Settings page before returning.
+
+- Declare bounded `watch_logs.timeout_ms` for Core, Mobile, Extension and web-dapp, including Terminal inheritance. Use the supporting protocol 0.40.0 and runner 0.31.0 through coordinated runtime pins.
+
+### Changed
+
+- Breaking correction inherited from runner 0.31.0: run-scoped log observations require paths resolved before producers execute; output-derived paths must use `scope=file`. Nested output assertions and static JSON paths now receive complete preflight validation.
+
+### Fixed
+
+- Run the declared Oxlint script for changed-source checks and explicit fixes instead of skipping lint when ESLint is absent.
+
+- Mobile Perps position selectors now enforce long/short selection when the controller returns signed size without a side label. Core and Extension reuse the same side normalization while preserving their existing selection rules.
+
+## 0.90.0 - 2026-10-12
+
+- Use typed iOS simulator recording targets, retain original Android recording segments, and use the shared action-context snapshot API for Extension evidence.
+
+- Share compact log viewing and owned-window recovery with the project recipe CLI, preserving event counts and cancellation.
+
+- Preserve project doctor reports, setup advisories, explicit fixture repairs and wallet-aware health indicators through the shared provider host.
+
+### Changed
+
+- Pin the coordinated shared runtime releases: protocol 0.39.0, recipe-runner 0.30.0, adapter-sdk 0.9.0, agent-runtime 0.18.0, recipe-cli 0.14.1, adapter-node 0.1.13, adapter-rn 0.20.0 and adapter-web 0.7.0.
+- Preserve checkout status details, resolved project library revisions and owned collector cleanup for shared project lifecycle commands; keep readiness device selection read-only and refuse Metro-wide reload when multiple devices are connected and forward interruption to owned reload processes.
+- Collect opt-in rendered HUD observations around screenshot capture for live conformance.
+- Bind navigation-memory suite claims to explicit assertions on the measured bounds.
+
 ## 0.89.0 - 2026-10-11
 
 ### Added

package/adapters/mobile/reload-app.mjs

@@ -79,6 +79,16 @@ async function reload(port) {
       `No React Native debug target with a stable ID is connected to Metro on port ${numericPort}`,
     );
   }
+  const response = await fetch(`http://127.0.0.1:${numericPort}/json/list`, {
+    signal: AbortSignal.timeout(5000),
+  });
+  if (!response.ok) throw new Error(`Cannot inspect Metro clients on port ${numericPort}`);
+  const clients = rankRuntimeCandidates(await response.json());
+  const deviceIds = new Set(clients.map((client) => deviceIdFromUrl(client.webSocketDebuggerUrl)));
+  // Metro's message channel reloads every connected client, even when CDP is pinned.
+  if (deviceIds.size !== 1 || !deviceIds.has(deviceIdFromUrl(targetBefore.wsUrl))) {
+    throw new Error(`Metro reload needs one connected device on port ${numericPort}. Next: use a dedicated slot Metro or an explicit targeted app.lifecycle restart.`);
+  }
   const processBefore = readAndroidPid();
   if (androidSerial() && !processBefore) {
     throw new Error(`The Android app is not running on ${androidSerial()}`);

package/dist/adapters/extension/reload.js

@@ -1,7 +1,7 @@
-import { EXIT, spawnScript, usageOut } from "@farmslot/recipe-cli/harness";
+import { EXIT, spawnScriptStreaming, usageOut } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
 import { runnerDir } from "../../paths.js";
-function reloadExtension(target, json) {
+async function reloadExtension(target, json) {
   const adapter = "extension";
   if (!process.env.CDP_PORT) {
     return usageOut(
@@ -16,7 +16,7 @@ function reloadExtension(target, json) {
   if (process.env.WATCHER_PORT) {
     args.push("--watcher-port", process.env.WATCHER_PORT);
   }
-  const result = spawnScript(script, args, target, json);
+  const result = await spawnScriptStreaming(script, args, target, { forward: json ? "none" : "stderr" });
   if (json) {
     console.log(
       JSON.stringify(

package/dist/adapters/extension/run.js

@@ -159,12 +159,7 @@ async function ensureExtensionProofRuntime(target, heal, state, json, deps = {})
   return null;
 }
 const extensionRecording = {
-  target: (context) => resolveExtensionRecordingTarget(context),
-  framed: {
-    browserPid: (projectRoot, artifactsDir, cdpPort) => resolveExtensionBrowserPid(projectRoot, artifactsDir, cdpPort),
-    // cdp.mjs snapshots the framed recording of this pid.
-    activePidEnv: "METAMASK_RECIPE_EXTENSION_ACTIVE_RECORDING_PID"
-  }
+  target: (context) => resolveExtensionRecordingTarget(context)
 };
 async function resolveExtensionRecordingTarget(context) {
   const pid = resolveExtensionBrowserPid(

package/dist/adapters/mobile/android-screenrecord.js

@@ -173,38 +173,38 @@ async function startRecording(serial, request, adb, options) {
         }
         if (recorded.length === 0) throw recordingFailure("RECORDING_FAILED", `Android recording output is empty: ${request.outputPath}`);
         const startedAtUnixMs = recorded[0].startedAtUnixMs;
-        const stoppedAtUnixMs = recorded.at(-1).stoppedAtUnixMs;
         const placed = recorded.map((segment) => ({ ...segment, offsetMs: segment.startedAtUnixMs - startedAtUnixMs }));
-        joinSegments(placed, request.outputPath);
         const timingEvidencePath = `${path.basename(request.outputPath)}.segments.json`;
-        fs.writeFileSync(
-          path.join(stagingDir, timingEvidencePath),
-          `${JSON.stringify({
-            recorder: "adb-screenrecord",
-            serial,
-            segments: placed.map((segment) => ({
-              offsetMs: segment.offsetMs,
-              startedAtUnixMs: segment.startedAtUnixMs,
-              stoppedAtUnixMs: segment.stoppedAtUnixMs,
-              bytes: segment.bytes
-            }))
-          })}
-`
-        );
-        const timing = await optionalVideoTiming(request.outputPath, { startedAtUnixMs, stoppedAtUnixMs });
+        fs.writeFileSync(path.join(stagingDir, timingEvidencePath), `${JSON.stringify({
+          recorder: "adb-screenrecord",
+          serial,
+          segments: placed.map(({ offsetMs, startedAtUnixMs: startedAtUnixMs2, stoppedAtUnixMs, bytes }) => ({
+            offsetMs,
+            startedAtUnixMs: startedAtUnixMs2,
+            stoppedAtUnixMs,
+            bytes
+          }))
+        })}
+`);
         const recorder = { name: "adb-screenrecord", platform: "android", target: { selector: "adb-serial", value: serial } };
-        return {
-          ...timing.timing ? { timing: { ...timing.timing, clock: { ...timing.timing.clock, latestZeroUnixMs: latestVideoZero(timing.timing, placed) } } } : timing,
+        const originals = await Promise.all(recorded.map(async (segment, index) => ({
+          path: path.basename(segment.localPath),
+          ...index > 0 ? { gapBefore: true } : {},
+          ...await optionalVideoTiming(segment.localPath, {
+            startedAtUnixMs: segment.startedAtUnixMs,
+            stoppedAtUnixMs: segment.stoppedAtUnixMs
+          }),
           timingEvidencePath,
-          recorder,
-          // The runner keeps the files finished before the failure and fails the run as CAPTURE_INTERRUPTED.
-          ...interruption ? {
-            interruption: {
-              frames: timing.timing?.framesMs.length ?? 0,
-              mediaTimeMs: timing.timing?.framesMs.at(-1) ?? 0,
-              cause: interruption
-            }
-          } : {}
+          recorder
+        })));
+        for (const segment of recorded) localFiles.delete(segment.localPath);
+        return {
+          segments: originals,
+          ...interruption ? { interruption: {
+            frames: originals.reduce((sum, segment) => sum + (segment.timing?.framesMs.length ?? 0), 0),
+            mediaTimeMs: placed.at(-1).offsetMs + (originals.at(-1).timing?.framesMs.at(-1) ?? 0),
+            cause: interruption
+          } } : {}
         };
       } finally {
         abandon();
@@ -213,36 +213,6 @@ async function startRecording(serial, request, adb, options) {
     }
   };
 }
-function latestVideoZero(timing, segments) {
-  return segments.reduce((latest, segment, index) => {
-    const to = segments[index + 1]?.offsetMs ?? Infinity;
-    const last = timing.framesMs.filter((time) => time >= segment.offsetMs && time < to).at(-1);
-    return last === void 0 ? latest : Math.max(latest, segment.stoppedAtUnixMs - last);
-  }, timing.clock.latestZeroUnixMs);
-}
-function joinSegments(segments, outputPath) {
-  if (segments.length === 1) {
-    fs.renameSync(segments[0].localPath, outputPath);
-    return;
-  }
-  const listPath = `${outputPath}.segments.txt`;
-  const list = segments.map((segment, index) => {
-    const entry = `file '${segment.localPath.replaceAll("'", "'\\''")}'`;
-    const next = segments[index + 1];
-    return next ? `${entry}
-duration ${((next.offsetMs - segment.offsetMs) / 1e3).toFixed(3)}` : entry;
-  });
-  fs.writeFileSync(listPath, `${list.join("\n")}
-`);
-  try {
-    const join = spawnSync(ffmpegPath(), ["-v", "error", "-y", "-f", "concat", "-safe", "0", "-i", listPath, "-c", "copy", outputPath], {
-      encoding: "utf8"
-    });
-    if (join.status !== 0) throw new Error(`Could not join Android recording segments: ${failure(join)}`);
-  } finally {
-    fs.rmSync(listPath, { force: true });
-  }
-}
 function ffmpegPath() {
   return process.env.FFMPEG_PATH || "ffmpeg";
 }

package/dist/adapters/mobile/devices.js

@@ -12,12 +12,13 @@ const mobileDevices = {
   // adapter-sdk's live view names the app's feature-flag overrides `featureFlags`.
   async live(target, view) {
     const live = await mobileDeviceLiveView(target, view);
-    return { ...live, featureFlags: live.featureFlagOverrides };
+    return { ...live, featureFlags: live.featureFlagOverrides, statusFields: live.androidPortHints.length ? { androidPortHints: live.androidPortHints } : {} };
   },
   renderList: renderMobileDeviceList,
   renderAdditional: renderAdditionalReachableDevices,
   renderLive: renderMobileLiveBlock,
   renderPortHints: renderAndroidPortHints,
+  renderHints: (live, paint) => renderAndroidPortHints(live.androidPortHints, paint),
   nextForLive
 };
 export {

package/dist/adapters/mobile/reload.js

@@ -1,12 +1,12 @@
-import { EXIT, spawnScript } from "@farmslot/recipe-cli/harness";
+import { EXIT, spawnScriptStreaming } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
 import { runnerDir } from "../../paths.js";
-function reloadMobile(target, json) {
+async function reloadMobile(target, json) {
   const script = path.join(runnerDir, "adapters/mobile/reload-app.mjs");
   const args = [];
   if (process.env.WATCHER_PORT) args.push("--port", process.env.WATCHER_PORT);
   if (json) args.push("--json");
-  const result = spawnScript(process.execPath, [script, ...args], target, json);
+  const result = await spawnScriptStreaming(process.execPath, [script, ...args], target, { forward: json ? "none" : "stderr" });
   if (json) process.stdout.write(result.output);
   return result.status === 0 ? EXIT.ok : EXIT.runtime;
 }

package/dist/adapters/mobile/run.js

@@ -1,7 +1,6 @@
 import { EXIT, isRecord } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
-import { IOS_SIMULATOR_RECORDING_TARGET_PREFIX } from "@farmslot/adapter-rn";
 import { devicePlatformFromEnv } from "../performance/device-platform.js";
 import {
   resolveAndroidDeviceSerial,
@@ -171,8 +170,8 @@ async function resolveMobileRecordingTarget(context) {
     );
   }
   return {
-    kind: "window-id",
-    windowId: `${IOS_SIMULATOR_RECORDING_TARGET_PREFIX}${simulator}`
+    kind: "simulator",
+    device: simulator
   };
 }
 const mobileDiagnostics = {

package/dist/checkout-view.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { color, recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
+import { color, harnessContext, recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
 import { renderRuntimeContext, runtimeContextSummary } from "./doctor.js";
 import {
   configPath,
@@ -12,11 +12,18 @@ const NO_LIBRARIES = "none registered. Learn how: docs/RECIPES.md, or run: mm-ha
 const FIXTURE_REPORT = path.join("prepare", "fixtures.json");
 function collectCheckoutView(target, adapter) {
   const declared = declaredLibraryPathEnv();
-  const libraries = discoverLibraries({
+  const bound = harnessContext()?.project?.libraries;
+  const sources = bound !== void 0 ? bound.map((library) => ({
+    name: library.name,
+    root: library.root,
+    source: "binding",
+    revision: library.identity.head ?? library.revision
+  })) : discoverLibraries({
     target,
     config: readConfig(configPath()),
     ...declared ? { env: { ...process.env, RECIPE_LIBRARY_PATH: declared.value } } : {}
-  }).map((library) => ({
+  });
+  const libraries = sources.map((library) => ({
     name: library.name,
     root: library.root,
     source: library.source,

package/dist/command-contract.js

@@ -42,6 +42,7 @@ const RECIPE_RUNTIME = {
   "--validation-runtime-dir": value(),
   "--launch-existing-dist": bool(),
   "--record-video": optionalValue(["full-run", "off"]),
+  "--recording-reason": value(),
   "--source-trust": value(["trusted", "untrusted", "unknown"]),
   "--source-kind": value(["bundled", "operator", "task", "recipe-file", "library", "custom-adapter"]),
   "--source-name": value(),
@@ -788,6 +789,7 @@ Common overrides:
   --json                             Machine-readable output
   --json-stream                      Line-flushed JSONL progress + terminal event
   --record-video=full-run            Record a video of the run
+  --recording-reason <text>          Explain an explicit recording opt-out
   --hud <show|hide>                  Recipe HUD: each node's intent drawn over the app on every adapter, headless included (default: show)
 
 Advanced integrations:

package/dist/commands/check.js

@@ -62,34 +62,32 @@ async function handleCheck(argv) {
   });
   const policyFailed = suppressionCheck.status === "fail";
   const fixes = [];
-  const eslintConfigArgs = resolveEslintConfigArgs(packageJson);
+  const usesOxlint = typeof packageJson?.scripts?.["lint:oxlint"] === "string";
+  const lintCommandArgs = usesOxlint ? ["lint:oxlint"] : resolveEslintConfigArgs(packageJson);
+  const lintCacheArgs = usesOxlint ? [] : ["--cache", "--cache-location", path.join(artifactsDir, "eslintcache")];
+  const lintCheck = {
+    id: usesOxlint ? "oxlint" : "eslint",
+    label: usesOxlint ? "Changed-file Oxlint" : "Changed-file ESLint",
+    target,
+    artifactsDir,
+    files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
+    command: usesOxlint ? "yarn" : executable(target, "eslint"),
+    args: [...lintCommandArgs, ...lintCacheArgs]
+  };
   if (fix && !policyFailed) {
     fixes.push(
       runToolCheck({
-        id: "eslint-fix",
-        label: "Changed-file ESLint fix",
-        target,
-        artifactsDir,
-        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
-        command: executable(target, "eslint"),
-        args: [...eslintConfigArgs, "--fix", "--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
+        ...lintCheck,
+        id: `${lintCheck.id}-fix`,
+        label: `${lintCheck.label} fix`,
+        args: [...lintCommandArgs, "--fix", ...lintCacheArgs]
       })
     );
     fixes.push(runFormatterFix({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
   }
   const checks = [suppressionCheck];
   if (!policyFailed) {
-    checks.push(
-      runToolCheck({
-        id: "eslint",
-        label: "Changed-file ESLint",
-        target,
-        artifactsDir,
-        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
-        command: executable(target, "eslint"),
-        args: [...eslintConfigArgs, "--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
-      })
-    );
+    checks.push(runToolCheck(lintCheck));
     checks.push(runFormatterCheck({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
     checks.push(
       ...runJestChecks({
@@ -115,7 +113,7 @@ async function handleCheck(argv) {
   }
   const status = [...fixes, ...checks].some((check) => check.status === "fail") ? "fail" : "pass";
   const exitCode = status === "pass" ? EXIT.ok : EXIT.validation;
-  const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === "eslint" && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
+  const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === lintCheck.id && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
   const failureUserAction = guidance[0] ?? `inspect ${path.join(artifactsDir, "validation-summary.json")}, fix the failing check, then retry: mm-harness check diff --target ${shellQuote(target)} --base ${shellQuote(baseRef)} --profile ${profile} --json`;
   const summary = {
     schemaVersion: 1,

package/dist/commands/device-target.js

@@ -129,7 +129,7 @@ function applyDeviceTargeting(command, adapter, options, opts) {
       }
       if (matched.platform === "android") setAndroidDeviceEnv(matched.id, matched.name);
       else setIosDeviceEnv(matched.id, matched.name);
-      persistExplicitDevicePin(targetPath(options), matched);
+      if (opts.persistPin !== false) persistExplicitDevicePin(targetPath(options), matched);
       return { ok: true };
     };
     const androidById = connected2.find((d) => d.platform === "android" && d.id === device);

package/dist/commands/doctor.js

@@ -2,7 +2,7 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { featureFlagReport } from "../feature-flags.js";
-import { adapterPluginChecks, color, acquireCheckoutLock, contextAdapter, resolveRuntimeContextPath, ensureOverlay, newHealState, recipeRunning, adapterDetectNext, checkoutBusyOut, EXIT, usageOut, actionManifestPathOption, applyRuntimeDirOption, optionFlag, optionString, shellQuote, targetPath } from "@farmslot/recipe-cli/harness";
+import { adapterPluginChecks, color, acquireCheckoutLock, contextAdapter, resolveRuntimeContextPath, ensureOverlay, newHealState, recipeRunning, adapterDetectNext, checkoutBusyOut, EXIT, usageOut, actionManifestPathOption, applyRuntimeDirOption, optionFlag, optionString, shellQuote, spawnScriptStreaming, doctorReady, renderDoctorRecorder, targetPath } from "@farmslot/recipe-cli/harness";
 import { collectCheckoutView, renderCheckoutView } from "../checkout-view.js";
 import { createDoctorReport, fixtureSummary, requiredDoctorCheckSummary } from "../doctor.js";
 import { assertAdapter, runnerDir } from "../paths.js";
@@ -110,7 +110,7 @@ async function handleDoctor({ options }) {
       } else if (runtimeProbeError2) {
         console.log(`runtime probe failed: ${runtimeProbeError2}`);
       }
-      if (recorder2) console.log(`recorder: ${recorder2.status} ${recorder2.message}`);
+      renderDoctorRecorder(recorder2);
       for (const action of nextActions) console.error(`  Next: ${action}`);
     }
     return status === "pass" ? 0 : 1;
@@ -230,7 +230,7 @@ async function handleDoctor({ options }) {
     } else if (runtimeProbeError) {
       console.log(`${out("err", "runtime probe failed:")} ${out("dim", runtimeProbeError)}`);
     }
-    if (recorder) console.log(`${out("label", "recorder:")} ${out(recorder.status === "pass" ? "ok" : "err", recorder.status)} ${recorder.message}`);
+    renderDoctorRecorder(recorder, out);
     console.log(renderCheckoutView(view));
     console.log(`${out("label", "feature flags:")} ${out(
       featureFlags.error || (featureFlags.overrideCount ?? 0) > 0 ? "warn" : "dim",
@@ -255,9 +255,7 @@ async function handleDoctor({ options }) {
   }
   return doctorResult.status === "pass" ? 0 : 1;
 }
-function doctorReady(runtime, recorder) {
-  return runtime?.decision === "ready" && recorder?.status !== "fail";
-}
+import { doctorReady as doctorReady2 } from "@farmslot/recipe-cli/harness";
 async function platformDoctorChecks(adapter, target) {
   try {
     return await getAdapterSurface(adapter).doctor?.(target) ?? [];
@@ -295,11 +293,7 @@ function doctorFixNextActions(failed, fixture, adapter, target, block) {
   const actions = [];
   const executable = process.env.MM_HARNESS_EXECUTABLE ? shellQuote(process.env.MM_HARNESS_EXECUTABLE) : "mm-harness";
   const scope = `--adapter ${adapter} --target ${shellQuote(target)}`;
-  if (failed.includes("wallet-fixture")) {
-    const force = fixture.status === "invalid" || fixture.status === "incomplete" ? " --force" : "";
-    actions.push(`1) ${executable} fixtures init --from <path>${force} ${scope}   # existing team/test fixture`);
-    actions.push(`2) ${executable} fixtures init --dev${force} ${scope}           # disposable public test wallet; never real funds`);
-  }
+  actions.push(...doctorFixtureNextActions(failed, fixture, scope, executable));
   if (failed.includes("runtime-context")) {
     actions.push(
       `inspect ${shellQuote(resolveRuntimeContextPath(target))}, then retry ${executable} doctor --fix ${scope}`
@@ -309,6 +303,15 @@ function doctorFixNextActions(failed, fixture, adapter, target, block) {
   if (block?.userAction && failed.includes(block.id)) actions.push(block.userAction);
   return actions;
 }
+function doctorFixtureNextActions(failed, fixture, scope, executable = process.env.MM_HARNESS_EXECUTABLE ? shellQuote(process.env.MM_HARNESS_EXECUTABLE) : "mm-harness") {
+  const actions = [];
+  if (failed.includes("wallet-fixture")) {
+    const force = fixture.status === "invalid" || fixture.status === "incomplete" ? " --force" : "";
+    actions.push(`1) ${executable} fixtures init --from <path>${force} ${scope}   # existing team/test fixture`);
+    actions.push(`2) ${executable} fixtures init --dev${force} ${scope}           # disposable public test wallet; never real funds`);
+  }
+  return actions;
+}
 function emitExpectLiveVerdict(adapter, target, runtime, verdict, recorder) {
   const out = (style, text) => color(style, text, { stream: process.stderr });
   const detail = runtime ? `${runtime.decision}${runtime.reasonCode ? ` (${runtime.reasonCode})` : ""}` : "runtime probe unavailable";
@@ -456,26 +459,27 @@ async function runDoctorFix(adapter, target, manifestValidation, json) {
   const ensured = await ensureOverlay(adapter, target, "infra-only", state, json);
   if (!ensured.ok) failed.push("overlay");
   else if (state.mutations.length > 0) fixed.push("overlay");
-  let fixture = fixtureSummary(target, adapter);
-  if (fixture.status !== "ready") {
-    const syncFixture = path.join(runnerDir, "adapters/shared/sync-wallet-fixture.sh");
-    try {
-      execFileSync("bash", [syncFixture, "--target", target], {
-        encoding: "utf8",
-        stdio: json ? ["ignore", "ignore", "ignore"] : "inherit",
-        timeout: 3e4
-      });
-    } catch {
-    }
-    fixture = fixtureSummary(target, adapter);
-    if (fixture.status === "ready") fixed.push("wallet-fixture");
-    else failed.push("wallet-fixture");
-  }
+  const fixture = await repairDoctorFixture(target, adapter, json);
+  fixed.push(...fixture.fixed);
+  failed.push(...fixture.failed);
   return { fixed, failed };
 }
+async function repairDoctorFixture(target, adapter, json) {
+  if (fixtureSummary(target, adapter).status === "ready") return { fixed: [], failed: [] };
+  const syncFixture = path.join(runnerDir, "adapters/shared/sync-wallet-fixture.sh");
+  await spawnScriptStreaming("bash", [syncFixture, "--target", target], target, {
+    forward: json ? "none" : "stderr",
+    timeoutMs: 3e4
+  });
+  return fixtureSummary(target, adapter).status === "ready" ? { fixed: ["wallet-fixture"], failed: [] } : { fixed: [], failed: ["wallet-fixture"] };
+}
 export {
   doctorFixNextActions,
-  doctorReady,
+  doctorFixtureNextActions,
+  doctorReady2 as doctorReady,
   handleDoctor,
+  renderSkillsView,
+  renderUpdateStatus,
+  repairDoctorFixture,
   skillsView
 };

package/dist/commands/logs.js

@@ -1,7 +1,7 @@
-import { adapterDetectNext, EXIT, flag, parseFlags, contextAdapter, spawnInherit, spawnScript, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
+import { adapterDetectNext, EXIT, flag, parseFlags, contextAdapter, spawnInherit, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
-import { runnerDir } from "../paths.js";
+import { createLogsOptions } from "../provider-logs.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 const LOGS_BOOLEANS = /* @__PURE__ */ new Set(["full", "json", "window"]);
 async function handleLogs(argv) {
@@ -66,27 +66,12 @@ async function handleLogs(argv) {
     );
   }
   if (flag(options, "window")) {
-    surface.resolveSlotPorts(target);
-    const port = process.env.WATCHER_PORT ?? process.env.METRO_PORT ?? "default";
-    const windowName = `${surface.devServer.label}-${port}`;
-    const devLog = logSources[0].path;
-    const leaf = path.join(runnerDir, "adapters/shared/open-log-window.sh");
-    const result = spawnScript(
-      leaf,
-      ["--window", windowName, "--log", devLog, "--runtime-dir", path.dirname(devLog)],
+    const result = await createLogsOptions(surface).window({
       target,
-      json
-    );
-    if (json) {
-      console.log(
-        JSON.stringify(
-          { schemaVersion: 1, command: "logs", action: "window", adapter, window: windowName, logFile: devLog, exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime },
-          null,
-          2
-        )
-      );
-    }
-    return result.status === 0 ? EXIT.ok : EXIT.runtime;
+      logFile: logSources[0].path
+    });
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "logs", action: "window", adapter, ...result }, null, 2));
+    return result.exitCode;
   }
   if (json) {
     console.log(JSON.stringify({ schemaVersion: 1, command: "logs", adapter, source, logFile, exitCode: EXIT.ok }, null, 2));
@@ -102,14 +87,12 @@ async function handleLogs(argv) {
   if (full) {
     return spawnInherit("tail", ["-n", "+1", "-F", logFile], target) === 0 ? EXIT.ok : EXIT.runtime;
   }
-  const logTui = path.join(runnerDir, "adapters/shared/log-tui.mjs");
-  const eventCount = process.env.RECIPE_LOG_EVENTS ?? "20";
-  const uiMode = process.env.RECIPE_LOG_UI_MODE ?? "compact";
-  return spawnInherit(
-    process.execPath,
-    [logTui, "tail", "--log", logFile, "--events", eventCount, "--follow", "--mode", uiMode],
-    target
-  ) === 0 ? EXIT.ok : EXIT.runtime;
+  return createLogsOptions(surface).compact({
+    target,
+    logFile,
+    events: process.env.RECIPE_LOG_EVENTS ?? "20",
+    mode: process.env.RECIPE_LOG_UI_MODE ?? "compact"
+  });
 }
 export {
   handleLogs