Adriano 6f6dd4c8dd feat(gui): Phase C — Position drilldown with payoff diagram
* gui/data_layer.py — adds load_position_by_id, load_decisions_for_position,
  compute_payoff_curve (pure math: bull_put / bear_call piecewise linear
  P&L at expiry, with breakeven), compute_distance_metrics (OTM%,
  days-to-expiry, days-held, width%).
* gui/pages/5_💼_Position.py — selector across open + 10 most-recent
  closed positions (with deep-link support via ?proposal_id=…), header
  metrics, distance summary, leg snapshot table (entry-time only —
  the GUI never calls MCP), plotly payoff diagram with strike/breakeven/
  entry-spot annotations and max profit/max loss tiles, decision
  history table from the decisions table.

Live greeks/mid are deliberately not pulled: per docs/11-gui-streamlit.md
the GUI reads SQLite + audit log only and lets the engine refresh data.

Validated math against a synthetic bull_put 2475/2350 × 2 contracts:
breakeven 2452.50, max profit $45, max loss $-160 — all matching the
expected formulas (credit, width × n − credit).

353/353 tests still pass; ruff clean; mypy strict src clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 12:28:26 +02:00
2026-04-26 23:10:30 +02:00

Cerbero Bite

Sistema deterministico rule-based per l'esecuzione sistematica della strategia Cerberus Bite: credit spread su opzioni Ethereum (Deribit) con gestione attiva, sizing Quarter Kelly e disciplina di uscita rigida.

Sintesi della strategia

  • Sottostante: ETH/USD su Deribit (opzioni europee).
  • Struttura: Bull Put Spread (modalità principale) o Bear Call Spread, vendita di credito a delta corto 0.100.15 (≈ 18% OTM).
  • DTE: 1421 giorni, sweet spot a 18 DTE.
  • Sizing: Quarter Kelly = 13% del capitale corrente, con cap hard 200 EUR per trade e 1.000 EUR di engagement aperto totale.
  • Gestione attiva: profit take 50% credito, stop loss 1.5× credito, vol stop +10 punti DVOL, time stop 7 DTE, exit su short strike testato (|delta| ≥ 0.30). Su ETH non si difende rollando: si esce.
  • Frequenza: apertura ogni 7 giorni, una posizione alla volta.

Il sistema è deterministico: nessun LLM partecipa al decision loop. Le regole sono codificate, le soglie sono parametri di configurazione, i tool MCP sono usati esclusivamente come fonti di dati e canali di esecuzione (proposta verso Cerbero core, notifiche verso Adriano).

Catena di responsabilità

Cerbero Bite (rule engine)  →  Adriano (decisione finale)  →  Cerbero core (esecuzione)
  • Cerbero Bite propone trade e segnala uscite. Non esegue mai direttamente sul broker.
  • Adriano riceve un report strutturato e dà conferma esplicita.
  • Cerbero core riceve l'istruzione tramite cerbero-memory.push_user_instruction con source="cerbero-bite" e ne pianifica l'apertura/chiusura sul proprio motore di esecuzione.

Documentazione

I documenti di progetto si trovano sotto docs/. Sono numerati e da leggere in ordine per chi implementa.

File Contenuto
docs/00-overview.md Visione del sistema, perimetro, non-obiettivi
docs/01-strategy-rules.md Regole della strategia (entry/manage/exit)
docs/02-architecture.md Architettura software, componenti, interfacce
docs/03-algorithms.md Specifiche dettagliate dei sette algoritmi core
docs/04-mcp-integration.md Mappa dei tool MCP usati e contratti
docs/05-data-model.md Schema persistenza posizioni, log, KB
docs/06-operational-flow.md Flussi operativi: avvio, settimanale, monitoring
docs/07-risk-controls.md Kill switch, cap, dead-man, audit
docs/08-testing-validation.md TDD, paper trading, golden tests
docs/09-development-roadmap.md Fasi di sviluppo e milestone
docs/10-config-spec.md Schema di strategy.yaml con soglie
docs/11-gui-streamlit.md Dashboard Streamlit locale per osservazione e azioni manuali

Stato attuale

Il progetto è in fase specifica. Nessun codice è stato ancora prodotto; tutta la documentazione di design è quella presente nella cartella docs/. La prima fase di implementazione è dettagliata in docs/09-development-roadmap.md.

Avvertenza

Questo sistema gestisce capitale reale ed è soggetto alle Hard Prohibitions di Cerbero (vedi Cerbero_Office/CLAUDE.md). Le opzioni su criptovaluta sono strumenti complessi con rischio di perdita totale. La validazione statistica via Monte Carlo (Cerbero_Office/NewStrategy/ analisi_dai_storici/) è uno stimatore, non una garanzia. Le regole di stop loss e i cap di sizing sono non negoziabili.

S
Description
No description provided
Readme 2.3 MiB
Languages
Python 99.3%
Shell 0.4%
Dockerfile 0.3%