@deeeed/metamask-harness 0.92.22 → 0.92.23

package/dist/review/knowledge.js

@@ -274,74 +274,6 @@ function loadOwnedPaths(root) {
   }
   return { domain: record.domain, repos };
 }
-function globToRegExp(glob) {
-  let out = "^";
-  for (let i = 0; i < glob.length; i += 1) {
-    const char = glob[i];
-    if (char === "*") {
-      if (glob[i + 1] === "*") {
-        const slashAfter = glob[i + 2] === "/";
-        out += slashAfter ? "(?:.*/)?" : ".*";
-        i += slashAfter ? 2 : 1;
-      } else {
-        out += "[^/]*";
-      }
-    } else if (char === "?") {
-      out += "[^/]";
-    } else if (char === "[") {
-      const negated = glob[i + 1] === "!";
-      const bodyStart = i + 1 + (negated ? 1 : 0);
-      const close = glob.indexOf("]", glob[bodyStart] === "]" ? bodyStart + 1 : bodyStart);
-      if (close === -1) {
-        out += "\\[";
-      } else {
-        out += `[${negated ? "^" : ""}${glob.slice(bodyStart, close).replace(/[\\\]]/g, "\\$&")}]`;
-        i = close;
-      }
-    } else {
-      out += char.replace(/[.+^${}()|\\]/g, "\\$&");
-    }
-  }
-  return new RegExp(`${out}$`);
-}
-function matchOwnedFiles(files, globs) {
-  const patterns = globs.map(globToRegExp);
-  return files.filter((file) => patterns.some((pattern) => pattern.test(file)));
-}
-function classifyDomain(files, adapter, libraries) {
-  const matches = [];
-  for (const library of libraries) {
-    const owned = loadOwnedPaths(library.root);
-    if (!owned) continue;
-    const matched = matchOwnedFiles(files, owned.repos[adapter] ?? []);
-    if (matched.length > 0) matches.push({ domain: owned.domain, library, matched });
-  }
-  return matches.sort((a, b) => b.matched.length - a.matched.length);
-}
-function git(target, args) {
-  return execFileSync("git", ["-C", target, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
-}
-function defaultBaseRef(target) {
-  for (const candidate of ["origin/main", "main", "origin/develop", "develop"]) {
-    try {
-      git(target, ["rev-parse", "--verify", "--quiet", `${candidate}^{commit}`]);
-      return candidate;
-    } catch {
-    }
-  }
-  return "HEAD";
-}
-function changedFiles(target, base) {
-  const ref = base ?? defaultBaseRef(target);
-  const lists = [
-    ref === "HEAD" ? "" : git(target, ["diff", "--name-only", `${ref}...HEAD`]),
-    git(target, ["diff", "--name-only", "HEAD"]),
-    git(target, ["ls-files", "--others", "--exclude-standard"])
-  ];
-  const files = /* @__PURE__ */ new Set();
-  for (const list of lists) for (const line of list.split("\n")) if (line.trim()) files.add(line.trim());
-  return { base: ref, files: [...files].sort() };
-}
 function parseSections(markdown) {
   const lines = markdown.split("\n");
   const introLines = [];
@@ -457,51 +389,6 @@ function parityReviewSteps(input) {
   }
   return ["Parity: core changes are consumed by both mobile and extension; confirm both consumers still compile against the public surface."];
 }
-function renderReviewChecklist(input) {
-  const diffRange = input.since ? `${input.since}..HEAD` : `${input.base}...HEAD`;
-  const lines = [];
-  const scope = input.domain ? `${input.domain} (${input.adapter})` : input.adapter;
-  lines.push(`# Review checklist \u2014 ${scope}`, "");
-  lines.push(`Materialized by mm-harness ${input.harnessVersion} for ${input.target}.`);
-  if (input.knowledge) {
-    const { library } = input.knowledge;
-    lines.push(`Domain knowledge: ${library.name}${library.revision ? ` @ ${library.revision}` : ""} (${library.root}, via ${library.source}).`);
-  }
-  if (input.reference) {
-    lines.push(`Parity reference: ${input.reference.adapter} checkout at ${input.reference.root} (via ${input.reference.source}).`);
-  } else if (input.referenceMissing) {
-    lines.push(`Parity reference: not checked \u2014 ${input.referenceMissing}.`);
-  }
-  lines.push(`Scope: \`git diff ${diffRange}\`${input.since ? " (incremental re-review since the last verdict)" : ""}.`, "");
-  let step = 0;
-  const item = (text) => {
-    step += 1;
-    lines.push(`- [ ] ${step}. ${text}`);
-  };
-  lines.push("## Setup");
-  if (input.since) {
-    item(`Re-read the previous findings, then list only the files changed in \`git diff --name-only ${diffRange}\`; confirm each earlier finding is addressed or explicitly declined.`);
-  } else {
-    item(`Read the task or PR description and the linked ticket, then list the changed files with \`git diff --name-only ${diffRange}\`.`);
-  }
-  item(
-    input.domain ? `Confirm the domain is ${input.domain} (\`mm-harness domain\`) and open ${input.knowledge?.antipatterns ? "review/antipatterns.md" : "the domain library"} once before reading the diff.` : "Run `mm-harness domain` to check whether a team library owns the changed files; if one does, re-run with --domain."
-  );
-  lines.push("", "## Base review");
-  for (const text of BASE_REVIEW_STEPS) item(text);
-  if (input.knowledge?.antipatterns) {
-    lines.push("", `## Domain patterns (${input.domain})`);
-    for (const section of input.knowledge.antipatterns.sections) {
-      item(`${section.title}: ${section.summary}`);
-    }
-  }
-  lines.push("", "## Parity");
-  for (const step2 of parityReviewSteps({ ...input, hasParityGuide: Boolean(input.knowledge?.parity) })) item(step2);
-  lines.push("", "## Verdict");
-  item(VERDICT_STEP);
-  return `${lines.join("\n")}
-`;
-}
 function renderReviewHelp(input) {
   const lines = [];
   lines.push(`mm-harness ${input.harnessVersion} review guide${input.domain ? ` \u2014 ${input.domain}` : ""}`, "");
@@ -542,21 +429,16 @@ export {
   REVIEW_ADAPTERS,
   SKILLS_CACHE_DIR,
   VERDICT_STEP,
-  changedFiles,
-  classifyDomain,
   configPath,
   declaredLibraryPathEnv,
-  defaultBaseRef,
   discoverLibraries,
   excludeCacheDir,
   fetchLibrary,
   gitExcludeFile,
-  globToRegExp,
   hydrateLibraryPathEnv,
   libraryCachePath,
   loadDomainKnowledge,
   loadOwnedPaths,
-  matchOwnedFiles,
   parityAdapter,
   parityReviewSteps,
   parseAdvisorSettings,
@@ -565,7 +447,6 @@ export {
   readConfig,
   referenceEnvName,
   referenceHint,
-  renderReviewChecklist,
   renderReviewHelp,
   resolveLibrary,
   resolveReference,

package/docs/CONTRIBUTING.md

@@ -88,8 +88,9 @@ command-local platform ladders for surface-owned behavior:
 - the runner reads `actions` (manifest, bundled semantic actions, live adapter
   scripts, `cdp.target`, the `ui.*` transport, adapter wrappers, input checks);
 - `install`/`verify`/`cleanup` read `harness`, `agentic-runtime.json` reads
-  `runtimeContext`, `doctor`/`status` read `readiness`, and `fixtures`,
-  `prepare`, `debug`, `reload` and `runtime-decision` read their own members.
+  `runtimeContext`, `doctor`/`status` read `readiness`, `prepare` reads
+  `readiness.prepare`, and `fixtures`, `debug`, `reload` and
+  `runtime-decision` read their own members.
 
 A few comparisons remain where a command exists for one platform
 (`resolve-extension`, `ensure-ready`, `runtime-launch`) or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.92.22",
+  "version": "0.92.23",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -24,11 +24,11 @@
     "@farmslot/adapter-node": "0.1.34",
     "@farmslot/adapter-rn": "0.22.23",
     "@farmslot/adapter-sdk": "0.18.0",
-    "@farmslot/adapter-web": "0.10.14",
+    "@farmslot/adapter-web": "0.10.15",
     "@farmslot/agent-runtime": "0.29.0",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "0.54.0",
-    "@farmslot/recipe-cli": "0.23.0",
+    "@farmslot/recipe-cli": "0.23.1",
     "@farmslot/recipe-runner": "0.39.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",

package/dist/commands/checklist.js

@@ -1,242 +0,0 @@
-import { EXIT } from "@farmslot/recipe-cli/harness";
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { HANDOFF_INPUT } from "@farmslot/agent-runtime";
-import { enumerateChecklistCheckboxes, isTerminalWorkerSignalStatus } from "@farmslot/protocol";
-const require2 = createRequire(import.meta.url);
-const MARK_SCRIPT = require2.resolve(
-  "@farmslot/agent-runtime/scripts/mark-checklist-step.cjs"
-);
-const { resolveChecklistPaths } = require2(
-  "@farmslot/agent-runtime/scripts/checklist-target.cjs"
-);
-const { readSubtaskIndex, SubtaskRefusal } = require2("@farmslot/agent-runtime/scripts/subtask-unit.cjs");
-const USAGE = "mm-harness checklist <mark <task-dir> <step> | closeout <task-dir>> [options]";
-const CHECKLIST_VALUE_OPTIONS = /* @__PURE__ */ new Set([
-  "--reason",
-  "--checklist",
-  "--signal",
-  "--config",
-  "--destination",
-  "--metadata"
-]);
-function parseChecklistArgv(argv) {
-  const positionals = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index] ?? "";
-    if (arg.startsWith("-")) {
-      const option = arg.split("=", 1)[0] ?? arg;
-      if (CHECKLIST_VALUE_OPTIONS.has(option) && !arg.includes("=")) index += 1;
-      continue;
-    }
-    positionals.push({ index, value: arg });
-  }
-  const consumed = new Set(positionals.slice(0, 2).map(({ index }) => index));
-  return {
-    action: positionals[0]?.value,
-    taskDir: positionals[1]?.value,
-    step: positionals[2]?.value,
-    forwarded: argv.filter((_, index) => !consumed.has(index))
-  };
-}
-function handoffCommand() {
-  if (process.env.HANDOFF_BIN) {
-    try {
-      fs.accessSync(process.env.HANDOFF_BIN, fs.constants.X_OK);
-      return { command: process.env.HANDOFF_BIN, prefix: [] };
-    } catch {
-      return { command: process.execPath, prefix: [process.env.HANDOFF_BIN] };
-    }
-  }
-  return {
-    command: process.execPath,
-    prefix: [require2.resolve("@farmslot/handoff/cli")]
-  };
-}
-function closeoutArgs(taskDir, args) {
-  const normalized = args.flatMap((arg) => {
-    const option = ["--config", "--destination", "--metadata"].find(
-      (name) => arg.startsWith(`${name}=`)
-    );
-    return option ? [option, arg.slice(option.length + 1)] : [arg];
-  });
-  if (process.env.METAMASK_AGENTIC_LEARNINGS_DIR && !normalized.includes("--destination")) {
-    return [
-      "closeout",
-      taskDir,
-      ...normalized,
-      "--destination",
-      process.env.METAMASK_AGENTIC_LEARNINGS_DIR
-    ];
-  }
-  return ["closeout", taskDir, ...normalized];
-}
-function runCloseout(taskDir, args, stdio) {
-  try {
-    const { command, prefix } = handoffCommand();
-    return spawnSync(command, [...prefix, ...closeoutArgs(taskDir, args)], {
-      encoding: "utf8",
-      stdio
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      status: 1,
-      stdout: "",
-      stderr: message,
-      error: new Error(message)
-    };
-  }
-}
-function stageLearningPackage(taskDir, step, markArgs) {
-  if (!["complete", "no-change"].includes(step ?? "") || markArgs.includes("--skip-learnings") || !fs.existsSync(path.join(taskDir, HANDOFF_INPUT))) {
-    return;
-  }
-  try {
-    const result = runCloseout(taskDir, ["--json"], "pipe");
-    if (result.status === 0) return;
-  } catch {
-  }
-  console.error(
-    `Warning: learning capture could not be staged; rerun: mm-harness checklist closeout ${taskDir}; task verdict is unchanged.`
-  );
-}
-function terminalSignalStatus(taskDir) {
-  const { signalPath } = resolveChecklistPaths(taskDir);
-  let signal;
-  try {
-    signal = JSON.parse(fs.readFileSync(signalPath, "utf8"));
-  } catch {
-    return null;
-  }
-  return isTerminalWorkerSignalStatus(signal.status) ? signal.status ?? null : null;
-}
-function preserveTerminalSignal(taskDir, step) {
-  if (step !== "start" && numericMarkStep(step) === null) return false;
-  const status = terminalSignalStatus(taskDir);
-  if (!status) return false;
-  console.log(
-    `signal already terminal: status=${status}; ignoring non-terminal mark ${step}`
-  );
-  return true;
-}
-function numericMarkStep(step) {
-  const stepNumber = Number(step);
-  return Number.isInteger(stepNumber) && stepNumber >= 1 ? stepNumber : null;
-}
-function checklistStepRequiresDiffPass(checklist, stepNumber) {
-  const step = enumerateChecklistCheckboxes(checklist).find((item) => item.stepNumber === stepNumber);
-  return step !== void 0 && /mm-harness check diff/u.test(step.rawLabel);
-}
-function checkDiffGateReady(taskDir, step, parentChecklist) {
-  const stepNumber = numericMarkStep(step);
-  if (stepNumber === null) return true;
-  const taskPath = parentChecklist ? path.join(taskDir, parentChecklist) : resolveChecklistPaths(taskDir).taskPath;
-  let checklist = "";
-  try {
-    checklist = fs.readFileSync(taskPath, "utf8");
-  } catch {
-    return true;
-  }
-  if (!checklistStepRequiresDiffPass(checklist, stepNumber)) return true;
-  return checkDiffSummaryReady(taskDir, step);
-}
-function checkDiffSummaryReady(taskDir, step) {
-  const summaryPath = path.join(
-    taskDir,
-    "artifacts",
-    "validation-summary.json"
-  );
-  try {
-    const summary = JSON.parse(fs.readFileSync(summaryPath, "utf8"));
-    if (summary.command === "check" && summary.action === "diff" && summary.status === "pass") {
-      return true;
-    }
-  } catch {
-  }
-  console.error(
-    `check-diff gate ${step} requires a task-local PASS at ${summaryPath}`
-  );
-  console.error(
-    `Run: mm-harness check diff [--fix] --artifacts-dir ${path.dirname(summaryPath)}`
-  );
-  console.error("Then rerun the same checklist mark command.");
-  return false;
-}
-function teachRecipeCompletion(taskDir, step) {
-  if (step !== "complete") return;
-  const artifactsDir = path.join(taskDir, "artifacts");
-  if (!fs.existsSync(path.join(artifactsDir, "recipe.json"))) return;
-  const qualityPath = path.join(artifactsDir, "recipe-quality.json");
-  const coveragePath = path.join(artifactsDir, "recipe-coverage.md");
-  const missingQuality = !fs.existsSync(qualityPath);
-  const missingCoverage = !fs.existsSync(coveragePath);
-  if (!missingQuality && !missingCoverage) return;
-  console.error("Recipe completion needs two closure artifacts; derive them from the real recipe run and evidence (do not stub them):");
-  if (missingCoverage) {
-    console.error(`  - ${coveragePath}: map each proof target to its recipe node and evidence, or record a reasoned N/A.`);
-  }
-  if (missingQuality) {
-    const compactPath = path.join(artifactsDir, "recipe-quality-input.json");
-    console.error("    First run: mm-harness help");
-    console.error(`  - ${qualityPath}: write ${compactPath} as:`);
-    console.error('    {"verdict":"pass|warn|fail","reasons":["evidence-backed reason"]}');
-    console.error(`    then run: mm-harness recipe-quality build --input ${compactPath} --output ${qualityPath}`);
-  }
-  console.error("Then rerun the same checklist complete command.");
-}
-async function handleChecklist(argv) {
-  const { action, taskDir, step, forwarded } = parseChecklistArgv(argv);
-  if (!taskDir) {
-    console.error(`usage: ${USAGE}`);
-    return EXIT.usage;
-  }
-  const resolvedTaskDir = path.resolve(taskDir);
-  if (action === "closeout") {
-    const result2 = runCloseout(resolvedTaskDir, forwarded, "inherit");
-    if (result2.error) {
-      console.error(`mm-harness checklist closeout: ${result2.error.message}`);
-      return EXIT.runtime;
-    }
-    return result2.status ?? EXIT.runtime;
-  }
-  if (action !== "mark" || !step) {
-    console.error(`usage: ${USAGE}`);
-    return EXIT.usage;
-  }
-  if (preserveTerminalSignal(resolvedTaskDir, step)) return EXIT.ok;
-  if (step === "sub" && forwarded[2] === "complete") {
-    try {
-      const unit = readSubtaskIndex(resolvedTaskDir)?.units.find((unit2) => unit2.id === forwarded[1]);
-      if (unit && !checkDiffGateReady(resolvedTaskDir, String(unit.parent.stepNumber), unit.parent.checklist)) return EXIT.runtime;
-    } catch (error) {
-      if (!(error instanceof SubtaskRefusal)) throw error;
-      console.error(error.message);
-      return error.code;
-    }
-  }
-  if (!checkDiffGateReady(resolvedTaskDir, step)) return EXIT.runtime;
-  teachRecipeCompletion(resolvedTaskDir, step);
-  const result = spawnSync(
-    process.execPath,
-    [MARK_SCRIPT, resolvedTaskDir, ...forwarded],
-    { stdio: "inherit" }
-  );
-  if (result.error) {
-    console.error(`mm-harness checklist mark: ${result.error.message}`);
-    return EXIT.runtime;
-  }
-  const status = result.status ?? EXIT.runtime;
-  if (status === EXIT.ok) {
-    stageLearningPackage(resolvedTaskDir, step, forwarded);
-  }
-  return status;
-}
-export {
-  checkDiffSummaryReady,
-  handleChecklist,
-  runCloseout,
-  teachRecipeCompletion
-};

package/dist/commands/domain.js

@@ -1,57 +0,0 @@
-import { optionFlag, optionString, parseArgs, targetPath, usageError } from "@farmslot/recipe-cli/harness";
-import {
-  changedFiles,
-  classifyDomain,
-  configPath,
-  discoverLibraries,
-  readConfig,
-  REVIEW_ADAPTERS
-} from "../review/knowledge.js";
-import { adapterFromOptions } from "./review.js";
-async function handleDomain(argv) {
-  const parsed = parseArgs(argv);
-  const target = targetPath(parsed.options);
-  const json = optionFlag(parsed.options, "json");
-  const declared = optionString(parsed.options, "domain") ?? process.env.MM_HARNESS_DOMAIN;
-  const detected = adapterFromOptions();
-  const adapter = detected === "unscoped" ? void 0 : detected;
-  if (declared) {
-    emit(json, { domain: declared, source: "declared", adapter: adapter ?? null, target });
-    return 0;
-  }
-  if (!adapter) {
-    throw usageError(`No MetaMask checkout detected: pass --adapter <${REVIEW_ADAPTERS.join("|")}> or --domain <name>.`);
-  }
-  const config = readConfig(configPath());
-  const libraries = discoverLibraries({ target, config });
-  const { base, files } = changedFiles(target, optionString(parsed.options, "base"));
-  const matches = classifyDomain(files, adapter, libraries);
-  const best = matches[0];
-  emit(json, {
-    domain: best?.domain ?? null,
-    source: best ? "owned-paths" : "none",
-    adapter,
-    target,
-    base,
-    changedFiles: files.length,
-    libraries: libraries.map((library) => ({ name: library.name, root: library.root, source: library.source, revision: library.revision ?? null })),
-    matches: matches.map((match) => ({ domain: match.domain, library: match.library.root, matched: match.matched }))
-  });
-  return 0;
-}
-function emit(json, payload) {
-  if (json) {
-    process.stdout.write(`${JSON.stringify({ command: "domain", ...payload }, null, 2)}
-`);
-    return;
-  }
-  process.stdout.write(`${payload.domain ?? "none"}
-`);
-  const best = payload.matches?.[0];
-  const detail = payload.source === "declared" ? "declared via --domain or MM_HARNESS_DOMAIN" : best ? `owned-paths match in ${best.library} (${best.matched.length} of ${payload.changedFiles} changed files)` : `no library owns the ${payload.changedFiles} changed files (base ${payload.base}; libraries scanned: ${payload.libraries?.length ?? 0})`;
-  process.stderr.write(`domain: ${detail}
-`);
-}
-export {
-  handleDomain
-};

package/dist/commands/execution-template.js

@@ -1,28 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-const require2 = createRequire(import.meta.url);
-async function handleExecutionTemplate(argv) {
-  let entrypoint;
-  try {
-    entrypoint = require2.resolve(
-      "@farmslot/agent-runtime/scripts/execution-template-cli.mjs"
-    );
-  } catch (error) {
-    console.error(
-      `mm-harness execution-template: installed @farmslot/agent-runtime does not expose the catalog command: ${error instanceof Error ? error.message : String(error)}`
-    );
-    return 1;
-  }
-  const result = spawnSync(process.execPath, [entrypoint, ...argv], {
-    env: process.env,
-    stdio: "inherit"
-  });
-  if (result.error) {
-    console.error(`mm-harness execution-template: ${result.error.message}`);
-    return 1;
-  }
-  return result.status ?? 1;
-}
-export {
-  handleExecutionTemplate
-};

package/dist/commands/logs.js

@@ -1,99 +0,0 @@
-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 { createLogsOptions } from "../provider-logs.js";
-import { getAdapterSurface } from "../adapters/surface.js";
-const LOGS_BOOLEANS = /* @__PURE__ */ new Set(["full", "json", "window"]);
-async function handleLogs(argv) {
-  const { options } = parseFlags(argv, LOGS_BOOLEANS);
-  const json = flag(options, "json");
-  const target = targetOf(options);
-  const adapter = contextAdapter(target);
-  if (!adapter) {
-    return usageOut(json, "logs", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
-  }
-  const surface = getAdapterSurface(adapter);
-  if (surface.headless) {
-    return usageOut(json, "logs", "core is headless; it has no dev server logs.", surface.hints.launch);
-  }
-  const logSources = surface.logSources(target);
-  const appLogSource = surface.appLogSource(target);
-  const sourceLabels = logSources.map((entry) => entry.label);
-  const appSourceLabel = appLogSource?.label ?? "app";
-  const defaultSource = appLogSource && appSourceLabel !== "app" ? appSourceLabel : sourceLabels[0];
-  const source = str(options, "source") ?? defaultSource;
-  const validSources = [...sourceLabels, ...appLogSource ? [appSourceLabel] : [], ...appLogSource && appSourceLabel !== "app" ? ["app"] : []];
-  if (!validSources.includes(source)) {
-    return usageOut(json, "logs", `--source must be one of: ${validSources.join(", ")}.`, `mm-harness logs --source ${defaultSource}`);
-  }
-  const events = str(options, "events");
-  if (events !== void 0) {
-    if (!/^\d+$/u.test(events)) {
-      return usageOut(json, "logs", `--events must be numeric (got: ${events}).`, "mm-harness logs --events 20");
-    }
-    process.env.RECIPE_LOG_EVENTS = events;
-  }
-  const isAppSource = source === "app" || source === appSourceLabel;
-  const requested = isAppSource ? appLogSource : logSources.find((entry) => entry.label === source);
-  const ordered = isAppSource ? requested ? [requested] : [] : requested ? [requested] : logSources;
-  const logFile = ordered.find((entry) => fs.existsSync(entry.path))?.path;
-  if (!logFile) {
-    if (isAppSource && appLogSource) {
-      const message = `application console unavailable for this checkout (${path.basename(appLogSource.path)} is absent).`;
-      const userAction = surface.hints.launch;
-      if (json) {
-        console.log(JSON.stringify({
-          schemaVersion: 1,
-          command: "logs",
-          adapter,
-          source,
-          status: "fail",
-          error: { code: "APP_LOG_UNAVAILABLE", message, userAction },
-          exitCode: EXIT.runtime
-        }, null, 2));
-      } else {
-        console.error(`\u2717 logs: ${message}`);
-        console.error(`  Next: ${userAction}`);
-      }
-      return EXIT.runtime;
-    }
-    const names = isAppSource && appLogSource ? path.basename(appLogSource.path) : logSources.map((entry) => path.basename(entry.path)).join(" / ");
-    return usageOut(
-      json,
-      "logs",
-      `nothing running for this checkout (no ${names}).`,
-      surface.hints.launch
-    );
-  }
-  if (flag(options, "window")) {
-    const result = await createLogsOptions(surface).window({
-      target,
-      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));
-    return EXIT.ok;
-  }
-  process.stderr.write(
-    `${source} log: ${logFile}
-  tail it yourself: tail -f ${logFile}   \xB7   page it: less +F ${logFile}
-  following below (Ctrl-C to stop) \u2026
-`
-  );
-  const full = flag(options, "full");
-  if (full) {
-    return spawnInherit("tail", ["-n", "+1", "-F", logFile], 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
-};