repocheck-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repocheck-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Scan any GitHub repo and get an instant engineering health report card.
 Author: Syed Ahmed Ali
 License-Expression: MIT
@@ -22,6 +22,8 @@ Dynamic: license-file
 
 # repocheck
 
+[![PyPI](https://img.shields.io/pypi/v/repocheck-cli)](https://pypi.org/project/repocheck-cli/)
+
 Scan any public GitHub repo and get an instant engineering health report card — README quality, CI/CD, test presence, dependency hygiene, license, commit activity, and issue hygiene, scored A–F.
 
 ```

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/README.md

@@ -1,5 +1,7 @@
 # repocheck
 
+[![PyPI](https://img.shields.io/pypi/v/repocheck-cli)](https://pypi.org/project/repocheck-cli/)
+
 Scan any public GitHub repo and get an instant engineering health report card — README quality, CI/CD, test presence, dependency hygiene, license, commit activity, and issue hygiene, scored A–F.
 
 ```

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "repocheck-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Scan any GitHub repo and get an instant engineering health report card."
 readme = "README.md"
 requires-python = ">=3.9"

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/repocheck/checks.py

@@ -282,6 +282,112 @@ def check_issue_hygiene(client: GitHubClient, ref: RepoRef) -> CheckResult:
     return _result("Issue Hygiene", score, details)
 
 
+def check_security(client: GitHubClient, ref: RepoRef) -> CheckResult:
+    root_files = client.root_files(ref)
+    github_contents = client.contents(ref, ".github") or []
+    github_names = [item["name"].lower() for item in github_contents if isinstance(github_contents, list)]
+
+    details = []
+    score = 0
+
+    has_security_md = any(f.lower() == "security.md" for f in root_files)
+    if has_security_md:
+        score += 40
+        details.append("SECURITY.md present — vulnerability disclosure policy defined.")
+    else:
+        details.append("No SECURITY.md — add one to define how to report vulnerabilities.")
+
+    has_dependabot = "dependabot.yml" in github_names or "dependabot.yaml" in github_names
+    if has_dependabot:
+        score += 35
+        details.append("dependabot.yml configured — automated dependency updates enabled.")
+    else:
+        details.append("No dependabot.yml — consider adding automated dependency updates.")
+
+    has_codeowners = "codeowners" in [f.lower() for f in root_files] or "codeowners" in github_names
+    if has_codeowners:
+        score += 25
+        details.append("CODEOWNERS file found — code review ownership defined.")
+    else:
+        details.append("No CODEOWNERS file.")
+
+    return _result("Security", score, details)
+
+
+def check_contributing(client: GitHubClient, ref: RepoRef) -> CheckResult:
+    files = client.root_files(ref)
+    contrib_file = next((f for f in files if f.lower().startswith("contributing")), None)
+
+    if not contrib_file:
+        return _result("Contributing Guide", 0, ["No CONTRIBUTING.md — makes it harder for others to contribute."], weight=0.75)
+
+    text = client.file_text(ref, contrib_file) or ""
+    details = [f"CONTRIBUTING.md found ({len(text)} chars)."]
+    score = 70
+    if len(text) > 500:
+        score += 30
+        details.append("Substantive contribution guide (>500 chars).")
+    else:
+        details.append("Short contribution guide — consider expanding.")
+
+    return _result("Contributing Guide", score, details, weight=0.75)
+
+
+def check_docker(client: GitHubClient, ref: RepoRef) -> CheckResult:
+    files = [f.lower() for f in client.root_files(ref)]
+    details = []
+    score = 0
+
+    if "dockerfile" in files:
+        score += 60
+        details.append("Dockerfile found.")
+
+    if "docker-compose.yml" in files or "docker-compose.yaml" in files:
+        score += 40
+        details.append("docker-compose.yml found.")
+
+    deploy_hints = ["railway.json", "heroku.yml", "render.yaml", "fly.toml", "vercel.json", "netlify.toml"]
+    found_deploy = [f for f in deploy_hints if f in files]
+    if found_deploy:
+        score = max(score, 50)
+        details.append(f"Deployment config found: {', '.join(found_deploy)}.")
+
+    if score == 0:
+        details.append("No Docker or deployment configuration found.")
+
+    return _result("Docker/Deploy", score, details, weight=0.5)
+
+
+def check_branch_protection(client: GitHubClient, ref: RepoRef) -> CheckResult:
+    protection = client.branch_protection(ref, "main") or client.branch_protection(ref, "master")
+
+    if protection is None:
+        return _result("Branch Protection", 0, ["No branch protection on main/master — anyone can push directly."], weight=0.75)
+
+    details = []
+    score = 40
+
+    required_reviews = protection.get("required_pull_request_reviews")
+    if required_reviews:
+        count = required_reviews.get("required_approving_review_count", 1)
+        score += 30
+        details.append(f"PR reviews required ({count} approver(s)).")
+    else:
+        details.append("No required PR reviews.")
+
+    if protection.get("required_status_checks"):
+        score += 20
+        details.append("Required status checks configured.")
+    else:
+        details.append("No required status checks.")
+
+    if protection.get("enforce_admins", {}).get("enabled"):
+        score += 10
+        details.append("Protection enforced for admins too.")
+
+    return _result("Branch Protection", score, details, weight=0.75)
+
+
 CHECKS: list[Callable[[GitHubClient, RepoRef], CheckResult]] = [
     check_readme,
     check_ci,
@@ -290,4 +396,8 @@ CHECKS: list[Callable[[GitHubClient, RepoRef], CheckResult]] = [
     check_license,
     check_activity,
     check_issue_hygiene,
+    check_security,
+    check_contributing,
+    check_docker,
+    check_branch_protection,
 ]

repocheck_cli-0.2.0/repocheck/cli.py

@@ -0,0 +1,247 @@
+"""repocheck CLI."""
+from __future__ import annotations
+
+import json
+import os
+import sys
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+from .github_client import GitHubClient, GitHubError, RepoRef, parse_repo_arg
+from .history import get_last_run, save_run
+from .report import run_report
+
+console = Console()
+
+GRADE_COLORS = {
+    "A": "green",
+    "B": "cyan",
+    "C": "yellow",
+    "D": "orange3",
+    "F": "red",
+}
+
+
+def _grade_text(grade: str) -> Text:
+    color = GRADE_COLORS.get(grade, "white")
+    return Text(grade, style=f"bold {color}")
+
+
+def _render(report, verbose: bool, last_run: dict | None = None) -> None:
+    grade_color = GRADE_COLORS.get(report.overall_grade, "white")
+    header = Text()
+    header.append(f"{report.repo.full_name}\n", style="bold")
+    header.append(f"★ {report.repo_meta.get('stargazers_count', 0)}  ", style="dim")
+    header.append(f"⑂ {report.repo_meta.get('forks_count', 0)}  ", style="dim")
+    header.append(f"{report.repo_meta.get('language') or 'unknown'}", style="dim")
+
+    score_text = Text()
+    score_text.append(f"{report.overall_score}/100  ", style=f"bold {grade_color}")
+    score_text.append(f"({report.overall_grade})", style=f"bold {grade_color}")
+
+    if last_run:
+        diff = report.overall_score - last_run["score"]
+        sign = "+" if diff >= 0 else ""
+        color = "green" if diff > 0 else ("red" if diff < 0 else "dim")
+        score_text.append(f"  {sign}{diff} since last run", style=color)
+
+    console.print(Panel(header, title="repo", expand=False))
+    console.print(Panel(score_text, title="overall health score", expand=False))
+
+    table = Table(show_header=True, header_style="bold")
+    table.add_column("Check")
+    table.add_column("Score", justify="right")
+    table.add_column("Grade", justify="center")
+    if verbose:
+        table.add_column("Details")
+
+    for check in report.checks:
+        score_str = str(check.score)
+        if last_run and check.name in last_run.get("checks", {}):
+            prev = last_run["checks"][check.name]
+            diff = check.score - prev
+            if diff != 0:
+                sign = "+" if diff > 0 else ""
+                color = "green" if diff > 0 else "red"
+                score_str = f"{check.score} [{color}]({sign}{diff})[/{color}]"
+
+        row = [check.name, score_str, _grade_text(check.grade)]
+        if verbose:
+            row.append("\n".join(f"• {d}" for d in check.details))
+        table.add_row(*row)
+
+    console.print(table)
+
+    if not verbose:
+        console.print("[dim]Run with -v for detailed reasoning behind each score.[/dim]")
+
+    if not os.environ.get("GITHUB_TOKEN"):
+        console.print(
+            "[dim]Tip: set GITHUB_TOKEN to raise your API rate limit from 60/hr to 5000/hr.[/dim]"
+        )
+
+
+def _render_fix(report) -> None:
+    suggestions = report.fix_suggestions()
+    if not suggestions:
+        console.print("[green bold]Nothing to fix — all checks are at 90+![/green bold]")
+        return
+
+    console.print(f"\n[bold]Fix checklist for {report.repo.full_name}[/bold]\n")
+    for check_name, hints in suggestions:
+        check = next(c for c in report.checks if c.name == check_name)
+        color = GRADE_COLORS.get(check.grade, "white")
+        console.print(f"[{color}]{check_name} ({check.score}/100)[/{color}]")
+        for hint in hints:
+            console.print(f"  [ ] {hint}")
+        console.print()
+
+
+def _render_compare(report_a, report_b) -> None:
+    console.print(f"\n[bold]Comparing repos[/bold]\n")
+
+    table = Table(show_header=True, header_style="bold")
+    table.add_column("Check")
+    table.add_column(report_a.repo.full_name, justify="right")
+    table.add_column(report_b.repo.full_name, justify="right")
+
+    all_checks = {c.name for c in report_a.checks} | {c.name for c in report_b.checks}
+    map_a = {c.name: c for c in report_a.checks}
+    map_b = {c.name: c for c in report_b.checks}
+
+    for name in sorted(all_checks):
+        ca = map_a.get(name)
+        cb = map_b.get(name)
+        score_a = _grade_text(ca.grade) if ca else Text("—", style="dim")
+        score_b = _grade_text(cb.grade) if cb else Text("—", style="dim")
+        if ca and cb:
+            score_a = Text(f"{ca.score} ({ca.grade})", style=f"bold {GRADE_COLORS.get(ca.grade, 'white')}")
+            score_b = Text(f"{cb.score} ({cb.grade})", style=f"bold {GRADE_COLORS.get(cb.grade, 'white')}")
+        table.add_row(name, score_a, score_b)
+
+    # Overall row
+    overall_a = Text(f"{report_a.overall_score} ({report_a.overall_grade})", style=f"bold {GRADE_COLORS.get(report_a.overall_grade, 'white')}")
+    overall_b = Text(f"{report_b.overall_score} ({report_b.overall_grade})", style=f"bold {GRADE_COLORS.get(report_b.overall_grade, 'white')}")
+    table.add_section()
+    table.add_row("OVERALL", overall_a, overall_b)
+
+    console.print(table)
+
+
+def _render_org(results: list[tuple[RepoRef, int, str]]) -> None:
+    table = Table(show_header=True, header_style="bold", title="Org Health Report")
+    table.add_column("Repo")
+    table.add_column("Score", justify="right")
+    table.add_column("Grade", justify="center")
+
+    for ref, score, grade in results:
+        color = GRADE_COLORS.get(grade, "white")
+        table.add_row(ref.name, str(score), Text(grade, style=f"bold {color}"))
+
+    console.print(table)
+    avg = round(sum(s for _, s, _ in results) / len(results)) if results else 0
+    console.print(f"\n[bold]Org average: {avg}/100[/bold]")
+
+
+@click.command()
+@click.argument("repo", required=False, default=None)
+@click.option("--token", envvar="GITHUB_TOKEN", help="GitHub personal access token.")
+@click.option("--json", "as_json", is_flag=True, help="Output raw JSON.")
+@click.option("--verbose", "-v", is_flag=True, help="Show detailed reasoning for every check.")
+@click.option("--min-score", type=int, default=None, help="Exit with code 1 if score is below this threshold.")
+@click.option("--compare", default=None, metavar="REPO2", help="Compare against a second repo.")
+@click.option("--org", default=None, metavar="ORG", help="Scan all public repos in a GitHub org.")
+@click.option("--fix", "show_fix", is_flag=True, help="Print a checklist of improvements.")
+@click.option("--md", "as_markdown", is_flag=True, help="Output a markdown report.")
+@click.option("--limit", type=int, default=20, show_default=True, help="Max repos to scan with --org.")
+@click.version_option()
+def main(repo, token, as_json, verbose, min_score, compare, org, show_fix, as_markdown, limit):
+    """Scan a GitHub REPO (owner/repo or URL) and print a health report card.
+
+    \b
+    Examples:
+      repocheck pallets/flask
+      repocheck pallets/flask --compare psf/requests
+      repocheck pallets/flask --fix
+      repocheck pallets/flask --md > report.md
+      repocheck pallets/flask --min-score 80
+      repocheck --org pallets
+    """
+    if not repo and not org:
+        raise click.UsageError("Provide a REPO argument or use --org ORG.")
+
+    client = GitHubClient(token=token)
+
+    # --org mode: scan all public repos in an org
+    if org:
+        with console.status(f"[bold blue]Fetching repos for {org}..."):
+            repos = client.org_repos(org, per_page=min(limit, 100))
+
+        if not repos:
+            console.print(f"[red]No public repos found for org: {org}[/red]")
+            sys.exit(1)
+
+        repos = repos[:limit]
+        results = []
+        for r in repos:
+            ref = RepoRef(r["owner"]["login"], r["name"])
+            try:
+                with console.status(f"Scanning {ref.full_name}..."):
+                    report = run_report(client, ref)
+                results.append((ref, report.overall_score, report.overall_grade))
+            except GitHubError:
+                pass
+
+        results.sort(key=lambda x: x[1], reverse=True)
+        _render_org(results)
+        return
+
+    # Normal single-repo mode
+    try:
+        ref = parse_repo_arg(repo)
+    except ValueError as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        sys.exit(1)
+
+    try:
+        with console.status(f"[bold blue]Scanning {ref.full_name}..."):
+            report = run_report(client, ref)
+    except GitHubError as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        sys.exit(1)
+
+    # --compare mode
+    if compare:
+        try:
+            ref2 = parse_repo_arg(compare)
+            with console.status(f"[bold blue]Scanning {ref2.full_name}..."):
+                report2 = run_report(client, ref2)
+            _render_compare(report, report2)
+        except (ValueError, GitHubError) as e:
+            console.print(f"[bold red]Error:[/bold red] {e}")
+            sys.exit(1)
+        return
+
+    last_run = get_last_run(ref.full_name)
+    save_run(ref.full_name, report.overall_score, [{"name": c.name, "score": c.score} for c in report.checks])
+
+    if as_json:
+        print(json.dumps(report.to_dict(), indent=2))
+    elif as_markdown:
+        print(report.to_markdown())
+    else:
+        _render(report, verbose=verbose, last_run=last_run)
+        if show_fix:
+            _render_fix(report)
+
+    if min_score is not None and report.overall_score < min_score:
+        console.print(f"\n[red bold]Score {report.overall_score} is below --min-score {min_score}. Exiting with code 1.[/red bold]")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/repocheck/github_client.py

@@ -123,3 +123,18 @@ class GitHubClient:
         if not isinstance(data, list):
             return []
         return [item["name"] for item in data if item["type"] == "dir"]
+
+    def branch_protection(self, ref: RepoRef, branch: str = "main") -> Optional[dict[str, Any]]:
+        try:
+            return self._get(f"/repos/{ref.full_name}/branches/{branch}/protection").json()
+        except (GitHubError, requests.exceptions.HTTPError):
+            return None
+
+    def org_repos(self, org: str, per_page: int = 100) -> list[dict[str, Any]]:
+        try:
+            return self._get(
+                f"/orgs/{org}/repos",
+                params={"per_page": per_page, "type": "public", "sort": "updated"},
+            ).json()
+        except GitHubError:
+            return []

repocheck_cli-0.2.0/repocheck/history.py

@@ -0,0 +1,40 @@
+"""Local run history — stores scores in ~/.repocheck/history.json."""
+from __future__ import annotations
+
+import json
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+HISTORY_FILE = Path.home() / ".repocheck" / "history.json"
+
+
+def _load() -> dict:
+    if not HISTORY_FILE.exists():
+        return {}
+    try:
+        return json.loads(HISTORY_FILE.read_text())
+    except Exception:
+        return {}
+
+
+def _save(data: dict) -> None:
+    HISTORY_FILE.parent.mkdir(parents=True, exist_ok=True)
+    HISTORY_FILE.write_text(json.dumps(data, indent=2))
+
+
+def get_last_run(repo: str) -> Optional[dict]:
+    runs = _load().get(repo, [])
+    return runs[-1] if runs else None
+
+
+def save_run(repo: str, score: int, checks: list[dict]) -> None:
+    data = _load()
+    runs = data.setdefault(repo, [])
+    runs.append({
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "score": score,
+        "checks": {c["name"]: c["score"] for c in checks},
+    })
+    data[repo] = runs[-20:]
+    _save(data)

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/repocheck/report.py

@@ -1,12 +1,19 @@
 """Aggregates individual CheckResults into an overall report."""
 from __future__ import annotations
 
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 
 from .checks import CHECKS, CheckResult
 from .github_client import GitHubClient, RepoRef
 
 
+_FIX_SIGNALS = ("No ", "consider", "appears inactive", "low-effort", "Short ")
+
+
+def _is_actionable(detail: str) -> bool:
+    return any(signal in detail for signal in _FIX_SIGNALS)
+
+
 @dataclass
 class Report:
     repo: RepoRef
@@ -34,6 +41,38 @@ class Report:
             ],
         }
 
+    def to_markdown(self) -> str:
+        lines = [
+            f"# repocheck: {self.repo.full_name}",
+            "",
+            f"**Overall: {self.overall_score}/100 ({self.overall_grade})**  ",
+            f"★ {self.repo_meta.get('stargazers_count', 0)}  "
+            f"⑂ {self.repo_meta.get('forks_count', 0)}  "
+            f"{self.repo_meta.get('language') or 'unknown'}",
+            "",
+            "| Check | Score | Grade |",
+            "|---|---|---|",
+        ]
+        for c in self.checks:
+            lines.append(f"| {c.name} | {c.score} | {c.grade} |")
+        lines.append("")
+        lines.append("## Details")
+        for c in self.checks:
+            lines.append(f"\n### {c.name} — {c.score}/100 ({c.grade})")
+            for d in c.details:
+                lines.append(f"- {d}")
+        return "\n".join(lines)
+
+    def fix_suggestions(self) -> list[tuple[str, list[str]]]:
+        suggestions = []
+        for c in sorted(self.checks, key=lambda x: x.score):
+            if c.score >= 90:
+                continue
+            hints = [d for d in c.details if _is_actionable(d)]
+            if hints:
+                suggestions.append((c.name, hints))
+        return suggestions
+
 
 def run_report(client: GitHubClient, ref: RepoRef) -> Report:
     repo_meta = client.repo(ref)

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/repocheck_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repocheck-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Scan any GitHub repo and get an instant engineering health report card.
 Author: Syed Ahmed Ali
 License-Expression: MIT
@@ -22,6 +22,8 @@ Dynamic: license-file
 
 # repocheck
 
+[![PyPI](https://img.shields.io/pypi/v/repocheck-cli)](https://pypi.org/project/repocheck-cli/)
+
 Scan any public GitHub repo and get an instant engineering health report card — README quality, CI/CD, test presence, dependency hygiene, license, commit activity, and issue hygiene, scored A–F.
 
 ```

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/repocheck_cli.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ repocheck/__init__.py
 repocheck/checks.py
 repocheck/cli.py
 repocheck/github_client.py
+repocheck/history.py
 repocheck/report.py
 repocheck_cli.egg-info/PKG-INFO
 repocheck_cli.egg-info/SOURCES.txt

{repocheck_cli-0.1.0 → repocheck_cli-0.2.0}/tests/test_end_to_end.py

@@ -74,7 +74,7 @@ def test_end_to_end_report_with_mocked_api():
     assert report.repo.full_name == "acme/widget"
     assert 0 <= report.overall_score <= 100
     assert report.overall_grade in ("A", "B", "C", "D", "F")
-    assert len(report.checks) == 7
+    assert len(report.checks) == 11
 
     as_dict = report.to_dict()
     # Confirm it's JSON-serializable end to end, like --json mode produces

repocheck_cli-0.1.0/repocheck/cli.py

@@ -1,114 +0,0 @@
-"""repocheck CLI."""
-from __future__ import annotations
-
-import json
-import sys
-
-import click
-from rich.console import Console
-from rich.panel import Panel
-from rich.table import Table
-from rich.text import Text
-
-from .github_client import GitHubClient, GitHubError, parse_repo_arg
-from .report import run_report
-
-console = Console()
-
-GRADE_COLORS = {
-    "A": "green",
-    "B": "cyan",
-    "C": "yellow",
-    "D": "orange3",
-    "F": "red",
-}
-
-
-def _grade_text(grade: str) -> Text:
-    color = GRADE_COLORS.get(grade, "white")
-    return Text(grade, style=f"bold {color}")
-
-
-@click.command()
-@click.argument("repo")
-@click.option("--token", envvar="GITHUB_TOKEN", help="GitHub personal access token (or set GITHUB_TOKEN env var).")
-@click.option("--json", "as_json", is_flag=True, help="Output raw JSON instead of a formatted report.")
-@click.option("--verbose", "-v", is_flag=True, help="Show detailed reasoning for every check.")
-@click.version_option()
-def main(repo: str, token: str | None, as_json: bool, verbose: bool):
-    """Scan a GitHub REPO (owner/repo or URL) and print a health report card.
-
-    \b
-    Examples:
-      repocheck pallets/flask
-      repocheck https://github.com/psf/requests
-      repocheck torvalds/linux --json
-    """
-    try:
-        ref = parse_repo_arg(repo)
-    except ValueError as e:
-        console.print(f"[bold red]Error:[/bold red] {e}")
-        sys.exit(1)
-
-    client = GitHubClient(token=token)
-
-    try:
-        with console.status(f"[bold blue]Scanning {ref.full_name}..."):
-            report = run_report(client, ref)
-    except GitHubError as e:
-        console.print(f"[bold red]Error:[/bold red] {e}")
-        sys.exit(1)
-
-    if as_json:
-        print(json.dumps(report.to_dict(), indent=2))
-        return
-
-    _render(report, verbose=verbose)
-
-
-def _render(report, verbose: bool):
-    grade_color = GRADE_COLORS.get(report.overall_grade, "white")
-    header = Text()
-    header.append(f"{report.repo.full_name}\n", style="bold")
-    header.append(f"★ {report.repo_meta.get('stargazers_count', 0)}  ", style="dim")
-    header.append(f"⑂ {report.repo_meta.get('forks_count', 0)}  ", style="dim")
-    header.append(f"{report.repo_meta.get('language') or 'unknown'}", style="dim")
-
-    score_text = Text()
-    score_text.append(f"{report.overall_score}/100  ", style=f"bold {grade_color}")
-    score_text.append(f"({report.overall_grade})", style=f"bold {grade_color}")
-
-    console.print(Panel(header, title="repo", expand=False))
-    console.print(Panel(score_text, title="overall health score", expand=False))
-
-    table = Table(show_header=True, header_style="bold")
-    table.add_column("Check")
-    table.add_column("Score", justify="right")
-    table.add_column("Grade", justify="center")
-    if verbose:
-        table.add_column("Details")
-
-    for check in report.checks:
-        row = [check.name, str(check.score), _grade_text(check.grade)]
-        if verbose:
-            row.append("\n".join(f"• {d}" for d in check.details))
-        table.add_row(*row)
-
-    console.print(table)
-
-    if not verbose:
-        console.print("[dim]Run with -v for detailed reasoning behind each score.[/dim]")
-
-    if client_rate_hint(report):
-        console.print(
-            "[dim]Tip: set GITHUB_TOKEN to raise your API rate limit from 60/hr to 5000/hr.[/dim]"
-        )
-
-
-def client_rate_hint(report) -> bool:
-    import os
-    return not os.environ.get("GITHUB_TOKEN")
-
-
-if __name__ == "__main__":
-    main()