mcp-ticketer 0.1.22__py3-none-any.whl → 0.1.24__py3-none-any.whl

mcp_ticketer/adapters/linear.py

@@ -1,10 +1,11 @@
 """Linear adapter implementation using native GraphQL API with full feature support."""
 
 import asyncio
+import builtins
 import os
 from datetime import date, datetime
 from enum import Enum
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 
 from gql import Client, gql
 from gql.transport.exceptions import TransportQueryError
@@ -278,7 +279,7 @@ ISSUE_LIST_FRAGMENTS = (
 class LinearAdapter(BaseAdapter[Task]):
     """Adapter for Linear issue tracking system using native GraphQL API."""
 
-    def __init__(self, config: Dict[str, Any]):
+    def __init__(self, config: dict[str, Any]):
         """Initialize Linear adapter.
 
         Args:
@@ -315,9 +316,9 @@ class LinearAdapter(BaseAdapter[Task]):
 
         # Caches for frequently used data
         self._team_id: Optional[str] = None
-        self._workflow_states: Optional[Dict[str, Dict[str, Any]]] = None
-        self._labels: Optional[Dict[str, str]] = None  # name -> id
-        self._users: Optional[Dict[str, str]] = None  # email -> id
+        self._workflow_states: Optional[dict[str, dict[str, Any]]] = None
+        self._labels: Optional[dict[str, str]] = None  # name -> id
+        self._users: Optional[dict[str, str]] = None  # email -> id
 
         # Initialize state mapping
         self._state_mapping = self._get_state_mapping()
@@ -435,7 +436,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def _fetch_workflow_states_data(
         self, team_id: str
-    ) -> Dict[str, Dict[str, Any]]:
+    ) -> dict[str, dict[str, Any]]:
         """Fetch workflow states data."""
         query = gql(
             """
@@ -467,7 +468,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return workflow_states
 
-    async def _fetch_labels_data(self, team_id: str) -> Dict[str, str]:
+    async def _fetch_labels_data(self, team_id: str) -> dict[str, str]:
         """Fetch labels data."""
         query = gql(
             """
@@ -498,7 +499,7 @@ class LinearAdapter(BaseAdapter[Task]):
         await self._ensure_initialized()
         return self._team_id
 
-    async def _get_workflow_states(self) -> Dict[str, Dict[str, Any]]:
+    async def _get_workflow_states(self) -> dict[str, dict[str, Any]]:
         """Get cached workflow states from Linear."""
         await self._ensure_initialized()
         return self._workflow_states
@@ -619,7 +620,7 @@ class LinearAdapter(BaseAdapter[Task]):
             )
         return True, ""
 
-    def _get_state_mapping(self) -> Dict[TicketState, str]:
+    def _get_state_mapping(self) -> dict[TicketState, str]:
         """Get mapping from universal states to Linear state types.
 
         Required by BaseAdapter abstract method.
@@ -643,7 +644,7 @@ class LinearAdapter(BaseAdapter[Task]):
         return self._state_mapping.get(state, LinearStateType.BACKLOG)
 
     def _map_linear_state(
-        self, state_data: Dict[str, Any], labels: List[str]
+        self, state_data: dict[str, Any], labels: list[str]
     ) -> TicketState:
         """Map Linear state and labels to universal state."""
         state_type = state_data.get("type", "").lower()
@@ -669,7 +670,7 @@ class LinearAdapter(BaseAdapter[Task]):
         }
         return state_mapping.get(state_type, TicketState.OPEN)
 
-    def _task_from_linear_issue(self, issue: Dict[str, Any]) -> Task:
+    def _task_from_linear_issue(self, issue: dict[str, Any]) -> Task:
         """Convert Linear issue to universal Task."""
         # Extract labels
         tags = []
@@ -786,7 +787,7 @@ class LinearAdapter(BaseAdapter[Task]):
             metadata=metadata,
         )
 
-    def _epic_from_linear_project(self, project: Dict[str, Any]) -> Epic:
+    def _epic_from_linear_project(self, project: dict[str, Any]) -> Epic:
         """Convert Linear project to universal Epic."""
         # Map project state to ticket state
         project_state = project.get("state", "planned").lower()
@@ -1005,7 +1006,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return None
 
-    async def update(self, ticket_id: str, updates: Dict[str, Any]) -> Optional[Task]:
+    async def update(self, ticket_id: str, updates: dict[str, Any]) -> Optional[Task]:
         """Update a Linear issue with comprehensive field support."""
         # Validate credentials before attempting operation
         is_valid, error_message = self.validate_credentials()
@@ -1162,8 +1163,8 @@ class LinearAdapter(BaseAdapter[Task]):
         return result.get("issueArchive", {}).get("success", False)
 
     async def list(
-        self, limit: int = 10, offset: int = 0, filters: Optional[Dict[str, Any]] = None
-    ) -> List[Task]:
+        self, limit: int = 10, offset: int = 0, filters: Optional[dict[str, Any]] = None
+    ) -> list[Task]:
         """List Linear issues with comprehensive filtering."""
         team_id = await self._ensure_team_id()
 
@@ -1271,7 +1272,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return tasks
 
-    async def search(self, query: SearchQuery) -> List[Task]:
+    async def search(self, query: SearchQuery) -> builtins.list[Task]:
         """Search Linear issues with advanced filtering and text search."""
         team_id = await self._ensure_team_id()
 
@@ -1445,7 +1446,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def get_comments(
         self, ticket_id: str, limit: int = 10, offset: int = 0
-    ) -> List[Comment]:
+    ) -> builtins.list[Comment]:
         """Get comments for a Linear issue with pagination."""
         query = gql(
             USER_FRAGMENT
@@ -1546,7 +1547,9 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return result["projectCreate"]["project"]["id"]
 
-    async def get_cycles(self, active_only: bool = True) -> List[Dict[str, Any]]:
+    async def get_cycles(
+        self, active_only: bool = True
+    ) -> builtins.list[dict[str, Any]]:
         """Get Linear cycles (sprints) for the team."""
         team_id = await self._ensure_team_id()
 
@@ -1638,7 +1641,7 @@ class LinearAdapter(BaseAdapter[Task]):
         ticket_id: str,
         pr_url: str,
         pr_number: Optional[int] = None,
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
         """Link a Linear issue to a GitHub pull request.
 
         Args:
@@ -1741,8 +1744,8 @@ class LinearAdapter(BaseAdapter[Task]):
     async def create_pull_request_for_issue(
         self,
         ticket_id: str,
-        github_config: Dict[str, Any],
-    ) -> Dict[str, Any]:
+        github_config: dict[str, Any],
+    ) -> dict[str, Any]:
         """Create a GitHub PR for a Linear issue using GitHub integration.
 
         This requires GitHub integration to be configured in Linear.
@@ -1837,7 +1840,7 @@ class LinearAdapter(BaseAdapter[Task]):
         else:
             raise ValueError(f"Failed to update issue {ticket_id} with branch name")
 
-    async def _search_by_identifier(self, identifier: str) -> Optional[Dict[str, Any]]:
+    async def _search_by_identifier(self, identifier: str) -> Optional[dict[str, Any]]:
         """Search for an issue by its identifier."""
         search_query = gql(
             """
@@ -1857,7 +1860,7 @@ class LinearAdapter(BaseAdapter[Task]):
                     search_query, variable_values={"identifier": identifier}
                 )
             return result.get("issue")
-        except:
+        except Exception:
             return None
 
     # Epic/Issue/Task Hierarchy Methods (Linear: Project = Epic, Issue = Issue, Sub-issue = Task)
@@ -1950,7 +1953,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return None
 
-    async def list_epics(self, **kwargs) -> List[Epic]:
+    async def list_epics(self, **kwargs) -> builtins.list[Epic]:
         """List all Linear Projects (Epics).
 
         Args:
@@ -2037,7 +2040,7 @@ class LinearAdapter(BaseAdapter[Task]):
         # The existing create method handles project association via parent_epic field
         return await self.create(task)
 
-    async def list_issues_by_epic(self, epic_id: str) -> List[Task]:
+    async def list_issues_by_epic(self, epic_id: str) -> builtins.list[Task]:
         """List all issues in a Linear project (epic).
 
         Args:
@@ -2197,7 +2200,7 @@ class LinearAdapter(BaseAdapter[Task]):
         created_issue = result["issueCreate"]["issue"]
         return self._task_from_linear_issue(created_issue)
 
-    async def list_tasks_by_issue(self, issue_id: str) -> List[Task]:
+    async def list_tasks_by_issue(self, issue_id: str) -> builtins.list[Task]:
         """List all tasks (sub-issues) under an issue.
 
         Args:

mcp_ticketer/cache/memory.py

@@ -5,7 +5,7 @@ import hashlib
 import json
 import time
 from functools import wraps
-from typing import Any, Callable, Dict, Optional
+from typing import Any, Callable, Optional
 
 
 class CacheEntry:
@@ -37,7 +37,7 @@ class MemoryCache:
             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()
 

mcp_ticketer/cli/auggie_configure.py

@@ -0,0 +1,237 @@
+"""Auggie CLI configuration for mcp-ticketer integration.
+
+IMPORTANT: Auggie CLI ONLY supports global configuration at ~/.augment/settings.json.
+There is no project-level configuration support.
+"""
+
+import json
+from pathlib import Path
+from typing import Any
+
+from rich.console import Console
+
+from .mcp_configure import find_mcp_ticketer_binary, load_project_config
+
+console = Console()
+
+
+def find_auggie_config() -> Path:
+    """Find or create Auggie CLI configuration file.
+
+    Auggie CLI only supports global user-level configuration.
+
+    Returns:
+        Path to Auggie settings file at ~/.augment/settings.json
+
+    """
+    # Global user-level configuration (ONLY option for Auggie)
+    config_path = Path.home() / ".augment" / "settings.json"
+    return config_path
+
+
+def load_auggie_config(config_path: Path) -> dict[str, Any]:
+    """Load existing Auggie configuration or return empty structure.
+
+    Args:
+        config_path: Path to Auggie settings file
+
+    Returns:
+        Auggie configuration dict
+
+    """
+    if config_path.exists():
+        try:
+            with open(config_path) as f:
+                config: dict[str, Any] = json.load(f)
+                return config
+        except json.JSONDecodeError as e:
+            console.print(
+                f"[yellow]⚠ Warning: Could not parse existing config: {e}[/yellow]"
+            )
+            console.print("[yellow]Creating new configuration...[/yellow]")
+
+    # Return empty structure with mcpServers section
+    return {"mcpServers": {}}
+
+
+def save_auggie_config(config_path: Path, config: dict[str, Any]) -> None:
+    """Save Auggie configuration to file.
+
+    Args:
+        config_path: Path to Auggie settings file
+        config: Configuration to save
+
+    """
+    # Ensure directory exists
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write with 2-space indentation (JSON standard)
+    with open(config_path, "w") as f:
+        json.dump(config, f, indent=2)
+
+
+def create_auggie_server_config(
+    binary_path: str, project_config: dict[str, Any]
+) -> dict[str, Any]:
+    """Create Auggie MCP server configuration for mcp-ticketer.
+
+    Args:
+        binary_path: Path to mcp-ticketer binary
+        project_config: Project configuration from .mcp-ticketer/config.json
+
+    Returns:
+        Auggie MCP server configuration dict
+
+    """
+    # Get adapter configuration
+    adapter = project_config.get("default_adapter", "aitrackdown")
+    adapters_config = project_config.get("adapters", {})
+    adapter_config = adapters_config.get(adapter, {})
+
+    # Build environment variables
+    env_vars = {}
+
+    # Add adapter type
+    env_vars["MCP_TICKETER_ADAPTER"] = adapter
+
+    # Add adapter-specific environment variables
+    if adapter == "aitrackdown":
+        # Set base path for local adapter
+        base_path = adapter_config.get("base_path", ".aitrackdown")
+        # Use absolute path to home directory for global config
+        # Since Auggie is global, we can't rely on project-specific paths
+        env_vars["MCP_TICKETER_BASE_PATH"] = str(
+            Path.home() / ".mcp-ticketer" / base_path
+        )
+
+    elif adapter == "linear":
+        if "api_key" in adapter_config:
+            env_vars["LINEAR_API_KEY"] = adapter_config["api_key"]
+        if "team_id" in adapter_config:
+            env_vars["LINEAR_TEAM_ID"] = adapter_config["team_id"]
+
+    elif adapter == "github":
+        if "token" in adapter_config:
+            env_vars["GITHUB_TOKEN"] = adapter_config["token"]
+        if "owner" in adapter_config:
+            env_vars["GITHUB_OWNER"] = adapter_config["owner"]
+        if "repo" in adapter_config:
+            env_vars["GITHUB_REPO"] = adapter_config["repo"]
+
+    elif adapter == "jira":
+        if "api_token" in adapter_config:
+            env_vars["JIRA_API_TOKEN"] = adapter_config["api_token"]
+        if "email" in adapter_config:
+            env_vars["JIRA_EMAIL"] = adapter_config["email"]
+        if "server" in adapter_config:
+            env_vars["JIRA_SERVER"] = adapter_config["server"]
+        if "project_key" in adapter_config:
+            env_vars["JIRA_PROJECT_KEY"] = adapter_config["project_key"]
+
+    # Create server configuration (simpler than Gemini - no timeout/trust)
+    config = {
+        "command": binary_path,
+        "args": ["serve"],
+        "env": env_vars,
+    }
+
+    return config
+
+
+def configure_auggie_mcp(force: bool = False) -> None:
+    """Configure Auggie CLI to use mcp-ticketer.
+
+    IMPORTANT: Auggie CLI ONLY supports global configuration.
+    This will configure ~/.augment/settings.json for all projects.
+
+    Args:
+        force: Overwrite existing configuration
+
+    Raises:
+        FileNotFoundError: If binary or project config not found
+        ValueError: If configuration is invalid
+
+    """
+    # Step 1: Find mcp-ticketer binary
+    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/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
+
+    # Step 2: Load project configuration
+    console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
+    try:
+        project_config = load_project_config()
+        adapter = project_config.get("default_adapter", "aitrackdown")
+        console.print(f"[green]✓[/green] Adapter: {adapter}")
+    except (FileNotFoundError, ValueError) as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 3: Find Auggie config location
+    console.print("\n[cyan]🔧 Configuring global Auggie CLI...[/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 4: Load existing Auggie configuration
+    auggie_config = load_auggie_config(auggie_config_path)
+
+    # Step 5: Check if mcp-ticketer already configured
+    if "mcp-ticketer" in auggie_config.get("mcpServers", {}):
+        if not force:
+            console.print("[yellow]⚠ mcp-ticketer is already configured[/yellow]")
+            console.print("[dim]Use --force to overwrite existing configuration[/dim]")
+            return
+        else:
+            console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
+
+    # Step 6: Create mcp-ticketer server config
+    server_config = create_auggie_server_config(
+        binary_path=binary_path, project_config=project_config
+    )
+
+    # Step 7: Update Auggie configuration
+    if "mcpServers" not in auggie_config:
+        auggie_config["mcpServers"] = {}
+
+    auggie_config["mcpServers"]["mcp-ticketer"] = server_config
+
+    # Step 8: Save configuration
+    try:
+        save_auggie_config(auggie_config_path, auggie_config)
+        console.print("\n[green]✓ Successfully configured mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration saved to: {auggie_config_path}[/dim]")
+
+        # Print configuration details
+        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("  Scope: Global (affects all projects)")
+        if "env" in server_config:
+            console.print(
+                f"  Environment variables: {list(server_config['env'].keys())}"
+            )
+
+        # 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. Run 'auggie' command in any directory")
+        console.print("3. mcp-ticketer tools will be available via MCP")
+        console.print(
+            "\n[yellow]⚠ Warning: This is a global configuration affecting all projects[/yellow]"
+        )
+        console.print(
+            "[dim]If you need project-specific configuration, use Claude or Gemini instead[/dim]"
+        )
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to save configuration:[/red] {e}")
+        raise