fenix-mcp 1.5.0__tar.gz → 1.7.0__tar.gz

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 1.5.0
+Version: 1.7.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "1.5.0"
+__version__ = "1.7.0"

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/fenix_mcp/application/tools/knowledge.py

@@ -39,18 +39,20 @@ class KnowledgeAction(str, Enum):
     # Work items
     WORK_CREATE = (
         "work_create",
-        "Creates a work item with title, status and optional links.",
+        "Creates a work item with title, status and optional links. Use parent_key (e.g., DVPT-0001) to set parent.",
     )
     WORK_LIST = (
         "work_list",
         "Lists work items with status, priority and context filters.",
     )
-    WORK_GET = ("work_get", "Gets full details of a work item by ID.")
+    WORK_GET = (
+        "work_get",
+        "Gets full details of a work item by ID or key (e.g., DVPT-0001).",
+    )
     WORK_UPDATE = (
         "work_update",
-        "Updates specific fields of an existing work item.",
+        "Updates allowed fields of an existing work item (title, description, priority, story_points, tags, due_date).",
     )
-    WORK_DELETE = ("work_delete", "Permanently removes a work item.")
     WORK_BACKLOG = ("work_backlog", "Lists backlog items for a team.")
     WORK_SEARCH = (
         "work_search",
@@ -60,7 +62,10 @@ class KnowledgeAction(str, Enum):
     WORK_BY_BOARD = ("work_by_board", "Lists work items associated with a board.")
     WORK_BY_SPRINT = ("work_by_sprint", "Lists work items associated with a sprint.")
     WORK_BY_EPIC = ("work_by_epic", "Lists work items associated with an epic.")
-    WORK_CHILDREN = ("work_children", "Lists child work items of a parent item.")
+    WORK_CHILDREN = (
+        "work_children",
+        "Lists child work items of a parent item by ID or key (e.g., DVPT-0001).",
+    )
     WORK_STATUS_UPDATE = (
         "work_status_update",
         "Updates only the status of a work item.",
@@ -69,6 +74,14 @@ class KnowledgeAction(str, Enum):
         "work_assign_sprint",
         "Assigns work items to a sprint.",
     )
+    WORK_ASSIGN_TO_ME = (
+        "work_assign_to_me",
+        "Assigns a work item to the current user.",
+    )
+    WORK_BULK_CREATE = (
+        "work_bulk_create",
+        "Creates multiple work items atomically with hierarchy. Use temp_id as temporary identifier and parent_temp_id to reference parent. Example: [{temp_id:'epic-1', title:'My Epic', item_type:'epic', work_category:'backend'}, {temp_id:'task-1', parent_temp_id:'epic-1', title:'My Task', item_type:'task', work_category:'backend'}]",
+    )
 
     # Boards
     BOARD_LIST = ("board_list", "Lists available boards with optional filters.")
@@ -203,6 +216,10 @@ class KnowledgeRequest(ToolRequest):
     )
 
     # Work item fields
+    work_key: Optional[str] = Field(
+        default=None,
+        description="Work item key (e.g., DVPT-0001). Use this instead of id for work_get and work_children.",
+    )
     work_title: Optional[TitleStr] = Field(default=None, description="Work item title.")
     work_description: Optional[MarkdownStr] = Field(
         default=None, description="Work item description (Markdown)."
@@ -213,7 +230,7 @@ class KnowledgeRequest(ToolRequest):
     )
     work_status: Optional[str] = Field(
         default=None,
-        description="Work item status (backlog, todo, in_progress, review, testing, done, cancelled).",
+        description="Work item status ID (UUID of TeamStatus).",
     )
     work_priority: Optional[str] = Field(
         default=None,
@@ -230,7 +247,12 @@ class KnowledgeRequest(ToolRequest):
         default=None, description="Assignee ID (UUID)."
     )
     parent_id: Optional[UUIDStr] = Field(
-        default=None, description="Parent item ID (UUID)."
+        default=None,
+        description="Parent item ID (UUID). Prefer using parent_key instead.",
+    )
+    parent_key: Optional[str] = Field(
+        default=None,
+        description="Parent item key (e.g., DVPT-0001). Use this to set the parent of a work item.",
     )
     work_due_date: Optional[DateTimeStr] = Field(
         default=None, description="Work item due date (ISO 8601)."
@@ -242,6 +264,17 @@ class KnowledgeRequest(ToolRequest):
         default=None,
         description="List of work item IDs for batch operations (UUIDs).",
     )
+    work_items: Optional[List[Dict[str, Any]]] = Field(
+        default=None,
+        description=(
+            "List of work items for bulk create (max 50). Each item requires: "
+            "temp_id (your temporary ID like 'epic-1', 'task-a'), title, item_type, work_category. "
+            "Use parent_temp_id to set parent (e.g., parent_temp_id:'epic-1' makes it child of epic-1). "
+            "Optional: description, priority (low/medium/high/critical), story_points, tags, due_date. "
+            'Example: [{"temp_id":"e1", "title":"Epic", "item_type":"epic", "work_category":"backend"}, '
+            '{"temp_id":"t1", "parent_temp_id":"e1", "title":"Task", "item_type":"task", "work_category":"backend"}]'
+        ),
+    )
 
     # Mode fields
     mode_id: Optional[UUIDStr] = Field(
@@ -372,19 +405,25 @@ class KnowledgeTool(Tool):
                 return text(
                     "❌ Provide work_category to create the item. Values: backend, frontend, mobile, fullstack, devops, infra, platform, sre, database, security, data, analytics, ai_ml, qa, automation, design, research, product, project, agile, support, operations, documentation, training, architecture, planning, development."
                 )
+
+            # Resolve parent_key to parent_id if provided
+            parent_id = payload.parent_id
+            if payload.parent_key and not parent_id:
+                parent_work = await self._service.work_get_by_key(payload.parent_key)
+                parent_id = parent_work.get("id")
+
             work = await self._service.work_create(
                 {
                     "title": payload.work_title,
                     "description": payload.work_description,
                     "item_type": payload.work_type,
-                    "status": payload.work_status,
+                    "status_id": payload.work_status,
                     "priority": payload.work_priority,
                     "work_category": payload.work_category,
                     "story_points": payload.story_points,
                     "assignee_id": payload.assignee_id,
                     "sprint_id": payload.sprint_id,
-                    "board_id": payload.board_id,
-                    "parent_id": payload.parent_id,
+                    "parent_id": parent_id,
                     "due_date": payload.work_due_date,
                     "tags": payload.work_tags,
                 }
@@ -399,7 +438,6 @@ class KnowledgeTool(Tool):
                 type=payload.work_type,
                 assignee=payload.assignee_id,
                 sprint=payload.sprint_id,
-                board=payload.board_id,
             )
             if not items:
                 return text("🎯 No work items found.")
@@ -407,41 +445,51 @@ class KnowledgeTool(Tool):
             return text(f"🎯 **Work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_GET:
-            if not payload.id:
-                return text("❌ Provide the work item ID.")
-            work = await self._service.work_get(payload.id)
+            # Support both id and work_key
+            if payload.work_key:
+                work = await self._service.work_get_by_key(payload.work_key)
+            elif payload.id:
+                work = await self._service.work_get(payload.id)
+            else:
+                return text("❌ Provide id or work_key to get the work item.")
             return text(
                 _format_work(work, header="🎯 Work item details", show_description=True)
             )
 
         if action is KnowledgeAction.WORK_UPDATE:
-            if not payload.id:
-                return text("❌ Provide the work item ID.")
+            # Resolve work_key to id if needed
+            work_id = payload.id
+            if payload.work_key and not work_id:
+                work_item = await self._service.work_get_by_key(payload.work_key)
+                work_id = work_item.get("id")
+            if not work_id:
+                return text("❌ Provide id or work_key to update the work item.")
+
+            # Only allow safe fields to be updated via MCP
+            # Excluded: item_type, status_id, assignee_id, sprint_id, parent_id, work_category
             work = await self._service.work_update(
-                payload.id,
+                work_id,
                 {
                     "title": payload.work_title,
                     "description": payload.work_description,
-                    "item_type": payload.work_type,
-                    "status": payload.work_status,
                     "priority": payload.work_priority,
-                    "work_category": payload.work_category,
                     "story_points": payload.story_points,
-                    "assignee_id": payload.assignee_id,
-                    "sprint_id": payload.sprint_id,
-                    "board_id": payload.board_id,
-                    "parent_id": payload.parent_id,
                     "due_date": payload.work_due_date,
                     "tags": payload.work_tags,
                 },
             )
             return text(_format_work(work, header="✅ Work item updated"))
 
-        if action is KnowledgeAction.WORK_DELETE:
-            if not payload.id:
-                return text("❌ Provide the work item ID.")
-            await self._service.work_delete(payload.id)
-            return text(f"🗑️ Work item {payload.id} removed.")
+        if action is KnowledgeAction.WORK_ASSIGN_TO_ME:
+            # Resolve work_key to id if needed
+            work_id = payload.id
+            if payload.work_key and not work_id:
+                work_item = await self._service.work_get_by_key(payload.work_key)
+                work_id = work_item.get("id")
+            if not work_id:
+                return text("❌ Provide id or work_key to assign the work item.")
+            work = await self._service.work_assign_to_me(work_id)
+            return text(_format_work(work, header="✅ Work item assigned to you"))
 
         if action is KnowledgeAction.WORK_BACKLOG:
             items = await self._service.work_backlog()
@@ -503,22 +551,32 @@ class KnowledgeTool(Tool):
             return text(f"📦 **Epic work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_CHILDREN:
-            if not payload.id:
-                return text("❌ Provide the parent work item ID.")
-            items = await self._service.work_children(payload.id)
+            # Support both id and work_key
+            work_id = payload.id
+            if payload.work_key and not work_id:
+                work_item = await self._service.work_get_by_key(payload.work_key)
+                work_id = work_item.get("id")
+            if not work_id:
+                return text("❌ Provide id or work_key to list children.")
+            items = await self._service.work_children(work_id)
             if not items:
                 return text("👶 No child items found.")
             body = "\n\n".join(_format_work(item) for item in items)
             return text(f"👶 **Child work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_STATUS_UPDATE:
-            if not payload.id:
-                return text("❌ Provide the work item ID.")
+            # Resolve work_key to id if needed
+            work_id = payload.id
+            if payload.work_key and not work_id:
+                work_item = await self._service.work_get_by_key(payload.work_key)
+                work_id = work_item.get("id")
+            if not work_id:
+                return text("❌ Provide id or work_key to update status.")
             if not payload.work_status:
-                return text("❌ Provide work_status to update.")
+                return text("❌ Provide work_status (status_id) to update.")
             work = await self._service.work_update_status(
-                payload.id,
-                {"status": payload.work_status},
+                work_id,
+                {"status_id": payload.work_status},
             )
             return text(_format_work(work, header="✅ Status updated"))
 
@@ -536,6 +594,48 @@ class KnowledgeTool(Tool):
             count = len(payload.work_item_ids)
             return text(f"✅ {count} work item(s) assigned to sprint.")
 
+        if action is KnowledgeAction.WORK_BULK_CREATE:
+            if not payload.work_items:
+                return text(
+                    "❌ Provide work_items array. Each item requires: temp_id, title, item_type, work_category. "
+                    "Optional: parent_temp_id, description, priority, story_points, tags, due_date."
+                )
+            if len(payload.work_items) > 50:
+                return text("❌ Maximum 50 items per bulk create.")
+
+            # Validate required fields
+            for i, item in enumerate(payload.work_items):
+                if not item.get("temp_id"):
+                    return text(f"❌ Item {i}: missing temp_id.")
+                if not item.get("title"):
+                    return text(f"❌ Item {i}: missing title.")
+                if not item.get("item_type"):
+                    return text(f"❌ Item {i}: missing item_type.")
+                if not item.get("work_category"):
+                    return text(f"❌ Item {i}: missing work_category.")
+
+            items = await self._service.work_bulk_create({"items": payload.work_items})
+
+            # Format response with summary
+            type_counts: Dict[str, int] = {}
+            for item in items:
+                item_type = item.get("item_type", "unknown")
+                type_counts[item_type] = type_counts.get(item_type, 0) + 1
+
+            lines = [f"✅ **{len(items)} work items created**", ""]
+            for item in items:
+                key = item.get("key", "")
+                title = item.get("title", "Untitled")
+                item_type = item.get("item_type", "unknown")
+                lines.append(f"- [{key}] {title} ({item_type})")
+
+            lines.append("")
+            lines.append("**Summary by type:**")
+            for item_type, count in sorted(type_counts.items()):
+                lines.append(f"- {item_type}: {count}")
+
+            return text("\n".join(lines))
+
         return text(
             "❌ Unsupported work item action.\n\nChoose one of the values:\n"
             + "\n".join(
@@ -1084,14 +1184,21 @@ def _format_work(
         lines.append(header)
         lines.append("")
 
+    # Extract key (e.g., DVPT-0001)
+    key = item.get("key", "")
+
     # Extract title
     title = item.get("title") or item.get("name") or "Untitled"
 
     # Extract type
     item_type = item.get("item_type") or item.get("type") or "unknown"
 
-    # Extract status
-    status = item.get("status") or item.get("state") or "unknown"
+    # Extract status - prefer status object with name, fallback to status_id
+    status_obj = item.get("status")
+    if isinstance(status_obj, dict):
+        status = status_obj.get("name", "unknown")
+    else:
+        status = item.get("status_id") or status_obj or "unknown"
 
     # Extract priority
     priority = item.get("priority") or item.get("priority_level") or "undefined"
@@ -1102,15 +1209,19 @@ def _format_work(
     # Extract assignee - check both assignee_id and assignee object
     assignee = item.get("assignee_id")
     if not assignee and item.get("assignee"):
-        assignee = item.get("assignee", {}).get("name") or item.get("assignee", {}).get(
-            "id"
-        )
+        assignee_obj = item.get("assignee", {})
+        assignee = assignee_obj.get("name") or assignee_obj.get("id")
     if not assignee:
         assignee = "N/A"
 
+    # Format title line with key if available
+    if key:
+        lines.append(f"🎯 **[{key}] {title}**")
+    else:
+        lines.append(f"🎯 **{title}**")
+
     lines.extend(
         [
-            f"🎯 **{title}**",
             f"ID: {item_id}",
             f"Type: {item_type}",
             f"Status: {status}",
@@ -1118,6 +1229,11 @@ def _format_work(
             f"Assignee: {assignee}",
         ]
     )
+
+    # Add key as separate line if present (for easy reference)
+    if key:
+        lines.append(f"Key: {key}")
+
     if item.get("due_date") or item.get("dueDate"):
         lines.append(
             f"Due date: {_format_date(item.get('due_date') or item.get('dueDate'))}"

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/fenix_mcp/domain/knowledge.py

@@ -72,6 +72,12 @@ class KnowledgeService:
     async def work_get(self, work_id: str) -> Dict[str, Any]:
         return await self._call_dict(self.api.get_work_item, work_id)
 
+    async def work_get_by_key(self, key: str) -> Dict[str, Any]:
+        return await self._call_dict(self.api.get_work_item_by_key, key)
+
+    async def work_assign_to_me(self, work_id: str) -> Dict[str, Any]:
+        return await self._call_dict(self.api.assign_work_item_to_me, work_id)
+
     async def work_update(
         self, work_id: str, payload: Dict[str, Any]
     ) -> Dict[str, Any]:
@@ -175,6 +181,11 @@ class KnowledgeService:
     async def work_bulk_update(self, payload: Dict[str, Any]) -> Dict[str, Any]:
         return await self._call(self.api.bulk_update_work_items, _strip_none(payload))
 
+    async def work_bulk_create(self, payload: Dict[str, Any]) -> List[Dict[str, Any]]:
+        return await self._call_list(
+            self.api.bulk_create_work_items, _strip_none(payload)
+        )
+
     # ------------------------------------------------------------------
     # Work boards
     # ------------------------------------------------------------------

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/fenix_mcp/infrastructure/fenix_api/client.py

@@ -492,6 +492,12 @@ class FenixApiClient:
     def get_work_item(self, item_id: str) -> Any:
         return self._request("GET", f"/api/work-items/{item_id}")
 
+    def get_work_item_by_key(self, key: str) -> Any:
+        return self._request("GET", f"/api/work-items/by-key/{key}")
+
+    def assign_work_item_to_me(self, item_id: str) -> Any:
+        return self._request("POST", f"/api/work-items/{item_id}/assign-to-me")
+
     def update_work_item(self, item_id: str, payload: Mapping[str, Any]) -> Any:
         return self._request("PATCH", f"/api/work-items/{item_id}", json=payload)
 
@@ -567,6 +573,9 @@ class FenixApiClient:
     def bulk_update_work_items(self, payload: Mapping[str, Any]) -> Any:
         return self._request("PATCH", "/api/work-items/bulk-update", json=payload)
 
+    def bulk_create_work_items(self, payload: Mapping[str, Any]) -> Any:
+        return self._request("POST", "/api/work-items/bulk-create", json=payload)
+
     # ------------------------------------------------------------------
     # Knowledge: boards
     # ------------------------------------------------------------------

{fenix_mcp-1.5.0 → fenix_mcp-1.7.0}/fenix_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 1.5.0
+Version: 1.7.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10