fenix-mcp 1.9.0__py3-none-any.whl → 1.11.0__py3-none-any.whl

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/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/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/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/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/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/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.dist-info → fenix_mcp-1.11.0.dist-info}/METADATA

@@ -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.dist-info → fenix_mcp-1.11.0.dist-info}/RECORD

@@ -1,29 +1,29 @@
-fenix_mcp/__init__.py,sha256=RSnCE2xWQoxMXMLP8m8560qoiZO8pwVWFgICK-rSnDw,180
+fenix_mcp/__init__.py,sha256=17a6anjdJHVc3TWomuQjFJeic0Pk_iIb4z6-uyKORw0,181
 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
+fenix_mcp/application/tool_base.py,sha256=ZCb9g4ij5Hbb0410NEZTYXvPWq-Zkg8ZCsinTa3gCY4,4741
 fenix_mcp/application/tool_registry.py,sha256=bPT5g8GfxG_qu28R1WaDOZHvtmG6TPDvZi8eWj1T9xE,1250
 fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBEZ02KBXJaKQ,796
 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=LfyDhjoy3utxZ-AHvcRYsimNd9KFTfIkH0Sc8aCvykQ,60358
-fenix_mcp/application/tools/productivity.py,sha256=wyJ7-2VqgI2cdrliBD_ejwNvQhN1DecpXSQVrCxcUpQ,11231
+fenix_mcp/application/tools/intelligence.py,sha256=wsph1GwiQX3aX5NtFIZlM7I5xo1N3KT-cMlVfZuaHpU,15811
+fenix_mcp/application/tools/knowledge.py,sha256=AQBSispBde0-jAhlKjHrek9FNUaZzqhn293yyocYUQ0,61057
+fenix_mcp/application/tools/productivity.py,sha256=Wmefwg6yuXkHwwQT999d9D4lQf0UY_jnCTDlBe2YRTg,11273
 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=4zCEpfzQxXiMDIphWfKiKnqvsVQ-B8yoUk1Zog3lJnE,20928
+fenix_mcp/domain/knowledge.py,sha256=xZt2Mjikf4HxcXERDC6ov1fxoHnm4LPU6FI2FZxqq0w,21152
 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=GZrrWiUGxMaFM7kT7M8YYeWN1X5EetaJg6Co1-RBI0o,28457
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=YIoDIUQdNd7zzt2X3OsgajjxH5Jqb_85A6BvQDN6H6o,28693
 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.9.0.dist-info/METADATA,sha256=A9gBNunNWduimqMBaYWovCv674-R9i9wVvXcB6bzAoQ,7260
-fenix_mcp-1.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fenix_mcp-1.9.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
-fenix_mcp-1.9.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
-fenix_mcp-1.9.0.dist-info/RECORD,,
+fenix_mcp-1.11.0.dist-info/METADATA,sha256=0U8QF618uJxIavnMhEnIbSD_5qPf48e1eavB_0dX3n0,7261
+fenix_mcp-1.11.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-1.11.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-1.11.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-1.11.0.dist-info/RECORD,,