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

mcp_ticketer/adapters/asana/adapter.py

@@ -59,6 +59,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 +69,7 @@ class AsanaAdapter(BaseAdapter[Task]):
                 - max_retries: Maximum retry attempts (default: 3)
 
         Raises:
+        ------
             ValueError: If required configuration is missing
 
         """
@@ -120,6 +122,7 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Validate Asana API credentials.
 
         Returns:
+        -------
             Tuple of (is_valid, error_message)
 
         """
@@ -244,9 +247,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 +282,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 +302,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 +348,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 +367,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 +404,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 +446,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 +477,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 +510,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 +585,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 +624,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 +656,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 +802,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Delete an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
 
         Returns:
+        -------
             True if successfully deleted
 
         """
@@ -795,11 +823,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 +926,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 +968,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 +983,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 +1021,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 +1058,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 +1082,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 +1108,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 +1153,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """List all Asana projects (Epics).
 
         Args:
+        ----
             **kwargs: Optional filter parameters
 
         Returns:
+        -------
             List of epics
 
         """
@@ -1143,13 +1190,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 +1260,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """List all subtasks of a task (Issue).
 
         Args:
+        ----
             issue_id: Parent task GID
 
         Returns:
+        -------
             List of subtasks
 
         """
@@ -1198,14 +1299,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 +1359,11 @@ class AsanaAdapter(BaseAdapter[Task]):
         """Get all attachments for an Asana task.
 
         Args:
+        ----
             ticket_id: Task GID
 
         Returns:
+        -------
             List of attachments
 
         """
@@ -1285,10 +1391,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
 
         """

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
 
     """