fenix-mcp 0.1.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

fenix_mcp/application/tools/productivity.py

@@ -4,7 +4,7 @@
 from __future__ import annotations
 
 from enum import Enum
-from typing import Any, Dict, Iterable, List, Optional
+from typing import Any, Dict, List, Optional
 
 from pydantic import Field
 
@@ -51,24 +51,36 @@ class TodoAction(str, Enum):
 
 ACTION_FIELD_DESCRIPTION = (
     "Ação de produtividade (TODO). Escolha um dos valores: "
-    + ", ".join(f"`{member.value}` ({member.description.rstrip('.')})." for member in TodoAction)
+    + ", ".join(
+        f"`{member.value}` ({member.description.rstrip('.')})." for member in TodoAction
+    )
 )
 
 
 class ProductivityRequest(ToolRequest):
     action: TodoAction = Field(description=ACTION_FIELD_DESCRIPTION)
     id: Optional[str] = Field(default=None, description="Identificador do item TODO.")
-    title: Optional[str] = Field(default=None, description="Título do TODO (obrigatório em create).")
-    content: Optional[str] = Field(default=None, description="Conteúdo em Markdown (obrigatório em create).")
+    title: Optional[str] = Field(
+        default=None, description="Título do TODO (obrigatório em create)."
+    )
+    content: Optional[str] = Field(
+        default=None, description="Conteúdo em Markdown (obrigatório em create)."
+    )
     status: Optional[str] = Field(default="pending", description="Status do TODO.")
     priority: Optional[str] = Field(default="medium", description="Prioridade do TODO.")
     category: Optional[str] = Field(default=None, description="Categoria opcional.")
     tags: Optional[List[str]] = Field(default=None, description="Lista de tags.")
-    due_date: Optional[str] = Field(default=None, description="Data de vencimento do TODO (ISO).")
-    limit: int = Field(default=20, ge=1, le=100, description="Limite de resultados em list/search.")
+    due_date: Optional[str] = Field(
+        default=None, description="Data de vencimento do TODO (ISO)."
+    )
+    limit: int = Field(
+        default=20, ge=1, le=100, description="Limite de resultados em list/search."
+    )
     offset: int = Field(default=0, ge=0, description="Offset de paginação.")
     query: Optional[str] = Field(default=None, description="Termo de busca.")
-    days: Optional[int] = Field(default=None, ge=1, le=30, description="Janela de dias para upcoming.")
+    days: Optional[int] = Field(
+        default=None, ge=1, le=30, description="Janela de dias para upcoming."
+    )
 
 
 class ProductivityTool(Tool):
@@ -175,7 +187,9 @@ class ProductivityTool(Tool):
     async def _handle_search(self, payload: ProductivityRequest):
         if not payload.query:
             return text("❌ Informe um termo de busca (query).")
-        todos = await self._service.search(payload.query, limit=payload.limit, offset=payload.offset)
+        todos = await self._service.search(
+            payload.query, limit=payload.limit, offset=payload.offset
+        )
         if not todos:
             return text("🔍 Nenhum TODO encontrado para a busca.")
         body = "\n\n".join(ProductivityService.format_todo(todo) for todo in todos)
@@ -213,7 +227,10 @@ class ProductivityTool(Tool):
         return text(f"🔖 **Tags utilizadas:**\n{body}")
 
     async def _handle_help(self):
-        return text("📚 **Ações disponíveis para productivity**\n\n" + TodoAction.formatted_help())
+        return text(
+            "📚 **Ações disponíveis para productivity**\n\n"
+            + TodoAction.formatted_help()
+        )
 
     @staticmethod
     def _format_single(todo: Dict[str, Any], *, header: str) -> str:

fenix_mcp/application/tools/user_config.py

@@ -4,7 +4,7 @@
 from __future__ import annotations
 
 from enum import Enum
-from typing import Dict, List, Optional
+from typing import Any, Dict, List, Optional
 
 from pydantic import Field
 
@@ -43,9 +43,9 @@ class UserConfigAction(str, Enum):
         return "\n".join(lines)
 
 
-ACTION_FIELD_DESCRIPTION = (
-    "Ação a executar. Escolha um dos valores: "
-    + ", ".join(f"`{member.value}` ({member.description.rstrip('.')})." for member in UserConfigAction)
+ACTION_FIELD_DESCRIPTION = "Ação a executar. Escolha um dos valores: " + ", ".join(
+    f"`{member.value}` ({member.description.rstrip('.')})."
+    for member in UserConfigAction
 )
 
 
@@ -53,12 +53,18 @@ class UserConfigRequest(ToolRequest):
     action: UserConfigAction = Field(description=ACTION_FIELD_DESCRIPTION)
     id: Optional[str] = Field(default=None, description="ID do documento.")
     name: Optional[str] = Field(default=None, description="Nome do documento.")
-    content: Optional[str] = Field(default=None, description="Conteúdo em Markdown/JSON.")
+    content: Optional[str] = Field(
+        default=None, description="Conteúdo em Markdown/JSON."
+    )
     mode_id: Optional[str] = Field(default=None, description="ID do modo associado.")
-    is_default: Optional[bool] = Field(default=None, description="Marca o documento como padrão.")
+    is_default: Optional[bool] = Field(
+        default=None, description="Marca o documento como padrão."
+    )
     limit: int = Field(default=20, ge=1, le=100, description="Limite para listagem.")
     offset: int = Field(default=0, ge=0, description="Offset para listagem.")
-    return_content: Optional[bool] = Field(default=None, description="Retorna conteúdo completo.")
+    return_content: Optional[bool] = Field(
+        default=None, description="Retorna conteúdo completo."
+    )
 
 
 class UserConfigTool(Tool):
@@ -125,7 +131,7 @@ class UserConfigTool(Tool):
 
         if action is UserConfigAction.DELETE:
             if not payload.id:
-                return text("❌ Informe o ID do documento." )
+                return text("❌ Informe o ID do documento.")
             await self._service.delete(payload.id)
             return text(f"🗑️ Documento {payload.id} removido.")
 
@@ -135,7 +141,10 @@ class UserConfigTool(Tool):
         )
 
     async def _handle_help(self):
-        return text("📚 **Ações disponíveis para user_config**\n\n" + UserConfigAction.formatted_help())
+        return text(
+            "📚 **Ações disponíveis para user_config**\n\n"
+            + UserConfigAction.formatted_help()
+        )
 
 
 def _format_doc(doc: Dict[str, Any], header: Optional[str] = None) -> str:

fenix_mcp/domain/initialization.py

@@ -25,7 +25,9 @@ class InitializationService:
         self._api = api_client
         self._logger = logger
 
-    async def gather_data(self, *, include_user_docs: bool, limit: int) -> InitializationData:
+    async def gather_data(
+        self, *, include_user_docs: bool, limit: int
+    ) -> InitializationData:
         profile = await self._safe_call(self._api.get_profile)
         core_docs = await self._safe_call(
             self._api.list_core_documents,
@@ -35,29 +37,20 @@ class InitializationService:
             self._logger.debug("Core docs response", extra={"core_docs": core_docs})
         user_docs: List[Dict[str, Any]] = []
         if include_user_docs:
-            user_docs = await self._safe_call(
-                self._api.list_user_core_documents,
-                return_content=True,
-            ) or []
+            user_docs = (
+                await self._safe_call(
+                    self._api.list_user_core_documents,
+                    return_content=True,
+                )
+                or []
+            )
             if self._logger:
                 self._logger.debug("User docs response", extra={"user_docs": user_docs})
-        memories = await self._safe_call(
-            self._api.list_memories,
-            include_content=True,
-            include_metadata=False,
-            limit=3,
-            offset=0,
-            sortBy="created_at",
-            sortOrder="desc",
-        )
-        if self._logger:
-            self._logger.debug("Memories response", extra={"memories": memories})
-
         return InitializationData(
             profile=profile,
             core_documents=self._extract_items(core_docs, "coreDocuments"),
             user_documents=self._extract_items(user_docs, "userCoreDocuments"),
-            recent_memories=self._extract_items(memories, "memories"),
+            recent_memories=[],
         )
 
     async def _safe_call(self, func, *args, **kwargs):
@@ -80,7 +73,9 @@ class InitializationService:
         return []
 
     @staticmethod
-    def build_existing_user_summary(data: InitializationData, include_user_docs: bool) -> str:
+    def build_existing_user_summary(
+        data: InitializationData, include_user_docs: bool
+    ) -> str:
         profile = data.profile or {}
         user_info = profile.get("user") or {}
         tenant_info = profile.get("tenant") or {}
@@ -109,16 +104,21 @@ class InitializationService:
 
         if core_count:
             preview = ", ".join(
-                doc.get("name", doc.get("title", "sem título")) for doc in data.core_documents[:5]
+                doc.get("name", doc.get("title", "sem título"))
+                for doc in data.core_documents[:5]
             )
             lines.append(f"- Exemplos de documentos principais: {preview}")
 
         if include_user_docs and user_count:
-            preview = ", ".join(doc.get("name", "sem título") for doc in data.user_documents[:5])
+            preview = ", ".join(
+                doc.get("name", "sem título") for doc in data.user_documents[:5]
+            )
             lines.append(f"- Exemplos de documentos pessoais: {preview}")
 
         if memories_count:
-            preview = ", ".join(mem.get("title", "sem título") for mem in data.recent_memories[:3])
+            preview = ", ".join(
+                mem.get("title", "sem título") for mem in data.recent_memories[:3]
+            )
             lines.append(f"- Memórias recentes: {preview}")
 
         lines.append("")

fenix_mcp/domain/intelligence.py

@@ -44,12 +44,15 @@ class IntelligenceService:
         params = _strip_none(filters)
         include_content = bool(params.pop("content", True))
         include_metadata = bool(params.pop("metadata", False))
-        return await self._call(
-            self.api.list_memories,
-            include_content=include_content,
-            include_metadata=include_metadata,
-            **params,
-        ) or []
+        return (
+            await self._call(
+                self.api.list_memories,
+                include_content=include_content,
+                include_metadata=include_metadata,
+                **params,
+            )
+            or []
+        )
 
     async def similar_memories(
         self, *, content: str, threshold: float, max_results: int
@@ -58,7 +61,9 @@ class IntelligenceService:
             "content": content,
             "threshold": threshold,
         }
-        result = await self._call(self.api.find_similar_memories, _strip_none(payload)) or []
+        result = (
+            await self._call(self.api.find_similar_memories, _strip_none(payload)) or []
+        )
         if isinstance(result, list) and max_results:
             return result[:max_results]
         return result
@@ -78,15 +83,20 @@ class IntelligenceService:
             "sortBy": "priority_score",
             "sortOrder": "desc",
         }
-        return await self._call(
-            self.api.list_memories,
-            include_content=False,
-            include_metadata=False,
-            **params,
-        ) or []
+        return (
+            await self._call(
+                self.api.list_memories,
+                include_content=False,
+                include_metadata=False,
+                **params,
+            )
+            or []
+        )
 
     async def analytics(self, *, time_range: str, group_by: str) -> Dict[str, Any]:
-        memories = await self.query_memories(limit=200, timeRange=time_range, groupBy=group_by)
+        memories = await self.query_memories(
+            limit=200, timeRange=time_range, groupBy=group_by
+        )
         summary: Dict[str, Any] = {
             "total_memories": len(memories),
             "by_group": {},
@@ -100,7 +110,9 @@ class IntelligenceService:
     async def update_memory(self, memory_id: str, **fields: Any) -> Dict[str, Any]:
         payload = _strip_none(fields)
         if "importance" in payload:
-            payload["priority_score"] = _importance_to_priority(payload.pop("importance"))
+            payload["priority_score"] = _importance_to_priority(
+                payload.pop("importance")
+            )
         mapping = {
             "documentation_item_id": "documentationItemId",
             "mode_id": "modeId",