@uniqbit/mate-core 0.18.1-canary.1 → 0.18.1-canary.2

package/src/cli/commands/companion/link.ts

@@ -1,6 +1,5 @@
 import os from "node:os";
 import path from "node:path";
-import { spawnSync } from "node:child_process";
 import fs from "node:fs/promises";
 
 import { FRAMEWORK_NAME } from "../../../framework";
@@ -19,17 +18,16 @@ import { runSetupFlowAtPath } from "../setup";
 import { runInstallCommand } from "../install";
 import type { CompanionSource, LinkedRepository } from "../../../lib/orchestrator/types";
 import { invalidateInstallState } from "../../../lib/install";
-import { toSshUrl } from "../../../runtime/companion-git";
+import { companionGit, describeGitFailure, type GitResult } from "../../../runtime/companion-git";
 
 interface CompanionLinkCommandDeps {
   selectCompanionLinkInputs?: (
     options: CompanionLinkWizardOptions,
   ) => Promise<CompanionLinkInputs | null>;
   extractRepoName?: (url: string) => string | null;
-  spawnSync?: typeof spawnSync;
+  cloneCompanion?: (url: string, destination: string) => Promise<GitResult>;
   mkdir?: typeof fs.mkdir;
   stat?: typeof fs.stat;
-  rm?: typeof fs.rm;
   listCompanions?: () => Promise<string[]>;
   registerCompanion?: (companionPath: string) => Promise<void>;
   resolveCompanion?: (cwd: string) => ReturnType<CompanionResolver["resolve"]>;
@@ -80,10 +78,12 @@ export async function runCompanionLinkCommandWithDeps(
 
   const selectInputs = deps.selectCompanionLinkInputs ?? selectCompanionLinkInputs;
   const extractName = deps.extractRepoName ?? extractRepoName;
-  const spawn = deps.spawnSync ?? spawnSync;
+  const cloneCompanion =
+    deps.cloneCompanion ??
+    ((url: string, destination: string) =>
+      companionGit(path.dirname(destination), { prompt: "if-terminal" }).clone(url, destination));
   const mkdir = deps.mkdir ?? fs.mkdir;
   const stat = deps.stat ?? fs.stat;
-  const rm = deps.rm ?? fs.rm;
   const listCompanions =
     deps.listCompanions ??
     (() => {
@@ -149,44 +149,14 @@ export async function runCompanionLinkCommandWithDeps(
     const existingTarget = await stat(companionPath).catch(() => null);
     if (!existingTarget?.isDirectory()) {
       await mkdir(companionsDir, { recursive: true });
-      const sshUrl = toSshUrl(gitUrl);
-      const cloneUrls = sshUrl && sshUrl !== gitUrl ? [sshUrl, gitUrl] : [gitUrl];
-      let cloneResult:
-        | {
-            status: number | null;
-            stderr?: string | Buffer;
-            stdout?: string | Buffer;
-          }
-        | undefined;
-      const cloneErrors: string[] = [];
-
-      for (const cloneUrl of cloneUrls) {
-        cloneResult = spawn("git", ["clone", cloneUrl, companionPath], {
-          encoding: "utf8",
-          stdio: ["ignore", "pipe", "pipe"],
-        });
-        if (cloneResult.status === 0) {
-          break;
-        }
-
-        cloneErrors.push(
-          String(cloneResult.stderr || cloneResult.stdout || `Clone failed for ${cloneUrl}`),
+      const clone = await cloneCompanion(gitUrl, companionPath);
+      if (clone.status !== 0) {
+        const detail = describeGitFailure(clone);
+        exitWithError(
+          `mate: failed to clone companion repository:\n${
+            detail === "unknown Git error" ? "review the Git or SSH diagnostics above" : detail
+          }`,
         );
-        try {
-          await rm(companionPath, { recursive: true, force: true });
-        } catch {
-          // Ignore cleanup errors after a failed clone.
-        }
-      }
-
-      if (!cloneResult || cloneResult.status !== 0) {
-        try {
-          await rm(companionPath, { recursive: true, force: true });
-        } catch {
-          // Ignore cleanup errors after a failed clone.
-        }
-        const output = cloneErrors.join("\n\n");
-        exitWithError(`mate: failed to clone companion repository:\n${output}`);
       }
     }
     companionPaths = [companionPath];

package/src/cli/commands/doctor.ts

@@ -2,12 +2,17 @@ import { execFileSync } from "node:child_process";
 import path from "node:path";
 
 import { FRAMEWORK_NAME } from "../../framework";
+import { gitEnvironment } from "../../runtime/companion-git";
 import { getActiveDistribution } from "../../distribution";
 import { checkEngineRequirement } from "../../lib/orchestrator/engine-guard";
 import type { GlobalConfigStore } from "../../lib/orchestrator/global-config-store";
 import { pathIsDirectory } from "../../lib/orchestrator/repo-local-registry";
 import { resolveRootContext, type RootContext } from "../../lib/orchestrator/root-context";
 import type { CapabilityConfig, FrameworkConfig, HubMember } from "../../lib/orchestrator/types";
+import {
+  verifyDeclaredPlugins,
+  type PluginVerificationFailure,
+} from "../../tools/setup/dynamic-plugins/verify";
 import { getRequiredPluginDrift } from "../../tools/setup/policy";
 import { resolveCommandOnPath } from "../../tools/setup/utils";
 import { writeJsonStdout } from "../write-json-stdout";
@@ -19,6 +24,7 @@ interface DoctorDeps {
   pathValue?: string;
   /** Returns a member checkout's HEAD commit, or null when unreadable. */
   gitHead?: (memberPath: string) => string | null;
+  verifyPlugins?: (companionPath: string) => Promise<PluginVerificationFailure[]>;
 }
 
 export type DoctorKind = "core" | "working" | "companion" | "hub";
@@ -51,6 +57,7 @@ export interface DoctorReport {
   capabilities?: string[];
   toolInstallations?: DoctorToolInstallation[];
   requiredPluginDrift?: Array<{ pluginId: string; kind: string; reason: string }>;
+  pluginFailures?: PluginVerificationFailure[];
   engineRequirement?: { range: string; ok: boolean; detail: string };
   hub?: { members: DoctorHubMember[] };
   resolutionFailures: Array<{ companionPath: string; message: string }>;
@@ -74,6 +81,7 @@ function defaultGitHead(memberPath: string): string | null {
   try {
     return execFileSync("git", ["-C", memberPath, "rev-parse", "HEAD"], {
       stdio: ["ignore", "pipe", "ignore"],
+      env: gitEnvironment(),
     })
       .toString()
       .trim();
@@ -237,6 +245,10 @@ export async function collectDoctorReport(deps: DoctorDeps = {}): Promise<Doctor
     report.engineRequirement = collectEngineRequirement(root.config);
   }
 
+  if (root.rootPath && root.config) {
+    report.pluginFailures = await (deps.verifyPlugins ?? verifyDeclaredPlugins)(root.rootPath);
+  }
+
   return report;
 }
 
@@ -329,6 +341,15 @@ function renderHumanReport(report: DoctorReport): void {
       ),
     );
   }
+  if (report.pluginFailures && report.pluginFailures.length > 0) {
+    printSection(
+      "Declared Plugins",
+      renderTable(
+        ["Plugin", "Issue"],
+        report.pluginFailures.map((failure) => [failure.package, failure.reason]),
+      ),
+    );
+  }
   if (report.engineRequirement) {
     printSection("Version Requirement", report.engineRequirement.detail);
   }
@@ -350,13 +371,18 @@ function renderHumanReport(report: DoctorReport): void {
  * working repository), `companion`, `hub`, or `core` (not linked) — with
  * kind-specific diagnostics: policy and capabilities for working repos,
  * capabilities and tool checks for companions, member health for hubs.
+ * Declared plugins are verified strictly (allowed by `MATE_ALLOWED_PLUGINS`,
+ * installed, loadable); any failure is named on stderr and exits non-zero.
  * `--json` emits the same report as one JSON document.
  */
 export async function runDoctorCommand(argv: string[] = [], deps: DoctorDeps = {}): Promise<void> {
   const report = await collectDoctorReport(deps);
-  if (argv.includes("--json")) {
-    await writeJsonStdout(report);
-    return;
+  if (argv.includes("--json")) await writeJsonStdout(report);
+  else renderHumanReport(report);
+
+  const failures = report.pluginFailures ?? [];
+  for (const failure of failures) {
+    process.stderr.write(`${FRAMEWORK_NAME}: plugin ${failure.package}: ${failure.reason}\n`);
   }
-  renderHumanReport(report);
+  if (failures.length > 0) process.exitCode = 1;
 }

package/src/cli/commands/plugin/plugin.ts

@@ -1,6 +1,5 @@
 import { usage } from "../../usage";
 import { runPluginInstallCommand } from "./install";
-import { runPluginVerifyCommand } from "./verify";
 
 export async function runPluginCommand(
   subcommand: string | undefined,
@@ -10,9 +9,6 @@ export async function runPluginCommand(
     case "install":
       await runPluginInstallCommand(argv);
       return;
-    case "verify":
-      await runPluginVerifyCommand();
-      return;
     default:
       console.error(`Unknown plugin command: ${subcommand ?? ""}`);
       console.error(usage());

package/src/cli/commands/report/formatter.ts

@@ -11,7 +11,3 @@ export function formatTokens(count: number): string {
 export function formatCost(amount: number): string {
   return `$${amount.toFixed(2)}`;
 }
-
-export function formatPercentage(value: number): string {
-  return `${value.toFixed(1)}%`;
-}

package/src/cli/commands/studio/selection.ts

@@ -30,6 +30,9 @@ export const STUDIO_PARAMS: readonly string[] = [
 /** Filled into a prompt when no change is named, so a prompt is never half-written. */
 export const CHANGE_PLACEHOLDER = "<change-name>";
 
+/** Filled into pre-explore prompts, which run before any change exists. */
+export const IDEA_PLACEHOLDER = "<idea>";
+
 const DIGEST_LENGTH = 10;
 
 interface SelectionBase {

package/src/cli/commands/studio/vault.ts

@@ -4,6 +4,8 @@ import * as fsp from "node:fs/promises";
 import path from "node:path";
 import { spawn } from "node:child_process";
 
+import { gitEnvironment } from "../../../runtime/companion-git";
+
 export interface VaultTreeNode {
   name: string;
   path: string;
@@ -108,7 +110,7 @@ function inside(root: string, candidate: string): boolean {
   );
 }
 
-async function realpathContaining(root: string, candidate: string): Promise<string> {
+async function realpathContaining(candidate: string): Promise<string> {
   let current = candidate;
   while (true) {
     try {
@@ -146,7 +148,7 @@ export async function resolveVaultPath(
     absolute = await fsp.realpath(lexical);
   } catch (error) {
     if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
-    const containing = await realpathContaining(root, path.dirname(lexical));
+    const containing = await realpathContaining(path.dirname(lexical));
     if (!inside(root, containing))
       throw new VaultPathError("the requested path leaves the companion root");
     absolute = lexical;
@@ -167,7 +169,7 @@ export async function resolveVaultPath(
 
 function runGit(args: string[], input?: string): Promise<VaultGitResult> {
   return new Promise((resolve, reject) => {
-    const child = spawn("git", args, { stdio: ["pipe", "pipe", "pipe"] });
+    const child = spawn("git", args, { stdio: ["pipe", "pipe", "pipe"], env: gitEnvironment() });
     const stdout: Buffer[] = [];
     const stderr: Buffer[] = [];
     child.stdout.on("data", (chunk: Buffer) => stdout.push(chunk));

package/src/cli/commands/studio/views/workflow/steps.ts

@@ -1,4 +1,4 @@
-import { CHANGE_PLACEHOLDER } from "../../selection";
+import { CHANGE_PLACEHOLDER, IDEA_PLACEHOLDER } from "../../selection";
 
 export type WorkflowStepKind = "skill" | "review" | "completion" | "optional";
 export type WorkflowStepBadge = "optional" | "skill" | "openspec" | "human-in-loop";
@@ -56,11 +56,12 @@ function stepPrompt(
   includeChange = true,
 ): string {
   const changeNote = includeChange ? ` for ${CHANGE_PLACEHOLDER}` : " for";
+  const ideaNote = includeChange ? ` about ${IDEA_PLACEHOLDER}` : " about";
   const schemaNote = profile && profile !== "mate-v1" ? ` (use schema: ${profile})` : "";
 
   switch (step.id) {
     case "pre-explore":
-      return `/mate-interview-me or /mate-grill-me${changeNote}`;
+      return `/mate-interview-me or /mate-grill-me${ideaNote}`;
     case "explore":
       return `/openspec-explore${schemaNote}${changeNote}`;
     case "proposal":
@@ -172,8 +173,8 @@ export function workflowPlan(
         name === "mate-interview-me"
           ? "Difference: guided, one-question-at-a-time clarification. Best when: the request is ambiguous and intent, constraints, or scope still need confirmation."
           : "Difference: adversarial, round-based review of the full design-tree frontier. Best when: the direction is mostly known but hidden assumptions, risks, and downstream impacts need surfacing.",
-      prompt: `/${name} for ${CHANGE_PLACEHOLDER}`,
-      copyPrompt: `/${name} for`,
+      prompt: `/${name} about ${IDEA_PLACEHOLDER}`,
+      copyPrompt: `/${name} about`,
     });
   }
   const start = optionalStep(

package/src/cli/commands/update.ts

@@ -1,10 +1,6 @@
 import { spawnSync } from "node:child_process";
 
 import { FRAMEWORK_NAME } from "../../framework";
-import {
-  OPENCODE_PLUGIN_PACKAGE_NAME,
-  warmOpenCodePluginCache,
-} from "../../lib/opencode-plugin-package";
 import { installPublicPackageSync, isPackageInstalledAtNpmGlobalRoot } from "../../lib/public-npm";
 import {
   fetchLatestVersion,
@@ -66,8 +62,6 @@ export const updateCommandDeps = {
   },
   spawnPostInstall: (executable: string, args: string[]): InstallResult =>
     spawnSync(executable, args, { stdio: "inherit" }) as InstallResult,
-  warmOpenCodePluginCache: (latest: string) =>
-    warmOpenCodePluginCache(latest, process.env, getUpdateConfig().registry),
 };
 
 /**
@@ -157,20 +151,6 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
 
   await updateCommandDeps.saveUpdateState(latest);
 
-  // The plugin package is released in lockstep with the CLI; pre-fetch the
-  // newly coordinated version into OpenCode's plugin environment so the next
-  // managed launch does not stall on a registry download. Best effort only.
-  const warmed = await updateCommandDeps.warmOpenCodePluginCache(latest);
-  if (!warmed.ok) {
-    process.stderr.write(
-      [
-        `${FRAMEWORK_NAME}: could not pre-fetch ${OPENCODE_PLUGIN_PACKAGE_NAME}@${latest} for OpenCode.`,
-        "The next managed OpenCode launch will download it (requires registry access).",
-        ...(warmed.detail ? [`Details: ${warmed.detail}`] : []),
-      ].join("\n") + "\n",
-    );
-  }
-
   const postInstall = updateCommandDeps.runPostInstall(skipConfirm);
   if (postInstall.status !== 0 || postInstall.error) {
     process.stderr.write(
@@ -182,4 +162,8 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
 
   console.log(`\nUpgraded to ${latest}.`);
   console.log("Post-update installation complete.");
+  /** Managed launches run standalone; only a long-lived service keeps the replaced plugin loaded. */
+  console.log(
+    "Restart any running OpenCode service to load the new plugin: `opencode service restart`.",
+  );
 }

package/src/cli/commands/working/cleanup.ts

@@ -6,6 +6,7 @@ import { promisify } from "node:util";
 import { parse } from "yaml";
 
 import { FRAMEWORK_NAME } from "../../../framework";
+import { gitEnvironment } from "../../../runtime/companion-git";
 import type { RootKind } from "../../../lib/orchestrator/root-context";
 import {
   collectWorkspaceInventory,
@@ -39,7 +40,9 @@ export interface WorkingCleanupCommandDeps {
 
 async function resolveGitRoot(cwd: string): Promise<string | null> {
   try {
-    const { stdout } = await execFileAsync("git", ["-C", cwd, "rev-parse", "--show-toplevel"]);
+    const { stdout } = await execFileAsync("git", ["-C", cwd, "rev-parse", "--show-toplevel"], {
+      env: gitEnvironment(),
+    });
     return canonicalPath(stdout.trim());
   } catch {
     return null;

package/src/cli/launch-selector.tsx

@@ -1,320 +1,2 @@
-import { Box, Text, render as inkRender } from "ink";
-import React, { useEffect } from "react";
-import { SelectMenu, type SelectMenuItem } from "../lib/components/select-menu";
-import { WizardFooter } from "../lib/components/wizard-footer";
-import { WizardHeader } from "../lib/components/wizard-header";
-
 export const LAUNCH_TARGETS = ["claude", "opencode"] as const;
 export type LaunchTarget = (typeof LAUNCH_TARGETS)[number];
-
-export interface LaunchPreviewData {
-  repositoryId: string;
-  repositoryPath: string;
-  companionPath: string;
-}
-
-export interface LaunchWizardResult {
-  target: LaunchTarget;
-  preview: LaunchPreviewData;
-}
-
-type WizardStep = "target" | "review";
-type PreviewState =
-  | { status: "idle" }
-  | { status: "loading" }
-  | { status: "ready"; data: LaunchPreviewData }
-  | { status: "error"; message: string };
-
-interface LaunchWizardAppProps {
-  activeIndex: number;
-  hasPreselectedTarget: boolean;
-  items: SelectMenuItem[];
-  previewState: PreviewState;
-  selectedTarget: LaunchTarget | null;
-  step: WizardStep;
-  totalSteps: number;
-  onMounted?: () => void;
-}
-
-export interface LaunchWizardOptions {
-  stdin?: NodeJS.ReadStream;
-  stdout?: NodeJS.WriteStream;
-  stderr?: NodeJS.WriteStream;
-  allowedTargets?: Set<string>;
-  preselectedTarget?: LaunchTarget;
-  resolvePreview(target: LaunchTarget): Promise<LaunchPreviewData>;
-}
-
-const launchSelectorDeps = {
-  render: inkRender,
-};
-
-const TARGET_ITEMS: SelectMenuItem[] = [
-  { key: "claude", label: "claude" },
-  { key: "opencode", label: "opencode" },
-];
-
-function parseLaunchSelectorInput(
-  input: string,
-): "submit" | "cancel" | "up" | "down" | "back" | null {
-  if (input === "\r" || input === "\n") return "submit";
-  if (input === "\x1b[A" || input === "[A") return "up";
-  if (input === "\x1b[B" || input === "[B") return "down";
-  if (input === "\x7f" || input === "\b") return "back";
-  if (input === "\x1b" || input.toLowerCase() === "q") return "cancel";
-  return null;
-}
-
-function ReviewPanel({
-  previewState,
-  selectedTarget,
-}: {
-  previewState: PreviewState;
-  selectedTarget: LaunchTarget | null;
-}) {
-  if (previewState.status === "loading" || previewState.status === "idle") {
-    return <Text dimColor>Resolving launch preview…</Text>;
-  }
-
-  if (previewState.status === "error") {
-    return <Text color="red">{previewState.message}</Text>;
-  }
-
-  return (
-    <Box flexDirection="column">
-      <Text>Target: {selectedTarget}</Text>
-      <Text>Repository: {previewState.data.repositoryId}</Text>
-      <Text dimColor>{previewState.data.repositoryPath}</Text>
-      <Text>Companion:</Text>
-      <Text dimColor>{previewState.data.companionPath}</Text>
-    </Box>
-  );
-}
-
-function LaunchWizardApp({
-  activeIndex,
-  hasPreselectedTarget,
-  items,
-  previewState,
-  selectedTarget,
-  step,
-  totalSteps,
-  onMounted,
-}: LaunchWizardAppProps): React.JSX.Element {
-  useEffect(() => {
-    onMounted?.();
-  }, [onMounted]);
-
-  const stepNumber = hasPreselectedTarget ? 0 : step === "target" ? 0 : totalSteps - 1;
-  const title = step === "target" ? "Select launch target" : "Review launch";
-  const hint =
-    step === "target"
-      ? "↑↓ navigate · enter continue · q cancel"
-      : previewState.status === "error"
-        ? "enter retry · backspace previous · q cancel"
-        : previewState.status === "ready"
-          ? "enter launch · backspace previous · q cancel"
-          : "backspace previous · q cancel";
-
-  return (
-    <Box flexDirection="column" width="100%">
-      <WizardHeader title={title} step={stepNumber} totalSteps={totalSteps} />
-      <Box marginTop={1} flexDirection="column">
-        {step === "target" ? <SelectMenu items={items} activeIndex={activeIndex} /> : null}
-        {step === "review" ? (
-          <ReviewPanel previewState={previewState} selectedTarget={selectedTarget} />
-        ) : null}
-      </Box>
-      <WizardFooter hint={hint} />
-    </Box>
-  );
-}
-
-export async function runLaunchWizard(
-  options: LaunchWizardOptions,
-): Promise<LaunchWizardResult | null> {
-  const stdin = options.stdin ?? process.stdin;
-  const stdout = options.stdout ?? process.stdout;
-  const stderr = options.stderr ?? process.stderr;
-  if (!stdin.isTTY || !stdout.isTTY) {
-    throw new Error("Launch wizard requires a TTY.");
-  }
-
-  const allowedTargets = options.allowedTargets;
-  const preselectedTarget = options.preselectedTarget ?? null;
-  const items: SelectMenuItem[] = TARGET_ITEMS.map((item) => ({
-    ...item,
-    dimColor: allowedTargets ? !allowedTargets.has(item.key) : false,
-  }));
-  const firstEnabledIndex = items.findIndex((item) => !item.dimColor);
-  let activeIndex = preselectedTarget ? 0 : firstEnabledIndex < 0 ? 0 : firstEnabledIndex;
-  let step: WizardStep = preselectedTarget ? "review" : "target";
-  let selectedTarget: LaunchTarget | null = preselectedTarget;
-  let previewState: PreviewState = { status: "idle" };
-  let previewRequestId = 0;
-  let finalResult: LaunchWizardResult | null = null;
-  let resolved = false;
-  let rendered: ReturnType<typeof launchSelectorDeps.render> | undefined;
-
-  const totalSteps = preselectedTarget ? 1 : 2;
-
-  stdin.resume();
-  (stdin as NodeJS.ReadStream & { ref?: () => void }).ref?.();
-  const keepAlive = setInterval(() => {}, 1 << 30);
-
-  const cleanup = () => {
-    clearInterval(keepAlive);
-    stdin.off("data", onData);
-    stdin.pause();
-    stdin.setRawMode?.(false);
-    (stdin as NodeJS.ReadStream & { unref?: () => void }).unref?.();
-  };
-
-  const currentTarget = () => LAUNCH_TARGETS[activeIndex];
-  const isEnabled = (index: number) => !items[index]?.dimColor;
-  const nextEnabledIndex = (start: number, direction: 1 | -1): number => {
-    if (!items.some((item) => !item.dimColor)) return start;
-    let index = start;
-    for (let i = 0; i < items.length; i += 1) {
-      index = (index + direction + items.length) % items.length;
-      if (isEnabled(index)) return index;
-    }
-    return start;
-  };
-
-  const rerender = () => {
-    rendered?.rerender(
-      <LaunchWizardApp
-        activeIndex={activeIndex}
-        hasPreselectedTarget={!!preselectedTarget}
-        items={items}
-        previewState={previewState}
-        selectedTarget={selectedTarget}
-        step={step}
-        totalSteps={totalSteps}
-        onMounted={onMounted}
-      />,
-    );
-  };
-
-  const settle = (
-    value: LaunchWizardResult | null,
-    resolve: (value: LaunchWizardResult | null) => void,
-  ) => {
-    if (resolved) return;
-    resolved = true;
-    cleanup();
-    resolve(value);
-  };
-
-  const loadPreview = () => {
-    if (!selectedTarget) return;
-    const requestId = ++previewRequestId;
-    previewState = { status: "loading" };
-    rerender();
-
-    options
-      .resolvePreview(selectedTarget)
-      .then((preview) => {
-        if (requestId !== previewRequestId || resolved) return;
-        previewState = { status: "ready", data: preview };
-        rerender();
-      })
-      .catch((error: unknown) => {
-        if (requestId !== previewRequestId || resolved) return;
-        previewState = {
-          status: "error",
-          message: error instanceof Error ? error.message : String(error),
-        };
-        rerender();
-      });
-  };
-
-  const enterReview = () => {
-    step = "review";
-    loadPreview();
-  };
-
-  const onMounted = () => {
-    const buffered = stdin.read();
-    if (buffered) {
-      // Discard buffered input before the wizard becomes interactive.
-    }
-    stdin.on("data", onData);
-    if (step === "review") {
-      loadPreview();
-    }
-  };
-
-  const onData = (chunk: string) => {
-    const action = parseLaunchSelectorInput(chunk);
-    if (!action) return;
-    if (action === "cancel") {
-      finalResult = null;
-      rendered?.unmount();
-      return;
-    }
-    if (action === "back") {
-      if (step === "review") {
-        if (preselectedTarget) {
-          finalResult = null;
-          rendered?.unmount();
-        } else {
-          step = "target";
-          previewState = { status: "idle" };
-          rerender();
-        }
-        return;
-      }
-      return;
-    }
-    if (step === "review") {
-      if (action !== "submit") return;
-      if (previewState.status === "error") {
-        loadPreview();
-        return;
-      }
-      if (previewState.status !== "ready" || !selectedTarget) return;
-      finalResult = {
-        target: selectedTarget,
-        preview: previewState.data,
-      };
-      rendered?.unmount();
-      return;
-    }
-    if (action === "up" || action === "down") {
-      activeIndex = nextEnabledIndex(activeIndex, action === "up" ? -1 : 1);
-      rerender();
-      return;
-    }
-    if (action !== "submit") return;
-    if (!isEnabled(activeIndex)) return;
-    selectedTarget = currentTarget();
-    enterReview();
-  };
-
-  stdin.setEncoding("utf8");
-  stdin.setRawMode?.(true);
-
-  return new Promise<LaunchWizardResult | null>((resolve) => {
-    rendered = launchSelectorDeps.render(
-      <LaunchWizardApp
-        activeIndex={activeIndex}
-        hasPreselectedTarget={!!preselectedTarget}
-        items={items}
-        previewState={previewState}
-        selectedTarget={selectedTarget}
-        step={step}
-        totalSteps={totalSteps}
-        onMounted={onMounted}
-      />,
-      { stdin, stdout, stderr },
-    );
-
-    const finish = (value: LaunchWizardResult | null) => settle(value, resolve);
-
-    rendered.waitUntilExit().then(() => {
-      finish(finalResult);
-    });
-  });
-}