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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-muster
-Version: 0.4.0
+Version: 0.5.0
 Summary: See every local Git branch and what needs attention
 Keywords: branch,cli,git,github,worktree
 Author: Dan O'Leary
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Version Control :: Git
-Requires-Dist: rich>=14,<15
+Requires-Dist: rich>=14,<16
 Requires-Dist: typer>=0.27,<0.28
 Requires-Python: >=3.13, <3.15
 Project-URL: Homepage, https://github.com/olearydj/git-muster
@@ -57,7 +57,7 @@ BRANCH (4 local)      REMOTE  STATE          WORKTREE       UPDATED  PULL REQUES
 - Conditional linked-worktree names and checkout paths.
 - Draft, open, approved, changes-requested, merged, and closed GitHub pull requests.
 - Clickable, underlined PR numbers in supported interactive terminals.
-- Responsive terminal layout plus stable ASCII output for logs and pipes.
+- Responsive terminal layout plus stable plain output with ASCII interface glyphs for logs and pipes.
 - Read-only operation with `--no-fetch`; no branch switching, deletion, merging, rebasing, or pushing.
 
 ## Requirements
@@ -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 |
 |---|---|
@@ -131,7 +131,7 @@ Color, Unicode symbols, and clickable pull-request numbers appear when the repor
 | `FORCE_COLOR`, `CLICOLOR_FORCE` | Keep color when output is redirected to a file or pipe. |
 | `COLUMNS` | Overrides the detected terminal width used to fit columns. |
 
-`--plain` overrides all of them and emits pure ASCII, without color or terminal hyperlinks. Git Muster also falls back to those ASCII glyphs on its own whenever the destination stream cannot encode its symbols, so redirected output never fails to encode.
+`--plain` overrides all of them and uses ASCII interface glyphs without color or terminal hyperlinks. Repository-provided text, including branch, remote, and worktree names, is preserved and may contain Unicode. Git Muster also falls back to the ASCII glyph set on its own whenever the destination stream cannot encode its symbols, so its built-in decorations never cause an encoding failure.
 
 ## Reading the report
 
@@ -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.0 → git_muster-0.5.0}/README.md

@@ -33,7 +33,7 @@ BRANCH (4 local)      REMOTE  STATE          WORKTREE       UPDATED  PULL REQUES
 - Conditional linked-worktree names and checkout paths.
 - Draft, open, approved, changes-requested, merged, and closed GitHub pull requests.
 - Clickable, underlined PR numbers in supported interactive terminals.
-- Responsive terminal layout plus stable ASCII output for logs and pipes.
+- Responsive terminal layout plus stable plain output with ASCII interface glyphs for logs and pipes.
 - Read-only operation with `--no-fetch`; no branch switching, deletion, merging, rebasing, or pushing.
 
 ## Requirements
@@ -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 |
 |---|---|
@@ -107,7 +107,7 @@ Color, Unicode symbols, and clickable pull-request numbers appear when the repor
 | `FORCE_COLOR`, `CLICOLOR_FORCE` | Keep color when output is redirected to a file or pipe. |
 | `COLUMNS` | Overrides the detected terminal width used to fit columns. |
 
-`--plain` overrides all of them and emits pure ASCII, without color or terminal hyperlinks. Git Muster also falls back to those ASCII glyphs on its own whenever the destination stream cannot encode its symbols, so redirected output never fails to encode.
+`--plain` overrides all of them and uses ASCII interface glyphs without color or terminal hyperlinks. Repository-provided text, including branch, remote, and worktree names, is preserved and may contain Unicode. Git Muster also falls back to the ASCII glyph set on its own whenever the destination stream cannot encode its symbols, so its built-in decorations never cause an encoding failure.
 
 ## Reading the report
 
@@ -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.0 → git_muster-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "git-muster"
-version = "0.4.0"
+version = "0.5.0"
 description = "See every local Git branch and what needs attention"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"
@@ -27,7 +27,7 @@ classifiers = [
     "Topic :: Software Development :: Version Control :: Git",
 ]
 dependencies = [
-    "rich>=14,<15",
+    "rich>=14,<16",
     "typer>=0.27,<0.28",
 ]
 

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

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "git-muster"
-version = "0.4.0"
+version = "0.5.0"
 description = "See every local Git branch and what needs attention"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"
@@ -21,7 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Version Control :: Git",
 ]
-dependencies = ["rich>=14,<15", "typer>=0.27,<0.28"]
+dependencies = ["rich>=14,<16", "typer>=0.27,<0.28"]
 
 [project.scripts]
 git-muster = "git_muster.cli:entrypoint"

{git_muster-0.4.0 → 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
@@ -38,7 +39,7 @@ EPILOG = """
   Use the remote-tracking data already on disk.
 
   [cyan]git muster --plain[/cyan]
-  Emit stable ASCII output without color for logs and pipes.
+  Emit stable output with ASCII decorations and no color for logs and pipes.
 
 [bold]Linked worktrees[/bold]
 
@@ -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()
@@ -315,7 +414,10 @@ def github_pull_requests() -> tuple[list[dict[str, object]], str | None]:
         return [], "unusable"
     if not isinstance(parsed, list):
         return [], "unusable"
-    return [row for row in parsed if isinstance(row, dict)], None
+    rows = [row for row in parsed if isinstance(row, dict)]
+    if parsed and not rows:
+        return [], "unusable"
+    return rows, None
 
 
 def parse_track(track: str) -> tuple[int, int] | None:
@@ -488,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",
@@ -621,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")
@@ -747,7 +867,10 @@ def main(
         bool,
         typer.Option(
             "--plain",
-            help="Disable color and Unicode symbols for stable logs and pipes.",
+            help=(
+                "Disable color, hyperlinks, and Unicode interface symbols for stable logs and "
+                "pipes. Repository-provided text is preserved."
+            ),
             rich_help_panel="Report options",
         ),
     ] = False,