Function ensureProjectGit

packages/server/src/project-git.ts:42–121

(projectRoot: string)

}

export async function ensureProjectGit(projectRoot: string): Promise<EnsureProjectGitResult> {
  const abs = resolve(projectRoot);
  const gitPath = resolve(abs, '.git');
  const headPath = resolve(gitPath, 'HEAD');

  let needsRepair = false;
  if (existsSync(gitPath)) {
    if (!statSync(gitPath).isDirectory()) {
      return { didInit: false };
    }
    if (existsSync(headPath)) {
      return { didInit: false };
    }
    log.info({}, 'detected partial .git/ — running git init to repair');
    needsRepair = true;
  }

  let detected: GitDetected;
  try {
    detected = assertGitAvailable();
  } catch (err) {
    if (err instanceof GitNotAvailableError || err instanceof GitTooOldError) {
      emitPreflightFailureSpan(err);
      log.warn(
        {
          event: 'git_preflight_fail',
          platform: err.platform,
          reason: err instanceof GitTooOldError ? 'too_old' : 'not_available',
          detectedVersion: err instanceof GitTooOldError ? err.detected : '',
        },
        err instanceof GitTooOldError ? 'git binary too old' : 'git binary not found',
      );
    } else {
      log.warn(
        {
          event: 'git_preflight_unexpected_error',
          message: err instanceof Error ? err.message : String(err),
        },
        'unexpected error during git preflight',
      );
    }
    throw err;
  }
  const gitBin = detected.resolvedPath;

  if (!needsRepair && (await isInsideExistingWorkTree(gitBin, abs))) {
    return { didInit: false };
  }

  let stderr = '';
  try {
    const result = await execFileAsync(gitBin, ['init', '--initial-branch=main', abs]);
    stderr = result.stderr ?? '';
  } catch (err) {
    const capturedStderr =
      err !== null && typeof err === 'object' && 'stderr' in err
        ? String((err as { stderr: unknown }).stderr ?? '')
        : '';