quickcall-integrations 0.3.2__tar.gz → 0.3.3__tar.gz

{quickcall_integrations-0.3.2 → quickcall_integrations-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.3.2
+Version: 0.3.3
 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.2 → quickcall_integrations-0.3.3}/mcp_server/tools/github_tools.py

@@ -164,10 +164,8 @@ def create_github_tools(mcp: FastMCP) -> None:
         List pull requests for a GitHub repository.
 
         Returns PRs sorted by last updated.
-        Requires QuickCall authentication with GitHub connected.
-
-        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.
+        Use detail_level='summary' (default) to avoid context overflow.
+        Use get_prs() to fetch full details for specific PRs.
         """
         try:
             client = _get_client()
@@ -286,10 +284,8 @@ def create_github_tools(mcp: FastMCP) -> None:
         List commits for a GitHub repository.
 
         Returns commits sorted by date (newest first).
-        Requires QuickCall authentication with GitHub connected.
-
-        Use detail_level='summary' (default) to avoid context overflow with large result sets.
-        Use get_commit(sha) to get full details for specific commits when needed.
+        Use detail_level='summary' (default) to avoid context overflow.
+        Use get_commit(sha) for full details on a specific commit.
         """
         try:
             client = _get_client()
@@ -413,18 +409,17 @@ def create_github_tools(mcp: FastMCP) -> None:
         ),
     ) -> dict:
         """
-        Prepare appraisal data by fetching ALL merged PRs with full details.
-
-        USE THIS TOOL FOR APPRAISALS AND PERFORMANCE REVIEWS!
+        Fetch all merged PRs for appraisals/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
+        Returns:
+        - file_path: temp file with full PR data (additions, deletions, files)
+        - pr_titles: list of {number, title, repo} for Claude to review
+        - count: total PRs found
 
-        DO NOT use search_merged_prs for appraisals - it doesn't include stats
-        and causes context overflow with large result sets.
+        Workflow:
+        1. Call this tool → get file_path and pr_titles
+        2. Review pr_titles, pick significant PRs
+        3. Call get_appraisal_pr_details(file_path, [pr_numbers]) for full details
         """
         import json
         import tempfile
@@ -533,13 +528,12 @@ def create_github_tools(mcp: FastMCP) -> None:
         ),
     ) -> dict:
         """
-        Get full PR details from the appraisal data dump.
+        Read full PR details from the appraisal data file.
 
-        This reads from the local file created by prepare_appraisal_data.
-        NO API CALLS are made - all data comes from the cached dump.
+        Call this after prepare_appraisal_data with selected PR numbers.
+        Reads from the cached file - no API calls made.
 
-        Use this after prepare_appraisal_data to get full details for specific PRs
-        that Claude has identified as important for the appraisal.
+        Returns: additions, deletions, files changed, body for selected PRs.
         """
         import json
 

{quickcall_integrations-0.3.2 → quickcall_integrations-0.3.3}/plugins/quickcall/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "quickcall",
   "description": "Integrate quickcall into dev workflows - eliminate interruptions for developers. Ask about your work, get instant answers. No more context switching.",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "author": {
     "name": "Sagar Sarkale"
   }

{quickcall_integrations-0.3.2 → quickcall_integrations-0.3.3}/plugins/quickcall/commands/appraisal.md

@@ -16,11 +16,10 @@ Parse `$ARGUMENTS` for time period:
 
 ## Instructions
 
-**IMPORTANT:** Only use these two MCP tools for appraisals:
-1. `prepare_appraisal_data` - fetches and dumps all PR data to a temp file
-2. `get_appraisal_pr_details` - reads specific PRs from that file (no API calls)
+**Two-step flow (avoids context overflow):**
 
-Do NOT use `get_prs`, `list_prs`, or any other tools - they will overflow context.
+1. `prepare_appraisal_data` → fetches all PRs, dumps to file, returns titles + PR numbers
+2. `get_appraisal_pr_details` → Claude picks which PRs to get details for, reads from file
 
 ---
 
@@ -28,9 +27,8 @@ Do NOT use `get_prs`, `list_prs`, or any other tools - they will overflow contex
 
    **Option A - GitHub API (preferred):**
    - Call `prepare_appraisal_data(days=X)` with the parsed time period
-   - This fetches ALL merged PRs with full stats in PARALLEL
-   - Dumps everything to a temp file (avoids context overflow)
-   - Returns: `file_path` + list of `pr_titles` (number, title, repo only)
+   - This fetches ALL merged PRs with full stats in PARALLEL and dumps to a temp file
+   - Returns: `file_path` + `pr_titles` (number, title, repo for each PR)
    - Optional: pass `org` or `repo` parameter to filter
 
    **Option B - Local Git (fallback):**
@@ -44,11 +42,10 @@ Do NOT use `get_prs`, `list_prs`, or any other tools - they will overflow contex
    - **Bug fixes**: (fix:, bugfix:, hotfix:, resolve, patch)
    - **Chores**: Maintenance work (docs:, test:, ci:, chore:, refactor:, bump)
 
-3. **Get details for top accomplishments:**
-   - Pick the top 5-10 significant PRs from the categorized list
-   - Call `get_appraisal_pr_details(file_path, [pr_numbers])`
-   - This reads from the temp file - NO additional API calls
-   - Returns full details: additions, deletions, files, body
+3. **Get full details for selected PRs:**
+   - Based on the titles, pick the top 5-10 significant PRs worth highlighting
+   - Call `get_appraisal_pr_details(file_path, [pr_numbers])` with the selected PR numbers
+   - Returns: full details (additions, deletions, files, body) for those PRs only
 
 4. **Calculate summary metrics:**
    - Total PRs merged by category

{quickcall_integrations-0.3.2 → quickcall_integrations-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quickcall-integrations"
-version = "0.3.2"
+version = "0.3.3"
 description = "MCP server with developer integrations for Claude Code and Cursor"
 readme = "README.md"
 requires-python = ">=3.10"