MQL5-Google-Onedrive/scripts/review_pull_requests.py
google-labs-jules[bot] afeaaa0c39 Bolt: optimize PR review with bulk git metadata
This commit optimizes `scripts/review_pull_requests.py` by implementing bulk
metadata retrieval for Git branches.

Key improvements:
- Reduced subprocess calls from O(N) to O(1) for branch metadata (ahead/behind,
  last commit date, subject) using `git for-each-ref`.
- Implemented `get_git_version()` for safe usage of the `%(ahead-behind)` atom
  (introduced in Git 2.41).
- Added a `BRANCH_METADATA_CACHE` to eliminate redundant `git log` calls.
- Maintained full compatibility with older Git versions via a robust fallback path.
- Preserved output parity with the original script.

Performance impact:
- Execution time reduced from ~2.3s to ~0.56s (~76% improvement) in an
  environment with 315 remote branches.
2026-02-25 18:15:14 +00:00

322 lines
12 KiB
Python

#!/usr/bin/env python3
"""
Pull Request Review Script
Reviews all pull requests and creates a comprehensive summary
"""
import subprocess
import sys
import json
from pathlib import Path
from datetime import datetime
from collections import defaultdict
REPO_ROOT = Path(__file__).resolve().parents[1]
# ⚡ Bolt: Global cache for branch metadata to avoid redundant git log calls.
BRANCH_METADATA_CACHE = {}
def get_git_version():
"""⚡ Bolt: Get git version to check for advanced feature support (like ahead-behind atom)."""
result = run_command(["git", "--version"])
if result and result.returncode == 0:
try:
# "git version 2.52.0" -> [2, 52, 0]
parts = result.stdout.strip().split()[-1].split('.')
return tuple(int(p) for p in parts if p.isdigit())
except (IndexError, ValueError):
return (0, 0, 0)
return (0, 0, 0)
def run_command(cmd, capture_output=True):
"""Run a command and return the result."""
try:
result = subprocess.run(
cmd,
cwd=REPO_ROOT,
capture_output=capture_output,
text=True,
timeout=30,
encoding='utf-8',
errors='replace'
)
return result
except Exception as e:
print(f"Error running command: {e}", file=sys.stderr)
return None
def get_prs_via_gh_cli():
"""Get PRs using GitHub CLI."""
result = run_command(["gh", "pr", "list", "--state", "all", "--json", "number,title,state,author,createdAt,updatedAt,headRefName,baseRefName,isDraft,labels"])
if result and result.returncode == 0:
try:
return json.loads(result.stdout)
except json.JSONDecodeError:
return []
return None
def get_prs_via_git():
"""⚡ Bolt: Get PR information via git branches, optimized with bulk metadata retrieval."""
global BRANCH_METADATA_CACHE
# Check if ahead-behind is supported (Git 2.41+)
version = get_git_version()
use_ahead_behind = version >= (2, 41)
# Format: name|ahead behind|date|subject
fmt = "%(refname:short)|%(ahead-behind:main)|%(committerdate:iso8601)|%(subject)"
if not use_ahead_behind:
fmt = "%(refname:short)|0 0|%(committerdate:iso8601)|%(subject)"
# Scan all remote branches under refs/remotes
result = run_command(["git", "for-each-ref", f"--format={fmt}", "refs/remotes"])
open_branches = []
merged_branches = []
if result and result.returncode == 0:
for line in result.stdout.strip().split("\n"):
if not line.strip():
continue
# Split by | but limit to 4 parts to handle subjects containing |
parts = line.split("|", 3)
if len(parts) < 4:
continue
refname = parts[0]
# Skip main branches and HEAD
if refname in ["origin/main", "main", "origin/HEAD"] or "/HEAD" in refname:
continue
# ⚡ Bolt: date and subject are always available from for-each-ref
BRANCH_METADATA_CACHE[refname] = {
"date": parts[2],
"subject": parts[3]
}
if use_ahead_behind:
try:
# %(ahead-behind) returns "ahead behind"
ahead, behind = map(int, parts[1].split())
BRANCH_METADATA_CACHE[refname]["ahead"] = ahead
BRANCH_METADATA_CACHE[refname]["behind"] = behind
if ahead > 0:
open_branches.append(refname)
else:
merged_branches.append(refname)
except (ValueError, IndexError):
# If ahead-behind fails for a specific ref, fall back to default
pass
# Fallback for categorization if ahead-behind is not supported
if not use_ahead_behind:
res_open = run_command(["git", "branch", "-r", "--no-merged", "main"])
if res_open and res_open.returncode == 0:
open_branches = [b.strip() for b in res_open.stdout.strip().split("\n")
if b.strip() and b.strip() not in ["origin/main", "origin/HEAD"]]
res_merged = run_command(["git", "branch", "-r", "--merged", "main"])
if res_merged and res_merged.returncode == 0:
merged_branches = [b.strip() for b in res_merged.stdout.strip().split("\n")
if b.strip() and b.strip() not in ["origin/main", "origin/HEAD"]]
return {
"open": open_branches,
"merged": merged_branches
}
def analyze_branch_name(branch_name):
"""Analyze branch name to extract PR information."""
branch = branch_name.replace("origin/", "")
info = {
"type": "unknown",
"category": "other",
"description": branch
}
# Categorize branches
if branch.startswith("Cursor/"):
info["type"] = "cursor"
info["category"] = "ai-generated"
info["description"] = branch.replace("Cursor/A6-9V/", "")
elif branch.startswith("copilot/"):
info["type"] = "copilot"
info["category"] = "ai-generated"
info["description"] = branch.replace("copilot/", "")
elif branch.startswith("bolt-"):
info["type"] = "bolt"
info["category"] = "optimization"
info["description"] = branch.replace("bolt-", "")
elif branch.startswith("feat/"):
info["type"] = "feature"
info["category"] = "feature"
info["description"] = branch.replace("feat/", "")
elif branch.startswith("feature/"):
info["type"] = "feature"
info["category"] = "feature"
info["description"] = branch.replace("feature/", "")
return info
def get_branch_info(branch_name):
"""⚡ Bolt: Get detailed information about a branch, optimized with cached data."""
branch = branch_name.replace("origin/", "")
# ⚡ Bolt: Use cached data if available to reduce subprocess calls.
cached = BRANCH_METADATA_CACHE.get(branch_name)
commit_count = 0
commits = []
# 1. Get commit count and history
# If we have ahead count in cache, we might skip the log call if it's 0.
if cached and "ahead" in cached:
commit_count = cached["ahead"]
if commit_count > 0:
result = run_command(["git", "log", "--oneline", f"main..{branch_name}"])
if result and result.returncode == 0:
commits = [c.strip() for c in result.stdout.strip().split("\n") if c.strip()]
else:
# Fallback: get count and commits together in one call
result = run_command(["git", "log", "--oneline", f"main..{branch_name}"])
if result and result.returncode == 0:
commits = [c.strip() for c in result.stdout.strip().split("\n") if c.strip()]
commit_count = len(commits)
# 2. Get last commit date
last_commit = cached.get("date") if cached else None
if not last_commit:
result = run_command(["git", "log", "-1", "--format=%ci", branch_name])
if result and result.returncode == 0 and result.stdout.strip():
last_commit = result.stdout.strip()
return {
"branch": branch,
"full_name": branch_name,
"commit_count": commit_count,
"commits": commits[:5],
"last_commit_date": last_commit
}
def main():
"""Main review function."""
print("=" * 80)
print("PULL REQUEST REVIEW")
print(f"Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
print("=" * 80)
print()
# Try GitHub CLI first
prs = get_prs_via_gh_cli()
if prs is not None:
print(f"Found {len(prs)} pull requests via GitHub CLI")
print()
# Group by state
by_state = defaultdict(list)
for pr in prs:
by_state[pr.get("state", "unknown")].append(pr)
print("Pull Requests by State:")
for state, pr_list in sorted(by_state.items()):
print(f" {state.upper()}: {len(pr_list)}")
print()
# Show open PRs
open_prs = by_state.get("OPEN", [])
if open_prs:
print("=" * 80)
print("OPEN PULL REQUESTS")
print("=" * 80)
for pr in open_prs:
print(f"\nPR #{pr.get('number', 'N/A')}: {pr.get('title', 'No title')}")
print(f" Author: {pr.get('author', {}).get('login', 'Unknown')}")
print(f" Branch: {pr.get('headRefName', 'N/A')} -> {pr.get('baseRefName', 'main')}")
print(f" Created: {pr.get('createdAt', 'N/A')}")
print(f" Updated: {pr.get('updatedAt', 'N/A')}")
print(f" Draft: {'Yes' if pr.get('isDraft') else 'No'}")
labels = [l.get('name') for l in pr.get('labels', [])]
if labels:
print(f" Labels: {', '.join(labels)}")
# Show merged PRs
merged_prs = by_state.get("MERGED", [])
if merged_prs:
print("\n" + "=" * 80)
print(f"MERGED PULL REQUESTS ({len(merged_prs)} total)")
print("=" * 80)
print(f"\nShowing last 10 merged PRs:")
for pr in merged_prs[-10:]:
print(f" PR #{pr.get('number', 'N/A')}: {pr.get('title', 'No title')}")
else:
# Fallback to git branch analysis
print("GitHub CLI not available, analyzing branches...")
print()
branch_info = get_prs_via_git()
open_branches = branch_info["open"]
merged_branches = branch_info["merged"]
print(f"Open branches (potential PRs): {len(open_branches)}")
print(f"Merged branches (completed PRs): {len(merged_branches)}")
print()
# Categorize open branches
categories = defaultdict(list)
for branch in open_branches:
info = analyze_branch_name(branch)
categories[info["category"]].append((branch, info))
print("=" * 80)
print("OPEN BRANCHES (Potential Pull Requests)")
print("=" * 80)
print()
for category, branches in sorted(categories.items()):
print(f"{category.upper()}: {len(branches)} branches")
for branch, info in branches[:10]: # Show first 10
branch_details = get_branch_info(branch)
print(f" - {info['description']}")
print(f" Branch: {branch_details['branch']}")
print(f" Commits: {branch_details['commit_count']}")
if branch_details['last_commit_date']:
print(f" Last commit: {branch_details['last_commit_date']}")
if len(branches) > 10:
print(f" ... and {len(branches) - 10} more")
print()
print("=" * 80)
print("MERGED BRANCHES (Completed Pull Requests)")
print("=" * 80)
print(f"\nTotal merged: {len(merged_branches)}")
print("\nRecent merged branches:")
for branch in merged_branches[:20]:
info = analyze_branch_name(branch)
print(f" - {info['description']}")
print("\n" + "=" * 80)
print("REVIEW COMPLETE")
print("=" * 80)
print("\nNote: GitHub doesn't support 'pinning' pull requests directly.")
print("Consider:")
print("1. Creating a tracking issue for important PRs")
print("2. Using labels to categorize PRs")
print("3. Adding PRs to project boards")
print("4. Creating a PR summary document")
if __name__ == "__main__":
main()