mcp-ticketer 0.1.16__py3-none-any.whl → 0.1.17__py3-none-any.whl

mcp_ticketer/__version__.py

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

mcp_ticketer/adapters/aitrackdown.py

@@ -40,6 +40,20 @@ class AITrackdownAdapter(BaseAdapter[Task]):
             self.tracker = None
             self.tickets_dir.mkdir(parents=True, exist_ok=True)
 
+    def validate_credentials(self) -> tuple[bool, str]:
+        """Validate that required credentials are present.
+
+        AITrackdown is file-based and doesn't require credentials.
+
+        Returns:
+            (is_valid, error_message) - Always returns (True, "") for AITrackdown
+        """
+        # AITrackdown is file-based and doesn't require API credentials
+        # Just verify the base_path is accessible
+        if not self.base_path:
+            return False, "AITrackdown base_path is required in configuration"
+        return True, ""
+
     def _get_state_mapping(self) -> Dict[TicketState, str]:
         """Map universal states to AI-Trackdown states."""
         return {

mcp_ticketer/adapters/github.py

@@ -191,6 +191,20 @@ class GitHubAdapter(BaseAdapter[Task]):
         self._milestones_cache: Optional[List[Dict[str, Any]]] = None
         self._rate_limit: Dict[str, Any] = {}
 
+    def validate_credentials(self) -> tuple[bool, str]:
+        """Validate that required credentials are present.
+
+        Returns:
+            (is_valid, error_message) - Tuple of validation result and error message
+        """
+        if not self.token:
+            return False, "GITHUB_TOKEN is required but not found. Set it in .env.local or environment."
+        if not self.owner:
+            return False, "GitHub owner is required in configuration. Set GITHUB_OWNER in .env.local or configure with 'mcp-ticketer init --adapter github --github-owner <owner>'"
+        if not self.repo:
+            return False, "GitHub repo is required in configuration. Set GITHUB_REPO in .env.local or configure with 'mcp-ticketer init --adapter github --github-repo <repo>'"
+        return True, ""
+
     def _get_state_mapping(self) -> Dict[TicketState, str]:
         """Map universal states to GitHub states."""
         return {
@@ -379,6 +393,11 @@ class GitHubAdapter(BaseAdapter[Task]):
 
     async def create(self, ticket: Task) -> Task:
         """Create a new GitHub issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         # Prepare labels
         labels = ticket.tags.copy() if ticket.tags else []
 
@@ -448,6 +467,11 @@ class GitHubAdapter(BaseAdapter[Task]):
 
     async def read(self, ticket_id: str) -> Optional[Task]:
         """Read a GitHub issue by number."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         try:
             issue_number = int(ticket_id)
         except ValueError:
@@ -468,6 +492,11 @@ class GitHubAdapter(BaseAdapter[Task]):
 
     async def update(self, ticket_id: str, updates: Dict[str, Any]) -> Optional[Task]:
         """Update a GitHub issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         try:
             issue_number = int(ticket_id)
         except ValueError:
@@ -584,6 +613,11 @@ class GitHubAdapter(BaseAdapter[Task]):
 
     async def delete(self, ticket_id: str) -> bool:
         """Delete (close) a GitHub issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         try:
             issue_number = int(ticket_id)
         except ValueError:

mcp_ticketer/adapters/jira.py

@@ -89,6 +89,20 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         self._issue_types_cache: Dict[str, Any] = {}
         self._custom_fields_cache: Dict[str, Any] = {}
 
+    def validate_credentials(self) -> tuple[bool, str]:
+        """Validate that required credentials are present.
+
+        Returns:
+            (is_valid, error_message) - Tuple of validation result and error message
+        """
+        if not self.server:
+            return False, "JIRA_SERVER is required but not found. Set it in .env.local or environment."
+        if not self.email:
+            return False, "JIRA_EMAIL is required but not found. Set it in .env.local or environment."
+        if not self.api_token:
+            return False, "JIRA_API_TOKEN is required but not found. Set it in .env.local or environment."
+        return True, ""
+
     def _get_state_mapping(self) -> Dict[TicketState, str]:
         """Map universal states to common JIRA workflow states."""
         return {
@@ -457,6 +471,11 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def create(self, ticket: Union[Epic, Task]) -> Union[Epic, Task]:
         """Create a new JIRA issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         # Prepare issue fields
         fields = self._ticket_to_issue_fields(ticket)
 
@@ -476,6 +495,11 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def read(self, ticket_id: str) -> Optional[Union[Epic, Task]]:
         """Read a JIRA issue by key."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         try:
             issue = await self._make_request(
                 "GET",
@@ -494,6 +518,11 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         updates: Dict[str, Any]
     ) -> Optional[Union[Epic, Task]]:
         """Update a JIRA issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         # Read current issue
         current = await self.read(ticket_id)
         if not current:
@@ -530,6 +559,11 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
 
     async def delete(self, ticket_id: str) -> bool:
         """Delete a JIRA issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         try:
             await self._make_request("DELETE", f"issue/{ticket_id}")
             return True

mcp_ticketer/adapters/linear.py

@@ -520,6 +520,18 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return None
 
+    def validate_credentials(self) -> tuple[bool, str]:
+        """Validate that required credentials are present.
+
+        Returns:
+            (is_valid, error_message) - Tuple of validation result and error message
+        """
+        if not self.api_key:
+            return False, "LINEAR_API_KEY is required but not found. Set it in .env.local or environment."
+        if not self.team_key:
+            return False, "Linear team_key is required in configuration. Set it in .mcp-ticketer/config.json"
+        return True, ""
+
     def _get_state_mapping(self) -> Dict[TicketState, str]:
         """Get mapping from universal states to Linear state types.
 
@@ -711,6 +723,11 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def create(self, ticket: Task) -> Task:
         """Create a new Linear issue with full field support."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         team_id = await self._ensure_team_id()
         states = await self._get_workflow_states()
 
@@ -821,6 +838,11 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def read(self, ticket_id: str) -> Optional[Task]:
         """Read a Linear issue by identifier with full details."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         query = gql(ALL_FRAGMENTS + """
             query GetIssue($identifier: String!) {
                 issue(id: $identifier) {
@@ -846,6 +868,11 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def update(self, ticket_id: str, updates: Dict[str, Any]) -> Optional[Task]:
         """Update a Linear issue with comprehensive field support."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         # First get the Linear internal ID
         query = gql("""
             query GetIssueId($identifier: String!) {
@@ -944,6 +971,11 @@ class LinearAdapter(BaseAdapter[Task]):
 
     async def delete(self, ticket_id: str) -> bool:
         """Archive (soft delete) a Linear issue."""
+        # Validate credentials before attempting operation
+        is_valid, error_message = self.validate_credentials()
+        if not is_valid:
+            raise ValueError(error_message)
+
         # Get Linear ID
         query = gql("""
             query GetIssueId($identifier: String!) {

mcp_ticketer/core/adapter.py

@@ -29,6 +29,15 @@ class BaseAdapter(ABC, Generic[T]):
         """
         pass
 
+    @abstractmethod
+    def validate_credentials(self) -> tuple[bool, str]:
+        """Validate that required credentials are present.
+
+        Returns:
+            (is_valid, error_message) - Tuple of validation result and error message
+        """
+        pass
+
     @abstractmethod
     async def create(self, ticket: T) -> T:
         """Create a new ticket.

mcp_ticketer/mcp/server.py

@@ -4,12 +4,31 @@ import asyncio
 import json
 import sys
 from typing import Any, Dict, List, Optional
+from pathlib import Path
+from dotenv import load_dotenv
 
 from ..core import Task, TicketState, Priority, AdapterRegistry
 from ..core.models import SearchQuery, Comment
 from ..adapters import AITrackdownAdapter
 from ..queue import Queue, QueueStatus, WorkerManager
 
+# Load environment variables early (prioritize .env.local)
+# Check for .env.local first (takes precedence)
+env_local_file = Path.cwd() / ".env.local"
+if env_local_file.exists():
+    load_dotenv(env_local_file, override=True)
+    sys.stderr.write(f"[MCP Server] Loaded environment from: {env_local_file}\n")
+else:
+    # Fall back to .env
+    env_file = Path.cwd() / ".env"
+    if env_file.exists():
+        load_dotenv(env_file, override=True)
+        sys.stderr.write(f"[MCP Server] Loaded environment from: {env_file}\n")
+    else:
+        # Try default dotenv loading (searches upward)
+        load_dotenv(override=True)
+        sys.stderr.write("[MCP Server] Loaded environment from default search path\n")
+
 
 class MCPTicketServer:
     """MCP server for ticket operations over stdio."""

{mcp_ticketer-0.1.16.dist-info → mcp_ticketer-0.1.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.1.16
+Version: 0.1.17
 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.16.dist-info → mcp_ticketer-0.1.17.dist-info}/RECORD

@@ -1,12 +1,12 @@
 mcp_ticketer/__init__.py,sha256=ayPQdFr6msypD06_G96a1H0bdFCT1m1wDtv8MZBpY4I,496
-mcp_ticketer/__version__.py,sha256=VU-W9BGb5-hfF3jvOPn-c-W8RnOMrAL8rswIa9JjVSE,1115
+mcp_ticketer/__version__.py,sha256=WgT2pB0LHF_awU8L3zAq7pQyDkXi1wLI6eY0gHjmjUw,1115
 mcp_ticketer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_ticketer/adapters/__init__.py,sha256=K_1egvhHb5F_7yFceUx2YzPGEoc7vX-q8dMVaS4K6gw,356
-mcp_ticketer/adapters/aitrackdown.py,sha256=gqS_N6VGLoG5itUu17ANG5SefaAITYoW-t2xL9SrY-Y,15372
-mcp_ticketer/adapters/github.py,sha256=onT8NhYaf9fIw2eCOTbZSkk7q4IoM7ZADRvRl9qrUz8,43850
+mcp_ticketer/adapters/aitrackdown.py,sha256=916SpzQcG6gSdQit5Ptm9AdGOsZFXpt9nNWlRjCReMY,15924
+mcp_ticketer/adapters/github.py,sha256=NdUPaSlOEi4zZN_VBvAjSJANJhp1IBwdOkkF6fGbaKs,45410
 mcp_ticketer/adapters/hybrid.py,sha256=H9B-pfWmDKXO3GgzxB8undEcZTMzLz_1a6zWhj7xfR0,18556
-mcp_ticketer/adapters/jira.py,sha256=rd-8PseTsRyQNPjsrUJ8vJ8vfBpa6HWFBieOUyvw0Tg,28954
-mcp_ticketer/adapters/linear.py,sha256=BUK40EF4yNVJV5ldJPFx7Ne4FXHYbrGCUAaFy2gWC9Y,65211
+mcp_ticketer/adapters/jira.py,sha256=jxoQS22wjOl1FhsYiGK-r1pLXOenUmbe5wa0ehD6xDg,30373
+mcp_ticketer/adapters/linear.py,sha256=VmZ9UI5cDvbsiFgWEopnUTwWGcHZDeGtsTSnR_Z5_BA,66506
 mcp_ticketer/cache/__init__.py,sha256=MSi3GLXancfP2-edPC9TFAJk7r0j6H5-XmpMHnkGPbI,137
 mcp_ticketer/cache/memory.py,sha256=gTzv-xF7qGfiYVUjG7lnzo0ZcqgXQajMl4NAYUcaytg,5133
 mcp_ticketer/cli/__init__.py,sha256=YeljyLtv906TqkvRuEPhmKO-Uk0CberQ9I6kx1tx2UA,88
@@ -18,7 +18,7 @@ mcp_ticketer/cli/migrate_config.py,sha256=iZIstnlr9vkhiW_MlnSyJOkMi4KHQqrZ6Hz1EC
 mcp_ticketer/cli/queue_commands.py,sha256=f3pEHKZ43dBHEIoCBvdfvjfMB9_WJltps9ATwTzorY0,8160
 mcp_ticketer/cli/utils.py,sha256=cdP-7GHtELAPZtqInUC24k_SAnRbIRkafIP3T4kMZDM,19509
 mcp_ticketer/core/__init__.py,sha256=qpCZveQMyqU2JvYG9MG_c6X35z_VoSmjWdXGcUZqqmA,348
-mcp_ticketer/core/adapter.py,sha256=6KfhceINHfDjs--RyA_rOLeM2phVD_D85S9D6s2lcuU,10075
+mcp_ticketer/core/adapter.py,sha256=W87W-hEmgCxw5BkvaFlCGZtouN49aW2KHND53zgg6-c,10339
 mcp_ticketer/core/config.py,sha256=9a2bksbcFr7KXeHSPY6KoSP5Pzt54utYPCmbM-1QKmk,13932
 mcp_ticketer/core/env_discovery.py,sha256=SPoyq_y5j-3gJG5gYNVjCIIrbdzimOdDbTYySmQWZOA,17536
 mcp_ticketer/core/http_client.py,sha256=RM9CEMNcuRb-FxhAijmM_FeBMgxgh1OII9HIPBdJue0,13855
@@ -27,16 +27,16 @@ mcp_ticketer/core/models.py,sha256=GhuTitY6t_QlqfEUvWT6Q2zvY7qAtx_SQyCMMn8iYkk,6
 mcp_ticketer/core/project_config.py,sha256=VVSeCwuESuemL-iC4fqbPrJxR4i5k5fhUpujnY7MCZA,22389
 mcp_ticketer/core/registry.py,sha256=fwje0fnjp0YKPZ0SrVWk82SMNLs7CD0JlHQmx7SigNo,3537
 mcp_ticketer/mcp/__init__.py,sha256=Bvzof9vBu6VwcXcIZK8RgKv6ycRV9tDlO-9TUmd8zqQ,122
-mcp_ticketer/mcp/server.py,sha256=TDuU8ChZC2QYSRo0uGHkVReblTf--hriOjxo-pSAF_Y,34068
+mcp_ticketer/mcp/server.py,sha256=CC1iaeugUbiVrNvNgOgm2mRb4AW-5e0X2ygLjH8I6mM,34835
 mcp_ticketer/queue/__init__.py,sha256=xHBoUwor8ZdO8bIHc7nP25EsAp5Si5Co4g_8ybb7fes,230
 mcp_ticketer/queue/__main__.py,sha256=kQd6iOCKbbFqpRdbIRavuI4_G7-oE898JE4a0yLEYPE,108
 mcp_ticketer/queue/manager.py,sha256=79AH9oUxdBXH3lmJ3kIlFf2GQkWHL6XB6u5JqVWPq60,7571
 mcp_ticketer/queue/queue.py,sha256=z4aivQCtsH5_OUr2OfXSfnFKzugTahNnwHw0LS3ZhZc,11549
 mcp_ticketer/queue/run_worker.py,sha256=HFoykfDpOoz8OUxWbQ2Fka_UlGrYwjPVZ-DEimGFH9o,802
 mcp_ticketer/queue/worker.py,sha256=cVjHR_kfnGKAkiUg0HuXCnbKeKNBBEuj0XZHgIuIn4k,14017
-mcp_ticketer-0.1.16.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
-mcp_ticketer-0.1.16.dist-info/METADATA,sha256=2Fa_rzfQvRRW-6e52xz_umAJlztAjQn1DMSQaTzcTEE,11211
-mcp_ticketer-0.1.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_ticketer-0.1.16.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
-mcp_ticketer-0.1.16.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
-mcp_ticketer-0.1.16.dist-info/RECORD,,
+mcp_ticketer-0.1.17.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.1.17.dist-info/METADATA,sha256=Mcy0c4cYLlswlEJbYolMAdS4shFf27maFmydb2LtnaA,11211
+mcp_ticketer-0.1.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.1.17.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
+mcp_ticketer-0.1.17.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.1.17.dist-info/RECORD,,