mcp-ticketer 0.3.2__py3-none-any.whl → 0.3.3__py3-none-any.whl

mcp_ticketer/adapters/linear/types.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from enum import Enum
-from typing import Any, Dict
+from typing import Any
 
 from mcp_ticketer.core.models import Priority, TicketState
 
@@ -12,14 +12,14 @@ class LinearPriorityMapping:
     """Mapping between universal Priority and Linear priority values."""
 
     # Linear uses numeric priorities: 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low
-    TO_LINEAR: Dict[Priority, int] = {
+    TO_LINEAR: dict[Priority, int] = {
         Priority.CRITICAL: 1,  # Urgent
         Priority.HIGH: 2,  # High
         Priority.MEDIUM: 3,  # Medium
         Priority.LOW: 4,  # Low
     }
 
-    FROM_LINEAR: Dict[int, Priority] = {
+    FROM_LINEAR: dict[int, Priority] = {
         0: Priority.LOW,  # No priority -> Low
         1: Priority.CRITICAL,  # Urgent -> Critical
         2: Priority.HIGH,  # High -> High
@@ -32,7 +32,7 @@ class LinearStateMapping:
     """Mapping between universal TicketState and Linear workflow state types."""
 
     # Linear workflow state types
-    TO_LINEAR: Dict[TicketState, str] = {
+    TO_LINEAR: dict[TicketState, str] = {
         TicketState.OPEN: "unstarted",
         TicketState.IN_PROGRESS: "started",
         TicketState.READY: "unstarted",  # No direct equivalent, use unstarted
@@ -43,7 +43,7 @@ class LinearStateMapping:
         TicketState.BLOCKED: "unstarted",
     }
 
-    FROM_LINEAR: Dict[str, TicketState] = {
+    FROM_LINEAR: dict[str, TicketState] = {
         "backlog": TicketState.OPEN,
         "unstarted": TicketState.OPEN,
         "started": TicketState.IN_PROGRESS,
@@ -152,7 +152,7 @@ def build_issue_filter(
     updated_after: str | None = None,
     due_before: str | None = None,
     include_archived: bool = False,
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """Build a Linear issue filter from parameters.
 
     Args:
@@ -171,7 +171,7 @@ def build_issue_filter(
         Linear GraphQL filter object
 
     """
-    issue_filter: Dict[str, Any] = {}
+    issue_filter: dict[str, Any] = {}
 
     # Team filter (required for most operations)
     if team_id:
@@ -218,7 +218,7 @@ def build_project_filter(
     state: str | None = None,
     team_id: str | None = None,
     include_completed: bool = True,
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """Build a Linear project filter from parameters.
 
     Args:
@@ -230,7 +230,7 @@ def build_project_filter(
         Linear GraphQL filter object
 
     """
-    project_filter: Dict[str, Any] = {}
+    project_filter: dict[str, Any] = {}
 
     # Team filter
     if team_id:
@@ -246,7 +246,7 @@ def build_project_filter(
     return project_filter
 
 
-def extract_linear_metadata(issue_data: Dict[str, Any]) -> Dict[str, Any]:
+def extract_linear_metadata(issue_data: dict[str, Any]) -> dict[str, Any]:
     """Extract Linear-specific metadata from issue data.
 
     Args:

mcp_ticketer/cli/adapter_diagnostics.py

@@ -1,7 +1,7 @@
 """Adapter diagnostics and configuration validation."""
 
 from pathlib import Path
-from typing import Any, Dict
+from typing import Any
 
 from rich.console import Console
 from rich.table import Table
@@ -350,7 +350,7 @@ def _provide_recommendations(console: Console) -> None:
     console.print("• List tickets: [cyan]mcp-ticketer list[/cyan]")
 
 
-def get_adapter_status() -> Dict[str, Any]:
+def get_adapter_status() -> dict[str, Any]:
     """Get current adapter status for programmatic use.
 
     Returns:

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, Dict, Optional
+from typing import Any, Optional
 
 if sys.version_info >= (3, 11):
     import tomllib
@@ -36,7 +36,7 @@ def find_codex_config() -> Path:
     return config_path
 
 
-def load_codex_config(config_path: Path) -> Dict[str, Any]:
+def load_codex_config(config_path: Path) -> dict[str, Any]:
     """Load existing Codex configuration or return empty structure.
 
     Args:
@@ -61,7 +61,7 @@ def load_codex_config(config_path: Path) -> Dict[str, Any]:
     return {"mcp_servers": {}}
 
 
-def save_codex_config(config_path: Path, config: Dict[str, Any]) -> None:
+def save_codex_config(config_path: Path, config: dict[str, Any]) -> None:
     """Save Codex configuration to TOML file.
 
     Args:
@@ -79,7 +79,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
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """Create Codex MCP server configuration for mcp-ticketer.
 
     Args:
@@ -97,7 +97,7 @@ def create_codex_server_config(
     adapter_config = adapters_config.get(adapter, {})
 
     # Build environment variables
-    env_vars: Dict[str, str] = {}
+    env_vars: dict[str, str] = {}
 
     # Add PYTHONPATH if running from development environment
     if cwd:
@@ -142,7 +142,7 @@ def create_codex_server_config(
 
     # Create server configuration with Codex-specific structure
     # NOTE: Codex uses nested dict structure for env vars
-    config: Dict[str, Any] = {
+    config: dict[str, Any] = {
         "command": binary_path,
         "args": ["serve"],
         "env": env_vars,

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, Dict, List, Optional
+from typing import Any, Optional
 
 import typer
 from rich.console import Console
@@ -108,7 +108,7 @@ class SystemDiagnostics:
             self.queue_available = False
             console.print(f"⚠️  Could not initialize worker manager: {e}")
 
-    async def run_full_diagnosis(self) -> Dict[str, Any]:
+    async def run_full_diagnosis(self) -> dict[str, Any]:
         """Run complete system diagnosis and return detailed report."""
         console.print("\n🔍 [bold blue]MCP Ticketer System Diagnosis[/bold blue]")
         console.print("=" * 60)
@@ -137,7 +137,7 @@ class SystemDiagnostics:
         except ImportError:
             return "unknown"
 
-    def _get_system_info(self) -> Dict[str, Any]:
+    def _get_system_info(self) -> dict[str, Any]:
         """Gather system information."""
         return {
             "python_version": sys.version,
@@ -150,7 +150,7 @@ class SystemDiagnostics:
             ),
         }
 
-    async def _diagnose_configuration(self) -> Dict[str, Any]:
+    async def _diagnose_configuration(self) -> dict[str, Any]:
         """Diagnose configuration issues."""
         console.print("\n📋 [yellow]Configuration Analysis[/yellow]")
 
@@ -220,7 +220,7 @@ class SystemDiagnostics:
                 console.print(f"✅ {len(adapters_config)} adapter(s) configured")
 
             # Check each adapter configuration
-            for name, adapter_config in adapters_config.items():
+            for name, _adapter_config in adapters_config.items():
                 try:
                     # Use the same adapter creation approach as working commands
                     adapter = CommonPatterns.get_adapter(override_adapter=name)
@@ -256,7 +256,7 @@ class SystemDiagnostics:
 
         return config_status
 
-    async def _diagnose_adapters(self) -> Dict[str, Any]:
+    async def _diagnose_adapters(self) -> dict[str, Any]:
         """Diagnose adapter functionality."""
         console.print("\n🔌 [yellow]Adapter Diagnosis[/yellow]")
 
@@ -277,7 +277,6 @@ class SystemDiagnostics:
 
             for name, adapter_config in adapters_config.items():
                 adapter_type = adapter_config.get("type", name)
-                config_dict = adapter_config
 
                 details = {
                     "type": adapter_type,
@@ -327,7 +326,7 @@ class SystemDiagnostics:
 
         return adapter_status
 
-    async def _diagnose_queue_system(self) -> Dict[str, Any]:
+    async def _diagnose_queue_system(self) -> dict[str, Any]:
         """Diagnose queue system health with active testing."""
         console.print("\n⚡ [yellow]Queue System Diagnosis[/yellow]")
 
@@ -454,7 +453,7 @@ class SystemDiagnostics:
 
         return queue_status
 
-    async def _test_worker_startup(self) -> Dict[str, Any]:
+    async def _test_worker_startup(self) -> dict[str, Any]:
         """Test starting a queue worker."""
         test_result = {
             "attempted": True,
@@ -496,7 +495,7 @@ class SystemDiagnostics:
 
         return test_result
 
-    async def _test_queue_operations(self) -> Dict[str, Any]:
+    async def _test_queue_operations(self) -> dict[str, Any]:
         """Test basic queue operations."""
         test_result = {
             "attempted": True,
@@ -531,7 +530,7 @@ class SystemDiagnostics:
 
         return test_result
 
-    async def _test_basic_queue_functionality(self) -> Dict[str, Any]:
+    async def _test_basic_queue_functionality(self) -> dict[str, Any]:
         """Test basic queue functionality in fallback mode."""
         test_result = {
             "attempted": True,
@@ -572,7 +571,7 @@ class SystemDiagnostics:
 
         return test_result
 
-    async def _analyze_recent_logs(self) -> Dict[str, Any]:
+    async def _analyze_recent_logs(self) -> dict[str, Any]:
         """Analyze recent log entries for issues."""
         console.print("\n📝 [yellow]Recent Log Analysis[/yellow]")
 
@@ -611,7 +610,7 @@ class SystemDiagnostics:
         return log_analysis
 
     async def _analyze_log_directory(
-        self, log_path: Path, log_analysis: Dict[str, Any]
+        self, log_path: Path, log_analysis: dict[str, Any]
     ):
         """Analyze logs in a specific directory."""
         try:
@@ -624,7 +623,7 @@ class SystemDiagnostics:
         except Exception as e:
             self.warnings.append(f"Could not analyze logs in {log_path}: {str(e)}")
 
-    async def _parse_log_file(self, log_file: Path, log_analysis: Dict[str, Any]):
+    async def _parse_log_file(self, log_file: Path, log_analysis: dict[str, Any]):
         """Parse individual log file for issues."""
         try:
             with open(log_file) as f:
@@ -639,7 +638,7 @@ class SystemDiagnostics:
         except Exception as e:
             self.warnings.append(f"Could not parse {log_file}: {str(e)}")
 
-    async def _analyze_performance(self) -> Dict[str, Any]:
+    async def _analyze_performance(self) -> dict[str, Any]:
         """Analyze system performance metrics."""
         console.print("\n⚡ [yellow]Performance Analysis[/yellow]")
 
@@ -651,7 +650,7 @@ class SystemDiagnostics:
 
         try:
             # Test basic operations performance
-            start_time = datetime.now()
+            datetime.now()
 
             # Test configuration loading
             config_start = datetime.now()
@@ -671,7 +670,7 @@ class SystemDiagnostics:
 
         return performance
 
-    def _generate_recommendations(self) -> List[str]:
+    def _generate_recommendations(self) -> list[str]:
         """Generate actionable recommendations based on diagnosis."""
         recommendations = []
 
@@ -706,7 +705,7 @@ class SystemDiagnostics:
 
         return recommendations
 
-    def _display_diagnosis_summary(self, report: Dict[str, Any]):
+    def _display_diagnosis_summary(self, report: dict[str, Any]):
         """Display a comprehensive diagnosis summary."""
         console.print("\n" + "=" * 60)
         console.print("📋 [bold green]DIAGNOSIS SUMMARY[/bold green]")

mcp_ticketer/cli/simple_health.py

@@ -3,7 +3,7 @@
 import os
 import sys
 from pathlib import Path
-from typing import Any, Dict
+from typing import Any
 
 from rich.console import Console
 
@@ -149,7 +149,7 @@ def simple_health_check() -> int:
         return 1
 
 
-def simple_diagnose() -> Dict[str, Any]:
+def simple_diagnose() -> dict[str, Any]:
     """Simple diagnosis that works without full config system."""
     console.print("\n🔍 [bold blue]MCP Ticketer Simple Diagnosis[/bold blue]")
     console.print("=" * 60)
@@ -168,14 +168,9 @@ def simple_diagnose() -> Dict[str, Any]:
     console.print("\n📋 [yellow]Basic System Check[/yellow]")
 
     # Python version
-    if sys.version_info < (3, 9):
-        issue = f"Python {sys.version_info.major}.{sys.version_info.minor} is too old (requires 3.9+)"
-        report["issues"].append(issue)
-        console.print(f"❌ {issue}")
-    else:
-        console.print(
-            f"✅ Python {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
-        )
+    console.print(
+        f"✅ Python {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
+    )
 
     # Installation check
     try:

mcp_ticketer/core/env_loader.py

@@ -12,7 +12,7 @@ import logging
 import os
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any, Optional
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +22,7 @@ class EnvKeyConfig:
     """Configuration for environment variable key aliases."""
 
     primary_key: str
-    aliases: List[str]
+    aliases: list[str]
     description: str
     required: bool = False
     default: Optional[str] = None
@@ -113,7 +113,7 @@ class UnifiedEnvLoader:
 
         """
         self.project_root = project_root or self._find_project_root()
-        self._env_cache: Dict[str, str] = {}
+        self._env_cache: dict[str, str] = {}
         self._load_env_files()
 
     def _find_project_root(self) -> Path:
@@ -148,7 +148,7 @@ class UnifiedEnvLoader:
         """Load variables from a single .env file."""
         try:
             with open(env_file) as f:
-                for line_num, line in enumerate(f, 1):
+                for _line_num, line in enumerate(f, 1):
                     line = line.strip()
 
                     # Skip empty lines and comments
@@ -177,7 +177,7 @@ class UnifiedEnvLoader:
             logger.warning(f"Failed to load {env_file}: {e}")
 
     def get_value(
-        self, config_key: str, config: Optional[Dict[str, Any]] = None
+        self, config_key: str, config: Optional[dict[str, Any]] = None
     ) -> Optional[str]:
         """Get a configuration value using the key alias system.
 
@@ -230,8 +230,8 @@ class UnifiedEnvLoader:
         return None
 
     def get_adapter_config(
-        self, adapter_name: str, base_config: Optional[Dict[str, Any]] = None
-    ) -> Dict[str, Any]:
+        self, adapter_name: str, base_config: Optional[dict[str, Any]] = None
+    ) -> dict[str, Any]:
         """Get complete configuration for an adapter with environment variable resolution.
 
         Args:
@@ -264,8 +264,8 @@ class UnifiedEnvLoader:
         return config
 
     def validate_adapter_config(
-        self, adapter_name: str, config: Dict[str, Any]
-    ) -> List[str]:
+        self, adapter_name: str, config: dict[str, Any]
+    ) -> list[str]:
         """Validate that all required configuration is present for an adapter.
 
         Args:
@@ -292,7 +292,7 @@ class UnifiedEnvLoader:
 
         return missing_keys
 
-    def get_debug_info(self) -> Dict[str, Any]:
+    def get_debug_info(self) -> dict[str, Any]:
         """Get debug information about environment loading."""
         return {
             "project_root": str(self.project_root),
@@ -319,8 +319,8 @@ def get_env_loader() -> UnifiedEnvLoader:
 
 
 def load_adapter_config(
-    adapter_name: str, base_config: Optional[Dict[str, Any]] = None
-) -> Dict[str, Any]:
+    adapter_name: str, base_config: Optional[dict[str, Any]] = None
+) -> dict[str, Any]:
     """Convenience function to load adapter configuration with environment variables.
 
     Args:
@@ -334,7 +334,7 @@ def load_adapter_config(
     return get_env_loader().get_adapter_config(adapter_name, base_config)
 
 
-def validate_adapter_config(adapter_name: str, config: Dict[str, Any]) -> List[str]:
+def validate_adapter_config(adapter_name: str, config: dict[str, Any]) -> list[str]:
     """Convenience function to validate adapter configuration.
 
     Args:

mcp_ticketer/core/exceptions.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from .models import TicketState
 
@@ -20,7 +20,7 @@ class AdapterError(MCPTicketerError):
         self,
         message: str,
         adapter_name: str,
-        original_error: Optional[Exception] = None,
+        original_error: Exception | None = None,
     ):
         """Initialize adapter error.
 
@@ -55,8 +55,8 @@ class RateLimitError(AdapterError):
         self,
         message: str,
         adapter_name: str,
-        retry_after: Optional[int] = None,
-        original_error: Optional[Exception] = None,
+        retry_after: int | None = None,
+        original_error: Exception | None = None,
     ):
         """Initialize rate limit error.
 
@@ -74,7 +74,7 @@ class RateLimitError(AdapterError):
 class ValidationError(MCPTicketerError):
     """Data validation error."""
 
-    def __init__(self, message: str, field: Optional[str] = None, value: Any = None):
+    def __init__(self, message: str, field: str | None = None, value: Any = None):
         """Initialize validation error.
 
         Args:

mcp_ticketer/mcp/constants.py

@@ -0,0 +1,58 @@
+"""MCP server constants and configuration."""
+
+# JSON-RPC Protocol
+JSONRPC_VERSION = "2.0"
+MCP_PROTOCOL_VERSION = "2024-11-05"
+
+# Server Info
+SERVER_NAME = "mcp-ticketer"
+SERVER_VERSION = "0.3.2"
+
+# Status Values
+STATUS_COMPLETED = "completed"
+STATUS_ERROR = "error"
+STATUS_NOT_IMPLEMENTED = "not_implemented"
+
+# Error Codes
+ERROR_PARSE = -32700
+ERROR_INVALID_REQUEST = -32600
+ERROR_METHOD_NOT_FOUND = -32601
+ERROR_INVALID_PARAMS = -32602
+ERROR_INTERNAL = -32603
+
+# Default Values
+DEFAULT_LIMIT = 10
+DEFAULT_OFFSET = 0
+DEFAULT_PRIORITY = "medium"
+DEFAULT_MAX_DEPTH = 3
+DEFAULT_BASE_PATH = ".aitrackdown"
+
+# Response Messages
+MSG_TICKET_NOT_FOUND = "Ticket {ticket_id} not found"
+MSG_UPDATE_FAILED = "Ticket {ticket_id} not found or update failed"
+MSG_TRANSITION_FAILED = "Ticket {ticket_id} not found or transition failed"
+MSG_EPIC_NOT_FOUND = "Epic {epic_id} not found"
+MSG_MISSING_PARENT_ID = "Tasks must have a parent_id (issue identifier)"
+MSG_UNKNOWN_OPERATION = "Unknown comment operation: {operation}"
+MSG_UNKNOWN_METHOD = "Method not found: {method}"
+MSG_INTERNAL_ERROR = "Internal error: {error}"
+MSG_NO_TICKETS_PROVIDED = "No tickets provided for bulk creation"
+MSG_NO_UPDATES_PROVIDED = "No updates provided for bulk operation"
+MSG_MISSING_TITLE = "Ticket {index} missing required 'title' field"
+MSG_MISSING_TICKET_ID = "Update {index} missing required 'ticket_id' field"
+MSG_TICKET_ID_REQUIRED = "ticket_id is required"
+MSG_PR_URL_REQUIRED = "pr_url is required"
+MSG_ATTACHMENT_NOT_IMPLEMENTED = "Attachment functionality not yet implemented"
+MSG_PR_NOT_SUPPORTED = "PR creation not supported for adapter: {adapter}"
+MSG_PR_LINK_NOT_SUPPORTED = "PR linking not supported for adapter: {adapter}"
+MSG_UNKNOWN_TOOL = "Unknown tool: {tool}"
+MSG_GITHUB_CONFIG_REQUIRED = "GitHub owner and repo are required for Linear PR creation"
+
+# Attachment Alternative Messages
+ATTACHMENT_ALTERNATIVES = [
+    "Add file URLs in comments",
+    "Use external file storage",
+]
+ATTACHMENT_NOT_IMPLEMENTED_REASON = (
+    "File attachments require adapter-specific implementation"
+)