Fix Repo.active_branch resolution for reftable-backed repositories

[Copilot]

GitPython currently infers the active branch from ref files directly, which breaks on repositories using Git’s reftable ref storage and can surface refs/heads/.invalid as the active branch. This PR switches active-branch resolution to Git’s symbolic-ref plumbing so behavior stays correct across ref backends.

• Active branch resolution

  • Replaced Repo.active_branch’s direct HEAD reference dereference path with git symbolic-ref -q HEAD.
  • Constructs Head from the resolved symbolic ref path returned by Git.
  • Preserves detached-HEAD semantics by translating symbolic-ref’s non-symbolic result into the existing TypeError behavior.

• Regression coverage

  • Added a reftable-specific test for empty repositories that validates:
    • repo.active_branch.path matches git symbolic-ref HEAD
    • repo.active_branch.name matches git symbolic-ref --short HEAD
  • Added a detached-HEAD test asserting Repo.active_branch raises TypeError with the expected detached-reference message.

@property
def active_branch(self) -> Head:
    try:
        return Head(self, self.git.symbolic_ref("-q", "HEAD").strip())
    except GitCommandError as err:
        if err.status == 1:
            raise TypeError("HEAD is a detached symbolic reference as it points to a commit") from err
        raise

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This PR aims to make Repo.active_branch work correctly on repositories using Git’s reftable ref backend (where filesystem-based ref parsing can misidentify the active branch).

Changes:

• Added a guard in Repo.active_branch that raises ValueError when the resolved branch name is .invalid.
• Added tests asserting Repo.active_branch raises ValueError when HEAD points at refs/heads/.invalid (including a reftable init case).
• Added a detached-HEAD regression test asserting Repo.active_branch raises TypeError.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
git/repo/base.py	Adds .invalid detection and raises ValueError instead of resolving via git plumbing.
test/test_repo.py	Adds tests for .invalid HEAD and detached HEAD behavior (currently expecting exceptions).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.