mcp-ticketer 0.3.7__tar.gz → 0.4.0__tar.gz

mcp_ticketer-0.4.0/CLAUDE.md

@@ -0,0 +1,49 @@
+# Project Memory Configuration
+
+This project uses KuzuMemory for intelligent context management.
+
+## Project Information
+- **Path**: /Users/masa/Projects/mcp-ticketer
+- **Language**: Python
+- **Framework**: Unknown
+
+## Memory Integration
+
+KuzuMemory is configured to enhance all AI interactions with project-specific context.
+
+### Available Commands:
+- `kuzu-memory enhance <prompt>` - Enhance prompts with project context
+- `kuzu-memory learn <content>` - Store learning from conversations (async)
+- `kuzu-memory recall <query>` - Query project memories
+- `kuzu-memory stats` - View memory statistics
+
+### MCP Tools Available:
+When interacting with Claude Desktop, the following MCP tools are available:
+- **kuzu_enhance**: Enhance prompts with project memories
+- **kuzu_learn**: Store new learnings asynchronously
+- **kuzu_recall**: Query specific memories
+- **kuzu_stats**: Get memory system statistics
+
+## Project Context
+
+Universal ticket management interface for AI agents with MCP support
+
+## Key Technologies
+- Python
+
+## Development Guidelines
+- Use kuzu-memory enhance for all AI interactions
+- Store important decisions with kuzu-memory learn
+- Query context with kuzu-memory recall when needed
+- Keep memories project-specific and relevant
+
+## Memory Guidelines
+
+- Store project decisions and conventions
+- Record technical specifications and API details
+- Capture user preferences and patterns
+- Document error solutions and workarounds
+
+---
+
+*Generated by KuzuMemory Claude Hooks Installer*

mcp_ticketer-0.4.0/CLI_RESTRUCTURING_SUMMARY.md

@@ -0,0 +1,272 @@
+# CLI Restructuring Summary
+
+## Overview
+
+The MCP Ticketer CLI has been restructured to follow the kuzu-memory pattern, with a clear hierarchy of commands organized into logical groups. This restructuring improves discoverability, reduces clutter at the top level, and provides a more intuitive user experience.
+
+## New Command Structure
+
+```
+mcp-ticketer
+│
+├── Top-Level Commands (System Management)
+│   ├── init                    # Initialize/setup project
+│   ├── setup                   # Alias for init
+│   ├── install                 # Alias for init
+│   ├── status (alias: health)  # Quick health check
+│   ├── health (alias: status)  # Quick health check
+│   ├── doctor (alias: diagnose) # Comprehensive diagnostics
+│   ├── diagnose (alias: doctor) # Comprehensive diagnostics
+│   ├── configure               # Configuration wizard
+│   ├── set                     # Set adapter configuration
+│   ├── migrate-config          # Migrate config format
+│   └── serve                   # Start MCP server
+│
+├── ticket                      # Ticket operations (NEW GROUP)
+│   ├── create                  # Create ticket
+│   ├── list                    # List tickets
+│   ├── show                    # Show ticket details
+│   ├── update                  # Update ticket
+│   ├── transition              # Change ticket state
+│   ├── search                  # Search tickets
+│   ├── comment                 # Add comment
+│   └── check                   # Check queued operation
+│
+├── mcp                         # MCP client configuration
+│   ├── claude                  # Configure Claude Code/Desktop
+│   ├── gemini                  # Configure Gemini CLI
+│   ├── codex                   # Configure Codex CLI
+│   └── auggie                  # Configure Auggie CLI
+│
+├── platform                    # Platform-specific commands (NEW GROUP)
+│   ├── linear
+│   │   ├── workspaces          # List workspaces
+│   │   ├── teams               # List teams
+│   │   ├── configure           # Configure Linear adapter
+│   │   └── info                # Show team info
+│   ├── jira                    # Placeholder for future
+│   │   ├── projects            # (Placeholder)
+│   │   └── configure           # (Placeholder)
+│   ├── github                  # Placeholder for future
+│   │   ├── repos               # (Placeholder)
+│   │   └── configure           # (Placeholder)
+│   └── aitrackdown             # Placeholder for future
+│       ├── info                # (Placeholder)
+│       └── configure           # (Placeholder)
+│
+├── queue                       # Queue management
+│   └── worker
+│       ├── start
+│       ├── stop
+│       ├── status
+│       └── restart
+│
+└── discover                    # Environment discovery
+    └── ...
+```
+
+## Key Changes
+
+### 1. New Command Groups
+
+#### `ticket` Group
+All ticket-related operations have been consolidated under the `ticket` command group:
+
+**Before:**
+```bash
+mcp-ticketer create "My ticket"
+mcp-ticketer list
+mcp-ticketer show TICKET-123
+```
+
+**After:**
+```bash
+mcp-ticketer ticket create "My ticket"
+mcp-ticketer ticket list
+mcp-ticketer ticket show TICKET-123
+```
+
+#### `platform` Group
+Platform-specific commands are now organized under the `platform` group:
+
+**Before:**
+```bash
+mcp-ticketer linear teams
+mcp-ticketer linear configure --team-id ABC123
+```
+
+**After:**
+```bash
+mcp-ticketer platform linear teams
+mcp-ticketer platform linear configure --team-id ABC123
+```
+
+### 2. Command Aliases
+
+The following command aliases have been added for convenience:
+
+- `status` ↔ `health` - System health check
+- `diagnose` ↔ `doctor` - Comprehensive diagnostics
+
+**Examples:**
+```bash
+mcp-ticketer status       # Same as: mcp-ticketer health
+mcp-ticketer doctor       # Same as: mcp-ticketer diagnose
+```
+
+### 3. Backward Compatibility
+
+All old top-level ticket commands are still available but are marked as **deprecated** and **hidden**. When used, they will display a deprecation warning and redirect users to the new command structure:
+
+```bash
+$ mcp-ticketer create "My ticket"
+⚠️  This command is deprecated. Use 'mcp-ticketer ticket create' instead.
+```
+
+The deprecated commands include:
+- `create` → `ticket create`
+- `list` → `ticket list`
+- `show` → `ticket show`
+- `update` → `ticket update`
+- `transition` → `ticket transition`
+- `search` → `ticket search`
+- `comment` → `ticket comment`
+- `check` → `ticket check`
+
+### 4. Platform Placeholders
+
+Placeholder command groups have been added for future platform integrations:
+- **JIRA** - `mcp-ticketer platform jira`
+- **GitHub** - `mcp-ticketer platform github`
+- **AITrackdown** - `mcp-ticketer platform aitrackdown`
+
+These placeholders provide helpful messages directing users to use the generic ticket commands until platform-specific features are implemented.
+
+## File Changes
+
+### New Files Created
+
+1. **`src/mcp_ticketer/cli/ticket_commands.py`**
+   - Contains all ticket management commands
+   - Includes configuration functions (load_config, save_config, get_adapter)
+   - Self-contained to avoid circular imports
+
+2. **`src/mcp_ticketer/cli/platform_commands.py`**
+   - Platform command group orchestration
+   - Imports and registers Linear commands
+   - Placeholder apps for JIRA, GitHub, and AITrackdown
+
+### Modified Files
+
+1. **`src/mcp_ticketer/cli/main.py`**
+   - Added imports for new command groups
+   - Registered `ticket` and `platform` command groups
+   - Deprecated old top-level ticket commands
+   - Added command aliases (status/health, diagnose/doctor)
+   - Removed direct `linear_app` registration (now under platform)
+
+2. **`src/mcp_ticketer/cli/linear_commands.py`**
+   - No changes required (works as-is under platform group)
+
+## Migration Guide
+
+### For End Users
+
+#### Updating Scripts
+If you have scripts using the old commands, they will continue to work but will show deprecation warnings. Update them to use the new structure:
+
+**Old scripts:**
+```bash
+#!/bin/bash
+mcp-ticketer create "Bug in login"
+mcp-ticketer list --state todo
+mcp-ticketer linear teams
+```
+
+**Updated scripts:**
+```bash
+#!/bin/bash
+mcp-ticketer ticket create "Bug in login"
+mcp-ticketer ticket list --state todo
+mcp-ticketer platform linear teams
+```
+
+#### Using Aliases
+Take advantage of the new aliases for brevity:
+
+```bash
+# Instead of: mcp-ticketer diagnose
+mcp-ticketer doctor
+
+# Instead of: mcp-ticketer health
+mcp-ticketer status
+```
+
+### For Developers
+
+#### Adding New Platform Commands
+
+To add commands for a new platform (e.g., JIRA), follow this pattern:
+
+1. Create the command module (e.g., `jira_commands.py`)
+2. Import it in `platform_commands.py`
+3. Replace the placeholder app with your real implementation
+
+**Example:**
+```python
+# In src/mcp_ticketer/cli/jira_commands.py
+import typer
+
+app = typer.Typer(name="jira", help="JIRA workspace and project management")
+
+@app.command("projects")
+def list_projects():
+    """List JIRA projects."""
+    # Implementation here
+    pass
+
+# In src/mcp_ticketer/cli/platform_commands.py
+from .jira_commands import app as jira_app
+
+# Replace the placeholder:
+# jira_app = typer.Typer(...)  # OLD
+# with:
+# from .jira_commands import app as jira_app  # NEW
+```
+
+## Testing
+
+All new command structures have been tested and verified:
+
+✅ `mcp-ticketer --help` - Shows new command groups
+✅ `mcp-ticketer ticket --help` - Shows ticket subcommands
+✅ `mcp-ticketer platform --help` - Shows platform groups
+✅ `mcp-ticketer platform linear --help` - Shows Linear commands
+✅ `mcp-ticketer status` / `mcp-ticketer health` - Aliases work
+✅ `mcp-ticketer doctor` / `mcp-ticketer diagnose` - Aliases work
+✅ Old commands show deprecation warnings
+
+## Benefits
+
+1. **Better Organization** - Commands are logically grouped by function
+2. **Cleaner Top Level** - Reduced clutter at the main help level
+3. **Improved Discoverability** - Users can explore commands by category
+4. **Future-Proof** - Easy to add new platforms without polluting the top level
+5. **Backward Compatible** - Existing scripts continue to work (with warnings)
+6. **Consistent Pattern** - Follows established CLI patterns (kuzu-memory style)
+7. **Alias Convenience** - Common operations have intuitive aliases
+
+## Next Steps
+
+1. ✅ Implement restructuring
+2. ✅ Add deprecation warnings
+3. ✅ Test all command paths
+4. 📝 Update documentation (in progress)
+5. 🔄 Deprecation cycle (6-12 months before removing old commands)
+6. 🚀 Implement platform-specific commands for JIRA and GitHub
+
+---
+
+**Version:** 1.0.0
+**Date:** October 26, 2025
+**Author:** Generated via Claude Code MPM

{mcp_ticketer-0.3.7/src/mcp_ticketer.egg-info → mcp_ticketer-0.4.0}/PKG-INFO

@@ -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 → mcp_ticketer-0.4.0}/pyproject.toml

@@ -151,7 +151,7 @@ extend-exclude = '''
 '''
 
 [tool.ruff]
-target-version = "py39"
+target-version = "0.4.0"
 line-length = 88
 
 [tool.ruff.lint]

{mcp_ticketer-0.3.7 → mcp_ticketer-0.4.0}/src/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-0.3.7 → mcp_ticketer-0.4.0}/src/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")