mcp-ticketer 0.3.3__py3-none-any.whl → 0.3.4__py3-none-any.whl

mcp_ticketer/__version__.py

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

mcp_ticketer/adapters/linear/adapter.py

@@ -137,8 +137,9 @@ class LinearAdapter(BaseAdapter[Task]):
             # Load team data and workflow states concurrently
             team_id = await self._ensure_team_id()
 
-            # Load workflow states for the team
+            # Load workflow states and labels for the team
             await self._load_workflow_states(team_id)
+            await self._load_team_labels(team_id)
 
             self._initialized = True
 
@@ -216,6 +217,85 @@ class LinearAdapter(BaseAdapter[Task]):
         except Exception as e:
             raise ValueError(f"Failed to load workflow states: {e}")
 
+    async def _load_team_labels(self, team_id: str) -> None:
+        """Load and cache labels for the team.
+
+        Args:
+            team_id: Linear team ID
+
+        """
+        query = """
+            query GetTeamLabels($teamId: ID!) {
+                team(id: $teamId) {
+                    labels {
+                        nodes {
+                            id
+                            name
+                            color
+                            description
+                        }
+                    }
+                }
+            }
+        """
+
+        try:
+            result = await self.client.execute_query(query, {"teamId": team_id})
+            self._labels_cache = result["team"]["labels"]["nodes"]
+        except Exception:
+            # Log error but don't fail - labels are optional
+            self._labels_cache = []
+
+    async def _resolve_label_ids(self, label_names: list[str]) -> list[str]:
+        """Resolve label names to Linear label IDs.
+
+        Args:
+            label_names: List of label names
+
+        Returns:
+            List of Linear label IDs that exist
+
+        """
+        import logging
+
+        logger = logging.getLogger(__name__)
+
+        if not self._labels_cache:
+            team_id = await self._ensure_team_id()
+            await self._load_team_labels(team_id)
+
+        if not self._labels_cache:
+            logger.warning("No labels found in team cache")
+            return []
+
+        # Create name -> ID mapping (case-insensitive)
+        label_map = {label["name"].lower(): label["id"] for label in self._labels_cache}
+
+        logger.debug(f"Available labels in team: {list(label_map.keys())}")
+
+        # Resolve label names to IDs
+        label_ids = []
+        unmatched_labels = []
+
+        for name in label_names:
+            label_id = label_map.get(name.lower())
+            if label_id:
+                label_ids.append(label_id)
+                logger.debug(f"Resolved label '{name}' to ID: {label_id}")
+            else:
+                unmatched_labels.append(name)
+                logger.warning(
+                    f"Label '{name}' not found in team. Available labels: {list(label_map.keys())}"
+                )
+
+        if unmatched_labels:
+            logger.warning(
+                f"Could not resolve labels: {unmatched_labels}. "
+                f"Create them in Linear first or check spelling."
+            )
+
+        return label_ids
+
     def _get_state_mapping(self) -> dict[TicketState, str]:
         """Get mapping from universal states to Linear workflow state IDs.
 
@@ -311,12 +391,28 @@ class LinearAdapter(BaseAdapter[Task]):
         # Build issue input using mapper
         issue_input = build_linear_issue_input(task, team_id)
 
+        # Set default state if not provided
+        # Map OPEN to "unstarted" state (typically "To-Do" in Linear)
+        if task.state == TicketState.OPEN and self._workflow_states:
+            state_mapping = self._get_state_mapping()
+            if TicketState.OPEN in state_mapping:
+                issue_input["stateId"] = state_mapping[TicketState.OPEN]
+
         # Resolve assignee to user ID if provided
         if task.assignee:
             user_id = await self._get_user_id(task.assignee)
             if user_id:
                 issue_input["assigneeId"] = user_id
 
+        # Resolve label names to IDs if provided
+        if task.tags:
+            label_ids = await self._resolve_label_ids(task.tags)
+            if label_ids:
+                issue_input["labelIds"] = label_ids
+            else:
+                # Remove labelIds if no labels resolved
+                issue_input.pop("labelIds", None)
+
         try:
             result = await self.client.execute_mutation(
                 CREATE_ISSUE_MUTATION, {"input": issue_input}
@@ -489,6 +585,12 @@ class LinearAdapter(BaseAdapter[Task]):
                 if user_id:
                     update_input["assigneeId"] = user_id
 
+            # Resolve label names to IDs if provided
+            if "tags" in updates and updates["tags"]:
+                label_ids = await self._resolve_label_ids(updates["tags"])
+                if label_ids:
+                    update_input["labelIds"] = label_ids
+
             # Execute update
             result = await self.client.execute_mutation(
                 UPDATE_ISSUE_MUTATION, {"id": linear_id, "input": update_input}

mcp_ticketer/adapters/linear/mappers.py

@@ -242,9 +242,8 @@ def build_linear_issue_input(task: Task, team_id: str) -> dict[str, Any]:
 
     # Add labels (tags) if provided
     if task.tags:
-        # Note: Linear requires label IDs, not names
-        # This would need to be resolved by the adapter
-        pass
+        # Note: This returns label names, will be resolved to IDs by adapter
+        issue_input["labelIds"] = task.tags  # Temporary - adapter will resolve
 
     # Add Linear-specific metadata
     if task.metadata and "linear" in task.metadata:

mcp_ticketer/cli/main.py

@@ -1266,6 +1266,16 @@ def create(
     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"
     ),
@@ -1337,6 +1347,9 @@ def create(
                 # 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
@@ -1347,6 +1360,7 @@ def create(
         "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
@@ -1377,6 +1391,7 @@ def create(
                 ),
                 tags=task_data.get("tags", []),
                 assignee=task_data.get("assignee"),
+                parent_epic=task_data.get("parent_epic"),
             )
 
             # Create ticket synchronously

mcp_ticketer/core/models.py

@@ -260,13 +260,21 @@ class Epic(BaseTicket):
 
 
 class Task(BaseTicket):
-    """Task - individual work item (can be ISSUE or TASK type)."""
+    """Task - individual work item (can be ISSUE or TASK type).
+
+    Note: The `project` field is a synonym for `parent_epic` to provide
+    flexibility in CLI and API usage. Both fields map to the same underlying
+    value (the parent epic/project ID).
+    """
 
     ticket_type: TicketType = Field(
         default=TicketType.ISSUE, description="Ticket type in hierarchy"
     )
     parent_issue: Optional[str] = Field(None, description="Parent issue ID (for tasks)")
-    parent_epic: Optional[str] = Field(None, description="Parent epic ID (for issues)")
+    parent_epic: Optional[str] = Field(
+        None,
+        description="Parent epic/project ID (for issues). Synonym: 'project'",
+    )
     assignee: Optional[str] = Field(None, description="Assigned user")
     children: list[str] = Field(default_factory=list, description="Child task IDs")
 
@@ -274,6 +282,26 @@ class Task(BaseTicket):
     estimated_hours: Optional[float] = Field(None, description="Time estimate")
     actual_hours: Optional[float] = Field(None, description="Actual time spent")
 
+    @property
+    def project(self) -> Optional[str]:
+        """Synonym for parent_epic.
+
+        Returns:
+            Parent epic/project ID
+
+        """
+        return self.parent_epic
+
+    @project.setter
+    def project(self, value: Optional[str]) -> None:
+        """Set parent_epic via project synonym.
+
+        Args:
+            value: Parent epic/project ID
+
+        """
+        self.parent_epic = value
+
     def is_epic(self) -> bool:
         """Check if this is an epic (should use Epic class instead)."""
         return self.ticket_type == TicketType.EPIC

{mcp_ticketer-0.3.3.dist-info → mcp_ticketer-0.3.4.dist-info}/METADATA

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

@@ -1,5 +1,5 @@
 mcp_ticketer/__init__.py,sha256=Xx4WaprO5PXhVPbYi1L6tBmwmJMkYS-lMyG4ieN6QP0,717
-mcp_ticketer/__version__.py,sha256=j309F4mrlZqf8FcC91dNHQzvReN2SW3ubVrcqvAI7YY,1117
+mcp_ticketer/__version__.py,sha256=XrTye_cA_opF1wX2csBbZnPCpEQ57tGLh94P_i6prws,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
@@ -8,9 +8,9 @@ mcp_ticketer/adapters/hybrid.py,sha256=UADYZLc_UNw0xHPSbgguBNzvUCnuYn12Qi9ea-zdl
 mcp_ticketer/adapters/jira.py,sha256=labZFqOy_mmMmizC-RD1EQbu9m4LLtJywwZ956-_x5E,35347
 mcp_ticketer/adapters/linear.py,sha256=trm6ZhmlUl80sj51WAPAox_R2HQZXZ-h1QXJsrFYDCQ,587
 mcp_ticketer/adapters/linear/__init__.py,sha256=6l0ZoR6ZHSRcytLfps2AZuk5R189Pq1GfR5-YDQt8-Q,731
-mcp_ticketer/adapters/linear/adapter.py,sha256=wXZyhK1nK1QxPoGz2VsNdgtrktvICz4g4pk6naRcfYE,26144
+mcp_ticketer/adapters/linear/adapter.py,sha256=IwmMCm9UFss1NcOnf3gdAlBJ8AeiVTG3FbeqW36gpVg,29606
 mcp_ticketer/adapters/linear/client.py,sha256=0UmWlSEcRiwnSMFYKL89KMrPPL8S8uZ5V6rIY_KFOQU,8803
-mcp_ticketer/adapters/linear/mappers.py,sha256=DbUrCI2gEYkK_PddjR62wva4q8PWcaBh5j1hWOczkPY,9596
+mcp_ticketer/adapters/linear/mappers.py,sha256=GN1X7bOcU-5dhDW3dAtSEGivinhFBc8hoKYot8c5tCo,9631
 mcp_ticketer/adapters/linear/queries.py,sha256=LScSwVb9QA6gPiJJ1vHHoTwA6NA3TEPPD7dUzd1zA4g,7196
 mcp_ticketer/adapters/linear/types.py,sha256=ugXtRGLljDw6yoCnEVgdFs0xLR9ErLdnv4ffh9EAUhk,7874
 mcp_ticketer/cache/__init__.py,sha256=Xcd-cKnt-Cx7jBzvfzUUUPaGkmyXFi5XUFWw3Z4b7d4,138
@@ -24,7 +24,7 @@ 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=C06b393NtgRwLEp4CjOFCQQCNEQ9V-UoMMrJy33r_P0,73982
+mcp_ticketer/cli/main.py,sha256=BFo7QYU0tTOHWSfTmegzDqflSYFytCE8Jw6QGB7TwaY,74470
 mcp_ticketer/cli/mcp_configure.py,sha256=RzV50UjXgOmvMp-9S0zS39psuvjffVByaMrqrUaAGAM,9594
 mcp_ticketer/cli/migrate_config.py,sha256=MYsr_C5ZxsGg0P13etWTWNrJ_lc6ElRCkzfQADYr3DM,5956
 mcp_ticketer/cli/queue_commands.py,sha256=mm-3H6jmkUGJDyU_E46o9iRpek8tvFCm77F19OtHiZI,7884
@@ -38,7 +38,7 @@ mcp_ticketer/core/env_loader.py,sha256=VLCQhK50quM5e3LkrAGHD5on5vTBj18Z2IgNMNES1
 mcp_ticketer/core/exceptions.py,sha256=H1gUmNiOjVXn4CT-JLQcGXmjWxHaxxdFvwcpJLTrs-U,3621
 mcp_ticketer/core/http_client.py,sha256=s5ikMiwEJ8TJjNn73wu3gv3OdAtyBEpAqPnSroRMW2k,13971
 mcp_ticketer/core/mappers.py,sha256=1aG1jFsHTCwmGRVgOlXW-VOSTGzc86gv7qjDfiR1ups,17462
-mcp_ticketer/core/models.py,sha256=O3t7x1Q5l6OYS93HNSg7Kp-d6JapVjdTc6gAAfUBxUo,12495
+mcp_ticketer/core/models.py,sha256=r3BqH0pK2ag2_7c7SSKMZe2G0K7eQID6qy2tkC-GvfI,13155
 mcp_ticketer/core/project_config.py,sha256=5W9YvDBBASEo5fBcSF-rlA1W3LwzkTv6_CEJXxnsOjc,23346
 mcp_ticketer/core/registry.py,sha256=ShYLDPE62KFJpB0kj_zFyQzRxSH3LkQEEuo1jaakb1k,3483
 mcp_ticketer/mcp/__init__.py,sha256=Y05eTzsPk0wH8yKNIM-ekpGjgSDO0bQr0EME-vOP4GE,123
@@ -54,9 +54,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.3.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
-mcp_ticketer-0.3.3.dist-info/METADATA,sha256=jUhjNp9zoOr4y9AXssKHVoe6p7YEyS--WQhKDnEzmrA,13219
-mcp_ticketer-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_ticketer-0.3.3.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
-mcp_ticketer-0.3.3.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
-mcp_ticketer-0.3.3.dist-info/RECORD,,
+mcp_ticketer-0.3.4.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.3.4.dist-info/METADATA,sha256=mcdoktp4RGFdnMy0_fMGrCQXJ72rTjCtVsF3fqrpDOg,13219
+mcp_ticketer-0.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.3.4.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
+mcp_ticketer-0.3.4.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.3.4.dist-info/RECORD,,