Function run

e2e/scripts/cli.ts:192–353

(target: "selfhost" | "cloud", flags: ReadonlySet<string>)

// The detached runner: boots the target, owns it (cloud's emulators live in
// this process), writes the state file, and tears down on SIGTERM.
const run = async (target: "selfhost" | "cloud", flags: ReadonlySet<string>) => {
  const share = flags.has("--share");
  const logFile = process.env.E2E_CLI_LOG ?? join(devDir, `${target}.log`);
  const base: Omit<InstanceState, "status"> = {
    target,
    runnerPid: process.pid,
    logFile,
    startedAt: new Date().toISOString(),
  };
  writeState({ ...base, status: "starting" });

  try {
    let state: InstanceState;
    let teardown: () => Promise<void>;

    // Claim ports atomically from this checkout's block (src/ports.ts) — the
    // held block lock doubles as "this instance is deliberate, not a leak",
    // and a concurrently running vitest suite walks to its own block.
    const { claimPorts } = await import("../src/ports");

    if (target === "selfhost") {
      const { bootSelfhost } = await import("../setup/selfhost.boot");
      const claim = await claimPorts([
        { envVar: "E2E_SELFHOST_PORT", offset: 4, label: "selfhost vite dev (cli)" },
      ]);
      const port = claim.ports.E2E_SELFHOST_PORT!;
      const ip = share ? tailnetIp() : undefined;
      const baseUrl = ip ? `http://${ip}:${port}` : `http://localhost:${port}`;
      const admin = { email: "admin@e2e.test", password: "e2e-admin-password-123" };
      const booted = await bootSelfhost({
        port,
        webBaseUrl: baseUrl,
        admin,
        host: share ? "0.0.0.0" : undefined,
        fresh: !flags.has("--keep-data"),
        logFile,
      });
      teardown = async () => {
        await booted.teardown();
        await claim.release();
      };
      state = {
        ...base,
        status: "ready",
        childPids: booted.pids,
        env: {
          E2E_TARGET: "selfhost",
          E2E_SELFHOST_URL: baseUrl,
          E2E_SELFHOST_ADMIN_EMAIL: admin.email,
          E2E_SELFHOST_ADMIN_PASSWORD: admin.password,
        },
        urls: { app: baseUrl },
        admin,
      };
    } else {
      const { bootCloud } = await import("../setup/cloud.boot");
      const claim = await claimPorts([
        { envVar: "E2E_CLOUD_PORT", offset: 0, label: "cloud vite dev (cli)" },