mcp-ticketer 0.3.6__py3-none-any.whl → 0.4.0__py3-none-any.whl

mcp_ticketer/__init__.py

@@ -1,8 +1,17 @@
 """MCP Ticketer - Universal ticket management interface."""
 
-from .__version__ import (__author__, __author_email__, __copyright__,
-                          __description__, __license__, __title__, __version__,
-                          __version_info__, get_user_agent, get_version)
+from .__version__ import (
+                          __author__,
+                          __author_email__,
+                          __copyright__,
+                          __description__,
+                          __license__,
+                          __title__,
+                          __version__,
+                          __version_info__,
+                          get_user_agent,
+                          get_version,
+)
 
 __all__ = [
     "__version__",

mcp_ticketer/__version__.py

@@ -1,6 +1,6 @@
 """Version information for mcp-ticketer package."""
 
-__version__ = "0.3.6"
+__version__ = "0.4.0"
 __version_info__ = tuple(int(part) for part in __version__.split("."))
 
 # Package metadata

mcp_ticketer/adapters/aitrackdown.py

@@ -7,8 +7,7 @@ from pathlib import Path
 from typing import Any, Optional, Union
 
 from ..core.adapter import BaseAdapter
-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
 
 # Import ai-trackdown-pytools when available

mcp_ticketer/adapters/github.py

@@ -9,8 +9,7 @@ import httpx
 
 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
 
 

mcp_ticketer/adapters/jira.py

@@ -13,8 +13,7 @@ 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__)

mcp_ticketer/adapters/linear/adapter.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import asyncio
+import logging
 import os
 from typing import Any
 
@@ -18,15 +20,27 @@ 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]):
@@ -206,12 +220,14 @@ class LinearAdapter(BaseAdapter[Task]):
             raise ValueError(f"Failed to load workflow states: {e}")
 
     async def _load_team_labels(self, team_id: str) -> None:
-        """Load and cache labels for the team.
+        """Load and cache labels for the team with retry logic.
 
         Args:
             team_id: Linear team ID
 
         """
+        logger = logging.getLogger(__name__)
+
         query = """
             query GetTeamLabels($teamId: String!) {
                 team(id: $teamId) {
@@ -227,15 +243,32 @@ class LinearAdapter(BaseAdapter[Task]):
             }
         """
 
-        try:
-            result = await self.client.execute_query(query, {"teamId": team_id})
-            self._labels_cache = result["team"]["labels"]["nodes"]
-        except Exception:
-            # Log error but don't fail - labels are optional
-            self._labels_cache = []
+        max_retries = 3
+        for attempt in range(max_retries):
+            try:
+                result = await self.client.execute_query(query, {"teamId": team_id})
+                labels = result.get("team", {}).get("labels", {}).get("nodes", [])
+                self._labels_cache = labels
+                logger.info(f"Loaded {len(labels)} labels for team {team_id}")
+                return  # Success
+
+            except Exception as e:
+                if attempt < max_retries - 1:
+                    wait_time = 2**attempt
+                    logger.warning(
+                        f"Failed to load labels (attempt {attempt + 1}/{max_retries}): {e}. "
+                        f"Retrying in {wait_time}s..."
+                    )
+                    await asyncio.sleep(wait_time)
+                else:
+                    logger.error(
+                        f"Failed to load team labels after {max_retries} attempts: {e}",
+                        exc_info=True,
+                    )
+                    self._labels_cache = []  # Explicitly empty on failure
 
     async def _resolve_label_ids(self, label_names: list[str]) -> list[str]:
-        """Resolve label names to Linear label IDs.
+        """Resolve label names to Linear label IDs with proper None vs empty list handling.
 
         Args:
             label_names: List of label names
@@ -244,16 +277,25 @@ class LinearAdapter(BaseAdapter[Task]):
             List of Linear label IDs that exist
 
         """
-        import logging
-
         logger = logging.getLogger(__name__)
 
-        if not self._labels_cache:
+        # None = not loaded yet, [] = loaded but empty or failed
+        if self._labels_cache is None:
             team_id = await self._ensure_team_id()
             await self._load_team_labels(team_id)
 
+        if self._labels_cache is None:
+            # Still None after load attempt - should not happen
+            logger.error(
+                "Label cache is None after load attempt. Tags will be skipped."
+            )
+            return []
+
         if not self._labels_cache:
-            logger.warning("No labels found in team cache")
+            # Empty list - either no labels in team or load failed
+            logger.warning(
+                f"Team has no labels available. Cannot resolve tags: {label_names}"
+            )
             return []
 
         # Create name -> ID mapping (case-insensitive)
@@ -823,7 +865,7 @@ class LinearAdapter(BaseAdapter[Task]):
 
             comment_input = {
                 "issueId": linear_id,
-                "body": comment.body,
+                "body": comment.content,
             }
 
             result = await self.client.execute_mutation(

mcp_ticketer/adapters/linear/client.py

@@ -16,8 +16,7 @@ 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,8 +6,7 @@ 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/cli/adapter_diagnostics.py

@@ -197,8 +197,7 @@ 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:
@@ -385,8 +384,7 @@ 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/configure.py

@@ -9,9 +9,15 @@ 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()
 

mcp_ticketer/cli/discover.py

@@ -7,8 +7,12 @@ 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")

mcp_ticketer/cli/main.py

@@ -21,13 +21,13 @@ from ..core.models import Comment, SearchQuery
 from ..queue import Queue, QueueStatus, WorkerManager
 from ..queue.health_monitor import HealthStatus, QueueHealthMonitor
 from ..queue.ticket_registry import TicketRegistry
-from .configure import (configure_wizard, set_adapter_config,
-                        show_current_config)
+from .configure import configure_wizard, set_adapter_config, show_current_config
 from .diagnostics import run_diagnostics
 from .discover import app as discover_app
-from .linear_commands import app as linear_app
 from .migrate_config import migrate_config_command
+from .platform_commands import app as platform_app
 from .queue_commands import app as queue_app
+from .ticket_commands import app as ticket_app
 
 # Load environment variables from .env files
 # Priority: .env.local (highest) > .env (base)
@@ -1143,9 +1143,14 @@ def migrate_config(
     migrate_config_command(dry_run=dry_run)
 
 
-@app.command("status")
-def status_command():
-    """Show queue and worker status."""
+@app.command("queue-status", deprecated=True, hidden=True)
+def old_queue_status_command():
+    """Show queue and worker status.
+
+    DEPRECATED: Use 'mcp-ticketer queue status' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer queue status' instead.[/yellow]\n")
+
     queue = Queue()
     manager = WorkerManager()
 
@@ -1170,12 +1175,12 @@ def status_command():
         console.print("\n[red]○ Worker is not running[/red]")
         if pending > 0:
             console.print(
-                "[yellow]Note: There are pending items. Start worker with 'mcp-ticketer worker start'[/yellow]"
+                "[yellow]Note: There are pending items. Start worker with 'mcp-ticketer queue worker start'[/yellow]"
             )
 
 
-@app.command()
-def health(
+@app.command("queue-health", deprecated=True, hidden=True)
+def old_queue_health_command(
     auto_repair: bool = typer.Option(
         False, "--auto-repair", help="Attempt automatic repair of issues"
     ),
@@ -1183,7 +1188,11 @@ def health(
         False, "--verbose", "-v", help="Show detailed health information"
     ),
 ) -> None:
-    """Check queue system health and detect issues immediately."""
+    """Check queue system health and detect issues immediately.
+
+    DEPRECATED: Use 'mcp-ticketer queue health' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer queue health' instead.[/yellow]\n")
     health_monitor = QueueHealthMonitor()
     health = health_monitor.check_health()
 
@@ -1252,7 +1261,7 @@ def health(
         raise typer.Exit(2)
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def create(
     title: str = typer.Argument(..., help="Ticket title"),
     description: Optional[str] = typer.Option(
@@ -1281,7 +1290,12 @@ def create(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Create a new ticket with comprehensive health checks."""
+    """Create a new ticket with comprehensive health checks.
+
+    DEPRECATED: Use 'mcp-ticketer ticket create' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket create' instead.[/yellow]\n")
+
     # IMMEDIATE HEALTH CHECK - Critical for reliability
     health_monitor = QueueHealthMonitor()
     health = health_monitor.check_health()
@@ -1477,7 +1491,7 @@ def create(
             )
 
 
-@app.command("list")
+@app.command("list", deprecated=True, hidden=True)
 def list_tickets(
     state: Optional[TicketState] = typer.Option(
         None, "--state", "-s", help="Filter by state"
@@ -1490,7 +1504,11 @@ def list_tickets(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """List tickets with optional filters."""
+    """List tickets with optional filters.
+
+    DEPRECATED: Use 'mcp-ticketer ticket list' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket list' instead.[/yellow]\n")
 
     async def _list():
         adapter_instance = get_adapter(
@@ -1532,7 +1550,7 @@ def list_tickets(
     console.print(table)
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def show(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     comments: bool = typer.Option(False, "--comments", "-c", help="Show comments"),
@@ -1540,7 +1558,11 @@ def show(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Show detailed ticket information."""
+    """Show detailed ticket information.
+
+    DEPRECATED: Use 'mcp-ticketer ticket show' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket show' instead.[/yellow]\n")
 
     async def _show():
         adapter_instance = get_adapter(
@@ -1582,7 +1604,7 @@ def show(
             console.print(comment.content)
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def comment(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     content: str = typer.Argument(..., help="Comment content"),
@@ -1590,7 +1612,11 @@ def comment(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Add a comment to a ticket."""
+    """Add a comment to a ticket.
+
+    DEPRECATED: Use 'mcp-ticketer ticket comment' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket comment' instead.[/yellow]\n")
 
     async def _comment():
         adapter_instance = get_adapter(
@@ -1618,7 +1644,7 @@ def comment(
         raise typer.Exit(1)
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def update(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     title: Optional[str] = typer.Option(None, "--title", help="New title"),
@@ -1635,7 +1661,11 @@ def update(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Update ticket fields."""
+    """Update ticket fields.
+
+    DEPRECATED: Use 'mcp-ticketer ticket update' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket update' instead.[/yellow]\n")
     updates = {}
     if title:
         updates["title"] = title
@@ -1682,7 +1712,7 @@ def update(
         console.print("[dim]Worker started to process request[/dim]")
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def transition(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     state_positional: Optional[TicketState] = typer.Argument(
@@ -1697,15 +1727,19 @@ def transition(
 ) -> None:
     """Change ticket state with validation.
 
+    DEPRECATED: Use 'mcp-ticketer ticket transition' instead.
+
     Examples:
         # Recommended syntax with flag:
-        mcp-ticketer transition BTA-215 --state done
-        mcp-ticketer transition BTA-215 -s in_progress
+        mcp-ticketer ticket transition BTA-215 --state done
+        mcp-ticketer ticket transition BTA-215 -s in_progress
 
         # Legacy positional syntax (still supported):
-        mcp-ticketer transition BTA-215 done
+        mcp-ticketer ticket transition BTA-215 done
 
     """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket transition' instead.[/yellow]\n")
+
     # Determine which state to use (prefer flag over positional)
     target_state = state if state is not None else state_positional
 
@@ -1748,7 +1782,7 @@ def transition(
         console.print("[dim]Worker started to process request[/dim]")
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def search(
     query: Optional[str] = typer.Argument(None, help="Search query"),
     state: Optional[TicketState] = typer.Option(None, "--state", "-s"),
@@ -1759,7 +1793,11 @@ def search(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Search tickets with advanced query."""
+    """Search tickets with advanced query.
+
+    DEPRECATED: Use 'mcp-ticketer ticket search' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket search' instead.[/yellow]\n")
 
     async def _search():
         adapter_instance = get_adapter(
@@ -1791,6 +1829,12 @@ def search(
         console.print()
 
 
+# Add ticket command group to main app
+app.add_typer(ticket_app, name="ticket")
+
+# Add platform command group to main app
+app.add_typer(platform_app, name="platform")
+
 # Add queue command to main app
 app.add_typer(queue_app, name="queue")
 
@@ -1799,8 +1843,8 @@ app.add_typer(discover_app, name="discover")
 
 
 # Add diagnostics command
-@app.command()
-def diagnose(
+@app.command("diagnose")
+def diagnose_command(
     output_file: Optional[str] = typer.Option(
         None, "--output", "-o", help="Save full report to file"
     ),
@@ -1811,7 +1855,7 @@ def diagnose(
         False, "--simple", help="Use simple diagnostics (no heavy dependencies)"
     ),
 ) -> None:
-    """Run comprehensive system diagnostics and health check."""
+    """Run comprehensive system diagnostics and health check (alias: doctor)."""
     if simple:
         from .simple_health import simple_diagnose
 
@@ -1846,9 +1890,36 @@ def diagnose(
                 raise typer.Exit(1)
 
 
-@app.command()
-def health() -> None:
-    """Quick health check - shows system status summary."""
+@app.command("doctor")
+def doctor_alias(
+    output_file: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Save full report to file"
+    ),
+    json_output: bool = typer.Option(
+        False, "--json", help="Output report in JSON format"
+    ),
+    simple: bool = typer.Option(
+        False, "--simple", help="Use simple diagnostics (no heavy dependencies)"
+    ),
+) -> None:
+    """Run comprehensive system diagnostics and health check (alias for diagnose)."""
+    # Call the diagnose_command function with the same parameters
+    diagnose_command(output_file=output_file, json_output=json_output, simple=simple)
+
+
+@app.command("status")
+def status_command() -> None:
+    """Quick health check - shows system status summary (alias: health)."""
+    from .simple_health import simple_health_check
+
+    result = simple_health_check()
+    if result != 0:
+        raise typer.Exit(result)
+
+
+@app.command("health")
+def health_alias() -> None:
+    """Quick health check - shows system status summary (alias for status)."""
     from .simple_health import simple_health_check
 
     result = simple_health_check()
@@ -1864,9 +1935,13 @@ mcp_app = typer.Typer(
 )
 
 
-@app.command()
+@app.command(deprecated=True, hidden=True)
 def check(queue_id: str = typer.Argument(..., help="Queue ID to check")):
-    """Check status of a queued operation."""
+    """Check status of a queued operation.
+
+    DEPRECATED: Use 'mcp-ticketer ticket check' instead.
+    """
+    console.print("[yellow]⚠️  This command is deprecated. Use 'mcp-ticketer ticket check' instead.[/yellow]\n")
     queue = Queue()
     item = queue.get_item(queue_id)
 
@@ -2142,7 +2217,6 @@ def mcp_auggie(
 
 
 # Add command groups to main app (must be after all subcommands are defined)
-app.add_typer(linear_app, name="linear")
 app.add_typer(mcp_app, name="mcp")