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

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

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

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

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

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

@@ -80,7 +80,7 @@ class KnowledgeAction(str, Enum):
     )
     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'}]",
+        "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
@@ -269,7 +269,9 @@ class KnowledgeRequest(ToolRequest):
         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). "
+            "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"}]'
@@ -598,7 +600,7 @@ class KnowledgeTool(Tool):
             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."
+                    "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.")
@@ -613,21 +615,73 @@ class KnowledgeTool(Tool):
                     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
-
+            # Format response as hierarchical tree
             lines = [f"✅ **{len(items)} work items created**", ""]
+
+            # Build tree structure
+            items_by_id: Dict[str, Dict[str, Any]] = {}
+            children_map: Dict[str, List[str]] = {}
+            root_ids: List[str] = []
+
             for item in items:
+                item_id = item.get("id", "")
+                items_by_id[item_id] = item
+                parent_id = item.get("parent_id")
+                if parent_id and parent_id in items_by_id:
+                    if parent_id not in children_map:
+                        children_map[parent_id] = []
+                    children_map[parent_id].append(item_id)
+                else:
+                    root_ids.append(item_id)
+
+            def format_tree_node(
+                item_id: str, prefix: str = "", is_last: bool = True
+            ) -> List[str]:
+                """Format a node and its children as tree lines."""
+                node_lines: List[str] = []
+                item = items_by_id.get(item_id, {})
                 key = item.get("key", "")
                 title = item.get("title", "Untitled")
                 item_type = item.get("item_type", "unknown")
-                lines.append(f"- [{key}] {title} ({item_type})")
+
+                # Determine connector
+                if prefix == "":
+                    connector = ""
+                    child_prefix = ""
+                else:
+                    connector = "└── " if is_last else "├── "
+                    child_prefix = prefix + ("    " if is_last else "│   ")
+
+                node_lines.append(f"{prefix}{connector}{item_type}: {key} - {title}")
+
+                # Process children
+                child_ids = children_map.get(item_id, [])
+                for i, child_id in enumerate(child_ids):
+                    is_last_child = i == len(child_ids) - 1
+                    node_lines.extend(
+                        format_tree_node(child_id, child_prefix, is_last_child)
+                    )
+
+                return node_lines
+
+            # Format root items and their children
+            for i, root_id in enumerate(root_ids):
+                lines.extend(format_tree_node(root_id))
+                if i < len(root_ids) - 1:
+                    lines.append("")  # Add blank line between root trees
+
+            # Summary by type
+            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.append("")
             lines.append("**Summary by type:**")

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

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