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

mcp_ticketer/adapters/linear/client.py

@@ -69,7 +69,7 @@ class LinearGraphQLClient:
             return client
 
         except Exception as e:
-            raise AdapterError(f"Failed to create Linear client: {e}", "linear")
+            raise AdapterError(f"Failed to create Linear client: {e}", "linear") from e
 
     async def execute_query(
         self,
@@ -110,15 +110,19 @@ class LinearGraphQLClient:
                     status_code = e.response.status
 
                     if status_code == 401:
-                        raise AuthenticationError("Invalid Linear API key", "linear")
+                        raise AuthenticationError(
+                            "Invalid Linear API key", "linear"
+                        ) from e
                     elif status_code == 403:
-                        raise AuthenticationError("Insufficient permissions", "linear")
+                        raise AuthenticationError(
+                            "Insufficient permissions", "linear"
+                        ) from e
                     elif status_code == 429:
                         # Rate limit exceeded
                         retry_after = e.response.headers.get("Retry-After", "60")
                         raise RateLimitError(
                             "Linear API rate limit exceeded", "linear", retry_after
-                        )
+                        ) from e
                     elif status_code >= 500:
                         # Server error - retry
                         if attempt < retries:
@@ -126,13 +130,13 @@ class LinearGraphQLClient:
                             continue
                         raise AdapterError(
                             f"Linear API server error: {status_code}", "linear"
-                        )
+                        ) from e
 
                 # Network or other transport error
                 if attempt < retries:
                     await asyncio.sleep(2**attempt)
                     continue
-                raise AdapterError(f"Linear API transport error: {e}", "linear")
+                raise AdapterError(f"Linear API transport error: {e}", "linear") from e
 
             except Exception as e:
                 # GraphQL or other errors
@@ -145,15 +149,19 @@ class LinearGraphQLClient:
                 ):
                     raise AuthenticationError(
                         f"Linear authentication failed: {error_msg}", "linear"
-                    )
+                    ) from e
                 elif "rate limit" in error_msg.lower():
-                    raise RateLimitError("Linear API rate limit exceeded", "linear")
+                    raise RateLimitError(
+                        "Linear API rate limit exceeded", "linear"
+                    ) from e
 
                 # Generic error
                 if attempt < retries:
                     await asyncio.sleep(2**attempt)
                     continue
-                raise AdapterError(f"Linear GraphQL error: {error_msg}", "linear")
+                raise AdapterError(
+                    f"Linear GraphQL error: {error_msg}", "linear"
+                ) from e
 
         # Should never reach here
         raise AdapterError("Maximum retries exceeded", "linear")
@@ -266,6 +274,50 @@ class LinearGraphQLClient:
         except Exception:
             return None
 
+    async def get_users_by_name(self, name: str) -> list[dict[str, Any]]:
+        """Search users by display name or full name.
+
+        Args:
+            name: Display name or full name to search for
+
+        Returns:
+            List of matching users (may be empty)
+
+        """
+        import logging
+
+        try:
+            query = """
+                query SearchUsers($nameFilter: String!) {
+                    users(
+                        filter: {
+                            or: [
+                                { displayName: { containsIgnoreCase: $nameFilter } }
+                                { name: { containsIgnoreCase: $nameFilter } }
+                            ]
+                        }
+                        first: 10
+                    ) {
+                        nodes {
+                            id
+                            name
+                            email
+                            displayName
+                            avatarUrl
+                            active
+                        }
+                    }
+                }
+            """
+
+            result = await self.execute_query(query, {"nameFilter": name})
+            users = result.get("users", {}).get("nodes", [])
+            return [u for u in users if u.get("active", True)]  # Filter active users
+
+        except Exception as e:
+            logging.getLogger(__name__).warning(f"Failed to search users by name: {e}")
+            return []
+
     async def close(self) -> None:
         """Close the client connection.
 

mcp_ticketer/adapters/linear/mappers.py

@@ -10,7 +10,10 @@ from .types import extract_linear_metadata, get_universal_priority, get_universa
 
 
 def map_linear_issue_to_task(issue_data: dict[str, Any]) -> Task:
-    """Convert Linear issue data to universal Task model.
+    """Convert Linear issue or sub-issue data to universal Task model.
+
+    Handles both top-level issues (no parent) and sub-issues (child items
+    with a parent issue).
 
     Args:
         issue_data: Raw Linear issue data from GraphQL
@@ -203,7 +206,10 @@ def map_linear_comment_to_comment(
 
 
 def build_linear_issue_input(task: Task, team_id: str) -> dict[str, Any]:
-    """Build Linear issue input from universal Task model.
+    """Build Linear issue or sub-issue input from universal Task model.
+
+    Creates input for a top-level issue when task.parent_issue is not set,
+    or for a sub-issue when task.parent_issue is provided.
 
     Args:
         task: Universal Task model
@@ -215,7 +221,7 @@ def build_linear_issue_input(task: Task, team_id: str) -> dict[str, Any]:
     """
     from .types import get_linear_priority
 
-    issue_input = {
+    issue_input: dict[str, Any] = {
         "title": task.title,
         "teamId": team_id,
     }

mcp_ticketer/adapters/linear/queries.py

@@ -226,13 +226,15 @@ ISSUE_LIST_FRAGMENTS = (
 
 WORKFLOW_STATES_QUERY = """
     query WorkflowStates($teamId: String!) {
-        workflowStates(filter: { team: { id: { eq: $teamId } } }) {
-            nodes {
-                id
-                name
-                type
-                position
-                color
+        team(id: $teamId) {
+            states {
+                nodes {
+                    id
+                    name
+                    type
+                    position
+                    color
+                }
             }
         }
     }

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:
@@ -114,7 +115,7 @@ class MemoryCache:
         return len(self._cache)
 
     @staticmethod
-    def generate_key(*args, **kwargs) -> str:
+    def generate_key(*args: Any, **kwargs: Any) -> str:
         """Generate cache key from arguments.
 
         Args:
@@ -134,11 +135,11 @@ 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.
+    """Decorate async function to cache its results.
 
     Args:
         ttl: TTL for cached results
@@ -154,7 +155,7 @@ def cache_decorator(
 
     def decorator(func: Callable) -> Callable:
         @wraps(func)
-        async def wrapper(*args, **kwargs):
+        async def wrapper(*args: Any, **kwargs: Any) -> Any:
             # Generate cache key
             base_key = MemoryCache.generate_key(*args, **kwargs)
             cache_key = f"{key_prefix}:{func.__name__}:{base_key}"

mcp_ticketer/cli/adapter_diagnostics.py

@@ -343,7 +343,7 @@ def _provide_recommendations(console: Console) -> None:
     console.print("• For local files: [cyan]mcp-ticketer init aitrackdown[/cyan]")
 
     console.print("\n[bold]Test Configuration:[/bold]")
-    console.print("• Run diagnostics: [cyan]mcp-ticketer diagnose[/cyan]")
+    console.print("• Run diagnostics: [cyan]mcp-ticketer doctor[/cyan]")
     console.print(
         "• Test ticket creation: [cyan]mcp-ticketer create 'Test ticket'[/cyan]"
     )

mcp_ticketer/cli/auggie_configure.py

@@ -10,7 +10,8 @@ from typing import Any
 
 from rich.console import Console
 
-from .mcp_configure import find_mcp_ticketer_binary, load_project_config
+from .mcp_configure import load_project_config
+from .python_detection import get_mcp_ticketer_python
 
 console = Console()
 
@@ -71,18 +72,22 @@ def save_auggie_config(config_path: Path, config: dict[str, Any]) -> None:
 
 
 def create_auggie_server_config(
-    binary_path: str, project_config: dict[str, Any]
+    python_path: str, project_config: dict[str, Any], project_path: str | None = None
 ) -> dict[str, Any]:
     """Create Auggie MCP server configuration for mcp-ticketer.
 
     Args:
-        binary_path: Path to mcp-ticketer binary
+        python_path: Path to Python executable in mcp-ticketer venv
         project_config: Project configuration from .mcp-ticketer/config.json
+        project_path: Project directory path (optional)
 
     Returns:
         Auggie MCP server configuration dict
 
     """
+    # Use Python module invocation pattern (works regardless of where package is installed)
+    from pathlib import Path
+
     # Get adapter configuration
     adapter = project_config.get("default_adapter", "aitrackdown")
     adapters_config = project_config.get("adapters", {})
@@ -91,6 +96,10 @@ def create_auggie_server_config(
     # Build environment variables
     env_vars = {}
 
+    # Add PYTHONPATH for project context
+    if project_path:
+        env_vars["PYTHONPATH"] = project_path
+
     # Add adapter type
     env_vars["MCP_TICKETER_ADAPTER"] = adapter
 
@@ -128,16 +137,87 @@ def create_auggie_server_config(
         if "project_key" in adapter_config:
             env_vars["JIRA_PROJECT_KEY"] = adapter_config["project_key"]
 
+    # Use Python module invocation pattern
+    args = ["-m", "mcp_ticketer.mcp.server"]
+    if project_path:
+        args.append(project_path)
+
     # Create server configuration (simpler than Gemini - no timeout/trust)
     config = {
-        "command": binary_path,
-        "args": ["serve"],
+        "command": python_path,
+        "args": args,
         "env": env_vars,
     }
 
     return config
 
 
+def remove_auggie_mcp(dry_run: bool = False) -> None:
+    """Remove mcp-ticketer from Auggie CLI configuration.
+
+    IMPORTANT: Auggie CLI ONLY supports global configuration.
+    This will remove mcp-ticketer from ~/.augment/settings.json.
+
+    Args:
+        dry_run: Show what would be removed without making changes
+
+    """
+    # Step 1: Find Auggie config location
+    console.print("[cyan]🔍 Removing Auggie CLI global configuration...[/cyan]")
+    console.print(
+        "[yellow]⚠ NOTE: Auggie only supports global configuration (affects all projects)[/yellow]"
+    )
+
+    auggie_config_path = find_auggie_config()
+    console.print(f"[dim]Config location: {auggie_config_path}[/dim]")
+
+    # Step 2: Check if config file exists
+    if not auggie_config_path.exists():
+        console.print(
+            f"[yellow]⚠ No configuration found at {auggie_config_path}[/yellow]"
+        )
+        console.print("[dim]mcp-ticketer is not configured for Auggie[/dim]")
+        return
+
+    # Step 3: Load existing Auggie configuration
+    auggie_config = load_auggie_config(auggie_config_path)
+
+    # Step 4: Check if mcp-ticketer is configured
+    if "mcp-ticketer" not in auggie_config.get("mcpServers", {}):
+        console.print("[yellow]⚠ mcp-ticketer is not configured[/yellow]")
+        console.print(f"[dim]No mcp-ticketer entry found in {auggie_config_path}[/dim]")
+        return
+
+    # Step 5: Show what would be removed (dry run or actual removal)
+    if dry_run:
+        console.print("\n[cyan]DRY RUN - Would remove:[/cyan]")
+        console.print("  Server name: mcp-ticketer")
+        console.print(f"  From: {auggie_config_path}")
+        console.print("  Scope: Global (all projects)")
+        return
+
+    # Step 6: Remove mcp-ticketer from configuration
+    del auggie_config["mcpServers"]["mcp-ticketer"]
+
+    # Step 7: Save updated configuration
+    try:
+        save_auggie_config(auggie_config_path, auggie_config)
+        console.print("\n[green]✓ Successfully removed mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration updated: {auggie_config_path}[/dim]")
+
+        # Next steps
+        console.print("\n[bold cyan]Next Steps:[/bold cyan]")
+        console.print("1. Restart Auggie CLI for changes to take effect")
+        console.print("2. mcp-ticketer will no longer be available via MCP")
+        console.print(
+            "\n[yellow]⚠ Note: This removes global configuration affecting all projects[/yellow]"
+        )
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to update configuration:[/red] {e}")
+        raise
+
+
 def configure_auggie_mcp(force: bool = False) -> None:
     """Configure Auggie CLI to use mcp-ticketer.
 
@@ -148,18 +228,22 @@ def configure_auggie_mcp(force: bool = False) -> None:
         force: Overwrite existing configuration
 
     Raises:
-        FileNotFoundError: If binary or project config not found
+        FileNotFoundError: If Python executable or project config not found
         ValueError: If configuration is invalid
 
     """
-    # Step 1: Find mcp-ticketer binary
-    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/cyan]")
+    # Step 1: Find Python executable
+    console.print("[cyan]🔍 Finding mcp-ticketer Python executable...[/cyan]")
     try:
-        binary_path = find_mcp_ticketer_binary()
-        console.print(f"[green]✓[/green] Found: {binary_path}")
-    except FileNotFoundError as e:
-        console.print(f"[red]✗[/red] {e}")
-        raise
+        python_path = get_mcp_ticketer_python()
+        console.print(f"[green]✓[/green] Found: {python_path}")
+    except Exception as e:
+        console.print(f"[red]✗[/red] Could not find Python executable: {e}")
+        raise FileNotFoundError(
+            "Could not find mcp-ticketer Python executable. "
+            "Please ensure mcp-ticketer is installed.\n"
+            "Install with: pip install mcp-ticketer or pipx install mcp-ticketer"
+        ) from e
 
     # Step 2: Load project configuration
     console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
@@ -193,8 +277,11 @@ def configure_auggie_mcp(force: bool = False) -> None:
             console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
 
     # Step 6: Create mcp-ticketer server config
+    project_path = str(Path.cwd())
     server_config = create_auggie_server_config(
-        binary_path=binary_path, project_config=project_config
+        python_path=python_path,
+        project_config=project_config,
+        project_path=project_path,
     )
 
     # Step 7: Update Auggie configuration
@@ -213,8 +300,10 @@ def configure_auggie_mcp(force: bool = False) -> None:
         console.print("\n[bold]Configuration Details:[/bold]")
         console.print("  Server name: mcp-ticketer")
         console.print(f"  Adapter: {adapter}")
-        console.print(f"  Binary: {binary_path}")
+        console.print(f"  Python: {python_path}")
+        console.print("  Command: python -m mcp_ticketer.mcp.server")
         console.print("  Scope: Global (affects all projects)")
+        console.print(f"  Project path: {project_path}")
         if "env" in server_config:
             console.print(
                 f"  Environment variables: {list(server_config['env'].keys())}"