quickcall-integrations 0.3.8__tar.gz → 0.3.9__tar.gz

quickcall_integrations-0.3.9/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,24 @@
+name: Bug Report
+description: Report a bug
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this?
+      placeholder: |
+        1. Run '...'
+        2. See error
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should have happened?

quickcall_integrations-0.3.9/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,16 @@
+name: Feature Request
+description: Suggest a new feature
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should it work?

quickcall_integrations-0.3.9/.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,19 @@
+name: Task
+description: A general task or todo item
+labels: [task]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What needs to be done?
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      description: How do we know it's done?
+      placeholder: |
+        - [ ] Criteria 1
+        - [ ] Criteria 2

quickcall_integrations-0.3.9/.quickcall-issue-template.yaml

@@ -0,0 +1,23 @@
+defaults:
+  labels: ["triage"]
+  body: |
+    ## Description
+
+    ## Details
+
+templates:
+  docs:
+    labels: ["documentation"]
+    title_prefix: "[Docs QC] "
+    body: |
+      ## Documentation Update
+
+      ## What needs to be documented?
+
+  chore:
+    labels: ["chore"]
+    title_prefix: "[Chore QC] "
+    body: |
+      ## Task
+
+      ## Why is this needed?

{quickcall_integrations-0.3.8 → quickcall_integrations-0.3.9}/PKG-INFO

@@ -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 → quickcall_integrations-0.3.9}/README.md

@@ -77,7 +77,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 |
@@ -89,10 +89,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
@@ -159,9 +160,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.
 
@@ -215,6 +220,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 → quickcall_integrations-0.3.9}/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.",
         }
 

{quickcall_integrations-0.3.8 → quickcall_integrations-0.3.9}/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 → quickcall_integrations-0.3.9}/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.7",
+  "version": "0.6.8",
   "author": {
     "name": "Sagar Sarkale"
   }

quickcall_integrations-0.3.9/plugins/quickcall/commands/connect-github-pat.md

@@ -0,0 +1,37 @@
+---
+description: Connect GitHub using a Personal Access Token (for enterprise users)
+---
+
+# Connect GitHub via PAT
+
+Use this if your organization can't install the QuickCall GitHub App.
+
+## Steps
+
+1. **Call `connect_github_via_pat` (no arguments needed):**
+   - The tool auto-detects tokens from these locations (in order):
+     1. `GITHUB_TOKEN` or `GITHUB_PAT` environment variable
+     2. `.quickcall.env` in project root (where `.git` is located)
+     3. `~/.quickcall.env` in home directory
+   - If a token is found, it validates and connects automatically
+   - If no token is found, it returns an error with helpful instructions
+
+2. **If no token found automatically:**
+   - Ask the user for their GitHub Personal Access Token
+   - Remind them: "Create a PAT at https://github.com/settings/tokens with scopes: project, read:user, repo"
+   - Or suggest: "Create a `.quickcall.env` file in your project root with `GITHUB_TOKEN=ghp_xxx`"
+   - Call `connect_github_via_pat` with the provided token
+
+3. **Show result:**
+   ```
+   GitHub connected via PAT!
+   Username: {username}
+   Token source: {token_source}
+   ```
+
+## Notes
+
+- PAT mode works independently of QuickCall
+- Slack tools still require QuickCall authentication (`/quickcall:connect`)
+- To disconnect PAT: call `disconnect_github_pat`
+- The `.quickcall.env` file should NOT be committed to git (it contains secrets)

{quickcall_integrations-0.3.8 → quickcall_integrations-0.3.9}/pyproject.toml

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

quickcall_integrations-0.3.8/.quickcall-issue-template.yaml

@@ -1,38 +0,0 @@
-defaults:
-  labels: ["triage"]
-  body: |
-    ## Description
-
-    ## Details
-
-templates:
-  bug:
-    labels: ["bug", "triage"]
-    body: |
-      ## Bug Description
-
-      ## Steps to Reproduce
-      1.
-      2.
-
-      ## Expected Behavior
-
-      ## Actual Behavior
-
-  feature:
-    labels: ["enhancement"]
-    body: |
-      ## Feature Request
-
-      ## Problem Statement
-
-      ## Proposed Solution
-
-      ## Alternatives Considered
-
-  docs:
-    labels: ["documentation"]
-    body: |
-      ## Documentation Update
-
-      ## What needs to be documented?

quickcall_integrations-0.3.8/plugins/quickcall/commands/connect-github-pat.md

@@ -1,43 +0,0 @@
----
-description: Connect GitHub using a Personal Access Token (for enterprise users)
----
-
-# Connect GitHub via PAT
-
-Use this if your organization can't install the QuickCall GitHub App.
-
-## Steps
-
-1. **Check if PAT already configured:**
-   - Call `check_quickcall_status`
-   - If `github_pat.configured` is true, inform user and ask if they want to reconnect
-
-2. **Auto-detect PAT from .quickcall.env (IMPORTANT):**
-   - Use the Read tool to check if `.quickcall.env` exists in the current project directory
-   - If found, read it and look for `GITHUB_TOKEN=...` or `GITHUB_PAT=...`
-   - If a token is found in the file, use it automatically (do NOT ask the user)
-   - Also check `~/.quickcall.env` if not found in project root
-
-3. **Get PAT from user (only if not found in .quickcall.env):**
-   - If no token was found in config files, ask the user for their GitHub Personal Access Token
-   - Remind them: "Create a PAT at https://github.com/settings/tokens with `repo` scope"
-   - Or suggest: "You can also create a `.quickcall.env` file with `GITHUB_TOKEN=your_token`"
-
-4. **Connect:**
-   - Call `connect_github_via_pat` with the token (from file or user input)
-   - The tool validates the token and auto-detects username
-
-5. **Show result:**
-   ```
-   GitHub connected via PAT!
-   Username: {username}
-   Mode: Personal Access Token
-   Source: .quickcall.env (or "manually provided")
-   ```
-
-## Notes
-
-- PAT mode works independently of QuickCall
-- Slack tools still require QuickCall authentication (`/quickcall:connect`)
-- To disconnect PAT: call `disconnect_github_pat`
-- The `.quickcall.env` file should NOT be committed to git (it contains secrets)