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

fenix_mcp/domain/productivity.py

@@ -4,7 +4,6 @@
 from __future__ import annotations
 
 import asyncio
-from dataclasses import dataclass
 from datetime import datetime
 from typing import Any, Dict, Iterable, List, Optional
 
@@ -94,7 +93,9 @@ class ProductivityService:
     async def stats(self) -> Dict[str, Any]:
         return await self._call(self._api.get_todo_stats) or {}
 
-    async def search(self, query: str, *, limit: int, offset: int) -> List[Dict[str, Any]]:
+    async def search(
+        self, query: str, *, limit: int, offset: int
+    ) -> List[Dict[str, Any]]:
         # API atual não expõe paginação no endpoint de busca, mas mantemos
         # assinatura para possível suporte futuro.
         result = await self._call(self._api.search_todo_items, query=query)

fenix_mcp/domain/user_config.py

@@ -21,13 +21,20 @@ class UserConfigService:
         payload = _strip_none(data)
         return await asyncio.to_thread(self._api.create_user_core_document, payload)
 
-    async def list(self, *, returnContent: Optional[bool] = None, **_: Any) -> List[Dict[str, Any]]:
-        return await asyncio.to_thread(
-            self._api.list_user_core_documents,
-            return_content=bool(returnContent),
-        ) or []
+    async def list(
+        self, *, returnContent: Optional[bool] = None, **_: Any
+    ) -> List[Dict[str, Any]]:
+        return (
+            await asyncio.to_thread(
+                self._api.list_user_core_documents,
+                return_content=bool(returnContent),
+            )
+            or []
+        )
 
-    async def get(self, doc_id: str, *, returnContent: Optional[bool] = None, **_: Any) -> Dict[str, Any]:
+    async def get(
+        self, doc_id: str, *, returnContent: Optional[bool] = None, **_: Any
+    ) -> Dict[str, Any]:
         return await asyncio.to_thread(
             self._api.get_user_core_document,
             doc_id,
@@ -36,7 +43,9 @@ class UserConfigService:
 
     async def update(self, doc_id: str, data: Dict[str, Any]) -> Dict[str, Any]:
         payload = _strip_none(data)
-        return await asyncio.to_thread(self._api.update_user_core_document, doc_id, payload)
+        return await asyncio.to_thread(
+            self._api.update_user_core_document, doc_id, payload
+        )
 
     async def delete(self, doc_id: str) -> None:
         await asyncio.to_thread(self._api.delete_user_core_document, doc_id)

fenix_mcp/infrastructure/config.py

@@ -17,14 +17,18 @@ class Settings(BaseSettings):
         default="https://fenix-api-production-7619.up.railway.app",
         description="Base URL for the Fênix Cloud API.",
     )
-    http_timeout: float = Field(default=30.0, description="Default HTTP timeout in seconds.")
+    http_timeout: float = Field(
+        default=30.0, description="Default HTTP timeout in seconds."
+    )
     log_level: str = Field(default="INFO", description="Root log level.")
     transport_mode: Literal["stdio", "http", "both"] = Field(
         default="stdio",
         description="Active transport mode: stdio, http or both.",
     )
     http_host: str = Field(default="127.0.0.1", description="HTTP bind host.")
-    http_port: int = Field(default=3000, description="HTTP port when running with network transport.")
+    http_port: int = Field(
+        default=3000, description="HTTP port when running with network transport."
+    )
 
     model_config = SettingsConfigDict(
         populate_by_name=True,

fenix_mcp/infrastructure/context.py

@@ -17,4 +17,3 @@ class AppContext:
     settings: Settings
     logger: Logger
     api_client: FenixApiClient
-

fenix_mcp/infrastructure/fenix_api/client.py

@@ -20,7 +20,9 @@ def _to_query_value(value: Any) -> Any:
 
 
 def _strip_none(data: Mapping[str, Any]) -> Dict[str, Any]:
-    return {key: _to_query_value(value) for key, value in data.items() if value is not None}
+    return {
+        key: _to_query_value(value) for key, value in data.items() if value is not None
+    }
 
 
 @dataclass(slots=True)
@@ -103,7 +105,9 @@ class FenixApiClient:
         json: Optional[Mapping[str, Any]] = None,
         headers: Optional[Mapping[str, str]] = None,
     ) -> Any:
-        response = self._http.request(method, endpoint, params=params, json=json, headers=headers)
+        response = self._http.request(
+            method, endpoint, params=params, json=json, headers=headers
+        )
         if response.status_code == 204:
             return None
 
@@ -114,7 +118,9 @@ class FenixApiClient:
 
         if not response.ok:
             message = payload.get("message") or payload.get("error") or response.text
-            raise FenixApiError(f"HTTP {response.status_code} calling {endpoint}: {message}")
+            raise FenixApiError(
+                f"HTTP {response.status_code} calling {endpoint}: {message}"
+            )
 
         return payload.get("data", payload)
 
@@ -134,13 +140,27 @@ class FenixApiClient:
 
     def list_core_documents(self, *, return_content: bool = False) -> Any:
         params = self._build_params(optional={"returnContent": return_content})
-        headers = {"x-mcp-token": self.core_documents_token} if self.core_documents_token else None
-        return self._request("GET", "/api/core-documents/mcp/all", params=params, headers=headers)
+        headers = (
+            {"x-mcp-token": self.core_documents_token}
+            if self.core_documents_token
+            else None
+        )
+        return self._request(
+            "GET", "/api/core-documents/mcp/all", params=params, headers=headers
+        )
 
-    def get_core_document_by_name(self, name: str, *, return_content: bool = False) -> Any:
+    def get_core_document_by_name(
+        self, name: str, *, return_content: bool = False
+    ) -> Any:
         params = self._build_params(optional={"returnContent": return_content})
-        headers = {"x-mcp-token": self.core_documents_token} if self.core_documents_token else None
-        return self._request("GET", f"/api/core-documents/mcp/{name}", params=params, headers=headers)
+        headers = (
+            {"x-mcp-token": self.core_documents_token}
+            if self.core_documents_token
+            else None
+        )
+        return self._request(
+            "GET", f"/api/core-documents/mcp/{name}", params=params, headers=headers
+        )
 
     def list_core_documents_auth(self, *, return_content: bool = False) -> Any:
         params = self._build_params(optional={"returnContent": return_content})
@@ -158,15 +178,23 @@ class FenixApiClient:
         params = self._build_params(optional={"returnContent": return_content})
         return self._request("GET", "/api/user-core-documents", params=params)
 
-    def get_user_core_document(self, document_id: str, *, return_content: bool = False) -> Any:
+    def get_user_core_document(
+        self, document_id: str, *, return_content: bool = False
+    ) -> Any:
         params = self._build_params(optional={"returnContent": return_content})
-        return self._request("GET", f"/api/user-core-documents/{document_id}", params=params)
+        return self._request(
+            "GET", f"/api/user-core-documents/{document_id}", params=params
+        )
 
     def create_user_core_document(self, payload: Mapping[str, Any]) -> Any:
         return self._request("POST", "/api/user-core-documents", json=payload)
 
-    def update_user_core_document(self, document_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/user-core-documents/{document_id}", json=payload)
+    def update_user_core_document(
+        self, document_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "PATCH", f"/api/user-core-documents/{document_id}", json=payload
+        )
 
     def delete_user_core_document(self, document_id: str) -> Any:
         return self._request("DELETE", f"/api/user-core-documents/{document_id}")
@@ -195,8 +223,12 @@ class FenixApiClient:
     def update_todo_item_status(self, item_id: str, payload: Mapping[str, Any]) -> Any:
         return self._request("PATCH", f"/api/todo-items/{item_id}/status", json=payload)
 
-    def update_todo_item_priority(self, item_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/todo-items/{item_id}/priority", json=payload)
+    def update_todo_item_priority(
+        self, item_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "PATCH", f"/api/todo-items/{item_id}/priority", json=payload
+        )
 
     def get_todo_stats(self) -> Any:
         return self._request("GET", "/api/todo-items/stats")
@@ -245,7 +277,9 @@ class FenixApiClient:
         include_content: bool = True,
         include_metadata: bool = True,
     ) -> Any:
-        params = self._build_params(required={"content": include_content, "metadata": include_metadata})
+        params = self._build_params(
+            required={"content": include_content, "metadata": include_metadata}
+        )
         return self._request("GET", f"/api/memories/{memory_id}", params=params)
 
     def update_memory(self, memory_id: str, payload: Mapping[str, Any]) -> Any:
@@ -262,13 +296,19 @@ class FenixApiClient:
         return self._request("POST", f"/api/memories/{memory_id}/access")
 
     def find_similar_memories(self, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", "/api/memory-intelligence/similarity", json=payload)
+        return self._request(
+            "POST", "/api/memory-intelligence/similarity", json=payload
+        )
 
     def consolidate_memories(self, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", "/api/memory-intelligence/consolidate", json=payload)
+        return self._request(
+            "POST", "/api/memory-intelligence/consolidate", json=payload
+        )
 
     def smart_create_memory(self, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", "/api/memory-intelligence/smart-create", json=payload)
+        return self._request(
+            "POST", "/api/memory-intelligence/smart-create", json=payload
+        )
 
     # ------------------------------------------------------------------
     # Configuration: modes and rules
@@ -377,12 +417,16 @@ class FenixApiClient:
         return self._request("GET", "/api/documentation", params=_strip_none(filters))
 
     def get_documentation_item(self, item_id: str, **filters: Any) -> Any:
-        return self._request("GET", f"/api/documentation/{item_id}", params=_strip_none(filters))
+        return self._request(
+            "GET", f"/api/documentation/{item_id}", params=_strip_none(filters)
+        )
 
     def create_documentation_item(self, payload: Mapping[str, Any]) -> Any:
         return self._request("POST", "/api/documentation", json=payload)
 
-    def update_documentation_item(self, item_id: str, payload: Mapping[str, Any]) -> Any:
+    def update_documentation_item(
+        self, item_id: str, payload: Mapping[str, Any]
+    ) -> Any:
         return self._request("PATCH", f"/api/documentation/{item_id}", json=payload)
 
     def delete_documentation_item(self, item_id: str) -> Any:
@@ -397,8 +441,12 @@ class FenixApiClient:
     def get_documentation_full_tree(self) -> Any:
         return self._request("GET", "/api/documentation/tree")
 
-    def search_documentation_items(self, *, query: str, team_id: str, limit: int) -> Any:
-        params = self._build_params(required={"q": query, "team_id": team_id, "limit": limit})
+    def search_documentation_items(
+        self, *, query: str, team_id: str, limit: int
+    ) -> Any:
+        params = self._build_params(
+            required={"q": query, "team_id": team_id, "limit": limit}
+        )
         return self._request("GET", "/api/documentation/search", params=params)
 
     def list_documentation_roots(self, *, team_id: str) -> Any:
@@ -414,16 +462,26 @@ class FenixApiClient:
         return self._request("GET", "/api/documentation/analytics", params=params)
 
     def move_documentation_item(self, item_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/documentation/{item_id}/move", json=payload)
+        return self._request(
+            "PATCH", f"/api/documentation/{item_id}/move", json=payload
+        )
 
     def publish_documentation_item(self, item_id: str) -> Any:
         return self._request("PATCH", f"/api/documentation/{item_id}/publish")
 
-    def create_documentation_version(self, item_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", f"/api/documentation/{item_id}/version", json=payload)
+    def create_documentation_version(
+        self, item_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "POST", f"/api/documentation/{item_id}/version", json=payload
+        )
 
-    def duplicate_documentation_item(self, item_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", f"/api/documentation/{item_id}/duplicate", json=payload)
+    def duplicate_documentation_item(
+        self, item_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "POST", f"/api/documentation/{item_id}/duplicate", json=payload
+        )
 
     # ------------------------------------------------------------------
     # Knowledge: work items
@@ -449,7 +507,9 @@ class FenixApiClient:
         return self._request("GET", "/api/work-items/backlog", params=params)
 
     def search_work_items(self, *, query: str, team_id: str, limit: int) -> Any:
-        params = self._build_params(required={"q": query, "team_id": team_id, "limit": limit})
+        params = self._build_params(
+            required={"q": query, "team_id": team_id, "limit": limit}
+        )
         return self._request("GET", "/api/work-items/search", params=params)
 
     def get_work_items_analytics(self, *, team_id: str) -> Any:
@@ -458,7 +518,9 @@ class FenixApiClient:
 
     def get_work_items_velocity(self, *, team_id: str, sprints_count: int) -> Any:
         params = self._build_params(required={"sprints_count": sprints_count})
-        return self._request("GET", f"/api/work-items/velocity/{team_id}", params=params)
+        return self._request(
+            "GET", f"/api/work-items/velocity/{team_id}", params=params
+        )
 
     def list_work_items_by_sprint(self, *, sprint_id: str) -> Any:
         return self._request("GET", f"/api/work-items/by-sprint/{sprint_id}")
@@ -513,7 +575,9 @@ class FenixApiClient:
         return self._request("GET", "/api/work-boards/favorites")
 
     def search_work_boards(self, *, query: str, team_id: str, limit: int) -> Any:
-        params = self._build_params(required={"q": query, "team_id": team_id, "limit": limit})
+        params = self._build_params(
+            required={"q": query, "team_id": team_id, "limit": limit}
+        )
         return self._request("GET", "/api/work-boards/search", params=params)
 
     def list_recent_work_boards(self, *, limit: int) -> Any:
@@ -535,8 +599,12 @@ class FenixApiClient:
     def list_work_board_columns(self, board_id: str) -> Any:
         return self._request("GET", f"/api/work-boards/{board_id}/columns")
 
-    def toggle_work_board_favorite(self, board_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/work-boards/{board_id}/favorite", json=payload)
+    def toggle_work_board_favorite(
+        self, board_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "PATCH", f"/api/work-boards/{board_id}/favorite", json=payload
+        )
 
     def clone_work_board(self, board_id: str, payload: Mapping[str, Any]) -> Any:
         return self._request("POST", f"/api/work-boards/{board_id}/clone", json=payload)
@@ -553,8 +621,12 @@ class FenixApiClient:
     def get_work_board_column(self, column_id: str) -> Any:
         return self._request("GET", f"/api/work-boards/columns/{column_id}")
 
-    def update_work_board_column(self, column_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/work-boards/columns/{column_id}", json=payload)
+    def update_work_board_column(
+        self, column_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "PATCH", f"/api/work-boards/columns/{column_id}", json=payload
+        )
 
     def delete_work_board_column(self, column_id: str) -> Any:
         return self._request("DELETE", f"/api/work-boards/columns/{column_id}")
@@ -586,7 +658,9 @@ class FenixApiClient:
         return self._request("GET", f"/api/sprints/recent/{team_id}", params=params)
 
     def search_sprints(self, *, query: str, team_id: str, limit: int) -> Any:
-        params = self._build_params(required={"q": query, "team_id": team_id, "limit": limit})
+        params = self._build_params(
+            required={"q": query, "team_id": team_id, "limit": limit}
+        )
         return self._request("GET", "/api/sprints/search", params=params)
 
     def get_active_sprint(self, *, team_id: str) -> Any:
@@ -601,8 +675,12 @@ class FenixApiClient:
     def get_sprint_work_items(self, sprint_id: str) -> Any:
         return self._request("GET", f"/api/sprints/{sprint_id}/work-items")
 
-    def add_work_items_to_sprint(self, sprint_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("POST", f"/api/sprints/{sprint_id}/work-items", json=payload)
+    def add_work_items_to_sprint(
+        self, sprint_id: str, payload: Mapping[str, Any]
+    ) -> Any:
+        return self._request(
+            "POST", f"/api/sprints/{sprint_id}/work-items", json=payload
+        )
 
     def remove_work_items_from_sprint(self, payload: Mapping[str, Any]) -> Any:
         return self._request("DELETE", "/api/sprints/work-items", json=payload)
@@ -617,7 +695,9 @@ class FenixApiClient:
         return self._request("PATCH", f"/api/sprints/{sprint_id}/start", json=payload)
 
     def complete_sprint(self, sprint_id: str, payload: Mapping[str, Any]) -> Any:
-        return self._request("PATCH", f"/api/sprints/{sprint_id}/complete", json=payload)
+        return self._request(
+            "PATCH", f"/api/sprints/{sprint_id}/complete", json=payload
+        )
 
     def cancel_sprint(self, sprint_id: str) -> Any:
         return self._request("PATCH", f"/api/sprints/{sprint_id}/cancel")

fenix_mcp/infrastructure/http_client.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 
 import logging
 from dataclasses import dataclass, field
-from typing import Any, Dict, Mapping, Optional
+from typing import Any, Mapping, Optional
 
 import requests
 from requests import Response, Session

fenix_mcp/interface/mcp_server.py

@@ -3,9 +3,6 @@
 
 from __future__ import annotations
 
-import asyncio
-import json
-import sys
 import uuid
 from dataclasses import dataclass
 from typing import Any, Dict, Optional

fenix_mcp/interface/transports.py

@@ -19,8 +19,7 @@ from fenix_mcp.infrastructure.config import Settings
 class Transport(Protocol):
     name: str
 
-    async def serve_forever(self) -> None:
-        ...
+    async def serve_forever(self) -> None: ...
 
 
 class StdIoTransport:
@@ -47,7 +46,9 @@ class StdIoTransport:
                 try:
                     request = json.loads(line)
                 except json.JSONDecodeError as exc:  # pragma: no cover - defensive
-                    self._logger.warning("Invalid JSON received on STDIO", extra={"error": str(exc)})
+                    self._logger.warning(
+                        "Invalid JSON received on STDIO", extra={"error": str(exc)}
+                    )
                     continue
 
                 try:
@@ -109,14 +110,16 @@ class HttpTransport:
         site = web.TCPSite(runner, host=self._host, port=self._port)
         try:
             await site.start()
-        except Exception as exc:  # pragma: no cover - defensive
+        except Exception:  # pragma: no cover - defensive
             self._logger.exception(
                 "Failed to bind HTTP transport",
                 extra={"host": self._host, "port": self._port},
             )
             raise
 
-        self._logger.info("HTTP transport listening", extra={"host": self._host, "port": self._port})
+        self._logger.info(
+            "HTTP transport listening", extra={"host": self._host, "port": self._port}
+        )
         self._runner = runner
 
     async def _cleanup(self) -> None:
@@ -126,7 +129,9 @@ class HttpTransport:
 
     def _with_cors(self, response: web.StreamResponse) -> web.StreamResponse:
         response.headers.setdefault("Access-Control-Allow-Origin", "*")
-        response.headers.setdefault("Access-Control-Allow-Headers", "Content-Type, Authorization")
+        response.headers.setdefault(
+            "Access-Control-Allow-Headers", "Content-Type, Authorization"
+        )
         response.headers.setdefault("Access-Control-Allow-Methods", "POST, OPTIONS")
         return response
 
@@ -142,9 +147,11 @@ class HttpTransport:
         return self._with_cors(web.Response(status=204))
 
     async def _handle_jsonrpc(self, request: web.Request) -> web.StreamResponse:
-        auth_header = request.headers.get('Authorization') or request.headers.get('authorization')
-        if auth_header and auth_header.lower().startswith('bearer '):
-            token = auth_header.split(' ', 1)[1].strip()
+        auth_header = request.headers.get("Authorization") or request.headers.get(
+            "authorization"
+        )
+        if auth_header and auth_header.lower().startswith("bearer "):
+            token = auth_header.split(" ", 1)[1].strip()
             if token:
                 self._server.set_personal_access_token(token)
 
@@ -219,7 +226,9 @@ class TransportFactory:
             transports.append(http_transport)
 
         if not transports:
-            raise ValueError("No transport configured. Check FENIX_TRANSPORT_MODE env var.")
+            raise ValueError(
+                "No transport configured. Check FENIX_TRANSPORT_MODE env var."
+            )
 
         if len(transports) == 1:
             return transports[0]

fenix_mcp/main.py

@@ -16,6 +16,7 @@ from fenix_mcp.infrastructure.fenix_api.client import FenixApiClient
 from fenix_mcp.interface.mcp_server import build_server
 from fenix_mcp.interface.transports import TransportFactory
 
+
 def _normalize_pat(token: str | None) -> str | None:
     if token is None:
         return None
@@ -63,7 +64,9 @@ async def _run_async(pat_token: str | None) -> None:
 
     async with AsyncExitStack() as stack:
         server = build_server(context=context)
-        transport = await TransportFactory(settings, logger=logger).create(stack=stack, server=server)
+        transport = await TransportFactory(settings, logger=logger).create(
+            stack=stack, server=server
+        )
         logger.info("Fênix MCP server started (mode=%s)", transport.name)
         await transport.serve_forever()
 

{fenix_mcp-0.1.0.dist-info → fenix_mcp-0.2.1.dist-info}/METADATA

@@ -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.2.1.dist-info/RECORD

@@ -0,0 +1,29 @@
+fenix_mcp/__init__.py,sha256=LF6isSdae_j8s4tpM4kkMDDkxA1ezezbFtp2fukuWm8,615
+fenix_mcp/main.py,sha256=iJV-9btNMDJMObvcn7wBQdbLLKjkYCQ1ANGEwHGHlMU,2857
+fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
+fenix_mcp/application/tool_base.py,sha256=qUcb46qx9gHQfrSHgj4RD4NCHW-OIvKQdR5G9uxZ5l4,1316
+fenix_mcp/application/tool_registry.py,sha256=bPT5g8GfxG_qu28R1WaDOZHvtmG6TPDvZi8eWj1T9xE,1250
+fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBEZ02KBXJaKQ,796
+fenix_mcp/application/tools/health.py,sha256=m5DxhoRbdwl6INzd6PISxv1NAv-ljCrezsr773VB0wE,834
+fenix_mcp/application/tools/initialize.py,sha256=F3coSBzeVinrXBzIfuifGgfNwpireWoi4lgUn_s6fCk,4627
+fenix_mcp/application/tools/intelligence.py,sha256=Tst0ydvaLgxx3GC1vyfNK3iWf2Nf46_A-DZGtgsMD-Q,12090
+fenix_mcp/application/tools/knowledge.py,sha256=4ClGoFRqyFIPuzzg2DAg-w2eMvTP37mH0THXDGftinw,44634
+fenix_mcp/application/tools/productivity.py,sha256=2IMkNdZ-Kd1CFAO7geruAVjtf_BWoDdbnwkl76vhtC8,9973
+fenix_mcp/application/tools/user_config.py,sha256=8mPOZuwszO0TapxgrA7Foe15VQE874_mvfQYlGzyv4Y,6230
+fenix_mcp/domain/initialization.py,sha256=LmDbTIfFtScfKMothKiCyEi4K0f8hEtsZcigpW5zd88,7345
+fenix_mcp/domain/intelligence.py,sha256=8t4cgCsGwt8ouabVYrajp3-M90DepLnP_qZPNYnGCzU,4725
+fenix_mcp/domain/knowledge.py,sha256=fKQOTt20u5aa5Yo7gPeQ1Qxa_K5pBxn1yn8FEfOFltM,20241
+fenix_mcp/domain/productivity.py,sha256=nmHRuVJGRRu1s4eMoAv8vXHKsSauCPl-FvFx3I_yCTE,6661
+fenix_mcp/domain/user_config.py,sha256=LzBDCk31gLMtKHTbBmYb9VoFPHDW6OydpmDXeHHd0Mw,1642
+fenix_mcp/infrastructure/config.py,sha256=zhJ3hhsP-bRfICcdq8rIDh5NGDe_u7AGpcgjcc2U1nY,1908
+fenix_mcp/infrastructure/context.py,sha256=kiDiamiPbHZpTGyZMylcQwtLhfaDXrxAkWSst_DWQNw,470
+fenix_mcp/infrastructure/http_client.py,sha256=QLIPhGYR_cBQGsbIO4RTR6ksyvkQt-OKHQU1JhPyap8,2470
+fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd0ShS2Y,1371
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=9gYNTxky5i3bjTiiRXdnld6ZCvkTtf0Xdlm0FDtQi24,28239
+fenix_mcp/interface/mcp_server.py,sha256=5UM2NJuNbwHkmCEprIFataJ5nFZiO8efTtP_oW3_iX0,2331
+fenix_mcp/interface/transports.py,sha256=PxdhfjH8UMl03f7nuCLc-M6tMx6-Y-btVz_mSqXKrSI,8138
+fenix_mcp-0.2.1.dist-info/METADATA,sha256=BS8uIDZk1lYVlyS_VnosK8ftqNB95kKiBPxSV2vDRUE,7260
+fenix_mcp-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-0.2.1.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-0.2.1.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-0.2.1.dist-info/RECORD,,