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

mcp_server/api_clients/github_client.py

@@ -582,8 +582,16 @@ class GitHubClient:
     # Issue Operations
     # ========================================================================
 
-    def _issue_to_dict(self, issue) -> Dict[str, Any]:
+    def _issue_to_dict(self, issue, summary: bool = False) -> Dict[str, Any]:
         """Convert PyGithub Issue to dict."""
+        if summary:
+            return {
+                "number": issue.number,
+                "title": issue.title,
+                "state": issue.state,
+                "labels": [label.name for label in issue.labels],
+                "html_url": issue.html_url,
+            }
         return {
             "number": issue.number,
             "title": issue.title,
@@ -595,6 +603,70 @@ class GitHubClient:
             "created_at": issue.created_at.isoformat(),
         }
 
+    def list_issues(
+        self,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: str = "open",
+        labels: Optional[List[str]] = None,
+        assignee: Optional[str] = None,
+        creator: Optional[str] = None,
+        milestone: Optional[str] = None,
+        sort: str = "updated",
+        limit: int = 30,
+    ) -> List[Dict[str, Any]]:
+        """
+        List issues in a repository.
+
+        Args:
+            owner: Repository owner
+            repo: Repository name
+            state: Issue state: 'open', 'closed', or 'all'
+            labels: Filter by labels
+            assignee: Filter by assignee username
+            creator: Filter by issue creator username
+            milestone: Filter by milestone (number, title, or '*' for any, 'none' for no milestone)
+            sort: Sort by 'created', 'updated', or 'comments'
+            limit: Maximum issues to return
+
+        Returns:
+            List of issue summaries
+        """
+        gh_repo = self._get_repo(owner, repo)
+
+        kwargs = {"state": state, "sort": sort, "direction": "desc"}
+        if labels:
+            kwargs["labels"] = labels
+        if assignee:
+            kwargs["assignee"] = assignee
+        if creator:
+            kwargs["creator"] = creator
+        if milestone:
+            # Handle milestone - can be number, '*', 'none', or title
+            if milestone == "*" or milestone == "none":
+                kwargs["milestone"] = milestone
+            elif milestone.isdigit():
+                kwargs["milestone"] = gh_repo.get_milestone(int(milestone))
+            else:
+                # Search by title
+                for ms in gh_repo.get_milestones(state="all"):
+                    if ms.title.lower() == milestone.lower():
+                        kwargs["milestone"] = ms
+                        break
+
+        issues = []
+        count = 0
+        for issue in gh_repo.get_issues(**kwargs):
+            # Skip pull requests (GitHub API returns PRs in issues endpoint)
+            if issue.pull_request is not None:
+                continue
+            issues.append(self._issue_to_dict(issue, summary=True))
+            count += 1
+            if count >= limit:
+                break
+
+        return issues
+
     def create_issue(
         self,
         title: str,
@@ -686,6 +758,232 @@ class GitHubClient:
             "issue_number": issue_number,
         }
 
+    def get_issue(
+        self,
+        issue_number: int,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        include_sub_issues: bool = True,
+    ) -> Dict[str, Any]:
+        """
+        Get detailed information about a GitHub issue.
+
+        Args:
+            issue_number: Issue number
+            owner: Repository owner
+            repo: Repository name
+            include_sub_issues: Whether to fetch sub-issues list
+
+        Returns:
+            Issue details including sub-issues if requested
+        """
+        gh_repo = self._get_repo(owner, repo)
+        issue = gh_repo.get_issue(issue_number)
+
+        result = {
+            "number": issue.number,
+            "id": issue.id,  # Internal ID needed for sub-issues API
+            "title": issue.title,
+            "body": issue.body,
+            "state": issue.state,
+            "html_url": issue.html_url,
+            "labels": [label.name for label in issue.labels],
+            "assignees": [a.login for a in issue.assignees],
+            "created_at": issue.created_at.isoformat(),
+            "updated_at": issue.updated_at.isoformat() if issue.updated_at else None,
+            "closed_at": issue.closed_at.isoformat() if issue.closed_at else None,
+            "comments_count": issue.comments,
+            "author": issue.user.login if issue.user else "unknown",
+        }
+
+        # Fetch sub-issues if requested
+        if include_sub_issues:
+            owner = owner or self.default_owner
+            repo_name = repo or self.default_repo
+            sub_issues = self.list_sub_issues(issue_number, owner=owner, repo=repo_name)
+            result["sub_issues"] = sub_issues
+            result["sub_issues_count"] = len(sub_issues)
+
+        return result
+
+    # ========================================================================
+    # Sub-Issue Operations (GitHub's native sub-issues feature)
+    # ========================================================================
+
+    def list_sub_issues(
+        self,
+        parent_issue_number: int,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> List[Dict[str, Any]]:
+        """
+        List sub-issues of a parent issue.
+
+        Args:
+            parent_issue_number: Parent issue number
+            owner: Repository owner
+            repo: Repository name
+
+        Returns:
+            List of sub-issue summaries
+        """
+        owner = owner or self.default_owner
+        repo = repo or self.default_repo
+
+        if not owner or not repo:
+            raise ValueError("Repository owner and name must be specified")
+
+        try:
+            with httpx.Client() as client:
+                response = client.get(
+                    f"https://api.github.com/repos/{owner}/{repo}/issues/{parent_issue_number}/sub_issues",
+                    headers={
+                        "Authorization": f"Bearer {self.token}",
+                        "Accept": "application/vnd.github+json",
+                        "X-GitHub-Api-Version": "2022-11-28",
+                    },
+                    timeout=30.0,
+                )
+                response.raise_for_status()
+                data = response.json()
+
+            return [
+                {
+                    "number": item["number"],
+                    "id": item["id"],
+                    "title": item["title"],
+                    "state": item["state"],
+                    "html_url": item["html_url"],
+                }
+                for item in data
+            ]
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 404:
+                # No sub-issues or feature not enabled
+                return []
+            logger.error(f"Failed to list sub-issues: HTTP {e.response.status_code}")
+            raise GithubException(e.response.status_code, e.response.json())
+        except Exception as e:
+            logger.error(f"Failed to list sub-issues: {e}")
+            return []
+
+    def add_sub_issue(
+        self,
+        parent_issue_number: int,
+        child_issue_number: int,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Add an existing issue as a sub-issue to a parent.
+
+        Args:
+            parent_issue_number: Parent issue number
+            child_issue_number: Child issue number to add as sub-issue
+            owner: Repository owner
+            repo: Repository name
+
+        Returns:
+            Result with parent and child info
+        """
+        owner = owner or self.default_owner
+        repo = repo or self.default_repo
+
+        if not owner or not repo:
+            raise ValueError("Repository owner and name must be specified")
+
+        # First, get the child issue's internal ID (required by API)
+        gh_repo = self._get_repo(owner, repo)
+        child_issue = gh_repo.get_issue(child_issue_number)
+        child_id = child_issue.id
+
+        try:
+            with httpx.Client() as client:
+                response = client.post(
+                    f"https://api.github.com/repos/{owner}/{repo}/issues/{parent_issue_number}/sub_issues",
+                    headers={
+                        "Authorization": f"Bearer {self.token}",
+                        "Accept": "application/vnd.github+json",
+                        "X-GitHub-Api-Version": "2022-11-28",
+                    },
+                    json={"sub_issue_id": child_id},
+                    timeout=30.0,
+                )
+                response.raise_for_status()
+
+            return {
+                "success": True,
+                "parent_issue": parent_issue_number,
+                "child_issue": child_issue_number,
+                "child_id": child_id,
+            }
+        except httpx.HTTPStatusError as e:
+            logger.error(f"Failed to add sub-issue: HTTP {e.response.status_code}")
+            error_data = e.response.json() if e.response.content else {}
+            raise GithubException(
+                e.response.status_code,
+                error_data,
+                message=f"Failed to add #{child_issue_number} as sub-issue of #{parent_issue_number}",
+            )
+
+    def remove_sub_issue(
+        self,
+        parent_issue_number: int,
+        child_issue_number: int,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Remove a sub-issue from a parent.
+
+        Args:
+            parent_issue_number: Parent issue number
+            child_issue_number: Child issue number to remove
+            owner: Repository owner
+            repo: Repository name
+
+        Returns:
+            Result with parent and child info
+        """
+        owner = owner or self.default_owner
+        repo = repo or self.default_repo
+
+        if not owner or not repo:
+            raise ValueError("Repository owner and name must be specified")
+
+        # Get the child issue's internal ID
+        gh_repo = self._get_repo(owner, repo)
+        child_issue = gh_repo.get_issue(child_issue_number)
+        child_id = child_issue.id
+
+        try:
+            with httpx.Client() as client:
+                response = client.delete(
+                    f"https://api.github.com/repos/{owner}/{repo}/issues/{parent_issue_number}/sub_issues/{child_id}",
+                    headers={
+                        "Authorization": f"Bearer {self.token}",
+                        "Accept": "application/vnd.github+json",
+                        "X-GitHub-Api-Version": "2022-11-28",
+                    },
+                    timeout=30.0,
+                )
+                response.raise_for_status()
+
+            return {
+                "success": True,
+                "parent_issue": parent_issue_number,
+                "child_issue": child_issue_number,
+                "removed": True,
+            }
+        except httpx.HTTPStatusError as e:
+            logger.error(f"Failed to remove sub-issue: HTTP {e.response.status_code}")
+            error_data = e.response.json() if e.response.content else {}
+            raise GithubException(
+                e.response.status_code,
+                error_data,
+                message=f"Failed to remove #{child_issue_number} from #{parent_issue_number}",
+            )
+
     # ========================================================================
     # Search Operations (for Appraisals)
     # ========================================================================

mcp_server/tools/github_tools.py

@@ -570,11 +570,12 @@ def create_github_tools(mcp: FastMCP) -> None:
     def manage_issues(
         action: str = Field(
             ...,
-            description="Action: 'create', 'update', 'close', 'reopen', or 'comment'",
+            description="Action: 'list', 'view', 'create', 'update', 'close', 'reopen', 'comment', "
+            "'add_sub_issue', 'remove_sub_issue', 'list_sub_issues'",
         ),
         issue_numbers: Optional[List[int]] = Field(
             default=None,
-            description="Issue number(s). Required for update/close/reopen/comment. Supports bulk operations.",
+            description="Issue number(s). Required for view/update/close/reopen/comment/sub-issue ops.",
         ),
         title: Optional[str] = Field(
             default=None,
@@ -594,7 +595,12 @@ def create_github_tools(mcp: FastMCP) -> None:
         ),
         template: Optional[str] = Field(
             default=None,
-            description="Template name for 'create' (e.g., 'bug', 'feature')",
+            description="Template name for 'create' (e.g., 'bug_report', 'feature_request')",
+        ),
+        parent_issue: Optional[int] = Field(
+            default=None,
+            description="Parent issue number. For 'create': attach new issue as sub-issue. "
+            "For 'add_sub_issue'/'remove_sub_issue'/'list_sub_issues': the parent issue.",
         ),
         owner: Optional[str] = Field(
             default=None,
@@ -604,20 +610,68 @@ def create_github_tools(mcp: FastMCP) -> None:
             default=None,
             description="Repository name. Required.",
         ),
+        state: Optional[str] = Field(
+            default="open",
+            description="Issue state filter for 'list': 'open', 'closed', or 'all' (default: 'open')",
+        ),
+        creator: Optional[str] = Field(
+            default=None,
+            description="Filter by issue creator username (for 'list')",
+        ),
+        milestone: Optional[str] = Field(
+            default=None,
+            description="Filter by milestone: number, title, '*' (any), or 'none' (for 'list')",
+        ),
+        sort: Optional[str] = Field(
+            default="updated",
+            description="Sort by: 'created', 'updated', or 'comments' (for 'list', default: 'updated')",
+        ),
+        limit: Optional[int] = Field(
+            default=30,
+            description="Maximum issues to return for 'list' action (default: 30)",
+        ),
     ) -> dict:
         """
-        Manage GitHub issues: create, update, close, reopen, or comment.
+        Manage GitHub issues: list, view, create, update, close, reopen, comment, and sub-issues.
 
-        Supports bulk operations for close/reopen/comment via issue_numbers list.
+        Supports bulk operations for view/close/reopen/comment via issue_numbers list.
 
         Examples:
-        - create: manage_issues(action="create", title="Bug", template="bug")
+        - list: manage_issues(action="list", state="open", milestone="v1.0")
+        - list by creator: manage_issues(action="list", creator="username")
+        - view: manage_issues(action="view", issue_numbers=[42])
+        - create: manage_issues(action="create", title="Bug", template="bug_report")
+        - create as sub-issue: manage_issues(action="create", title="Task 1", parent_issue=42)
         - close multiple: manage_issues(action="close", issue_numbers=[1, 2, 3])
         - comment: manage_issues(action="comment", issue_numbers=[42], body="Fixed!")
+        - add sub-issues: manage_issues(action="add_sub_issue", issue_numbers=[43,44], parent_issue=42)
+        - remove sub-issue: manage_issues(action="remove_sub_issue", issue_numbers=[43], parent_issue=42)
+        - list sub-issues: manage_issues(action="list_sub_issues", parent_issue=42)
         """
         try:
             client = _get_client()
 
+            # === LIST ACTION ===
+            if action == "list":
+                issues = client.list_issues(
+                    owner=owner,
+                    repo=repo,
+                    state=state or "open",
+                    labels=labels,
+                    assignee=assignees[0] if assignees else None,
+                    creator=creator,
+                    milestone=milestone,
+                    sort=sort or "updated",
+                    limit=limit or 30,
+                )
+                return {
+                    "action": "list",
+                    "state": state or "open",
+                    "count": len(issues),
+                    "issues": issues,
+                }
+
+            # === CREATE ACTION ===
             if action == "create":
                 if not title:
                     raise ToolError("'title' is required for 'create' action")
@@ -625,24 +679,79 @@ def create_github_tools(mcp: FastMCP) -> None:
                 tpl = _load_issue_template(template)
                 final_body = body if body is not None else tpl.get("body", "")
                 final_labels = labels if labels is not None else tpl.get("labels", [])
+                final_assignees = (
+                    assignees if assignees is not None else tpl.get("assignees", [])
+                )
+
+                # Apply title prefix from template if present
+                title_prefix = tpl.get("title_prefix", "")
+                if title_prefix and not title.startswith(title_prefix):
+                    title = f"{title_prefix}{title}"
 
                 issue = client.create_issue(
                     title=title,
                     body=final_body,
                     labels=final_labels,
-                    assignees=assignees,
+                    assignees=final_assignees,
                     owner=owner,
                     repo=repo,
                 )
-                return {"action": "created", "issue": issue}
 
-            # All other actions require issue_numbers
+                result = {"action": "created", "issue": issue}
+
+                # If parent_issue specified, add as sub-issue
+                if parent_issue:
+                    try:
+                        sub_result = client.add_sub_issue(
+                            parent_issue_number=parent_issue,
+                            child_issue_number=issue["number"],
+                            owner=owner,
+                            repo=repo,
+                        )
+                        result["sub_issue_of"] = parent_issue
+                        result["sub_issue_linked"] = sub_result.get("success", False)
+                    except Exception as e:
+                        result["sub_issue_error"] = str(e)
+
+                return result
+
+            # === LIST SUB-ISSUES ACTION ===
+            if action == "list_sub_issues":
+                if not parent_issue:
+                    raise ToolError(
+                        "'parent_issue' is required for 'list_sub_issues' action"
+                    )
+
+                sub_issues = client.list_sub_issues(
+                    parent_issue_number=parent_issue,
+                    owner=owner,
+                    repo=repo,
+                )
+                return {
+                    "action": "list_sub_issues",
+                    "parent_issue": parent_issue,
+                    "count": len(sub_issues),
+                    "sub_issues": sub_issues,
+                }
+
+            # === ALL OTHER ACTIONS REQUIRE issue_numbers ===
             if not issue_numbers:
                 raise ToolError(f"'issue_numbers' required for '{action}' action")
 
             results = []
             for issue_number in issue_numbers:
-                if action == "update":
+                # === VIEW ACTION ===
+                if action == "view":
+                    issue_data = client.get_issue(
+                        issue_number=issue_number,
+                        owner=owner,
+                        repo=repo,
+                        include_sub_issues=True,
+                    )
+                    results.append(issue_data)
+
+                # === UPDATE ACTION ===
+                elif action == "update":
                     client.update_issue(
                         issue_number=issue_number,
                         title=title,
@@ -654,14 +763,17 @@ def create_github_tools(mcp: FastMCP) -> None:
                     )
                     results.append({"number": issue_number, "status": "updated"})
 
+                # === CLOSE ACTION ===
                 elif action == "close":
                     client.close_issue(issue_number, owner=owner, repo=repo)
                     results.append({"number": issue_number, "status": "closed"})
 
+                # === REOPEN ACTION ===
                 elif action == "reopen":
                     client.reopen_issue(issue_number, owner=owner, repo=repo)
                     results.append({"number": issue_number, "status": "reopened"})
 
+                # === COMMENT ACTION ===
                 elif action == "comment":
                     if not body:
                         raise ToolError("'body' is required for 'comment' action")
@@ -676,9 +788,57 @@ def create_github_tools(mcp: FastMCP) -> None:
                         }
                     )
 
+                # === ADD SUB-ISSUE ACTION ===
+                elif action == "add_sub_issue":
+                    if not parent_issue:
+                        raise ToolError(
+                            "'parent_issue' is required for 'add_sub_issue' action"
+                        )
+                    sub_result = client.add_sub_issue(
+                        parent_issue_number=parent_issue,
+                        child_issue_number=issue_number,
+                        owner=owner,
+                        repo=repo,
+                    )
+                    results.append(
+                        {
+                            "number": issue_number,
+                            "status": "added_as_sub_issue",
+                            "parent_issue": parent_issue,
+                        }
+                    )
+
+                # === REMOVE SUB-ISSUE ACTION ===
+                elif action == "remove_sub_issue":
+                    if not parent_issue:
+                        raise ToolError(
+                            "'parent_issue' is required for 'remove_sub_issue' action"
+                        )
+                    client.remove_sub_issue(
+                        parent_issue_number=parent_issue,
+                        child_issue_number=issue_number,
+                        owner=owner,
+                        repo=repo,
+                    )
+                    results.append(
+                        {
+                            "number": issue_number,
+                            "status": "removed_from_parent",
+                            "parent_issue": parent_issue,
+                        }
+                    )
+
                 else:
                     raise ToolError(f"Invalid action: {action}")
 
+            # Return format depends on action
+            if action == "view":
+                return {
+                    "action": "view",
+                    "count": len(results),
+                    "issues": results,
+                }
+
             return {"action": action, "count": len(results), "results": results}
 
         except ToolError:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.3.6
+Version: 0.3.8
 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.6.dist-info → quickcall_integrations-0.3.8.dist-info}/RECORD

@@ -1,7 +1,7 @@
 mcp_server/__init__.py,sha256=6KGzjSPyVB6vQh150DwBjINM_CsZNDhOzwSQFWpXz0U,301
 mcp_server/server.py,sha256=kv5hh0J-M7yENUBBNI1bkq1y7MB0zn5R_-R1tib6_sk,3108
 mcp_server/api_clients/__init__.py,sha256=kOG5_sxIVpAx_tvf1nq_P0QCkqojAVidRE-wenLS-Wc,207
-mcp_server/api_clients/github_client.py,sha256=HBLKgwZpbbdhroladE0l4mGjmuoa8uKCTf3oEL6S_P4,29298
+mcp_server/api_clients/github_client.py,sha256=Mlh6BzMhZ05NqkX9A2O80eJIQXWuW4FnnN1DBM0WKC8,40135
 mcp_server/api_clients/slack_client.py,sha256=w3rcGghttfYw8Ird2beNo2LEYLc3rCTbUKMH4X7QQuQ,16447
 mcp_server/auth/__init__.py,sha256=D-JS0Qe7FkeJjYx92u_AqPx8ZRoB3dKMowzzJXlX6cc,780
 mcp_server/auth/credentials.py,sha256=sDS0W5c16i_UGvhG8Sh1RO93FxRn-hHVAdI9hlWuhx0,20011
@@ -12,10 +12,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=iQvVuhWwVsKSPI7Ue6Eu0gYJcMKjWBAoo4U2Is9eIUI,33241
+mcp_server/tools/github_tools.py,sha256=ZBJzRhg1BSFdn9VS4qi0PYLCSGBXRfHviKzjR0LxO08,40058
 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.6.dist-info/METADATA,sha256=tt1WubqnaF5Yjq9mE-8HDIsDqCYXO4vaXGSw5ZKKV2Q,7070
-quickcall_integrations-0.3.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-quickcall_integrations-0.3.6.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
-quickcall_integrations-0.3.6.dist-info/RECORD,,
+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,,