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

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

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

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

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

{fenix_mcp-1.9.0 → fenix_mcp-1.11.0}/fenix_mcp/application/tool_base.py

@@ -70,6 +70,30 @@ MarkdownStr = Annotated[
     ),
 ]
 
+# Mermaid diagram hint for markdown fields
+MERMAID_HINT = """
+💡 **Tip**: You can use Mermaid code blocks to create visual diagrams.
+
+Flowchart example:
+```mermaid
+graph TD
+    A[Start] --> B{Decision}
+    B -->|Yes| C[Action 1]
+    B -->|No| D[Action 2]
+```
+
+Sequence diagram example:
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant A as API
+    U->>A: Request
+    A-->>U: Response
+```
+
+Supported types: flowchart, sequenceDiagram, classDiagram, gantt, pie, mindmap, gitGraph.
+"""
+
 # Short title/name strings (1-300 chars)
 TitleStr = Annotated[
     str,

{fenix_mcp-1.9.0 → fenix_mcp-1.11.0}/fenix_mcp/application/tools/intelligence.py

@@ -10,6 +10,7 @@ from pydantic import Field, field_validator
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     MarkdownStr,
@@ -73,7 +74,7 @@ class IntelligenceRequest(ToolRequest):
     action: IntelligenceAction = Field(description=ACTION_FIELD_DESCRIPTION)
     title: Optional[TitleStr] = Field(default=None, description="Memory title.")
     content: Optional[MarkdownStr] = Field(
-        default=None, description="Memory content/text (Markdown)."
+        default=None, description=f"Memory content/text (Markdown).{MERMAID_HINT}"
     )
     metadata: Optional[MarkdownStr] = Field(
         default=None,

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

@@ -10,6 +10,7 @@ from pydantic import Field
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     DescriptionStr,
@@ -78,6 +79,10 @@ class KnowledgeAction(str, Enum):
         "work_assign_to_me",
         "Assigns a work item to the current user.",
     )
+    WORK_MINE = (
+        "work_mine",
+        "Lists work items assigned to the current user. Automatically excludes items with status 'done' or 'cancelled'. Supports pagination via limit and offset parameters.",
+    )
     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'}]",
@@ -222,7 +227,7 @@ class KnowledgeRequest(ToolRequest):
     )
     work_title: Optional[TitleStr] = Field(default=None, description="Work item title.")
     work_description: Optional[MarkdownStr] = Field(
-        default=None, description="Work item description (Markdown)."
+        default=None, description=f"Work item description (Markdown).{MERMAID_HINT}"
     )
     work_type: Optional[str] = Field(
         default="task",
@@ -320,7 +325,7 @@ class KnowledgeRequest(ToolRequest):
         default=None, description="Documentation description."
     )
     doc_content: Optional[MarkdownStr] = Field(
-        default=None, description="Documentation content (Markdown)."
+        default=None, description=f"Documentation content (Markdown).{MERMAID_HINT}"
     )
     doc_status: Optional[str] = Field(
         default=None,
@@ -493,6 +498,16 @@ class KnowledgeTool(Tool):
             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_MINE:
+            items = await self._service.work_mine(
+                limit=payload.limit,
+                offset=payload.offset,
+            )
+            if not items:
+                return text("🎯 No work items assigned to you.")
+            body = "\n\n".join(_format_work(item) for item in items)
+            return text(f"🎯 **Your work items ({len(items)}):**\n\n{body}")
+
         if action is KnowledgeAction.WORK_BACKLOG:
             items = await self._service.work_backlog()
             if not items:

{fenix_mcp-1.9.0 → fenix_mcp-1.11.0}/fenix_mcp/application/tools/productivity.py

@@ -10,6 +10,7 @@ from pydantic import Field
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     MarkdownStr,
@@ -77,7 +78,8 @@ class ProductivityRequest(ToolRequest):
         default=None, description="TODO title (required for create)."
     )
     content: Optional[MarkdownStr] = Field(
-        default=None, description="Markdown content (required for create)."
+        default=None,
+        description=f"Markdown content (required for create).{MERMAID_HINT}",
     )
     status: Optional[str] = Field(
         default=None,

{fenix_mcp-1.9.0 → fenix_mcp-1.11.0}/fenix_mcp/domain/knowledge.py

@@ -78,6 +78,13 @@ class KnowledgeService:
     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_mine(
+        self, *, limit: int = 50, offset: int = 0
+    ) -> List[Dict[str, Any]]:
+        return await self._call_list(
+            self.api.get_work_items_mine, limit=limit, offset=offset
+        )
+
     async def work_update(
         self, work_id: str, payload: Dict[str, Any]
     ) -> Dict[str, Any]:

{fenix_mcp-1.9.0 → fenix_mcp-1.11.0}/fenix_mcp/infrastructure/fenix_api/client.py

@@ -498,6 +498,10 @@ class FenixApiClient:
     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 get_work_items_mine(self, *, limit: int = 50, offset: int = 0) -> Any:
+        params = self._build_params(optional={"limit": limit, "offset": offset})
+        return self._request("GET", "/api/work-items/mine", params=params)
+
     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.9.0 → fenix_mcp-1.11.0}/fenix_mcp.egg-info/PKG-INFO

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