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

mcp_ticketer/__version__.py

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

mcp_ticketer/cli/main.py

@@ -24,9 +24,10 @@ from ..queue.ticket_registry import TicketRegistry
 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)
@@ -1142,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()
 
@@ -1169,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"
     ),
@@ -1182,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()
 
@@ -1251,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(
@@ -1280,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()
@@ -1476,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"
@@ -1489,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(
@@ -1531,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"),
@@ -1539,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(
@@ -1581,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"),
@@ -1589,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(
@@ -1617,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"),
@@ -1634,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
@@ -1681,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(
@@ -1696,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
 
@@ -1747,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"),
@@ -1758,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(
@@ -1790,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")
 
@@ -1798,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"
     ),
@@ -1810,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
 
@@ -1845,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()
@@ -1863,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)
 
@@ -2141,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")
 
 

mcp_ticketer/cli/platform_commands.py

@@ -0,0 +1,133 @@
+"""Platform-specific command groups."""
+
+import typer
+
+# Import platform-specific command modules
+from .linear_commands import app as linear_app
+
+# Create main platform command group
+app = typer.Typer(
+    name="platform",
+    help="Platform-specific commands (Linear, JIRA, GitHub, AITrackdown)",
+)
+
+# Register Linear commands
+app.add_typer(linear_app, name="linear")
+
+# Create placeholder apps for other platforms
+
+# JIRA platform commands (placeholder)
+jira_app = typer.Typer(
+    name="jira",
+    help="JIRA-specific workspace and project management",
+)
+
+
+@jira_app.command("projects")
+def jira_list_projects():
+    """List JIRA projects (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]JIRA platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use the generic ticket commands for JIRA operations:\n"
+        "  mcp-ticketer ticket create 'My ticket'\n"
+        "  mcp-ticketer ticket list"
+    )
+
+
+@jira_app.command("configure")
+def jira_configure():
+    """Configure JIRA adapter (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]JIRA platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use 'mcp-ticketer init --adapter jira' to configure JIRA adapter."
+    )
+
+
+# GitHub platform commands (placeholder)
+github_app = typer.Typer(
+    name="github",
+    help="GitHub-specific repository and issue management",
+)
+
+
+@github_app.command("repos")
+def github_list_repos():
+    """List GitHub repositories (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]GitHub platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use the generic ticket commands for GitHub operations:\n"
+        "  mcp-ticketer ticket create 'My issue'\n"
+        "  mcp-ticketer ticket list"
+    )
+
+
+@github_app.command("configure")
+def github_configure():
+    """Configure GitHub adapter (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]GitHub platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use 'mcp-ticketer init --adapter github' to configure GitHub adapter."
+    )
+
+
+# AITrackdown platform commands (placeholder)
+aitrackdown_app = typer.Typer(
+    name="aitrackdown",
+    help="AITrackdown-specific local file management",
+)
+
+
+@aitrackdown_app.command("info")
+def aitrackdown_info():
+    """Show AITrackdown storage information (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]AITrackdown platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use the generic ticket commands for AITrackdown operations:\n"
+        "  mcp-ticketer ticket create 'My ticket'\n"
+        "  mcp-ticketer ticket list"
+    )
+
+
+@aitrackdown_app.command("configure")
+def aitrackdown_configure():
+    """Configure AITrackdown adapter (placeholder - not yet implemented)."""
+    from rich.console import Console
+
+    console = Console()
+    console.print(
+        "[yellow]AITrackdown platform commands are not yet implemented.[/yellow]"
+    )
+    console.print(
+        "Use 'mcp-ticketer init --adapter aitrackdown' to configure AITrackdown adapter."
+    )
+
+
+# Register all platform command groups
+app.add_typer(jira_app, name="jira")
+app.add_typer(github_app, name="github")
+app.add_typer(aitrackdown_app, name="aitrackdown")

mcp_ticketer/cli/ticket_commands.py

@@ -0,0 +1,765 @@
+"""Ticket management commands."""
+
+import asyncio
+import json
+import os
+from enum import Enum
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ..core import AdapterRegistry, Priority, TicketState
+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
+
+
+# Moved from main.py to avoid circular import
+class AdapterType(str, Enum):
+    """Available adapter types."""
+
+    AITRACKDOWN = "aitrackdown"
+    LINEAR = "linear"
+    JIRA = "jira"
+    GITHUB = "github"
+
+
+app = typer.Typer(
+    name="ticket",
+    help="Ticket management operations (create, list, update, search, etc.)",
+)
+console = Console()
+
+
+# Configuration functions (moved from main.py to avoid circular import)
+def load_config(project_dir: Optional[Path] = None) -> dict:
+    """Load configuration from project-local config file."""
+    import logging
+
+    logger = logging.getLogger(__name__)
+    base_dir = project_dir or Path.cwd()
+    project_config = base_dir / ".mcp-ticketer" / "config.json"
+
+    if project_config.exists():
+        try:
+            with open(project_config) as f:
+                config = json.load(f)
+                logger.info(f"Loaded configuration from: {project_config}")
+                return config
+        except (OSError, json.JSONDecodeError) as e:
+            logger.warning(f"Could not load project config: {e}, using defaults")
+            console.print(f"[yellow]Warning: Could not load project config: {e}[/yellow]")
+
+    logger.info("No project-local config found, defaulting to aitrackdown adapter")
+    return {"adapter": "aitrackdown", "config": {"base_path": ".aitrackdown"}}
+
+
+def save_config(config: dict) -> None:
+    """Save configuration to project-local config file."""
+    import logging
+
+    logger = logging.getLogger(__name__)
+    project_config = Path.cwd() / ".mcp-ticketer" / "config.json"
+    project_config.parent.mkdir(parents=True, exist_ok=True)
+    with open(project_config, "w") as f:
+        json.dump(config, f, indent=2)
+    logger.info(f"Saved configuration to: {project_config}")
+
+
+def get_adapter(override_adapter: Optional[str] = None, override_config: Optional[dict] = None):
+    """Get configured adapter instance."""
+    config = load_config()
+
+    if override_adapter:
+        adapter_type = override_adapter
+        adapters_config = config.get("adapters", {})
+        adapter_config = adapters_config.get(adapter_type, {})
+        if override_config:
+            adapter_config.update(override_config)
+    else:
+        adapter_type = config.get("default_adapter", "aitrackdown")
+        adapters_config = config.get("adapters", {})
+        adapter_config = adapters_config.get(adapter_type, {})
+
+    if not adapter_config and "config" in config:
+        adapter_config = config["config"]
+
+    # Add environment variables for authentication
+    if adapter_type == "linear":
+        if not adapter_config.get("api_key"):
+            adapter_config["api_key"] = os.getenv("LINEAR_API_KEY")
+    elif adapter_type == "github":
+        if not adapter_config.get("api_key") and not adapter_config.get("token"):
+            adapter_config["api_key"] = os.getenv("GITHUB_TOKEN")
+    elif adapter_type == "jira":
+        if not adapter_config.get("api_token"):
+            adapter_config["api_token"] = os.getenv("JIRA_ACCESS_TOKEN")
+        if not adapter_config.get("email"):
+            adapter_config["email"] = os.getenv("JIRA_ACCESS_USER")
+
+    return AdapterRegistry.get_adapter(adapter_type, adapter_config)
+
+
+def _discover_from_env_files() -> Optional[str]:
+    """Discover adapter configuration from .env or .env.local files.
+
+    Returns:
+        Adapter name if discovered, None otherwise
+
+    """
+    import logging
+    from pathlib import Path
+
+    logger = logging.getLogger(__name__)
+
+    # Check .env.local first, then .env
+    env_files = [".env.local", ".env"]
+
+    for env_file in env_files:
+        env_path = Path.cwd() / env_file
+        if env_path.exists():
+            try:
+                # Simple .env parsing (key=value format)
+                env_vars = {}
+                with open(env_path) as f:
+                    for line in f:
+                        line = line.strip()
+                        if line and not line.startswith("#") and "=" in line:
+                            key, value = line.split("=", 1)
+                            env_vars[key.strip()] = value.strip().strip("\"'")
+
+                # Check for adapter-specific variables
+                if env_vars.get("LINEAR_API_KEY"):
+                    logger.info(f"Discovered Linear configuration in {env_file}")
+                    return "linear"
+                elif env_vars.get("GITHUB_TOKEN"):
+                    logger.info(f"Discovered GitHub configuration in {env_file}")
+                    return "github"
+                elif env_vars.get("JIRA_SERVER"):
+                    logger.info(f"Discovered JIRA configuration in {env_file}")
+                    return "jira"
+
+            except Exception as e:
+                logger.warning(f"Could not read {env_file}: {e}")
+
+    return None
+
+
+def _save_adapter_to_config(adapter_name: str) -> None:
+    """Save adapter configuration to config file.
+
+    Args:
+        adapter_name: Name of the adapter to save as default
+
+    """
+    import logging
+
+    from .main import save_config
+
+    logger = logging.getLogger(__name__)
+
+    try:
+        config = load_config()
+        config["default_adapter"] = adapter_name
+
+        # Ensure adapters section exists
+        if "adapters" not in config:
+            config["adapters"] = {}
+
+        # Add basic adapter config if not exists
+        if adapter_name not in config["adapters"]:
+            if adapter_name == "aitrackdown":
+                config["adapters"][adapter_name] = {"base_path": ".aitrackdown"}
+            else:
+                config["adapters"][adapter_name] = {"type": adapter_name}
+
+        save_config(config)
+        logger.info(f"Saved {adapter_name} as default adapter")
+
+    except Exception as e:
+        logger.warning(f"Could not save adapter configuration: {e}")
+
+
+@app.command()
+def create(
+    title: str = typer.Argument(..., help="Ticket title"),
+    description: Optional[str] = typer.Option(
+        None, "--description", "-d", help="Ticket description"
+    ),
+    priority: Priority = typer.Option(
+        Priority.MEDIUM, "--priority", "-p", help="Priority level"
+    ),
+    tags: Optional[list[str]] = typer.Option(
+        None, "--tag", "-t", help="Tags (can be specified multiple times)"
+    ),
+    assignee: Optional[str] = typer.Option(
+        None, "--assignee", "-a", help="Assignee username"
+    ),
+    project: Optional[str] = typer.Option(
+        None,
+        "--project",
+        help="Parent project/epic ID (synonym for --epic)",
+    ),
+    epic: Optional[str] = typer.Option(
+        None,
+        "--epic",
+        help="Parent epic/project ID (synonym for --project)",
+    ),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Create a new ticket with comprehensive health checks."""
+    # IMMEDIATE HEALTH CHECK - Critical for reliability
+    health_monitor = QueueHealthMonitor()
+    health = health_monitor.check_health()
+
+    # Display health status
+    if health["status"] == HealthStatus.CRITICAL:
+        console.print("[red]🚨 CRITICAL: Queue system has serious issues![/red]")
+        for alert in health["alerts"]:
+            if alert["level"] == "critical":
+                console.print(f"[red]  • {alert['message']}[/red]")
+
+        # Attempt auto-repair
+        console.print("[yellow]Attempting automatic repair...[/yellow]")
+        repair_result = health_monitor.auto_repair()
+
+        if repair_result["actions_taken"]:
+            for action in repair_result["actions_taken"]:
+                console.print(f"[yellow]  ✓ {action}[/yellow]")
+
+            # Re-check health after repair
+            health = health_monitor.check_health()
+            if health["status"] == HealthStatus.CRITICAL:
+                console.print(
+                    "[red]❌ Auto-repair failed. Manual intervention required.[/red]"
+                )
+                console.print(
+                    "[red]Cannot safely create ticket. Please check system status.[/red]"
+                )
+                raise typer.Exit(1)
+            else:
+                console.print(
+                    "[green]✓ Auto-repair successful. Proceeding with ticket creation.[/green]"
+                )
+        else:
+            console.print(
+                "[red]❌ No repair actions available. Manual intervention required.[/red]"
+            )
+            raise typer.Exit(1)
+
+    elif health["status"] == HealthStatus.WARNING:
+        console.print("[yellow]⚠️  Warning: Queue system has minor issues[/yellow]")
+        for alert in health["alerts"]:
+            if alert["level"] == "warning":
+                console.print(f"[yellow]  • {alert['message']}[/yellow]")
+        console.print("[yellow]Proceeding with ticket creation...[/yellow]")
+
+    # Get the adapter name with priority: 1) argument, 2) config, 3) .env files, 4) default
+    if adapter:
+        # Priority 1: Command-line argument - save to config for future use
+        adapter_name = adapter.value
+        _save_adapter_to_config(adapter_name)
+    else:
+        # Priority 2: Check existing config
+        config = load_config()
+        adapter_name = config.get("default_adapter")
+
+        if not adapter_name or adapter_name == "aitrackdown":
+            # Priority 3: Check .env files and save if found
+            env_adapter = _discover_from_env_files()
+            if env_adapter:
+                adapter_name = env_adapter
+                _save_adapter_to_config(adapter_name)
+            else:
+                # Priority 4: Default
+                adapter_name = "aitrackdown"
+
+    # Resolve project/epic synonym - prefer whichever is provided
+    parent_epic_id = project or epic
+
+    # Create task data
+    # Import Priority for type checking
+    from ..core.models import Priority as PriorityEnum
+
+    task_data = {
+        "title": title,
+        "description": description,
+        "priority": priority.value if isinstance(priority, PriorityEnum) else priority,
+        "tags": tags or [],
+        "assignee": assignee,
+        "parent_epic": parent_epic_id,
+    }
+
+    # WORKAROUND: Use direct operation for Linear adapter to bypass worker subprocess issue
+    if adapter_name == "linear":
+        console.print(
+            "[yellow]⚠️[/yellow]  Using direct operation for Linear adapter (bypassing queue)"
+        )
+        try:
+            # Load configuration and create adapter directly
+            config = load_config()
+            adapter_config = config.get("adapters", {}).get(adapter_name, {})
+
+            # Import and create adapter
+            from ..core.registry import AdapterRegistry
+
+            adapter_instance = AdapterRegistry.get_adapter(adapter_name, adapter_config)
+
+            # Create task directly
+            from ..core.models import Priority, Task
+
+            task = Task(
+                title=task_data["title"],
+                description=task_data.get("description"),
+                priority=(
+                    Priority(task_data["priority"])
+                    if task_data.get("priority")
+                    else Priority.MEDIUM
+                ),
+                tags=task_data.get("tags", []),
+                assignee=task_data.get("assignee"),
+                parent_epic=task_data.get("parent_epic"),
+            )
+
+            # Create ticket synchronously
+            import asyncio
+
+            result = asyncio.run(adapter_instance.create(task))
+
+            console.print(f"[green]✓[/green] Ticket created successfully: {result.id}")
+            console.print(f"  Title: {result.title}")
+            console.print(f"  Priority: {result.priority}")
+            console.print(f"  State: {result.state}")
+            # Get URL from metadata if available
+            if (
+                result.metadata
+                and "linear" in result.metadata
+                and "url" in result.metadata["linear"]
+            ):
+                console.print(f"  URL: {result.metadata['linear']['url']}")
+
+            return result.id
+
+        except Exception as e:
+            console.print(f"[red]❌[/red] Failed to create ticket: {e}")
+            raise
+
+    # Use queue for other adapters
+    queue = Queue()
+    queue_id = queue.add(
+        ticket_data=task_data,
+        adapter=adapter_name,
+        operation="create",
+        project_dir=str(Path.cwd()),  # Explicitly pass current project directory
+    )
+
+    # Register in ticket registry for tracking
+    registry = TicketRegistry()
+    registry.register_ticket_operation(
+        queue_id, adapter_name, "create", title, task_data
+    )
+
+    console.print(f"[green]✓[/green] Queued ticket creation: {queue_id}")
+    console.print(f"  Title: {title}")
+    console.print(f"  Priority: {priority}")
+    console.print(f"  Adapter: {adapter_name}")
+    console.print("[dim]Use 'mcp-ticketer ticket check {queue_id}' to check progress[/dim]")
+
+    # Start worker if needed with immediate feedback
+    manager = WorkerManager()
+    worker_started = manager.start_if_needed()
+
+    if worker_started:
+        console.print("[dim]Worker started to process request[/dim]")
+
+        # Give immediate feedback on processing
+        import time
+
+        time.sleep(1)  # Brief pause to let worker start
+
+        # Check if item is being processed
+        item = queue.get_item(queue_id)
+        if item and item.status == QueueStatus.PROCESSING:
+            console.print("[green]✓ Item is being processed by worker[/green]")
+        elif item and item.status == QueueStatus.PENDING:
+            console.print("[yellow]⏳ Item is queued for processing[/yellow]")
+        else:
+            console.print(
+                "[red]⚠️  Item status unclear - check with 'mcp-ticketer ticket check {queue_id}'[/red]"
+            )
+    else:
+        # Worker didn't start - this is a problem
+        pending_count = queue.get_pending_count()
+        if pending_count > 1:  # More than just this item
+            console.print(
+                f"[red]❌ Worker failed to start with {pending_count} pending items![/red]"
+            )
+            console.print(
+                "[red]This is a critical issue. Try 'mcp-ticketer queue worker start' manually.[/red]"
+            )
+        else:
+            console.print(
+                "[yellow]Worker not started (no other pending items)[/yellow]"
+            )
+
+
+@app.command("list")
+def list_tickets(
+    state: Optional[TicketState] = typer.Option(
+        None, "--state", "-s", help="Filter by state"
+    ),
+    priority: Optional[Priority] = typer.Option(
+        None, "--priority", "-p", help="Filter by priority"
+    ),
+    limit: int = typer.Option(10, "--limit", "-l", help="Maximum number of tickets"),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """List tickets with optional filters."""
+
+    async def _list():
+        adapter_instance = get_adapter(
+            override_adapter=adapter.value if adapter else None
+        )
+        filters = {}
+        if state:
+            filters["state"] = state
+        if priority:
+            filters["priority"] = priority
+        return await adapter_instance.list(limit=limit, filters=filters)
+
+    tickets = asyncio.run(_list())
+
+    if not tickets:
+        console.print("[yellow]No tickets found[/yellow]")
+        return
+
+    # Create table
+    table = Table(title="Tickets")
+    table.add_column("ID", style="cyan", no_wrap=True)
+    table.add_column("Title", style="white")
+    table.add_column("State", style="green")
+    table.add_column("Priority", style="yellow")
+    table.add_column("Assignee", style="blue")
+
+    for ticket in tickets:
+        # Handle assignee field - Epic doesn't have assignee, Task does
+        assignee = getattr(ticket, "assignee", None) or "-"
+
+        table.add_row(
+            ticket.id or "N/A",
+            ticket.title,
+            ticket.state,
+            ticket.priority,
+            assignee,
+        )
+
+    console.print(table)
+
+
+@app.command()
+def show(
+    ticket_id: str = typer.Argument(..., help="Ticket ID"),
+    comments: bool = typer.Option(False, "--comments", "-c", help="Show comments"),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Show detailed ticket information."""
+
+    async def _show():
+        adapter_instance = get_adapter(
+            override_adapter=adapter.value if adapter else None
+        )
+        ticket = await adapter_instance.read(ticket_id)
+        ticket_comments = None
+        if comments and ticket:
+            ticket_comments = await adapter_instance.get_comments(ticket_id)
+        return ticket, ticket_comments
+
+    ticket, ticket_comments = asyncio.run(_show())
+
+    if not ticket:
+        console.print(f"[red]✗[/red] Ticket not found: {ticket_id}")
+        raise typer.Exit(1)
+
+    # Display ticket details
+    console.print(f"\n[bold]Ticket: {ticket.id}[/bold]")
+    console.print(f"Title: {ticket.title}")
+    console.print(f"State: [green]{ticket.state}[/green]")
+    console.print(f"Priority: [yellow]{ticket.priority}[/yellow]")
+
+    if ticket.description:
+        console.print("\n[dim]Description:[/dim]")
+        console.print(ticket.description)
+
+    if ticket.tags:
+        console.print(f"\nTags: {', '.join(ticket.tags)}")
+
+    if ticket.assignee:
+        console.print(f"Assignee: {ticket.assignee}")
+
+    # Display comments if requested
+    if ticket_comments:
+        console.print(f"\n[bold]Comments ({len(ticket_comments)}):[/bold]")
+        for comment in ticket_comments:
+            console.print(f"\n[dim]{comment.created_at} - {comment.author}:[/dim]")
+            console.print(comment.content)
+
+
+@app.command()
+def comment(
+    ticket_id: str = typer.Argument(..., help="Ticket ID"),
+    content: str = typer.Argument(..., help="Comment content"),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Add a comment to a ticket."""
+
+    async def _comment():
+        adapter_instance = get_adapter(
+            override_adapter=adapter.value if adapter else None
+        )
+
+        # Create comment
+        comment_obj = Comment(
+            ticket_id=ticket_id,
+            content=content,
+            author="cli-user",  # Could be made configurable
+        )
+
+        result = await adapter_instance.add_comment(comment_obj)
+        return result
+
+    try:
+        result = asyncio.run(_comment())
+        console.print("[green]✓[/green] Comment added successfully")
+        if result.id:
+            console.print(f"Comment ID: {result.id}")
+        console.print(f"Content: {content}")
+    except Exception as e:
+        console.print(f"[red]✗[/red] Failed to add comment: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def update(
+    ticket_id: str = typer.Argument(..., help="Ticket ID"),
+    title: Optional[str] = typer.Option(None, "--title", help="New title"),
+    description: Optional[str] = typer.Option(
+        None, "--description", "-d", help="New description"
+    ),
+    priority: Optional[Priority] = typer.Option(
+        None, "--priority", "-p", help="New priority"
+    ),
+    assignee: Optional[str] = typer.Option(
+        None, "--assignee", "-a", help="New assignee"
+    ),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Update ticket fields."""
+    updates = {}
+    if title:
+        updates["title"] = title
+    if description:
+        updates["description"] = description
+    if priority:
+        updates["priority"] = (
+            priority.value if isinstance(priority, Priority) else priority
+        )
+    if assignee:
+        updates["assignee"] = assignee
+
+    if not updates:
+        console.print("[yellow]No updates specified[/yellow]")
+        raise typer.Exit(1)
+
+    # Get the adapter name
+    config = load_config()
+    adapter_name = (
+        adapter.value if adapter else config.get("default_adapter", "aitrackdown")
+    )
+
+    # Add ticket_id to updates
+    updates["ticket_id"] = ticket_id
+
+    # Add to queue with explicit project directory
+    queue = Queue()
+    queue_id = queue.add(
+        ticket_data=updates,
+        adapter=adapter_name,
+        operation="update",
+        project_dir=str(Path.cwd()),  # Explicitly pass current project directory
+    )
+
+    console.print(f"[green]✓[/green] Queued ticket update: {queue_id}")
+    for key, value in updates.items():
+        if key != "ticket_id":
+            console.print(f"  {key}: {value}")
+    console.print("[dim]Use 'mcp-ticketer ticket check {queue_id}' to check progress[/dim]")
+
+    # Start worker if needed
+    manager = WorkerManager()
+    if manager.start_if_needed():
+        console.print("[dim]Worker started to process request[/dim]")
+
+
+@app.command()
+def transition(
+    ticket_id: str = typer.Argument(..., help="Ticket ID"),
+    state_positional: Optional[TicketState] = typer.Argument(
+        None, help="Target state (positional - deprecated, use --state instead)"
+    ),
+    state: Optional[TicketState] = typer.Option(
+        None, "--state", "-s", help="Target state (recommended)"
+    ),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Change ticket state with validation.
+
+    Examples:
+        # Recommended syntax with flag:
+        mcp-ticketer ticket transition BTA-215 --state done
+        mcp-ticketer ticket transition BTA-215 -s in_progress
+
+        # Legacy positional syntax (still supported):
+        mcp-ticketer ticket transition BTA-215 done
+
+    """
+    # Determine which state to use (prefer flag over positional)
+    target_state = state if state is not None else state_positional
+
+    if target_state is None:
+        console.print("[red]Error: State is required[/red]")
+        console.print(
+            "Use either:\n"
+            "  - Flag syntax (recommended): mcp-ticketer ticket transition TICKET-ID --state STATE\n"
+            "  - Positional syntax: mcp-ticketer ticket transition TICKET-ID STATE"
+        )
+        raise typer.Exit(1)
+
+    # Get the adapter name
+    config = load_config()
+    adapter_name = (
+        adapter.value if adapter else config.get("default_adapter", "aitrackdown")
+    )
+
+    # Add to queue with explicit project directory
+    queue = Queue()
+    queue_id = queue.add(
+        ticket_data={
+            "ticket_id": ticket_id,
+            "state": (
+                target_state.value if hasattr(target_state, "value") else target_state
+            ),
+        },
+        adapter=adapter_name,
+        operation="transition",
+        project_dir=str(Path.cwd()),  # Explicitly pass current project directory
+    )
+
+    console.print(f"[green]✓[/green] Queued state transition: {queue_id}")
+    console.print(f"  Ticket: {ticket_id} → {target_state}")
+    console.print("[dim]Use 'mcp-ticketer ticket check {queue_id}' to check progress[/dim]")
+
+    # Start worker if needed
+    manager = WorkerManager()
+    if manager.start_if_needed():
+        console.print("[dim]Worker started to process request[/dim]")
+
+
+@app.command()
+def search(
+    query: Optional[str] = typer.Argument(None, help="Search query"),
+    state: Optional[TicketState] = typer.Option(None, "--state", "-s"),
+    priority: Optional[Priority] = typer.Option(None, "--priority", "-p"),
+    assignee: Optional[str] = typer.Option(None, "--assignee", "-a"),
+    limit: int = typer.Option(10, "--limit", "-l"),
+    adapter: Optional[AdapterType] = typer.Option(
+        None, "--adapter", help="Override default adapter"
+    ),
+) -> None:
+    """Search tickets with advanced query."""
+
+    async def _search():
+        adapter_instance = get_adapter(
+            override_adapter=adapter.value if adapter else None
+        )
+        search_query = SearchQuery(
+            query=query,
+            state=state,
+            priority=priority,
+            assignee=assignee,
+            limit=limit,
+        )
+        return await adapter_instance.search(search_query)
+
+    tickets = asyncio.run(_search())
+
+    if not tickets:
+        console.print("[yellow]No tickets found matching query[/yellow]")
+        return
+
+    # Display results
+    console.print(f"\n[bold]Found {len(tickets)} ticket(s)[/bold]\n")
+
+    for ticket in tickets:
+        console.print(f"[cyan]{ticket.id}[/cyan]: {ticket.title}")
+        console.print(f"  State: {ticket.state} | Priority: {ticket.priority}")
+        if ticket.assignee:
+            console.print(f"  Assignee: {ticket.assignee}")
+        console.print()
+
+
+@app.command()
+def check(queue_id: str = typer.Argument(..., help="Queue ID to check")):
+    """Check status of a queued operation."""
+    queue = Queue()
+    item = queue.get_item(queue_id)
+
+    if not item:
+        console.print(f"[red]Queue item not found: {queue_id}[/red]")
+        raise typer.Exit(1)
+
+    # Display status
+    console.print(f"\n[bold]Queue Item: {item.id}[/bold]")
+    console.print(f"Operation: {item.operation}")
+    console.print(f"Adapter: {item.adapter}")
+
+    # Status with color
+    if item.status == QueueStatus.COMPLETED:
+        console.print(f"Status: [green]{item.status}[/green]")
+    elif item.status == QueueStatus.FAILED:
+        console.print(f"Status: [red]{item.status}[/red]")
+    elif item.status == QueueStatus.PROCESSING:
+        console.print(f"Status: [yellow]{item.status}[/yellow]")
+    else:
+        console.print(f"Status: {item.status}")
+
+    # Timestamps
+    console.print(f"Created: {item.created_at.strftime('%Y-%m-%d %H:%M:%S')}")
+    if item.processed_at:
+        console.print(f"Processed: {item.processed_at.strftime('%Y-%m-%d %H:%M:%S')}")
+
+    # Error or result
+    if item.error_message:
+        console.print(f"\n[red]Error:[/red] {item.error_message}")
+    elif item.result:
+        console.print("\n[green]Result:[/green]")
+        for key, value in item.result.items():
+            console.print(f"  {key}: {value}")
+
+    if item.retry_count > 0:
+        console.print(f"\nRetry Count: {item.retry_count}")

{mcp_ticketer-0.3.7.dist-info → mcp_ticketer-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.3.7
+Version: 0.4.0
 Summary: Universal ticket management interface for AI agents with MCP support
 Author-email: MCP Ticketer Team <support@mcp-ticketer.io>
 Maintainer-email: MCP Ticketer Team <support@mcp-ticketer.io>

{mcp_ticketer-0.3.7.dist-info → mcp_ticketer-0.4.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 mcp_ticketer/__init__.py,sha256=Xx4WaprO5PXhVPbYi1L6tBmwmJMkYS-lMyG4ieN6QP0,717
-mcp_ticketer/__version__.py,sha256=s7BXKaEC9wzrKYxOdqIb1UHlYxMSgLWk-8vzfr8WEIc,1117
+mcp_ticketer/__version__.py,sha256=CR9K0foaKbPjgF5Yl6n14vC3Mv6RP3UcC71ofaagTzE,1117
 mcp_ticketer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_ticketer/adapters/__init__.py,sha256=B5DFllWn23hkhmrLykNO5uMMSdcFuuPHXyLw_jyFzuE,358
 mcp_ticketer/adapters/aitrackdown.py,sha256=Ecw2SQAGVQs5yMH6m2pj61LxCJsuy-g2bvF8uwTpLUE,22588
@@ -24,11 +24,13 @@ mcp_ticketer/cli/diagnostics.py,sha256=jHF68ydW3RNVGumBnHUjUmq6YOjQD2UDkx0O7M__x
 mcp_ticketer/cli/discover.py,sha256=AF_qlQc1Oo0UkWayoF5pmRChS5J3fJjH6f2YZzd_k8w,13188
 mcp_ticketer/cli/gemini_configure.py,sha256=ZNSA1lBW-itVToza-JxW95Po7daVXKiZAh7lp6pmXMU,9343
 mcp_ticketer/cli/linear_commands.py,sha256=_8f8ze_1MbiUweU6RFHpldgfHLirysIdPjHr2_S0YhI,17319
-mcp_ticketer/cli/main.py,sha256=BFo7QYU0tTOHWSfTmegzDqflSYFytCE8Jw6QGB7TwaY,74470
+mcp_ticketer/cli/main.py,sha256=veWHcq44L58SxegU3iU--r1jz9LM1OWv4fUG47K3BGw,77798
 mcp_ticketer/cli/mcp_configure.py,sha256=RzV50UjXgOmvMp-9S0zS39psuvjffVByaMrqrUaAGAM,9594
 mcp_ticketer/cli/migrate_config.py,sha256=MYsr_C5ZxsGg0P13etWTWNrJ_lc6ElRCkzfQADYr3DM,5956
+mcp_ticketer/cli/platform_commands.py,sha256=koLWUFW-q1oRxJMVI_V35cDZ8OOH3F3bIdD8RRTTRpM,3694
 mcp_ticketer/cli/queue_commands.py,sha256=mm-3H6jmkUGJDyU_E46o9iRpek8tvFCm77F19OtHiZI,7884
 mcp_ticketer/cli/simple_health.py,sha256=GlOLRRFoifCna995NoHuKpb3xmFkLi2b3Ke1hyeDvq4,7950
+mcp_ticketer/cli/ticket_commands.py,sha256=AD9D-EidPA3vk_-MpY3B4QGKhezCQqbKCn8vRsg57Rg,26637
 mcp_ticketer/cli/utils.py,sha256=IOycMmhwtCDpL3RN_wVEZkYMg9FHyDr4mg5M9Bxzfbo,23041
 mcp_ticketer/core/__init__.py,sha256=eXovsaJymQRP2AwOBuOy6mFtI3I68D7gGenZ5V-IMqo,349
 mcp_ticketer/core/adapter.py,sha256=q64LxOInIno7EIbmuxItf8KEsd-g9grCs__Z4uwZHto,10273
@@ -54,9 +56,9 @@ mcp_ticketer/queue/queue.py,sha256=PIB_8gOE4rCb5_tBNKw9qD6YhSgH3Ei3IzVrUSY3F_o,1
 mcp_ticketer/queue/run_worker.py,sha256=WhoeamL8LKZ66TM8W1PkMPwjF2w_EDFMP-mevs6C1TM,1019
 mcp_ticketer/queue/ticket_registry.py,sha256=FE6W_D8NA-66cJQ6VqghChF3JasYW845JVfEZdiqLbA,15449
 mcp_ticketer/queue/worker.py,sha256=AF6W1bdxWnHiJd6-iBWqTHkZ4lFflsS65CAtgFPR0FA,20983
-mcp_ticketer-0.3.7.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
-mcp_ticketer-0.3.7.dist-info/METADATA,sha256=ivW854H301BPY_YzUtzYhhhQ15sQKF_u-owFjOq6e24,13219
-mcp_ticketer-0.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_ticketer-0.3.7.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
-mcp_ticketer-0.3.7.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
-mcp_ticketer-0.3.7.dist-info/RECORD,,
+mcp_ticketer-0.4.0.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.4.0.dist-info/METADATA,sha256=kU9H9axMFLLYInrAxYQPW-4rlfBEd9USR_kOHdlfWQY,13219
+mcp_ticketer-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.4.0.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
+mcp_ticketer-0.4.0.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.4.0.dist-info/RECORD,,