Function runSymbolicRef

packages/computer/src/git/cli.ts:948–990

(
  client: GitClient,
  args: string[],
  input: GitCliInput,
)

// ---------------------------------------------------------------

async function runSymbolicRef(
  client: GitClient,
  args: string[],
  input: GitCliInput,
): Promise<GitCliResult> {
  // Limited surface: only `git symbolic-ref HEAD` and the bare
  // `git symbolic-ref` (which behaves like the previous form).
  const parsed = parseFlags(args, {
    short: { kind: "bool" },
    quiet: { kind: "bool", alias: ["q"] },
  });
  if ("error" in parsed) {
    return { stdout: "", stderr: `git symbolic-ref: ${parsed.error}\n`, exitCode: 129 };
  }
  const ref = parsed.positional[0] ?? "HEAD";
  if (ref !== "HEAD") {
    return {
      stdout: "",
      stderr: `git symbolic-ref: only HEAD is supported (got ${JSON.stringify(ref)})\n`,
      exitCode: 129,
    };
  }
  const dir = resolveDir(undefined, input.cwd);
  try {
    const name = await client.currentBranch({
      dir,
      fullname: parsed.flags.short !== true,
    });
    if (name === undefined) {
      // Detached HEAD: real git exits 1 with empty stdout when
      // --quiet, otherwise an error message.
      if (parsed.flags.quiet) return { stdout: "", stderr: "", exitCode: 1 };
      return {
        stdout: "",
        stderr: "git symbolic-ref: ref HEAD is not a symbolic ref\n",
        exitCode: 1,
      };
    }
    return { stdout: `${name}\n`, stderr: "", exitCode: 0 };
  } catch (cause) {
    return mapGitError("symbolic-ref", cause);
  }
}

// ---------------------------------------------------------------
// ls-files