@spec build_git_opts(binary(), integer() | nil) :: keyword()

Builds git options for a repository path and optional timeout.

@spec gh_available?() :: boolean()

Checks if gh is available.

@spec glab_available?() :: boolean()

Checks if glab is available.

@spec has_uncommitted_changes?(binary()) :: boolean()

Checks if a repository has uncommitted changes.

@spec run_git(
  [binary()],
  keyword()
) :: {:ok, map()} | {:error, any()}

Runs a git command with options.

Builds a shell-quoted command line from git_args and dispatches it via run_system_cmd/3.

@spec run_system_cmd(binary(), binary(), keyword()) :: {:ok, map()} | {:error, any()}

Runs a system command with telemetry instrumentation.

Emits [:apero, :git, :command, :start|:stop|:error] telemetry events.

@spec setup_credential_helper(binary()) :: :ok | {:error, binary()}

Sets up a credential helper for git.

@spec setup_credentials(keyword()) :: :ok | {:error, binary()}

Configures Git credentials (SSH key path or credential helper).

@spec setup_ssh_key(binary()) :: :ok | {:error, binary()}

Sets up an SSH key for git.

@spec shell_quote(binary()) :: binary()

Quotes a binary string for safe shell use.