@deeeed/metamask-harness 0.17.0 → 0.17.2

package/dist/commands/update.js

@@ -1,4 +1,4 @@
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -6,7 +6,7 @@ import { runnerDir } from "../paths.js";
 import { EXIT, flag, parseFlags } from "./shared.js";
 const PACKAGE_NAME = "@deeeed/metamask-harness";
 const NUDGE_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-const NUDGE_FETCH_TIMEOUT_MS = 300;
+const NUDGE_FETCH_TIMEOUT_MS = 2e3;
 function currentVersion() {
   try {
     const pkg = JSON.parse(fs.readFileSync(path.join(runnerDir, "package.json"), "utf8"));
@@ -56,24 +56,6 @@ function fetchLatest(timeoutMs) {
   if (!latest) return { error: { kind: "unreachable", message: "npm returned no dist-tag for latest" } };
   return { latest };
 }
-async function fetchLatestAsync(timeoutMs) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const url = `https://registry.npmjs.org/-/package/${encodeURIComponent(PACKAGE_NAME)}/dist-tags`;
-    const res = await fetch(url, { signal: controller.signal });
-    if (!res.ok) return { error: { kind: "unreachable", message: `registry returned HTTP ${res.status}` } };
-    const data = await res.json();
-    const latest = data["latest"];
-    if (!latest) return { error: { kind: "unreachable", message: "npm registry returned no latest dist-tag" } };
-    return { latest };
-  } catch (err) {
-    const msg = err.name === "AbortError" ? `registry fetch timed out after ${timeoutMs}ms` : err.message;
-    return { error: { kind: "unreachable", message: msg } };
-  } finally {
-    clearTimeout(timer);
-  }
-}
 function teachFailure(json, current, code, message, userAction) {
   if (json) {
     console.log(
@@ -211,23 +193,28 @@ function nudgeDisabled() {
 function nudgeLine(current, latest) {
   return isNewer(latest, current) ? `mm-harness ${current} \u2192 ${latest} available \xB7 run: mm-harness update` : null;
 }
-async function maybeNudge(now = Date.now()) {
+function maybeNudge(now = Date.now()) {
   if (nudgeDisabled()) return;
   const file = cacheFile();
   const cache = readCache(file);
   const current = currentVersion();
-  let latest = cache?.latest ?? "";
   process.once("exit", () => {
-    const line = nudgeLine(current, latest);
+    const line = nudgeLine(current, cache?.latest ?? "");
     if (line) process.stderr.write(`${line}
 `);
   });
   if (!cache || now - cache.lastCheck >= NUDGE_INTERVAL_MS) {
-    writeCache(file, { lastCheck: now, latest });
-    const fetched = await fetchLatestAsync(NUDGE_FETCH_TIMEOUT_MS);
-    if (fetched.latest) {
-      latest = fetched.latest;
-      writeCache(file, { lastCheck: now, latest });
+    writeCache(file, { lastCheck: now, latest: cache?.latest ?? "" });
+    const worker = path.join(runnerDir, "adapters", "shared", "update-check-worker.mjs");
+    if (!fs.existsSync(worker)) return;
+    try {
+      const child = spawn(
+        process.execPath,
+        [worker, file, String(NUDGE_FETCH_TIMEOUT_MS)],
+        { detached: true, stdio: "ignore" }
+      );
+      child.unref();
+    } catch {
     }
   }
 }

package/dist/doctor.js

@@ -93,10 +93,7 @@ function fixtureFileSummary(file, adapter, reportedPath = file) {
 const RUNTIME_CONTEXT_FIELDS = [
   { key: "slotId", envVars: ["RECIPE_SLOT_ID"], envVar: "RECIPE_SLOT_ID", customize: "doctor --fix creates local identity; Farmslot may override", adapters: ["mobile", "extension", "core"] },
   { key: "extensionId", envVars: ["RECIPE_HARNESS_EXTENSION_ID"], envVar: "RECIPE_HARNESS_EXTENSION_ID", customize: "resolved from the built extension", adapters: ["extension"] },
-  { key: "cdpPort", envVars: ["RECIPE_CDP_PORT", "CDP_PORT"], envVar: "CDP_PORT", customize: "doctor --fix claims one; --cdp-port overrides", adapters: ["extension"] },
-  { key: "runtimeStart.approved", envVars: ["RECIPE_RUNTIME_START_APPROVED"], envVar: "RECIPE_RUNTIME_START_APPROVED", customize: "optional orchestrator-provided legacy live context", adapters: ["mobile", "extension"] },
-  { key: "runtimeStart.command", envVars: [], envVar: null, customize: "optional orchestrator-provided legacy live context", adapters: ["mobile", "extension"] },
-  { key: "runtimeStart.readyUrl", envVars: ["RECIPE_RUNTIME_READY_URL"], envVar: "RECIPE_RUNTIME_READY_URL", customize: "optional orchestrator-provided legacy live context", adapters: ["mobile", "extension"] }
+  { key: "cdpPort", envVars: ["RECIPE_CDP_PORT", "CDP_PORT"], envVar: "CDP_PORT", customize: "doctor --fix claims one; --cdp-port overrides", adapters: ["extension"] }
 ];
 function runtimeContextSummary(target, adapter) {
   const contextPath = resolveRuntimeContextPath(target);

package/dist/harness.js

@@ -4,13 +4,8 @@ import path from "node:path";
 import { resolveLeafInvoke, shellLeafMissing, missingShellLeafMessage } from "./leaf-invoke.js";
 import { resolveExtensionSlotPorts } from "./adapters/slot-ports.js";
 import { recipeHarnessPath, recipeRuntimeDir, runnerDir } from "./paths.js";
-import { prepareMobile } from "./adapters/mobile/prepare.js";
-const HARNESS_ACTIONS = ["install", "verify", "cleanup", "live"];
+const HARNESS_ACTIONS = ["install", "verify", "cleanup"];
 const ADAPTERS = ["mobile", "extension", "core"];
-function isValidAdapterAction(adapter, action) {
-  if (adapter === "core") return action === "install" || action === "verify" || action === "cleanup";
-  return true;
-}
 function harnessUsage() {
   console.error(`mm-harness \u2014 install and validate the MetaMask recipe runtime in a checkout.
 
@@ -167,7 +162,7 @@ function readRuntimeContextField(contextPath, field) {
   if (node === void 0 || node === null || node === "") return void 0;
   return String(node);
 }
-function applyExtensionRuntimeEnv(target, action, args) {
+function applyExtensionRuntimeEnv(target, args) {
   const contextPath = resolveRuntimeContextPath(target);
   const contextExists = fs.existsSync(contextPath);
   if (contextExists) {
@@ -180,19 +175,6 @@ function applyExtensionRuntimeEnv(target, action, args) {
       const extensionId = readRuntimeContextField(contextPath, "extensionId");
       if (extensionId) process.env.RECIPE_HARNESS_EXTENSION_ID = extensionId;
     }
-    if (process.env.RECIPE_RUNTIME_START_APPROVED === void 0) {
-      const approved = readRuntimeContextField(contextPath, "runtimeStart.approved");
-      if (approved === "true" || approved === "True" || approved === "1") process.env.RECIPE_RUNTIME_START_APPROVED = "1";
-      else if (approved === "false" || approved === "False" || approved === "0") process.env.RECIPE_RUNTIME_START_APPROVED = "0";
-    }
-    if (!process.env.RECIPE_RUNTIME_START_CMD) {
-      const command = readRuntimeContextField(contextPath, "runtimeStart.command");
-      if (command) process.env.RECIPE_RUNTIME_START_CMD = command;
-    }
-    if (!process.env.RECIPE_RUNTIME_READY_URL) {
-      const readyUrl = readRuntimeContextField(contextPath, "runtimeStart.readyUrl");
-      if (readyUrl) process.env.RECIPE_RUNTIME_READY_URL = readyUrl;
-    }
   } else {
     delete process.env.RECIPE_RUNTIME_CONTEXT;
   }
@@ -206,11 +188,6 @@ function applyExtensionRuntimeEnv(target, action, args) {
       result = [...result, "--cdp-port", cdpPort];
     }
   }
-  if (action === "live" && !hasArg(result, "--prepare-cmd")) {
-    if (process.env.RECIPE_RUNTIME_START_APPROVED === "1" && process.env.RECIPE_RUNTIME_START_CMD) {
-      result = [...result, "--prepare-cmd", process.env.RECIPE_RUNTIME_START_CMD];
-    }
-  }
   return result;
 }
 function resolveEntry(base, candidates, mode) {
@@ -287,82 +264,6 @@ Next: mm-harness install --platform core --target ${target}`
   );
   return { command, prefixArgs: [] };
 }
-async function handleMobileLive(target, forwardArgs, json, autoDetected) {
-  const platform = argValue(forwardArgs, "--platform") ?? "ios";
-  const watcherPortStr = argValue(forwardArgs, "--watcher-port") ?? process.env.WATCHER_PORT;
-  const watcherPort = watcherPortStr ? parseInt(watcherPortStr, 10) : void 0;
-  const start = Date.now();
-  if (!json) {
-    const detected = autoDetected ? ", auto-detected" : "";
-    console.error(`\u2192 live (mobile${detected}) \u2014 target: ${target}`);
-  }
-  const prepResult = await prepareMobile(target, { platform, json, watcherPort });
-  if (prepResult.status !== 0) {
-    const elapsed2 = ((Date.now() - start) / 1e3).toFixed(1);
-    if (json) {
-      console.log(
-        harnessSummary("live", "mobile", target, "fail", prepResult.status, autoDetected, {
-          code: "MOBILE_PREPARE_FAILED",
-          message: `mobile prepare failed (exit ${prepResult.status})`,
-          userAction: failureHint("mobile", "live")
-        })
-      );
-    } else {
-      console.error(
-        `\u2717 live mobile failed (exit ${prepResult.status}, ${elapsed2}s)
-  ${failureHint("mobile", "live")}`
-      );
-    }
-    return prepResult.status;
-  }
-  const installedVerify = path.join(recipeHarnessPath(target, "mobile"), "scripts", "verify.sh");
-  const verifySh = fs.existsSync(installedVerify) ? installedVerify : resolveEntry(runnerDir, ["adapters/mobile/verify.sh", "scripts/mobile/verify.sh"], "file");
-  const verifyArgs = hasArg(forwardArgs, "--no-auto-start") ? [...forwardArgs] : ["--no-auto-start", ...forwardArgs];
-  if (shellLeafMissing(verifySh)) {
-    const message = missingShellLeafMessage(verifySh);
-    if (json) {
-      console.log(
-        harnessSummary("live", "mobile", target, "fail", 1, autoDetected, {
-          code: "HARNESS_SPAWN_FAILED",
-          message,
-          userAction: failureHint("mobile", "live")
-        })
-      );
-    } else {
-      console.error(`\u2717 ${message}`);
-    }
-    return 1;
-  }
-  const { bin: verifyBin, args: verifySpawnArgs } = resolveLeafInvoke(verifySh, verifyArgs);
-  const result = spawnSync(verifyBin, verifySpawnArgs, {
-    stdio: json ? ["inherit", 2, "inherit"] : "inherit",
-    env: process.env
-  });
-  const elapsed = ((Date.now() - start) / 1e3).toFixed(1);
-  const exitCode = result.status ?? 1;
-  if (json) {
-    console.log(
-      harnessSummary(
-        "live",
-        "mobile",
-        target,
-        exitCode === 0 ? "pass" : "fail",
-        exitCode,
-        autoDetected,
-        exitCode === 0 ? void 0 : { code: "MOBILE_VERIFY_FAILED", message: `mobile live verify failed (exit ${exitCode})`, userAction: failureHint("mobile", "live") }
-      )
-    );
-  } else if (exitCode === 0) {
-    console.error(`\u2713 live mobile passed (${elapsed}s)
-  Next: ${successNext("mobile", "live", target)}`);
-  } else {
-    console.error(
-      `\u2717 live mobile failed (exit ${exitCode}, ${elapsed}s)
-  ${failureHint("mobile", "live")}`
-    );
-  }
-  return exitCode;
-}
 async function handleHarness(argv) {
   const action = argv[0];
   if (!action || action === "-h" || action === "--help") {
@@ -394,32 +295,13 @@ async function handleHarness(argv) {
     }
     return 2;
   }
-  if (!isValidAdapterAction(adapter, harnessAction)) {
-    if (json) {
-      console.log(
-        harnessSummary(harnessAction, adapter, target, "fail", 2, parsedAdapter === void 0, {
-          code: "UNSUPPORTED_ACTION",
-          message: `${harnessAction} is not supported for ${adapter} (core supports install, verify, cleanup).`,
-          userAction: "run mm-harness doctor to see which actions are supported for this adapter"
-        })
-      );
-    } else {
-      console.error(
-        `\u2717 ${harnessAction} is not supported for ${adapter} (core supports install, verify, cleanup).`
-      );
-    }
-    return 2;
-  }
   const autoDetected = parsedAdapter === void 0;
   let forwardArgs = hasArg(forward, "--target") ? [...forward] : ["--target", target, ...forward];
   if (harnessAction === "install" && hasArg(forward, "--runway")) {
     return handleRunwayInstall(adapter, target, forward, json);
   }
-  if (adapter === "extension" && (harnessAction === "live" || harnessAction === "verify")) {
-    forwardArgs = applyExtensionRuntimeEnv(target, harnessAction, forwardArgs);
-  }
-  if (adapter === "mobile" && harnessAction === "live") {
-    return handleMobileLive(target, forwardArgs, json, autoDetected);
+  if (adapter === "extension" && harnessAction === "verify") {
+    forwardArgs = applyExtensionRuntimeEnv(target, forwardArgs);
   }
   const dispatch = resolveHarnessDispatch(adapter, harnessAction, target);
   if ("error" in dispatch) {
@@ -587,7 +469,7 @@ function harnessSummary(action, adapter, target, status, exitCode, autoDetected,
     status,
     exitCode,
     // Error contract: every --json failure carries a stable machine code + human
-    // message (CLI-SPEC.md §5.1). userAction is included when present so callers
+    // message. userAction is included when present so callers
     // can surface the reachable escape without parsing the human message.
     ...status === "fail" && error ? { error } : {},
     ...status === "pass" && adapter ? { next: successNext(adapter, action, target) } : {}

package/dist/live-adapter-contract.js

@@ -46,29 +46,16 @@ function candidatePaths(platform, action) {
       }
       pushDomainDispatcherFiles(files, root, platform, family);
     }
-    for (const candidateStem of stems) {
-      pushFlatCandidateFiles(files, root, platform, candidateStem);
-    }
   }
   return files;
 }
 function pushCandidateFiles(files, root, platform, family, stem) {
-  for (const extension of ["mjs", "js", "sh"]) {
-    files.push(path.join(root, platform, family, `${stem}.${extension}`));
-    files.push(path.join(root, "shared", family, `${stem}.${extension}`));
-  }
+  files.push(path.join(root, platform, family, `${stem}.mjs`));
+  files.push(path.join(root, "shared", family, `${stem}.mjs`));
 }
 function pushDomainDispatcherFiles(files, root, platform, family) {
-  for (const extension of ["mjs", "js", "sh"]) {
-    files.push(path.join(root, platform, family, `${family}.${extension}`));
-    files.push(path.join(root, "shared", family, `${family}.${extension}`));
-  }
-}
-function pushFlatCandidateFiles(files, root, platform, stem) {
-  for (const extension of ["mjs", "js", "sh"]) {
-    files.push(path.join(root, platform, `${stem}.${extension}`));
-    files.push(path.join(root, "shared", `${stem}.${extension}`));
-  }
+  files.push(path.join(root, platform, family, `${family}.mjs`));
+  files.push(path.join(root, "shared", family, `${family}.mjs`));
 }
 async function firstExecutablePath(paths) {
   for (const file of paths) {
@@ -120,9 +107,8 @@ function runProcess(command, args, options) {
   });
 }
 function commandFor(file, projectRoot, platform) {
-  if (file.endsWith(".sh")) return { command: "bash", args: [file] };
   const needsTsx = platform === "core" || importsSourceTypescript(file);
-  if (!needsTsx && (file.endsWith(".mjs") || file.endsWith(".js"))) {
+  if (!needsTsx) {
     return { command: process.execPath, args: [file] };
   }
   const tsxBin = resolveTsxBin(projectRoot);
@@ -165,7 +151,7 @@ function importsSourceTypescriptFrom(file, visited) {
     const specifier = match[1] ?? "";
     if (specifier.endsWith(".ts")) return true;
     if (!specifier.startsWith(".")) continue;
-    if (!specifier.endsWith(".mjs") && !specifier.endsWith(".js")) continue;
+    if (!specifier.endsWith(".mjs")) continue;
     if (importsSourceTypescriptFrom(path.resolve(path.dirname(absolute), specifier), visited)) {
       return true;
     }

package/dist/mm-harness-cli.js

@@ -424,8 +424,8 @@ Example:
   --full                             Raw log tail (default = compact) (env: RECIPE_LOG_UI)
   --window                           (Re)open the read-only tmux tail window for the resolved dev-server port (leaves the process untouched)
   --events <n>                       Compact event count (default 10) (env: RECIPE_LOG_EVENTS)
-  --source <label>                   Log source per adapter \u2014 mobile: metro|app (default metro);
-                                     extension: webpack|watcher|rebuild|app (default webpack).
+  --source <label>                   Log source per adapter \u2014 mobile: metro|app;
+                                     extension: extension|dapp|webpack|watcher|rebuild.
                                      Core is headless (teaching error).
   --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
@@ -541,21 +541,6 @@ function assertPublicContractMatchesSurface() {
   }
 }
 assertPublicContractMatchesSurface();
-const RETIRED = [
-  {
-    name: "live",
-    message: `mm-harness live is retired (exit 2).
-
-Replacement: mm-harness launch --verify (install overlay \u2192 launch \u2192 CDP/bridge poll \u2192 smoke verify).`
-  },
-  {
-    name: "manifest",
-    message: `mm-harness manifest is retired (exit 2).
-
-Replacement: mm-harness actions --raw   (works now \u2014 dumps the raw action registry JSON,
-identical to the old \`manifest --json\`). Manifest validation moved into doctor / run --plan.`
-  }
-];
 const HELP_GROUPS = [
   {
     title: "DAILY LOOP",
@@ -658,7 +643,7 @@ function groupedHelp() {
   lines.push("DEV/PROD \u2014 the global npm install is prod; set MM_HARNESS_BIN to a dev checkout to override:");
   lines.push("  MM_HARNESS_BIN=/path/to/checkout/bin/mm-harness   # unset = the installed/global bin");
   lines.push("");
-  lines.push("See docs/MENTAL-MODEL.md (overview) and docs/CLI-SPEC.md (full contract).");
+  lines.push("See README.md for the workflow and docs/CHEATSHEET.md for examples.");
   return `${lines.join("\n")}
 `;
 }
@@ -670,11 +655,6 @@ async function delegate(argv) {
     return error !== null && typeof error === "object" && "exitCode" in error && typeof error.exitCode === "number" ? error.exitCode : 1;
   }
 }
-function translateActionsRaw(argv) {
-  const rest = argv.slice(1).filter((arg) => arg !== "--raw");
-  const withJson = rest.includes("--json") ? rest : [...rest, "--json"];
-  return ["manifest", ...withJson];
-}
 const pkgVersion = (() => {
   try {
     return JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8")).version ?? "unknown";
@@ -692,8 +672,7 @@ for (const command of REAL) {
     if (command.name === "update") {
       process.exit(await handleUpdate(rawArgv.slice(1)));
     }
-    const argv = command.name === "actions" && rawArgv.includes("--raw") ? translateActionsRaw(rawArgv) : rawArgv;
-    process.exit(await withCommandJournal(command.name, rawArgv, () => delegate(argv)));
+    process.exit(await withCommandJournal(command.name, rawArgv, () => delegate(rawArgv)));
   });
 }
 const HIDDEN = [
@@ -715,24 +694,9 @@ program.command("completions").description("Install/print bundled shell tab-comp
   const result = spawnSync("bash", [script, ...rawArgv.slice(1)], { stdio: "inherit" });
   process.exit(result.status ?? 1);
 });
-for (const retired of RETIRED) {
-  program.command(retired.name).description(`${retired.name} is retired (see teaching error)`).allowUnknownOption().helpOption(false).argument("[args...]").action(async () => {
-    if (retired.name === "live") {
-      const adapterIdx = rawArgv.indexOf("--adapter");
-      const aliasIdx = rawArgv.indexOf("-a");
-      const adapterVal = adapterIdx !== -1 ? rawArgv[adapterIdx + 1] : aliasIdx !== -1 ? rawArgv[aliasIdx + 1] : void 0;
-      if (adapterVal === "mobile" || adapterVal === "android") {
-        process.exit(await delegate(rawArgv));
-        return;
-      }
-    }
-    console.error(retired.message);
-    process.exit(2);
-  });
-}
 const NUDGE_SKIP = ["update", "completions", "completion-candidates"];
 if (rawArgv.length > 0 && !NUDGE_SKIP.includes(rawArgv[0])) {
-  setImmediate(() => void maybeNudge());
+  maybeNudge();
 }
 function hasPassthroughHelp(argv) {
   const divider = argv.indexOf("--");
@@ -794,8 +758,7 @@ if (rawArgv.length === 0) {
 }
 const preflightBypass = /* @__PURE__ */ new Set([
   ...HIDDEN,
-  "completions",
-  ...RETIRED.map((command) => command.name)
+  "completions"
 ]);
 if (!preflightBypass.has(rawArgv[0] ?? "")) {
   const usageError = validatePublicInvocation(rawArgv, PUBLIC_COMMAND_EXAMPLES);

package/dist/paths.js

@@ -47,10 +47,7 @@ function recipeWatchLogCandidates() {
 }
 function resolveLocalProtocolRoot() {
   const candidates = [
-    // Orchestrator-neutral name is primary; FARMSLOT_ROOT stays a back-compat alias
-    // for one release (the installer injects METAMASK_RUNNER_PROTOCOL_ROOT).
     process.env.METAMASK_RUNNER_PROTOCOL_ROOT,
-    process.env.FARMSLOT_ROOT,
     readConfiguredProtocolRoot(),
     findProtocolRoot(runnerDir),
     findProtocolRoot(process.cwd())
@@ -62,7 +59,7 @@ function resolveRequiredLocalProtocolRoot(reason) {
   const root = resolveLocalProtocolRoot();
   if (!root) {
     throw new Error(
-      `${reason} requires a local protocol/runtime checkout. Set METAMASK_RUNNER_PROTOCOL_ROOT (or the legacy FARMSLOT_ROOT), or create .farmslot-root for this dev-only path.`
+      `${reason} requires a local protocol/runtime checkout. Set METAMASK_RUNNER_PROTOCOL_ROOT or create .farmslot-root for this dev-only path.`
     );
   }
   return root;
@@ -152,7 +149,7 @@ async function importProtocolPackage(packageName, localSourceEntry) {
   const root = resolveLocalProtocolRoot();
   if (!root) {
     throw new Error(
-      `${packageName} is not installed. Install @farmslot/* packages normally, or set FARMSLOT_ROOT/use npm run dev:link-farmslot while co-developing protocol packages locally.`
+      `${packageName} is not installed. Install @farmslot/* packages normally, or set METAMASK_RUNNER_PROTOCOL_ROOT/use npm run dev:link-farmslot while co-developing protocol packages locally.`
     );
   }
   return import(pathToFileURL(path.join(root, localSourceEntry)).href);

package/dist/run-diagnostics.js

@@ -1,26 +1,54 @@
 import fs from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { spawn, spawnSync } from "node:child_process";
+import { spawnSync } from "node:child_process";
 import { getAdapterSurface } from "./adapters/surface.js";
 import { runnerDir } from "./paths.js";
+import { ensureExtensionConsoleCapture } from "./adapters/extension/console-capture.js";
 const MAX_CAPTURE_BYTES = 512 * 1024;
 const MAX_FINDINGS = 20;
 const MAX_PREVIEW_CHARS = 320;
+function readRunDiagnosticsDocument(diagnosticsPath) {
+  if (typeof diagnosticsPath !== "string" || diagnosticsPath.length === 0) return null;
+  try {
+    const document = JSON.parse(fs.readFileSync(diagnosticsPath, "utf8"));
+    return isRunDiagnosticsDocument(document) ? document : null;
+  } catch {
+    return null;
+  }
+}
+function formatRunDiagnosticsForHuman(diagnostics, adapter) {
+  if (!diagnostics) {
+    return [adapter === "core" ? "N/A \u2014 Core is headless and has no application log source." : "UNAVAILABLE \u2014 application diagnostics could not be collected for this run."];
+  }
+  const status = diagnostics.status === "clean" ? "CLEAN" : diagnostics.status === "review" ? "REVIEW" : "UNAVAILABLE";
+  const lines = [`${status} \u2014 ${diagnostics.note}`];
+  for (const finding of diagnostics.findings) {
+    const count = finding.count > 1 ? ` \xD7${finding.count}` : "";
+    lines.push(`${finding.level.toUpperCase()}${count} \u2014 ${finding.preview}`);
+  }
+  return lines;
+}
 async function beginRunDiagnostics(adapter, projectRoot) {
   const source = getAdapterSurface(adapter).appLogSource(projectRoot);
   if (!source) return null;
   const mobileIssueBuffer = adapter === "mobile" && armMobileIssueBuffer(projectRoot) ? { projectRoot } : void 0;
-  const extensionConsoleCapture = adapter === "extension" ? await startExtensionConsoleCapture(source, projectRoot) : void 0;
+  if (adapter === "extension") {
+    await ensureExtensionConsoleCapture(projectRoot).catch(() => void 0);
+  }
   const stat = safeStat(source.path);
   return {
     source,
     offset: stat?.size ?? 0,
     ...stat ? { inode: stat.ino } : {},
-    ...mobileIssueBuffer ? { mobileIssueBuffer } : {},
-    ...extensionConsoleCapture ? { extensionConsoleCapture } : {}
+    ...mobileIssueBuffer ? { mobileIssueBuffer } : {}
   };
 }
+function isRunDiagnosticsDocument(value) {
+  if (!isRecord(value) || value.schemaVersion !== 1 || value.scope !== "recipe-run-application") return false;
+  if (value.status !== "clean" && value.status !== "review" && value.status !== "unavailable") return false;
+  return typeof value.note === "string" && Array.isArray(value.findings);
+}
 function finishRunDiagnostics(baseline, result) {
   if (!baseline) return result;
   try {
@@ -56,9 +84,7 @@ function finishRunDiagnostics(baseline, result) {
   }
 }
 function stopRunDiagnostics(baseline) {
-  const capture = baseline?.extensionConsoleCapture;
-  if (!capture || capture.exitCode !== null || capture.signalCode !== null) return;
-  capture.kill("SIGTERM");
+  void baseline;
 }
 function collectRunDiagnostics(baseline, bufferedIssues) {
   const stat = safeStat(baseline.source.path);
@@ -157,39 +183,6 @@ function runMobileIssueCommand(projectRoot, command) {
     return null;
   }
 }
-async function startExtensionConsoleCapture(source, projectRoot) {
-  const cdpPort = process.env.CDP_PORT ?? process.env.RECIPE_CDP_PORT;
-  if (!cdpPort) return void 0;
-  fs.mkdirSync(path.dirname(source.path), { recursive: true });
-  const before = safeStat(source.path)?.size ?? 0;
-  const script = path.join(runnerDir, "adapters", "extension", "console-tail.mjs");
-  const child = spawn(process.execPath, [script, "--cdp-port", cdpPort, "--log", source.path], {
-    cwd: projectRoot,
-    stdio: "ignore"
-  });
-  const attached = await waitForExtensionAttachment(source.path, before, child, 3e3);
-  if (attached) {
-    await delay(50);
-    return child;
-  }
-  if (child.exitCode === null && child.signalCode === null) child.kill("SIGTERM");
-  return void 0;
-}
-async function waitForExtensionAttachment(logPath, offset, child, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline && child.exitCode === null && child.signalCode === null) {
-    const stat = safeStat(logPath);
-    if (stat && stat.size > offset) {
-      const appended = readSlice(logPath, offset, Math.min(stat.size - offset, 64 * 1024));
-      if (appended.includes("[attached]")) return true;
-    }
-    await delay(50);
-  }
-  return false;
-}
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
 function redactPreview(value) {
   return value.replace(/\b(Bearer)\s+\S+/giu, "$1 [REDACTED]").replace(/\b(password|passphrase|mnemonic|seed(?:Phrase)?|privateKey|secret|token|authorization)\b\s*[:=]\s*(?:"[^"]*"|'[^']*'|\S+)/giu, "$1=[REDACTED]").replace(/\b(?:0x)?[a-f0-9]{64,}\b/giu, "[REDACTED_HEX]").replace(/(https?:\/\/[^\s?]+)\?\S+/giu, "$1?[REDACTED_QUERY]").slice(0, MAX_PREVIEW_CHARS);
 }
@@ -267,5 +260,7 @@ export {
   beginRunDiagnostics,
   collectRunDiagnostics,
   finishRunDiagnostics,
+  formatRunDiagnosticsForHuman,
+  readRunDiagnosticsDocument,
   stopRunDiagnostics
 };

package/dist/runtime-context.js

@@ -53,6 +53,32 @@ function readExistingContext(contextPath, repoRoot, runtimeDir, adapter) {
   return { context, existed: true };
 }
 function validExistingContext(context, repoRoot, runtimeDir, adapter) {
+  const allowedFields = /* @__PURE__ */ new Set([
+    "schemaVersion",
+    "repoRoot",
+    "project",
+    "slotId",
+    "machine",
+    "runtimeOwner",
+    "strict",
+    "platform",
+    "runtimeDir",
+    "gitDirty",
+    "simulator",
+    "adbSerial",
+    "distDir",
+    "extensionId",
+    "gitHead",
+    "gitBranch",
+    "gitCommit",
+    "createdAt",
+    "session",
+    "cdpPort",
+    "watcherPort",
+    "metroPort",
+    "devServerPort"
+  ]);
+  if (Object.keys(context).some((field) => !allowedFields.has(field))) return false;
   if (context.schemaVersion !== void 0 && context.schemaVersion !== 1) return false;
   if (context.repoRoot !== void 0 && (typeof context.repoRoot !== "string" || path.resolve(context.repoRoot) !== repoRoot)) return false;
   if (context.platform !== void 0 && context.platform !== adapter) return false;
@@ -82,14 +108,6 @@ function validExistingContext(context, repoRoot, runtimeDir, adapter) {
     const value = context[field];
     if (value !== void 0 && (!Number.isInteger(value) || Number(value) < 1 || Number(value) > 65535)) return false;
   }
-  if (context.runtimeStart !== void 0) {
-    if (!context.runtimeStart || typeof context.runtimeStart !== "object" || Array.isArray(context.runtimeStart)) return false;
-    const runtimeStart = context.runtimeStart;
-    if (runtimeStart.approved !== void 0 && typeof runtimeStart.approved !== "boolean") return false;
-    for (const field of ["command", "readyUrl"]) {
-      if (runtimeStart[field] !== void 0 && (typeof runtimeStart[field] !== "string" || runtimeStart[field].length === 0)) return false;
-    }
-  }
   const forbiddenResources = adapter === "core" ? ["cdpPort", "watcherPort", "metroPort", "devServerPort", "simulator", "adbSerial", "extensionId"] : adapter === "extension" ? ["metroPort", "simulator", "adbSerial"] : ["cdpPort", "extensionId"];
   if (forbiddenResources.some((field) => context[field] !== void 0)) return false;
   return true;