Phase 0: project skeleton

- pyproject.toml with uv, deps for runtime + gui + backtest + dev
- ruff/mypy strict config, pre-commit hooks for ruff/mypy/pytest
- src/cerbero_bite/ layout with empty modules ready for Phase 1+
- structlog JSONL logger with daily rotation
- click CLI with placeholder subcommands (status, start, kill-switch,
  gui, replay, config hash, audit verify)
- 6 smoke tests passing, mypy --strict clean, ruff clean

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-26 23:10:30 +02:00
commit 881bc8a1bf
40 changed files with 6018 additions and 0 deletions
+72
View File
@@ -0,0 +1,72 @@
# 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**.