mcp-ticketer 0.1.26__tar.gz → 0.1.27__tar.gz

{mcp_ticketer-0.1.26 → mcp_ticketer-0.1.27}/CHANGELOG.md

@@ -8,13 +8,73 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ### Added
 - WebSocket support for real-time updates
-- Advanced search with full-text capabilities
-- Bulk operations for mass ticket management
 - Custom ticket templates
 - Team collaboration features
 - Analytics dashboard
 - Webhook notification support
 
+## [0.1.27] - 2025-10-23
+
+### Added
+- **Complete MCP Tool Coverage**: 18 comprehensive MCP tools for full workflow management
+  - Hierarchy management: `epic_create`, `epic_list`, `epic_issues`, `issue_create`, `issue_tasks`, `task_create`, `hierarchy_tree`
+  - Bulk operations: `ticket_bulk_create`, `ticket_bulk_update`
+  - Advanced search: `ticket_search_hierarchy` with parent/child context
+  - Standard operations: `ticket_create`, `ticket_list`, `ticket_read`, `ticket_update`, `ticket_transition`, `ticket_search`
+  - Integration: `ticket_create_pr`, `ticket_status`
+- **Epic/Project → Issue → Task Hierarchy**: Complete 3-level hierarchy with validation
+  - Epics as top-level projects/milestones
+  - Issues as work items under epics
+  - Tasks as sub-items under issues with required parent_id
+  - Hierarchy tree visualization with depth control
+- **Ultra-Reliable Async System**: Production-grade reliability improvements
+  - Real-time health monitoring with immediate issue detection
+  - Auto-repair mechanisms for common failure scenarios
+  - Ticket ID persistence and recovery system
+  - Race condition prevention with atomic operations
+  - Queue health checks with worker heartbeat monitoring
+- **Comprehensive State Management**: All workflow states with validation
+  - Complete workflow: OPEN → IN_PROGRESS → READY → TESTED → DONE → CLOSED
+  - Blocked/Waiting states available at any transition point
+  - Bulk state transitions for multiple tickets
+  - State history tracking (adapter-dependent)
+- **Enhanced Comment System**: Full collaboration support
+  - Add/list comments with author tracking
+  - Comment threading and pagination
+  - Integration with all ticket types
+- **Advanced Search with Hierarchy**: Context-aware search functionality
+  - Search with parent/child relationship context
+  - Include/exclude hierarchy information in results
+  - Filter by epic, issue, or task relationships
+- **Comprehensive E2E Test Suite**: Production-ready testing
+  - Complete workflow tests from epic creation to closure
+  - Hierarchy validation and relationship testing
+  - All state transition coverage
+  - Concurrent operation and race condition testing
+  - Health monitoring and auto-repair verification
+
+### Enhanced
+- **Queue System Reliability**: Bulletproof async processing
+  - Worker auto-restart on failures
+  - Stuck item detection and reset (5-minute timeout)
+  - Health-based auto-repair with immediate user feedback
+  - Atomic queue operations preventing data corruption
+- **MCP Server Integration**: Enhanced AI agent compatibility
+  - All 18 tools properly exposed to MCP clients
+  - Comprehensive input validation and error handling
+  - Queue health integration for immediate failure detection
+- **CLI Health Monitoring**: Immediate system status feedback
+  - `mcp-ticketer health` command with auto-repair option
+  - Verbose health metrics and detailed diagnostics
+  - Pre-flight health checks before operations
+  - Auto-repair integration in create commands
+
+### Fixed
+- **Worker Process Registration**: Fixed adapter registration in worker subprocesses
+- **CLI Adapter Registration**: Fixed adapter availability in CLI commands
+- **Boolean Parameter Handling**: Fixed MCP tool schema boolean defaults
+- **Queue Processing Reliability**: Enhanced error handling and retry logic
+
 ## [0.1.26] - 2025-10-23
 
 ### Changed

{mcp_ticketer-0.1.26 → mcp_ticketer-0.1.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.1.26
+Version: 0.1.27
 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.1.26 → mcp_ticketer-0.1.27}/src/mcp_ticketer/__version__.py

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

{mcp_ticketer-0.1.26 → mcp_ticketer-0.1.27}/src/mcp_ticketer/adapters/hybrid.py

@@ -8,7 +8,7 @@ import builtins
 import json
 import logging
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any, Optional, Union
 
 from ..core.adapter import BaseAdapter
 from ..core.models import Comment, Epic, SearchQuery, Task, TicketState
@@ -153,7 +153,7 @@ class HybridAdapter(BaseAdapter):
 
         return f"hybrid-{uuid.uuid4().hex[:12]}"
 
-    async def create(self, ticket: Task | Epic) -> Task | Epic:
+    async def create(self, ticket: Union[Task, Epic]) -> Union[Task, Epic]:
         """Create ticket in all configured adapters.
 
         Args:
@@ -208,7 +208,7 @@ class HybridAdapter(BaseAdapter):
         return primary_ticket
 
     def _add_cross_references(
-        self, ticket: Task | Epic, results: list[tuple[str, Task | Epic]]
+        self, ticket: Union[Task, Epic], results: list[tuple[str, Union[Task, Epic]]]
     ) -> None:
         """Add cross-references to ticket description.
 
@@ -226,7 +226,7 @@ class HybridAdapter(BaseAdapter):
         else:
             ticket.description = cross_refs.strip()
 
-    async def read(self, ticket_id: str) -> Optional[Task | Epic]:
+    async def read(self, ticket_id: str) -> Optional[Union[Task, Epic]]:
         """Read ticket from primary adapter.
 
         Args:
@@ -255,7 +255,7 @@ class HybridAdapter(BaseAdapter):
 
     async def update(
         self, ticket_id: str, updates: dict[str, Any]
-    ) -> Optional[Task | Epic]:
+    ) -> Optional[Union[Task, Epic]]:
         """Update ticket across all adapters.
 
         Args:
@@ -360,7 +360,7 @@ class HybridAdapter(BaseAdapter):
 
     async def list(
         self, limit: int = 10, offset: int = 0, filters: Optional[dict[str, Any]] = None
-    ) -> list[Task | Epic]:
+    ) -> list[Union[Task, Epic]]:
         """List tickets from primary adapter.
 
         Args:
@@ -375,7 +375,7 @@ class HybridAdapter(BaseAdapter):
         primary = self.adapters[self.primary_adapter_name]
         return await primary.list(limit, offset, filters)
 
-    async def search(self, query: SearchQuery) -> builtins.list[Task | Epic]:
+    async def search(self, query: SearchQuery) -> builtins.list[Union[Task, Epic]]:
         """Search tickets in primary adapter.
 
         Args:
@@ -390,7 +390,7 @@ class HybridAdapter(BaseAdapter):
 
     async def transition_state(
         self, ticket_id: str, target_state: TicketState
-    ) -> Optional[Task | Epic]:
+    ) -> Optional[Union[Task, Epic]]:
         """Transition ticket state across all adapters.
 
         Args:

{mcp_ticketer-0.1.26 → mcp_ticketer-0.1.27}/src/mcp_ticketer/cli/main.py

@@ -16,6 +16,11 @@ from ..__version__ import __version__
 from ..core import AdapterRegistry, Priority, TicketState
 from ..core.models import SearchQuery
 from ..queue import Queue, QueueStatus, WorkerManager
+from ..queue.health_monitor import QueueHealthMonitor, HealthStatus
+from ..queue.ticket_registry import TicketRegistry
+
+# Import adapters module to trigger registration
+import mcp_ticketer.adapters  # noqa: F401
 from .configure import configure_wizard, set_adapter_config, show_current_config
 from .discover import app as discover_app
 from .migrate_config import migrate_config_command
@@ -791,6 +796,76 @@ def status_command():
             )
 
 
+@app.command()
+def health(
+    auto_repair: bool = typer.Option(False, "--auto-repair", help="Attempt automatic repair of issues"),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Show detailed health information")
+) -> None:
+    """Check queue system health and detect issues immediately."""
+
+    health_monitor = QueueHealthMonitor()
+    health = health_monitor.check_health()
+
+    # Display overall status
+    status_color = {
+        HealthStatus.HEALTHY: "green",
+        HealthStatus.WARNING: "yellow",
+        HealthStatus.CRITICAL: "red",
+        HealthStatus.FAILED: "red"
+    }
+
+    status_icon = {
+        HealthStatus.HEALTHY: "✓",
+        HealthStatus.WARNING: "⚠️",
+        HealthStatus.CRITICAL: "🚨",
+        HealthStatus.FAILED: "❌"
+    }
+
+    color = status_color.get(health["status"], "white")
+    icon = status_icon.get(health["status"], "?")
+
+    console.print(f"[{color}]{icon} Queue Health: {health['status'].upper()}[/{color}]")
+    console.print(f"Last checked: {health['timestamp']}")
+
+    # Display alerts
+    if health["alerts"]:
+        console.print("\n[bold]Issues Found:[/bold]")
+        for alert in health["alerts"]:
+            alert_color = status_color.get(alert["level"], "white")
+            console.print(f"[{alert_color}]  • {alert['message']}[/{alert_color}]")
+
+            if verbose and alert.get("details"):
+                for key, value in alert["details"].items():
+                    console.print(f"    {key}: {value}")
+    else:
+        console.print("\n[green]✓ No issues detected[/green]")
+
+    # Auto-repair if requested
+    if auto_repair and health["status"] in [HealthStatus.CRITICAL, HealthStatus.WARNING]:
+        console.print("\n[yellow]Attempting automatic repair...[/yellow]")
+        repair_result = health_monitor.auto_repair()
+
+        if repair_result["actions_taken"]:
+            console.print("[green]Repair actions taken:[/green]")
+            for action in repair_result["actions_taken"]:
+                console.print(f"[green]  ✓ {action}[/green]")
+
+            # Re-check health
+            console.print("\n[yellow]Re-checking health after repair...[/yellow]")
+            new_health = health_monitor.check_health()
+            new_color = status_color.get(new_health["status"], "white")
+            new_icon = status_icon.get(new_health["status"], "?")
+            console.print(f"[{new_color}]{new_icon} Updated Health: {new_health['status'].upper()}[/{new_color}]")
+        else:
+            console.print("[yellow]No repair actions available[/yellow]")
+
+    # Exit with appropriate code
+    if health["status"] == HealthStatus.CRITICAL:
+        raise typer.Exit(1)
+    elif health["status"] == HealthStatus.WARNING:
+        raise typer.Exit(2)
+
+
 @app.command()
 def create(
     title: str = typer.Argument(..., help="Ticket title"),
@@ -810,7 +885,46 @@ def create(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
-    """Create a new ticket."""
+    """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
     config = load_config()
     adapter_name = (
@@ -832,16 +946,44 @@ def create(
         ticket_data=task_data, adapter=adapter_name, operation="create"
     )
 
+    # 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("[dim]Use 'mcp-ticketer status {queue_id}' to check progress[/dim]")
+    console.print(f"  Adapter: {adapter_name}")
+    console.print("[dim]Use 'mcp-ticketer check {queue_id}' to check progress[/dim]")
 
-    # Start worker if needed
+    # Start worker if needed with immediate feedback
     manager = WorkerManager()
-    if manager.start_if_needed():
+    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 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(