mcp-ticketer 0.1.21__py3-none-any.whl → 0.1.23__py3-none-any.whl

mcp_ticketer/cache/__init__.py

@@ -2,4 +2,4 @@
 
 from .memory import MemoryCache, cache_decorator
 
-__all__ = ["MemoryCache", "cache_decorator"]
+__all__ = ["MemoryCache", "cache_decorator"]

mcp_ticketer/cache/memory.py

@@ -5,7 +5,7 @@ import hashlib
 import json
 import time
 from functools import wraps
-from typing import Any, Optional, Callable, Dict, Tuple
+from typing import Any, Callable, Optional
 
 
 class CacheEntry:
@@ -17,6 +17,7 @@ class CacheEntry:
         Args:
             value: Cached value
             ttl: Time to live in seconds
+
         """
         self.value = value
         self.expires_at = time.time() + ttl if ttl > 0 else float("inf")
@@ -34,8 +35,9 @@ class MemoryCache:
 
         Args:
             default_ttl: Default TTL in seconds (5 minutes)
+
         """
-        self._cache: Dict[str, CacheEntry] = {}
+        self._cache: dict[str, CacheEntry] = {}
         self._default_ttl = default_ttl
         self._lock = asyncio.Lock()
 
@@ -47,6 +49,7 @@ class MemoryCache:
 
         Returns:
             Cached value or None if not found/expired
+
         """
         async with self._lock:
             entry = self._cache.get(key)
@@ -57,18 +60,14 @@ 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: Optional[float] = None) -> None:
         """Set value in cache.
 
         Args:
             key: Cache key
             value: Value to cache
             ttl: Optional TTL override
+
         """
         async with self._lock:
             ttl = ttl if ttl is not None else self._default_ttl
@@ -82,6 +81,7 @@ class MemoryCache:
 
         Returns:
             True if key was deleted
+
         """
         async with self._lock:
             if key in self._cache:
@@ -99,11 +99,11 @@ class MemoryCache:
 
         Returns:
             Number of entries removed
+
         """
         async with self._lock:
             expired_keys = [
-                key for key, entry in self._cache.items()
-                if entry.is_expired()
+                key for key, entry in self._cache.items() if entry.is_expired()
             ]
             for key in expired_keys:
                 del self._cache[key]
@@ -123,12 +123,10 @@ class MemoryCache:
 
         Returns:
             Hash-based cache key
+
         """
         # Create string representation of arguments
-        key_data = {
-            "args": args,
-            "kwargs": sorted(kwargs.items())
-        }
+        key_data = {"args": args, "kwargs": sorted(kwargs.items())}
         key_str = json.dumps(key_data, sort_keys=True, default=str)
 
         # Generate hash
@@ -138,7 +136,7 @@ class MemoryCache:
 def cache_decorator(
     ttl: Optional[float] = None,
     key_prefix: str = "",
-    cache_instance: Optional[MemoryCache] = None
+    cache_instance: Optional[MemoryCache] = None,
 ) -> Callable:
     """Decorator for caching async function results.
 
@@ -149,6 +147,7 @@ def cache_decorator(
 
     Returns:
         Decorated function
+
     """
     # Use shared cache instance or create new
     cache = cache_instance or MemoryCache()
@@ -190,4 +189,4 @@ _global_cache = MemoryCache()
 
 def get_global_cache() -> MemoryCache:
     """Get global cache instance."""
-    return _global_cache
+    return _global_cache

mcp_ticketer/cli/__init__.py

@@ -2,4 +2,4 @@
 
 from .main import app
 
-__all__ = ["app"]
+__all__ = ["app"]

mcp_ticketer/cli/configure.py

@@ -1,25 +1,22 @@
 """Interactive configuration wizard for MCP Ticketer."""
 
 import os
-import sys
-from typing import Optional, Dict, Any
-from pathlib import Path
+from typing import Optional
 
 import typer
 from rich.console import Console
-from rich.prompt import Prompt, Confirm
 from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
 from rich.table import Table
 
 from ..core.project_config import (
-    ConfigResolver,
-    TicketerConfig,
     AdapterConfig,
-    ProjectConfig,
-    HybridConfig,
     AdapterType,
+    ConfigResolver,
+    ConfigValidator,
+    HybridConfig,
     SyncStrategy,
-    ConfigValidator
+    TicketerConfig,
 )
 
 console = Console()
@@ -27,22 +24,20 @@ console = Console()
 
 def configure_wizard() -> None:
     """Run interactive configuration wizard."""
-    console.print(Panel.fit(
-        "[bold cyan]MCP-Ticketer Configuration Wizard[/bold cyan]\n"
-        "Configure your ticketing system integration",
-        border_style="cyan"
-    ))
+    console.print(
+        Panel.fit(
+            "[bold cyan]MCP-Ticketer Configuration Wizard[/bold cyan]\n"
+            "Configure your ticketing system integration",
+            border_style="cyan",
+        )
+    )
 
     # Step 1: Choose integration mode
     console.print("\n[bold]Step 1: Integration Mode[/bold]")
     console.print("1. Single Adapter (recommended for most projects)")
     console.print("2. Hybrid Mode (sync across multiple platforms)")
 
-    mode = Prompt.ask(
-        "Select mode",
-        choices=["1", "2"],
-        default="1"
-    )
+    mode = Prompt.ask("Select mode", choices=["1", "2"], default="1")
 
     if mode == "1":
         config = _configure_single_adapter()
@@ -54,18 +49,16 @@ def configure_wizard() -> None:
     console.print("1. Global (all projects): ~/.mcp-ticketer/config.json")
     console.print("2. Project-specific: .mcp-ticketer/config.json in project root")
 
-    scope = Prompt.ask(
-        "Save configuration as",
-        choices=["1", "2"],
-        default="2"
-    )
+    scope = Prompt.ask("Save configuration as", choices=["1", "2"], default="2")
 
     resolver = ConfigResolver()
 
     if scope == "1":
         # Save global
         resolver.save_global_config(config)
-        console.print(f"\n[green]✓[/green] Configuration saved globally to {resolver.GLOBAL_CONFIG_PATH}")
+        console.print(
+            f"\n[green]✓[/green] Configuration saved globally to {resolver.GLOBAL_CONFIG_PATH}"
+        )
     else:
         # Save project-specific
         resolver.save_project_config(config)
@@ -74,9 +67,11 @@ def configure_wizard() -> None:
 
     # Show usage instructions
     console.print("\n[bold]Usage:[/bold]")
-    console.print("  CLI: [cyan]mcp-ticketer create \"Task title\"[/cyan]")
+    console.print('  CLI: [cyan]mcp-ticketer create "Task title"[/cyan]')
     console.print("  MCP: Configure Claude Desktop to use this adapter")
-    console.print("\nRun [cyan]mcp-ticketer configure --show[/cyan] to view your configuration")
+    console.print(
+        "\nRun [cyan]mcp-ticketer configure --show[/cyan] to view your configuration"
+    )
 
 
 def _configure_single_adapter() -> TicketerConfig:
@@ -88,9 +83,7 @@ def _configure_single_adapter() -> TicketerConfig:
     console.print("4. Internal/AITrackdown (File-based, no API)")
 
     adapter_choice = Prompt.ask(
-        "Select system",
-        choices=["1", "2", "3", "4"],
-        default="1"
+        "Select system", choices=["1", "2", "3", "4"], default="1"
     )
 
     adapter_type_map = {
@@ -115,7 +108,7 @@ def _configure_single_adapter() -> TicketerConfig:
     # Create config
     config = TicketerConfig(
         default_adapter=adapter_type.value,
-        adapters={adapter_type.value: adapter_config}
+        adapters={adapter_type.value: adapter_config},
     )
 
     return config
@@ -128,34 +121,22 @@ def _configure_linear() -> AdapterConfig:
     # API Key
     api_key = os.getenv("LINEAR_API_KEY") or ""
     if api_key:
-        console.print(f"[dim]Found LINEAR_API_KEY in environment[/dim]")
+        console.print("[dim]Found LINEAR_API_KEY in environment[/dim]")
         use_env = Confirm.ask("Use this API key?", default=True)
         if not use_env:
             api_key = ""
 
     if not api_key:
-        api_key = Prompt.ask(
-            "Linear API Key",
-            password=True
-        )
+        api_key = Prompt.ask("Linear API Key", password=True)
 
     # Team ID
-    team_id = Prompt.ask(
-        "Team ID (optional, e.g., team-abc)",
-        default=""
-    )
+    team_id = Prompt.ask("Team ID (optional, e.g., team-abc)", default="")
 
     # Team Key
-    team_key = Prompt.ask(
-        "Team Key (optional, e.g., ENG)",
-        default=""
-    )
+    team_key = Prompt.ask("Team Key (optional, e.g., ENG)", default="")
 
     # Project ID
-    project_id = Prompt.ask(
-        "Project ID (optional)",
-        default=""
-    )
+    project_id = Prompt.ask("Project ID (optional)", default="")
 
     config_dict = {
         "adapter": AdapterType.LINEAR.value,
@@ -185,9 +166,7 @@ def _configure_jira() -> AdapterConfig:
     # Server URL
     server = os.getenv("JIRA_SERVER") or ""
     if not server:
-        server = Prompt.ask(
-            "JIRA Server URL (e.g., https://company.atlassian.net)"
-        )
+        server = Prompt.ask("JIRA Server URL (e.g., https://company.atlassian.net)")
 
     # Email
     email = os.getenv("JIRA_EMAIL") or ""
@@ -197,21 +176,17 @@ def _configure_jira() -> AdapterConfig:
     # API Token
     api_token = os.getenv("JIRA_API_TOKEN") or ""
     if not api_token:
-        console.print("[dim]Generate token at: https://id.atlassian.com/manage/api-tokens[/dim]")
-        api_token = Prompt.ask(
-            "JIRA API Token",
-            password=True
+        console.print(
+            "[dim]Generate token at: https://id.atlassian.com/manage/api-tokens[/dim]"
         )
+        api_token = Prompt.ask("JIRA API Token", password=True)
 
     # Project Key
-    project_key = Prompt.ask(
-        "Default Project Key (optional, e.g., PROJ)",
-        default=""
-    )
+    project_key = Prompt.ask("Default Project Key (optional, e.g., PROJ)", default="")
 
     config_dict = {
         "adapter": AdapterType.JIRA.value,
-        "server": server.rstrip('/'),
+        "server": server.rstrip("/"),
         "email": email,
         "api_token": api_token,
     }
@@ -235,18 +210,19 @@ def _configure_github() -> AdapterConfig:
     # Token
     token = os.getenv("GITHUB_TOKEN") or ""
     if token:
-        console.print(f"[dim]Found GITHUB_TOKEN in environment[/dim]")
+        console.print("[dim]Found GITHUB_TOKEN in environment[/dim]")
         use_env = Confirm.ask("Use this token?", default=True)
         if not use_env:
             token = ""
 
     if not token:
-        console.print("[dim]Create token at: https://github.com/settings/tokens/new[/dim]")
-        console.print("[dim]Required scopes: repo (or public_repo for public repos)[/dim]")
-        token = Prompt.ask(
-            "GitHub Personal Access Token",
-            password=True
+        console.print(
+            "[dim]Create token at: https://github.com/settings/tokens/new[/dim]"
         )
+        console.print(
+            "[dim]Required scopes: repo (or public_repo for public repos)[/dim]"
+        )
+        token = Prompt.ask("GitHub Personal Access Token", password=True)
 
     # Repository Owner
     owner = os.getenv("GITHUB_OWNER") or ""
@@ -279,10 +255,7 @@ def _configure_aitrackdown() -> AdapterConfig:
     """Configure AITrackdown adapter."""
     console.print("\n[bold]Configure AITrackdown (File-based):[/bold]")
 
-    base_path = Prompt.ask(
-        "Base path for ticket storage",
-        default=".aitrackdown"
-    )
+    base_path = Prompt.ask("Base path for ticket storage", default=".aitrackdown")
 
     config_dict = {
         "adapter": AdapterType.AITRACKDOWN.value,
@@ -305,8 +278,7 @@ def _configure_hybrid_mode() -> TicketerConfig:
     console.print("4. AITrackdown")
 
     selections = Prompt.ask(
-        "Select adapters (e.g., 1,3 for Linear and GitHub)",
-        default="1,3"
+        "Select adapters (e.g., 1,3 for Linear and GitHub)", default="1,3"
     )
 
     adapter_choices = [s.strip() for s in selections.split(",")]
@@ -318,7 +290,9 @@ def _configure_hybrid_mode() -> TicketerConfig:
         "4": AdapterType.AITRACKDOWN,
     }
 
-    selected_adapters = [adapter_type_map[c] for c in adapter_choices if c in adapter_type_map]
+    selected_adapters = [
+        adapter_type_map[c] for c in adapter_choices if c in adapter_type_map
+    ]
 
     if len(selected_adapters) < 2:
         console.print("[red]Hybrid mode requires at least 2 adapters[/red]")
@@ -345,11 +319,13 @@ def _configure_hybrid_mode() -> TicketerConfig:
     for idx, adapter_type in enumerate(selected_adapters, 1):
         console.print(f"{idx}. {adapter_type.value}")
 
-    primary_idx = int(Prompt.ask(
-        "Primary adapter",
-        choices=[str(i) for i in range(1, len(selected_adapters) + 1)],
-        default="1"
-    ))
+    primary_idx = int(
+        Prompt.ask(
+            "Primary adapter",
+            choices=[str(i) for i in range(1, len(selected_adapters) + 1)],
+            default="1",
+        )
+    )
 
     primary_adapter = selected_adapters[primary_idx - 1].value
 
@@ -359,11 +335,7 @@ def _configure_hybrid_mode() -> TicketerConfig:
     console.print("2. Bidirectional (two-way sync)")
     console.print("3. Mirror (clone tickets across all)")
 
-    strategy_choice = Prompt.ask(
-        "Sync strategy",
-        choices=["1", "2", "3"],
-        default="1"
-    )
+    strategy_choice = Prompt.ask("Sync strategy", choices=["1", "2", "3"], default="1")
 
     strategy_map = {
         "1": SyncStrategy.PRIMARY_SOURCE,
@@ -378,14 +350,12 @@ def _configure_hybrid_mode() -> TicketerConfig:
         enabled=True,
         adapters=[a.value for a in selected_adapters],
         primary_adapter=primary_adapter,
-        sync_strategy=sync_strategy
+        sync_strategy=sync_strategy,
     )
 
     # Create full config
     config = TicketerConfig(
-        default_adapter=primary_adapter,
-        adapters=adapters,
-        hybrid_mode=hybrid_config
+        default_adapter=primary_adapter, adapters=adapters, hybrid_mode=hybrid_config
     )
 
     return config
@@ -440,9 +410,15 @@ def show_current_config() -> None:
 
             if project_config.hybrid_mode and project_config.hybrid_mode.enabled:
                 console.print("\n[bold]Hybrid Mode:[/bold] Enabled")
-                console.print(f"  Adapters: {', '.join(project_config.hybrid_mode.adapters)}")
-                console.print(f"  Primary: {project_config.hybrid_mode.primary_adapter}")
-                console.print(f"  Strategy: {project_config.hybrid_mode.sync_strategy.value}")
+                console.print(
+                    f"  Adapters: {', '.join(project_config.hybrid_mode.adapters)}"
+                )
+                console.print(
+                    f"  Primary: {project_config.hybrid_mode.primary_adapter}"
+                )
+                console.print(
+                    f"  Strategy: {project_config.hybrid_mode.sync_strategy.value}"
+                )
     else:
         console.print("[yellow]No project-specific configuration found[/yellow]")
 
@@ -469,7 +445,7 @@ def set_adapter_config(
     project_id: Optional[str] = None,
     team_id: Optional[str] = None,
     global_scope: bool = False,
-    **kwargs
+    **kwargs,
 ) -> None:
     """Set specific adapter configuration values.
 
@@ -480,6 +456,7 @@ def set_adapter_config(
         team_id: Team ID (Linear)
         global_scope: Save to global config instead of project
         **kwargs: Additional adapter-specific options
+
     """
     resolver = ConfigResolver()
 
@@ -511,8 +488,7 @@ def set_adapter_config(
         # Get or create adapter config
         if target_adapter not in config.adapters:
             config.adapters[target_adapter] = AdapterConfig(
-                adapter=target_adapter,
-                **updates
+                adapter=target_adapter, **updates
             )
         else:
             # Update existing

mcp_ticketer/cli/discover.py

@@ -1,21 +1,17 @@
 """CLI command for auto-discovering configuration from .env files."""
 
-import json
 from pathlib import Path
 from typing import Optional
 
 import typer
 from rich.console import Console
-from rich.table import Table
-from rich.panel import Panel
-from rich import print as rprint
 
-from ..core.env_discovery import EnvDiscovery, DiscoveredAdapter
+from ..core.env_discovery import DiscoveredAdapter, EnvDiscovery
 from ..core.project_config import (
-    ConfigResolver,
-    TicketerConfig,
     AdapterConfig,
+    ConfigResolver,
     ConfigValidator,
+    TicketerConfig,
 )
 
 console = Console()
@@ -31,6 +27,7 @@ def _mask_sensitive(value: str, key: str) -> str:
 
     Returns:
         Masked or original value
+
     """
     sensitive_keys = ["token", "key", "password", "secret", "api_token"]
 
@@ -52,12 +49,15 @@ def _mask_sensitive(value: str, key: str) -> str:
     return value
 
 
-def _display_discovered_adapter(adapter: DiscoveredAdapter, discovery: EnvDiscovery) -> None:
+def _display_discovered_adapter(
+    adapter: DiscoveredAdapter, discovery: EnvDiscovery
+) -> None:
     """Display information about a discovered adapter.
 
     Args:
         adapter: Discovered adapter to display
         discovery: EnvDiscovery instance for validation
+
     """
     # Header
     completeness = "✅ Complete" if adapter.is_complete() else "⚠️  Incomplete"
@@ -80,7 +80,9 @@ def _display_discovered_adapter(adapter: DiscoveredAdapter, discovery: EnvDiscov
 
     # Missing fields
     if adapter.missing_fields:
-        console.print(f"  [yellow]Missing:[/yellow] {', '.join(adapter.missing_fields)}")
+        console.print(
+            f"  [yellow]Missing:[/yellow] {', '.join(adapter.missing_fields)}"
+        )
 
     # Validation warnings
     warnings = discovery.validate_discovered_config(adapter)
@@ -95,7 +97,7 @@ def show(
         None,
         "--path",
         "-p",
-        help="Project path to scan (defaults to current directory)"
+        help="Project path to scan (defaults to current directory)",
     ),
 ) -> None:
     """Show discovered configuration without saving."""
@@ -119,7 +121,9 @@ def show(
     # Show discovered adapters
     if result.adapters:
         console.print("\n[bold]Detected adapter configurations:[/bold]")
-        for adapter in sorted(result.adapters, key=lambda a: a.confidence, reverse=True):
+        for adapter in sorted(
+            result.adapters, key=lambda a: a.confidence, reverse=True
+        ):
             _display_discovered_adapter(adapter, discovery)
 
         # Show recommended adapter
@@ -131,7 +135,9 @@ def show(
             )
     else:
         console.print("\n[yellow]No adapter configurations detected[/yellow]")
-        console.print("[dim]Make sure your .env file contains adapter credentials[/dim]")
+        console.print(
+            "[dim]Make sure your .env file contains adapter credentials[/dim]"
+        )
 
     # Show warnings
     if result.warnings:
@@ -143,27 +149,19 @@ def show(
 @app.command()
 def save(
     adapter: Optional[str] = typer.Option(
-        None,
-        "--adapter",
-        "-a",
-        help="Which adapter to save (defaults to recommended)"
+        None, "--adapter", "-a", help="Which adapter to save (defaults to recommended)"
     ),
     global_config: bool = typer.Option(
-        False,
-        "--global",
-        "-g",
-        help="Save to global config instead of project config"
+        False, "--global", "-g", help="Save to global config instead of project config"
     ),
     dry_run: bool = typer.Option(
-        False,
-        "--dry-run",
-        help="Show what would be saved without saving"
+        False, "--dry-run", help="Show what would be saved without saving"
     ),
     project_path: Optional[Path] = typer.Option(
         None,
         "--path",
         "-p",
-        help="Project path to scan (defaults to current directory)"
+        help="Project path to scan (defaults to current directory)",
     ),
 ) -> None:
     """Discover configuration and save to config file.
@@ -181,7 +179,9 @@ def save(
 
     if not result.adapters:
         console.print("[red]No adapter configurations detected[/red]")
-        console.print("[dim]Make sure your .env file contains adapter credentials[/dim]")
+        console.print(
+            "[dim]Make sure your .env file contains adapter credentials[/dim]"
+        )
         raise typer.Exit(1)
 
     # Determine which adapter to save
@@ -189,7 +189,9 @@ def save(
         discovered_adapter = result.get_adapter_by_type(adapter)
         if not discovered_adapter:
             console.print(f"[red]No configuration found for adapter: {adapter}[/red]")
-            console.print(f"[dim]Available: {', '.join(a.adapter_type for a in result.adapters)}[/dim]")
+            console.print(
+                f"[dim]Available: {', '.join(a.adapter_type for a in result.adapters)}[/dim]"
+            )
             raise typer.Exit(1)
     else:
         # Use recommended adapter
@@ -207,13 +209,14 @@ def save(
 
     # Validate configuration
     is_valid, error_msg = ConfigValidator.validate(
-        discovered_adapter.adapter_type,
-        discovered_adapter.config
+        discovered_adapter.adapter_type, discovered_adapter.config
     )
 
     if not is_valid:
         console.print(f"\n[red]Configuration validation failed:[/red] {error_msg}")
-        console.print("[dim]Fix the configuration in your .env file and try again[/dim]")
+        console.print(
+            "[dim]Fix the configuration in your .env file and try again[/dim]"
+        )
         raise typer.Exit(1)
 
     if dry_run:
@@ -247,7 +250,9 @@ def save(
             config_location = proj_path / resolver.PROJECT_CONFIG_SUBPATH
 
         console.print(f"\n[green]✅ Configuration saved to:[/green] {config_location}")
-        console.print(f"[green]✅ Default adapter set to:[/green] {discovered_adapter.adapter_type}")
+        console.print(
+            f"[green]✅ Default adapter set to:[/green] {discovered_adapter.adapter_type}"
+        )
 
     except Exception as e:
         console.print(f"\n[red]Failed to save configuration:[/red] {e}")
@@ -260,7 +265,7 @@ def interactive(
         None,
         "--path",
         "-p",
-        help="Project path to scan (defaults to current directory)"
+        help="Project path to scan (defaults to current directory)",
     ),
 ) -> None:
     """Interactive mode for discovering and saving configuration."""
@@ -284,7 +289,9 @@ def interactive(
     # Show discovered adapters
     if not result.adapters:
         console.print("\n[red]No adapter configurations detected[/red]")
-        console.print("[dim]Make sure your .env file contains adapter credentials[/dim]")
+        console.print(
+            "[dim]Make sure your .env file contains adapter credentials[/dim]"
+        )
         raise typer.Exit(1)
 
     console.print("\n[bold]Detected adapter configurations:[/bold]")
@@ -344,7 +351,9 @@ def interactive(
             raise typer.Exit(1)
     else:  # choice == 4
         adapters_to_save = result.adapters
-        default_adapter = primary.adapter_type if primary else result.adapters[0].adapter_type
+        default_adapter = (
+            primary.adapter_type if primary else result.adapters[0].adapter_type
+        )
 
     # Determine save location
     save_global = choice == 2
@@ -364,8 +373,7 @@ def interactive(
     for discovered_adapter in adapters_to_save:
         # Validate
         is_valid, error_msg = ConfigValidator.validate(
-            discovered_adapter.adapter_type,
-            discovered_adapter.config
+            discovered_adapter.adapter_type, discovered_adapter.config
         )
 
         if not is_valid: