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

fenix_mcp/__init__.py

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

fenix_mcp/application/tools/knowledge.py

@@ -78,6 +78,10 @@ class KnowledgeAction(str, Enum):
         "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 in the same batch, or parent_key to reference an existing work item (e.g., TEMA-0056). Cannot use both parent_temp_id and parent_key on the same item. 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'}] or [{temp_id:'task-1', parent_key:'TEMA-0056', title:'My Task', item_type:'task', work_category:'backend'}]",
+    )
 
     # Boards
     BOARD_LIST = ("board_list", "Lists available boards with optional filters.")
@@ -260,6 +264,19 @@ 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 from same batch (e.g., parent_temp_id:'epic-1'), "
+            "OR parent_key to set parent from existing work item (e.g., parent_key:'TEMA-0056'). "
+            "Cannot use both parent_temp_id and parent_key on the same item. "
+            "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(
@@ -579,6 +596,52 @@ 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 OR parent_key (not both), 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.")
+                if item.get("parent_temp_id") and item.get("parent_key"):
+                    return text(
+                        f"❌ Item {i}: cannot have both parent_temp_id and parent_key. Use one or the other."
+                    )
+
+            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(

fenix_mcp/domain/knowledge.py

@@ -181,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/infrastructure/fenix_api/client.py

@@ -573,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.6.0.dist-info → fenix_mcp-1.8.0.dist-info}/METADATA

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

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

@@ -1,4 +1,4 @@
-fenix_mcp/__init__.py,sha256=0hD_tbK6SIxOmfllb0TMUOmfIeKzQvRt5FZWd9Uhcgw,180
+fenix_mcp/__init__.py,sha256=1rPPMWBN4_kt19tylpYO9VURpib6wyxuNU5d3n6gYfk,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=mQL3PmXCQIBpSMhpxCaWmF7silj__s1pc5dMJSciXUw,54650
+fenix_mcp/application/tools/knowledge.py,sha256=TOXyiXzEzeq_IiLTJ9kR_o8Kgc2oDmnQOQVvDPimAAA,58408
 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=X2terO-05fMzCpDTEmdIoAAzooEqx2odF90zIOXyf6I,20726
+fenix_mcp/domain/knowledge.py,sha256=4zCEpfzQxXiMDIphWfKiKnqvsVQ-B8yoUk1Zog3lJnE,20928
 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=5ewLAdZcNO59zgCkFLke0sTLU8dalo1W0nXKATt3F4Q,28301
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=GZrrWiUGxMaFM7kT7M8YYeWN1X5EetaJg6Co1-RBI0o,28457
 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.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,,
+fenix_mcp-1.8.0.dist-info/METADATA,sha256=I9_mtSYu17C0GPL2tEyygd3L3giTE8wo-rq88IQP0Os,7260
+fenix_mcp-1.8.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-1.8.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-1.8.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-1.8.0.dist-info/RECORD,,