Files
Anubis/docs/STATE.md
T
Alby96andClaude Opus 5.5 78e77818eb
ci / test (postgres) (push) Failing after 6m20s
ci / test (sqlite) (push) Failing after 5m59s
ci / image (push) Skipped
ci / test (postgres) (pull_request) Failing after 4m51s
ci / test (sqlite) (pull_request) Successful in 5m29s
ci / image (pull_request) Skipped
Read the tone of English headlines with the pinned ONNX model of SPEC 4.5 (refs #57)
The classifier is distilroberta-finetuned-financial-news-sentiment-analysis in
Xenova's quantized ONNX export, pinned at revision e6953e30 and checked by size and
SHA-256.

- Model download: the model is not in the repository. The news job downloads it in
  the background into the models folder of the data directory, the first time, and
  retries after 6 hours if that fails. Until then the keywords judge alone, as
  SPEC 10.3 requires.
- Tokenizer: RoBERTa's byte-level BPE travels inside the DLL, read with
  BpeTokenizer and the RoBERTa pre-tokenizer. CodeGenTokenizer.Create adds ids for
  runs of spaces that the model rejects. No special tokens are recognised in
  untrusted text.
- Token check: the test compares the ids on 14 headlines with an independent copy
  of the GPT-2 encoder run on the same files.
- Model test: it reads the tone of clear headlines at 23-24 ms per title on one
  thread. It runs where the model is already downloaded and is skipped in CI.

Microsoft.ML.OnnxRuntime 1.31.1 and Microsoft.ML.Tokenizers 2.0.1 come from the
ADR 0004 list. Google.Protobuf joins the known indirect dependencies.

Anubis and Anubis.Server now declare win-x64 among their runtime identifiers, so
their lock files hold the Windows native packages. Publishing the Windows zip no
longer rewrites the lock files.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 12:00:54 +01:00

19 KiB
Raw Blame History

Stato del progetto

Aggiornato: 2026-11-15

Fase corrente

Fase 7 — Notizie: in corso. La Fase 6 è completata. La sua prova di durata di 48 ore in casa è stata interrotta più volte dal computer, mai da Anubis, e il 14 novembre l'utente ha scelto un'altra strada (ADR 0013). Ora il bot raccoglie da solo i dati per l'analisi (issue #95). L'utente fa girare la release di prova v0.7.0 pubblicata su Gitea per il tempo che vuole, poi incolla in chat il rapporto. Il controllo della prova (#55) si fa su quel rapporto. Nessuna strategia manda ordini: crypto_trend non ha superato il backtest e decide solo in osservazione, le due azionarie aspettano le chiavi di Alpaca.

Fatto

  • Specifica in docs/SPEC.md, con il nome Anubis (ADR 0001).
  • Stack:
    • C# su .NET 10 con interfaccia Blazor (ADR 0003);
    • solo i componenti autorizzati dall'utente (ADR 0004);
    • precisazioni della Fase 0 nell'ADR 0006.
  • Logo: la bilancia della pesatura del cuore (ADR 0005).
  • Lavori su Gitea, una milestone per fase (ADR 0002), elencati in docs/ROADMAP.md.
  • Fase 0:
    • Fatti della sezione 4 ricontrollati il 10/11/2026 in docs/API-NOTES.md, insieme alle versioni dei pacchetti e alle dipendenze indirette.
    • Soluzione Anubis.slnx con sette progetti:
      • src/: Anubis, Server, Guard, Desktop, Setup;
      • tests/: Anubis.Tests;
      • tools/: Anubis.Tasks.
    • Toolchain:
      • analizzatori con avvisi trattati come errori;
      • formattazione controllata;
      • versioni centralizzate, file di blocco.
    • Comandi tasks (vedi CLAUDE.md) e hook pre-commit, attivo in questa copia.
    • Test sempre attivi:
      • generatore casuale a seme fisso per i test di proprietà;
      • pacchetti ammessi;
      • nessun ANUBIS_ALLOW_LIVE=1;
      • nessun segreto nei file;
      • /health.
    • Applicazione minima con GET /health, Dockerfile e docker-compose.yml con PostgreSQL 18.
    • CI in .gitea/workflows/ci.yml: test su SQLite e PostgreSQL, poi l'immagine. Solo passi run:.
  • Fase 1 (scelte nell'ADR 0007):
    • Piattaforma: configurazione d'avvio Docker (variabili) e desktop (config.toml), cartella dei dati, identità dell'installazione con impronta del database, custodia della chiave dei segreti (DPAPI su Windows).
    • Database portabile su PostgreSQL e SQLite con ADO.NET: un solo schema con tipi per motore, migrazioni SQL numerate con salvataggio prima, esportazione e importazione tra motori con controllo di conteggi e totali (Anubis.Server db export|import), salvataggi notturni (ne tiene 14).
    • Nucleo: orologio iniettabile, bus degli eventi, pianificatore, impostazioni con registro delle modifiche, segreti cifrati AES-GCM, registri JSON con i segreti oscurati, formati italiani.
    • Accesso: password PBKDF2, sessioni, CSRF, limite ai tentativi, secondo fattore TOTP facoltativo.
    • Server: avvio a stati (configurazione, primo avvio, database assente, schema, identità, pronto), pagina d'errore con riprova automatica, API REST e WebSocket dello stato.
    • Interfaccia: guscio di menu, barra superiore e barra in basso come nei mockup, temi chiaro e scuro, Panoramica, Diario, Rischio, Impostazioni (aspetto, sicurezza, sistema); le altre voci arrivano con le loro fasi.
    • Modalità dimostrativa (tasks seed-demo) con i dati dell'appendice F, in un database a parte.
    • Immagine Docker definitiva: PUID/PGID, controllo di salute, l'applicazione non gira come root. Provata con SQLite, PostgreSQL, configurazione sbagliata e database staccato.
    • tasks screenshots per confrontare le schermate con i mockup.
    • Dopo la chiusura, con il permesso dell'utente: carattere Instrument Sans incluso nell'applicazione (ADR 0007, punto 5).
  • Fase 2 (scelte nell'ADR 0008, fatti verificati in docs/API-NOTES.md):
    • Catalogo degli strumenti e parte dati degli adapter OKX Europe (coppie in EUR, candele, prezzi, libro, WebSocket) e Alpaca (barre consolidate reali e rettificate, minuti, calendario, orologio, azioni societarie, flusso IEX).
    • Collector storico e dal vivo dentro il server: recupero dei buchi, controlli di qualità con seconda lettura immediata, freschezza dei dati, ripresa con attese crescenti.
    • Storico di ricerca in file csv.gz per anno; importatori degli archivi Binance (con controllo SHA-256) e dei CSV dell'utente (anubis data binance, anubis data csv).
    • Fonti gratuite: cambi BCE, calendario economico, date FRED e trimestrali Finnhub (con chiave facoltativa), riunioni di Fed e BCE modificabili, umore (Fear & Greed, VIX, finanziamento e open interest di OKX).
    • Azioni societarie e serie rettificate ancorate al giorno della decisione.
    • Universi azionario e crypto "a una certa data", senza ETF né fondi.
    • Rapporto di qualità dei dati (anubis data report, /api/data/quality) e sezione Dati in Impostazioni con lo stato di ogni fonte.
    • Prova sui dati reali: BTC, ETH e SOL in EUR dal 21/11/2023 (1.085 giorni ciascuna, nessun buco) e BTCUSDT di Binance dal 17/08/2017 (3.363 giorni).
  • Fase 3 (scelte nell'ADR 0009, fatti verificati in docs/API-NOTES.md):
    • Interfaccia comune dei conti (IBrokerAccount), simulatore interno (PaperBroker) e parte conti degli adapter Alpaca (paper) e OKX (demo). Nessun conto reale viene creato; gli adapter rifiutano l'ambiente reale prima di qualsiasi richiesta.
    • Gestore degli ordini: stati che vanno solo avanti, id deterministici mai rimandati due volte, limite che insegue il prezzo, al massimo sei invii al minuto con le vendite per prime.
    • Stop sul broker per ogni posizione: permanenti sulle azioni intere, giornalieri sulle frazioni, sempre allineati alla quantità; stop già superato; residui invendibili.
    • Contabilità per strategia in sola aggiunta: esecuzioni, lotti, registro della liquidità, capitale affidato in euro diviso per quote, dividendi e frazionamenti, fotografie del patrimonio ogni 5 minuti, rendimento ponderato nel tempo.
    • Riconciliazione ogni 5 minuti con modalità prudente, scelta "allinea" o "escludi", blocco delle chiavi che permettono i prelievi.
    • Schermata Conti e posizioni come il mockup, esportazione CSV delle posizioni; in Impostazioni chiavi (verificate col broker prima di salvarle) e capitale affidato; la Panoramica indica il capitale come primo passo.
    • Batteria di conformità sul simulatore e sulle risposte d'esempio della documentazione; sui conti di prova parte da sola quando ci sono le chiavi.
  • Fase 4 (scelte nell'ADR 0010):
    • Motore di backtest a eventi, una seduta alla volta: si decide sulla chiusura e si esegue all'apertura dopo, con gli stessi costi del simulatore (moltiplicabili per 2 e 3), stop, frazionamenti e dividendi, nessun prestito. Le strategie sono le stesse classi che girano dal vivo; correttivi e rischio hanno già il loro posto e fino alla Fase 5 lasciano passare tutto.
    • Metriche del rapporto (rendimento, volatilità, Sharpe, calo massimo, operazioni, esposizione, risultati per anno) e confronto con "comprare e tenere".
    • Convalide scritte in casa: finestre che avanzano, K-fold purgato combinatorio, Deflated Sharpe Ratio, PBO, regola dell'altopiano, test contro lo sguardo in avanti. DSR e PBO riproducono i casi noti.
    • Registro delle prove: il piano (con le soglie) e la sua impronta si scrivono prima dei risultati e non cambiano; il numero di prove del DSR conta tutti i tentativi della stessa strategia.
    • Laboratorio su un thread a priorità bassa, una prova alla volta, con ripresa dopo un riavvio; dati dalle barre raccolte o dallo storico di ricerca Binance.
    • Schermata Laboratorio: elenco delle prove, modulo per un nuovo test, rapporto completo, confronto tra due prove. Le sezioni "Migliorie in osservazione" e "Stime di costo da confermare" aspettano le Fasi 9 e 8.
    • Strategia d'esempio sma_cross (incrocio di medie) per provare il laboratorio; le strategie di base arrivano con la Fase 5.
  • Fase 5 (scelte nell'ADR 0011):
    • Le tre strategie di base: crypto_trend (rottura su nove periodi, stop a metà del canale, pesi a volatilità obiettivo, universo dei primi dieci del mese), equity_momentum (revisione settimanale con il filtro di SPY, pesi a volatilità inversa, stop che segue il prezzo) e equity_meanrev (RSI a 2 sopra la media a 200 sedute, rischio fisso, uscita alla chiusura). Le stesse classi girano in prova e dal vivo e passano il test contro lo sguardo in avanti.
    • Correttivi comuni (regime crypto, calendario economico), dimensionamento sulla quota del bot e motore del rischio completo: limiti di perdita per mondo, calo dal massimo con dimezzamento e interruttore, limiti di dimensione, controlli tecnici, niente vendite allo scoperto né leva. Toglie o riduce, mai aggiunge. Gira anche dentro i backtest.
    • Ogni passo di una decisione resta scritto con i suoi codici motivo (tabella decisions).
    • Stadi verso i soldi veri: osservazione, simulazione, reale ridotto, reale. Senza la procedura di 12.4 nessun ordine raggiunge un conto reale; una strategia retrocessa gestisce le uscite delle posizioni reali fino a zero; il gemello simulato resta fuori dai totali. In simulazione entra solo una strategia che ha superato il backtest.
    • Backtest onesti in docs/backtests/ con anubis backtest base: storico Binance convertito in euro con il cambio BCE, monete tolte dal listino comprese, due universi, costi doppi e tripli, comprare e tenere accanto. crypto_trend non supera (calo massimo del 32,8% contro il 25% ammesso; probabilità di sovra-adattamento 0,84 su BTC, ETH e SOL) e resta in osservazione. Le due azionarie aspettano le chiavi di Alpaca. Gli esiti sono inclusi nell'applicazione e letti a ogni avvio.
    • Schermate Operazioni (con la scheda "perché" e l'esportazione CSV), Strategie e Rischio come i mockup 03, 04 e 07; in Impostazioni limiti, protezione per le operazioni in giornata e scenari. Fermare, chiudere e ripartire passano dal motore del rischio; alzare un limite mentre una strategia usa soldi veri chiede frase e password.
  • Fase 6 (scelte nell'ADR 0012):
    • Motore dal vivo: ogni decisione passa dalla stessa chiamata del backtest (DecideOnce), agli orari di 5.5. Ogni decisione ha una chiave scritta nella stessa transazione dei suoi ordini pianificati e delle righe del diario, quindi una ripartenza non decide né manda niente due volte. Parità con il backtest provata su 40 giorni di crypto_trend e 6 settimane di equity_meanrev; 14 giorni con guasti iniettati finiscono riconciliati e senza ordini doppi.
    • Recupero dopo un'assenza (5.6): l'assenza si misura dall'ultimo lavoro finito. I lavori persi si rifanno una volta o si saltano con il motivo. Le decisioni in ritardo aggiornano solo le uscite. Un'assenza di più di un giorno resta in Panoramica finché non la vedi.
    • Processo di guardia: in Docker è il processo principale e il genitore del motore. Interviene dopo due minuti di silenzio, un avvio fermo dieci minuti o un'uscita senza preavviso. Annulla gli ordini a metà, rimette gli stop, avvisa e fa ripartire il motore. La terza ripartenza forzata in un'ora scrive il file STOP. La prova (drill) gira anche dentro l'immagine, in tasks ci e nella CI.
    • Diario con le frasi fisse dell'appendice B e confronto "senza bot" (40% BTC, 60% SPY, ogni versamento investito nel suo giorno).
    • Telegram: coda con stato, nuovi tentativi e abbandono dopo un giorno; comandi dal telefono solo dalla chat configurata e solo se recenti, /ferma con /conferma; riepilogo del mattino, stato facoltativo, segnale di vita ogni minuto. Sezione in Impostazioni.
    • Schermate Panoramica e Diario e sistema come i mockup 01, 08 e 09.
    • anubis soak: il rapporto di una prova di durata, letto dai registri del bot mentre lavora.
  • Fase 7, in corso (ADR 0013):
    • Raccolta dei dati per l'analisi (#95). Ogni 5 minuti, e a ogni avvio, il bot scrive una fotografia del processo in diagnostic_samples: memoria, GC, thread, handle, CPU, eccezioni, dimensione del database, avvisi ed errori dei registri, chiamate HTTP in uscita per destinazione con le durate. Ogni esecuzione di ogni lavoro va in job_runs. Si tiene tutto per 30 giorni.
    • Il rapporto da incollare, in Markdown fino a 60 KB e senza segreti, si ottiene in tre modi: dal pulsante «Scarica i dati per l'analisi» in Diario e sistema, da /api/diagnostica.md e da anubis diagnostics.
    • Release di prova per Windows con tasks release-win: uno zip con il server, Avvia Anubis.cmd, Prepara i dati da incollare.cmd e un LEGGIMI.txt.
    • Raccolta delle notizie (#56, ADR 0014, branch fase-7). Il lavoro "notizie" legge ogni 2 minuti le 14 fonti di SPEC 4.4. Le richieste sono condizionate e una fonte che sbaglia aspetta sempre di più, fino a un'ora. Poi:
      • i feed si leggono senza DTD né entità;
      • gli articoli doppi si tolgono per indirizzo e le riprese dello stesso fatto si raggruppano in una storia, contando le fonti indipendenti;
      • ogni storia si collega a strumenti, classi o mercato: simboli, ticker, nomi delle società e delle monete, temi.
    • Primo giudizio locale (#57): casi gravi trovati con parole chiave in inglese e in italiano, tono in cinque gradi, importanza da 1 a 4. Ogni articolo e ogni storia lo conservano.
    • Classificatore ONNX (#57, ADR 0014 punto 8): il modello Xenova quantizzato, con revisione e hash fissati, scaricato dal bot nella cartella models al primo giro delle notizie. Il tokenizzatore sta nella DLL e dà gli stessi identificativi dell'originale. 23–24 ms per titolo su un thread. Senza il modello giudicano le sole parole chiave.

In corso

Nulla.

Prossimo passo

  1. L'utente scarica lo zip della release v0.7.0 da Gitea (Release), lo fa girare e poi incolla il rapporto: doppio clic su Prepara i dati da incollare.cmd, oppure il pulsante in Diario e sistema. Il rapporto si analizza e si salva in docs/diagnostica/; da lì si chiude #55.
  2. Intanto la Fase 7 va avanti sul branch fase-7. Raccolta (#56) e primo giudizio con il classificatore (#57) sono fatti. Restano:
    • l'analista facoltativo (#58);
    • lo stato per strumento (#59);
    • la schermata (#60).
  3. Con le chiavi del conto paper di Alpaca si possono anche fare i backtest azionari (anubis backtest base) e chiudere i criteri delle Fasi 2 e 3 in attesa.

Da sapere

  • Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006).
  • La prova nel container anubis-prova è chiusa (ADR 0013). I compiti programmati che la sorvegliavano sono spenti; il container si può fermare con docker stop anubis-prova.
  • La modalità dimostrativa mostra le schermate costruite fin qui. Notizie e apprendimento appaiono solo con i dati dell'appendice F: fuori dalla demo arrivano con le Fasi 7 e 8. Nella demo il motore di trading e Telegram sono spenti.
  • In Docker il processo principale è la guardia; fuori da Docker (tasks dev, VS Code) il server gira da solo.
  • La guardia oggi apre solo i conti di prova: avrà i conti reali con la fase dei soldi veri (ADR 0012, punto 4).
  • Le chiavi dei conti di prova si inseriscono da Impostazioni → Conti e chiavi oppure nel file .env; quelle nelle variabili d'ambiente valgono di più. Una chiave OKX che permette i prelievi viene rifiutata.
  • Il capitale affidato si decide in euro in Impostazioni → Conti e chiavi. Finché non c'è, le strategie osservano soltanto.
  • tasks dev fuori da Docker usa la cartella dei dati vera dell'utente: per prove usa tasks seed-demo.
  • Alpaca non ha più conti senza margine: il divieto di leva lo impone Anubis (API-NOTES A14).
  • OKX: WebSocket sulla porta 443, la 8443 è chiusa (API-NOTES O3).
  • Le coppie in EUR di OKX esistono da novembre 2023: prima di allora la storia crypto viene dagli archivi Binance in USDT. Il Laboratorio li usa nella loro valuta (ADR 0010, punto 13); i backtest delle strategie di base li convertono in euro con il cambio BCE del giorno (ADR 0011, punto 10).
  • crypto_trend resta in osservazione perché il suo backtest non è superato. Non ho ritoccato regole o soglie dopo aver visto il risultato: una nuova versione della strategia è una nuova prova, che il DSR conterà insieme alle precedenti.
  • Il motore dal vivo fa girare ogni strategia con i parametri scritti nel suo file dell'esito (parameters), non con quelli predefiniti: sono quelli che si sono qualificati.
  • Per rifare i backtest di base: anubis backtest base --to AAAA-MM-GG --out docs/backtests (con --offline usa gli archivi già scaricati).
  • Nella modalità dimostrativa il Laboratorio è spento: mostra l'elenco ma non esegue prove.
  • I dati di mercato si spengono con ANUBIS_MARKET_DATA=off; nella modalità dimostrativa sono sempre spenti.
  • Gli universi passati usano i flag ETF e "frazionabile" di oggi: è un limite delle fonti gratuite (API-NOTES, Fase 2).
  • Gitea ha un esecutore delle Actions attivo: la CI gira a ogni push (prima esecuzione: run 169 del branch fase-0, test verdi su SQLite e PostgreSQL). tasks ci resta per provarla in locale.
  • Su questo PC Docker Desktop non partiva: erano rimasti due file di comunicazione di una sessione di ottobre, che Windows non riusciva a cancellare. Le cartelle che li contengono sono state rinominate, non cancellate: %LOCALAPPDATA%\Docker\run.stale* e %LOCALAPPDATA%\docker-secrets-engine.stale*. Si possono eliminare dopo un riavvio.

Serve dall'utente

Cosa Da quando serve Senza
Far girare la release v0.7.0 e incollare il rapporto in chat Ora, per il tempo che vuoi La prova di durata (#55) resta aperta
Chiavi del conto paper di Alpaca (ALPACA_API_KEY_DEMO, ALPACA_API_SECRET_DEMO) Già dalla Fase 2 (dati azionari) Parte azionaria spenta; storico azionario dal 2016 e backtest delle due strategie azionarie in attesa
Chiavi demo di OKX Europe, senza permesso di prelievo Fase 3 (ordini sui conti di prova) Batteria di conformità su risposte d'esempio; criterio della Fase 3 in attesa
Un token Gitea con permesso write:package come segreto REGISTRY_TOKEN Fase 9 (pubblicazione dell'immagine) Pubblicazione a mano
Token del bot Telegram e chat autorizzata (facoltativi), da Impostazioni → Telegram Fase 6 Nessun avviso sul telefono; comandi provati con un finto server
Un indirizzo per il segnale di vita (facoltativo, per esempio un controllo gratuito di Healthchecks.io) Fase 6 Nessuno avvisa se bot e guardia si spengono insieme
Chiavi FRED e Finnhub (facoltative, gratuite) Già dalla Fase 2 Calendario limitato alla settimana corrente; filtro trimestrali spento
Chiave di un modello linguistico (facoltativa) Fase 7 Solo classificatore locale
Prova del template su Unraid Fase 9 Criterio in attesa
Permesso per ogni componente esterno non elencato nell'ADR 0004 Quando serve Si scrive in casa

Le chiavi non vanno mai scritte nel repository: si mettono nel file .env locale (modello in .env.example) oppure, più avanti, dall'interfaccia.