quickcall-integrations 0.3.8__py3-none-any.whl → 0.3.9__py3-none-any.whl

mcp_server/tools/auth_tools.py

@@ -10,7 +10,7 @@ Also provides GitHub PAT authentication for users who can't install the GitHub A
 import os
 import logging
 import webbrowser
-from typing import Dict, Any
+from typing import Dict, Any, Optional
 
 import httpx
 from github import Github, Auth, GithubException
@@ -20,6 +20,7 @@ from pydantic import Field
 from mcp_server.auth import (
     get_credential_store,
     DeviceFlowAuth,
+    get_github_pat,
 )
 
 logger = logging.getLogger(__name__)
@@ -532,9 +533,10 @@ def create_auth_tools(mcp: FastMCP):
 
     @mcp.tool(tags={"auth", "github"})
     def connect_github_via_pat(
-        token: str = Field(
-            ...,
-            description="GitHub Personal Access Token (ghp_xxx or github_pat_xxx)",
+        token: Optional[str] = Field(
+            default=None,
+            description="GitHub Personal Access Token (ghp_xxx or github_pat_xxx). "
+            "If not provided, auto-detects from .quickcall.env or GITHUB_TOKEN env var.",
         ),
     ) -> Dict[str, Any]:
         """
@@ -543,17 +545,13 @@ def create_auth_tools(mcp: FastMCP):
         Use this if your organization can't install the QuickCall GitHub App.
         This is an alternative to the standard connect_github flow.
 
-        This command:
-        1. Validates your PAT by calling GitHub API
-        2. Auto-detects your GitHub username
-        3. Stores the PAT securely in ~/.quickcall/credentials.json
-
-        After connecting, you can use GitHub tools like list_repos, list_prs, etc.
+        Token auto-detection locations (in order):
+        1. GITHUB_TOKEN or GITHUB_PAT environment variable
+        2. .quickcall.env in your project root (where .git is)
+        3. ~/.quickcall.env in your home directory
 
         Create a PAT at: https://github.com/settings/tokens
-        Required scopes:
-        - repo (full access to private repos)
-        - OR public_repo (public repos only)
+        Required scopes (classic PAT): project, read:user, repo
 
         Note: PAT mode works independently of QuickCall. You don't need
         to run connect_quickcall first. However, Slack tools still require
@@ -571,11 +569,29 @@ def create_auth_tools(mcp: FastMCP):
                 "hint": "Use disconnect_github_pat to remove it, then connect again with a new token.",
             }
 
+        # Auto-detect token if not provided
+        token_source = "provided directly"
+        if not token:
+            token, token_source = get_github_pat()
+            if not token:
+                return {
+                    "status": "error",
+                    "message": "No token provided and none found automatically.",
+                    "searched_locations": [
+                        "GITHUB_TOKEN / GITHUB_PAT environment variables",
+                        ".quickcall.env in project root (where .git is located)",
+                        "~/.quickcall.env in home directory",
+                    ],
+                    "hint": "Either provide the token directly, set GITHUB_TOKEN env var, "
+                    "or create .quickcall.env with GITHUB_TOKEN=ghp_xxx",
+                }
+
         # Validate token format
         if not token.startswith(("ghp_", "github_pat_")):
             return {
                 "status": "error",
                 "message": "Invalid token format. GitHub PATs start with 'ghp_' or 'github_pat_'",
+                "token_source": token_source,
                 "hint": "Create a new token at https://github.com/settings/tokens",
             }
 
@@ -619,6 +635,7 @@ def create_auth_tools(mcp: FastMCP):
             "message": f"Successfully connected GitHub as {username}!",
             "username": username,
             "mode": "pat",
+            "token_source": token_source,
             "hint": "You can now use GitHub tools. Run check_github_connection to verify.",
         }
 

mcp_server/tools/github_tools.py

@@ -270,7 +270,7 @@ def _get_client() -> GitHubClient:
             "2. Run connect_quickcall to use QuickCall (GitHub App + Slack)\n"
             "3. Set GITHUB_TOKEN environment variable\n\n"
             "For PAT: Create token at https://github.com/settings/tokens\n"
-            "Required scopes: repo (private) or public_repo (public only)"
+            "Required scopes (classic PAT): project, read:user, repo"
         )
 
 

{quickcall_integrations-0.3.8.dist-info → quickcall_integrations-0.3.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.3.8
+Version: 0.3.9
 Summary: MCP server with developer integrations for Claude Code and Cursor
 Requires-Python: >=3.10
 Requires-Dist: fastmcp>=2.13.0
@@ -90,7 +90,7 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
 | **Slack** | Read/send messages, threads, channels | Yes |
 
 <details>
-<summary><strong>Available Tools (23)</strong></summary>
+<summary><strong>Available Tools (24)</strong></summary>
 
 ### Git
 | Tool | Description |
@@ -102,10 +102,11 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
 |------|-------------|
 | `list_repos` | List accessible repositories |
 | `list_prs` | List pull requests (open/closed/all) |
-| `get_pr` | Get PR details (title, description, files changed) |
+| `get_prs` | Get PR details (title, description, files changed) |
 | `list_commits` | List commits with optional filters |
 | `get_commit` | Get commit details (message, stats, files) |
 | `list_branches` | List repository branches |
+| `manage_issues` | List, view, create, update, close, reopen, comment on issues + sub-issues |
 | `check_github_connection` | Verify GitHub connection |
 
 ### Slack
@@ -172,9 +173,13 @@ GITHUB_USERNAME=your-username  # Optional: for better UX
 
 **Create a PAT at:** https://github.com/settings/tokens
 
-**Required scopes:**
-- `repo` - Full access to private repositories
-- `public_repo` - Access to public repositories only (if you don't need private repos)
+**Required scopes (classic PAT):**
+
+| Scope | Used For |
+|-------|----------|
+| `project` | GitHub Projects access |
+| `read:user` | Read user profile data |
+| `repo` | PRs, commits, branches, issues |
 
 **Note:** PAT mode provides access to GitHub tools only. For Slack integration, use QuickCall authentication.
 
@@ -228,6 +233,100 @@ List open PRs on [repo] and send titles to #updates channel
 What did I work on this week? Send summary to #standup
 ```
 
+## Issue Management
+
+The `manage_issues` tool provides full issue lifecycle management:
+
+### Actions
+
+| Action | Description |
+|--------|-------------|
+| `list` | List issues with filters |
+| `view` | View issue details |
+| `create` | Create new issue (with optional template) |
+| `update` | Update issue title/body/labels |
+| `close` | Close issue(s) |
+| `reopen` | Reopen issue(s) |
+| `comment` | Add comment to issue(s) |
+| `add_sub_issue` | Add child issue to parent |
+| `remove_sub_issue` | Remove child from parent |
+| `list_sub_issues` | List sub-issues of a parent |
+
+### List Filters
+
+| Filter | Description |
+|--------|-------------|
+| `state` | `'open'`, `'closed'`, or `'all'` (default: `'open'`) |
+| `labels` | Filter by one or more labels |
+| `assignees` | Filter by assignee |
+| `creator` | Filter by issue creator username |
+| `milestone` | Filter by milestone: number, title, `'*'` (any), or `'none'` |
+| `sort` | Sort by: `'created'`, `'updated'`, or `'comments'` (default: `'updated'`) |
+| `limit` | Max issues to return (default: 30) |
+
+**Examples:**
+```
+List open issues in milestone v1.0
+List issues created by sagar
+Show closed bugs sorted by comments
+List issues without a milestone
+```
+
+### Issue Templates
+
+QuickCall supports issue templates from two sources:
+
+**1. GitHub Native Templates** (`.github/ISSUE_TEMPLATE/*.yml`)
+
+Standard GitHub issue templates are automatically detected:
+```yaml
+# .github/ISSUE_TEMPLATE/bug_report.yml
+name: Bug Report
+description: Report a bug
+labels: [bug]
+body:
+  - type: textarea
+    attributes:
+      label: Description
+```
+
+**2. Custom Templates** (`.quickcall.env`)
+
+Define custom templates in your project config:
+```bash
+# .quickcall.env
+ISSUE_TEMPLATE_PATH=/path/to/templates.yml
+```
+
+```yaml
+# templates.yml
+bug_report:
+  name: Bug Report
+  description: Report a bug
+  labels: [bug]
+  title_prefix: "[BUG] "
+  body: |
+    ## Description
+
+    ## Steps to Reproduce
+
+    ## Expected Behavior
+
+feature_request:
+  name: Feature Request
+  labels: [enhancement]
+  body: |
+    ## Problem
+
+    ## Proposed Solution
+```
+
+**Usage:**
+```
+Create a bug report issue titled "Login fails on Safari"
+Create issue with feature_request template
+```
+
 ## Troubleshooting
 
 ### Clean Reinstall

{quickcall_integrations-0.3.8.dist-info → quickcall_integrations-0.3.9.dist-info}/RECORD

@@ -10,12 +10,12 @@ mcp_server/resources/__init__.py,sha256=JrMa3Kf-DmeCB4GwVNfmfw9OGnxF9pJJxCw9Y7u7
 mcp_server/resources/github_resources.py,sha256=sXE06j9jrSDODxH2832fiCtY9n1lKBQR8QZ8U5wYbJY,4030
 mcp_server/resources/slack_resources.py,sha256=b_CPxAicwkF3PsBXIat4QoLbDUHM2g_iPzgzvVpwjaw,1687
 mcp_server/tools/__init__.py,sha256=vIR2ujAaTXm2DgpTsVNz3brI4G34p-Jeg44Qe0uvWc0,405
-mcp_server/tools/auth_tools.py,sha256=kCPjPC1jrVz0XaRAwPea-ue8ybjLLTxyILplBDJ9Mv4,24477
+mcp_server/tools/auth_tools.py,sha256=BPuj9M0pZOvvWHxH0HPdiVm-Y6DJyD-PEvtrIh68vbc,25409
 mcp_server/tools/git_tools.py,sha256=jyCTQR2eSzUFXMt0Y8x66758-VY8YCY14DDUJt7GY2U,13957
-mcp_server/tools/github_tools.py,sha256=ZBJzRhg1BSFdn9VS4qi0PYLCSGBXRfHviKzjR0LxO08,40058
+mcp_server/tools/github_tools.py,sha256=2YE0RtkfartAuLVUciVFuycqc-B3OhN0uNPwhDm1t48,40053
 mcp_server/tools/slack_tools.py,sha256=-HVE_x3Z1KMeYGi1xhyppEwz5ZF-I-ZD0-Up8yBeoYE,11796
 mcp_server/tools/utility_tools.py,sha256=oxAXpdqtPeB5Ug5dvk54V504r-8v1AO4_px-sO6LFOw,3910
-quickcall_integrations-0.3.8.dist-info/METADATA,sha256=d5t3CbdPI7v4PkgeoJ4x4i8KuB_RZ_GDZv2N6GhkghA,7070
-quickcall_integrations-0.3.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-quickcall_integrations-0.3.8.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
-quickcall_integrations-0.3.8.dist-info/RECORD,,
+quickcall_integrations-0.3.9.dist-info/METADATA,sha256=thgEYROxcB1cBO4BsAunkrS9BIYtyTmLWTe3Fci5qSI,9415
+quickcall_integrations-0.3.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+quickcall_integrations-0.3.9.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
+quickcall_integrations-0.3.9.dist-info/RECORD,,