#!/usr/bin/env python # /// script # requires-python = ">=3.10" # dependencies = [ # "httpx", # ] # /// """ Auto-close duplicate GitHub issues. This script runs on a schedule to automatically close issues that have been marked as duplicates and haven't received any preventing activity. """ import os from dataclasses import dataclass from datetime import datetime, timedelta, timezone import httpx @dataclass class Issue: """Represents a GitHub issue.""" number: int title: str state: str created_at: str user_id: int user_login: str @dataclass class Comment: """Represents a GitHub comment.""" id: int body: str created_at: str user_id: int user_login: str user_type: str @dataclass class Reaction: """Represents a reaction on a comment.""" user_id: int user_login: str content: str class GitHubClient: """Client for interacting with GitHub API.""" def __init__(self, token: str, owner: str, repo: str): self.token = token self.owner = owner self.repo = repo self.headers = { "Authorization": f"token {token}", "Accept": "application/vnd.github.v3+json", } self.base_url = f"https://api.github.com/repos/{owner}/{repo}" def get_potential_duplicate_issues(self) -> list[Issue]: """Fetch open issues with the potential-duplicate label.""" url = f"{self.base_url}/issues" issues = [] with httpx.Client() as client: page = 1 while page <= 10: # Safety limit response = client.get( url, headers=self.headers, params={ "state": "open", "labels": "potential-duplicate", "per_page": 100, "page": page, }, ) if response.status_code != 200: print(f"Error fetching issues: {response.status_code}") break data = response.json() if not data: break for item in data: # Skip pull requests if "pull_request" in item: continue issues.append( Issue( number=item["number"], title=item["title"], state=item["state"], created_at=item["created_at"], user_id=item["user"]["id"], user_login=item["user"]["login"], ) ) page += 1 return issues def get_issue_comments(self, issue_number: int) -> list[Comment]: """Fetch all comments for an issue.""" url = f"{self.base_url}/issues/{issue_number}/comments" comments = [] with httpx.Client() as client: page = 1 while True: response = client.get( url, headers=self.headers, params={"page": page, "per_page": 100} ) if response.status_code != 200: break data = response.json() if not data: break for comment_data in data: comments.append( Comment( id=comment_data["id"], body=comment_data["body"], created_at=comment_data["created_at"], user_id=comment_data["user"]["id"], user_login=comment_data["user"]["login"], user_type=comment_data["user"]["type"], ) ) page += 1 if page > 10: # Safety limit break return comments def get_comment_reactions( self, issue_number: int, comment_id: int ) -> list[Reaction]: """Fetch reactions for a specific comment.""" url = f"{self.base_url}/issues/{issue_number}/comments/{comment_id}/reactions" reactions = [] with httpx.Client() as client: response = client.get(url, headers=self.headers) if response.status_code != 200: return reactions data = response.json() for reaction_data in data: reactions.append( Reaction( user_id=reaction_data["user"]["id"], user_login=reaction_data["user"]["login"], content=reaction_data["content"], ) ) return reactions def remove_label(self, issue_number: int, label: str) -> bool: """Remove a label from an issue.""" url = f"{self.base_url}/issues/{issue_number}/labels/{label}" with httpx.Client() as client: response = client.delete(url, headers=self.headers) return response.status_code in [200, 204] def close_issue(self, issue_number: int, comment: str) -> bool: """Close an issue with a comment and add duplicate label.""" # First add the comment comment_url = f"{self.base_url}/issues/{issue_number}/comments" with httpx.Client() as client: response = client.post( comment_url, headers=self.headers, json={"body": comment} ) if response.status_code != 201: print(f"Failed to add comment to issue #{issue_number}") return False # Swap labels: remove potential-duplicate, add duplicate self.remove_label(issue_number, "potential-duplicate") labels_url = f"{self.base_url}/issues/{issue_number}/labels" with httpx.Client() as client: response = client.post( labels_url, headers=self.headers, json={"labels": ["duplicate"]} ) if response.status_code not in [200, 201]: print(f"Failed to add duplicate label to issue #{issue_number}") # Then close the issue issue_url = f"{self.base_url}/issues/{issue_number}" with httpx.Client() as client: response = client.patch( issue_url, headers=self.headers, json={"state": "closed"} ) return response.status_code == 200 def find_duplicate_comment(comments: list[Comment]) -> Comment | None: """Find a bot comment marking the issue as duplicate.""" for comment in comments: # Check for the specific duplicate message format from a bot if ( comment.user_type == "Bot" and "possible duplicate issues" in comment.body.lower() ): return comment return None def was_already_auto_closed(comments: list[Comment]) -> bool: """Check if this issue was already auto-closed once.""" for comment in comments: if ( comment.user_type == "Bot" and "closing this issue as a duplicate" in comment.body.lower() ): return True return False def is_past_cooldown(duplicate_comment: Comment) -> bool: """Check if the 3-day cooldown period has passed.""" comment_date = datetime.fromisoformat( duplicate_comment.created_at.replace("Z", "+00:00") ) three_days_ago = datetime.now(timezone.utc) - timedelta(days=3) return comment_date <= three_days_ago def has_human_activity( issue: Issue, duplicate_comment: Comment, all_comments: list[Comment], reactions: list[Reaction], ) -> bool: """Check if there's human activity that should prevent auto-closure.""" comment_date = datetime.fromisoformat( duplicate_comment.created_at.replace("Z", "+00:00") ) # Check for preventing reactions (thumbs down) for reaction in reactions: if reaction.content in ["-1", "confused"]: print( f"Issue #{issue.number}: Has preventing reaction from {reaction.user_login}" ) return True # Check for any human comment after the duplicate marking for comment in all_comments: comment_date_check = datetime.fromisoformat( comment.created_at.replace("Z", "+00:00") ) if comment_date_check > comment_date: if comment.user_type != "Bot": print( f"Issue #{issue.number}: {comment.user_login} commented after duplicate marking" ) return True return False def main(): """Main entry point for auto-closing duplicate issues.""" print("[DEBUG] Starting auto-close duplicates script") # Get environment variables token = os.environ.get("GITHUB_TOKEN") if not token: raise ValueError("GITHUB_TOKEN environment variable is required") owner = os.environ.get("GITHUB_REPOSITORY_OWNER", "prefecthq") repo = os.environ.get("GITHUB_REPOSITORY_NAME", "fastmcp") print(f"[DEBUG] Repository: {owner}/{repo}") # Initialize client client = GitHubClient(token, owner, repo) # Only fetch issues with the potential-duplicate label all_issues = client.get_potential_duplicate_issues() print(f"[DEBUG] Found {len(all_issues)} open issues with potential-duplicate label") closed_count = 0 cleared_count = 0 for issue in all_issues: # Get comments for this issue comments = client.get_issue_comments(issue.number) # Look for duplicate marking comment duplicate_comment = find_duplicate_comment(comments) if not duplicate_comment: # Label exists but no bot comment - clean up the label print(f"[DEBUG] Issue #{issue.number} has label but no duplicate comment") client.remove_label(issue.number, "potential-duplicate") cleared_count += 1 continue # Skip if already auto-closed once (someone reopened it intentionally) if was_already_auto_closed(comments): print( f"[DEBUG] Issue #{issue.number} was already auto-closed, removing label" ) client.remove_label(issue.number, "potential-duplicate") cleared_count += 1 continue print(f"[DEBUG] Issue #{issue.number} has duplicate comment") # Still in cooldown period - skip for now, check again later if not is_past_cooldown(duplicate_comment): print(f"[DEBUG] Issue #{issue.number} still in 3-day cooldown period") continue # Get reactions on the duplicate comment reactions = client.get_comment_reactions(issue.number, duplicate_comment.id) # Check for human activity that prevents closure if has_human_activity(issue, duplicate_comment, comments, reactions): print(f"[DEBUG] Issue #{issue.number} has human activity, removing label") client.remove_label(issue.number, "potential-duplicate") cleared_count += 1 continue # No human activity after cooldown - close as duplicate close_message = ( "Closing this issue as a duplicate based on the automated analysis above.\n\n" "The duplicate issues identified contain existing discussions and potential solutions. " "Please add your 👍 to those issues if they match your use case.\n\n" "If this was closed in error, please leave a comment explaining why this is not " "a duplicate and we'll reopen it." ) if client.close_issue(issue.number, close_message): print(f"[SUCCESS] Closed issue #{issue.number} as duplicate") closed_count += 1 else: print(f"[ERROR] Failed to close issue #{issue.number}") print( f"[DEBUG] Processing complete. Closed {closed_count} duplicates, " f"cleared {cleared_count} from review" ) if __name__ == "__main__": main()