fenix-mcp 0.1.0__tar.gz → 0.2.1__tar.gz

{fenix_mcp-0.1.0/fenix_mcp.egg-info → fenix_mcp-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 0.1.0
+Version: 0.2.1
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10
@@ -13,6 +13,11 @@ Requires-Dist: pydantic-settings>=2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
 
 # Fênix MCP — Live Access to Fênix Cloud Data
 
@@ -132,17 +137,61 @@ Set `FENIX_TRANSPORT_MODE=both` to run STDIO and HTTP simultaneously. The defaul
 
 > Copy `.env.example` to `.env` for easier customization.
 
-## 🧪 Local Testing
+
+## 🧪 Development
+
+### Local Testing
 
 ```bash
+# Install development dependencies
 pip install -e .[dev]
+
+# Run tests
 pytest
+
+# Run with coverage
+pytest --cov=fenix_mcp --cov-report=html
+
+# Run linting
+flake8 fenix_mcp/ tests/
+black --check fenix_mcp/ tests/
+
+# Run type checking
+mypy fenix_mcp/
+
+# Format code
+black fenix_mcp/ tests/
 ```
 
+### Pre-commit Hooks (Optional)
+
+```bash
+# Install pre-commit
+pip install pre-commit
+
+# Install hooks
+pre-commit install
+
+# Run on all files
+pre-commit run --all-files
+```
+
+### Commit Convention
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `fix:` - Bug fixes (patch version bump)
+- `feat:` - New features (minor version bump)
+- `BREAKING CHANGE:` - Breaking changes (major version bump)
+- `chore:` - Maintenance tasks
+- `docs:` - Documentation changes
+- `test:` - Test additions/changes
+
 ## 🔄 Automation
 
-- **CI (GitHub Actions)** – runs on pushes and pull requests targeting `main`. It installs dependencies, runs `pytest`, builds the distribution artifacts, and uploads them as workflow artifacts.
-- **Publish workflow** – push a tag `v*` (or trigger the "Publish" workflow manually) to build the package and, if `PYPI_API_TOKEN` is set in repository secrets, upload artifacts to PyPI via `twine`.
+- **CI (GitHub Actions)** – runs on pushes and pull requests targeting `main`. It installs dependencies, runs tests on Python 3.11, enforces flake8/black/mypy, generates coverage, builds the distribution (`python -m build`) and, on pushes, uploads artifacts for debugging.
+
+- **Semantic Release** – after the CI job succeeds on `main`, the workflow installs the required `semantic-release` plugins and runs `npx semantic-release`. Conventional Commits decide the next version, `scripts/bump_version.py` updates `fenix_mcp.__version__`, the build artifacts are regenerated, and release notes/assets are published to GitHub and PyPI (using `PYPI_API_TOKEN`). If no eligible commit (`feat`, `fix`, or `BREAKING CHANGE`) exists since the last tag, no new release is produced.
 
 ## 🧰 Available Tools
 
@@ -200,8 +249,9 @@ STDIO stays active for MCP clients; HTTP will listen on `FENIX_HTTP_HOST:FENIX_H
 1. Fork the repository
 2. Create a branch: `git checkout -b feat/my-feature`
 3. Install dev dependencies: `pip install -e .[dev]`
-4. Run `pytest`
-5. Open a Pull Request describing your changes
+4. Use Conventional Commits (`feat:`, `fix:`, or `BREAKING CHANGE:`) so Semantic Release can infer the next version.
+5. Run `pytest`
+6. Open a Pull Request describing your changes
 
 ## 📄 License
 

fenix_mcp-0.1.0/PKG-INFO → fenix_mcp-0.2.1/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: fenix-mcp
-Version: 0.1.0
-Summary: Fênix Cloud MCP server implemented in Python
-Author: Fenix Inc
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: pydantic>=2.5
-Requires-Dist: requests>=2.31
-Requires-Dist: urllib3>=2.0
-Requires-Dist: aiohttp>=3.9
-Requires-Dist: pydantic-settings>=2.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-
 # Fênix MCP — Live Access to Fênix Cloud Data
 
 [![PyPI](https://img.shields.io/pypi/v/fenix-mcp.svg)](https://pypi.org/project/fenix-mcp/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
@@ -132,17 +116,61 @@ Set `FENIX_TRANSPORT_MODE=both` to run STDIO and HTTP simultaneously. The defaul
 
 > Copy `.env.example` to `.env` for easier customization.
 
-## 🧪 Local Testing
+
+## 🧪 Development
+
+### Local Testing
 
 ```bash
+# Install development dependencies
 pip install -e .[dev]
+
+# Run tests
 pytest
+
+# Run with coverage
+pytest --cov=fenix_mcp --cov-report=html
+
+# Run linting
+flake8 fenix_mcp/ tests/
+black --check fenix_mcp/ tests/
+
+# Run type checking
+mypy fenix_mcp/
+
+# Format code
+black fenix_mcp/ tests/
+```
+
+### Pre-commit Hooks (Optional)
+
+```bash
+# Install pre-commit
+pip install pre-commit
+
+# Install hooks
+pre-commit install
+
+# Run on all files
+pre-commit run --all-files
 ```
 
+### Commit Convention
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `fix:` - Bug fixes (patch version bump)
+- `feat:` - New features (minor version bump)
+- `BREAKING CHANGE:` - Breaking changes (major version bump)
+- `chore:` - Maintenance tasks
+- `docs:` - Documentation changes
+- `test:` - Test additions/changes
+
 ## 🔄 Automation
 
-- **CI (GitHub Actions)** – runs on pushes and pull requests targeting `main`. It installs dependencies, runs `pytest`, builds the distribution artifacts, and uploads them as workflow artifacts.
-- **Publish workflow** – push a tag `v*` (or trigger the "Publish" workflow manually) to build the package and, if `PYPI_API_TOKEN` is set in repository secrets, upload artifacts to PyPI via `twine`.
+- **CI (GitHub Actions)** – runs on pushes and pull requests targeting `main`. It installs dependencies, runs tests on Python 3.11, enforces flake8/black/mypy, generates coverage, builds the distribution (`python -m build`) and, on pushes, uploads artifacts for debugging.
+
+- **Semantic Release** – after the CI job succeeds on `main`, the workflow installs the required `semantic-release` plugins and runs `npx semantic-release`. Conventional Commits decide the next version, `scripts/bump_version.py` updates `fenix_mcp.__version__`, the build artifacts are regenerated, and release notes/assets are published to GitHub and PyPI (using `PYPI_API_TOKEN`). If no eligible commit (`feat`, `fix`, or `BREAKING CHANGE`) exists since the last tag, no new release is produced.
 
 ## 🧰 Available Tools
 
@@ -200,8 +228,9 @@ STDIO stays active for MCP clients; HTTP will listen on `FENIX_HTTP_HOST:FENIX_H
 1. Fork the repository
 2. Create a branch: `git checkout -b feat/my-feature`
 3. Install dev dependencies: `pip install -e .[dev]`
-4. Run `pytest`
-5. Open a Pull Request describing your changes
+4. Use Conventional Commits (`feat:`, `fix:`, or `BREAKING CHANGE:`) so Semantic Release can infer the next version.
+5. Run `pytest`
+6. Open a Pull Request describing your changes
 
 ## 📄 License
 

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/__init__.py

@@ -10,8 +10,11 @@ This package follows a Clean Architecture layout inside the MCP ecosystem:
 - application: tools, registries, presenters and use-case orchestrators
 - domain: pure business models and services
 - infrastructure: API clients, config, logging and shared context
+
+Version 0.1.0 - Initial release with basic MCP functionality.
+Updated with improved error handling and better documentation.
 """
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/application/tool_base.py

@@ -35,7 +35,9 @@ class Tool(ABC):
             "inputSchema": self.request_model.model_json_schema(),
         }
 
-    async def execute(self, raw_arguments: Dict[str, Any], context: AppContext) -> ToolResponse:
+    async def execute(
+        self, raw_arguments: Dict[str, Any], context: AppContext
+    ) -> ToolResponse:
         """Validate raw arguments and run the tool."""
         payload = self.request_model.model_validate(raw_arguments or {})
         return await self.run(payload, context)
@@ -43,4 +45,3 @@ class Tool(ABC):
     @abstractmethod
     async def run(self, payload: ToolRequest, context: AppContext) -> ToolResponse:
         """Execute business logic and return a MCP-formatted response."""
-

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/application/tool_registry.py

@@ -22,7 +22,9 @@ class ToolRegistry:
     def list_definitions(self) -> List[dict]:
         return [tool.schema() for tool in self._tools.values()]
 
-    async def execute(self, name: str, arguments: dict, context: AppContext) -> ToolResponse:
+    async def execute(
+        self, name: str, arguments: dict, context: AppContext
+    ) -> ToolResponse:
         try:
             tool = self._tools[name]
         except KeyError as exc:

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/application/tools/health.py

@@ -3,9 +3,7 @@
 
 from __future__ import annotations
 
-from pydantic import BaseModel
-
-from fenix_mcp.application.presenters import key_value, text
+from fenix_mcp.application.presenters import key_value
 from fenix_mcp.application.tool_base import Tool, ToolRequest
 from fenix_mcp.infrastructure.context import AppContext
 

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/application/tools/initialize.py

@@ -21,26 +21,35 @@ class InitializeAction(str, Enum):
 
 
 class InitializeRequest(ToolRequest):
-    action: InitializeAction = Field(description="Operação de inicialização a executar.")
+    action: InitializeAction = Field(
+        description="Operação de inicialização a executar."
+    )
     include_user_docs: bool = Field(
         default=True,
-        description="Inclui documentos pessoais durante a inicialização (apenas para ação init).",
+        description=(
+            "Inclui documentos pessoais durante a inicialização "
+            "(apenas para ação init)."
+        ),
     )
     limit: int = Field(
         default=50,
         ge=1,
         le=200,
-        description="Quantidade máxima de documentos principais/pessoais carregados.",
+        description=("Quantidade máxima de documentos principais/pessoais carregados."),
     )
     answers: Optional[List[str]] = Field(
         default=None,
-        description="Lista com 9 respostas textuais para processar o setup personalizado.",
+        description=(
+            "Lista com 9 respostas textuais para processar o setup personalizado."
+        ),
     )
 
 
 class InitializeTool(Tool):
     name = "initialize"
-    description = "Inicializa o ambiente do Fênix Cloud ou processa o setup personalizado."
+    description = (
+        "Inicializa o ambiente do Fênix Cloud ou processa o setup personalizado."
+    )
     request_model = InitializeRequest
 
     def __init__(self, context: AppContext):
@@ -62,7 +71,10 @@ class InitializeTool(Tool):
             )
         except Exception as exc:  # pragma: no cover - defensive
             self._context.logger.error("Initialize failed: %s", exc)
-            return text("❌ Falha ao carregar dados de inicialização. Verifique se o token tem acesso à API.")
+            return text(
+                "❌ Falha ao carregar dados de inicialização. "
+                "Verifique se o token tem acesso à API."
+            )
 
         if (
             not data.core_documents

{fenix_mcp-0.1.0 → fenix_mcp-0.2.1}/fenix_mcp/application/tools/intelligence.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
 
@@ -21,10 +21,16 @@ class IntelligenceAction(str, Enum):
         obj.description = description
         return obj
 
-    SMART_CREATE = ("memory_smart_create", "Cria memórias inteligentes com análise de similaridade.")
+    SMART_CREATE = (
+        "memory_smart_create",
+        "Cria memórias inteligentes com análise de similaridade.",
+    )
     QUERY = ("memory_query", "Lista memórias aplicando filtros e busca textual.")
     SIMILARITY = ("memory_similarity", "Busca memórias similares a um conteúdo base.")
-    CONSOLIDATE = ("memory_consolidate", "Consolida múltiplas memórias em uma principal.")
+    CONSOLIDATE = (
+        "memory_consolidate",
+        "Consolida múltiplas memórias em uma principal.",
+    )
     PRIORITY = ("memory_priority", "Retorna memórias ordenadas por prioridade.")
     ANALYTICS = ("memory_analytics", "Calcula métricas e analytics das memórias.")
     UPDATE = ("memory_update", "Atualiza campos de uma memória existente.")
@@ -47,17 +53,24 @@ class IntelligenceAction(str, Enum):
 
 ACTION_FIELD_DESCRIPTION = (
     "Ação de inteligência a executar. Use um dos valores: "
-    + ", ".join(f"`{member.value}` ({member.description.rstrip('.')})." for member in IntelligenceAction)
+    + ", ".join(
+        f"`{member.value}` ({member.description.rstrip('.')})."
+        for member in IntelligenceAction
+    )
 )
 
 
 class IntelligenceRequest(ToolRequest):
     action: IntelligenceAction = Field(description=ACTION_FIELD_DESCRIPTION)
     title: Optional[str] = Field(default=None, description="Título da memória.")
-    content: Optional[str] = Field(default=None, description="Conteúdo/texto da memória.")
+    content: Optional[str] = Field(
+        default=None, description="Conteúdo/texto da memória."
+    )
     context: Optional[str] = Field(default=None, description="Contexto adicional.")
     source: Optional[str] = Field(default=None, description="Fonte da memória.")
-    importance: str = Field(default="medium", description="Nível de importância da memória.")
+    importance: str = Field(
+        default="medium", description="Nível de importância da memória."
+    )
     tags: Optional[List[str]] = Field(default=None, description="Tags da memória.")
     limit: int = Field(default=20, ge=1, le=100, description="Limite de resultados.")
     offset: int = Field(default=0, ge=0, description="Offset para paginação.")
@@ -65,23 +78,39 @@ class IntelligenceRequest(ToolRequest):
     category: Optional[str] = Field(default=None, description="Categoria para filtro.")
     date_from: Optional[str] = Field(default=None, description="Filtro inicial (ISO).")
     date_to: Optional[str] = Field(default=None, description="Filtro final (ISO).")
-    threshold: float = Field(default=0.8, ge=0, le=1, description="Limite mínimo de similaridade.")
-    max_results: int = Field(default=5, ge=1, le=20, description="Máximo de memórias similares.")
-    memory_ids: Optional[List[str]] = Field(default=None, description="IDs para consolidação.")
+    threshold: float = Field(
+        default=0.8, ge=0, le=1, description="Limite mínimo de similaridade."
+    )
+    max_results: int = Field(
+        default=5, ge=1, le=20, description="Máximo de memórias similares."
+    )
+    memory_ids: Optional[List[str]] = Field(
+        default=None, description="IDs para consolidação."
+    )
     strategy: str = Field(default="merge", description="Estratégia de consolidação.")
-    time_range: str = Field(default="month", description="Janela de tempo para analytics.")
+    time_range: str = Field(
+        default="month", description="Janela de tempo para analytics."
+    )
     group_by: str = Field(default="category", description="Agrupamento para analytics.")
     id: Optional[str] = Field(default=None, description="ID da memória para update.")
-    documentation_item_id: Optional[str] = Field(default=None, description="ID de documentação relacionada.")
+    documentation_item_id: Optional[str] = Field(
+        default=None, description="ID de documentação relacionada."
+    )
     mode_id: Optional[str] = Field(default=None, description="ID do modo relacionado.")
     rule_id: Optional[str] = Field(default=None, description="ID da regra relacionada.")
-    work_item_id: Optional[str] = Field(default=None, description="ID do work item relacionado.")
-    sprint_id: Optional[str] = Field(default=None, description="ID do sprint relacionado.")
+    work_item_id: Optional[str] = Field(
+        default=None, description="ID do work item relacionado."
+    )
+    sprint_id: Optional[str] = Field(
+        default=None, description="ID do sprint relacionado."
+    )
 
 
 class IntelligenceTool(Tool):
     name = "intelligence"
-    description = "Operações de inteligência do Fênix Cloud (memórias e smart operations)."
+    description = (
+        "Operações de inteligência do Fênix Cloud (memórias e smart operations)."
+    )
     request_model = IntelligenceRequest
 
     def __init__(self, context: AppContext):
@@ -231,7 +260,10 @@ class IntelligenceTool(Tool):
         )
 
     async def _handle_help(self):
-        return text("📚 **Ações disponíveis para intelligence**\n\n" + IntelligenceAction.formatted_help())
+        return text(
+            "📚 **Ações disponíveis para intelligence**\n\n"
+            + IntelligenceAction.formatted_help()
+        )
 
 
 def _format_memory(memory: Dict[str, Any]) -> str: