Function runStartCommand

packages/cli/src/commands/start.ts:583–732

(config: Config, opts: StartCommandOptions)

}

export async function runStartCommand(config: Config, opts: StartCommandOptions): Promise<void> {
  const startConsoleLevel = resolveStartConsoleLevel(process.env);
  if (startConsoleLevel !== null) process.env.OK_CONSOLE_LEVEL = startConsoleLevel;

  const { renderBanner } = await import('../ui/banner.ts');
  const { accent, dim, error, warning } = await import('../ui/colors.ts');

  const cwd = process.cwd();
  const activeConfig = config;

  process.title = deriveServerProcessTitle(cwd);

  const host = resolveHost(opts, process.env as { HOST?: string | undefined });
  const portFromCli = opts.port !== undefined ? Number(opts.port) : undefined;
  const portFromEnv = process.env.PORT ? Number(process.env.PORT) : undefined;
  const requestedUiPort = opts.uiPort !== undefined ? Number(opts.uiPort) : undefined;
  const port = resolveCollabPort(portFromCli, portFromEnv, requestedUiPort);

  if (requestedUiPort !== undefined) {
    const { readServerLock, resolveLockDir } = await import('@inkeep/open-knowledge-server');
    const liveServer = readServerLock(resolveLockDir(cwd));
    if (shouldConnectToExistingServer(requestedUiPort, liveServer)) {
      await connectUiSibling({ cwd, uiPort: requestedUiPort });
      return;
    }
  }

  let booted: BootedStartServer;
  try {
    booted = await bootStartServer({
      config: activeConfig,
      cwd,
      host,
      port,
      ...(requestedUiPort !== undefined ? { uiPort: requestedUiPort } : {}),
      ...(opts.serveContentAssets ? { serveContentAssets: true } : {}),
      ...(opts.reactShellDistDir ? { reactShellDistDir: opts.reactShellDistDir } : {}),
      ...(opts.singleFile ? { singleFile: opts.singleFile } : {}),
      ...(opts.projectDir ? { projectDir: opts.projectDir } : {}),
    });
  } catch (err) {
    if (err instanceof OkDirMissingError) {
      console.error(error(err.message));
      process.exit(1);
    }

    const serverModule = await import('@inkeep/open-knowledge-server');
    if (
      err instanceof serverModule.GitNotAvailableError ||
      err instanceof serverModule.GitTooOldError
    ) {
      process.exit(78);
    }

    if (
      err instanceof serverModule.SingleFileNotFoundError ||
      err instanceof serverModule.SingleFileNotAFileError ||
      err instanceof serverModule.SingleFileNotMarkdownError