Function startServerAtDirAndGetPort

packages/server/src/api-extension.ts:8581–8683

(
    dir: string,
    port?: number,
  )

  }

  async function startServerAtDirAndGetPort(
    dir: string,
    port?: number,
  ): Promise<{ port: number } | { error: string }> {
    const absDir = resolve(expandTilde(dir));
    const lockDir = getLocalDir(absDir);

    const existingUi = readUiLock(lockDir);
    if (existingUi && existingUi.port > 0) {
      return { port: existingUi.port };
    }

    const [cmd, ...baseArgs] = localOpCliArgs;
    const buildArgs = (cliCmd: 'ui' | 'start'): string[] => {
      const portFlag =
        port !== undefined
          ? cliCmd === 'ui'
            ? ['--port', String(port)]
            : ['--ui-port', String(port)]
          : [];
      return [...baseArgs, cliCmd, ...portFlag];
    };

    const spawnAndAwaitUi = async (
      cliCmd: 'ui' | 'start',
    ): Promise<{ port: number } | { error: string; exited: boolean }> => {
      const child = spawn(cmd, buildArgs(cliCmd), {
        cwd: absDir,
        detached: true,
        stdio: ['ignore', 'ignore', 'pipe'],
        env: { ...process.env, OK_LOCK_KIND: 'interactive' },
      });

      const stderrChunks: Buffer[] = [];
      child.stderr?.on('data', (chunk: Buffer) => {
        stderrChunks.push(chunk);
        log.warn(
          { cwd: absDir, cliCmd, msg: chunk.toString('utf-8').trim() },
          '[local-op/clone] child stderr',
        );
      });

      let earlyExitCode: number | null = null;
      let earlyExitSignal: NodeJS.Signals | null = null;
      let spawnErrorMessage: string | null = null;
      child.on('exit', (code, signal) => {
        earlyExitCode = code ?? -1;
        earlyExitSignal = signal ?? null;
      });
      child.on('error', (err) => {
        spawnErrorMessage = err.message;
        earlyExitCode = -1;
        log.error(
          { cwd: absDir, cliCmd, err: err.message },
          '[local-op/clone] failed to spawn child',
        );
      });