PythagorasGoal/docs/diary/2026-08-26-advance-riparato-e-debiti.md

2026-08-26 — advance() riparato e rigenerato, quattro debiti chiusi in un giorno

Quattro debiti di CLAUDE.md §5 chiusi: §5.1 (advance + rigenerazione + guardia), §5.12 (isolamento test esteso), §5.5 (test di leva cancellato con nota), §5.9 (test rosso indagato e ancorato). Suite: 751 passati, 0 falliti — tutta verde per la prima volta dal ~24/08.

§5.1 — advance() consuma solo barre CHIUSE, e le serie sono RIGENERATE

Il fix (src/live/paper_guard.py + 6 monitor): la riga new = [i for i in range(len(ts)) if ts[i] > last_ts] diventa PG.nuove_chiuse(ts, last_ts, cadenza) — una barra open-labeled e' chiusa quando ts + cadenza <= adesso. Filtro condiviso, importato da tutti e sei i monitor (anche paper_combo, che era sano per caso: ora e' sano per costruzione).

⚠️ D6 pagata DI NUOVO scrivendo il fix: la prima stesura di indice_chiuso usava asi8 assumendo nanosecondi — pandas 3 usa us di default, e l'intero nella scala sbagliata dava "chiusa" la barra del giorno in corso senza eccezioni. Beccata dal test di fumo, riparata con la sottrazione dall'epoca (la forma di resample_tf), e blindata da un test che prova ns/us/s. La regola che stavo cablando e' quella che stavo violando.

La guardia (era "raccomandata e non cablata"): monitor_health ha ora lo stato PREMATURO — ultima barra che chiude DOPO l'mtime del file, grazia 5 min. Derivata dalle spec esistenti (P1), con open_labeled=False per collect_chain che timbra i giri, non barre (P14: senza il flag avrebbe allertato sempre). Controllo positivo sul dato vivo: ha segnalato esattamente i 5 rotti e taciuto sui 2 sani prima della rigenerazione; dopo, 7/7 OK.

La rigenerazione (scripts/live/paper_regen.py): stesso start_ts pre-registrato, config congelata, replay del codice di produzione riparato — il metodo validato due volte dall'audit del 22/08 (0 barre chiuse cambiate su 1.427/1.488 + 6/6 al bit). Vecchi file archiviati come *.pre_regen_20260826.* (evidenza del difetto, nel perimetro di backup). Nessuna data di gate si sposta.

monitor	barre	Sharpe rotto → vero
paper_statarb (gate 27/09)	58 → 57	+1,95 → −1,61 — il ribaltamento previsto dall'audit
paper_dvolspread (kill 24/10)	32 → 31	−14,73 → −4,41
paper_xsr (gate 23/10)	32 → 31	−4,98 → −2,72
paper_prevday	1584 → 1584	+0,39 → +0,40

paper_portfolio non rigenerato (gamba GTAA su ADJUSTED_LAST ri-aggiustato: il replay non sarebbe la serie registrata — P12); tolta la sola coda non chiusa, cosi' la guardia non resta accesa per sempre su un difetto gia' riparato (P14). Storia pre-fix dichiarata corrotta.

§5.12 — un test non puo' piu' scrivere nel libro di bordo vivo

tests/conftest.py: oltre al watermark, ora deviati trades.db (wrapper su connect — il default e' catturato alla definizione, patchare la costante non serviva a niente) e docs/journal/ (pagine tracciate da git). Per book_executions.jsonl, che i test caricano ad-hoc con importlib e conftest non puo' raggiungere prima: impronta a inizio suite, verifica a fine suite, col falso positivo possibile (fill reale del cron :47 durante la suite) dichiarato nel messaggio.

§5.5 — il test di leva e' CANCELLATO, non aggiustato

test_leva_massima_da_config_resta_sotto_o_uguale_a_1x misurava frac x n_asset: con una chiave di scala la grandezza vera diventerebbe frac x n_asset x scala e il test avrebbe continuato a passare smettendo di controllare. Al suo posto una nota che rimanda al tetto sul PRODOTTO di GATE SCALA-01, da cablare nel codice che leggera' la chiave, quando esistera'.

§5.9 — il test rosso non segnalava un guasto: segnalava una banda scritta male

r0826_skh_band_drift.py — feed tagliato a date crescenti, stesso codice di produzione:

taglio	Sharpe hold-out
02/07 (audit)	1,6376 — riproduce l'audit
25/07 (banda cablata)	1,5751
01→15/08	1,566 → 1,547 (scivola piano)
22/08	1,8966
oggi	1,9306 — riproduce il rosso

Il dato regge (in-sample 1,424 identico su ogni taglio; il taglio all'epoca riproduce l'epoca). Il codice non c'entra. 📌 La scoperta vera: la SOLA settimana 15-22/08 (rally ETH con SKH01 long) vale +0,35 di Sharpe hold-out — il numero e' cosi' fragile, e chi cita "hold-out 1,9" oggi citerebbe 1,55 di una settimana fa. Coerente con §2: l'hold-out canonico di SKH01 era gia' il numero da non citare.

La riparazione: il test ora taglia il feed al 02/07 e verifica la riproduzione stretta (±0,02) di full/in-sample/hold-out/maxDD. Si rompe se cambiano codice o dato sulla finestra congelata — e per nessun altro motivo. La deriva del vivo non e' affare suo: per quella ci sono i monitor (e da oggi la guardia PREMATURO).

Nel farlo, un altro inciampo istruttivo: la prima esecuzione del drift stampava sette righe identiche — run_asset memoizza in un dict di modulo (_CACHE), non in lru_cache, e lo svuotamento non lo toccava. Anche il test riparato ora pulisce quel dict, prima E dopo, per non avvelenare gli altri test.

Conseguenze sui gate (nessuna data si muove)

• STATARB 27/09: il monitor ora misura la serie vera (−1,61 a oggi). Coi criteri pre-registrati invariati, a oggi punta al RITIRO — si legge quel giorno, non prima.
• XSR01 23/10 / DVOLSPREAD 24/10: metrica primaria finalmente su serie reali. Restano i difetti dichiarati (§5.3 pavimento del gate XSR01; veto DVOLSPREAD ora sorvegliato dalla guardia).