mcp-ticketer 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

mcp_ticketer/mcp/dto.py

@@ -1,6 +1,6 @@
 """Data Transfer Objects for MCP requests and responses."""
 
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, Field
 
@@ -10,32 +10,32 @@ class CreateTicketRequest(BaseModel):
     """Request to create a ticket."""
 
     title: str = Field(..., min_length=1, description="Ticket title")
-    description: Optional[str] = Field(None, description="Ticket description")
+    description: str | None = Field(None, description="Ticket description")
     priority: str = Field("medium", description="Ticket priority")
     tags: list[str] = Field(default_factory=list, description="Ticket tags")
-    assignee: Optional[str] = Field(None, description="Ticket assignee")
+    assignee: str | None = Field(None, description="Ticket assignee")
 
 
 class CreateEpicRequest(BaseModel):
     """Request to create an epic."""
 
     title: str = Field(..., min_length=1, description="Epic title")
-    description: Optional[str] = Field(None, description="Epic description")
+    description: str | None = Field(None, description="Epic description")
     child_issues: list[str] = Field(default_factory=list, description="Child issue IDs")
-    target_date: Optional[str] = Field(None, description="Target completion date")
-    lead_id: Optional[str] = Field(None, description="Epic lead/owner ID")
+    target_date: str | None = Field(None, description="Target completion date")
+    lead_id: str | None = Field(None, description="Epic lead/owner ID")
 
 
 class CreateIssueRequest(BaseModel):
     """Request to create an issue."""
 
     title: str = Field(..., min_length=1, description="Issue title")
-    description: Optional[str] = Field(None, description="Issue description")
-    epic_id: Optional[str] = Field(None, description="Parent epic ID")
+    description: str | None = Field(None, description="Issue description")
+    epic_id: str | None = Field(None, description="Parent epic ID")
     priority: str = Field("medium", description="Issue priority")
-    assignee: Optional[str] = Field(None, description="Issue assignee")
+    assignee: str | None = Field(None, description="Issue assignee")
     tags: list[str] = Field(default_factory=list, description="Issue tags")
-    estimated_hours: Optional[float] = Field(
+    estimated_hours: float | None = Field(
         None, description="Estimated hours to complete"
     )
 
@@ -45,11 +45,11 @@ class CreateTaskRequest(BaseModel):
 
     title: str = Field(..., min_length=1, description="Task title")
     parent_id: str = Field(..., description="Parent issue ID")
-    description: Optional[str] = Field(None, description="Task description")
+    description: str | None = Field(None, description="Task description")
     priority: str = Field("medium", description="Task priority")
-    assignee: Optional[str] = Field(None, description="Task assignee")
+    assignee: str | None = Field(None, description="Task assignee")
     tags: list[str] = Field(default_factory=list, description="Task tags")
-    estimated_hours: Optional[float] = Field(
+    estimated_hours: float | None = Field(
         None, description="Estimated hours to complete"
     )
 
@@ -77,11 +77,11 @@ class TransitionRequest(BaseModel):
 class SearchRequest(BaseModel):
     """Request to search tickets."""
 
-    query: Optional[str] = Field(None, description="Search query text")
-    state: Optional[str] = Field(None, description="Filter by ticket state")
-    priority: Optional[str] = Field(None, description="Filter by priority")
-    assignee: Optional[str] = Field(None, description="Filter by assignee")
-    tags: Optional[list[str]] = Field(None, description="Filter by tags")
+    query: str | None = Field(None, description="Search query text")
+    state: str | None = Field(None, description="Filter by ticket state")
+    priority: str | None = Field(None, description="Filter by priority")
+    assignee: str | None = Field(None, description="Filter by assignee")
+    tags: list[str] | None = Field(None, description="Filter by tags")
     limit: int = Field(10, description="Maximum number of results")
 
 
@@ -90,7 +90,7 @@ class ListRequest(BaseModel):
 
     limit: int = Field(10, description="Maximum number of tickets to return")
     offset: int = Field(0, description="Number of tickets to skip")
-    filters: Optional[dict[str, Any]] = Field(None, description="Additional filters")
+    filters: dict[str, Any] | None = Field(None, description="Additional filters")
 
 
 class DeleteTicketRequest(BaseModel):
@@ -104,8 +104,8 @@ class CommentRequest(BaseModel):
 
     operation: str = Field("add", description="Operation: 'add' or 'list'")
     ticket_id: str = Field(..., description="Ticket ID")
-    content: Optional[str] = Field(None, description="Comment content (for add)")
-    author: Optional[str] = Field(None, description="Comment author (for add)")
+    content: str | None = Field(None, description="Comment content (for add)")
+    author: str | None = Field(None, description="Comment author (for add)")
     limit: int = Field(10, description="Max comments to return (for list)")
     offset: int = Field(0, description="Number of comments to skip (for list)")
 
@@ -115,12 +115,12 @@ class CreatePRRequest(BaseModel):
 
     ticket_id: str = Field(..., description="Ticket ID")
     base_branch: str = Field("main", description="Base branch")
-    head_branch: Optional[str] = Field(None, description="Head branch")
-    title: Optional[str] = Field(None, description="PR title")
-    body: Optional[str] = Field(None, description="PR body")
+    head_branch: str | None = Field(None, description="Head branch")
+    title: str | None = Field(None, description="PR title")
+    body: str | None = Field(None, description="PR body")
     draft: bool = Field(False, description="Create as draft PR")
-    github_owner: Optional[str] = Field(None, description="GitHub owner (for Linear)")
-    github_repo: Optional[str] = Field(None, description="GitHub repo (for Linear)")
+    github_owner: str | None = Field(None, description="GitHub owner (for Linear)")
+    github_repo: str | None = Field(None, description="GitHub repo (for Linear)")
 
 
 class LinkPRRequest(BaseModel):
@@ -152,7 +152,7 @@ class IssueTasksRequest(BaseModel):
 class HierarchyTreeRequest(BaseModel):
     """Request to get hierarchy tree."""
 
-    epic_id: Optional[str] = Field(None, description="Specific epic ID (optional)")
+    epic_id: str | None = Field(None, description="Specific epic ID (optional)")
     max_depth: int = Field(3, description="Maximum depth of tree")
     limit: int = Field(10, description="Max epics to return (if no epic_id)")
 
@@ -173,8 +173,8 @@ class SearchHierarchyRequest(BaseModel):
     """Request to search with hierarchy context."""
 
     query: str = Field("", description="Search query")
-    state: Optional[str] = Field(None, description="Filter by state")
-    priority: Optional[str] = Field(None, description="Filter by priority")
+    state: str | None = Field(None, description="Filter by state")
+    priority: str | None = Field(None, description="Filter by priority")
     include_children: bool = Field(True, description="Include child tickets")
     include_parents: bool = Field(True, description="Include parent tickets")
     limit: int = Field(50, description="Maximum number of results")
@@ -184,9 +184,9 @@ class AttachRequest(BaseModel):
     """Request to attach file to ticket."""
 
     ticket_id: str = Field(..., description="Ticket ID")
-    file_path: Optional[str] = Field(None, description="File path to attach")
-    file_content: Optional[str] = Field(None, description="File content (base64)")
-    file_name: Optional[str] = Field(None, description="File name")
+    file_path: str | None = Field(None, description="File path to attach")
+    file_content: str | None = Field(None, description="File content (base64)")
+    file_name: str | None = Field(None, description="File name")
 
 
 class ListAttachmentsRequest(BaseModel):

mcp_ticketer/mcp/response_builder.py

@@ -1,6 +1,6 @@
 """Response builder utility for consistent MCP responses."""
 
-from typing import Any, Optional
+from typing import Any
 
 from .constants import JSONRPC_VERSION, STATUS_COMPLETED
 
@@ -36,7 +36,7 @@ class ResponseBuilder:
         request_id: Any,
         code: int,
         message: str,
-        data: Optional[dict[str, Any]] = None,
+        data: dict[str, Any] | None = None,
     ) -> dict[str, Any]:
         """Build error response.
 

mcp_ticketer/mcp/server.py

@@ -4,7 +4,7 @@ import asyncio
 import json
 import sys
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 from dotenv import load_dotenv
 
@@ -70,7 +70,7 @@ class MCPTicketServer:
     """MCP server for ticket operations over stdio - synchronous implementation."""
 
     def __init__(
-        self, adapter_type: str = "aitrackdown", config: Optional[dict[str, Any]] = None
+        self, adapter_type: str = "aitrackdown", config: dict[str, Any] | None = None
     ):
         """Initialize MCP server.
 
@@ -1129,7 +1129,7 @@ async def main():
     await server.run()
 
 
-def _load_env_configuration() -> Optional[dict[str, Any]]:
+def _load_env_configuration() -> dict[str, Any] | None:
     """Load adapter configuration from .env files.
 
     Checks .env.local first (highest priority), then .env.

mcp_ticketer/mcp/server_sdk.py

@@ -10,7 +10,7 @@ startup and used by all tool implementations.
 """
 
 import logging
-from typing import Any, Optional
+from typing import Any
 
 from mcp.server.fastmcp import FastMCP
 
@@ -21,7 +21,7 @@ from ..core.registry import AdapterRegistry
 mcp = FastMCP("mcp-ticketer")
 
 # Global adapter instance
-_adapter: Optional[BaseAdapter] = None
+_adapter: BaseAdapter | None = None
 
 # Configure logging
 logger = logging.getLogger(__name__)

mcp_ticketer/mcp/tools/attachment_tools.py

@@ -7,6 +7,7 @@ available in all adapters.
 
 from typing import Any
 
+from ...core.models import Comment
 from ..server_sdk import get_adapter, mcp
 
 
@@ -15,7 +16,7 @@ async def ticket_attach(
     ticket_id: str,
     file_path: str,
     description: str = "",
-) -> dict[str, Any]:
+) -> dict[str, Any]:  # Keep as dict for MCP compatibility
     """Attach a file to a ticket.
 
     Uploads a file and associates it with the specified ticket. This
@@ -63,8 +64,6 @@ async def ticket_attach(
 
     except AttributeError:
         # Fallback: Add file reference as comment
-        from ...core.models import Comment
-
         comment_text = f"Attachment: {file_path}"
         if description:
             comment_text += f"\nDescription: {description}"
@@ -102,7 +101,7 @@ async def ticket_attach(
 @mcp.tool()
 async def ticket_attachments(
     ticket_id: str,
-) -> dict[str, Any]:
+) -> dict[str, Any]:  # Keep as dict for MCP compatibility
     """Get all attachments for a ticket.
 
     Retrieves a list of all files attached to the specified ticket.

mcp_ticketer/mcp/tools/comment_tools.py

@@ -3,7 +3,7 @@
 This module implements tools for adding and retrieving comments on tickets.
 """
 
-from typing import Any, Optional
+from typing import Any
 
 from ...core.models import Comment
 from ..server_sdk import get_adapter, mcp
@@ -13,7 +13,7 @@ from ..server_sdk import get_adapter, mcp
 async def ticket_comment(
     ticket_id: str,
     operation: str,
-    text: Optional[str] = None,
+    text: str | None = None,
     limit: int = 10,
     offset: int = 0,
 ) -> dict[str, Any]:

mcp_ticketer/mcp/tools/hierarchy_tools.py

@@ -7,7 +7,7 @@ This module implements tools for managing the three-level ticket hierarchy:
 """
 
 from datetime import datetime
-from typing import Any, Optional
+from typing import Any
 
 from ...core.models import Epic, Priority, Task, TicketType
 from ..server_sdk import get_adapter, mcp
@@ -17,9 +17,9 @@ from ..server_sdk import get_adapter, mcp
 async def epic_create(
     title: str,
     description: str = "",
-    target_date: Optional[str] = None,
-    lead_id: Optional[str] = None,
-    child_issues: Optional[list[str]] = None,
+    target_date: str | None = None,
+    lead_id: str | None = None,
+    child_issues: list[str] | None = None,
 ) -> dict[str, Any]:
     """Create a new epic (strategic level container).
 
@@ -156,8 +156,8 @@ async def epic_issues(epic_id: str) -> dict[str, Any]:
 async def issue_create(
     title: str,
     description: str = "",
-    epic_id: Optional[str] = None,
-    assignee: Optional[str] = None,
+    epic_id: str | None = None,
+    assignee: str | None = None,
     priority: str = "medium",
 ) -> dict[str, Any]:
     """Create a new issue (standard work item).
@@ -258,8 +258,8 @@ async def issue_tasks(issue_id: str) -> dict[str, Any]:
 async def task_create(
     title: str,
     description: str = "",
-    issue_id: Optional[str] = None,
-    assignee: Optional[str] = None,
+    issue_id: str | None = None,
+    assignee: str | None = None,
     priority: str = "medium",
 ) -> dict[str, Any]:
     """Create a new task (sub-work item).

mcp_ticketer/mcp/tools/pr_tools.py

@@ -5,7 +5,7 @@ creating PRs from tickets. Note that PR functionality may not be available
 in all adapters.
 """
 
-from typing import Any, Optional
+from typing import Any
 
 from ..server_sdk import get_adapter, mcp
 
@@ -15,7 +15,7 @@ async def ticket_create_pr(
     ticket_id: str,
     title: str,
     description: str = "",
-    source_branch: Optional[str] = None,
+    source_branch: str | None = None,
     target_branch: str = "main",
 ) -> dict[str, Any]:
     """Create a pull request linked to a ticket.

mcp_ticketer/mcp/tools/search_tools.py

@@ -4,7 +4,7 @@ This module implements advanced search capabilities for tickets using
 various filters and criteria.
 """
 
-from typing import Any, Optional
+from typing import Any
 
 from ...core.models import Priority, SearchQuery, TicketState
 from ..server_sdk import get_adapter, mcp
@@ -12,11 +12,11 @@ from ..server_sdk import get_adapter, mcp
 
 @mcp.tool()
 async def ticket_search(
-    query: Optional[str] = None,
-    state: Optional[str] = None,
-    priority: Optional[str] = None,
-    tags: Optional[list[str]] = None,
-    assignee: Optional[str] = None,
+    query: str | None = None,
+    state: str | None = None,
+    priority: str | None = None,
+    tags: list[str] | None = None,
+    assignee: str | None = None,
     limit: int = 10,
 ) -> dict[str, Any]:
     """Search tickets using advanced filters.

mcp_ticketer/mcp/tools/ticket_tools.py

@@ -4,7 +4,7 @@ This module implements the core create, read, update, delete, and list
 operations for tickets using the FastMCP SDK.
 """
 
-from typing import Any, Optional
+from typing import Any
 
 from ...core.models import Priority, Task, TicketState
 from ..server_sdk import get_adapter, mcp
@@ -15,8 +15,8 @@ async def ticket_create(
     title: str,
     description: str = "",
     priority: str = "medium",
-    tags: Optional[list[str]] = None,
-    assignee: Optional[str] = None,
+    tags: list[str] | None = None,
+    assignee: str | None = None,
 ) -> dict[str, Any]:
     """Create a new ticket with specified details.
 
@@ -101,12 +101,12 @@ async def ticket_read(ticket_id: str) -> dict[str, Any]:
 @mcp.tool()
 async def ticket_update(
     ticket_id: str,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    priority: Optional[str] = None,
-    state: Optional[str] = None,
-    assignee: Optional[str] = None,
-    tags: Optional[list[str]] = None,
+    title: str | None = None,
+    description: str | None = None,
+    priority: str | None = None,
+    state: str | None = None,
+    assignee: str | None = None,
+    tags: list[str] | None = None,
 ) -> dict[str, Any]:
     """Update an existing ticket.
 
@@ -214,9 +214,9 @@ async def ticket_delete(ticket_id: str) -> dict[str, Any]:
 async def ticket_list(
     limit: int = 10,
     offset: int = 0,
-    state: Optional[str] = None,
-    priority: Optional[str] = None,
-    assignee: Optional[str] = None,
+    state: str | None = None,
+    priority: str | None = None,
+    assignee: str | None = None,
 ) -> dict[str, Any]:
     """List tickets with pagination and optional filters.
 

mcp_ticketer/queue/health_monitor.py

@@ -4,7 +4,7 @@ import logging
 import time
 from datetime import datetime, timedelta
 from enum import Enum
-from typing import Any, Optional
+from typing import Any
 
 import psutil
 
@@ -30,8 +30,8 @@ class HealthAlert:
         self,
         level: HealthStatus,
         message: str,
-        details: Optional[dict[str, Any]] = None,
-        timestamp: Optional[datetime] = None,
+        details: dict[str, Any] | None = None,
+        timestamp: datetime | None = None,
     ):
         self.level = level
         self.message = message
@@ -52,7 +52,7 @@ class QueueHealthMonitor:
     QUEUE_BACKLOG_WARNING = 10  # Warn if more than 10 pending items
     QUEUE_BACKLOG_CRITICAL = 50  # Critical if more than 50 pending items
 
-    def __init__(self, queue: Optional[Queue] = None):
+    def __init__(self, queue: Queue | None = None):
         """Initialize health monitor.
 
         Args:

mcp_ticketer/queue/manager.py

@@ -7,7 +7,7 @@ import subprocess
 import sys
 import time
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 import psutil
 
@@ -304,7 +304,7 @@ class WorkerManager:
 
         return status
 
-    def _get_pid(self) -> Optional[int]:
+    def _get_pid(self) -> int | None:
         """Get worker PID from file.
 
         Returns:

mcp_ticketer/queue/queue.py

@@ -8,7 +8,7 @@ from dataclasses import asdict, dataclass
 from datetime import datetime, timedelta
 from enum import Enum
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 
 class QueueStatus(str, Enum):
@@ -30,12 +30,12 @@ class QueueItem:
     operation: str
     status: QueueStatus
     created_at: datetime
-    processed_at: Optional[datetime] = None
-    error_message: Optional[str] = None
+    processed_at: datetime | None = None
+    error_message: str | None = None
     retry_count: int = 0
-    result: Optional[dict[str, Any]] = None
-    project_dir: Optional[str] = None
-    adapter_config: Optional[dict[str, Any]] = None  # Adapter configuration
+    result: dict[str, Any] | None = None
+    project_dir: str | None = None
+    adapter_config: dict[str, Any] | None = None  # Adapter configuration
 
     def to_dict(self) -> dict:
         """Convert to dictionary for storage."""
@@ -67,7 +67,7 @@ class QueueItem:
 class Queue:
     """Thread-safe SQLite queue for ticket operations."""
 
-    def __init__(self, db_path: Optional[Path] = None):
+    def __init__(self, db_path: Path | None = None):
         """Initialize queue with database connection.
 
         Args:
@@ -139,8 +139,8 @@ class Queue:
         ticket_data: dict[str, Any],
         adapter: str,
         operation: str,
-        project_dir: Optional[str] = None,
-        adapter_config: Optional[dict[str, Any]] = None,
+        project_dir: str | None = None,
+        adapter_config: dict[str, Any] | None = None,
     ) -> str:
         """Add item to queue.
 
@@ -186,7 +186,7 @@ class Queue:
 
         return queue_id
 
-    def get_next_pending(self) -> Optional[QueueItem]:
+    def get_next_pending(self) -> QueueItem | None:
         """Get next pending item from queue atomically.
 
         Returns:
@@ -251,9 +251,9 @@ class Queue:
         self,
         queue_id: str,
         status: QueueStatus,
-        error_message: Optional[str] = None,
-        result: Optional[dict[str, Any]] = None,
-        expected_status: Optional[QueueStatus] = None,
+        error_message: str | None = None,
+        result: dict[str, Any] | None = None,
+        expected_status: QueueStatus | None = None,
     ) -> bool:
         """Update queue item status atomically.
 
@@ -328,7 +328,7 @@ class Queue:
                     raise
 
     def increment_retry(
-        self, queue_id: str, expected_status: Optional[QueueStatus] = None
+        self, queue_id: str, expected_status: QueueStatus | None = None
     ) -> int:
         """Increment retry count and reset to pending atomically.
 
@@ -387,7 +387,7 @@ class Queue:
                     conn.rollback()
                     raise
 
-    def get_item(self, queue_id: str) -> Optional[QueueItem]:
+    def get_item(self, queue_id: str) -> QueueItem | None:
         """Get specific queue item by ID.
 
         Args:
@@ -409,7 +409,7 @@ class Queue:
             return QueueItem.from_row(row) if row else None
 
     def list_items(
-        self, status: Optional[QueueStatus] = None, limit: int = 50
+        self, status: QueueStatus | None = None, limit: int = 50
     ) -> list[QueueItem]:
         """List queue items.
 

mcp_ticketer/queue/ticket_registry.py

@@ -5,13 +5,13 @@ import sqlite3
 import threading
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 
 class TicketRegistry:
     """Persistent registry for tracking ticket IDs and their lifecycle."""
 
-    def __init__(self, db_path: Optional[Path] = None):
+    def __init__(self, db_path: Path | None = None):
         """Initialize ticket registry.
 
         Args:
@@ -130,10 +130,10 @@ class TicketRegistry:
         self,
         queue_id: str,
         status: str,
-        ticket_id: Optional[str] = None,
-        result_data: Optional[dict[str, Any]] = None,
-        error_message: Optional[str] = None,
-        retry_count: Optional[int] = None,
+        ticket_id: str | None = None,
+        result_data: dict[str, Any] | None = None,
+        error_message: str | None = None,
+        retry_count: int | None = None,
     ) -> None:
         """Update ticket operation status.
 
@@ -179,7 +179,7 @@ class TicketRegistry:
                 )
                 conn.commit()
 
-    def get_ticket_info(self, queue_id: str) -> Optional[dict[str, Any]]:
+    def get_ticket_info(self, queue_id: str) -> dict[str, Any] | None:
         """Get ticket information by queue ID.
 
         Args:

mcp_ticketer/queue/worker.py

@@ -7,7 +7,7 @@ import threading
 import time
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 from dotenv import load_dotenv
 
@@ -58,7 +58,7 @@ class Worker:
 
     def __init__(
         self,
-        queue: Optional[Queue] = None,
+        queue: Queue | None = None,
         batch_size: int = DEFAULT_BATCH_SIZE,
         max_concurrent: int = DEFAULT_MAX_CONCURRENT,
     ):