quickcall-integrations 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

mcp_server/tools/github_tools.py

@@ -195,40 +195,60 @@ def create_github_tools(mcp: FastMCP) -> None:
             raise ToolError(f"Failed to list pull requests: {str(e)}")
 
     @mcp.tool(tags={"github", "prs"})
-    def get_pr(
-        pr_number: int = Field(..., description="Pull request number", gt=0),
-        owner: Optional[str] = Field(
-            default=None,
-            description="Repository owner. Uses your GitHub username if not specified.",
-        ),
-        repo: Optional[str] = Field(
-            default=None,
-            description="Repository name. Required.",
+    def get_prs(
+        pr_refs: List[dict] = Field(
+            ...,
+            description="List of PR references. Each item should have 'owner', 'repo', and 'number' keys. "
+            "Example: [{'owner': 'org', 'repo': 'myrepo', 'number': 123}, ...]",
         ),
     ) -> dict:
         """
-        Get detailed information about a specific pull request.
+        Get detailed information about one or more pull requests.
+
+        Works for single or multiple PRs - fetches in parallel when multiple.
+        Each PR ref needs owner, repo, and number.
 
-        Includes title, description, status, files changed, and review status.
+        Returns full PR details including additions, deletions, and files changed.
         Requires QuickCall authentication with GitHub connected.
         """
         try:
             client = _get_client()
-            pr = client.get_pr(pr_number, owner=owner, repo=repo)
 
-            if not pr:
-                raise ToolError(f"Pull request #{pr_number} not found")
+            # Validate input
+            validated_refs = []
+            for ref in pr_refs:
+                if not isinstance(ref, dict):
+                    raise ToolError(f"Invalid PR ref (must be dict): {ref}")
+                if "number" not in ref:
+                    raise ToolError(f"Missing 'number' in PR ref: {ref}")
+                if "owner" not in ref or "repo" not in ref:
+                    raise ToolError(
+                        f"Missing 'owner' or 'repo' in PR ref: {ref}. "
+                        "Each ref must have owner, repo, and number."
+                    )
+                validated_refs.append(
+                    {
+                        "owner": ref["owner"],
+                        "repo": ref["repo"],
+                        "number": int(ref["number"]),
+                    }
+                )
+
+            if not validated_refs:
+                return {"count": 0, "prs": []}
+
+            # Fetch all PRs in parallel
+            prs = client.fetch_prs_parallel(validated_refs, max_workers=10)
 
-            return {"pr": pr.model_dump()}
+            return {
+                "count": len(prs),
+                "requested": len(validated_refs),
+                "prs": prs,
+            }
         except ToolError:
             raise
-        except ValueError as e:
-            raise ToolError(
-                f"Repository not specified: {str(e)}. "
-                f"Please provide both owner and repo parameters."
-            )
         except Exception as e:
-            raise ToolError(f"Failed to get pull request #{pr_number}: {str(e)}")
+            raise ToolError(f"Failed to fetch PRs: {str(e)}")
 
     @mcp.tool(tags={"github", "commits"})
     def list_commits(
@@ -373,97 +393,6 @@ def create_github_tools(mcp: FastMCP) -> None:
         except Exception as e:
             raise ToolError(f"Failed to list branches: {str(e)}")
 
-    @mcp.tool(tags={"github", "prs", "appraisal"})
-    def search_merged_prs(
-        author: Optional[str] = Field(
-            default=None,
-            description="GitHub username to filter by. Defaults to authenticated user if not specified.",
-        ),
-        days: int = Field(
-            default=180,
-            description="Number of days to look back (default: 180 for ~6 months)",
-        ),
-        org: Optional[str] = Field(
-            default=None,
-            description="GitHub org to search within. If not specified, searches all accessible repos.",
-        ),
-        repo: Optional[str] = Field(
-            default=None,
-            description="Specific repo in 'owner/repo' format (e.g., 'revolving-org/supabase'). Overrides org if specified.",
-        ),
-        limit: int = Field(
-            default=100,
-            description="Maximum PRs to return (default: 100)",
-        ),
-        detail_level: str = Field(
-            default="summary",
-            description="'summary' for minimal fields (number, title, merged_at, repo, owner, html_url, author), "
-            "'full' adds body and labels. Use 'summary' for large result sets.",
-        ),
-    ) -> dict:
-        """
-        Search for merged pull requests by author within a time period.
-
-        USE FOR APPRAISALS: This tool is ideal for gathering contribution data
-        for performance reviews. Returns basic PR info - use get_pr for full
-        details (additions, deletions, files) on specific PRs.
-
-        Claude should analyze the returned PRs to:
-
-        1. CATEGORIZE by type (look at PR title/labels):
-           - Features: "feat:", "add:", "implement", "new", "create"
-           - Enhancements: "improve:", "update:", "perf:", "optimize", "enhance"
-           - Bug fixes: "fix:", "bugfix:", "hotfix:", "resolve", "patch"
-           - Chores: "chore:", "docs:", "test:", "ci:", "refactor:", "bump"
-
-        2. IDENTIFY top PRs worth highlighting (call get_pr for detailed metrics)
-
-        3. SUMMARIZE for appraisal with accomplishments grouped by category
-
-        Use detail_level='summary' (default) to avoid context overflow with large result sets.
-        Use get_pr(number) to get full details for specific PRs when needed.
-
-        Requires QuickCall authentication with GitHub connected.
-        """
-        try:
-            client = _get_client()
-
-            # Calculate since_date from days
-            from datetime import datetime, timedelta, timezone
-
-            since_date = (datetime.now(timezone.utc) - timedelta(days=days)).strftime(
-                "%Y-%m-%d"
-            )
-
-            # Use authenticated user if author not specified
-            if not author:
-                creds = get_credential_store().get_api_credentials()
-                if creds and creds.github_username:
-                    author = creds.github_username
-
-            prs = client.search_merged_prs(
-                author=author,
-                since_date=since_date,
-                org=org,
-                repo=repo,
-                limit=limit,
-                detail_level=detail_level,
-            )
-
-            return {
-                "count": len(prs),
-                "detail_level": detail_level,
-                "period": f"Last {days} days",
-                "author": author,
-                "org": org,
-                "repo": repo,
-                "prs": prs,
-            }
-        except ToolError:
-            raise
-        except Exception as e:
-            raise ToolError(f"Failed to search merged PRs: {str(e)}")
-
     @mcp.tool(tags={"github", "prs", "appraisal"})
     def prepare_appraisal_data(
         author: Optional[str] = Field(
@@ -486,14 +415,16 @@ def create_github_tools(mcp: FastMCP) -> None:
         """
         Prepare appraisal data by fetching ALL merged PRs with full details.
 
-        This tool:
-        1. Searches for all merged PRs by the author
-        2. Fetches FULL details (additions, deletions, files) for each PR IN PARALLEL
-        3. Dumps everything to a JSON file for later queries
-        4. Returns the file path + list of PR titles for Claude to review
+        USE THIS TOOL FOR APPRAISALS AND PERFORMANCE REVIEWS!
+
+        This is the recommended tool for gathering contribution data because it:
+        1. Fetches ALL merged PRs with full stats (additions, deletions) in PARALLEL
+        2. Dumps everything to a local file (avoids context overflow)
+        3. Returns just PR titles for you to review
+        4. Then use get_appraisal_pr_details(file_path, pr_numbers) for selected PRs
 
-        USE THIS for appraisals instead of search_merged_prs + multiple get_pr calls.
-        After calling this, use get_appraisal_pr_details to get full info for specific PRs.
+        DO NOT use search_merged_prs for appraisals - it doesn't include stats
+        and causes context overflow with large result sets.
         """
         import json
         import tempfile

{quickcall_integrations-0.3.0.dist-info → quickcall_integrations-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.3.0
+Version: 0.3.2
 Summary: MCP server with developer integrations for Claude Code and Cursor
 Requires-Python: >=3.10
 Requires-Dist: fastmcp>=2.13.0

{quickcall_integrations-0.3.0.dist-info → quickcall_integrations-0.3.2.dist-info}/RECORD

@@ -11,10 +11,10 @@ mcp_server/resources/slack_resources.py,sha256=b_CPxAicwkF3PsBXIat4QoLbDUHM2g_iP
 mcp_server/tools/__init__.py,sha256=vIR2ujAaTXm2DgpTsVNz3brI4G34p-Jeg44Qe0uvWc0,405
 mcp_server/tools/auth_tools.py,sha256=kCPjPC1jrVz0XaRAwPea-ue8ybjLLTxyILplBDJ9Mv4,24477
 mcp_server/tools/git_tools.py,sha256=jyCTQR2eSzUFXMt0Y8x66758-VY8YCY14DDUJt7GY2U,13957
-mcp_server/tools/github_tools.py,sha256=0WUX4r9F1vd0ZUlUQvG1239zuqWCuBFrG6a48_m5XTY,25667
+mcp_server/tools/github_tools.py,sha256=N4VvJu1X-1rWNTqVovYmKKmfbrJYtZ5f9kM2ftFEBVo,23002
 mcp_server/tools/slack_tools.py,sha256=-HVE_x3Z1KMeYGi1xhyppEwz5ZF-I-ZD0-Up8yBeoYE,11796
 mcp_server/tools/utility_tools.py,sha256=1WiOpJivu6Ug9OLajm77lzsmFfBPgWHs8e1hNCEX_Aw,3359
-quickcall_integrations-0.3.0.dist-info/METADATA,sha256=5BIm2jpjEC6uCdnERPMZ4hArn9GyZUZXda31KNERd7k,7043
-quickcall_integrations-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-quickcall_integrations-0.3.0.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
-quickcall_integrations-0.3.0.dist-info/RECORD,,
+quickcall_integrations-0.3.2.dist-info/METADATA,sha256=_xknARbrRiIxzxz38TCAe1yW9WYPLMfl_cyzm-Nx5JA,7043
+quickcall_integrations-0.3.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+quickcall_integrations-0.3.2.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
+quickcall_integrations-0.3.2.dist-info/RECORD,,