Merge feat/strategy-improvements-fdac
# Conflicts:
# src/cerbero_bite/gui/pages/7_📚_Strategia.py
# strategy.aggressiva.yaml
# strategy.conservativa.yaml
# strategy.yaml
# tests/unit/test_config_loader.py
This commit is contained in:
@@ -90,6 +90,17 @@ class EntryConfig(BaseModel):
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
class DeltaByDvolBand(BaseModel):
|
||||
"""Banda della step function delta-target per regime DVOL (§3.2 A)."""
|
||||
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
|
||||
dvol_under: Decimal
|
||||
delta_target: Decimal
|
||||
delta_min: Decimal
|
||||
delta_max: Decimal
|
||||
|
||||
|
||||
class ShortStrikeSpec(BaseModel):
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
|
||||
@@ -99,6 +110,16 @@ class ShortStrikeSpec(BaseModel):
|
||||
distance_otm_pct_min: Decimal = Field(default=Decimal("0.15"))
|
||||
distance_otm_pct_max: Decimal = Field(default=Decimal("0.25"))
|
||||
|
||||
# §3.2 enhancement (A): step function delta-target by DVOL regime.
|
||||
# Empty list = behaviour invariato (delta_target sopra è il singolo
|
||||
# valore). Quando popolato, il combo_builder sceglie la prima
|
||||
# banda ordinata ascending su `dvol_under` con
|
||||
# `dvol_now ≤ dvol_under`. Esempio:
|
||||
# - dvol_under=50 → delta 0.15 (bassa vol → più premio)
|
||||
# - dvol_under=70 → delta 0.12
|
||||
# - dvol_under=90 → delta 0.10 (alta vol → più safety)
|
||||
delta_by_dvol: list[DeltaByDvolBand] = Field(default_factory=list)
|
||||
|
||||
|
||||
class SpreadWidthSpec(BaseModel):
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
@@ -174,6 +195,25 @@ class SizingConfig(BaseModel):
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
class PartialProfitLevel(BaseModel):
|
||||
"""Livello della scala di profit-take graduale (§7.1bis C).
|
||||
|
||||
`mark_at_pct_credit`: il livello è triggerato quando
|
||||
`mark_combo ≤ mark_at_pct_credit × credito_iniziale` (es. 0.25 =
|
||||
25% del credito = 75% di profitto sulla porzione chiusa).
|
||||
|
||||
`close_pct_of_initial_contracts`: frazione dei contratti aperti
|
||||
INIZIALMENTE da chiudere a questo livello (es. 0.50 = chiudi metà).
|
||||
Le frazioni sono cumulative; chiudere oltre i contratti residui
|
||||
è no-op.
|
||||
"""
|
||||
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
|
||||
mark_at_pct_credit: Decimal
|
||||
close_pct_of_initial_contracts: Decimal
|
||||
|
||||
|
||||
class ExitConfig(BaseModel):
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
|
||||
@@ -185,6 +225,29 @@ class ExitConfig(BaseModel):
|
||||
delta_breach_threshold: Decimal = Field(default=Decimal("0.30"))
|
||||
adverse_move_4h_pct: Decimal = Field(default=Decimal("0.05"))
|
||||
|
||||
# §7.1ter (D): vol-collapse harvest. Esce in profit anche se il
|
||||
# profit-take non è ancora colpito quando DVOL è scesa di tot
|
||||
# punti rispetto all'entry (edge IV-RV catturato, vol attesa già
|
||||
# rientrata). 0 = filtro disabilitato.
|
||||
vol_harvest_dvol_decrease: Decimal = Field(default=Decimal("0"))
|
||||
|
||||
# §7.1bis (C): scala graduata di profit-take. Lista vuota =
|
||||
# comportamento invariato (chiusura atomica al
|
||||
# `profit_take_pct_of_credit`). Quando popolata, l'engine
|
||||
# interpreta come "chiudi N% dei contratti iniziali al livello
|
||||
# di mark M%×credito". Le entry sono ordinate dal mark più alto
|
||||
# (più profit, livello triggerato prima) al più basso. Vedi
|
||||
# `core/exit_decision.py` per la semantica esatta.
|
||||
#
|
||||
# ATTENZIONE: questa funzione richiede il supporto di chiusure
|
||||
# parziali nel runtime (entry_cycle / repository / clients).
|
||||
# Fino al merge della partial-close pipeline, l'engine la mappa
|
||||
# a CLOSE_PROFIT atomico al primo livello triggerato (vedi
|
||||
# commento in `evaluate`). Default vuoto = no-op.
|
||||
profit_take_partial_levels: list[PartialProfitLevel] = Field(
|
||||
default_factory=list
|
||||
)
|
||||
|
||||
monitor_cron: str = "0 2,14 * * *"
|
||||
user_confirmation_timeout_min: int = 30
|
||||
escalate_on_timeout: list[str] = Field(
|
||||
@@ -192,6 +255,36 @@ class ExitConfig(BaseModel):
|
||||
)
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Auto-pause (F): circuit breaker su drawdown rolling
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
class AutoPauseConfig(BaseModel):
|
||||
"""Configurazione del circuit breaker su drawdown.
|
||||
|
||||
Quando abilitato, il rule engine valuta — prima di ogni entry —
|
||||
il P/L cumulato delle ultime `lookback_trades` posizioni chiuse
|
||||
in proporzione al capitale attuale. Se la perdita supera la
|
||||
soglia, l'engine si auto-mette in pausa per `pause_weeks`
|
||||
settimane (skip-week). La pausa si annulla automaticamente alla
|
||||
scadenza, oppure manualmente via comando dalla GUI.
|
||||
|
||||
Difende da regime change non rilevati dai filtri quant: se i
|
||||
filtri stanno fallendo sistematicamente, vale la pena fermarsi
|
||||
e attendere che le condizioni cambino, invece di continuare a
|
||||
sanguinare. È un'estensione conservativa del kill switch
|
||||
(che oggi reagisce solo a errori tecnici).
|
||||
"""
|
||||
|
||||
model_config = ConfigDict(frozen=True, extra="forbid")
|
||||
|
||||
enabled: bool = False
|
||||
lookback_trades: int = 5
|
||||
max_drawdown_pct: Decimal = Field(default=Decimal("0.10"))
|
||||
pause_weeks: int = 2
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Kelly recalibration
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -265,6 +358,7 @@ class StrategyConfig(BaseModel):
|
||||
sizing: SizingConfig = Field(default_factory=SizingConfig)
|
||||
exit: ExitConfig = Field(default_factory=ExitConfig)
|
||||
kelly_recalibration: KellyConfig = Field(default_factory=KellyConfig)
|
||||
auto_pause: AutoPauseConfig = Field(default_factory=AutoPauseConfig)
|
||||
|
||||
execution: ExecutionConfig = Field(default_factory=ExecutionConfig)
|
||||
monitoring: MonitoringConfig = Field(default_factory=MonitoringConfig)
|
||||
|
||||
Reference in New Issue
Block a user