fenix-mcp 0.6.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

fenix_mcp/application/tools/knowledge.py

@@ -22,6 +22,8 @@ from fenix_mcp.application.tool_base import (
     ToolRequest,
     UUIDStr,
     VersionStr,
+    sanitize_null,
+    sanitize_null_list,
 )
 from fenix_mcp.domain.knowledge import KnowledgeService, _format_date
 from fenix_mcp.infrastructure.context import AppContext
@@ -37,90 +39,93 @@ class KnowledgeAction(str, Enum):
     # Work items
     WORK_CREATE = (
         "work_create",
-        "Cria um work item com título, status e vínculos opcionais.",
+        "Creates a work item with title, status and optional links.",
     )
     WORK_LIST = (
         "work_list",
-        "Lista work items com filtros de status, prioridade e contexto.",
+        "Lists work items with status, priority and context filters.",
     )
-    WORK_GET = ("work_get", "Obtém detalhes completos de um work item pelo ID.")
+    WORK_GET = ("work_get", "Gets full details of a work item by ID.")
     WORK_UPDATE = (
         "work_update",
-        "Atualiza campos específicos de um work item existente.",
+        "Updates specific fields of an existing work item.",
     )
-    WORK_DELETE = ("work_delete", "Remove um work item definitivamente.")
-    WORK_BACKLOG = ("work_backlog", "Lista itens do backlog de um time.")
-    WORK_SEARCH = ("work_search", "Busca work items por texto com filtros adicionais.")
-    WORK_ANALYTICS = ("work_analytics", "Retorna métricas consolidadas de work items.")
-    WORK_BY_BOARD = ("work_by_board", "Lista work items associados a um board.")
-    WORK_BY_SPRINT = ("work_by_sprint", "Lista work items associados a um sprint.")
-    WORK_BY_EPIC = ("work_by_epic", "Lista work items associados a um épico.")
-    WORK_CHILDREN = ("work_children", "Lista work items filhos de um item pai.")
+    WORK_DELETE = ("work_delete", "Permanently removes a work item.")
+    WORK_BACKLOG = ("work_backlog", "Lists backlog items for a team.")
+    WORK_SEARCH = (
+        "work_search",
+        "Searches work items by text with additional filters.",
+    )
+    WORK_ANALYTICS = ("work_analytics", "Returns consolidated work item metrics.")
+    WORK_BY_BOARD = ("work_by_board", "Lists work items associated with a board.")
+    WORK_BY_SPRINT = ("work_by_sprint", "Lists work items associated with a sprint.")
+    WORK_BY_EPIC = ("work_by_epic", "Lists work items associated with an epic.")
+    WORK_CHILDREN = ("work_children", "Lists child work items of a parent item.")
     WORK_STATUS_UPDATE = (
         "work_status_update",
-        "Atualiza apenas o status de um work item.",
+        "Updates only the status of a work item.",
     )
     WORK_ASSIGN_SPRINT = (
         "work_assign_sprint",
-        "Atribui work items a um sprint.",
+        "Assigns work items to a sprint.",
     )
 
     # Boards
-    BOARD_LIST = ("board_list", "Lista boards disponíveis com filtros opcionais.")
-    BOARD_BY_TEAM = ("board_by_team", "Lista boards de um time específico.")
-    BOARD_FAVORITES = ("board_favorites", "Lista boards marcados como favoritos.")
-    BOARD_GET = ("board_get", "Obtém detalhes de um board pelo ID.")
-    BOARD_COLUMNS = ("board_columns", "Lista colunas configuradas para um board.")
+    BOARD_LIST = ("board_list", "Lists available boards with optional filters.")
+    BOARD_BY_TEAM = ("board_by_team", "Lists boards for a specific team.")
+    BOARD_FAVORITES = ("board_favorites", "Lists boards marked as favorites.")
+    BOARD_GET = ("board_get", "Gets board details by ID.")
+    BOARD_COLUMNS = ("board_columns", "Lists columns configured for a board.")
 
     # Sprints
-    SPRINT_LIST = ("sprint_list", "Lista sprints disponíveis com filtros opcionais.")
-    SPRINT_BY_TEAM = ("sprint_by_team", "Lista sprints associados a um time.")
-    SPRINT_ACTIVE = ("sprint_active", "Obtém o sprint ativo de um time.")
-    SPRINT_GET = ("sprint_get", "Obtém detalhes de um sprint pelo ID.")
+    SPRINT_LIST = ("sprint_list", "Lists available sprints with optional filters.")
+    SPRINT_BY_TEAM = ("sprint_by_team", "Lists sprints associated with a team.")
+    SPRINT_ACTIVE = ("sprint_active", "Gets the active sprint for a team.")
+    SPRINT_GET = ("sprint_get", "Gets sprint details by ID.")
     SPRINT_WORK_ITEMS = (
         "sprint_work_items",
-        "Lista work items vinculados a um sprint.",
+        "Lists work items linked to a sprint.",
     )
 
     # Modes
-    MODE_CREATE = ("mode_create", "Cria um modo com conteúdo e metadados opcionais.")
-    MODE_LIST = ("mode_list", "Lista modes cadastrados.")
-    MODE_GET = ("mode_get", "Obtém detalhes completos de um modo.")
-    MODE_UPDATE = ("mode_update", "Atualiza propriedades de um modo existente.")
-    MODE_DELETE = ("mode_delete", "Remove um modo.")
-    MODE_RULE_ADD = ("mode_rule_add", "Associa uma regra a um modo.")
+    MODE_CREATE = ("mode_create", "Creates a mode with content and optional metadata.")
+    MODE_LIST = ("mode_list", "Lists registered modes.")
+    MODE_GET = ("mode_get", "Gets full details of a mode.")
+    MODE_UPDATE = ("mode_update", "Updates properties of an existing mode.")
+    MODE_DELETE = ("mode_delete", "Removes a mode.")
+    MODE_RULE_ADD = ("mode_rule_add", "Associates a rule with a mode.")
     MODE_RULE_REMOVE = (
         "mode_rule_remove",
-        "Remove a associação de uma regra com um modo.",
+        "Removes the association of a rule with a mode.",
     )
-    MODE_RULES = ("mode_rules", "Lista regras associadas a um modo.")
+    MODE_RULES = ("mode_rules", "Lists rules associated with a mode.")
 
     # Rules
-    RULE_CREATE = ("rule_create", "Cria uma regra com conteúdo e metadados.")
-    RULE_LIST = ("rule_list", "Lista regras cadastradas.")
-    RULE_GET = ("rule_get", "Obtém detalhes de uma regra.")
-    RULE_UPDATE = ("rule_update", "Atualiza uma regra existente.")
-    RULE_DELETE = ("rule_delete", "Remove uma regra.")
+    RULE_CREATE = ("rule_create", "Creates a rule with content and metadata.")
+    RULE_LIST = ("rule_list", "Lists registered rules.")
+    RULE_GET = ("rule_get", "Gets rule details.")
+    RULE_UPDATE = ("rule_update", "Updates an existing rule.")
+    RULE_DELETE = ("rule_delete", "Removes a rule.")
 
     # Documentation
-    DOC_CREATE = ("doc_create", "Cria um item de documentação.")
-    DOC_LIST = ("doc_list", "Lista itens de documentação com filtros.")
-    DOC_GET = ("doc_get", "Obtém detalhes de um item de documentação.")
-    DOC_UPDATE = ("doc_update", "Atualiza um item de documentação.")
-    DOC_DELETE = ("doc_delete", "Remove um item de documentação.")
-    DOC_SEARCH = ("doc_search", "Busca itens de documentação por texto.")
-    DOC_ROOTS = ("doc_roots", "Lista documentos raiz disponíveis.")
-    DOC_RECENT = ("doc_recent", "Lista documentos acessados recentemente.")
-    DOC_ANALYTICS = ("doc_analytics", "Retorna analytics dos documentos.")
-    DOC_CHILDREN = ("doc_children", "Lista documentos filhos de um item.")
-    DOC_TREE = ("doc_tree", "Recupera a árvore direta de um documento.")
-    DOC_FULL_TREE = ("doc_full_tree", "Recupera a árvore completa de documentação.")
-    DOC_MOVE = ("doc_move", "Move um documento para outro pai.")
-    DOC_PUBLISH = ("doc_publish", "Altera status de publicação de um documento.")
-    DOC_VERSION = ("doc_version", "Gera ou recupera versão de um documento.")
-    DOC_DUPLICATE = ("doc_duplicate", "Duplica um documento existente.")
-
-    HELP = ("knowledge_help", "Mostra as ações disponíveis e seus usos.")
+    DOC_CREATE = ("doc_create", "Creates a documentation item.")
+    DOC_LIST = ("doc_list", "Lists documentation items with filters.")
+    DOC_GET = ("doc_get", "Gets documentation item details.")
+    DOC_UPDATE = ("doc_update", "Updates a documentation item.")
+    DOC_DELETE = ("doc_delete", "Removes a documentation item.")
+    DOC_SEARCH = ("doc_search", "Searches documentation items by text.")
+    DOC_ROOTS = ("doc_roots", "Lists available root documents.")
+    DOC_RECENT = ("doc_recent", "Lists recently accessed documents.")
+    DOC_ANALYTICS = ("doc_analytics", "Returns document analytics.")
+    DOC_CHILDREN = ("doc_children", "Lists child documents of an item.")
+    DOC_TREE = ("doc_tree", "Retrieves the direct tree of a document.")
+    DOC_FULL_TREE = ("doc_full_tree", "Retrieves the full documentation tree.")
+    DOC_MOVE = ("doc_move", "Moves a document to another parent.")
+    DOC_PUBLISH = ("doc_publish", "Changes publication status of a document.")
+    DOC_VERSION = ("doc_version", "Generates or retrieves a document version.")
+    DOC_DUPLICATE = ("doc_duplicate", "Duplicates an existing document.")
+
+    HELP = ("knowledge_help", "Shows available actions and their uses.")
 
     @classmethod
     def choices(cls) -> List[str]:
@@ -129,7 +134,7 @@ class KnowledgeAction(str, Enum):
     @classmethod
     def formatted_help(cls) -> str:
         lines = [
-            "| **Ação** | **Descrição** |",
+            "| **Action** | **Description** |",
             "| --- | --- |",
         ]
         for member in cls:
@@ -137,7 +142,7 @@ class KnowledgeAction(str, Enum):
         return "\n".join(lines)
 
 
-ACTION_FIELD_DESCRIPTION = "Ação de conhecimento. Escolha um dos valores: " + ", ".join(
+ACTION_FIELD_DESCRIPTION = "Knowledge action. Choose one of the values: " + ", ".join(
     f"`{member.value}` ({member.description.rstrip('.')})."
     for member in KnowledgeAction
 )
@@ -154,165 +159,158 @@ _ALLOWED_DOC_TYPES = {
 class KnowledgeRequest(ToolRequest):
     action: KnowledgeAction = Field(description=ACTION_FIELD_DESCRIPTION)
     id: Optional[UUIDStr] = Field(
-        default=None, description="ID principal do recurso (UUID)."
+        default=None, description="Primary resource ID (UUID)."
     )
-    limit: int = Field(default=20, ge=1, le=100, description="Limite de resultados.")
+    limit: int = Field(default=20, ge=1, le=100, description="Result limit.")
     offset: int = Field(
-        default=0, ge=0, description="Offset de paginação (quando suportado)."
-    )
-    team_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do time para filtros (UUID)."
+        default=0, ge=0, description="Pagination offset (when supported)."
     )
     board_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do board associado (UUID)."
+        default=None, description="Associated board ID (UUID)."
     )
     sprint_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do sprint associado (UUID)."
+        default=None, description="Associated sprint ID (UUID)."
     )
     epic_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do épico associado (UUID)."
+        default=None, description="Associated epic ID (UUID)."
     )
-    query: Optional[str] = Field(default=None, description="Filtro/busca.")
+    query: Optional[str] = Field(default=None, description="Filter/search term.")
     return_content: Optional[bool] = Field(
-        default=None, description="Retorna conteúdo completo."
+        default=None, description="Return full content."
     )
     return_description: Optional[bool] = Field(
-        default=None, description="Retorna descrição completa."
+        default=None, description="Return full description."
     )
     return_metadata: Optional[bool] = Field(
-        default=None, description="Retorna metadados completos."
+        default=None, description="Return full metadata."
     )
 
     # Work item fields
-    work_title: Optional[TitleStr] = Field(
-        default=None, description="Título do work item."
-    )
+    work_title: Optional[TitleStr] = Field(default=None, description="Work item title.")
     work_description: Optional[MarkdownStr] = Field(
-        default=None, description="Descrição do work item (Markdown)."
+        default=None, description="Work item description (Markdown)."
     )
     work_type: Optional[str] = Field(
         default="task",
-        description="Tipo do work item (epic, feature, story, task, subtask, bug).",
+        description="Work item type (epic, feature, story, task, subtask, bug).",
     )
     work_status: Optional[str] = Field(
         default=None,
-        description="Status do work item (backlog, todo, in_progress, review, testing, done, cancelled).",
+        description="Work item status (backlog, todo, in_progress, review, testing, done, cancelled).",
     )
     work_priority: Optional[str] = Field(
         default=None,
-        description="Prioridade do work item (critical, high, medium, low).",
+        description="Work item priority (critical, high, medium, low).",
     )
     story_points: Optional[int] = Field(
         default=None, ge=0, le=100, description="Story points (0-100)."
     )
     assignee_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do responsável (UUID)."
+        default=None, description="Assignee ID (UUID)."
     )
     parent_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do item pai (UUID)."
+        default=None, description="Parent item ID (UUID)."
     )
     work_due_date: Optional[DateTimeStr] = Field(
-        default=None, description="Data de vencimento do work item (ISO 8601)."
+        default=None, description="Work item due date (ISO 8601)."
     )
     work_tags: Optional[List[TagStr]] = Field(
-        default=None, description="Tags do work item."
+        default=None, description="Work item tags."
     )
     work_item_ids: Optional[List[UUIDStr]] = Field(
         default=None,
-        description="Lista de IDs de work items para operações em lote (UUIDs).",
+        description="List of work item IDs for batch operations (UUIDs).",
     )
 
     # Mode fields
     mode_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do modo relacionado (UUID)."
+        default=None, description="Related mode ID (UUID)."
     )
-    mode_name: Optional[TitleStr] = Field(default=None, description="Nome do modo.")
+    mode_name: Optional[TitleStr] = Field(default=None, description="Mode name.")
     mode_description: Optional[DescriptionStr] = Field(
-        default=None, description="Descrição do modo."
+        default=None, description="Mode description."
     )
     mode_content: Optional[MarkdownStr] = Field(
-        default=None, description="Conteúdo do modo (Markdown)."
+        default=None, description="Mode content (Markdown)."
     )
     mode_is_default: Optional[bool] = Field(
-        default=None, description="Indica se o modo é padrão."
+        default=None, description="Indicates if the mode is default."
     )
     mode_metadata: Optional[MarkdownStr] = Field(
-        default=None, description="Metadata do modo para processamento de IA."
+        default=None, description="Mode metadata for AI processing."
     )
 
     # Rule fields
     rule_id: Optional[UUIDStr] = Field(
-        default=None, description="ID da regra relacionada (UUID)."
+        default=None, description="Related rule ID (UUID)."
     )
-    rule_name: Optional[TitleStr] = Field(default=None, description="Nome da regra.")
+    rule_name: Optional[TitleStr] = Field(default=None, description="Rule name.")
     rule_description: Optional[DescriptionStr] = Field(
-        default=None, description="Descrição da regra."
+        default=None, description="Rule description."
     )
     rule_content: Optional[MarkdownStr] = Field(
-        default=None, description="Conteúdo da regra (Markdown)."
+        default=None, description="Rule content (Markdown)."
     )
-    rule_is_default: Optional[bool] = Field(default=None, description="Regra padrão.")
+    rule_is_default: Optional[bool] = Field(default=None, description="Default rule.")
     rule_metadata: Optional[MarkdownStr] = Field(
-        default=None, description="Metadata da regra para processamento de IA."
+        default=None, description="Rule metadata for AI processing."
     )
 
     # Documentation fields
     doc_title: Optional[TitleStr] = Field(
-        default=None, description="Título da documentação."
+        default=None, description="Documentation title."
     )
     doc_description: Optional[DescriptionStr] = Field(
-        default=None, description="Descrição da documentação."
+        default=None, description="Documentation description."
     )
     doc_content: Optional[MarkdownStr] = Field(
-        default=None, description="Conteúdo da documentação (Markdown)."
+        default=None, description="Documentation content (Markdown)."
     )
     doc_status: Optional[str] = Field(
         default=None,
-        description="Status da documentação (draft, review, published, archived).",
+        description="Documentation status (draft, review, published, archived).",
     )
     doc_type: Optional[str] = Field(
-        default=None, description="Tipo da documentação (folder, page, api_doc, guide)."
+        default=None,
+        description="Documentation type. Values: folder, page, api_doc, guide.",
     )
     doc_language: Optional[LanguageStr] = Field(
-        default=None, description="Idioma da documentação (ex: pt, en, pt-BR)."
+        default=None, description="Documentation language (e.g.: pt, en, pt-BR)."
     )
     doc_parent_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do documento pai (UUID)."
-    )
-    doc_team_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do time responsável pela documentação (UUID)."
+        default=None, description="Parent document ID (UUID)."
     )
     doc_owner_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do dono (UUID)."
+        default=None, description="Owner ID (UUID)."
     )
     doc_reviewer_id: Optional[UUIDStr] = Field(
-        default=None, description="ID do revisor (UUID)."
+        default=None, description="Reviewer ID (UUID)."
     )
     doc_version: Optional[VersionStr] = Field(
-        default=None, description="Versão do documento (ex: 1.0, 2.1.3)."
+        default=None, description="Document version (e.g.: 1.0, 2.1.3)."
     )
-    doc_category: Optional[CategoryStr] = Field(default=None, description="Categoria.")
+    doc_category: Optional[CategoryStr] = Field(default=None, description="Category.")
     doc_tags: Optional[List[TagStr]] = Field(default=None, description="Tags.")
     doc_position: Optional[int] = Field(
-        default=None, ge=0, description="Posição desejada ao mover documentos."
+        default=None, ge=0, description="Desired position when moving documents."
     )
     doc_emoji: Optional[EmojiStr] = Field(
-        default=None, description="Emoji exibido junto ao documento."
+        default=None, description="Emoji displayed with the document."
     )
     doc_emote: Optional[EmojiStr] = Field(
-        default=None, description="Alias para emoji, mantido por compatibilidade."
+        default=None, description="Alias for emoji, kept for compatibility."
     )
     doc_keywords: Optional[List[TagStr]] = Field(
-        default=None, description="Palavras-chave para busca."
+        default=None, description="Keywords for search."
     )
     doc_is_public: Optional[bool] = Field(
-        default=None, description="Se o documento é público."
+        default=None, description="Whether the document is public."
     )
 
 
 class KnowledgeTool(Tool):
     name = "knowledge"
-    description = "Operações de conhecimento do Fênix Cloud (Work Items, Boards, Sprints, Modes, Rules, Docs)."
+    description = "Fenix Cloud knowledge operations (Work Items, Boards, Sprints, Modes, Rules, Docs)."
     request_model = KnowledgeRequest
 
     def __init__(self, context: AppContext):
@@ -336,7 +334,7 @@ class KnowledgeTool(Tool):
         if action.value.startswith("doc_"):
             return await self._run_doc(payload)
         return text(
-            "❌ Ação inválida para knowledge.\n\nEscolha um dos valores:\n"
+            "❌ Invalid action for knowledge.\n\nChoose one of the values:\n"
             + "\n".join(f"- `{value}`" for value in KnowledgeAction.choices())
         )
 
@@ -347,9 +345,7 @@ class KnowledgeTool(Tool):
         action = payload.action
         if action is KnowledgeAction.WORK_CREATE:
             if not payload.work_title:
-                return text("❌ Informe work_title para criar o item.")
-            if not payload.team_id:
-                return text("❌ Informe team_id para criar o item.")
+                return text("❌ Provide work_title to create the item.")
             work = await self._service.work_create(
                 {
                     "title": payload.work_title,
@@ -362,12 +358,11 @@ class KnowledgeTool(Tool):
                     "sprint_id": payload.sprint_id,
                     "board_id": payload.board_id,
                     "parent_id": payload.parent_id,
-                    "team_id": payload.team_id,
                     "due_date": payload.work_due_date,
                     "tags": payload.work_tags,
                 }
             )
-            return text(_format_work(work, header="✅ Work item criado"))
+            return text(_format_work(work, header="✅ Work item created"))
 
         if action is KnowledgeAction.WORK_LIST:
             items = await self._service.work_list(
@@ -380,19 +375,19 @@ class KnowledgeTool(Tool):
                 board=payload.board_id,
             )
             if not items:
-                return text("🎯 Nenhum work item encontrado.")
+                return text("🎯 No work items found.")
             body = "\n\n".join(_format_work(item) for item in items)
             return text(f"🎯 **Work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_GET:
             if not payload.id:
-                return text("❌ Informe o ID do work item.")
+                return text("❌ Provide the work item ID.")
             work = await self._service.work_get(payload.id)
-            return text(_format_work(work, header="🎯 Detalhes do work item"))
+            return text(_format_work(work, header="🎯 Work item details"))
 
         if action is KnowledgeAction.WORK_UPDATE:
             if not payload.id:
-                return text("❌ Informe o ID do work item.")
+                return text("❌ Provide the work item ID.")
             work = await self._service.work_update(
                 payload.id,
                 {
@@ -406,102 +401,97 @@ class KnowledgeTool(Tool):
                     "sprint_id": payload.sprint_id,
                     "board_id": payload.board_id,
                     "parent_id": payload.parent_id,
-                    "team_id": payload.team_id,
                     "due_date": payload.work_due_date,
                     "tags": payload.work_tags,
                 },
             )
-            return text(_format_work(work, header="✅ Work item atualizado"))
+            return text(_format_work(work, header="✅ Work item updated"))
 
         if action is KnowledgeAction.WORK_DELETE:
             if not payload.id:
-                return text("❌ Informe o ID do work item.")
+                return text("❌ Provide the work item ID.")
             await self._service.work_delete(payload.id)
-            return text(f"🗑️ Work item {payload.id} removido.")
+            return text(f"🗑️ Work item {payload.id} removed.")
 
         if action is KnowledgeAction.WORK_BACKLOG:
-            if not payload.team_id:
-                return text("❌ Informe team_id para consultar o backlog.")
-            items = await self._service.work_backlog(team_id=payload.team_id)
+            items = await self._service.work_backlog()
             if not items:
-                return text("📋 Backlog vazio para o time informado.")
+                return text("📋 Backlog empty.")
             body = "\n\n".join(_format_work(item) for item in items)
             return text(f"📋 **Backlog ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_SEARCH:
-            if not payload.query or not payload.team_id:
-                return text("❌ Informe query e team_id para buscar work items.")
+            query = sanitize_null(payload.query)
+            if not query:
+                return text("❌ Provide query to search work items.")
             items = await self._service.work_search(
-                query=payload.query,
-                team_id=payload.team_id,
+                query=query,
                 limit=payload.limit,
             )
             if not items:
-                return text("🔍 Nenhum work item encontrado.")
+                return text("🔍 No work items found.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"🔍 **Resultados ({len(items)}):**\n\n{body}")
+            return text(f"🔍 **Results ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_ANALYTICS:
-            if not payload.team_id:
-                return text("❌ Informe team_id para obter analytics.")
-            analytics = await self._service.work_analytics(team_id=payload.team_id)
-            lines = ["📊 **Analytics de Work Items**"]
+            analytics = await self._service.work_analytics()
+            lines = ["📊 **Work Items Analytics**"]
             for key, value in analytics.items():
                 lines.append(f"- {key}: {value}")
             return text("\n".join(lines))
 
         if action is KnowledgeAction.WORK_BY_BOARD:
             if not payload.board_id:
-                return text("❌ Informe board_id para listar os itens.")
+                return text("❌ Provide board_id to list items.")
             items = await self._service.work_by_board(board_id=payload.board_id)
             if not items:
-                return text("🗂️ Nenhum work item para o board informado.")
+                return text("🗂️ No work items for the specified board.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"🗂️ **Itens do board ({len(items)}):**\n\n{body}")
+            return text(f"🗂️ **Board items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_BY_SPRINT:
             if not payload.sprint_id:
-                return text("❌ Informe sprint_id para listar os itens.")
+                return text("❌ Provide sprint_id to list items.")
             items = await self._service.work_by_sprint(sprint_id=payload.sprint_id)
             if not items:
-                return text("🏃 Nenhum item vinculado ao sprint informado.")
+                return text("🏃 No items linked to the specified sprint.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"🏃 **Work items do sprint ({len(items)}):**\n\n{body}")
+            return text(f"🏃 **Sprint work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_BY_EPIC:
             if not payload.epic_id:
-                return text("❌ Informe epic_id para listar os itens.")
+                return text("❌ Provide epic_id to list items.")
             items = await self._service.work_by_epic(epic_id=payload.epic_id)
             if not items:
-                return text("📦 Nenhum item vinculado ao épico informado.")
+                return text("📦 No items linked to the specified epic.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"📦 **Work items do épico ({len(items)}):**\n\n{body}")
+            return text(f"📦 **Epic work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_CHILDREN:
             if not payload.id:
-                return text("❌ Informe o ID do work item pai.")
+                return text("❌ Provide the parent work item ID.")
             items = await self._service.work_children(payload.id)
             if not items:
-                return text("👶 Nenhum item filho encontrado.")
+                return text("👶 No child items found.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"👶 **Work items filhos ({len(items)}):**\n\n{body}")
+            return text(f"👶 **Child work items ({len(items)}):**\n\n{body}")
 
         if action is KnowledgeAction.WORK_STATUS_UPDATE:
             if not payload.id:
-                return text("❌ Informe o ID do work item.")
+                return text("❌ Provide the work item ID.")
             if not payload.work_status:
-                return text("❌ Informe work_status para atualizar.")
+                return text("❌ Provide work_status to update.")
             work = await self._service.work_update_status(
                 payload.id,
                 {"status": payload.work_status},
             )
-            return text(_format_work(work, header="✅ Status atualizado"))
+            return text(_format_work(work, header="✅ Status updated"))
 
         if action is KnowledgeAction.WORK_ASSIGN_SPRINT:
             if not payload.sprint_id:
-                return text("❌ Informe sprint_id para atribuir os itens.")
+                return text("❌ Provide sprint_id to assign items.")
             if not payload.work_item_ids:
-                return text("❌ Informe work_item_ids com a lista de IDs.")
+                return text("❌ Provide work_item_ids with the list of IDs.")
             await self._service.work_assign_to_sprint(
                 {
                     "sprint_id": payload.sprint_id,
@@ -509,10 +499,10 @@ class KnowledgeTool(Tool):
                 }
             )
             count = len(payload.work_item_ids)
-            return text(f"✅ {count} work item(s) atribuído(s) ao sprint.")
+            return text(f"✅ {count} work item(s) assigned to sprint.")
 
         return text(
-            "❌ Ação de work item não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported work item action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -530,46 +520,44 @@ class KnowledgeTool(Tool):
                 limit=payload.limit, offset=payload.offset
             )
             if not boards:
-                return text("🗂️ Nenhum board encontrado.")
+                return text("🗂️ No boards found.")
             body = "\n\n".join(_format_board(board) for board in boards)
             return text(f"🗂️ **Boards ({len(boards)}):**\n\n{body}")
 
         if action is KnowledgeAction.BOARD_BY_TEAM:
-            if not payload.team_id:
-                return text("❌ Informe team_id para listar boards do time.")
-            boards = await self._service.board_list_by_team(payload.team_id)
+            boards = await self._service.board_list_by_team()
             if not boards:
-                return text("🗂️ Nenhum board cadastrado para o time.")
+                return text("🗂️ No boards registered for the team.")
             body = "\n\n".join(_format_board(board) for board in boards)
-            return text(f"🗂️ **Boards do time ({len(boards)}):**\n\n{body}")
+            return text(f"🗂️ **Team boards ({len(boards)}):**\n\n{body}")
 
         if action is KnowledgeAction.BOARD_FAVORITES:
             boards = await self._service.board_favorites()
             if not boards:
-                return text("⭐ Nenhum board favorito cadastrado.")
+                return text("⭐ No favorite boards registered.")
             body = "\n\n".join(_format_board(board) for board in boards)
-            return text(f"⭐ **Boards favoritos ({len(boards)}):**\n\n{body}")
+            return text(f"⭐ **Favorite boards ({len(boards)}):**\n\n{body}")
 
         if action is KnowledgeAction.BOARD_GET:
             if not payload.board_id:
-                return text("❌ Informe board_id para consultar detalhes.")
+                return text("❌ Provide board_id to get details.")
             board = await self._service.board_get(payload.board_id)
-            return text(_format_board(board, header="🗂️ Detalhes do board"))
+            return text(_format_board(board, header="🗂️ Board details"))
 
         if action is KnowledgeAction.BOARD_COLUMNS:
             if not payload.board_id:
-                return text("❌ Informe board_id para listar colunas.")
+                return text("❌ Provide board_id to list columns.")
             columns = await self._service.board_columns(payload.board_id)
             if not columns:
-                return text("📊 Board sem colunas cadastradas.")
+                return text("📊 Board has no columns registered.")
             body = "\n".join(
-                f"- {col.get('name', 'Sem nome')} (ID: {col.get('id')})"
+                f"- {col.get('name', 'Unnamed')} (ID: {col.get('id')})"
                 for col in columns
             )
-            return text(f"📊 **Colunas do board:**\n{body}")
+            return text(f"📊 **Board columns:**\n{body}")
 
         return text(
-            "❌ Ação de board não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported board action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -587,44 +575,40 @@ class KnowledgeTool(Tool):
                 limit=payload.limit, offset=payload.offset
             )
             if not sprints:
-                return text("🏃 Nenhum sprint encontrado.")
+                return text("🏃 No sprints found.")
             body = "\n\n".join(_format_sprint(sprint) for sprint in sprints)
             return text(f"🏃 **Sprints ({len(sprints)}):**\n\n{body}")
 
         if action is KnowledgeAction.SPRINT_BY_TEAM:
-            if not payload.team_id:
-                return text("❌ Informe team_id para listar sprints do time.")
-            sprints = await self._service.sprint_list_by_team(payload.team_id)
+            sprints = await self._service.sprint_list_by_team()
             if not sprints:
-                return text("🏃 Nenhum sprint cadastrado para o time.")
+                return text("🏃 No sprints registered for the team.")
             body = "\n\n".join(_format_sprint(sprint) for sprint in sprints)
-            return text(f"🏃 **Sprints do time ({len(sprints)}):**\n\n{body}")
+            return text(f"🏃 **Team sprints ({len(sprints)}):**\n\n{body}")
 
         if action is KnowledgeAction.SPRINT_ACTIVE:
-            if not payload.team_id:
-                return text("❌ Informe team_id para consultar o sprint ativo.")
-            sprint = await self._service.sprint_active(payload.team_id)
+            sprint = await self._service.sprint_active()
             if not sprint:
-                return text("⏳ Nenhum sprint ativo no momento.")
-            return text(_format_sprint(sprint, header="⏳ Sprint ativo"))
+                return text("⏳ No active sprint at the moment.")
+            return text(_format_sprint(sprint, header="⏳ Active sprint"))
 
         if action is KnowledgeAction.SPRINT_GET:
             if not payload.sprint_id:
-                return text("❌ Informe sprint_id para consultar detalhes.")
+                return text("❌ Provide sprint_id to get details.")
             sprint = await self._service.sprint_get(payload.sprint_id)
-            return text(_format_sprint(sprint, header="🏃 Detalhes do sprint"))
+            return text(_format_sprint(sprint, header="🏃 Sprint details"))
 
         if action is KnowledgeAction.SPRINT_WORK_ITEMS:
             if not payload.sprint_id:
-                return text("❌ Informe sprint_id para listar os itens.")
+                return text("❌ Provide sprint_id to list items.")
             items = await self._service.sprint_work_items(payload.sprint_id)
             if not items:
-                return text("🏃 Nenhum item vinculado ao sprint informado.")
+                return text("🏃 No items linked to the specified sprint.")
             body = "\n\n".join(_format_work(item) for item in items)
-            return text(f"🏃 **Itens do sprint ({len(items)}):**\n\n{body}")
+            return text(f"🏃 **Sprint items ({len(items)}):**\n\n{body}")
 
         return text(
-            "❌ Ação de sprint não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported sprint action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -639,7 +623,7 @@ class KnowledgeTool(Tool):
         action = payload.action
         if action is KnowledgeAction.MODE_CREATE:
             if not payload.mode_name:
-                return text("❌ Informe mode_name para criar o modo.")
+                return text("❌ Provide mode_name to create the mode.")
             mode = await self._service.mode_create(
                 {
                     "name": payload.mode_name,
@@ -649,7 +633,7 @@ class KnowledgeTool(Tool):
                     "metadata": payload.mode_metadata,
                 }
             )
-            return text(_format_mode(mode, header="✅ Modo criado"))
+            return text(_format_mode(mode, header="✅ Mode created"))
 
         if action is KnowledgeAction.MODE_LIST:
             modes = await self._service.mode_list(
@@ -658,23 +642,23 @@ class KnowledgeTool(Tool):
                 return_metadata=payload.return_metadata,
             )
             if not modes:
-                return text("🎭 Nenhum modo encontrado.")
+                return text("🎭 No modes found.")
             body = "\n\n".join(_format_mode(mode) for mode in modes)
             return text(f"🎭 **Modes ({len(modes)}):**\n\n{body}")
 
         if action is KnowledgeAction.MODE_GET:
             if not payload.mode_id:
-                return text("❌ Informe mode_id para consultar detalhes.")
+                return text("❌ Provide mode_id to get details.")
             mode = await self._service.mode_get(
                 payload.mode_id,
                 return_description=payload.return_description,
                 return_metadata=payload.return_metadata,
             )
-            return text(_format_mode(mode, header="🎭 Detalhes do modo"))
+            return text(_format_mode(mode, header="🎭 Mode details"))
 
         if action is KnowledgeAction.MODE_UPDATE:
             if not payload.mode_id:
-                return text("❌ Informe mode_id para atualizar.")
+                return text("❌ Provide mode_id to update.")
             mode = await self._service.mode_update(
                 payload.mode_id,
                 {
@@ -685,53 +669,53 @@ class KnowledgeTool(Tool):
                     "metadata": payload.mode_metadata,
                 },
             )
-            return text(_format_mode(mode, header="✅ Modo atualizado"))
+            return text(_format_mode(mode, header="✅ Mode updated"))
 
         if action is KnowledgeAction.MODE_DELETE:
             if not payload.mode_id:
-                return text("❌ Informe mode_id para remover.")
+                return text("❌ Provide mode_id to remove.")
             await self._service.mode_delete(payload.mode_id)
-            return text(f"🗑️ Modo {payload.mode_id} removido.")
+            return text(f"🗑️ Mode {payload.mode_id} removed.")
 
         if action is KnowledgeAction.MODE_RULE_ADD:
             if not payload.mode_id or not payload.rule_id:
-                return text("❌ Informe mode_id e rule_id para associar.")
+                return text("❌ Provide mode_id and rule_id to associate.")
             link = await self._service.mode_rule_add(payload.mode_id, payload.rule_id)
             return text(
                 "\n".join(
                     [
-                        "🔗 **Regra associada ao modo!**",
-                        f"Modo: {link.get('modeId', payload.mode_id)}",
-                        f"Regra: {link.get('ruleId', payload.rule_id)}",
+                        "🔗 **Rule associated with mode!**",
+                        f"Mode: {link.get('modeId', payload.mode_id)}",
+                        f"Rule: {link.get('ruleId', payload.rule_id)}",
                     ]
                 )
             )
 
         if action is KnowledgeAction.MODE_RULE_REMOVE:
             if not payload.mode_id or not payload.rule_id:
-                return text("❌ Informe mode_id e rule_id para remover a associação.")
+                return text("❌ Provide mode_id and rule_id to remove the association.")
             await self._service.mode_rule_remove(payload.mode_id, payload.rule_id)
-            return text("🔗 Associação removida.")
+            return text("🔗 Association removed.")
 
         if action is KnowledgeAction.MODE_RULES:
             if payload.mode_id:
                 rules = await self._service.mode_rules(payload.mode_id)
-                context_label = f"modo {payload.mode_id}"
+                context_label = f"mode {payload.mode_id}"
             elif payload.rule_id:
                 rules = await self._service.mode_rules_for_rule(payload.rule_id)
-                context_label = f"regra {payload.rule_id}"
+                context_label = f"rule {payload.rule_id}"
             else:
-                return text("❌ Informe mode_id ou rule_id para listar associações.")
+                return text("❌ Provide mode_id or rule_id to list associations.")
             if not rules:
-                return text("🔗 Nenhuma associação encontrada.")
+                return text("🔗 No associations found.")
             body = "\n".join(
-                f"- {item.get('name', 'Sem nome')} (ID: {item.get('id')})"
+                f"- {item.get('name', 'Unnamed')} (ID: {item.get('id')})"
                 for item in rules
             )
-            return text(f"🔗 **Associações para {context_label}:**\n{body}")
+            return text(f"🔗 **Associations for {context_label}:**\n{body}")
 
         return text(
-            "❌ Ação de modo não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported mode action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -746,7 +730,7 @@ class KnowledgeTool(Tool):
         action = payload.action
         if action is KnowledgeAction.RULE_CREATE:
             if not payload.rule_name or not payload.rule_content:
-                return text("❌ Informe rule_name e rule_content.")
+                return text("❌ Provide rule_name and rule_content.")
             rule = await self._service.rule_create(
                 {
                     "name": payload.rule_name,
@@ -756,7 +740,7 @@ class KnowledgeTool(Tool):
                     "metadata": payload.rule_metadata,
                 }
             )
-            return text(_format_rule(rule, header="✅ Regra criada"))
+            return text(_format_rule(rule, header="✅ Rule created"))
 
         if action is KnowledgeAction.RULE_LIST:
             rules = await self._service.rule_list(
@@ -765,24 +749,24 @@ class KnowledgeTool(Tool):
                 return_modes=payload.return_metadata,
             )
             if not rules:
-                return text("📋 Nenhuma regra encontrada.")
+                return text("📋 No rules found.")
             body = "\n\n".join(_format_rule(rule) for rule in rules)
-            return text(f"📋 **Regras ({len(rules)}):**\n\n{body}")
+            return text(f"📋 **Rules ({len(rules)}):**\n\n{body}")
 
         if action is KnowledgeAction.RULE_GET:
             if not payload.rule_id:
-                return text("❌ Informe rule_id para consultar detalhes.")
+                return text("❌ Provide rule_id to get details.")
             rule = await self._service.rule_get(
                 payload.rule_id,
                 return_description=payload.return_description,
                 return_metadata=payload.return_metadata,
                 return_modes=payload.return_metadata,
             )
-            return text(_format_rule(rule, header="📋 Detalhes da regra"))
+            return text(_format_rule(rule, header="📋 Rule details"))
 
         if action is KnowledgeAction.RULE_UPDATE:
             if not payload.rule_id:
-                return text("❌ Informe rule_id para atualizar.")
+                return text("❌ Provide rule_id to update.")
             rule = await self._service.rule_update(
                 payload.rule_id,
                 {
@@ -793,16 +777,16 @@ class KnowledgeTool(Tool):
                     "metadata": payload.rule_metadata,
                 },
             )
-            return text(_format_rule(rule, header="✅ Regra atualizada"))
+            return text(_format_rule(rule, header="✅ Rule updated"))
 
         if action is KnowledgeAction.RULE_DELETE:
             if not payload.rule_id:
-                return text("❌ Informe rule_id para remover.")
+                return text("❌ Provide rule_id to remove.")
             await self._service.rule_delete(payload.rule_id)
-            return text(f"🗑️ Regra {payload.rule_id} removida.")
+            return text(f"🗑️ Rule {payload.rule_id} removed.")
 
         return text(
-            "❌ Ação de regra não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported rule action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -817,33 +801,32 @@ class KnowledgeTool(Tool):
         action = payload.action
         if action is KnowledgeAction.DOC_CREATE:
             if not payload.doc_title:
-                return text("❌ Informe doc_title para criar a documentação.")
+                return text("❌ Provide doc_title to create the documentation.")
             if payload.doc_type and payload.doc_type not in _ALLOWED_DOC_TYPES:
                 allowed = ", ".join(sorted(_ALLOWED_DOC_TYPES))
                 return text(
-                    "❌ doc_type inválido. Use um dos valores suportados: " + allowed
+                    "❌ Invalid doc_type. Use one of the supported values: " + allowed
                 )
             doc = await self._service.doc_create(
                 {
                     "title": payload.doc_title,
-                    "description": payload.doc_description,
-                    "content": payload.doc_content,
-                    "status": payload.doc_status,
-                    "doc_type": payload.doc_type,
-                    "language": payload.doc_language,
-                    "parent_id": payload.doc_parent_id,
-                    "team_id": payload.doc_team_id or payload.team_id,
-                    "owner_user_id": payload.doc_owner_id,
-                    "reviewer_user_id": payload.doc_reviewer_id,
-                    "version": payload.doc_version,
-                    "category": payload.doc_category,
-                    "tags": payload.doc_tags,
-                    "emoji": payload.doc_emoji or payload.doc_emote,
-                    "keywords": payload.doc_keywords,
+                    "description": sanitize_null(payload.doc_description),
+                    "content": sanitize_null(payload.doc_content),
+                    "status": sanitize_null(payload.doc_status),
+                    "doc_type": sanitize_null(payload.doc_type),
+                    "language": sanitize_null(payload.doc_language),
+                    "parent_id": sanitize_null(payload.doc_parent_id),
+                    "owner_user_id": sanitize_null(payload.doc_owner_id),
+                    "reviewer_user_id": sanitize_null(payload.doc_reviewer_id),
+                    "version": sanitize_null(payload.doc_version),
+                    "category": sanitize_null(payload.doc_category),
+                    "tags": sanitize_null_list(payload.doc_tags),
+                    "emoji": sanitize_null(payload.doc_emoji or payload.doc_emote),
+                    "keywords": sanitize_null_list(payload.doc_keywords),
                     "is_public": payload.doc_is_public,
                 }
             )
-            return text(_format_doc(doc, header="✅ Documentação criada"))
+            return text(_format_doc(doc, header="✅ Documentation created"))
 
         if action is KnowledgeAction.DOC_LIST:
             docs = await self._service.doc_list(
@@ -852,156 +835,140 @@ class KnowledgeTool(Tool):
                 returnContent=payload.return_content,
             )
             if not docs:
-                return text("📄 Nenhuma documentação encontrada.")
+                return text("📄 No documentation found.")
             body = "\n\n".join(_format_doc(doc) for doc in docs)
-            return text(f"📄 **Documentos ({len(docs)}):**\n\n{body}")
+            return text(f"📄 **Documents ({len(docs)}):**\n\n{body}")
 
         if action is KnowledgeAction.DOC_GET:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             doc = await self._service.doc_get(
                 payload.id,
                 returnContent=payload.return_content,
             )
-            return text(_format_doc(doc, header="📄 Detalhes da documentação"))
+            return text(_format_doc(doc, header="📄 Documentation details"))
 
         if action is KnowledgeAction.DOC_UPDATE:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             if payload.doc_type and payload.doc_type not in _ALLOWED_DOC_TYPES:
                 allowed = ", ".join(sorted(_ALLOWED_DOC_TYPES))
                 return text(
-                    "❌ doc_type inválido. Use um dos valores suportados: " + allowed
+                    "❌ Invalid doc_type. Use one of the supported values: " + allowed
                 )
             doc = await self._service.doc_update(
                 payload.id,
                 {
-                    "title": payload.doc_title,
-                    "description": payload.doc_description,
-                    "content": payload.doc_content,
-                    "status": payload.doc_status,
-                    "doc_type": payload.doc_type,
-                    "language": payload.doc_language,
-                    "parent_id": payload.doc_parent_id,
-                    "team_id": payload.doc_team_id or payload.team_id,
-                    "owner_user_id": payload.doc_owner_id,
-                    "reviewer_user_id": payload.doc_reviewer_id,
-                    "version": payload.doc_version,
-                    "category": payload.doc_category,
-                    "tags": payload.doc_tags,
-                    "emoji": payload.doc_emoji or payload.doc_emote,
-                    "keywords": payload.doc_keywords,
+                    "title": sanitize_null(payload.doc_title),
+                    "description": sanitize_null(payload.doc_description),
+                    "content": sanitize_null(payload.doc_content),
+                    "status": sanitize_null(payload.doc_status),
+                    "doc_type": sanitize_null(payload.doc_type),
+                    "language": sanitize_null(payload.doc_language),
+                    "parent_id": sanitize_null(payload.doc_parent_id),
+                    "owner_user_id": sanitize_null(payload.doc_owner_id),
+                    "reviewer_user_id": sanitize_null(payload.doc_reviewer_id),
+                    "version": sanitize_null(payload.doc_version),
+                    "category": sanitize_null(payload.doc_category),
+                    "tags": sanitize_null_list(payload.doc_tags),
+                    "emoji": sanitize_null(payload.doc_emoji or payload.doc_emote),
+                    "keywords": sanitize_null_list(payload.doc_keywords),
                     "is_public": payload.doc_is_public,
                 },
             )
-            return text(_format_doc(doc, header="✅ Documentação atualizada"))
+            return text(_format_doc(doc, header="✅ Documentation updated"))
 
         if action is KnowledgeAction.DOC_DELETE:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             await self._service.doc_delete(payload.id)
-            return text(f"🗑️ Documentação {payload.id} removida.")
+            return text(f"🗑️ Documentation {payload.id} removed.")
 
         if action is KnowledgeAction.DOC_SEARCH:
-            if not payload.query or not (payload.doc_team_id or payload.team_id):
-                return text("❌ Informe query e team_id para buscar documentação.")
+            query = sanitize_null(payload.query)
+            if not query:
+                return text("❌ Provide query to search documentation.")
             docs = await self._service.doc_search(
-                query=payload.query,
-                team_id=payload.doc_team_id or payload.team_id,
+                query=query,
                 limit=payload.limit,
             )
             if not docs:
-                return text(
-                    "🔍 Nenhum documento encontrado para os filtros informados."
-                )
+                return text("🔍 No documents found for the specified filters.")
             body = "\n\n".join(_format_doc(doc) for doc in docs)
-            return text(f"🔍 **Resultados ({len(docs)}):**\n\n{body}")
+            return text(f"🔍 **Results ({len(docs)}):**\n\n{body}")
 
         if action is KnowledgeAction.DOC_ROOTS:
-            if not (payload.doc_team_id or payload.team_id):
-                return text("❌ Informe team_id para listar raízes.")
-            docs = await self._service.doc_roots(
-                team_id=payload.doc_team_id or payload.team_id
-            )
+            docs = await self._service.doc_roots()
             if not docs:
-                return text("📚 Nenhuma raiz encontrada.")
+                return text("📚 No roots found.")
             body = "\n".join(
-                f"- {doc.get('title', 'Sem título')} (ID: {doc.get('id')})"
+                f"- {doc.get('title', 'Untitled')} (ID: {doc.get('id')})"
                 for doc in docs
             )
-            return text(f"📚 **Raízes de documentação:**\n{body}")
+            return text(f"📚 **Documentation roots:**\n{body}")
 
         if action is KnowledgeAction.DOC_RECENT:
-            if not (payload.doc_team_id or payload.team_id):
-                return text("❌ Informe team_id para listar documentos recentes.")
             docs = await self._service.doc_recent(
-                team_id=payload.doc_team_id or payload.team_id,
                 limit=payload.limit,
             )
             if not docs:
-                return text("🕒 Nenhuma documentação recente encontrada.")
+                return text("🕒 No recent documentation found.")
             body = "\n\n".join(_format_doc(doc) for doc in docs)
-            return text(f"🕒 **Documentos recentes ({len(docs)}):**\n\n{body}")
+            return text(f"🕒 **Recent documents ({len(docs)}):**\n\n{body}")
 
         if action is KnowledgeAction.DOC_ANALYTICS:
-            if not (payload.doc_team_id or payload.team_id):
-                return text("❌ Informe team_id para obter analytics.")
-            analytics = await self._service.doc_analytics(
-                team_id=payload.doc_team_id or payload.team_id
-            )
-            lines = ["📊 **Analytics de Documentação**"]
+            analytics = await self._service.doc_analytics()
+            lines = ["📊 **Documentation Analytics**"]
             for key, value in analytics.items():
                 lines.append(f"- {key}: {value}")
             return text("\n".join(lines))
 
         if action is KnowledgeAction.DOC_CHILDREN:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             docs = await self._service.doc_children(payload.id)
             if not docs:
-                return text("📄 Nenhum filho cadastrado para o documento informado.")
+                return text("📄 No children registered for the specified document.")
             body = "\n".join(
-                f"- {doc.get('title', 'Sem título')} (ID: {doc.get('id')})"
+                f"- {doc.get('title', 'Untitled')} (ID: {doc.get('id')})"
                 for doc in docs
             )
-            return text(f"📄 **Filhos:**\n{body}")
+            return text(f"📄 **Children:**\n{body}")
 
         if action is KnowledgeAction.DOC_TREE:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             tree = await self._service.doc_tree(payload.id)
-            return text(f"🌳 **Árvore de documentação para {payload.id}:**\n{tree}")
+            return text(f"🌳 **Documentation tree for {payload.id}:**\n{tree}")
 
         if action is KnowledgeAction.DOC_FULL_TREE:
             tree = await self._service.doc_full_tree()
-            return text(f"🌳 **Árvore completa de documentação:**\n{tree}")
+            return text(f"🌳 **Full documentation tree:**\n{tree}")
 
         if action is KnowledgeAction.DOC_MOVE:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             if payload.doc_parent_id is None and payload.doc_position is None:
-                return text(
-                    "❌ Informe doc_parent_id, doc_position ou ambos para mover."
-                )
+                return text("❌ Provide doc_parent_id, doc_position or both to move.")
             move_payload = {
                 "new_parent_id": payload.doc_parent_id,
                 "new_position": payload.doc_position,
             }
             doc = await self._service.doc_move(payload.id, move_payload)
-            return text(_format_doc(doc, header="📦 Documentação movida"))
+            return text(_format_doc(doc, header="📦 Documentation moved"))
 
         if action is KnowledgeAction.DOC_PUBLISH:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             result = await self._service.doc_publish(payload.id)
-            return text(f"🗞️ Documento publicado: {result}")
+            return text(f"🗞️ Document published: {result}")
 
         if action is KnowledgeAction.DOC_VERSION:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             if not payload.doc_version:
                 return text(
-                    "❌ Informe doc_version com o número/identificador da versão."
+                    "❌ Provide doc_version with the version number/identifier."
                 )
             version_payload = {
                 "title": payload.doc_title or f"Version {payload.doc_version}",
@@ -1009,24 +976,23 @@ class KnowledgeTool(Tool):
                 "content": payload.doc_content,
             }
             doc = await self._service.doc_version(payload.id, version_payload)
-            return text(_format_doc(doc, header="🗞️ Nova versão criada"))
+            return text(_format_doc(doc, header="🗞️ New version created"))
 
         if action is KnowledgeAction.DOC_DUPLICATE:
             if not payload.id:
-                return text("❌ Informe o ID da documentação.")
+                return text("❌ Provide the documentation ID.")
             if not payload.doc_title:
-                return text("❌ Informe doc_title para nomear a cópia.")
+                return text("❌ Provide doc_title to name the copy.")
             doc = await self._service.doc_duplicate(
                 payload.id,
                 {
                     "title": payload.doc_title,
-                    "team_id": payload.doc_team_id or payload.team_id,
                 },
             )
-            return text(_format_doc(doc, header="🗂️ Documento duplicado"))
+            return text(_format_doc(doc, header="🗂️ Document duplicated"))
 
         return text(
-            "❌ Ação de documentação não suportada.\n\nEscolha um dos valores:\n"
+            "❌ Unsupported documentation action.\n\nChoose one of the values:\n"
             + "\n".join(
                 f"- `{value}`"
                 for value in KnowledgeAction.choices()
@@ -1036,7 +1002,7 @@ class KnowledgeTool(Tool):
 
     async def _handle_help(self):
         return text(
-            "📚 **Ações disponíveis para knowledge**\n\n"
+            "📚 **Available actions for knowledge**\n\n"
             + KnowledgeAction.formatted_help()
         )
 
@@ -1048,13 +1014,13 @@ def _format_work(item: Dict[str, Any], *, header: Optional[str] = None) -> str:
         lines.append("")
 
     # Extract title
-    title = item.get("title") or item.get("name") or "Sem título"
+    title = item.get("title") or item.get("name") or "Untitled"
 
     # Extract status
-    status = item.get("status") or item.get("state") or "desconhecido"
+    status = item.get("status") or item.get("state") or "unknown"
 
     # Extract priority
-    priority = item.get("priority") or item.get("priority_level") or "indefinido"
+    priority = item.get("priority") or item.get("priority_level") or "undefined"
 
     # Extract ID
     item_id = item.get("id", "N/A")
@@ -1073,13 +1039,13 @@ def _format_work(item: Dict[str, Any], *, header: Optional[str] = None) -> str:
             f"🎯 **{title}**",
             f"ID: {item_id}",
             f"Status: {status}",
-            f"Prioridade: {priority}",
-            f"Responsável: {assignee}",
+            f"Priority: {priority}",
+            f"Assignee: {assignee}",
         ]
     )
     if item.get("due_date") or item.get("dueDate"):
         lines.append(
-            f"Vencimento: {_format_date(item.get('due_date') or item.get('dueDate'))}"
+            f"Due date: {_format_date(item.get('due_date') or item.get('dueDate'))}"
         )
     if item.get("tags"):
         tags = item.get("tags", [])
@@ -1095,10 +1061,10 @@ def _format_board(board: Dict[str, Any], header: Optional[str] = None) -> str:
         lines.append("")
     lines.extend(
         [
-            f"🗂️ **{board.get('name', 'Sem nome')}**",
+            f"🗂️ **{board.get('name', 'Unnamed')}**",
             f"ID: {board.get('id', 'N/A')}",
-            f"Time: {board.get('team_id', 'N/A')}",
-            f"Colunas: {len(board.get('columns', []))}",
+            f"Team: {board.get('team_id', 'N/A')}",
+            f"Columns: {len(board.get('columns', []))}",
         ]
     )
     return "\n".join(lines)
@@ -1111,19 +1077,19 @@ def _format_sprint(sprint: Dict[str, Any], header: Optional[str] = None) -> str:
         lines.append("")
     lines.extend(
         [
-            f"🏃 **{sprint.get('name', 'Sem nome')}**",
+            f"🏃 **{sprint.get('name', 'Unnamed')}**",
             f"ID: {sprint.get('id', 'N/A')}",
             f"Status: {sprint.get('status', 'N/A')}",
-            f"Time: {sprint.get('team_id', 'N/A')}",
+            f"Team: {sprint.get('team_id', 'N/A')}",
         ]
     )
     if sprint.get("start_date") or sprint.get("startDate"):
         lines.append(
-            f"Início: {_format_date(sprint.get('start_date') or sprint.get('startDate'))}"
+            f"Start: {_format_date(sprint.get('start_date') or sprint.get('startDate'))}"
         )
     if sprint.get("end_date") or sprint.get("endDate"):
         lines.append(
-            f"Fim: {_format_date(sprint.get('end_date') or sprint.get('endDate'))}"
+            f"End: {_format_date(sprint.get('end_date') or sprint.get('endDate'))}"
         )
     return "\n".join(lines)
 
@@ -1135,13 +1101,13 @@ def _format_mode(mode: Dict[str, Any], header: Optional[str] = None) -> str:
         lines.append("")
     lines.extend(
         [
-            f"🎭 **{mode.get('name', 'Sem nome')}**",
+            f"🎭 **{mode.get('name', 'Unnamed')}**",
             f"ID: {mode.get('id', 'N/A')}",
-            f"Padrão: {mode.get('is_default', False)}",
+            f"Default: {mode.get('is_default', False)}",
         ]
     )
     if mode.get("description"):
-        lines.append(f"Descrição: {mode['description']}")
+        lines.append(f"Description: {mode['description']}")
     return "\n".join(lines)
 
 
@@ -1152,13 +1118,13 @@ def _format_rule(rule: Dict[str, Any], header: Optional[str] = None) -> str:
         lines.append("")
     lines.extend(
         [
-            f"📋 **{rule.get('name', 'Sem nome')}**",
+            f"📋 **{rule.get('name', 'Unnamed')}**",
             f"ID: {rule.get('id', 'N/A')}",
-            f"Padrão: {rule.get('is_default', False)}",
+            f"Default: {rule.get('is_default', False)}",
         ]
     )
     if rule.get("description"):
-        lines.append(f"Descrição: {rule['description']}")
+        lines.append(f"Description: {rule['description']}")
     return "\n".join(lines)
 
 
@@ -1169,15 +1135,15 @@ def _format_doc(doc: Dict[str, Any], header: Optional[str] = None) -> str:
         lines.append("")
     lines.extend(
         [
-            f"📄 **{doc.get('title') or doc.get('name', 'Sem título')}**",
+            f"📄 **{doc.get('title') or doc.get('name', 'Untitled')}**",
             f"ID: {doc.get('id', 'N/A')}",
             f"Status: {doc.get('status', 'N/A')}",
-            f"Time: {doc.get('team_id', 'N/A')}",
+            f"Team: {doc.get('team_id', 'N/A')}",
         ]
     )
     if doc.get("updated_at") or doc.get("updatedAt"):
         lines.append(
-            f"Atualizado em: {_format_date(doc.get('updated_at') or doc.get('updatedAt'))}"
+            f"Updated at: {_format_date(doc.get('updated_at') or doc.get('updatedAt'))}"
         )
     return "\n".join(lines)