journal: la voce del giorno IN CORSO non si presenta piu' come una giornata

cron_daily (00:30 UTC) faceva DUE chiamate al giornale: chiudeva IERI (giusto)
e apriva OGGI. La pagina di oggi nasceva con ~30 minuti dentro e nessuno la
aggiornava fino alla notte dopo.

Il difetto non era il dato mancante: era che la pagina non lo diceva dove si
legge. Aveva TUTTE le sezioni di una chiusa -> passava ogni controllo di
completezza e freschezza, e la parzialita' stava solo in §Salute, quinta
sezione su otto. Stessa famiglia di "una barra presente non e' una giornata
presente", in veste nuova: la pagina e' presente, il giorno no.

Taglia misurata sul caso reale di oggi: la pagina congelata alle 00:37 diceva
"giorno: $+0.54 (1 letture)" e la regola [pnl] chiosava "senza operare". Alle
08:54 il libro aveva fatto 3 fill, 2 round-trip e +$25.86 ($642.56 -> $667.88).
Avrebbe raccontato una giornata ferma per tutta una giornata operativa.

Riparato in due pezzi indipendenti:
  1. la pagina dichiara la parzialita' nel TITOLO e nella prima riga —
     "PARZIALE (giorno in corso)", copertura esplicita (N giri su 24), il fatto
     che non si aggiorna da sola, e quali numeri sono di quella frazione;
  2. tolta la seconda chiamata dal cron. In docs/journal/ restano solo giorni
     chiusi; lo stato corrente si prende da journal.py a mano (pagina marcata)
     o da trades.db, che cron_book sincronizza ogni ora.

Scelta dichiarata: NON si rigenera ogni ora. Costerebbe una riga in cron_book
ma riscriverebbe un file tracciato da git 24 volte al giorno per un consumatore
che non esiste (l'analista legge il giorno chiuso). Se un domani servisse, la
strada e' RIGENERARLA, non congelarla: e' scritto nel commento del cron.

Prove (test_journal 28 -> 31): una accende la marcatura, una la tiene spenta su
un giorno chiuso (una marcatura sempre accesa non si legge), una e' guardia sul
SORGENTE di cron_daily.sh — ogni chiamata a journal.py deve avere --giorno
esplicito, perche' senza argomenti scrive OGGI.

Regolare docs/journal/2026-08-25.md rigenerato: ora si dichiara PARZIALE (9/24).

NON riparato, e registrato come debito aperto in CLAUDE.md §5:
test_wave_0726::test_t1_canonical_riproduce_il_backtest_ufficiale fallisce, e
falliva gia' prima di questa modifica (verificato con git stash sull'albero
pulito). Sharpe hold-out SKH01 canonical 1,9223 contro la banda cablata
1.3 < h < 1.9: il codice non e' cambiato, sono cambiati i dati (data/raw e'
gitignored, il cron lo ricostruisce ogni notte). La banda NON e' stata
allargata — lezione 07/08. Suite: 710 passati, 1 fallito.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Adriano Dal Pastro
2026-08-25 08:59:42 +00:00
parent 11a2370027
commit 2751a7efd0
6 changed files with 158 additions and 20 deletions
+61
View File
@@ -739,3 +739,64 @@ e i vincoli di deploy (PRIIPs/UCITS/broker).
include anche lo storico, e bocciava un'equity vera); (c) **una regola che si accende su $2 di
cumulato insegna a saltare la sezione**: serve una soglia di rilevanza; (d) chi scrive in un
registro va **firmato**, o il registro perde il suo valore probatorio.
---
## Addendum 2026-08-25 — la voce del GIORNO IN CORSO si presentava come una giornata
*(scritto 2026-08-25T08:59:12Z, ora letta da `date -u`)*
`cron_daily` gira alle **00:30 UTC** e faceva **due** chiamate al giornale: chiudeva IERI
(giorno completo, corretto) **e apriva OGGI**. La pagina di oggi nasceva quindi con **~30 minuti
di giornata dentro** e **nessuno la aggiornava fino alla notte dopo**.
🚨 **Il difetto non era il dato mancante, era che la pagina non lo diceva dove si legge.** Aveva
**tutte le sezioni** di una pagina chiusa — Mercato, Libro, P&L, Salute, Lettura, Nota — quindi
passava ogni controllo di completezza e di freschezza; la parzialita' era dichiarata **solo in
§Salute**, quinta sezione su otto (`giri di book_execute: 1/1 *(giorno in corso)*`), mentre
titolo, P&L e le regole della Lettura parlavano al passato di una frazione di giornata.
E' la stessa famiglia gia' codificata due volte — *"una riga presente non e' un dato presente"*,
*"una barra presente non e' una giornata presente"* — in una veste nuova: **la pagina e'
presente, il giorno no**.
📌 **La taglia, misurata sul caso reale del giorno stesso** (ed e' il motivo per cui non era un
difetto cosmetico): la pagina congelata alle 00:37 diceva **"giorno: $+0.54 di equity (1 letture)"**
e la regola `[pnl]` chiosava **"senza operare: e' mark-to-market sulle posizioni gia' aperte"**.
Alle 08:54 dello stesso giorno il libro aveva fatto **3 fill, 2 round-trip chiusi e +$25.86** di
equity ($642.56 → $667.88). **La pagina avrebbe raccontato una giornata ferma per tutta una
giornata operativa**, e chi l'avesse letta — o un modello che se la fosse ritrovata nel prompt —
non aveva modo di accorgersene senza contare i giri.
**Riparato in due pezzi indipendenti:**
1. **La pagina dichiara la propria parzialita' nel TITOLO e nella prima riga**
(`src/live/journal.py::rendi_markdown`): `⚠️ PARZIALE (giorno in corso)` + copertura
esplicita (*"copre N giri su 24"*), il fatto che **non si aggiorna da sola**, e quali numeri
sono di quella frazione (giorno) e quali restano corretti (cumulati).
2. **Il cron non la congela piu'**: tolta la seconda chiamata da `scripts/cron_daily.sh`. In
`docs/journal/` restano **solo giorni chiusi**; chi vuole lo stato corrente lancia
`journal.py` a mano (e riceve una pagina marcata PARZIALE) o legge `trades.db`, che
`cron_book` sincronizza **ogni ora**.
⚖️ **Scelta dichiarata: NON si rigenera la voce di oggi ogni ora.** Sarebbe l'altra soluzione
difendibile e costa una riga in `cron_book`, ma riscriverebbe un file **tracciato da git 24
volte al giorno** per un consumatore che oggi non esiste (l'analista legge il giorno **chiuso**).
Se un domani servisse la voce sempre fresca, **la strada e' rigenerarla, non congelarla**: e'
scritto nel commento del cron perche' chi ci torna non debba ri-derivarlo.
**Prove (3, in `tests/test_journal.py`, 28 → 31):** una **accende** la marcatura su un giorno in
corso e verifica titolo + copertura + *"non si aggiorna da sola"*; una la **tiene spenta** su un
giorno chiuso (*una marcatura sempre accesa non si legge*); la terza e' una **guardia sul
SORGENTE** di `cron_daily.sh` — ogni chiamata a `journal.py` deve avere `--giorno` esplicito,
perche' `journal.py` **senza argomenti scrive OGGI**. La guardia **non vieta** di rigenerare
spesso: vieta di scrivere la pagina **una volta e lasciarla li'**.
⚠️ **Trovato girando la suite completa, NON riparato — e' un'altra cosa:**
`tests/test_wave_0726.py::test_t1_canonical_riproduce_il_backtest_ufficiale` **fallisce**, e
falliva gia' prima di questa modifica (verificato con `git stash`: stesso fallimento sull'albero
pulito). Lo Sharpe hold-out di SKH01 `canonical` vale **1,9223** contro la banda cablata
`1.3 < h < 1.9`. **Il codice non e' cambiato: sono cambiati i DATI**`data/raw/` e' gitignored
e il cron lo ricostruisce ogni notte, quindi la finestra hold-out si allunga e il numero deriva
(verso l'**alto**, cioe' non e' un peggioramento). **La banda NON e' stata allargata**: e' la
lezione del 2026-08-07 (*"un test che fallisce senza che il codice sia cambiato sta segnalando
che i dati non sono versionati — si guarda sotto prima di toccarlo"*), e allargare una tolleranza
per far passare un test e' esattamente la manovra che quella lezione vieta. **Resta aperto.**