ultralytics-actions 0.1.9__py3-none-any.whl → 0.2.1__py3-none-any.whl

actions/__init__.py

@@ -12,10 +12,13 @@
 # │   │   ├── github_utils.py
 # │   │   ├── openai_utils.py
 # │   │   └── common_utils.py
+# │   ├── dispatch_actions.py
 # │   ├── first_interaction.py
 # │   ├── review_pr.py
+# │   ├── scan_prs.py
 # │   ├── summarize_pr.py
 # │   ├── summarize_release.py
+# │   ├── update_file_headers.py
 # │   └── update_markdown_code_blocks.py
 # └── tests/
 #     ├── __init__.py
@@ -23,4 +26,4 @@
 #     ├── test_summarize_pr.py
 #     └── ...
 
-__version__ = "0.1.9"
+__version__ = "0.2.1"

actions/dispatch_actions.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import os
 import time
 from datetime import datetime
 
@@ -12,47 +13,99 @@ RUN_CI_KEYWORD = "@ultralytics/run-ci"  # and then to merge "@ultralytics/run-ci
 WORKFLOW_FILES = ["ci.yml", "docker.yml"]
 
 
-def get_pr_branch(event) -> str:
-    """Gets the PR branch name."""
+def get_pr_branch(event) -> tuple[str, str | None]:
+    """Gets the PR branch name, creating temp branch for forks, returning (branch, temp_branch_to_delete)."""
+    import subprocess
+    import tempfile
+
     pr_number = event.event_data["issue"]["number"]
     pr_data = event.get_repo_data(f"pulls/{pr_number}")
-    return pr_data.get("head", {}).get("ref", "main")
-
-
-def trigger_and_get_workflow_info(event, branch: str) -> list[dict]:
-    """Triggers workflows and returns their information."""
+    head = pr_data.get("head", {})
+
+    # Check if PR is from a fork
+    is_fork = head.get("repo") and head["repo"]["id"] != pr_data["base"]["repo"]["id"]
+
+    if is_fork:
+        # Create temp branch in base repo by pushing fork code
+        temp_branch = f"temp-ci-{pr_number}-{int(time.time() * 1000)}"
+        fork_repo = head["repo"]["full_name"]
+        fork_branch = head["ref"]
+        base_repo = event.repository
+        token = os.environ.get("GITHUB_TOKEN")
+        if not token:
+            raise ValueError("GITHUB_TOKEN environment variable is not set")
+
+        with tempfile.TemporaryDirectory() as tmp_dir:
+            repo_dir = os.path.join(tmp_dir, "repo")
+            base_url = f"https://x-access-token:{token}@github.com/{base_repo}.git"
+            fork_url = f"https://github.com/{fork_repo}.git"
+
+            try:
+                # Clone base repo (minimal)
+                subprocess.run(["git", "clone", "--depth", "1", base_url, repo_dir], check=True, capture_output=True)
+
+                # Add fork as remote and fetch the PR branch
+                subprocess.run(
+                    ["git", "remote", "add", "fork", fork_url], cwd=repo_dir, check=True, capture_output=True
+                )
+                subprocess.run(
+                    ["git", "fetch", "fork", f"{fork_branch}:{temp_branch}"],
+                    cwd=repo_dir,
+                    check=True,
+                    capture_output=True,
+                )
+
+                # Push temp branch to base repo
+                subprocess.run(["git", "push", "origin", temp_branch], cwd=repo_dir, check=True, capture_output=True)
+            except subprocess.CalledProcessError as e:
+                # Sanitize error output to prevent token leakage
+                stderr = e.stderr.decode() if e.stderr else "No stderr output"
+                stderr = stderr.replace(token, "***TOKEN***")
+                raise RuntimeError(f"Failed to create tmp branch from fork (exit code {e.returncode}): {stderr}") from e
+
+        return temp_branch, temp_branch
+
+    return head.get("ref", "main"), None
+
+
+def trigger_and_get_workflow_info(event, branch: str, temp_branch: str | None = None) -> list[dict]:
+    """Triggers workflows and returns their information, deleting temp branch if provided."""
     repo = event.repository
     results = []
 
-    # Trigger all workflows
-    for file in WORKFLOW_FILES:
-        event.post(f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}/dispatches", json={"ref": branch})
+    try:
+        # Trigger all workflows
+        for file in WORKFLOW_FILES:
+            event.post(f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}/dispatches", json={"ref": branch})
 
-    # Wait for workflows to be created
-    time.sleep(10)
+        # Wait for workflows to be created and start
+        time.sleep(60)
 
-    # Collect information about all workflows
-    for file in WORKFLOW_FILES:
-        # Get workflow name
-        response = event.get(f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}")
-        name = file.replace(".yml", "").title()
-        if response.status_code == 200:
-            name = response.json().get("name", name)
+        # Collect information about all workflows
+        for file in WORKFLOW_FILES:
+            # Get workflow name
+            response = event.get(f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}")
+            name = file.replace(".yml", "").title()
+            if response.status_code == 200:
+                name = response.json().get("name", name)
 
-        # Get run information
-        run_url = f"https://github.com/{repo}/actions/workflows/{file}"
-        run_number = None
+            # Get run information
+            run_url = f"https://github.com/{repo}/actions/workflows/{file}"
+            run_number = None
 
-        runs_response = event.get(
-            f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}/runs?branch={branch}&event=workflow_dispatch&per_page=1"
-        )
+            runs_response = event.get(
+                f"{GITHUB_API_URL}/repos/{repo}/actions/workflows/{file}/runs?branch={branch}&event=workflow_dispatch&per_page=1"
+            )
 
-        if runs_response.status_code == 200:
-            if runs := runs_response.json().get("workflow_runs", []):
+            if runs_response.status_code == 200 and (runs := runs_response.json().get("workflow_runs", [])):
                 run_url = runs[0].get("html_url", run_url)
                 run_number = runs[0].get("run_number")
 
-        results.append({"name": name, "file": file, "url": run_url, "run_number": run_number})
+            results.append({"name": name, "file": file, "url": run_url, "run_number": run_number})
+    finally:
+        # Always delete temp branch even if workflow collection fails
+        if temp_branch:
+            event.delete(f"{GITHUB_API_URL}/repos/{repo}/git/refs/heads/{temp_branch}")
 
     return results
 
@@ -63,12 +116,15 @@ def update_comment(event, comment_body: str, triggered_actions: list[dict], bran
         return
 
     timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S UTC")
-    summary = (
-        f"\n\n## ⚡ Actions Trigger\n\n"
-        f"<sub>Made with ❤️ by [Ultralytics Actions](https://www.ultralytics.com/actions)<sub>\n\n"
-        f"GitHub Actions below triggered via workflow dispatch on this "
-        f"PR branch `{branch}` at {timestamp} with `{RUN_CI_KEYWORD}` command:\n\n"
-    )
+    summary = f"""
+
+## ⚡ Actions Trigger
+
+<sub>Made with ❤️ by [Ultralytics Actions](https://www.ultralytics.com/actions)<sub>
+
+GitHub Actions below triggered via workflow dispatch for this PR at {timestamp} with `{RUN_CI_KEYWORD}` command:
+
+"""
 
     for action in triggered_actions:
         run_info = f" run {action['run_number']}" if action["run_number"] else ""
@@ -104,10 +160,10 @@ def main(*args, **kwargs):
 
     # Get branch, trigger workflows, and update comment
     event.toggle_eyes_reaction(True)
-    branch = get_pr_branch(event)
-    print(f"Triggering workflows on branch: {branch}")
+    branch, temp_branch = get_pr_branch(event)
+    print(f"Triggering workflows on branch: {branch}" + (" (temp)" if temp_branch else ""))
 
-    triggered_actions = trigger_and_get_workflow_info(event, branch)
+    triggered_actions = trigger_and_get_workflow_info(event, branch, temp_branch)
     update_comment(event, comment_body, triggered_actions, branch)
     event.toggle_eyes_reaction(False)
 

actions/first_interaction.py

@@ -6,11 +6,9 @@ import os
 import time
 
 from . import review_pr
-from .utils import Action, filter_labels, get_completion, get_pr_open_response, remove_html_comments
+from .summarize_pr import SUMMARY_MARKER
+from .utils import ACTIONS_CREDIT, Action, filter_labels, get_completion, get_pr_open_response, remove_html_comments
 
-SUMMARY_START = (
-    "## 🛠️ PR Summary\n\n<sub>Made with ❤️ by [Ultralytics Actions](https://github.com/ultralytics/actions)<sub>\n\n"
-)
 BLOCK_USER = os.getenv("BLOCK_USER", "false").lower() == "true"
 AUTO_PR_REVIEW = os.getenv("REVIEW", "true").lower() == "true"
 
@@ -190,13 +188,13 @@ def main(*args, **kwargs):
         if event.should_skip_pr_author():
             return
 
-        print("Processing PR open with unified API call...")
+        print(f"Processing PR open by @{username} with unified API call...")
         diff = event.get_pr_diff()
-        response = get_pr_open_response(event.repository, diff, title, body, label_descriptions)
+        response = get_pr_open_response(event.repository, diff, title, username, label_descriptions)
 
         if summary := response.get("summary"):
             print("Updating PR description with summary...")
-            event.update_pr_description(number, SUMMARY_START + summary)
+            event.update_pr_description(number, f"{SUMMARY_MARKER}\n\n{ACTIONS_CREDIT}\n\n{summary}")
         else:
             summary = body
 

actions/review_pr.py

@@ -5,9 +5,9 @@ from __future__ import annotations
 import json
 import re
 
-from .utils import GITHUB_API_URL, MAX_PROMPT_CHARS, Action, get_completion, remove_html_comments
+from .utils import ACTIONS_CREDIT, GITHUB_API_URL, MAX_PROMPT_CHARS, Action, get_completion, remove_html_comments
 
-REVIEW_MARKER = "🔍 PR Review"
+REVIEW_MARKER = "## 🔍 PR Review"
 ERROR_MARKER = "⚠️ Review generation encountered an error"
 EMOJI_MAP = {"CRITICAL": "❗", "HIGH": "⚠️", "MEDIUM": "💡", "LOW": "📝", "SUGGESTION": "💭"}
 SKIP_PATTERNS = [
@@ -95,27 +95,25 @@ def generate_pr_review(repository: str, diff_text: str, pr_title: str, pr_descri
     lines_changed = sum(len(sides["RIGHT"]) + len(sides["LEFT"]) for sides in diff_files.values())
 
     content = (
-        "You are an expert code reviewer for Ultralytics. Provide detailed inline comments on specific code changes.\n\n"
-        "Focus on: Bugs, security, performance, best practices, edge cases, error handling\n\n"
-        "FORMATTING: Use backticks for code: `x=3`, `file.py`, `function()`\n\n"
+        "You are an expert code reviewer for Ultralytics. Review the code changes and provide inline comments where you identify issues or opportunities for improvement.\n\n"
+        "Focus on: bugs, security vulnerabilities, performance issues, best practices, edge cases, error handling, and code clarity.\n\n"
         "CRITICAL RULES:\n"
-        "1. Quality over quantity - zero comments is fine for clean code, only flag truly important issues\n"
-        "2. Combine issues that are directly related to the same problem\n"
-        "3. Use 'start_line' and 'line' to highlight multi-line ranges when issues span multiple lines\n"
+        "1. Provide balanced, constructive feedback - flag bugs, improvements, and best practice issues\n"
+        "2. For issues spanning multiple adjacent lines, use 'start_line' to create ONE multi-line comment, never separate comments\n"
+        "3. Combine related issues into a single comment when they stem from the same root cause\n"
         "4. Prioritize: CRITICAL bugs/security > HIGH impact > code quality improvements\n"
         "5. Keep comments concise and friendly - avoid jargon\n"
-        "6. Skip routine changes: imports, version updates, standard refactoring\n\n"
+        "6. Use backticks for code: `x=3`, `file.py`, `function()`\n"
+        "7. Skip routine changes: imports, version updates, standard refactoring\n\n"
         "SUMMARY:\n"
         "- Brief and actionable - what needs fixing, not where (locations shown in inline comments)\n\n"
         "SUGGESTIONS:\n"
-        "- ONLY provide 'suggestion' field when you have high certainty the code is problematic AND sufficient context for a confident fix\n"
-        "- If uncertain about the correct fix, omit 'suggestion' field and explain the concern in 'message' only\n"
-        "- Suggestions must be ready-to-merge code with NO comments, placeholders, or explanations\n"
-        "- Suggestions replace ONLY the single line at 'line' - for multi-line fixes, describe the change in 'message' instead\n"
-        "- Do NOT provide 'start_line' when including a 'suggestion' - suggestions are always single-line only\n"
-        "- Suggestion content must match the exact indentation of the original line\n"
-        "- Avoid triple backticks (```) in suggestions as they break markdown formatting\n"
-        "- It's better to flag an issue without a suggestion than provide a wrong or uncertain fix\n\n"
+        "- Provide 'suggestion' field with ready-to-merge code when you can confidently fix the issue\n"
+        "- Suggestions must be complete, working code with NO comments, placeholders, or explanations\n"
+        "- For single-line fixes: provide 'suggestion' without 'start_line' to replace the line at 'line'\n"
+        "- Do not provide multi-line fixes: suggestions should only be single line\n"
+        "- Match the exact indentation of the original code\n"
+        "- Avoid triple backticks (```) in suggestions as they break markdown formatting\n\n"
         "LINE NUMBERS:\n"
         "- Each line in the diff is prefixed with its line number for clarity:\n"
         "  R  123 +added code     <- RIGHT side (new file), line 123\n"
@@ -131,7 +129,7 @@ def generate_pr_review(repository: str, diff_text: str, pr_title: str, pr_descri
         "- Extract line numbers from R#### or L#### prefixes in the diff\n"
         "- Exact paths (no ./), 'side' field must match R (RIGHT) or L (LEFT) prefix\n"
         "- Severity: CRITICAL, HIGH, MEDIUM, LOW, SUGGESTION\n"
-        f"- Files changed: {len(file_list)} ({', '.join(file_list[:10])}{'...' if len(file_list) > 10 else ''})\n"
+        f"- Files changed: {len(file_list)} ({', '.join(file_list[:30])}{'...' if len(file_list) > 30 else ''})\n"
         f"- Lines changed: {lines_changed}\n"
     )
 
@@ -140,21 +138,37 @@ def generate_pr_review(repository: str, diff_text: str, pr_title: str, pr_descri
         {
             "role": "user",
             "content": (
-                f"Review this PR in https://github.com/{repository}:\n"
-                f"Title: {pr_title}\n"
-                f"Description: {remove_html_comments(pr_description or '')[:1000]}\n\n"
-                f"Diff:\n{augmented_diff[:MAX_PROMPT_CHARS]}\n\n"
+                f"Review this PR in https://github.com/{repository}:\n\n"
+                f"TITLE:\n{pr_title}\n\n"
+                f"BODY:\n{remove_html_comments(pr_description or '')[:1000]}\n\n"
+                f"DIFF:\n{augmented_diff[:MAX_PROMPT_CHARS]}\n\n"
                 "Now review this diff according to the rules above. Return JSON with comments array and summary."
             ),
         },
     ]
 
-    # Debug: print prompts sent to AI
-    # print(f"\nSystem prompt (first 1000 chars):\n{messages[0]['content'][:2000]}...\n")
-    # print(f"\nUser prompt (first 1000 chars):\n{messages[1]['content'][:2000]}...\n")
+    # Debug output
+    # print(f"\nSystem prompt (first 3000 chars):\n{messages[0]['content'][:3000]}...\n")
+    # print(f"\nUser prompt (first 3000 chars):\n{messages[1]['content'][:3000]}...\n")
 
     try:
-        response = get_completion(messages, reasoning_effort="low", model="gpt-5-codex")
+        response = get_completion(
+            messages,
+            reasoning_effort="low",
+            model="gpt-5-codex",
+            tools=[
+                {
+                    "type": "web_search",
+                    "filters": {
+                        "allowed_domains": [
+                            "ultralytics.com",
+                            "github.com",
+                            "stackoverflow.com",
+                        ]
+                    },
+                }
+            ],
+        )
 
         json_str = re.search(r"```(?:json)?\s*(\{.*?\})\s*```", response, re.DOTALL)
         review_data = json.loads(json_str.group(1) if json_str else response)
@@ -271,9 +285,9 @@ def post_review_summary(event: Action, review_data: dict, review_number: int) ->
     event_type = "COMMENT" if (has_error or has_inline_comments or has_issues) else "APPROVE"
 
     body = (
-        f"## {review_title}\n\n"
-        "<sub>Made with ❤️ by [Ultralytics Actions](https://github.com/ultralytics/actions)</sub>\n\n"
-        f"{review_data.get('summary', 'Review completed')[:1000]}\n\n"  # Clip summary length
+        f"{review_title}\n\n"
+        f"{ACTIONS_CREDIT}\n\n"
+        f"{review_data.get('summary', 'Review completed')[:3000]}\n\n"  # Clip summary length
     )
 
     if comments:
@@ -294,10 +308,10 @@ def post_review_summary(event: Action, review_data: dict, review_number: int) ->
 
         severity = comment.get("severity") or "SUGGESTION"
         side = comment.get("side", "RIGHT")
-        comment_body = f"{EMOJI_MAP.get(severity, '💭')} **{severity}**: {(comment.get('message') or '')[:1000]}"
+        comment_body = f"{EMOJI_MAP.get(severity, '💭')} **{severity}**: {(comment.get('message') or '')[:3000]}"
 
         if suggestion := comment.get("suggestion"):
-            suggestion = suggestion[:1000]  # Clip suggestion length
+            suggestion = suggestion[:3000]  # Clip suggestion length
             if "```" not in suggestion:
                 # Extract original line indentation and apply to suggestion
                 if original_line := review_data.get("diff_files", {}).get(file_path, {}).get(side, {}).get(line):
@@ -307,10 +321,9 @@ def post_review_summary(event: Action, review_data: dict, review_number: int) ->
 
         # Build comment with optional start_line for multi-line context
         review_comment = {"path": file_path, "line": line, "body": comment_body, "side": side}
-        if start_line := comment.get("start_line"):
-            if start_line < line:
-                review_comment["start_line"] = start_line
-                review_comment["start_side"] = side
+        if (start_line := comment.get("start_line")) and start_line < line:
+            review_comment["start_line"] = start_line
+            review_comment["start_side"] = side
 
         review_comments.append(review_comment)
 

actions/scan_prs.py

@@ -0,0 +1,205 @@
+# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
+"""List and auto-merge open PRs across GitHub organization."""
+
+import json
+import os
+import subprocess
+from datetime import datetime, timezone
+
+
+def get_age_days(created_at):
+    """Calculate PR age in days from ISO timestamp."""
+    return (datetime.now(timezone.utc) - datetime.fromisoformat(created_at.replace("Z", "+00:00"))).days
+
+
+def get_phase_emoji(age_days):
+    """Return emoji and label for PR age phase."""
+    if age_days == 0:
+        return "🆕", "NEW"
+    elif age_days <= 7:
+        return "🟢", f"{age_days} days"
+    elif age_days <= 30:
+        return "🟡", f"{age_days} days"
+    else:
+        return "🔴", f"{age_days} days"
+
+
+def run():
+    """List open PRs across organization and auto-merge eligible Dependabot PRs."""
+    # Get and validate settings
+    org = os.getenv("ORG", "ultralytics")
+    visibility = os.getenv("VISIBILITY", "public").lower()
+    repo_visibility = os.getenv("REPO_VISIBILITY", "public").lower()
+    valid_visibilities = {"public", "private", "internal", "all"}
+
+    if visibility not in valid_visibilities:
+        print(f"⚠️  Invalid visibility '{visibility}', defaulting to 'public'")
+        visibility = "public"
+
+    # Security: if calling repo is public, restrict to public repos only
+    if repo_visibility == "public" and visibility != "public":
+        print(f"⚠️  Security: Public repo cannot scan {visibility} repos. Restricting to public only.")
+        visibility = "public"
+
+    print(f"🔍 Scanning {visibility} repositories in {org} organization...")
+
+    # Get active repos with specified visibility
+    cmd = ["gh", "repo", "list", org, "--limit", "1000", "--json", "name,url,isArchived"]
+    if visibility != "all":
+        cmd.extend(["--visibility", visibility])
+
+    result = subprocess.run(cmd, capture_output=True, text=True, check=True)
+    repos = {r["name"]: r["url"] for r in json.loads(result.stdout) if not r["isArchived"]}
+
+    if not repos:
+        print("⚠️  No repositories found")
+        return
+
+    # Get all open PRs
+    result = subprocess.run(
+        [
+            "gh",
+            "search",
+            "prs",
+            "--owner",
+            org,
+            "--state",
+            "open",
+            "--limit",
+            "1000",
+            "--json",
+            "repository,number,title,url,createdAt",
+            "--sort",
+            "created",
+            "--order",
+            "desc",
+        ],
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    all_prs = json.loads(result.stdout)
+
+    if not all_prs:
+        print("✅ No open PRs found")
+        return
+
+    # Count PRs by phase
+    phase_counts = {"new": 0, "green": 0, "yellow": 0, "red": 0}
+    for pr in all_prs:
+        age_days = get_age_days(pr["createdAt"])
+        phase_counts[
+            "new" if age_days == 0 else "green" if age_days <= 7 else "yellow" if age_days <= 30 else "red"
+        ] += 1
+
+    repo_count = len({pr["repository"]["name"] for pr in all_prs if pr["repository"]["name"] in repos})
+    summary = [
+        f"# 🔍 Open Pull Requests - {org.title()} Organization\n",
+        f"**Total:** {len(all_prs)} open PRs across {repo_count} repos",
+        f"**By Phase:** 🆕 {phase_counts['new']} New | 🟢 {phase_counts['green']} Green (≤7d) | 🟡 {phase_counts['yellow']} Yellow (≤30d) | 🔴 {phase_counts['red']} Red (>30d)\n",
+    ]
+
+    for repo_name in sorted({pr["repository"]["name"] for pr in all_prs}):
+        if repo_name not in repos:
+            continue
+
+        repo_prs = [pr for pr in all_prs if pr["repository"]["name"] == repo_name]
+        summary.append(
+            f"## 📦 [{repo_name}]({repos[repo_name]}) - {len(repo_prs)} open PR{'s' if len(repo_prs) > 1 else ''}"
+        )
+
+        for pr in repo_prs[:30]:
+            emoji, age_str = get_phase_emoji(get_age_days(pr["createdAt"]))
+            summary.append(f"- 🔀 [#{pr['number']}]({pr['url']}) {pr['title']} {emoji} {age_str}")
+
+        if len(repo_prs) > 30:
+            summary.append(f"- ... {len(repo_prs) - 30} more PRs")
+        summary.append("")
+
+    # Auto-merge Dependabot GitHub Actions PRs
+    print("\n🤖 Checking for Dependabot PRs to auto-merge...")
+    summary.append("\n# 🤖 Auto-Merge Dependabot GitHub Actions PRs\n")
+    total_found = total_merged = total_skipped = 0
+
+    for repo_name in repos:
+        result = subprocess.run(
+            [
+                "gh",
+                "pr",
+                "list",
+                "--repo",
+                f"{org}/{repo_name}",
+                "--author",
+                "app/dependabot",
+                "--state",
+                "open",
+                "--json",
+                "number,title,files,mergeable,statusCheckRollup",
+            ],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode != 0:
+            continue
+
+        merged = 0
+        for pr in json.loads(result.stdout):
+            if not all(f["path"].startswith(".github/workflows/") for f in pr["files"]):
+                continue
+
+            total_found += 1
+            pr_ref = f"{org}/{repo_name}#{pr['number']}"
+            print(f"  Found: {pr_ref} - {pr['title']}")
+
+            if merged >= 1:
+                print(f"    ⏭️  Skipped (already merged 1 PR in {repo_name})")
+                total_skipped += 1
+                continue
+
+            if pr["mergeable"] != "MERGEABLE":
+                print(f"    ❌ Skipped (not mergeable: {pr['mergeable']})")
+                total_skipped += 1
+                continue
+
+            # Check if all status checks passed (normalize rollup structure)
+            rollup = pr.get("statusCheckRollup")
+            if isinstance(rollup, list):
+                checks = rollup
+            elif isinstance(rollup, dict):
+                checks = rollup.get("contexts", [])
+            else:
+                checks = []
+            failed_checks = [c for c in checks if c.get("conclusion") not in ["SUCCESS", "SKIPPED", "NEUTRAL"]]
+
+            if failed_checks:
+                for check in failed_checks:
+                    print(f"    ❌ Failing check: {check.get('name', 'unknown')} = {check.get('conclusion')}")
+                total_skipped += 1
+                continue
+
+            print("    ✅ All checks passed, merging...")
+            result = subprocess.run(
+                ["gh", "pr", "merge", str(pr["number"]), "--repo", f"{org}/{repo_name}", "--squash", "--admin"],
+                capture_output=True,
+                text=True,
+            )
+            if result.returncode == 0:
+                print(f"    ✅ Successfully merged {pr_ref}")
+                summary.append(f"- ✅ Merged {pr_ref}")
+                total_merged += 1
+                merged += 1
+            else:
+                print(f"    ❌ Merge failed: {result.stderr.strip()}")
+                total_skipped += 1
+
+    summary.append(f"\n**Summary:** Found {total_found} | Merged {total_merged} | Skipped {total_skipped}")
+    print(f"\n📊 Dependabot Summary: Found {total_found} | Merged {total_merged} | Skipped {total_skipped}")
+
+    # Write to GitHub step summary if available
+    if summary_file := os.getenv("GITHUB_STEP_SUMMARY"):
+        with open(summary_file, "a") as f:
+            f.write("\n".join(summary))
+
+
+if __name__ == "__main__":
+    run()

actions/summarize_pr.py

@@ -2,11 +2,9 @@
 
 from __future__ import annotations
 
-from .utils import GITHUB_API_URL, Action, get_completion, get_pr_summary_prompt
+from .utils import ACTIONS_CREDIT, GITHUB_API_URL, Action, get_completion, get_pr_summary_prompt
 
-SUMMARY_START = (
-    "## 🛠️ PR Summary\n\n<sub>Made with ❤️ by [Ultralytics Actions](https://github.com/ultralytics/actions)<sub>\n\n"
-)
+SUMMARY_MARKER = "## 🛠️ PR Summary"
 
 
 def generate_merge_message(pr_summary, pr_credit, pr_url):
@@ -73,7 +71,8 @@ def generate_pr_summary(repository, diff_text):
     reply = get_completion(messages, temperature=1.0)
     if is_large:
         reply = "**WARNING ⚠️** this PR is very large, summary may not cover all changes.\n\n" + reply
-    return SUMMARY_START + reply
+
+    return f"{SUMMARY_MARKER}\n\n{ACTIONS_CREDIT}\n\n{reply}"
 
 
 def label_fixed_issues(event, pr_summary):

actions/summarize_release.py

@@ -196,7 +196,7 @@ def main(*args, **kwargs):
     try:
         summary = generate_release_summary(event, diff, prs, CURRENT_TAG, previous_tag)
     except Exception as e:
-        print(f"Failed to generate summary: {str(e)}")
+        print(f"Failed to generate summary: {e}")
         summary = "Failed to generate summary."
 
     # Get the latest commit message

actions/utils/__init__.py

@@ -1,6 +1,7 @@
 # Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
 
 from .common_utils import (
+    ACTIONS_CREDIT,
     REDIRECT_END_IGNORE_LIST,
     REDIRECT_START_IGNORE_LIST,
     REQUESTS_HEADERS,
@@ -20,13 +21,14 @@ from .openai_utils import (
 from .version_utils import check_pubdev_version, check_pypi_version
 
 __all__ = (
+    "ACTIONS_CREDIT",
     "GITHUB_API_URL",
     "GITHUB_GRAPHQL_URL",
     "MAX_PROMPT_CHARS",
+    "REDIRECT_END_IGNORE_LIST",
+    "REDIRECT_START_IGNORE_LIST",
     "REQUESTS_HEADERS",
     "URL_IGNORE_LIST",
-    "REDIRECT_START_IGNORE_LIST",
-    "REDIRECT_END_IGNORE_LIST",
     "Action",
     "allow_redirect",
     "check_pubdev_version",

actions/utils/common_utils.py

@@ -23,6 +23,7 @@ REQUESTS_HEADERS = {
     "Sec-Fetch-User": "?1",
     "Sec-Fetch-Dest": "document",
 }
+ACTIONS_CREDIT = "<sub>Made with ❤️ by [Ultralytics Actions](https://www.ultralytics.com/actions)</sub>"
 BAD_HTTP_CODES = frozenset(
     {
         204,  # No content

actions/utils/github_utils.py

@@ -101,7 +101,13 @@ mutation($labelableId: ID!, $labelIds: [ID!]!) {
 class Action:
     """Handles GitHub Actions API interactions and event processing."""
 
-    def __init__(self, token: str = None, event_name: str = None, event_data: dict = None, verbose: bool = True):
+    def __init__(
+        self,
+        token: str | None = None,
+        event_name: str | None = None,
+        event_data: dict | None = None,
+        verbose: bool = True,
+    ):
         """Initializes a GitHub Actions API handler with token and event data for processing events."""
         self.token = token or os.getenv("GITHUB_TOKEN")
         self.event_name = event_name or os.getenv("GITHUB_EVENT_NAME")
@@ -116,8 +122,8 @@ class Action:
         self._pr_summary_cache = None
         self._username_cache = None
         self._default_status = {
-            "get": [200],
-            "post": [200, 201],
+            "get": [200, 204],
+            "post": [200, 201, 204],
             "put": [200, 201, 204],
             "patch": [200],
             "delete": [200, 204],
@@ -134,9 +140,12 @@ class Action:
             print(f"{'✓' if success else '✗'} {method.upper()} {url} → {r.status_code} ({elapsed:.1f}s)", flush=True)
             if not success:
                 try:
-                    print(f"  ❌ Error: {r.json().get('message', 'Unknown error')}")
+                    error_data = r.json()
+                    print(f"  ❌ Error: {error_data.get('message', 'Unknown error')}")
+                    if errors := error_data.get("errors"):
+                        print(f"  Details: {errors}")
                 except Exception:
-                    print(f"  ❌ Error: {r.text[:200]}")
+                    print(f"  ❌ Error: {r.text[:1000]}")
 
         if not success and hard:
             r.raise_for_status()
@@ -257,7 +266,7 @@ class Action:
             self.delete(f"{url}/{self.eyes_reaction_id}")
             self.eyes_reaction_id = None
 
-    def graphql_request(self, query: str, variables: dict = None) -> dict:
+    def graphql_request(self, query: str, variables: dict | None = None) -> dict:
         """Executes a GraphQL query against the GitHub API."""
         result = self.post(GITHUB_GRAPHQL_URL, json={"query": query, "variables": variables}).json()
         if "data" not in result or result.get("errors"):
@@ -331,7 +340,9 @@ class Action:
         else:
             self.post(f"{GITHUB_API_URL}/repos/{self.repository}/issues/{number}/comments", json={"body": comment})
 
-    def update_content(self, number: int, node_id: str, issue_type: str, title: str = None, body: str = None):
+    def update_content(
+        self, number: int, node_id: str, issue_type: str, title: str | None = None, body: str | None = None
+    ):
         """Updates the title and/or body of an issue, pull request, or discussion."""
         if issue_type == "discussion":
             variables = {"discussionId": node_id}
@@ -373,7 +384,7 @@ class Action:
     def handle_alert(self, number: int, node_id: str, issue_type: str, username: str, block: bool = False):
         """Handles content flagged as alert: updates content, locks, optionally closes and blocks user."""
         new_title = "Content Under Review"
-        new_body = """This post has been flagged for review by [Ultralytics Actions](https://ultralytics.com/actions) due to possible spam, abuse, or off-topic content. For more information please see our:
+        new_body = """This post has been flagged for review by [Ultralytics Actions](https://www.ultralytics.com/actions) due to possible spam, abuse, or off-topic content. For more information please see our:
 
 - [Code of Conduct](https://docs.ultralytics.com/help/code-of-conduct/)
 - [Security Policy](https://docs.ultralytics.com/help/security/)

actions/utils/openai_utils.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import json
 import os
 import time
 
@@ -12,6 +13,12 @@ from actions.utils.common_utils import check_links_in_string
 OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
 OPENAI_MODEL = os.getenv("OPENAI_MODEL", "gpt-5-2025-08-07")
 MAX_PROMPT_CHARS = round(128000 * 3.3 * 0.5)  # Max characters for prompt (50% of 128k context)
+MODEL_COSTS = {
+    "gpt-5-codex": (1.25, 10.00),
+    "gpt-5-2025-08-07": (1.25, 10.00),
+    "gpt-5-nano-2025-08-07": (0.05, 0.40),
+    "gpt-5-mini-2025-08-07": (0.25, 2.00),
+}
 SYSTEM_PROMPT_ADDITION = """Guidance:
   - Ultralytics Branding: Use YOLO11, YOLO26, etc., not YOLOv11, YOLOv26 (only older versions like YOLOv10 have a v). Always capitalize "HUB" in "Ultralytics HUB"; use "Ultralytics HUB", not "The Ultralytics HUB". 
   - Avoid Equations: Do not include equations or mathematical notations.
@@ -34,7 +41,7 @@ def remove_outer_codeblocks(string):
     return string
 
 
-def filter_labels(available_labels: dict, current_labels: list = None, is_pr: bool = False) -> dict:
+def filter_labels(available_labels: dict, current_labels: list | None = None, is_pr: bool = False) -> dict:
     """Filters labels by removing manually-assigned and mutually exclusive labels."""
     current_labels = current_labels or []
     filtered = available_labels.copy()
@@ -87,9 +94,9 @@ def get_pr_summary_prompt(repository: str, diff_text: str) -> tuple[str, bool]:
     return prompt, len(diff_text) > MAX_PROMPT_CHARS
 
 
-def get_pr_first_comment_template(repository: str) -> str:
+def get_pr_first_comment_template(repository: str, username: str) -> str:
     """Returns the PR first comment template with checklist (used only by unified PR open)."""
-    return f"""👋 Hello @username, thank you for submitting an `{repository}` 🚀 PR! To ensure a seamless integration of your work, please review the following checklist:
+    return f"""👋 Hello @{username}, thank you for submitting a `{repository}` 🚀 PR! To ensure a seamless integration of your work, please review the following checklist:
 
 - ✅ **Define a Purpose**: Clearly explain the purpose of your fix or feature in your PR description, and link to any [relevant issues](https://github.com/{repository}/issues). Ensure your commit messages are clear, concise, and adhere to the project's conventions.
 - ✅ **Synchronize with Source**: Confirm your PR is synchronized with the `{repository}` `main` branch. If it's behind, update it by clicking the 'Update branch' button or by running `git pull` and `git merge main` locally.
@@ -107,9 +114,10 @@ def get_completion(
     check_links: bool = True,
     remove: list[str] = (" @giscus[bot]",),
     temperature: float = 1.0,
-    reasoning_effort: str = None,
-    response_format: dict = None,
+    reasoning_effort: str | None = None,
+    response_format: dict | None = None,
     model: str = OPENAI_MODEL,
+    tools: list[dict] | None = None,
 ) -> str | dict:
     """Generates a completion using OpenAI's Responses API with retry logic."""
     assert OPENAI_API_KEY, "OpenAI API key is required."
@@ -122,25 +130,50 @@ def get_completion(
         data = {"model": model, "input": messages, "store": False, "temperature": temperature}
         if "gpt-5" in model:
             data["reasoning"] = {"effort": reasoning_effort or "low"}
+        if tools:
+            data["tools"] = tools
 
         try:
-            r = requests.post(url, json=data, headers=headers, timeout=600)
+            r = requests.post(url, json=data, headers=headers, timeout=(30, 900))
+            elapsed = r.elapsed.total_seconds()
             success = r.status_code == 200
-            print(f"{'✓' if success else '✗'} POST {url} → {r.status_code} ({r.elapsed.total_seconds():.1f}s)")
+            print(f"{'✓' if success else '✗'} POST {url} → {r.status_code} ({elapsed:.1f}s)")
+
+            # Retry server errors
+            if attempt < 2 and r.status_code >= 500:
+                print(f"Retrying {r.status_code} in {2**attempt}s (attempt {attempt + 1}/3)...")
+                time.sleep(2**attempt)
+                continue
+
             r.raise_for_status()
 
             # Parse response
+            response_json = r.json()
             content = ""
-            for item in r.json().get("output", []):
+            for item in response_json.get("output", []):
                 if item.get("type") == "message":
                     for c in item.get("content", []):
                         if c.get("type") == "output_text":
                             content += c.get("text") or ""
             content = content.strip()
 
-            if response_format and response_format.get("type") == "json_object":
-                import json
+            # Extract and print token usage
+            if usage := response_json.get("usage"):
+                input_tokens = usage.get("input_tokens", 0)
+                output_tokens = usage.get("output_tokens", 0)
+                thinking_tokens = (usage.get("output_tokens_details") or {}).get("reasoning_tokens", 0)
 
+                # Calculate cost
+                costs = MODEL_COSTS.get(model, (0.0, 0.0))
+                cost = (input_tokens * costs[0] + output_tokens * costs[1]) / 1e6
+
+                # Format summary
+                token_str = f"{input_tokens}→{output_tokens - thinking_tokens}"
+                if thinking_tokens:
+                    token_str += f" (+{thinking_tokens} thinking)"
+                print(f"{model} ({token_str} = {input_tokens + output_tokens} tokens, ${cost:.5f}, {elapsed:.1f}s)")
+
+            if response_format and response_format.get("type") == "json_object":
                 return json.loads(content)
 
             content = remove_outer_codeblocks(content)
@@ -154,33 +187,28 @@ def get_completion(
 
             return content
 
-        except (requests.exceptions.ConnectionError, requests.exceptions.Timeout):
+        except (requests.exceptions.ConnectionError, requests.exceptions.Timeout, json.JSONDecodeError) as e:
             if attempt < 2:
-                print(f"Connection error, retrying in {2**attempt}s")
+                print(f"Retrying {e.__class__.__name__} in {2**attempt}s (attempt {attempt + 1}/3)...")
                 time.sleep(2**attempt)
                 continue
             raise
-        except requests.exceptions.HTTPError as e:
-            status_code = getattr(e.response, "status_code", 0) if e.response else 0
-            if attempt < 2 and status_code >= 500:
-                print(f"Server error {status_code}, retrying in {2**attempt}s")
-                time.sleep(2**attempt)
-                continue
+        except requests.exceptions.HTTPError:  # 4xx errors
             raise
 
     return content
 
 
-def get_pr_open_response(repository: str, diff_text: str, title: str, body: str, available_labels: dict) -> dict:
+def get_pr_open_response(repository: str, diff_text: str, title: str, username: str, available_labels: dict) -> dict:
     """Generates unified PR response with summary, labels, and first comment in a single API call."""
     is_large = len(diff_text) > MAX_PROMPT_CHARS
 
     filtered_labels = filter_labels(available_labels, is_pr=True)
     labels_str = "\n".join(f"- {name}: {description}" for name, description in filtered_labels.items())
 
-    prompt = f"""You are processing a new GitHub pull request for the {repository} repository.
+    prompt = f"""You are processing a new GitHub PR by @{username} for the {repository} repository.
 
-Generate 3 outputs in a single JSON response for the PR titled {title} with the following diff:
+Generate 3 outputs in a single JSON response for the PR titled '{title}' with the following diff:
 {diff_text[:MAX_PROMPT_CHARS]}
 
 
@@ -202,7 +230,7 @@ Customized welcome message adapting the template below:
 - No spaces between bullet points
 
 Example comment template (adapt as needed, keep all links):
-{get_pr_first_comment_template(repository)}
+{get_pr_first_comment_template(repository, username)}
 
 Return ONLY valid JSON in this exact format:
 {{"summary": "...", "labels": [...], "first_comment": "..."}}"""

{ultralytics_actions-0.1.9.dist-info → ultralytics_actions-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ultralytics-actions
-Version: 0.1.9
+Version: 0.2.1
 Summary: Ultralytics Actions for GitHub automation and PR management.
 Author-email: Glenn Jocher <glenn.jocher@ultralytics.com>
 Maintainer-email: Ultralytics <hello@ultralytics.com>
@@ -38,111 +38,159 @@ Dynamic: license-file
 
 <a href="https://www.ultralytics.com/"><img src="https://raw.githubusercontent.com/ultralytics/assets/main/logo/Ultralytics_Logotype_Original.svg" width="320" alt="Ultralytics logo"></a>
 
-# 🚀 Ultralytics Actions: AI-powered formatting, labeling & PR summaries for Python and Markdown
+# 🚀 Ultralytics Actions
 
-Welcome to the [Ultralytics Actions](https://github.com/ultralytics/actions) repository, your go-to solution for maintaining consistent code quality across Ultralytics Python and Swift projects. This GitHub Action is designed to automate the formatting of Python, Markdown, and Swift files, ensuring adherence to our coding standards and enhancing project maintainability.
+Welcome to [Ultralytics Actions](https://github.com/ultralytics/actions) - a collection of GitHub Actions and Python tools for automating code quality, PR management, and CI/CD workflows across Ultralytics projects.
 
 [![GitHub Actions Marketplace](https://img.shields.io/badge/Marketplace-Ultralytics_Actions-blue?style=flat&logo=github)](https://github.com/marketplace/actions/ultralytics-actions)
 
 [![Actions CI](https://github.com/ultralytics/actions/actions/workflows/ci.yml/badge.svg)](https://github.com/ultralytics/actions/actions/workflows/ci.yml)
 [![Ultralytics Actions](https://github.com/ultralytics/actions/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/actions/actions/workflows/format.yml)
-[![List Open PRs](https://github.com/ultralytics/actions/actions/workflows/open-prs.yml/badge.svg)](https://github.com/ultralytics/actions/actions/workflows/open-prs.yml)
+[![Scan PRs](https://github.com/ultralytics/actions/actions/workflows/scan-prs.yml/badge.svg)](https://github.com/ultralytics/actions/actions/workflows/scan-prs.yml)
 [![codecov](https://codecov.io/github/ultralytics/actions/graph/badge.svg?token=DoizJ1WS6j)](https://codecov.io/github/ultralytics/actions)
 
 [![Ultralytics Discord](https://img.shields.io/discord/1089800235347353640?logo=discord&logoColor=white&label=Discord&color=blue)](https://discord.com/invite/ultralytics)
 [![Ultralytics Forums](https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com&logo=discourse&label=Forums&color=blue)](https://community.ultralytics.com/)
 [![Ultralytics Reddit](https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat&logo=reddit&logoColor=white&label=Reddit&color=blue)](https://reddit.com/r/ultralytics)
 
-## 📄 Actions Description
+## 📦 Repository Contents
 
-Ultralytics Actions automatically applies formats, updates, and enhancements using a suite of powerful tools:
+This repository provides three main components:
 
-- **Python Code:** Formatted using [Ruff](https://github.com/astral-sh/ruff), an extremely fast Python linter and formatter.
-- **Markdown Files:** Styled with [Prettier](https://github.com/prettier/prettier) to ensure consistent documentation appearance.
-- **Docstrings:** Cleaned and standardized using [docformatter](https://github.com/PyCQA/docformatter).
-- **Swift Code:** Formatted with [`swift-format`](https://github.com/swiftlang/swift-format) to maintain a uniform coding style across Swift projects. _(Note: Requires the `macos-latest` runner.)_
-- **Spell Check:** Common misspellings are caught using [codespell](https://github.com/codespell-project/codespell).
-- **Broken Links Check:** Broken links in documentation and Markdown files are identified using [Lychee](https://github.com/lycheeverse/lychee).
-- **PR Summary:** Concise Pull Request summaries are generated using [OpenAI](https://openai.com/) GPT-5, improving clarity and review efficiency.
-- **PR Review:** AI-powered code reviews identify critical bugs, security issues, and code quality concerns with suggested fixes.
-- **Auto-labeling:** Applies relevant labels to issues and PRs via [OpenAI](https://openai.com/) GPT-5 for intelligent categorization.
+1. **[Ultralytics Actions](#ultralytics-actions-main-action)** - Main GitHub Action for AI-powered code formatting, PR summaries, and auto-labeling
+2. **[Standalone Actions](#standalone-actions)** - Reusable composite actions for common CI/CD tasks
+3. **[Python Package](#python-package)** - `ultralytics-actions` package for programmatic use
 
-## 🛠️ How It Works
+## Ultralytics Actions (Main Action)
 
-Ultralytics Actions triggers on various GitHub events to streamline workflows:
+AI-powered formatting, labeling, and PR summaries for Python, Swift, and Markdown files.
 
-- **Push Events:** Automatically formats code when changes are pushed to the `main` branch.
-- **Pull Requests:**
-  - Ensures contributions meet formatting standards before merging.
-  - Generates a concise summary of changes using GPT-5.
-  - Provides AI-powered inline code reviews with suggested fixes for critical issues.
-  - Applies relevant labels using GPT-5 for intelligent categorization.
-- **Issues:** Automatically applies relevant labels using GPT-5 when new issues are created.
+### 📄 Features
 
-These automated actions help maintain high code quality, improve documentation clarity, and streamline the review process by providing consistent formatting, informative summaries, and appropriate categorization.
+- **Python Code:** Formatted using [Ruff](https://github.com/astral-sh/ruff), an extremely fast Python linter and formatter
+- **Markdown Files:** Styled with [Prettier](https://github.com/prettier/prettier) to ensure consistent documentation appearance
+- **Docstrings:** Cleaned and standardized using [docformatter](https://github.com/PyCQA/docformatter)
+- **Swift Code:** Formatted with [`swift-format`](https://github.com/swiftlang/swift-format) _(requires `macos-latest` runner)_
+- **Spell Check:** Common misspellings caught using [codespell](https://github.com/codespell-project/codespell)
+- **Broken Links Check:** Broken links identified using [Lychee](https://github.com/lycheeverse/lychee)
+- **PR Summary:** Concise Pull Request summaries generated using [OpenAI](https://openai.com/) GPT-5
+- **PR Review:** AI-powered code reviews identify critical bugs, security issues, and quality concerns with suggested fixes
+- **Auto-labeling:** Applies relevant labels to issues and PRs via [OpenAI](https://openai.com/) GPT-5
 
-## 🔧 Setting Up the Action
+### 🛠️ How It Works
 
-To integrate this action into your Ultralytics repository:
+Triggers on GitHub events to streamline workflows:
 
-1.  **Create a Workflow File:** In your repository, create a YAML file under `.github/workflows/`, for example, `ultralytics-actions.yml`.
+- **Push Events:** Automatically formats code when changes are pushed to `main`
+- **Pull Requests:** Ensures formatting standards, generates summaries, provides AI reviews, and applies labels
+- **Issues:** Automatically applies relevant labels using GPT-5
 
-2.  **Add the Action:** Configure the Ultralytics Actions in your workflow file as shown below:
+### 🔧 Setup
 
-    ```yaml
-    # Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
+Create `.github/workflows/ultralytics-actions.yml`:
 
-    # Ultralytics Actions https://github.com/ultralytics/actions
-    # This workflow formats code and documentation in PRs to Ultralytics standards
+```yaml
+# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
 
-    name: Ultralytics Actions
+# Ultralytics Actions https://github.com/ultralytics/actions
+# This workflow formats code and documentation in PRs to Ultralytics standards
 
-    on:
-      issues:
-        types: [opened]
-      pull_request:
-        branches: [main]
-        types: [opened, closed, synchronize, review_requested]
+name: Ultralytics Actions
 
-    permissions:
-      contents: write # Modify code in PRs
-      pull-requests: write # Add comments and labels to PRs
-      issues: write # Add comments and labels to issues
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    branches: [main]
+    types: [opened, closed, synchronize, review_requested]
 
-    jobs:
-      actions:
-        runs-on: ubuntu-latest
-        steps:
-          - name: Run Ultralytics Actions
-            uses: ultralytics/actions@main
-            with:
-              token: ${{ secrets.GITHUB_TOKEN }} # Auto-generated token
-              labels: true # Auto-label issues/PRs using AI
-              python: true # Format Python with Ruff and docformatter
-              prettier: true # Format YAML, JSON, Markdown, CSS
-              swift: false # Format Swift (requires macos-latest)
-              dart: false # Format Dart/Flutter
-              spelling: true # Check spelling with codespell
-              links: true # Check broken links with Lychee
-              summary: true # Generate AI-powered PR summaries
-              openai_api_key: ${{ secrets.OPENAI_API_KEY }} # Powers PR summaries, labels and comments
-              brave_api_key: ${{ secrets.BRAVE_API_KEY }} # Used for broken link resolution
-    ```
+permissions:
+  contents: write # Modify code in PRs
+  pull-requests: write # Add comments and labels to PRs
+  issues: write # Add comments and labels to issues
 
-3.  **Customize:** Adjust the `runs-on` runner and the boolean flags (`labels`, `python`, `prettier`, `swift`, `spelling`, `links`, `summary`) based on your project's needs. Remember to add your `OPENAI_API_KEY` as a secret in your repository settings if you enable `labels` or `summary`.
+jobs:
+  actions:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run Ultralytics Actions
+        uses: ultralytics/actions@main
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }} # Auto-generated token
+          labels: true # Auto-label issues/PRs using AI
+          python: true # Format Python with Ruff and docformatter
+          prettier: true # Format YAML, JSON, Markdown, CSS
+          swift: false # Format Swift (requires macos-latest)
+          dart: false # Format Dart/Flutter
+          spelling: true # Check spelling with codespell
+          links: true # Check broken links with Lychee
+          summary: true # Generate AI-powered PR summaries
+          openai_api_key: ${{ secrets.OPENAI_API_KEY }} # Powers PR summaries, labels and reviews
+          brave_api_key: ${{ secrets.BRAVE_API_KEY }} # Used for broken link resolution
+```
+
+## Standalone Actions
+
+Reusable composite actions for common CI/CD tasks. Each can be used independently in your workflows.
+
+### 1. Retry Action
+
+Retry failed commands with exponential backoff.
+
+```yaml
+- uses: ultralytics/actions/retry@main
+  with:
+    command: npm install
+    max_attempts: 3
+    timeout_minutes: 5
+```
+
+[**📖 Full Documentation →**](retry/README.md)
+
+### 2. Cleanup Disk Action
+
+Free up disk space on GitHub runners by removing unnecessary packages and files.
+
+```yaml
+- uses: ultralytics/actions/cleanup-disk@main
+```
+
+[**📖 Full Documentation →**](cleanup-disk/README.md)
+
+### 3. Scan PRs Action
+
+List open PRs across an organization and auto-merge eligible Dependabot PRs.
+
+```yaml
+- uses: ultralytics/actions/scan-prs@main
+  with:
+    token: ${{ secrets.GITHUB_TOKEN }}
+    org: ultralytics # Optional: defaults to ultralytics
+    visibility: public # Optional: public, private, internal, or all
+```
+
+[**📖 Full Documentation →**](scan-prs/README.md)
 
 ## Python Package
 
-Install the `ultralytics-actions` Python package directly with Pip:
+Install `ultralytics-actions` for programmatic access to action utilities.
 
 [![PyPI - Version](https://img.shields.io/pypi/v/ultralytics-actions?logo=pypi&logoColor=white)](https://pypi.org/project/ultralytics-actions/)
 [![Ultralytics Downloads](https://static.pepy.tech/badge/ultralytics-actions)](https://clickpy.clickhouse.com/dashboard/ultralytics-actions)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ultralytics-actions?logo=python&logoColor=gold)](https://pypi.org/project/ultralytics-actions/)
 
-```sh
+```bash
 pip install ultralytics-actions
 ```
 
+**Available Modules:**
+
+- `actions.review_pr` - AI-powered PR review
+- `actions.summarize_pr` - Generate PR summaries
+- `actions.scan_prs` - Scan and manage organization PRs
+- `actions.first_interaction` - Welcome message for new contributors
+- And more in `actions/` directory
+
 ## 💡 Contribute
 
 Ultralytics thrives on community collaboration, and we deeply value your contributions! Please see our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) for details on how you can get involved. We also encourage you to share your feedback through our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A huge thank you 🙏 to all our contributors!

ultralytics_actions-0.2.1.dist-info/RECORD

@@ -0,0 +1,20 @@
+actions/__init__.py,sha256=G-r-dtUaDXDKiTJuqW8GafMpIpOjbCVlG1ETyC4_yqY,881
+actions/dispatch_actions.py,sha256=ljlFR1o8m1qTHbStsJJVMVDdJv7iVqMfdPzKlZyKXl8,6743
+actions/first_interaction.py,sha256=wcKzLEUJmYnHmtwn-sz3N5erwftMT9jn7XxSKATAmXY,9815
+actions/review_pr.py,sha256=QqYmWE37sA4mJ6bPcY5M2dlNc1lRJPwT7XcJJFP1C7c,17466
+actions/scan_prs.py,sha256=9Gu4EHmLjdShIlkoCQfIrcxLpMZeOOnpKEyv_mVc3rU,7407
+actions/summarize_pr.py,sha256=0y4Cl4_ZMMtDWVhxwWasn3mHo_4GCnegJrf29yujUYM,5715
+actions/summarize_release.py,sha256=8D5EOQ36mho1HKtWD2J-IDH_xJJb3q0shgXZSdemmDM,9078
+actions/update_file_headers.py,sha256=E5fKYLdeW16-BHCcuqxohGpGZqgEh-WX4ZmCQJw2R90,6684
+actions/update_markdown_code_blocks.py,sha256=w3DTRltg2Rmr4-qrNawv_S2vJbheKE0tne1iz79FzXg,8692
+actions/utils/__init__.py,sha256=Uf7S5qYHS59zoAP9uKVIZwhpUbgyI947dD9jAWu50Lg,1115
+actions/utils/common_utils.py,sha256=InBc-bsXcwzQYjuDxtrrm3bj7J-70U54G0s2nQKgCg8,12052
+actions/utils/github_utils.py,sha256=5yzNIiu7-WBmH1-gSi4O31m1Fwd4k8pfbwM2BPVGf88,19989
+actions/utils/openai_utils.py,sha256=07g5NsfAfSuJ6CqWWQxsZ0MR4_kh6-Rjmud_iGPm49U,11965
+actions/utils/version_utils.py,sha256=EIbm3iZVNyNl3dh8aNz_9ITeTC93ZxfyUzIRkO3tSXw,3242
+ultralytics_actions-0.2.1.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+ultralytics_actions-0.2.1.dist-info/METADATA,sha256=1kN57DVDjQZMQGlhfF_3ugsfYGaXCsxFM-5guwrgFT4,12478
+ultralytics_actions-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ultralytics_actions-0.2.1.dist-info/entry_points.txt,sha256=n_VbDs3Xj33daaeN_2D72UTEuyeH8hVc6-CPH55ymkY,496
+ultralytics_actions-0.2.1.dist-info/top_level.txt,sha256=5apM5x80QlJcGbACn1v3fkmIuL1-XQCKcItJre7w7Tw,8
+ultralytics_actions-0.2.1.dist-info/RECORD,,

ultralytics_actions-0.1.9.dist-info/RECORD

@@ -1,19 +0,0 @@
-actions/__init__.py,sha256=j5AWc7zYYZL-B2DuboeBC58Yx3gjYg4eHLe1Np7bQxQ,772
-actions/dispatch_actions.py,sha256=i81UeHrYudAsOUFUfN71u6X-1cmZaZaiiTj6p2rvz8A,4217
-actions/first_interaction.py,sha256=QxPsLjd-m2G-QYOcQb2hQfIB_alupzeZzSHTk-jw0bg,9856
-actions/review_pr.py,sha256=tZztKjHmoGU3XBXy4dsxCWTHQGQIUpjmOGE8sNtxYfg,17329
-actions/summarize_pr.py,sha256=3nFotiZX42dz-mzDQ9wcoUILJKkcaxrC5EeyxvuvY60,5775
-actions/summarize_release.py,sha256=iCXa9a1DcOrDVe8pMWEsYKgDxuIOhIgMsYymElOLK6o,9083
-actions/update_file_headers.py,sha256=E5fKYLdeW16-BHCcuqxohGpGZqgEh-WX4ZmCQJw2R90,6684
-actions/update_markdown_code_blocks.py,sha256=w3DTRltg2Rmr4-qrNawv_S2vJbheKE0tne1iz79FzXg,8692
-actions/utils/__init__.py,sha256=unjXYIFNFeHrdC8LooDFVWlj6fAdGhssUgASo5229zY,1073
-actions/utils/common_utils.py,sha256=2DRvcyCgmn507w3T4FJcQSZNI9KC1gVUb8CnJqPapD0,11943
-actions/utils/github_utils.py,sha256=OKbUOjqOdu7rTLWZdFsB2uMggEtcwrjW98ecBT8lFMg,19714
-actions/utils/openai_utils.py,sha256=WPRiLJYOMEsmmWcQ-IirnQp1N37EQhO9OvgQaK9JIV0,10706
-actions/utils/version_utils.py,sha256=EIbm3iZVNyNl3dh8aNz_9ITeTC93ZxfyUzIRkO3tSXw,3242
-ultralytics_actions-0.1.9.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-ultralytics_actions-0.1.9.dist-info/METADATA,sha256=E0FUdK1lP_igrfWdDrUYyx30-vS6BtOgrj0kyEsmemk,12368
-ultralytics_actions-0.1.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ultralytics_actions-0.1.9.dist-info/entry_points.txt,sha256=n_VbDs3Xj33daaeN_2D72UTEuyeH8hVc6-CPH55ymkY,496
-ultralytics_actions-0.1.9.dist-info/top_level.txt,sha256=5apM5x80QlJcGbACn1v3fkmIuL1-XQCKcItJre7w7Tw,8
-ultralytics_actions-0.1.9.dist-info/RECORD,,