mcp-ticketer 0.3.7__py3-none-any.whl → 0.4.1__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.1"
 __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)
@@ -890,7 +891,8 @@ def _show_next_steps(
     console.print("[dim]Run 'mcp-ticketer --help' for more commands[/dim]")
 
 
-@app.command()
+# Keep the old install command as deprecated alias to init
+@app.command(deprecated=True, hidden=True)
 def install(
     adapter: Optional[str] = typer.Option(
         None,
@@ -940,26 +942,14 @@ def install(
         None, "--github-token", help="GitHub Personal Access Token"
     ),
 ) -> None:
-    """Initialize mcp-ticketer for the current project (alias for init).
-
-    This command is synonymous with 'init' and 'setup' - all three provide
-    identical functionality with interactive prompts to guide you through
-    configuring MCP Ticketer for your preferred ticket management system.
-
-    Examples:
-        # Interactive setup (same as 'init' and 'setup')
-        mcp-ticketer install
-
-        # Force specific adapter
-        mcp-ticketer install --adapter linear
-
-        # Initialize for different project
-        mcp-ticketer install --path /path/to/project
+    """DEPRECATED: Use 'mcp-ticketer init' instead.
 
-        # Save globally (not recommended)
-        mcp-ticketer install --global
+    This command is deprecated. Use 'mcp-ticketer init' for project initialization.
 
     """
+    console.print(
+        "[yellow]⚠️  'install' is deprecated. Use 'mcp-ticketer init' instead.[/yellow]\n"
+    )
     # Call init with all parameters
     init(
         adapter=adapter,
@@ -1142,9 +1132,16 @@ 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 +1166,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 +1179,13 @@ 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 +1254,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 +1283,14 @@ 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 +1486,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 +1499,13 @@ 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 +1547,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 +1555,13 @@ 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 +1603,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 +1611,13 @@ 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 +1645,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 +1662,13 @@ 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 +1715,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 +1730,21 @@ 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 +1787,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 +1798,13 @@ 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 +1836,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 +1850,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 +1862,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 +1897,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()
@@ -1862,10 +1941,81 @@ mcp_app = typer.Typer(
     add_completion=False,
 )
 
+# Create install command group (like kuzu-memory)
+install_app = typer.Typer(
+    name="install",
+    help="Manage AI system integrations",
+    add_completion=False,
+)
 
-@app.command()
+
+@install_app.command(name="add")
+def install_add(
+    platform: str = typer.Argument(
+        ..., help="Platform to install (claude-code, claude-desktop, etc.)"
+    ),
+    project_path: Optional[str] = typer.Option(
+        None, "--project", help="Project directory"
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Show what would be done without making changes"
+    ),
+    verbose: bool = typer.Option(False, "--verbose", help="Enable verbose output"),
+) -> None:
+    """Install mcp-ticketer integration for an AI platform.
+
+    Each platform gets the right configuration automatically:
+      - claude-code: Project-level MCP server
+      - claude-desktop: Global MCP server
+
+    Examples:
+        # Install for Claude Code (project-level)
+        mcp-ticketer install add claude-code
+
+        # Install for Claude Desktop (global)
+        mcp-ticketer install add claude-desktop
+
+        # Dry run to preview changes
+        mcp-ticketer install add claude-code --dry-run
+
+    """
+    from .mcp_configure import configure_claude_mcp
+
+    # Map platform names to configuration
+    platform_mapping = {
+        "claude-code": {"global": False, "name": "Claude Code"},
+        "claude-desktop": {"global": True, "name": "Claude Desktop"},
+    }
+
+    if platform not in platform_mapping:
+        console.print(f"[red]Unknown platform: {platform}[/red]")
+        console.print("\n[bold]Available platforms:[/bold]")
+        for p in platform_mapping.keys():
+            console.print(f"  • {p}")
+        raise typer.Exit(1)
+
+    config = platform_mapping[platform]
+
+    if dry_run:
+        console.print(f"[cyan]DRY RUN - Would install for {config['name']}[/cyan]")
+        return
+
+    try:
+        configure_claude_mcp(global_config=config["global"], force=True)
+    except Exception as e:
+        console.print(f"[red]Installation failed: {e}[/red]")
+        raise typer.Exit(1)
+
+
+@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)
 
@@ -1905,8 +2055,8 @@ def check(queue_id: str = typer.Argument(..., help="Queue ID to check")):
         console.print(f"\nRetry Count: {item.retry_count}")
 
 
-@app.command()
-def serve(
+@mcp_app.command(name="serve")
+def mcp_serve(
     adapter: Optional[AdapterType] = typer.Option(
         None, "--adapter", "-a", help="Override default adapter type"
     ),
@@ -1917,7 +2067,7 @@ def serve(
     """Start MCP server for JSON-RPC communication over stdio.
 
     This command is used by Claude Code/Desktop when connecting to the MCP server.
-    You typically don't need to run this manually - use 'mcp-ticketer mcp' to configure.
+    You typically don't need to run this manually - use 'mcp-ticketer install add' to configure.
 
     Configuration Resolution:
     - When MCP server starts, it uses the current working directory (cwd)
@@ -2141,8 +2291,8 @@ 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")
+app.add_typer(install_app, name="install")
 
 
 def main():

mcp_ticketer/cli/mcp_configure.py

@@ -16,13 +16,21 @@ def find_mcp_ticketer_binary() -> str:
     """Find the mcp-ticketer binary path.
 
     Returns:
-        Path to mcp-ticketer binary
+        Path to mcp-ticketer binary (prefers simple 'mcp-ticketer' if in PATH)
 
     Raises:
         FileNotFoundError: If binary not found
 
     """
-    # Check if running from development environment
+    # PRIORITY 1: Check PATH first (like kuzu-memory)
+    # This allows the system to resolve the binary location
+    which_result = shutil.which("mcp-ticketer")
+    if which_result:
+        # Return just "mcp-ticketer" for PATH-based installations
+        # This is more portable and matches kuzu-memory's approach
+        return "mcp-ticketer"
+
+    # FALLBACK: Check development environment
     import mcp_ticketer
 
     package_path = Path(mcp_ticketer.__file__).parent.parent.parent
@@ -45,11 +53,6 @@ def find_mcp_ticketer_binary() -> str:
         / "mcp-ticketer",
     ]
 
-    # Check PATH
-    which_result = shutil.which("mcp-ticketer")
-    if which_result:
-        return which_result
-
     # Check possible paths
     for path in possible_paths:
         if path.exists():
@@ -183,7 +186,7 @@ def create_mcp_server_config(
     """
     config = {
         "command": binary_path,
-        "args": ["serve"],  # Use 'serve' command to start MCP server
+        "args": ["mcp", "serve"],  # Use 'mcp serve' command to start MCP server
     }
 
     # Add working directory if provided

mcp_ticketer/cli/platform_commands.py

@@ -0,0 +1,123 @@
+"""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")