Cerbero-Bite

Adriano/Cerbero-Bite

Fork 0

Commit Graph

Author	SHA1	Message	Date
root	4ab7590745	feat(entry): IV richness gate (§2.9) + golden config bump 1.0.0 → 1.1.0 Aggiunge il filtro a maggior impatto sul win-rate atteso: l'entry salta se la IV implicita non sta pagando un margine misurabile sopra la realized vol. La letteratura short-vol systematic indica che l'edge sostenibile della strategia esiste solo quando IV30g − RV30g supera una soglia di alcuni punti vol; senza questo gate il selling vol nudo è strutturalmente neutro a win-rate 70-72%. Implementazione end-to-end: - `EntryConfig`: due nuovi campi `iv_minus_rv_min` e `iv_minus_rv_filter_enabled`, con default `0` / `false` per non rompere setup pre-calibrazione. - `validate_entry`: §2.9 hard gate che blocca l'entry se `iv_minus_rv < iv_minus_rv_min` (skip silenzioso quando il dato è `None`, coerente con il pattern §2.8 dei filtri quant). - `entry_cycle._gather_snapshot`: nuovo `_safe_iv_minus_rv` che legge `deribit.realized_vol("ETH")["iv_minus_rv_30d"]` in best-effort e lo propaga via `_MarketSnapshot.iv_minus_rv` → `EntryContext.iv_minus_rv` → audit `inputs.snapshot.iv_minus_rv`. - `tests/unit/test_entry_validator.py`: 5 nuovi casi (default permissivo, gate sotto/sopra/uguale soglia, dato mancante). - `tests/integration/test_entry_cycle.py`: stub `get_realized_vol` nel mock helper così tutti gli scenari di happy/edge path continuano a passare. Configurazione di profili coerente con la disciplina: - `strategy.yaml` (golden 1.1.0) e `strategy.conservativa.yaml`: gate `enabled=false, min=0`. Manteniamo i lunedì pre-calibrazione per accumulare dati sulla distribuzione di `iv_minus_rv`. - `strategy.aggressiva.yaml` (1.1.0-aggressiva): gate `enabled=true, min=3`. Coerente con la filosofia del profilo — size più grande pretende win-rate più alto. La soglia 3 è conservativa; la documentazione raccomanda 5 dopo 4-8 settimane di calibrazione. Doc + GUI: - `docs/13-strategia-spiegata.md` §4-quater: spiega gate, parametri, default per profilo, effetto atteso sul P/L (trade/anno scendono ma E[trade] sale → APR cresce comunque), roadmap di hardening (soglia adattiva, vol-of-vol guard, multi-asset). - pagina `📚 Strategia`: la riga "IV − RV" passa da informativa a pass/fail reale; mostra "filtro DISABILITATO (info-only)" quando spento, ✅/❌ contro la soglia di config quando acceso. Bump versioni e hash di tutti e tre i file YAML (`config_version: 1.1.0`, hash ricalcolato). Test pinning aggiornato (`test_load_repo_strategy_yaml`). Suite: 410 passed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-01 19:32:21 +00:00
Adriano	263470786d	Phase 2: persistence + safety controls Aggiunge la persistenza SQLite, l'audit log a hash chain, il kill switch coordinato e i CLI di gestione documentati in docs/05-data-model.md e docs/07-risk-controls.md. 197 test pass, 1 skipped (sqlite3 CLI mancante), copertura totale 97%. State (`state/`): - 0001_init.sql con positions, instructions, decisions, dvol_history, manual_actions, system_state. - db.py: connect con WAL + foreign_keys + transaction ctx, runner forward-only basato su PRAGMA user_version. - models.py: record Pydantic, Decimal preservato come TEXT. - repository.py: CRUD typed con singola connessione passata, cache aware, posizioni concorrenti. Safety (`safety/`): - audit_log.py: AuditLog append-only con SHA-256 chain e fsync, verify_chain riconosce ogni manomissione (payload, prev_hash, hash, JSON, separatori). - kill_switch.py: arm/disarm transazionali, idempotenti, accoppiati all'audit chain. Config (`config/loader.py` + `strategy.yaml`): - Loader YAML con deep-merge di strategy.local.yaml. - Verifica config_hash SHA-256 (riga config_hash esclusa). - File golden strategy.yaml + esempio override. Scripts: - dead_man.sh: watchdog shell indipendente da Python. - backup.py: VACUUM INTO orario con retention 30 giorni. CLI: - audit verify (exit 2 su tampering). - kill-switch arm/disarm/status su SQLite reale. - state inspect con tabella posizioni aperte. - config hash, config validate. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-27 13:35:35 +02:00

Author

SHA1

Message

Date

root

4ab7590745

feat(entry): IV richness gate (§2.9) + golden config bump 1.0.0 → 1.1.0

Aggiunge il filtro a maggior impatto sul win-rate atteso: l'entry
salta se la IV implicita non sta pagando un margine misurabile sopra
la realized vol. La letteratura short-vol systematic indica che
l'edge sostenibile della strategia esiste solo quando IV30g − RV30g
supera una soglia di alcuni punti vol; senza questo gate il selling
vol nudo è strutturalmente neutro a win-rate 70-72%.

Implementazione end-to-end:

- `EntryConfig`: due nuovi campi `iv_minus_rv_min` e
  `iv_minus_rv_filter_enabled`, con default `0` / `false` per non
  rompere setup pre-calibrazione.
- `validate_entry`: §2.9 hard gate che blocca l'entry se
  `iv_minus_rv < iv_minus_rv_min` (skip silenzioso quando il dato è
  `None`, coerente con il pattern §2.8 dei filtri quant).
- `entry_cycle._gather_snapshot`: nuovo `_safe_iv_minus_rv` che
  legge `deribit.realized_vol("ETH")["iv_minus_rv_30d"]` in
  best-effort e lo propaga via `_MarketSnapshot.iv_minus_rv` →
  `EntryContext.iv_minus_rv` → audit `inputs.snapshot.iv_minus_rv`.
- `tests/unit/test_entry_validator.py`: 5 nuovi casi (default
  permissivo, gate sotto/sopra/uguale soglia, dato mancante).
- `tests/integration/test_entry_cycle.py`: stub `get_realized_vol`
  nel mock helper così tutti gli scenari di happy/edge path
  continuano a passare.

Configurazione di profili coerente con la disciplina:

- `strategy.yaml` (golden 1.1.0) e `strategy.conservativa.yaml`:
  gate `enabled=false, min=0`. Manteniamo i lunedì pre-calibrazione
  per accumulare dati sulla distribuzione di `iv_minus_rv`.
- `strategy.aggressiva.yaml` (1.1.0-aggressiva): gate
  `enabled=true, min=3`. Coerente con la filosofia del profilo —
  size più grande pretende win-rate più alto. La soglia 3 è
  conservativa; la documentazione raccomanda 5 dopo 4-8 settimane di
  calibrazione.

Doc + GUI:

- `docs/13-strategia-spiegata.md` §4-quater: spiega gate, parametri,
  default per profilo, effetto atteso sul P/L (trade/anno scendono
  ma E[trade] sale → APR cresce comunque), roadmap di hardening
  (soglia adattiva, vol-of-vol guard, multi-asset).
- pagina `📚 Strategia`: la riga "IV − RV" passa da informativa a
  pass/fail reale; mostra "filtro DISABILITATO (info-only)" quando
  spento, ✅/❌ contro la soglia di config quando acceso.

Bump versioni e hash di tutti e tre i file YAML
(`config_version: 1.1.0`, hash ricalcolato). Test pinning aggiornato
(`test_load_repo_strategy_yaml`).

Suite: 410 passed.

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

2026-05-01 19:32:21 +00:00

Adriano

263470786d

Phase 2: persistence + safety controls

Aggiunge la persistenza SQLite, l'audit log a hash chain, il kill
switch coordinato e i CLI di gestione documentati in
docs/05-data-model.md e docs/07-risk-controls.md. 197 test pass,
1 skipped (sqlite3 CLI mancante), copertura totale 97%.

State (`state/`):
- 0001_init.sql con positions, instructions, decisions, dvol_history,
  manual_actions, system_state.
- db.py: connect con WAL + foreign_keys + transaction ctx, runner
  forward-only basato su PRAGMA user_version.
- models.py: record Pydantic, Decimal preservato come TEXT.
- repository.py: CRUD typed con singola connessione passata, cache
  aware, posizioni concorrenti.

Safety (`safety/`):
- audit_log.py: AuditLog append-only con SHA-256 chain e fsync,
  verify_chain riconosce ogni manomissione (payload, prev_hash,
  hash, JSON, separatori).
- kill_switch.py: arm/disarm transazionali, idempotenti, accoppiati
  all'audit chain.

Config (`config/loader.py` + `strategy.yaml`):
- Loader YAML con deep-merge di strategy.local.yaml.
- Verifica config_hash SHA-256 (riga config_hash esclusa).
- File golden strategy.yaml + esempio override.

Scripts:
- dead_man.sh: watchdog shell indipendente da Python.
- backup.py: VACUUM INTO orario con retention 30 giorni.

CLI:
- audit verify (exit 2 su tampering).
- kill-switch arm/disarm/status su SQLite reale.
- state inspect con tabella posizioni aperte.
- config hash, config validate.

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

2026-04-27 13:35:35 +02:00

2 Commits