git-muster 0.4.1__tar.gz → 0.5.0__tar.gz

{git_muster-0.4.1 → git_muster-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-muster
-Version: 0.4.1
+Version: 0.5.0
 Summary: See every local Git branch and what needs attention
 Keywords: branch,cli,git,github,worktree
 Author: Dan O'Leary
@@ -123,7 +123,7 @@ git muster --version
 
 ### Color, symbols, and width
 
-Color, Unicode symbols, and clickable pull-request numbers appear when the report is written to an interactive terminal that can render them. Git Muster honors the usual overrides:
+Color, Unicode symbols, clickable repository identities, and clickable pull-request numbers appear when the report is written to an interactive terminal that can render them. GitHub repositories appear as `owner / repository`, with the owner and repository linked separately. The title includes `[public]`, `[private]`, or `[internal]` when GitHub reports visibility, `[fork]` when the repository is a fork, and `[archived]` when it is archived. A fork label links to its parent repository. Git Muster resolves the repository from `origin`, or another GitHub remote when `origin` is not hosted there, and honors the usual overrides:
 
 | Variable | Effect |
 |---|---|
@@ -157,7 +157,7 @@ Publication is deliberately separate from Git's configured upstream. A branch is
 
 When another linked worktree holds a branch, Git Muster shows its directory in the table and lists the full checkout path below it. It does not scan those other worktrees for dirtiness or change them.
 
-GitHub integration uses one optional `gh pr list --state all --limit 100` query, so a branch whose pull request falls outside the hundred most recent is reported without pull-request state. When several pull requests share a head branch, the newest open, draft, approved, or changes-requested one wins over closed and merged ones. Without an installed and authenticated `gh`, or when no remote points at a known GitHub host, the complete Git report still works and names the reason pull-request state is missing.
+GitHub integration uses one `gh repo view` query for canonical identity, visibility, fork parent, and archive state, plus one optional `gh pr list --state all --limit 100` query for pull requests. A branch whose pull request falls outside the hundred most recent is reported without pull-request state. When several pull requests share a head branch, the newest open, draft, approved, or changes-requested one wins over closed and merged ones. Without an installed and authenticated `gh`, or when no remote points at a known GitHub host, the complete Git report still works, falls back to identity parsed from the remote URL, omits metadata it cannot establish, and names the reason pull-request state is missing.
 
 ## Safety and scope
 

{git_muster-0.4.1 → git_muster-0.5.0}/README.md

@@ -99,7 +99,7 @@ git muster --version
 
 ### Color, symbols, and width
 
-Color, Unicode symbols, and clickable pull-request numbers appear when the report is written to an interactive terminal that can render them. Git Muster honors the usual overrides:
+Color, Unicode symbols, clickable repository identities, and clickable pull-request numbers appear when the report is written to an interactive terminal that can render them. GitHub repositories appear as `owner / repository`, with the owner and repository linked separately. The title includes `[public]`, `[private]`, or `[internal]` when GitHub reports visibility, `[fork]` when the repository is a fork, and `[archived]` when it is archived. A fork label links to its parent repository. Git Muster resolves the repository from `origin`, or another GitHub remote when `origin` is not hosted there, and honors the usual overrides:
 
 | Variable | Effect |
 |---|---|
@@ -133,7 +133,7 @@ Publication is deliberately separate from Git's configured upstream. A branch is
 
 When another linked worktree holds a branch, Git Muster shows its directory in the table and lists the full checkout path below it. It does not scan those other worktrees for dirtiness or change them.
 
-GitHub integration uses one optional `gh pr list --state all --limit 100` query, so a branch whose pull request falls outside the hundred most recent is reported without pull-request state. When several pull requests share a head branch, the newest open, draft, approved, or changes-requested one wins over closed and merged ones. Without an installed and authenticated `gh`, or when no remote points at a known GitHub host, the complete Git report still works and names the reason pull-request state is missing.
+GitHub integration uses one `gh repo view` query for canonical identity, visibility, fork parent, and archive state, plus one optional `gh pr list --state all --limit 100` query for pull requests. A branch whose pull request falls outside the hundred most recent is reported without pull-request state. When several pull requests share a head branch, the newest open, draft, approved, or changes-requested one wins over closed and merged ones. Without an installed and authenticated `gh`, or when no remote points at a known GitHub host, the complete Git report still works, falls back to identity parsed from the remote URL, omits metadata it cannot establish, and names the reason pull-request state is missing.
 
 ## Safety and scope
 

{git_muster-0.4.1 → git_muster-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "git-muster"
-version = "0.4.1"
+version = "0.5.0"
 description = "See every local Git branch and what needs attention"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"

{git_muster-0.4.1 → git_muster-0.5.0}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "git-muster"
-version = "0.4.1"
+version = "0.5.0"
 description = "See every local Git branch and what needs attention"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"

{git_muster-0.4.1 → git_muster-0.5.0}/src/git_muster/cli.py

@@ -12,6 +12,7 @@ from collections.abc import Callable
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Annotated, Any
+from urllib.parse import urlsplit
 
 import typer
 from rich.console import Console
@@ -81,6 +82,7 @@ ASCII_GLYPHS = {
 
 PR_LIMIT = 100
 PR_FIELDS = "headRefName,number,state,isDraft,reviewDecision,url"
+REPOSITORY_FIELDS = "nameWithOwner,url,visibility,isFork,parent,isArchived"
 ACTIVE_PR_STATES = {"draft", "open", "approved", "changes requested"}
 
 PR_NOTICES: dict[str, tuple[str, ...]] = {
@@ -242,6 +244,19 @@ class PullRequest:
     url: str = ""
 
 
+@dataclass(frozen=True)
+class GitHubRepository:
+    """GitHub identity and presentation metadata for the current repository."""
+
+    owner: str
+    name: str
+    url: str
+    visibility: str = ""
+    is_fork: bool = False
+    parent_url: str = ""
+    is_archived: bool = False
+
+
 @dataclass(frozen=True)
 class Branch:
     """Collected status for one local branch."""
@@ -268,6 +283,90 @@ def hyperlink(text: str, url: str, *, enabled: bool) -> str:
     return f"\033]8;;{url}\033\\{underlined}\033]8;;\033\\"
 
 
+def github_repository_url(remote_url: str) -> str:
+    """Turn a GitHub clone URL into its canonical HTTPS repository page."""
+    scp_match = re.fullmatch(r"(?:[^@/:]+@)?([^/:]+):(.+)", remote_url)
+    if scp_match and "://" not in remote_url:
+        host, path = scp_match.groups()
+    else:
+        parsed = urlsplit(remote_url)
+        if parsed.scheme not in {"git", "http", "https", "ssh"}:
+            return ""
+        host, path = parsed.hostname or "", parsed.path
+
+    if host.lower() != "github.com":
+        return ""
+    path = path.strip("/")
+    if path.endswith(".git"):
+        path = path[:-4]
+    if not re.fullmatch(r"[-A-Za-z0-9_.]+/[-A-Za-z0-9_.]+", path):
+        return ""
+    return f"https://github.com/{path}"
+
+
+def repository_github_url(remotes: set[str]) -> str:
+    """Find the repository page, preferring the conventional origin remote."""
+    for remote in sorted(remotes, key=lambda name: (name != "origin", name)):
+        remote_url = command_output("git", "remote", "get-url", remote) or ""
+        if url := github_repository_url(remote_url):
+            return url
+    return ""
+
+
+def github_repository(repository_url: str) -> GitHubRepository:
+    """Read repository metadata from GitHub, retaining URL-derived identity on failure."""
+    owner, name = urlsplit(repository_url).path.strip("/").split("/", 1)
+    fallback = GitHubRepository(owner, name, repository_url)
+    result = command_result("gh", "repo", "view", f"{owner}/{name}", "--json", REPOSITORY_FIELDS)
+    if result is None or result[0] != 0:
+        return fallback
+    try:
+        payload = json.loads(result[1])
+    except (json.JSONDecodeError, TypeError, ValueError):
+        return fallback
+    if not isinstance(payload, dict):
+        return fallback
+
+    canonical_url = github_repository_url(str(payload.get("url", ""))) or repository_url
+    canonical_name = payload.get("nameWithOwner")
+    if isinstance(canonical_name, str) and re.fullmatch(
+        r"[-A-Za-z0-9_.]+/[-A-Za-z0-9_.]+", canonical_name
+    ):
+        owner, name = canonical_name.split("/", 1)
+        canonical_url = f"https://github.com/{canonical_name}"
+    else:
+        owner, name = urlsplit(canonical_url).path.strip("/").split("/", 1)
+
+    visibility = payload.get("visibility")
+    visibility = (
+        visibility.lower()
+        if isinstance(visibility, str) and visibility.upper() in {"PUBLIC", "PRIVATE", "INTERNAL"}
+        else ""
+    )
+
+    parent_url = ""
+    parent = payload.get("parent")
+    if isinstance(parent, dict):
+        parent_url = github_repository_url(str(parent.get("url", "")))
+        parent_name = parent.get("nameWithOwner")
+        if (
+            not parent_url
+            and isinstance(parent_name, str)
+            and re.fullmatch(r"[-A-Za-z0-9_.]+/[-A-Za-z0-9_.]+", parent_name)
+        ):
+            parent_url = f"https://github.com/{parent_name}"
+
+    return GitHubRepository(
+        owner=owner,
+        name=name,
+        url=canonical_url,
+        visibility=visibility,
+        is_fork=payload.get("isFork") is True,
+        parent_url=parent_url,
+        is_archived=payload.get("isArchived") is True,
+    )
+
+
 def pull_request_status(row: dict[str, object]) -> str:
     """Normalize GitHub's PR and review fields into a compact status."""
     state = str(row.get("state", "")).upper()
@@ -491,6 +590,8 @@ def run_report(*, no_fetch: bool = False, plain: bool = False) -> int:
         if not symref
     }
     remotes = set(git_output("remote").splitlines())
+    repo_url = repository_github_url(remotes)
+    github_repo = github_repository(repo_url) if repo_url else None
 
     raw_branches = git_output(
         "for-each-ref",
@@ -624,7 +725,23 @@ def run_report(*, no_fetch: bool = False, plain: bool = False) -> int:
     behind_count = sum("behind" in branch.state_text for branch in branches)
 
     print()
-    print(bold(repo_name) + dim(" :: ") + bold(current or "detached HEAD"))
+    if github_repo:
+        owner_url = f"https://github.com/{github_repo.owner}"
+        rendered_repo = (
+            bold(hyperlink(github_repo.owner, owner_url, enabled=use_links))
+            + dim(" / ")
+            + bold(hyperlink(github_repo.name, github_repo.url, enabled=use_links))
+        )
+        if github_repo.visibility:
+            rendered_repo += dim(f" [{github_repo.visibility}]")
+        if github_repo.is_fork:
+            fork_label = hyperlink("[fork]", github_repo.parent_url, enabled=use_links)
+            rendered_repo += " " + dim(fork_label)
+        if github_repo.is_archived:
+            rendered_repo += " " + yellow("[archived]")
+    else:
+        rendered_repo = bold(repo_name)
+    print(rendered_repo + dim(" :: ") + bold(current or "detached HEAD"))
     separator = glyph["separator"]
     worktree = (
         yellow(f"dirty: {f' {separator} '.join(worktree_parts)}") if dirty_lines else green("clean")