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

mcp_ticketer/adapters/jira.py

@@ -6,20 +6,21 @@ import logging
 import re
 from datetime import datetime
 from enum import Enum
-from typing import Any, Optional, Union
+from typing import Any, Union
 
 import httpx
 from httpx import AsyncClient, HTTPStatusError, TimeoutException
 
 from ..core.adapter import BaseAdapter
 from ..core.env_loader import load_adapter_config, validate_adapter_config
-from ..core.models import Comment, Epic, Priority, SearchQuery, Task, TicketState
+from ..core.models import (Comment, Epic, Priority, SearchQuery, Task,
+                           TicketState)
 from ..core.registry import AdapterRegistry
 
 logger = logging.getLogger(__name__)
 
 
-def parse_jira_datetime(date_str: str) -> Optional[datetime]:
+def parse_jira_datetime(date_str: str) -> datetime | None:
     """Parse JIRA datetime strings which can be in various formats.
 
     JIRA can return dates in formats like:
@@ -47,7 +48,7 @@ def parse_jira_datetime(date_str: str) -> Optional[datetime]:
         return None
 
 
-def extract_text_from_adf(adf_content: Union[str, dict[str, Any]]) -> str:
+def extract_text_from_adf(adf_content: str | dict[str, Any]) -> str:
     """Extract plain text from Atlassian Document Format (ADF).
 
     Args:
@@ -221,8 +222,8 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         self,
         method: str,
         endpoint: str,
-        data: Optional[dict[str, Any]] = None,
-        params: Optional[dict[str, Any]] = None,
+        data: dict[str, Any] | None = None,
+        params: dict[str, Any] | None = None,
         retry_count: int = 0,
     ) -> dict[str, Any]:
         """Make HTTP request to JIRA API with retry logic.
@@ -287,7 +288,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         return self._priority_cache
 
     async def _get_issue_types(
-        self, project_key: Optional[str] = None
+        self, project_key: str | None = None
     ) -> list[dict[str, Any]]:
         """Get available issue types for a project."""
         key = project_key or self.project_key
@@ -380,9 +381,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         }
         return mapping.get(priority, JiraPriority.MEDIUM)
 
-    def _map_priority_from_jira(
-        self, jira_priority: Optional[dict[str, Any]]
-    ) -> Priority:
+    def _map_priority_from_jira(self, jira_priority: dict[str, Any] | None) -> Priority:
         """Map JIRA priority to universal priority."""
         if not jira_priority:
             return Priority.MEDIUM
@@ -432,7 +431,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         else:
             return TicketState.OPEN
 
-    def _issue_to_ticket(self, issue: dict[str, Any]) -> Union[Epic, Task]:
+    def _issue_to_ticket(self, issue: dict[str, Any]) -> Epic | Task:
         """Convert JIRA issue to universal ticket model."""
         fields = issue.get("fields", {})
 
@@ -507,7 +506,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
             )
 
     def _ticket_to_issue_fields(
-        self, ticket: Union[Epic, Task], issue_type: Optional[str] = None
+        self, ticket: Epic | Task, issue_type: str | None = None
     ) -> dict[str, Any]:
         """Convert universal ticket to JIRA issue fields."""
         # Convert description to ADF format for JIRA Cloud
@@ -556,7 +555,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
         return fields
 
-    async def create(self, ticket: Union[Epic, Task]) -> Union[Epic, Task]:
+    async def create(self, ticket: Epic | Task) -> Epic | Task:
         """Create a new JIRA issue."""
         # Validate credentials before attempting operation
         is_valid, error_message = self.validate_credentials()
@@ -576,7 +575,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         created_issue = await self._make_request("GET", f"issue/{ticket.id}")
         return self._issue_to_ticket(created_issue)
 
-    async def read(self, ticket_id: str) -> Optional[Union[Epic, Task]]:
+    async def read(self, ticket_id: str) -> Epic | Task | None:
         """Read a JIRA issue by key."""
         # Validate credentials before attempting operation
         is_valid, error_message = self.validate_credentials()
@@ -595,7 +594,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def update(
         self, ticket_id: str, updates: dict[str, Any]
-    ) -> Optional[Union[Epic, Task]]:
+    ) -> Epic | Task | None:
         """Update a JIRA issue."""
         # Validate credentials before attempting operation
         is_valid, error_message = self.validate_credentials()
@@ -652,8 +651,8 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
             raise
 
     async def list(
-        self, limit: int = 10, offset: int = 0, filters: Optional[dict[str, Any]] = None
-    ) -> list[Union[Epic, Task]]:
+        self, limit: int = 10, offset: int = 0, filters: dict[str, Any] | None = None
+    ) -> list[Epic | Task]:
         """List JIRA issues with pagination."""
         # Build JQL query
         jql_parts = []
@@ -692,7 +691,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         issues = data.get("issues", [])
         return [self._issue_to_ticket(issue) for issue in issues]
 
-    async def search(self, query: SearchQuery) -> builtins.list[Union[Epic, Task]]:
+    async def search(self, query: SearchQuery) -> builtins.list[Epic | Task]:
         """Search JIRA issues using JQL."""
         # Build JQL query
         jql_parts = []
@@ -744,7 +743,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def transition_state(
         self, ticket_id: str, target_state: TicketState
-    ) -> Optional[Union[Epic, Task]]:
+    ) -> Epic | Task | None:
         """Transition JIRA issue to a new state."""
         # Get available transitions
         transitions = await self._get_transitions(ticket_id)
@@ -858,9 +857,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
         return comments
 
-    async def get_project_info(
-        self, project_key: Optional[str] = None
-    ) -> dict[str, Any]:
+    async def get_project_info(self, project_key: str | None = None) -> dict[str, Any]:
         """Get JIRA project information including workflows and fields."""
         key = project_key or self.project_key
         if not key:
@@ -882,7 +879,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def execute_jql(
         self, jql: str, limit: int = 50
-    ) -> builtins.list[Union[Epic, Task]]:
+    ) -> builtins.list[Epic | Task]:
         """Execute a raw JQL query.
 
         Args:
@@ -908,7 +905,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         return [self._issue_to_ticket(issue) for issue in issues]
 
     async def get_sprints(
-        self, board_id: Optional[int] = None
+        self, board_id: int | None = None
     ) -> builtins.list[dict[str, Any]]:
         """Get active sprints for a board (requires JIRA Software).
 
@@ -992,7 +989,7 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
             except Exception:
                 return []
 
-    async def get_current_user(self) -> Optional[dict[str, Any]]:
+    async def get_current_user(self) -> dict[str, Any] | None:
         """Get current authenticated user information."""
         try:
             return await self._make_request("GET", "myself")

mcp_ticketer/adapters/linear/adapter.py

@@ -20,27 +20,15 @@ from ...core.adapter import BaseAdapter
 from ...core.models import Comment, Epic, SearchQuery, Task, TicketState
 from ...core.registry import AdapterRegistry
 from .client import LinearGraphQLClient
-from .mappers import (
-    build_linear_issue_input,
-    build_linear_issue_update_input,
-    map_linear_comment_to_comment,
-    map_linear_issue_to_task,
-    map_linear_project_to_epic,
-)
-from .queries import (
-    ALL_FRAGMENTS,
-    CREATE_ISSUE_MUTATION,
-    LIST_ISSUES_QUERY,
-    SEARCH_ISSUES_QUERY,
-    UPDATE_ISSUE_MUTATION,
-    WORKFLOW_STATES_QUERY,
-)
-from .types import (
-    LinearStateMapping,
-    build_issue_filter,
-    get_linear_priority,
-    get_linear_state_type,
-)
+from .mappers import (build_linear_issue_input,
+                      build_linear_issue_update_input,
+                      map_linear_comment_to_comment, map_linear_issue_to_task,
+                      map_linear_project_to_epic)
+from .queries import (ALL_FRAGMENTS, CREATE_ISSUE_MUTATION, LIST_ISSUES_QUERY,
+                      SEARCH_ISSUES_QUERY, UPDATE_ISSUE_MUTATION,
+                      WORKFLOW_STATES_QUERY)
+from .types import (LinearStateMapping, build_issue_filter,
+                    get_linear_priority, get_linear_state_type)
 
 
 class LinearAdapter(BaseAdapter[Task]):

mcp_ticketer/adapters/linear/client.py

@@ -16,7 +16,8 @@ except ImportError:
     HTTPXAsyncTransport = None
     TransportError = Exception
 
-from ...core.exceptions import AdapterError, AuthenticationError, RateLimitError
+from ...core.exceptions import (AdapterError, AuthenticationError,
+                                RateLimitError)
 
 
 class LinearGraphQLClient:

mcp_ticketer/adapters/linear/mappers.py

@@ -6,7 +6,8 @@ from datetime import datetime
 from typing import Any
 
 from ...core.models import Comment, Epic, Priority, Task, TicketState
-from .types import extract_linear_metadata, get_universal_priority, get_universal_state
+from .types import (extract_linear_metadata, get_universal_priority,
+                    get_universal_state)
 
 
 def map_linear_issue_to_task(issue_data: dict[str, Any]) -> Task:

mcp_ticketer/cache/memory.py

@@ -4,8 +4,9 @@ import asyncio
 import hashlib
 import json
 import time
+from collections.abc import Callable
 from functools import wraps
-from typing import Any, Callable, Optional
+from typing import Any
 
 
 class CacheEntry:
@@ -41,7 +42,7 @@ class MemoryCache:
         self._default_ttl = default_ttl
         self._lock = asyncio.Lock()
 
-    async def get(self, key: str) -> Optional[Any]:
+    async def get(self, key: str) -> Any | None:
         """Get value from cache.
 
         Args:
@@ -60,7 +61,7 @@ class MemoryCache:
                 del self._cache[key]
             return None
 
-    async def set(self, key: str, value: Any, ttl: Optional[float] = None) -> None:
+    async def set(self, key: str, value: Any, ttl: float | None = None) -> None:
         """Set value in cache.
 
         Args:
@@ -134,9 +135,9 @@ class MemoryCache:
 
 
 def cache_decorator(
-    ttl: Optional[float] = None,
+    ttl: float | None = None,
     key_prefix: str = "",
-    cache_instance: Optional[MemoryCache] = None,
+    cache_instance: MemoryCache | None = None,
 ) -> Callable:
     """Decorator for caching async function results.
 

mcp_ticketer/cli/adapter_diagnostics.py

@@ -197,7 +197,8 @@ def _test_adapter_instantiation(console: Console) -> None:
                 if primary:
                     adapter_type = primary.adapter_type
                     # Build config from discovery
-                    from ..mcp.server import _build_adapter_config_from_env_vars
+                    from ..mcp.server import \
+                        _build_adapter_config_from_env_vars
 
                     config = _build_adapter_config_from_env_vars(adapter_type, {})
                 else:
@@ -384,7 +385,8 @@ def get_adapter_status() -> dict[str, Any]:
                     adapter_type = primary.adapter_type
                     status["configuration_source"] = primary.found_in
                     # Build basic config
-                    from ..mcp.server import _build_adapter_config_from_env_vars
+                    from ..mcp.server import \
+                        _build_adapter_config_from_env_vars
 
                     config = _build_adapter_config_from_env_vars(adapter_type, {})
                 else:

mcp_ticketer/cli/codex_configure.py

@@ -6,7 +6,7 @@ Unlike Claude Code and Gemini CLI, there is no project-level configuration suppo
 
 import sys
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 if sys.version_info >= (3, 11):
     import tomllib
@@ -78,7 +78,7 @@ def save_codex_config(config_path: Path, config: dict[str, Any]) -> None:
 
 
 def create_codex_server_config(
-    binary_path: str, project_config: dict, cwd: Optional[str] = None
+    binary_path: str, project_config: dict, cwd: str | None = None
 ) -> dict[str, Any]:
     """Create Codex MCP server configuration for mcp-ticketer.
 

mcp_ticketer/cli/configure.py

@@ -1,7 +1,6 @@
 """Interactive configuration wizard for MCP Ticketer."""
 
 import os
-from typing import Optional
 
 import typer
 from rich.console import Console
@@ -9,15 +8,9 @@ from rich.panel import Panel
 from rich.prompt import Confirm, Prompt
 from rich.table import Table
 
-from ..core.project_config import (
-    AdapterConfig,
-    AdapterType,
-    ConfigResolver,
-    ConfigValidator,
-    HybridConfig,
-    SyncStrategy,
-    TicketerConfig,
-)
+from ..core.project_config import (AdapterConfig, AdapterType, ConfigResolver,
+                                   ConfigValidator, HybridConfig, SyncStrategy,
+                                   TicketerConfig)
 
 console = Console()
 
@@ -440,10 +433,10 @@ def show_current_config() -> None:
 
 
 def set_adapter_config(
-    adapter: Optional[str] = None,
-    api_key: Optional[str] = None,
-    project_id: Optional[str] = None,
-    team_id: Optional[str] = None,
+    adapter: str | None = None,
+    api_key: str | None = None,
+    project_id: str | None = None,
+    team_id: str | None = None,
     global_scope: bool = False,
     **kwargs,
 ) -> None:

mcp_ticketer/cli/diagnostics.py

@@ -5,7 +5,7 @@ import logging
 import sys
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any
 
 import typer
 from rich.console import Console
@@ -795,7 +795,7 @@ class SystemDiagnostics:
 
 
 async def run_diagnostics(
-    output_file: Optional[str] = None,
+    output_file: str | None = None,
     json_output: bool = False,
 ) -> None:
     """Run comprehensive system diagnostics."""

mcp_ticketer/cli/discover.py

@@ -1,18 +1,13 @@
 """CLI command for auto-discovering configuration from .env files."""
 
 from pathlib import Path
-from typing import Optional
 
 import typer
 from rich.console import Console
 
 from ..core.env_discovery import DiscoveredAdapter, EnvDiscovery
-from ..core.project_config import (
-    AdapterConfig,
-    ConfigResolver,
-    ConfigValidator,
-    TicketerConfig,
-)
+from ..core.project_config import (AdapterConfig, ConfigResolver,
+                                   ConfigValidator, TicketerConfig)
 
 console = Console()
 app = typer.Typer(help="Auto-discover configuration from .env files")
@@ -93,7 +88,7 @@ def _display_discovered_adapter(
 
 @app.command()
 def show(
-    project_path: Optional[Path] = typer.Option(
+    project_path: Path | None = typer.Option(
         None,
         "--path",
         "-p",
@@ -148,7 +143,7 @@ def show(
 
 @app.command()
 def save(
-    adapter: Optional[str] = typer.Option(
+    adapter: str | None = typer.Option(
         None, "--adapter", "-a", help="Which adapter to save (defaults to recommended)"
     ),
     global_config: bool = typer.Option(
@@ -157,7 +152,7 @@ def save(
     dry_run: bool = typer.Option(
         False, "--dry-run", help="Show what would be saved without saving"
     ),
-    project_path: Optional[Path] = typer.Option(
+    project_path: Path | None = typer.Option(
         None,
         "--path",
         "-p",
@@ -261,7 +256,7 @@ def save(
 
 @app.command()
 def interactive(
-    project_path: Optional[Path] = typer.Option(
+    project_path: Path | None = typer.Option(
         None,
         "--path",
         "-p",

mcp_ticketer/cli/gemini_configure.py

@@ -2,7 +2,7 @@
 
 import json
 from pathlib import Path
-from typing import Literal, Optional
+from typing import Literal
 
 from rich.console import Console
 
@@ -73,7 +73,7 @@ def save_gemini_config(config_path: Path, config: dict) -> None:
 
 
 def create_gemini_server_config(
-    binary_path: str, project_config: dict, cwd: Optional[str] = None
+    binary_path: str, project_config: dict, cwd: str | None = None
 ) -> dict:
     """Create Gemini MCP server configuration for mcp-ticketer.
 

mcp_ticketer/cli/linear_commands.py

@@ -1,7 +1,6 @@
 """Linear-specific CLI commands for workspace and team management."""
 
 import os
-from typing import Optional
 
 import typer
 from gql import Client, gql
@@ -80,7 +79,7 @@ def list_workspaces():
 
 @app.command("teams")
 def list_teams(
-    workspace: Optional[str] = typer.Option(
+    workspace: str | None = typer.Option(
         None, "--workspace", "-w", help="Workspace URL key (optional)"
     ),
     all_teams: bool = typer.Option(
@@ -250,11 +249,11 @@ def list_teams(
 
 @app.command("configure")
 def configure_team(
-    team_key: Optional[str] = typer.Option(
+    team_key: str | None = typer.Option(
         None, "--team-key", "-k", help="Team key (e.g., '1M')"
     ),
-    team_id: Optional[str] = typer.Option(None, "--team-id", "-i", help="Team UUID"),
-    workspace: Optional[str] = typer.Option(
+    team_id: str | None = typer.Option(None, "--team-id", "-i", help="Team UUID"),
+    workspace: str | None = typer.Option(
         None, "--workspace", "-w", help="Workspace URL key"
     ),
 ):
@@ -382,10 +381,10 @@ def configure_team(
 
 @app.command("info")
 def show_info(
-    team_key: Optional[str] = typer.Option(
+    team_key: str | None = typer.Option(
         None, "--team-key", "-k", help="Team key to show info for"
     ),
-    team_id: Optional[str] = typer.Option(
+    team_id: str | None = typer.Option(
         None, "--team-id", "-i", help="Team UUID to show info for"
     ),
 ):