fenix-mcp 1.5.0__py3-none-any.whl → 1.6.0__py3-none-any.whl

fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "1.5.0"
+__version__ = "1.6.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,10 @@ 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.",
+    )
 
     # Boards
     BOARD_LIST = ("board_list", "Lists available boards with optional filters.")
@@ -203,6 +212,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 +226,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 +243,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)."
@@ -372,19 +390,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 +423,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 +430,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 +536,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"))
 
@@ -1084,14 +1127,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 +1152,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 +1172,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/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]:

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)
 

{fenix_mcp-1.5.0.dist-info → fenix_mcp-1.6.0.dist-info}/METADATA

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

{fenix_mcp-1.5.0.dist-info → fenix_mcp-1.6.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-fenix_mcp/__init__.py,sha256=Kfh5kzR-z6NJepWTkqAOawt-M0YPenLm7NKRJzcsVpA,180
+fenix_mcp/__init__.py,sha256=0hD_tbK6SIxOmfllb0TMUOmfIeKzQvRt5FZWd9Uhcgw,180
 fenix_mcp/main.py,sha256=iJV-9btNMDJMObvcn7wBQdbLLKjkYCQ1ANGEwHGHlMU,2857
 fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
 fenix_mcp/application/tool_base.py,sha256=YJk7aSVGjXEvAkXrOHOuUjCFhYni9NPKFyPKiZqkrCc,4235
@@ -7,23 +7,23 @@ fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBE
 fenix_mcp/application/tools/health.py,sha256=m5DxhoRbdwl6INzd6PISxv1NAv-ljCrezsr773VB0wE,834
 fenix_mcp/application/tools/initialize.py,sha256=YfsE3fVYiqGEwvaI_jg5-0K7pGURXxpB3WNwETmGBPc,5499
 fenix_mcp/application/tools/intelligence.py,sha256=fXfjBwAQmZCn3Zc8BqFnQFAJkpd9JsfOPa_uXJj-bMU,15778
-fenix_mcp/application/tools/knowledge.py,sha256=AJkzw9V5vFkcNzJaufw1HCpZG9rbIACFG9DbC6YA1lQ,52263
+fenix_mcp/application/tools/knowledge.py,sha256=mQL3PmXCQIBpSMhpxCaWmF7silj__s1pc5dMJSciXUw,54650
 fenix_mcp/application/tools/productivity.py,sha256=wyJ7-2VqgI2cdrliBD_ejwNvQhN1DecpXSQVrCxcUpQ,11231
 fenix_mcp/application/tools/user_config.py,sha256=O5AVg7IUKL9uIoUoBSFovBDHl9jofhKWzhFK7CnKi4s,6470
 fenix_mcp/domain/initialization.py,sha256=AZhdSNITQ7O3clELBuqGvjJc-c8pFKc7zQz-XR2xXPc,6933
 fenix_mcp/domain/intelligence.py,sha256=j1kkxT-pjuzLQeAGDd2H8gd3O1aeUIRgHFnMGvNwQYg,8636
-fenix_mcp/domain/knowledge.py,sha256=FmE3mGgu9jxr4fDKmBGdUBJ6KWiaVzqtmVu4ZXseXlE,20436
+fenix_mcp/domain/knowledge.py,sha256=X2terO-05fMzCpDTEmdIoAAzooEqx2odF90zIOXyf6I,20726
 fenix_mcp/domain/productivity.py,sha256=PzY664eRPuBCfZGUY_Uv1GNeyMWsw6xqC54C-nobQns,6799
 fenix_mcp/domain/user_config.py,sha256=8rzhJCNqIArfaCoKxxQXFoemCU7qww3hq0RDanIf_2Y,2028
 fenix_mcp/infrastructure/config.py,sha256=zhJ3hhsP-bRfICcdq8rIDh5NGDe_u7AGpcgjcc2U1nY,1908
 fenix_mcp/infrastructure/context.py,sha256=kiDiamiPbHZpTGyZMylcQwtLhfaDXrxAkWSst_DWQNw,470
 fenix_mcp/infrastructure/http_client.py,sha256=QLIPhGYR_cBQGsbIO4RTR6ksyvkQt-OKHQU1JhPyap8,2470
 fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd0ShS2Y,1371
-fenix_mcp/infrastructure/fenix_api/client.py,sha256=z5S6cwBxerpaDXj4Y4LWZEd7ZuGcVmgcaXQv3tTFPBs,28038
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=5ewLAdZcNO59zgCkFLke0sTLU8dalo1W0nXKATt3F4Q,28301
 fenix_mcp/interface/mcp_server.py,sha256=5UM2NJuNbwHkmCEprIFataJ5nFZiO8efTtP_oW3_iX0,2331
 fenix_mcp/interface/transports.py,sha256=PxdhfjH8UMl03f7nuCLc-M6tMx6-Y-btVz_mSqXKrSI,8138
-fenix_mcp-1.5.0.dist-info/METADATA,sha256=iF-2vrXuVW1dKcOh0r0_QpTwRxcysmlLsGAcNuW8MEg,7260
-fenix_mcp-1.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fenix_mcp-1.5.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
-fenix_mcp-1.5.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
-fenix_mcp-1.5.0.dist-info/RECORD,,
+fenix_mcp-1.6.0.dist-info/METADATA,sha256=ZIVb_fHfqXzT-S6-vxJqVplXjwGxNTIYYpPAH4AHirE,7260
+fenix_mcp-1.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-1.6.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-1.6.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-1.6.0.dist-info/RECORD,,