mcp-ticketer 0.12.0__py3-none-any.whl → 2.2.13__py3-none-any.whl

mcp_ticketer/adapters/asana/adapter.py

@@ -6,6 +6,7 @@ import builtins
 import logging
 import mimetypes
 import os
+from datetime import datetime
 from pathlib import Path
 from typing import Any
 
@@ -59,6 +60,7 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Initialize Asana adapter.
 
         Args:
+        ----
             config: Configuration with:
                 - api_key: Asana Personal Access Token (or ASANA_PAT env var)
                 - workspace: Asana workspace name (optional, for resolution)
@@ -68,6 +70,7 @@ class AsanaAdapter(BaseAdapter[Task]):
                 - max_retries: Maximum retry attempts (default: 3)
 
         Raises:
+        ------
             ValueError: If required configuration is missing
 
         """
@@ -120,6 +123,7 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Validate Asana API credentials.
 
         Returns:
+        -------
             Tuple of (is_valid, error_message)
 
         """
@@ -244,9 +248,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Load custom fields configured for a specific project.
 
         Args:
+        ----
             project_gid: Project GID to load custom fields for
 
         Returns:
+        -------
             Dictionary mapping field name (lowercase) to field data
 
         """
@@ -277,9 +283,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Get custom fields for a project, loading if not cached.
 
         Args:
+        ----
             project_gid: Project GID
 
         Returns:
+        -------
             Dictionary mapping field name (lowercase) to field data
 
         """
@@ -295,10 +303,12 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Map TicketState to Asana Status custom field option.
 
         Args:
+        ----
             state: The TicketState to map
             status_field: The Status custom field data with enum_options
 
         Returns:
+        -------
             Matching enum option or None
 
         """
@@ -339,6 +349,7 @@ class AsanaAdapter(BaseAdapter[Task]):
         We return a mapping to "true"/"false" strings for compatibility.
 
         Returns:
+        -------
             Dictionary mapping TicketState to completion status string
 
         """
@@ -357,9 +368,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Resolve project identifier (name or GID) to GID.
 
         Args:
+        ----
             project_identifier: Project name or GID
 
         Returns:
+        -------
             Project GID or None if not found
 
         """
@@ -392,9 +405,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Resolve user identifier (email, name, or GID) to GID.
 
         Args:
+        ----
             user_identifier: User email, name, or GID
 
         Returns:
+        -------
             User GID or None if not found
 
         """
@@ -432,12 +447,15 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Create a new Asana project or task.
 
         Args:
+        ----
             ticket: Epic or Task to create
 
         Returns:
+        -------
             Created ticket with ID populated
 
         Raises:
+        ------
             ValueError: If creation fails
 
         """
@@ -460,9 +478,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Create an Asana project from an Epic.
 
         Args:
+        ----
             epic: Epic to create
 
         Returns:
+        -------
             Created epic with Asana metadata
 
         """
@@ -491,9 +511,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         subtask (child of another task) when task.parent_issue is provided.
 
         Args:
+        ----
             task: Task to create
 
         Returns:
+        -------
             Created task with Asana metadata
 
         """
@@ -564,6 +586,7 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Add tags to an Asana task.
 
         Args:
+        ----
             task_gid: Task GID
             tags: List of tag names to add
 
@@ -602,9 +625,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Read an Asana task by GID.
 
         Args:
+        ----
             ticket_id: Asana task GID
 
         Returns:
+        -------
             Task if found, None otherwise
 
         """
@@ -632,10 +657,12 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Update an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
             updates: Dictionary of fields to update
 
         Returns:
+        -------
             Updated task or None if not found
 
         """
@@ -776,9 +803,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Delete an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
 
         Returns:
+        -------
             True if successfully deleted
 
         """
@@ -795,11 +824,13 @@ class AsanaAdapter(BaseAdapter[Task]):
         """List Asana tasks with optional filtering.
 
         Args:
+        ----
             limit: Maximum number of tasks to return
             offset: Number of tasks to skip (Note: Asana uses offset tokens)
             filters: Optional filters (state, assignee, project, etc.)
 
         Returns:
+        -------
             List of tasks matching the criteria
 
         """
@@ -896,9 +927,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Search Asana tasks using filters.
 
         Args:
+        ----
             query: Search query with filters
 
         Returns:
+        -------
             List of tasks matching the search criteria
 
         """
@@ -936,10 +969,12 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Transition task to new state.
 
         Args:
+        ----
             ticket_id: Task GID
             target_state: Target state
 
         Returns:
+        -------
             Updated task or None if failed
 
         """
@@ -949,12 +984,15 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Add a comment to an Asana task (as a story).
 
         Args:
+        ----
             comment: Comment to add
 
         Returns:
+        -------
             Created comment with ID
 
         Raises:
+        ------
             ValueError: If comment creation fails
 
         """
@@ -984,11 +1022,13 @@ class AsanaAdapter(BaseAdapter[Task]):
         Filters stories to only return comment type (not system events).
 
         Args:
+        ----
             ticket_id: Task GID
             limit: Maximum number of comments to return
             offset: Number of comments to skip
 
         Returns:
+        -------
             List of comments for the task
 
         """
@@ -1019,11 +1059,13 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Create an Asana project (Epic).
 
         Args:
+        ----
             title: Epic title
             description: Epic description
             **kwargs: Additional fields
 
         Returns:
+        -------
             Created epic or None if failed
 
         """
@@ -1041,9 +1083,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Get an Asana project (Epic) by GID.
 
         Args:
+        ----
             epic_id: Project GID
 
         Returns:
+        -------
             Epic if found, None otherwise
 
         """
@@ -1065,10 +1109,12 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Update an Asana project (Epic).
 
         Args:
+        ----
             epic_id: Project GID
             updates: Dictionary of fields to update
 
         Returns:
+        -------
             Updated epic or None if failed
 
         """
@@ -1108,9 +1154,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """List all Asana projects (Epics).
 
         Args:
+        ----
             **kwargs: Optional filter parameters
 
         Returns:
+        -------
             List of epics
 
         """
@@ -1143,13 +1191,65 @@ class AsanaAdapter(BaseAdapter[Task]):
             logger.error(f"Failed to list projects: {e}")
             return []
 
+    async def delete_epic(self, epic_id: str) -> bool:
+        """Delete an Asana project (Epic).
+
+        Args:
+        ----
+            epic_id: Project GID to delete
+
+        Returns:
+        -------
+            True if successfully deleted, False otherwise
+
+        Raises:
+        ------
+            ValueError: If credentials are invalid or GID format is invalid
+
+        """
+        # Validate credentials
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
+        # Validate GID format (should be numeric)
+        if not epic_id or not epic_id.isdigit():
+            raise ValueError(
+                f"Invalid project GID '{epic_id}'. Asana project GIDs must be numeric."
+            )
+
+        try:
+            # Delete project using REST API
+            await self.client.delete(f"/projects/{epic_id}")
+            logger.info(f"Successfully deleted project {epic_id}")
+            return True
+
+        except Exception as e:
+            # Check if it's a 404 (not found) - return False
+            if "404" in str(e) or "Not Found" in str(e):
+                logger.warning(f"Project {epic_id} not found")
+                return False
+
+            # Check for permissions errors
+            if "403" in str(e) or "Forbidden" in str(e):
+                logger.error(f"Permission denied to delete project {epic_id}")
+                raise ValueError(
+                    f"Permission denied: You don't have permission to delete project {epic_id}"
+                ) from e
+
+            # Other errors - log and raise
+            logger.error(f"Failed to delete project {epic_id}: {e}")
+            raise ValueError(f"Failed to delete project: {e}") from e
+
     async def list_issues_by_epic(self, epic_id: str) -> builtins.list[Task]:
         """List all tasks in a project (Epic).
 
         Args:
+        ----
             epic_id: Project GID
 
         Returns:
+        -------
             List of tasks in the project
 
         """
@@ -1161,9 +1261,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """List all subtasks of a task (Issue).
 
         Args:
+        ----
             issue_id: Parent task GID
 
         Returns:
+        -------
             List of subtasks
 
         """
@@ -1198,14 +1300,17 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Attach a file to an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
             file_path: Local file path to upload
             description: Optional attachment description (not used by Asana)
 
         Returns:
+        -------
             Created Attachment with metadata
 
         Raises:
+        ------
             FileNotFoundError: If file doesn't exist
             ValueError: If upload fails
 
@@ -1255,9 +1360,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Get all attachments for an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
 
         Returns:
+        -------
             List of attachments
 
         """
@@ -1285,10 +1392,12 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Delete an attachment from an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID (not used, kept for interface compatibility)
             attachment_id: Attachment GID
 
         Returns:
+        -------
             True if deleted successfully
 
         """
@@ -1303,6 +1412,126 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Close adapter and cleanup resources."""
         await self.client.close()
 
+    # Milestone Methods (Not yet implemented)
+
+    async def milestone_create(
+        self,
+        name: str,
+        target_date: datetime | None = None,
+        labels: list[str] | None = None,
+        description: str = "",
+        project_id: str | None = None,
+    ) -> Any:
+        """Create milestone - not yet implemented for Asana.
+
+        Args:
+        ----
+            name: Milestone name
+            target_date: Target completion date
+            labels: Labels that define this milestone
+            description: Milestone description
+            project_id: Associated project ID
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
+    async def milestone_get(self, milestone_id: str) -> Any:
+        """Get milestone - not yet implemented for Asana.
+
+        Args:
+        ----
+            milestone_id: Milestone identifier
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
+    async def milestone_list(
+        self,
+        project_id: str | None = None,
+        state: str | None = None,
+    ) -> list[Any]:
+        """List milestones - not yet implemented for Asana.
+
+        Args:
+        ----
+            project_id: Filter by project
+            state: Filter by state
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
+    async def milestone_update(
+        self,
+        milestone_id: str,
+        name: str | None = None,
+        target_date: datetime | None = None,
+        state: str | None = None,
+        labels: list[str] | None = None,
+        description: str | None = None,
+    ) -> Any:
+        """Update milestone - not yet implemented for Asana.
+
+        Args:
+        ----
+            milestone_id: Milestone identifier
+            name: New name
+            target_date: New target date
+            state: New state
+            labels: New labels
+            description: New description
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
+    async def milestone_delete(self, milestone_id: str) -> bool:
+        """Delete milestone - not yet implemented for Asana.
+
+        Args:
+        ----
+            milestone_id: Milestone identifier
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
+    async def milestone_get_issues(
+        self,
+        milestone_id: str,
+        state: str | None = None,
+    ) -> list[Any]:
+        """Get milestone issues - not yet implemented for Asana.
+
+        Args:
+        ----
+            milestone_id: Milestone identifier
+            state: Filter by issue state
+
+        Raises:
+        ------
+            NotImplementedError: Milestone support coming in v2.1.0
+
+        """
+        raise NotImplementedError("Milestone support for Asana coming in v2.1.0")
+
 
 # Register the adapter
 AdapterRegistry.register("asana", AsanaAdapter)

mcp_ticketer/adapters/asana/mappers.py

@@ -22,9 +22,11 @@ def parse_asana_datetime(date_str: str | None) -> datetime | None:
     """Parse Asana datetime string to datetime object.
 
     Args:
+    ----
         date_str: ISO 8601 datetime string or None
 
     Returns:
+    -------
         Parsed datetime or None
 
     """
@@ -43,9 +45,11 @@ def map_asana_project_to_epic(project: dict[str, Any]) -> Epic:
     """Map Asana project to Epic.
 
     Args:
+    ----
         project: Asana project data
 
     Returns:
+    -------
         Epic model instance
 
     """
@@ -91,9 +95,11 @@ def map_asana_task_to_task(task: dict[str, Any]) -> Task:
     - No parent task → ISSUE (standard task)
 
     Args:
+    ----
         task: Asana task data
 
     Returns:
+    -------
         Task model instance
 
     """
@@ -181,11 +187,13 @@ def map_epic_to_asana_project(
     """Map Epic to Asana project create/update data.
 
     Args:
+    ----
         epic: Epic model instance
         workspace_gid: Asana workspace GID
         team_gid: Asana team GID (optional, required for organization workspaces)
 
     Returns:
+    -------
         Asana project data for create/update
 
     """
@@ -216,11 +224,13 @@ def map_task_to_asana_task(
     """Map Task to Asana task create/update data.
 
     Args:
+    ----
         task: Task model instance
         workspace_gid: Asana workspace GID
         project_gids: List of project GIDs to add task to (optional)
 
     Returns:
+    -------
         Asana task data for create/update
 
     """
@@ -262,10 +272,12 @@ def map_asana_story_to_comment(story: dict[str, Any], task_gid: str) -> Comment
     Only maps stories of type 'comment'. Other story types (system events) are filtered out.
 
     Args:
+    ----
         story: Asana story data
         task_gid: Parent task GID
 
     Returns:
+    -------
         Comment model instance or None if not a comment type
 
     """
@@ -300,10 +312,12 @@ def map_asana_attachment_to_attachment(
     IMPORTANT: Use permanent_url for reliable access, not download_url which expires.
 
     Args:
+    ----
         attachment: Asana attachment data
         task_gid: Parent task GID
 
     Returns:
+    -------
         Attachment model instance
 
     """

mcp_ticketer/adapters/github/__init__.py

@@ -0,0 +1,26 @@
+"""GitHub adapter for MCP Ticketer.
+
+This module provides integration with GitHub's REST and GraphQL APIs for universal ticket management.
+The adapter is split into multiple modules for better organization:
+
+- adapter.py: Main GitHubAdapter class with core functionality
+- queries.py: GraphQL queries and fragments
+- types.py: GitHub-specific types and mappings
+- client.py: HTTP/GraphQL client management
+- mappers.py: Data transformation between GitHub and universal models
+
+Usage:
+    from mcp_ticketer.adapters.github import GitHubAdapter
+
+    config = {
+        "token": "your_github_token",
+        "owner": "repository_owner",
+        "repo": "repository_name"
+    }
+    adapter = GitHubAdapter(config)
+"""
+
+from .adapter import GitHubAdapter
+from .types import GitHubStateMapping
+
+__all__ = ["GitHubAdapter", "GitHubStateMapping"]