Phase 3: MCP HTTP clients + Dockerization

Wrapper async tipizzati sui sei servizi MCP HTTP che Cerbero Bite
consuma in autonomia. 277 test pass, copertura clients 93%, mypy
strict pulito, ruff clean.

Base layer:
- clients/_base.py: HttpToolClient con httpx + tenacity (retry
  esponenziale 3x, timeout 8s, mapping HTTP→eccezioni tipizzate).
- clients/_exceptions.py: McpAuthError, McpServerError, McpToolError,
  McpDataAnomalyError, McpNotFoundError, McpTimeoutError.
- config/mcp_endpoints.py: risoluzione URL via Docker DNS
  (mcp-deribit:9011, ...) con override per servizio via env var;
  caricamento bearer token da secrets/core.token o
  CERBERO_BITE_CORE_TOKEN_FILE.

Wrapper:
- clients/macro.py: next_high_severity_within() per filtro entry §2.5.
- clients/sentiment.py: funding_cross_median_annualized() con
  annualizzazione per period nativo per exchange (Binance/Bybit/OKX
  1095, Hyperliquid 8760).
- clients/hyperliquid.py: funding_rate_annualized() per filtro §2.6.
- clients/portfolio.py: total_equity_eur(), asset_pct_of_portfolio()
  per sizing engine + filtro §2.7.
- clients/telegram.py: notify-only (no callback queue, no
  conferme — Bite auto-execute).
- clients/deribit.py: environment_info, index_price_eth,
  latest_dvol, options_chain, get_tickers, orderbook_depth_top3,
  get_account_summary, get_positions, place_combo_order (combo
  atomico), cancel_order.

CLI:
- cerbero-bite ping: health-check parallelo di tutti gli MCP con
  tabella rich (OK/FAIL/SKIPPED).

Docker:
- Dockerfile multi-stage Python 3.13 + uv, user non-root.
- docker-compose.yml con rete external "cerbero-suite", secret
  core_token montato a /run/secrets/core_token, env per ogni MCP.
- secrets/README.md documenta il setup del token.

Documentazione di intervento:
- docs/12-mcp-deribit-changes.md: spec delle modifiche apportate
  al server mcp-deribit (place_combo_order + override testnet via
  DERIBIT_TESTNET).

Dipendenze:
- aggiunto pytest-httpx per i test HTTP.
- rimosso mcp>=1.0 (non usiamo l'SDK MCP, parliamo via HTTP REST).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

tests/unit/test_clients_sentiment.py

@@ -0,0 +1,110 @@
+"""Tests for SentimentClient."""
+
+from __future__ import annotations
+
+from decimal import Decimal
+
+import pytest
+from pytest_httpx import HTTPXMock
+
+from cerbero_bite.clients._base import HttpToolClient
+from cerbero_bite.clients._exceptions import McpDataAnomalyError
+from cerbero_bite.clients.sentiment import (
+    EXCHANGE_PERIODS_PER_YEAR,
+    SentimentClient,
+)
+
+
+def _client() -> SentimentClient:
+    http = HttpToolClient(
+        service="sentiment",
+        base_url="http://mcp-sentiment:9014",
+        token="t",
+        retry_max=1,
+    )
+    return SentimentClient(http)
+
+
+@pytest.mark.asyncio
+async def test_median_annualises_per_exchange_period(httpx_mock: HTTPXMock) -> None:
+    httpx_mock.add_response(
+        url="http://mcp-sentiment:9014/tools/get_cross_exchange_funding",
+        json={
+            "snapshot": {
+                "ETH": {
+                    "binance": 0.0001,
+                    "bybit": 0.0002,
+                    "okx": 0.00015,
+                    "hyperliquid": 0.00002,
+                }
+            }
+        },
+    )
+    median = await _client().funding_cross_median_annualized("eth")
+    # Annualised values (Decimal):
+    #   binance:    0.0001    * 1095 = 0.1095
+    #   bybit:      0.0002    * 1095 = 0.2190
+    #   okx:        0.00015   * 1095 = 0.16425
+    #   hyperliquid:0.00002   * 8760 = 0.17520
+    # sorted: 0.1095, 0.16425, 0.17520, 0.2190 → median = (0.16425+0.17520)/2 = 0.169725
+    assert median == Decimal("0.169725")
+
+
+@pytest.mark.asyncio
+async def test_median_skips_missing_venues(httpx_mock: HTTPXMock) -> None:
+    httpx_mock.add_response(
+        json={
+            "snapshot": {
+                "ETH": {
+                    "binance": 0.0001,
+                    "bybit": None,
+                    "okx": None,
+                    "hyperliquid": None,
+                }
+            }
+        }
+    )
+    median = await _client().funding_cross_median_annualized("ETH")
+    assert median == Decimal("0.0001") * Decimal("1095")
+
+
+@pytest.mark.asyncio
+async def test_anomaly_when_snapshot_missing(httpx_mock: HTTPXMock) -> None:
+    httpx_mock.add_response(json={"snapshot": {}})
+    with pytest.raises(McpDataAnomalyError, match="snapshot missing"):
+        await _client().funding_cross_median_annualized("ETH")
+
+
+@pytest.mark.asyncio
+async def test_anomaly_when_no_venue_responded(httpx_mock: HTTPXMock) -> None:
+    httpx_mock.add_response(
+        json={
+            "snapshot": {
+                "ETH": {
+                    "binance": None,
+                    "bybit": None,
+                    "okx": None,
+                    "hyperliquid": None,
+                }
+            }
+        }
+    )
+    with pytest.raises(McpDataAnomalyError, match="no funding venues"):
+        await _client().funding_cross_median_annualized("ETH")
+
+
+def test_periods_table_covers_documented_venues() -> None:
+    assert set(EXCHANGE_PERIODS_PER_YEAR) == {
+        "binance", "bybit", "okx", "hyperliquid"
+    }
+
+
+def test_sentiment_client_rejects_wrong_service() -> None:
+    bad = HttpToolClient(
+        service="macro",
+        base_url="http://x:1",
+        token="t",
+        retry_max=1,
+    )
+    with pytest.raises(ValueError, match="requires service 'sentiment'"):
+        SentimentClient(bad)