From b4bf864f74f8ea884a0ee020ab396eacad36ca4d Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Tue, 10 Nov 2026 09:51:41 +0100 Subject: [PATCH] Set up phase 0: .NET 10 solution, toolchain, minimal app, Docker and CI Empty but complete solution so every later phase starts from a working toolchain: analyzers as errors, locked restore, format check, policy tests that keep packages within ADR 0004 and keep live trading switched off, a /health endpoint served from Docker, and a Gitea workflow with only run steps. API facts of SPEC section 4 re-checked in docs/API-NOTES.md; ADR 0006 records what changed (MSTest base packages, Ubuntu images, OKX WebSocket on 443, Alpaca margin-only accounts). refs #1 refs #2 refs #3 refs #4 refs #5 Co-Authored-By: Claude Opus 5.5 --- .dockerignore | 11 ++ .editorconfig | 26 +++ .env.example | 8 + .gitattributes | 6 + .gitea/workflows/ci.yml | 59 ++++++ Anubis.slnx | 15 ++ CLAUDE.md | 11 +- Directory.Build.props | 24 +++ Directory.Packages.props | 12 ++ deploy/docker/Dockerfile | 22 +++ docker-compose.yml | 44 +++++ docs/API-NOTES.md | 192 ++++++++++++++++++++ docs/STATE.md | 52 ++++-- docs/adr/0004-componenti-esterni.md | 2 +- docs/adr/0006-precisazioni-fase-0.md | 48 +++++ global.json | 6 + src/Anubis.Desktop/Anubis.Desktop.csproj | 11 ++ src/Anubis.Desktop/Program.cs | 3 + src/Anubis.Desktop/packages.lock.json | 10 + src/Anubis.Guard/Anubis.Guard.csproj | 9 + src/Anubis.Guard/Program.cs | 3 + src/Anubis.Guard/packages.lock.json | 10 + src/Anubis.Server/Anubis.Server.csproj | 12 ++ src/Anubis.Server/Program.cs | 4 + src/Anubis.Server/ServerApp.cs | 18 ++ src/Anubis.Server/packages.lock.json | 10 + src/Anubis.Setup/Anubis.Setup.csproj | 11 ++ src/Anubis.Setup/Program.cs | 3 + src/Anubis.Setup/packages.lock.json | 10 + src/Anubis/Anubis.csproj | 8 + src/Anubis/AnubisInfo.cs | 18 ++ src/Anubis/README.md | 23 +++ src/Anubis/packages.lock.json | 6 + tasks.ps1 | 11 ++ tasks.sh | 8 + tests/Anubis.Tests/Anubis.Tests.csproj | 16 ++ tests/Anubis.Tests/DependencyPolicyTests.cs | 108 +++++++++++ tests/Anubis.Tests/HealthEndpointTests.cs | 37 ++++ tests/Anubis.Tests/LiveSafetyTests.cs | 47 +++++ tests/Anubis.Tests/SecretScanTests.cs | 64 +++++++ tests/Anubis.Tests/TestDatabaseTests.cs | 28 +++ tests/Anubis.Tests/TestSupport.cs | 89 +++++++++ tests/Anubis.Tests/packages.lock.json | 106 +++++++++++ tools/Anubis.Tasks/Anubis.Tasks.csproj | 6 + tools/Anubis.Tasks/Program.cs | 151 +++++++++++++++ tools/Anubis.Tasks/packages.lock.json | 6 + 46 files changed, 1368 insertions(+), 16 deletions(-) create mode 100644 .dockerignore create mode 100644 .editorconfig create mode 100644 .env.example create mode 100644 .gitattributes create mode 100644 .gitea/workflows/ci.yml create mode 100644 Anubis.slnx create mode 100644 Directory.Build.props create mode 100644 Directory.Packages.props create mode 100644 deploy/docker/Dockerfile create mode 100644 docker-compose.yml create mode 100644 docs/API-NOTES.md create mode 100644 docs/adr/0006-precisazioni-fase-0.md create mode 100644 global.json create mode 100644 src/Anubis.Desktop/Anubis.Desktop.csproj create mode 100644 src/Anubis.Desktop/Program.cs create mode 100644 src/Anubis.Desktop/packages.lock.json create mode 100644 src/Anubis.Guard/Anubis.Guard.csproj create mode 100644 src/Anubis.Guard/Program.cs create mode 100644 src/Anubis.Guard/packages.lock.json create mode 100644 src/Anubis.Server/Anubis.Server.csproj create mode 100644 src/Anubis.Server/Program.cs create mode 100644 src/Anubis.Server/ServerApp.cs create mode 100644 src/Anubis.Server/packages.lock.json create mode 100644 src/Anubis.Setup/Anubis.Setup.csproj create mode 100644 src/Anubis.Setup/Program.cs create mode 100644 src/Anubis.Setup/packages.lock.json create mode 100644 src/Anubis/Anubis.csproj create mode 100644 src/Anubis/AnubisInfo.cs create mode 100644 src/Anubis/README.md create mode 100644 src/Anubis/packages.lock.json create mode 100644 tasks.ps1 create mode 100755 tasks.sh create mode 100644 tests/Anubis.Tests/Anubis.Tests.csproj create mode 100644 tests/Anubis.Tests/DependencyPolicyTests.cs create mode 100644 tests/Anubis.Tests/HealthEndpointTests.cs create mode 100644 tests/Anubis.Tests/LiveSafetyTests.cs create mode 100644 tests/Anubis.Tests/SecretScanTests.cs create mode 100644 tests/Anubis.Tests/TestDatabaseTests.cs create mode 100644 tests/Anubis.Tests/TestSupport.cs create mode 100644 tests/Anubis.Tests/packages.lock.json create mode 100644 tools/Anubis.Tasks/Anubis.Tasks.csproj create mode 100644 tools/Anubis.Tasks/Program.cs create mode 100644 tools/Anubis.Tasks/packages.lock.json diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..619d996 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,11 @@ +**/bin/ +**/obj/ +.git/ +.claude/ +.vs/ +artifacts/ +TestResults/ +docs/ +**/*.md +.env +.env.* diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..cb644d7 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,26 @@ +root = true + +[*] +charset = utf-8 +indent_style = space +indent_size = 4 +insert_final_newline = true +trim_trailing_whitespace = true + +[*.{json,yml,yaml,xml,props,targets,csproj,slnx}] +indent_size = 2 + +[*.md] +trim_trailing_whitespace = false + +[*.cs] +csharp_style_namespace_declarations = file_scoped:warning +csharp_style_var_for_built_in_types = true:silent +csharp_style_var_when_type_is_apparent = true:silent +csharp_style_var_elsewhere = true:silent +csharp_prefer_braces = when_multiline:silent +dotnet_sort_system_directives_first = true +csharp_using_directive_placement = outside_namespace:warning +dotnet_style_qualification_for_field = false:warning +dotnet_style_qualification_for_property = false:warning +dotnet_style_qualification_for_method = false:warning diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..4ca2fba --- /dev/null +++ b/.env.example @@ -0,0 +1,8 @@ +# Example only: every value here is fake. Copy to .env and fill in locally; .env is never committed (SPEC 2.2). +ANUBIS_DB_ENGINE=sqlite +ANUBIS_DB_PASSWORD=change-me +ANUBIS_SECRET_KEY=replace-with-random-bytes +ANUBIS_ADMIN_PASSWORD=change-me-at-first-login +# Real money stays off during development: never set it to 1. +ANUBIS_ALLOW_LIVE=0 +TZ=Europe/Rome diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..5bcc21b --- /dev/null +++ b/.gitattributes @@ -0,0 +1,6 @@ +# Line endings: LF in the repository; shell scripts and the Dockerfile stay LF everywhere. +* text=auto +*.sh text eol=lf +Dockerfile text eol=lf +*.png binary +*.ico binary diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml new file mode 100644 index 0000000..d82a059 --- /dev/null +++ b/.gitea/workflows/ci.yml @@ -0,0 +1,59 @@ +# CI (SPEC 15.5, ADR 0003/0004): only run steps with git, dotnet and docker, no external actions. +# Publishing to the registry on v* tags arrives in phase 9 (issue #70). +name: ci + +on: + push: + branches: ["**"] + pull_request: + +jobs: + test: + runs-on: ubuntu-latest + container: + image: mcr.microsoft.com/dotnet/sdk:10.0 + strategy: + fail-fast: false + matrix: + db: [sqlite, postgres] + services: + postgres: + image: postgres:18 + env: + POSTGRES_DB: anubis + POSTGRES_USER: anubis + POSTGRES_PASSWORD: anubis-ci + options: >- + --health-cmd "pg_isready -U anubis -d anubis" + --health-interval 3s + --health-timeout 3s + --health-retries 20 + env: + ANUBIS_TEST_DB: ${{ matrix.db }} + ANUBIS_TEST_PG_HOST: postgres + ANUBIS_TEST_PG_PORT: "5432" + DOTNET_CLI_TELEMETRY_OPTOUT: "1" + DOTNET_NOLOGO: "1" + TESTINGPLATFORM_TELEMETRY_OPTOUT: "1" + steps: + - name: Checkout + run: | + git init -q . + git remote add origin "${{ github.server_url }}/${{ github.repository }}.git" + git -c http.extraHeader="Authorization: token ${{ github.token }}" fetch -q --depth 1 origin "${{ github.sha }}" + git checkout -q FETCH_HEAD + - name: Check + run: sh ./tasks.sh check + + image: + needs: test + runs-on: ubuntu-latest + steps: + - name: Checkout + run: | + git init -q . + git remote add origin "${{ github.server_url }}/${{ github.repository }}.git" + git -c http.extraHeader="Authorization: token ${{ github.token }}" fetch -q --depth 1 origin "${{ github.sha }}" + git checkout -q FETCH_HEAD + - name: Build image (no publish) + run: docker build -f deploy/docker/Dockerfile -t anubis:ci . diff --git a/Anubis.slnx b/Anubis.slnx new file mode 100644 index 0000000..faa44b2 --- /dev/null +++ b/Anubis.slnx @@ -0,0 +1,15 @@ + + + + + + + + + + + + + + + diff --git a/CLAUDE.md b/CLAUDE.md index e398142..eb7ff13 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -11,7 +11,16 @@ Bot di trading personale: azioni USA su Alpaca, crypto spot su OKX Europe, senza ## Comandi -Nessuno ancora: nascono nella Fase 0 (issue #3). Previsti, tutti da `tools/Anubis.Tasks` tramite `./tasks.ps1` (Windows) o `./tasks.sh` (Linux): `tasks check` (analizzatori, test, controllo dei pacchetti), `tasks dev`, `tasks test`, `tasks build` (immagine Docker), `tasks ci`, `tasks seed-demo`, `tasks desktop-win`. Niente `make`. Aggiorna questa sezione appena esistono. +Da `tools/Anubis.Tasks`, tramite `./tasks.ps1 ` (Windows) o `sh ./tasks.sh ` (Linux). Niente `make`. +- `check`: ripristino con `--locked-mode`, `dotnet format --verify-no-changes`, build Release con gli analizzatori, test. Va verde prima di ogni commit. +- `test`: solo i test; il motore viene da `ANUBIS_TEST_DB` (`sqlite` o `postgres`). Esclude la categoria `LiveDemo`. +- `dev`: il server con `dotnet watch` su http://localhost:5000 (o `--urls`). +- `build`: l'immagine Docker `gitea.encke-hake.ts.net/balbosoft/anubis:dev`. +- `ci`: come la CI. Esegue `check`, poi i test su PostgreSQL (avvia `docker compose up -d --wait postgres`, porta 55432) e infine l'immagine. Richiede Docker. +- `seed-demo` (Fase 1), `desktop-win` (Fase 10): non ancora disponibili. +- `docker compose up --build`: l'applicazione su http://localhost:8787, `/health` risponde `ok`. + +Un pacchetto nuovo rompe `DependencyPolicyTests` finché non è in `Directory.Packages.props`, nel file di blocco e in `docs/API-NOTES.md` (ADR 0004, 0006). ## Regole che, se dimenticate, fanno sbagliare diff --git a/Directory.Build.props b/Directory.Build.props new file mode 100644 index 0000000..5c70d95 --- /dev/null +++ b/Directory.Build.props @@ -0,0 +1,24 @@ + + + + net10.0 + latest + enable + enable + true + latest + Recommended + true + true + it;en + BalboSoft + Anubis + 0.0.1 + + + + + true + true + + diff --git a/Directory.Packages.props b/Directory.Packages.props new file mode 100644 index 0000000..9bd7a72 --- /dev/null +++ b/Directory.Packages.props @@ -0,0 +1,12 @@ + + + + + + + + + diff --git a/deploy/docker/Dockerfile b/deploy/docker/Dockerfile new file mode 100644 index 0000000..ed70e0e --- /dev/null +++ b/deploy/docker/Dockerfile @@ -0,0 +1,22 @@ +# Anubis image (ADR 0003). Phase 0: minimal server with /health. +# Phase 1 adds the entrypoint (PUID/PGID, data folder) and the HEALTHCHECK (issue #16). + +FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build +WORKDIR /src +COPY global.json Directory.Build.props Directory.Packages.props ./ +COPY src/Anubis/Anubis.csproj src/Anubis/packages.lock.json src/Anubis/ +COPY src/Anubis.Server/Anubis.Server.csproj src/Anubis.Server/packages.lock.json src/Anubis.Server/ +RUN dotnet restore src/Anubis.Server/Anubis.Server.csproj --locked-mode +COPY src/Anubis/ src/Anubis/ +COPY src/Anubis.Server/ src/Anubis.Server/ +RUN dotnet publish src/Anubis.Server/Anubis.Server.csproj -c Release --no-restore -o /app + +FROM mcr.microsoft.com/dotnet/aspnet:10.0 +WORKDIR /app +COPY --from=build /app ./ +ENV ASPNETCORE_HTTP_PORTS=8787 \ + TZ=Europe/Rome +EXPOSE 8787 +VOLUME /data +USER $APP_UID +ENTRYPOINT ["dotnet", "Anubis.Server.dll"] diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..5cb6028 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,44 @@ +# Development only (SPEC 3): the app plus a local PostgreSQL. Never used in production. +# Start: docker compose up --build Health: curl http://localhost:8787/health +services: + anubis: + build: + context: . + dockerfile: deploy/docker/Dockerfile + image: gitea.encke-hake.ts.net/balbosoft/anubis:dev + ports: + - "8787:8787" + environment: + ANUBIS_DB_ENGINE: postgres + ANUBIS_DB_HOST: postgres + ANUBIS_DB_PORT: "5432" + ANUBIS_DB_NAME: anubis + ANUBIS_DB_USER: anubis + ANUBIS_DB_PASSWORD: ${ANUBIS_DB_PASSWORD:-anubis-dev} + ANUBIS_ALLOW_LIVE: "0" + TZ: Europe/Rome + volumes: + - anubis-data:/data + depends_on: + postgres: + condition: service_healthy + + postgres: + image: postgres:18 + environment: + POSTGRES_DB: anubis + POSTGRES_USER: anubis + POSTGRES_PASSWORD: ${ANUBIS_DB_PASSWORD:-anubis-dev} + ports: + - "127.0.0.1:55432:5432" + healthcheck: + test: ["CMD-SHELL", "pg_isready -U anubis -d anubis"] + interval: 3s + timeout: 3s + retries: 20 + volumes: + - postgres-data:/var/lib/postgresql + +volumes: + anubis-data: + postgres-data: diff --git a/docs/API-NOTES.md b/docs/API-NOTES.md new file mode 100644 index 0000000..3656a47 --- /dev/null +++ b/docs/API-NOTES.md @@ -0,0 +1,192 @@ +# Note sulle API + +Controllo del 10 novembre 2026 dei fatti della sezione 4 di `docs/SPEC.md` (verificati il 9 ottobre 2026). Sono state lette solo pagine pubbliche e fatte solo chiamate pubbliche senza chiave. Nessuna registrazione, nessuna chiave usata. + +Ogni fatto ha uno di questi esiti: +- **confermato**: vale ancora come scritto nella specifica; +- **cambiato**: vale in parte o non vale più; la colonna Dettaglio dice cosa è diverso; +- **non verificabile**: le pagine pubbliche non bastano per verificarlo. Il fatto resta dietro una protezione, elencata in fondo alla pagina. + +I fatti che riguardano strumenti abbandonati con l'ADR 0003 (`alpaca-py`, `ccxt`, `ib_async`) sono segnati **non più rilevante**. + +Prima di scrivere ogni adapter, si rilegge la documentazione corrente e si aggiorna questa pagina (SPEC 4). + +## 4.1 Alpaca + +| # | Fatto (SPEC 4.1) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| A1 | Conto paper per tutti, 100.000 $ finti, solo dati IEX | confermato | Chiunque nel mondo lo apre con un'email. Il saldo si può azzerare con un importo a scelta. | https://docs.alpaca.markets/docs/paper-trading | +| A2 | Conto reale per residenti italiani: "più di 195 paesi", nessun elenco | non verificabile | Nessuna pagina ufficiale dà più né il numero né l'elenco. L'Italia compare tra i paesi del bonifico in valuta locale e del passaporto UE di Alpaca Europe (luglio 2026). Nessuna fonte dice però che un privato italiano può aprire un conto Trading API. | https://alpaca.markets/support/countries-alpaca-is-available · https://alpaca.markets/blog/alpaca-completes-eea-passporting-to-29-countries-expanding-access-to-regulated-investment-services-across-europe/ | +| A3 | Crypto su Alpaca non disponibile ai residenti UE | non verificabile | La documentazione parla solo di "alcune giurisdizioni internazionali". La pagina delle regioni ammesse risponde 404. Non cambia nulla: la crypto resta su OKX. | https://docs.alpaca.markets/docs/crypto-trading | +| A4 | Piano Basic: tempo reale solo IEX, 30 simboli via WebSocket, storico dal 2016, SIP solo se vecchio di almeno 15 minuti, 200 chiamate al minuto; piano a pagamento 99 $ al mese | confermato | Il flusso `delayed_sip` esiste come WebSocket. Attenzione: nelle API dei dati il parametro `feed` vale `sip` se non lo si indica. | https://docs.alpaca.markets/docs/about-market-data-api · https://docs.alpaca.markets/docs/market-data-faq | +| A4b | I volumi IEX sono una piccola parte del mercato: i filtri di liquidità usano le barre giornaliere consolidate | confermato | Discende da A4: le barre SIP si chiedono con un `end` vecchio di almeno 15 minuti. | come A4 | +| A5 | Notizie: Benzinga, REST e WebSocket `v1beta1/news`, storico dal 2015, campi headline, summary, symbols, created_at, source; gratuite? | cambiato | URL e campi confermati. In più ci sono `id`, `author`, `updated_at`, `content`, `url` e `images`. La fonte non è più solo Benzinga: gli esempi mostrano anche "fiscal.ai". Lo storico dal 2015 e la presenza nel piano gratuito non sono più scritti. Senza tempo reale, le notizie via REST arrivano con 15 minuti di ritardo. | https://docs.alpaca.markets/us/reference/news-3 · https://docs.alpaca.markets/us/docs/streaming-real-time-news | +| A6 | Tipi d'ordine e validità; `opg` rifiutati 09:28–19:00 ET, `cls` 15:50–19:00 ET | confermato | Dopo le 19:00 ET questi ordini vanno in coda per l'asta del giorno dopo. | https://docs.alpaca.markets/docs/orders-at-alpaca | +| A7 | Frazioni da 1 $; solo market, limit, stop e stop-limit con `day`; niente `opg`/`cls`, niente vendite allo scoperto | confermato | In più: gli importi hanno al massimo 2 decimali, e gli ordini in importo non si modificano (si annullano e si rimandano). Le frazioni ora sono ammesse anche fuori orario, solo con ordini limit. | https://docs.alpaca.markets/docs/fractional-trading | +| A8 | Fuori orario: solo limit con `extended_hours=true` | confermato | Validità solo `day` o `gtc`, niente bracket. Anubis opera solo in orario regolare. | https://docs.alpaca.markets/docs/orders-at-alpaca | +| A9 | PDT: soglia dei 25.000 $ tolta il 4 giugno 2026; campi PDT facoltativi; usare `buying_power` | cambiato | Data confermata. I campi `pattern_day_trader`, `daytrade_count`, `last_daytrade_count`, `daytrading_buying_power` e `last_daytrading_buying_power` sono stati tolti dall'API entro il 6 luglio 2026: possono mancare del tutto. | https://alpaca.markets/blog/finra-retires-the-pdt-rule-introducing-alpacas-new-intraday-margin-framework/ | +| A10 | Nessuna commissione, solo tasse regolamentari sulle vendite; conto in dollari; cambio sui versamenti circa 1,5% | cambiato | La tassa FINRA TAF è solo sulle vendite, ma la tassa CAT si paga anche sugli acquisti. L'1,5% vale per il bonifico in valuta locale (Italia compresa), con un massimo di 40 $. | https://docs.alpaca.markets/docs/regulatory-fees · https://alpaca.markets/support/currencycloud-transfer-questions | +| A11 | Calendario e orologio: `/v2/calendar` e `/v2/clock` | cambiato | Funzionano ancora, ma la documentazione li chiama "legacy". I nuovi sono `GET /v3/calendar/{market}` e `GET /v3/clock?markets=…`, che indicano anche la fase della seduta. Nessuna data di chiusura per i `/v2`. | https://docs.alpaca.markets/us/reference/calendar-2.md · https://docs.alpaca.markets/us/reference/legacyclock.md | +| A12 | Azioni societarie: `GET https://data.alpaca.markets/v1/corporate-actions` con symbols, types, start, end; nel piano gratuito? | confermato | Il sito le mette nel piano gratuito. Senza `start` e `end` restituisce solo il giorno corrente; la paginazione usa `page_token`, con `limit` da 1 a 1000. | https://docs.alpaca.markets/us/reference/corporateactions-1 · https://alpaca.markets/data | +| A13 | Ordini di segno opposto rifiutati con 403, con le eccezioni bracket, OCO e trailing stop | confermato | Vale anche per paper e crypto. Uno stop-limit conta come stop se accoppiato a un ordine market o stop. | https://docs.alpaca.markets/docs/user-protection | +| A14 | Su un conto senza margine il ricavato di una vendita può non essere spendibile fino al regolamento | cambiato | Alpaca non offre conti senza margine: tutti i conti sono a margine. Sotto i 2.000 $ il conto è "limited margin", con potere d'acquisto 1x. Il ricavato si reinveste subito in azioni, ma non si usa per la crypto né si preleva prima del regolamento (T+1). | https://alpaca.markets/support/alpaca-cash-accounts · https://docs.alpaca.markets/docs/account-plans | +| A15 | Nessun indicatore ETF negli asset Alpaca; `nasdaqtraded.txt` ha la colonna ETF Y/N | confermato | La colonna `ETF` è la sesta. | https://docs.alpaca.markets/us/reference/get-v2-assets-1.md · https://www.nasdaqtrader.com/dynamic/SymDir/nasdaqtraded.txt | +| A16 | Indirizzi e autenticazione da scrivere in casa | confermato | Paper `https://paper-api.alpaca.markets`, dati `https://data.alpaca.markets`, intestazioni `APCA-API-KEY-ID` e `APCA-API-SECRET-KEY`. WebSocket IEX `wss://stream.data.alpaca.markets/v2/iex`, autenticazione `{"action":"auth",…}` con risposta `authenticated`. | https://docs.alpaca.markets/docs/real-time-stock-pricing-data | +| A17 | SDK `alpaca-py` 0.44.0 | non più rilevante | Client scritto in casa (ADR 0003, 0004). | — | + +**Cosa cambia per il codice** +- **A4**: passare sempre `feed=iex` per i dati recenti. Il `sip` solo con un `end` vecchio di almeno 15 minuti. +- **A5**: `source` è un testo libero, non un valore fisso. +- **A9**: non leggere i campi PDT. Il potere d'acquisto viene da `buying_power` (e `non_marginable_buying_power` per frazioni e crypto). +- **A10**: la tassa CAT entra nel calcolo dei costi anche sugli acquisti. +- **A11**: il calendario sta dietro un'interfaccia, così si passa ai `/v3` senza toccare il resto. Si parte con i `/v2`. +- **A14**: il conto sarà a margine, quindi il divieto di leva (SPEC 9.1) lo impone Anubis. Compra solo fino alla liquidità propria, mai allo scoperto, anche se sopra i 2.000 $ Alpaca lo permetterebbe. + +## 4.2 OKX Europe + +| # | Fatto (SPEC 4.2) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| O1 | OKX Europe Ltd, autorizzata MiCA (Malta) dal 27/01/2025, opera in Italia | confermato | Autorizzazione dell'autorità maltese (MFSA) del 27/01/2025, con passaporto nello Spazio economico europeo. | https://www.casptracker.eu/casp/OKX-Europe-Limited | +| O2 | REST `https://eea.okx.com`; WebSocket `wss://wseea.okx.com/ws/v5/public`, `/private`, `/business` | confermato | Con un conto europeo, `www.okx.com` risponde con l'errore 50119. | https://my.okx.com/docs-v5/en/ | +| O3 | Demo: stessa REST con `x-simulated-trading: 1`; WebSocket `wss://wseeapap.okx.com/ws/v5/...`; chiavi a parte che non scadono | cambiato | Tutto confermato, ma la porta 8443 è chiusa dal 31/10/2026. I WebSocket vanno sulla 443, quindi senza porta nell'URL. | https://my.okx.com/docs-v5/log_en | +| O3b | Il demo europeo elenca 27 coppie in EUR e 29 in USDC | non verificabile | Senza chiave l'elenco demo mostra 28 EUR e 30 USDC, ma non è filtrato per l'Europa. Il 30/09/2026 sono state tolte alcune coppie (ICX, STORJ, ELF). | `GET https://eea.okx.com/api/v5/public/instruments?instType=SPOT` | +| O4 | Chiave, segreto e passphrase; fino a 20 IP; una chiave di trading senza IP scade dopo 14 giorni di inattività | confermato | La firma è Base64(HMAC-SHA256(timestamp + metodo + percorso + corpo)). Il timestamp REST è in formato ISO UTC con millisecondi; oltre 30 secondi di scarto arriva l'errore 50102. Il login WebSocket firma invece i **secondi** Unix + `GET` + `/users/self/verify`. | https://my.okx.com/docs-v5/en/ | +| O5 | Commissioni spot dal 25/09/2026: 0,10% maker, 0,20% taker | confermato | Sulle coppie di stablecoin 0% maker e 0,05% taker. La pagina generale delle commissioni mostra ancora la tariffa vecchia. | https://www.okx.com/en-eu/help/important-notice-upcoming-spot-fee-adjustment-eea | +| O6 | Quotazioni in EUR e USDC; USDT non negoziabile | confermato | L'USDT depositato resta congelato. Anche USDG è ammesso. | https://www.okx.com/en-eu/learn/usdt-not-tradeable-okx-europe-stablecoin-guide | +| O7 | Liquidità buona su BTC, ETH e SOL in EUR, scarsa sulle altre coppie in EUR (spread 7–17 punti base) | non verificabile | La documentazione non ne parla. Volumi a 24 ore del 10/11/2026: BTC-EUR circa 5,1 M€, ETH-EUR circa 2,0 M€, SOL-EUR circa 0,45 M€ (meno di HYPE-EUR e XRP-EUR). La mediana delle 272 coppie EUR è circa 400 €. | `GET https://eea.okx.com/api/v5/market/tickers?instType=SPOT` | +| O8 | Ultime 1.440 candele da `candles`, le precedenti da `history-candles`; BTC-EUR da novembre 2023; `1D` apre alle 16:00 UTC, `1Dutc` alle 00:00 UTC | confermato | Prima candela giornaliera di BTC-EUR: 21/11/2023. Gli orari di apertura sono stati controllati sui dati. Massimo 300 candele per chiamata. | chiamate pubbliche a eea.okx.com | +| O9 | `public/instruments` dà `minSz`, `lotSz`, `tickSz` | confermato | Per lo spot sono espressi nella moneta base. Esempio BTC-EUR: minSz 0,0001, lotSz 0,00000001, tickSz 0,1. | `GET https://eea.okx.com/api/v5/public/instruments?instType=SPOT` | +| O10 | Ordini market, limit, post-only, FOK, IOC; ordini algoritmici con stop, OCO, trigger, trailing stop | confermato | Gli algoritmici vanno su `POST /api/v5/trade/order-algo`. Esistono anche `optimal_limit_ioc` (solo derivati) e `rpi`; `elp` è dismesso. | https://my.okx.com/docs-v5/en/ | +| O11 | `clOrdId`: solo lettere e cifre, massimo 32 caratteri | confermato | Distingue maiuscole e minuscole, niente trattini, unico tra gli ordini aperti. Il formato `ANU` + lettere e cifre (ADR 0001) va bene. | https://my.okx.com/docs-v5/en/ | +| O12 | Dati dei derivati senza chiave: finanziamento, open interest, rapporto long/short | confermato | Finanziamento e open interest sono nella documentazione europea. Gli endpoint `rubik` del rapporto long/short non ci sono, ma rispondono su eea.okx.com (provato il 10/11/2026). | https://my.okx.com/docs-v5/en/ · `GET https://eea.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio?ccy=BTC&period=1D` | +| O13 | ccxt `myokx` 4.5.85 e le sue commissioni predefinite | non più rilevante | Client scritto in casa (ADR 0003). | — | +| O14 | La commissione può essere trattenuta nella moneta comprata | confermato | Ogni esecuzione ha `fee`, negativa quando è un costo, e `feeCcy`. Con l'impostazione di conto `feeType` = 1 si paga nella valuta di quotazione. | https://my.okx.com/docs-v5/en/ · https://www.okx.com/en-eu/help/okx-to-introduce-spot-fee-payment-option-in-quote-currency | +| O15 | Limiti di frequenza (dato in più, utile all'adapter) | confermato | `candles` 40 ogni 2 s per IP; `history-candles` 20 ogni 2 s; invio ordine 60 ogni 2 s; `instruments` 20 ogni 2 s; `fills` 60 ogni 2 s. | https://my.okx.com/docs-v5/en/ | +| O16 | Alternative: Bitvavo 0,15%/0,25% senza ambiente di prova; Kraken 0,40%/0,80%, candele solo ultime 720, solo `validate=true` | confermato | `validate=true` di Kraken non ricontrollato: conta solo se l'utente cambia exchange. | https://www.bitvavo.com/en/fees · https://docs.kraken.com/api/docs/rest-api/get-ohlc-data | +| O17 | Binance non serve più i residenti italiani dal 1/7/2026; archivi pubblici con candele a 1 minuto dal 2017 | confermato | La chiusura risulta solo dalla stampa, non da una nota ufficiale di Binance. L'archivio BTCUSDT a 1 minuto va da agosto 2017 a ottobre 2026. | https://data.binance.vision/?prefix=data/spot/monthly/klines/BTCUSDT/1m/ | + +**Cosa cambia per il codice** +- **O3**: gli URL WebSocket sono scritti senza porta, sia in produzione sia in demo. +- **O3b, O6**: chiamato senza chiave, `public/instruments` restituisce anche le coppie in USDT, TRY, BRL e altre valute. Ciò che si può davvero negoziare lo dice `GET /api/v5/account/instruments`, con la chiave. Fino ad allora vale un elenco fisso di coppie in EUR e USDC. +- **O4**: si controlla lo scarto con `GET /api/v5/public/time`, usando l'orologio iniettabile. Formati del timestamp diversi tra REST e WebSocket. +- **O8**: per le giornaliere si usa `1Dutc`, mai `1D`. Lo storico si scarica con un ritmo prudente (`history-candles` ha il limite più basso). +- **O12**: i dati `rubik` sono facoltativi; se smettono di rispondere, il bot va avanti senza. +- **O14**: la contabilità legge `fee` e `feeCcy` da ogni esecuzione e non ne deduce la valuta. + +## 4.3 Altri broker (fasi opzionali) + +| # | Fatto (SPEC 4.3) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| B1 | eToro: chiavi distinte demo e reale | confermato | Cambia solo il percorso: `trading/execution/demo` contro `trading/execution`. | https://builders.etoro.com/learn/authentication-and-api-keys.md | +| B1b | eToro: REST `https://public-api.etoro.com` e WebSocket | confermato | Il WebSocket è documentato; il suo indirizzo `wss://` non compare nella pagina letta. | https://api-portal.etoro.com/core/websocket/overview.md | +| B1c | eToro: circa 60 letture e 20 scritture al minuto | confermato | Le pagine dei dati di mercato indicano invece 120 richieste al minuto: le due pagine non coincidono. Si progetta su 60. | https://api-portal.etoro.com/getting-started/rate-limits.md | +| B1d | eToro: candele da 1 minuto a 1 settimana, 1.000 per richiesta | confermato | — | https://api-portal.etoro.com/api-reference/market-data/get-instrument-candle-history.md | +| B1e | eToro: nessun ordine limite in attesa | confermato | Gli ordini nuovi (v2 da maggio, v3 da agosto 2026) accettano solo `mkt`, `mit` e `limitIOC`, e solo in apertura. | https://api-portal.etoro.com/api-reference/trading--real/create-an-order.md | +| B1f | eToro: crypto 1% per lato | confermato | Sconti solo dai livelli Platinum in su. | https://www.etoro.com/trading/fees/ | +| B2 | Interactive Brokers: serve IB Gateway; secondo fattore manuale ogni settimana; dati a pagamento | confermato | Il flusso consolidato USA si paga; esiste un flusso gratuito non consolidato (Cboe One e IEX). Il sito risponde 403 ai programmi: letto dai risultati di ricerca. | https://www.interactivebrokers.com/docs/tws-api/doc/tws-settings/daily-weekly-reauthentication | +| B2b | Libreria `ib_async` | non più rilevante | Esiste un client C# ufficiale (`CSharpAPI.dll`), con una licenza non commerciale e fuori da NuGet. Sarebbe un componente esterno da chiedere all'utente (ADR 0004). | https://interactivebrokers.github.io/ | +| B3 | cTrader (IC Markets EU, Pepperstone EU): solo forex e CFD → escluso | confermato | Azioni e crypto ci sono solo come CFD con leva. | https://www.icmarkets.eu/en/range-of-markets · https://pepperstone.com/en-eu/platforms/ | +| B4 | OANDA: v20 non disponibile per l'entità europea → escluso | confermato | Esclusa l'entità polacca che serve l'Europa. | https://developer.oanda.com/rest-live-v20/introduction/ | +| B5 | MetaTrader 5: su Linux solo con Wine → escluso | confermato | Nessuna versione nativa. | https://www.metatrader5.com/en/terminal/help/start_advanced/install_linux.md | + +## 4.4 Fonti gratuite + +| # | Fatto (SPEC 4.4) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| F1 | `data.binance.vision`: archivi giornalieri e mensili senza chiave | confermato | Esiste anche l'intervallo da 1 secondo. Dal 1° gennaio 2025 i timestamp dei file spot sono in **microsecondi**, prima in millisecondi. | https://github.com/binance/binance-public-data | +| F2a | Cambio BCE, file XML giornaliero, nel pomeriggio | confermato | Di solito verso le 16:00 ora dell'Europa centrale. Ultimo valore letto: 9/11/2026, 1,1193. | https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml | +| F2b | Frankfurter come alternativa | cambiato | La versione principale è la v2, che mescola più banche centrali (il 10/11 dava 1,1194 contro 1,1193 della BCE). La v1 è deprecata dal 18/05/2026, ma resta attiva. Il dato della sola BCE è su `/v2/providers/ecb/rates`. | https://frankfurter.dev/ | +| F3a | Calendario economico `ff_calendar_thisweek.json`: settimana corrente, senza dato effettivo | confermato | Campi title, country (la valuta), date, impact, forecast, previous. | https://nfs.faireconomy.media/ff_calendar_thisweek.json | +| F3b | Calendario economico: al massimo una richiesta ogni 5 minuti | non verificabile | Nessuna documentazione ufficiale; un post di forum parla di 2 richieste ogni 5 minuti. | https://www.forexfactory.com/thread/post/15159093 (risponde 403) | +| F4 | FRED `release/dates`: chiave gratuita e **facoltativa**, 120 richieste al minuto | cambiato | Il parametro e il limite sono confermati, ma la chiave è **obbligatoria**: senza chiave l'API risponde 400. Resta facoltativa per Anubis: senza chiave la funzione si spegne, come la specifica già prevede. | https://fred.stlouisfed.org/docs/api/fred/release_dates.html | +| F5 | Storico VIX da `cdn.cboe.com` senza chiave | cambiato | Funziona, dati dal 1990, ma risponde con un rinvio 307 a `https://cdn-api.cboe.com/api/global/us_indices/daily_prices/VIX_History.csv`. | https://cdn.cboe.com/api/global/us_indices/daily_prices/VIX_History.csv | +| F6 | Finnhub gratuito: 60 chiamate al minuto; `hour` vale `bmo` o `amc` | cambiato | In più c'è un tetto di 30 al secondo. `hour` può valere anche `dmh` (durante la seduta) o essere vuoto. Il piano gratuito dà solo 1 mese di storico delle trimestrali. | https://finnhub.io/static/swagger.json | +| F7 | Fear & Greed crypto: giornaliero, con attribuzione | confermato | La fonte va citata in modo evidente accanto al dato. | https://alternative.me/crypto/fear-and-greed-index/ | +| F8 | SEC EDGAR: 10 richieste al secondo, User-Agent con nome e contatto | confermato | — | https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data | +| F9 | I 14 feed RSS rispondono | confermato | Tutti e 14 rispondono con RSS valido. CoinDesk rinvia all'indirizzo senza la barra finale: si usa `https://www.coindesk.com/arc/outboundfeeds/rss`. | elenco in SPEC 4.4 | +| F10a | CryptoPanic non ha più un piano gratuito | confermato | Piano gratuito chiuso dal 1° aprile 2026; il più economico costa 199 $ al mese. Dato da fonti secondarie: la pagina ufficiale non si legge senza JavaScript. | https://cryptopanic.com/developers/api/plans/ | +| F10b | `yfinance`, Stooq, GDELT, API di X e Reddit da non usare | non verificabile | Non ricontrollati. Non cambia nulla: restano esclusi. | — | + +**Cosa cambia per il codice** +- **F1**: l'importatore riconosce millisecondi e microsecondi. +- **F2b**: se si usa Frankfurter, solo `/v2/providers/ecb/rates`. La fonte principale resta il file BCE. +- **F3b**: una richiesta all'ora, come già scritto nella specifica. La pagina "Request Denied" si riconosce come errore. +- **F5**: il client HTTP segue i rinvii, oppure usa direttamente `cdn-api.cboe.com`. +- **F6**: `dmh` e il campo vuoto sono gestiti; con `dmh` la trimestrale cade in seduta. + +## 4.5 Modelli per le notizie + +| # | Fatto (SPEC 4.5) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| M1 | `mrm8488/distilroberta-finetuned-financial-news-sentiment-analysis`, licenza Apache-2.0 | confermato | — | https://huggingface.co/mrm8488/distilroberta-finetuned-financial-news-sentiment-analysis | +| M2 | Esportazione ONNX pronta nei repository `Xenova/...` | confermato | `Xenova/distilroberta-finetuned-financial-news-sentiment-analysis`: `onnx/model.onnx` (circa 329 MB), `onnx/model_quantized.onnx` (circa 83 MB) e `tokenizer.json`. Revisione da fissare: `e6953e30167c7fc3d1ad62f3df31617dd712fbc1`. Il repository **non dichiara una licenza**: vale quella del modello originale (Apache-2.0), da annotare nell'ADR della Fase 7. | https://huggingface.co/Xenova/distilroberta-finetuned-financial-news-sentiment-analysis | +| M3 | 10–20 ms per titolo su CPU | non verificabile | Si misura nella Fase 7, con ONNX Runtime per .NET. | — | +| M4 | Claude Haiku 5.5: 0,10 $ in ingresso e 0,50 $ in uscita per milione di token (fino a 100.000 token); batch a metà prezzo; non ancora nella panoramica dei modelli | cambiato | Ora **è** nella panoramica, con identificativo `claude-haiku-5-5`. Prezzi confermati. Oltre i 100.000 token costa 0,50 $ e 2,50 $. | https://platform.claude.com/docs/en/about-claude/models/overview · https://platform.claude.com/docs/en/about-claude/pricing | +| M5 | Claude Haiku 4.5: 1 $ e 5 $ | confermato | Ora è un modello "legacy", ancora disponibile. | https://platform.claude.com/docs/en/about-claude/pricing | + +L'identificativo del modello resta una voce di configurazione, mai una costante nel codice (SPEC 4.5). + +## 4.6 Vincoli per un residente italiano + +| # | Fatto (SPEC 4.6) | Esito | Dettaglio | Fonte | +|---|---|---|---|---| +| V1 | ETF domiciliati negli USA di norma non acquistabili dai privati europei (PRIIPs) | confermato | Senza il documento KID i broker europei ne bloccano l'acquisto; si possono tenere o vendere. Il filtro di Anubis resta attivo di base. | https://www.justetf.com/en/news/etf/us-domiciled-etfs.html | +| V2 | Non è verificato se Alpaca applichi il blocco ai residenti europei | non verificabile | Nessuna pagina pubblica ne parla. Il filtro di Anubis non dipende da questo. | — | +| V3 | Broker esteri, nessun sostituto d'imposta: serve l'esportazione delle operazioni in euro al cambio BCE | non verificabile | Non è consulenza fiscale e non si verifica su pagine tecniche. Il requisito dell'esportazione resta (SPEC 13.3). | — | + +## Fatti non verificabili e protezioni + +Ogni fatto non verificabile resta dietro una protezione. I nomi delle impostazioni sono provvisori: si fissano nella fase indicata. + +| Fatto | Protezione | Fase | +|---|---|---| +| A2 conto reale italiano | Anubis funziona tutto in paper. L'apertura del conto reale è una voce di `GO-LIVE.md`. | 2, 9 | +| A3 crypto su Alpaca | L'adapter Alpaca non espone la crypto. | 2 | +| A5 notizie Alpaca nel piano gratuito | Fonte facoltativa (`news.alpaca.enabled`): si spegne da sola se risponde 401/403; restano le fonti della sezione 4.4. | 7 | +| O3b coppie del demo europeo | Elenco fisso di coppie in EUR e USDC, confrontato con `account/instruments` appena ci sono le chiavi demo. | 3 | +| O7 liquidità | Elenco fisso di coppie ammesse e filtro sullo spread prima di ogni ordine. | 3, 5 | +| F3b limite del calendario | Una richiesta all'ora, al massimo una ogni 5 minuti anche ai riavvii; la pagina di blocco conta come errore. | 2 | +| F10b fonti escluse | Non usate. | — | +| M3 velocità del classificatore | Misura nella Fase 7; sopra i 50 ms per titolo si segnala all'utente. | 7 | +| V2 blocco ETF di Alpaca | Filtro ETF di Anubis attivo di base, indipendente dal broker. | 2 | +| V3 fiscalità | Esportazione CSV delle operazioni con il cambio BCE. | 3 | + +## Versioni di .NET e dei pacchetti ammessi + +Ultime versioni stabili lette dall'API di NuGet il 10 novembre 2026. Quelle già in uso sono fissate in `Directory.Packages.props`. Gli altri pacchetti si aggiungono nella fase in cui servono, dopo un nuovo controllo della versione. + +| Pacchetto | Versione | Licenza | In uso da | Fonte | +|---|---|---|---|---| +| .NET 10 runtime | 10.0.14 (LTS, supporto fino al 14/11/2028) | MIT | Fase 0 | https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/10.0/releases.json | +| .NET 10 SDK | 10.0.403 (`global.json` chiede almeno 10.0.100) | MIT | Fase 0 | come sopra | +| `MSTest.TestFramework`, `MSTest.TestAdapter` | 4.5.2 | MIT | Fase 0 | https://www.nuget.org/packages/MSTest/4.5.2 | +| `Microsoft.NET.Test.Sdk` | 18.11.0 | MIT | Fase 0 | https://www.nuget.org/packages/Microsoft.NET.Test.Sdk | +| `Microsoft.Data.Sqlite` | 10.0.14 | MIT | Fase 1 | https://www.nuget.org/packages/Microsoft.Data.Sqlite/10.0.14 | +| `Npgsql` | 10.0.3 | PostgreSQL License | Fase 1 | https://www.nuget.org/packages/Npgsql/10.0.3 | +| `System.Security.Cryptography.ProtectedData` | 10.0.14 | MIT | Fase 10 | https://www.nuget.org/packages/System.Security.Cryptography.ProtectedData/10.0.14 | +| `Microsoft.Web.WebView2` | 1.0.4314.35 | Licenza Microsoft di tipo BSD | Fase 10 | https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.4314.35 | +| `Microsoft.ML`, `Microsoft.ML.LightGbm`, `Microsoft.ML.FastTree` | 5.0.1 | MIT | Fase 8 | https://www.nuget.org/packages/Microsoft.ML/5.0.1 | +| `Microsoft.ML.OnnxRuntime` | 1.31.1 (librerie native per linux-x64 e win-x64) | MIT | Fase 7 | https://www.nuget.org/packages/Microsoft.ML.OnnxRuntime/1.31.1 | +| `Microsoft.ML.Tokenizers` | 2.0.1 | MIT | Fase 7 | https://www.nuget.org/packages/Microsoft.ML.Tokenizers/2.0.1 | + +Il metapacchetto `MSTest` porterebbe con sé l'estensione di copertura `Microsoft.Testing.Extensions.CodeCoverage`. Quell'estensione ha una licenza Microsoft separata da accettare e dipende da `Mono.Cecil`, di terze parti. Per questo si usano i suoi pacchetti di base (ADR 0006). + +## Dipendenze indirette di terze parti + +I pacchetti autorizzati se ne portano dietro alcuni non pubblicati da Microsoft. L'ADR 0004 li accetta insieme al pacchetto che li richiede. Il test `DependencyPolicyTests` blocca ogni pacchetto di terze parti che compare nei file di blocco senza essere elencato qui. Quando la fase indicata aggiunge il pacchetto, il nome entra anche nell'elenco del test. + +| Dipendenza | Di chi, licenza | Arriva con | Fase | Nota | +|---|---|---|---|---| +| `SQLitePCLRaw.bundle_e_sqlite3`, `SQLitePCLRaw.core` 2.1.13 | Eric Sink, Apache-2.0 | `Microsoft.Data.Sqlite` | 1 | Contiene la libreria nativa di SQLite. | +| `Newtonsoft.Json` 13.0.3 | James Newton-King, MIT | `Microsoft.ML`, LightGbm, FastTree | 8 | — | +| `LightGBM` 4.6.0 | progetto microsoft/LightGBM, pubblicato a nome di Guolin Ke, MIT | `Microsoft.ML.LightGbm` | 8 | Libreria nativa; in Docker serve `libgomp1`. | +| `Google.Protobuf` 3.30.2 | Google, BSD-3-Clause | `Microsoft.ML.Tokenizers` | 7 | — | +| `Mono.Cecil` 0.11.6 | Jb Evain, MIT | estensione di copertura di MSTest | — | Evitato: non si usa il metapacchetto. | + +Nella Fase 0 i file di blocco contengono solo pacchetti Microsoft e MSTest. + +## Immagini Docker + +- `mcr.microsoft.com/dotnet/sdk:10.0` (SDK 10.0.403) e `mcr.microsoft.com/dotnet/aspnet:10.0` (runtime 10.0.14) esistono. Dal .NET 10 il tag `10.0` usa **Ubuntu 24.04 "noble"**, non Debian. Non esiste un tag Debian stabile. +- `libgomp1` non è nelle immagini, ma si installa da Ubuntu "main" con `apt-get install -y --no-install-recommends libgomp1`. Si aggiunge nella Fase 8, insieme a LightGBM. +- Fonti: https://mcr.microsoft.com/v2/dotnet/aspnet/tags/list · https://github.com/dotnet/dotnet-docker/blob/main/manifest.json · https://packages.ubuntu.com/noble/libgomp1 diff --git a/docs/STATE.md b/docs/STATE.md index 16752c4..9050aff 100644 --- a/docs/STATE.md +++ b/docs/STATE.md @@ -1,21 +1,38 @@ # Stato del progetto -Aggiornato: 2026-11-09 +Aggiornato: 2026-11-10 ## Fase corrente -**Fase 0 — Preparazione: non iniziata.** Lo sviluppo parte solo con il via dell'utente. +**Fase 0 — Preparazione: completata.** La prossima è la Fase 1 (Fondamenta), da iniziare con il via dell'utente. ## Fatto -- Specifica caricata in `docs/SPEC.md`, con il nome Anubis al posto di Giano (ADR 0001). -- Linguaggio: C# su .NET 10 con interfaccia Blazor, al posto di Python (ADR 0003). -- Componenti esterni: ammessi solo quelli autorizzati dall'utente, il resto si scrive in casa (ADR 0004). -- Logo: la bilancia della pesatura del cuore, con il motivo del nome (ADR 0005); screen e icona Unraid aggiornati. -- Screen di riferimento in `docs/design/`, aggiornati al nuovo nome e al nuovo logo. -- Bozza del template Unraid in `deploy/unraid/anubis.xml`, già con il registry di Gitea. -- Lavori creati su Gitea: una milestone per fase, una issue per lavoro, una issue di chiusura per fase (ADR 0002), riscritti per lo stack C#. Elenco in `docs/ROADMAP.md`. -- Regole di lavoro in `docs/SVILUPPO.md` e `CLAUDE.md`. +- 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`). + - Test sempre attivi: + - 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:`. ## In corso @@ -23,16 +40,23 @@ Nulla. ## Prossimo passo -Fase 0, a partire dalla issue #1 (verifica dei fatti sulle API), poi #2–#5 e la chiusura #6. +Fase 1, issue #7–#13: piattaforma, database portabile, salvataggi, nucleo, accesso, guscio dell'interfaccia. + +## Da sapere + +- Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006). +- 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). +- Esecutore delle Actions su Gitea: ESITO_RUNNER ## Serve dall'utente | Cosa | Da quando serve | Senza | |---|---|---| -| Via libera per iniziare lo sviluppo | Subito | Non si parte | +| Via libera per la Fase 1 | Subito | Non si parte | | Chiavi del conto paper di Alpaca | Fase 2 (dati azionari) | La parte azionaria si prova su dati sintetici; criteri in attesa | | Chiavi demo di OKX Europe | Fase 3 (ordini sui conti di prova) | Batteria di conformità su risposte d'esempio; criteri in attesa | -| Un esecutore di Gitea Actions (runner), se si vuole la CI remota | Fase 0 | `tasks ci` in locale | +| Un esecutore di Gitea Actions (runner), se si vuole la CI remota | Ora | `tasks ci` in locale | | 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) | Fase 6 | Test con un finto server | | Chiavi FRED e Finnhub (facoltative, gratuite) | Fase 2 | Calendario limitato alla settimana corrente; filtro trimestrali spento | @@ -40,4 +64,4 @@ Fase 0, a partire dalla issue #1 (verifica dei fatti sulle API), poi #2–#5 e l | 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 (Fase 0 crea `.env.example`) oppure, più avanti, dall'interfaccia. +Le chiavi non vanno mai scritte nel repository: si mettono nel file `.env` locale (modello in `.env.example`) oppure, più avanti, dall'interfaccia. diff --git a/docs/adr/0004-componenti-esterni.md b/docs/adr/0004-componenti-esterni.md index 0fac19e..7e6b6e5 100644 --- a/docs/adr/0004-componenti-esterni.md +++ b/docs/adr/0004-componenti-esterni.md @@ -1,6 +1,6 @@ # 0004 — Nessun SDK o componente esterno senza il permesso dell'utente -Data: 2026-11-09 · Stato: accettata +Data: 2026-11-09 · Stato: accettata · Precisata dall'ADR 0006 (MSTest tramite i suoi pacchetti di base; `libgomp1` nella Fase 8) ## Contesto diff --git a/docs/adr/0006-precisazioni-fase-0.md b/docs/adr/0006-precisazioni-fase-0.md new file mode 100644 index 0000000..bb900db --- /dev/null +++ b/docs/adr/0006-precisazioni-fase-0.md @@ -0,0 +1,48 @@ +# 0006 — Precisazioni della Fase 0 su test, immagini Docker e API + +Data: 2026-11-10 · Stato: accettata · Precisa gli ADR 0003 e 0004, senza cambiare i componenti autorizzati + +## Contesto + +La Fase 0 ha preparato il progetto e ricontrollato i fatti della sezione 4 (`docs/API-NOTES.md`). Sono emersi alcuni punti in cui gli ADR 0003 e 0004 vanno precisati. Nessuno aggiunge componenti esterni: due ne tolgono. + +## Decisione + +**1. MSTest tramite i suoi pacchetti di base.** L'ADR 0004 autorizza `MSTest`. Il metapacchetto con quel nome si porta dietro l'estensione di copertura `Microsoft.Testing.Extensions.CodeCoverage`. Quell'estensione ha una licenza Microsoft separata da accettare e dipende da `Mono.Cecil`, di terze parti. Al suo posto si usano i tre pacchetti che il metapacchetto già contiene, tutti Microsoft con licenza MIT: +- `MSTest.TestFramework`; +- `MSTest.TestAdapter`; +- `Microsoft.NET.Test.Sdk`. + +Niente copertura del codice per ora. Se servirà, si chiede all'utente (ADR 0004). La telemetria della piattaforma di test è spenta con `TESTINGPLATFORM_TELEMETRY_OPTOUT=1` in `tasks` e nella CI. + +**2. Test dell'applicazione senza host di prova.** `Microsoft.AspNetCore.Mvc.Testing` non è autorizzato. I test avviano il server vero su una porta locale libera (`--urls http://127.0.0.1:0`) e lo interrogano con `HttpClient`. + +**3. Immagini Docker su Ubuntu.** Dal .NET 10 i tag `sdk:10.0` e `aspnet:10.0` usano Ubuntu 24.04 "noble", non Debian. Si resta su questi tag ufficiali. `libgomp1` si installa con `apt-get` nella Fase 8, quando arriva LightGBM. L'ADR 0004 la datava alla Fase 5, ma i modelli si addestrano nella Fase 8. + +**4. Dipendenze indirette sotto controllo.** +- I file di blocco (`packages.lock.json`) sono nel repository, e `tasks check` ripristina con `--locked-mode`. +- `DependencyPolicyTests` fallisce se: + - compare un pacchetto fuori dall'elenco dell'ADR 0004; + - un progetto fissa una versione propria; + - nei file di blocco c'è un pacchetto di terze parti non elencato in `docs/API-NOTES.md`. +- Le dipendenze di terze parti già note (SQLitePCLRaw, Newtonsoft.Json, LightGBM, Google.Protobuf) entrano nell'elenco del test nella fase che aggiunge il pacchetto che le richiede. + +**5. Cartelle dei moduli.** Le cartelle di `src/Anubis` nascono con il primo codice che le riempie, così git non deve tenere cartelle vuote. La tabella in `src/Anubis/README.md` dice per ogni modulo la cartella, il namespace e la fase. + +**6. Cambi delle API che toccano il progetto** (dettagli in `docs/API-NOTES.md`): +- **OKX, WebSocket sulla porta 443.** La 8443 è chiusa dal 31/10/2026. Gli URL si scrivono senza porta, in produzione e in demo. +- **Alpaca, calendario e orologio.** Si parte con i `/v2` ancora attivi, dietro un'interfaccia. I `/v3` vanno usati appena i `/v2` vengono dismessi. +- **Alpaca, conti a margine.** Alpaca non offre più conti senza margine. Il divieto di leva (SPEC 9.1) lo fa rispettare Anubis: compra solo con la liquidità propria e non va mai allo scoperto. +- **Alpaca, dati.** Il parametro `feed=iex` si passa sempre, perché senza di esso Alpaca usa `sip`. +- **FRED, chiave obbligatoria.** Per l'API la chiave è obbligatoria. Per Anubis resta facoltativa: senza chiave la funzione si spegne, come la specifica prevede. + +## Alternative scartate + +- **Tenere il metapacchetto `MSTest` e accettare l'estensione di copertura.** Porta una licenza in più e un pacchetto di terze parti che non serve. +- **Chiedere a parte il pacchetto `Microsoft.AspNetCore.Mvc.Testing`.** Il server vero su una porta libera fa la stessa prova senza componenti in più. +- **Un'immagine Debian fatta in casa.** Bisognerebbe mantenere un'immagine propria e perdere gli aggiornamenti di sicurezza di Microsoft. + +## Conseguenze + +- `Directory.Packages.props` elenca `MSTest.TestFramework`, `MSTest.TestAdapter` e `Microsoft.NET.Test.Sdk` al posto di `MSTest`. L'elenco dell'ADR 0004 si legge con questa precisazione. +- Ogni fase che aggiunge un pacchetto aggiorna i file di blocco, l'elenco del test e `docs/API-NOTES.md`. diff --git a/global.json b/global.json new file mode 100644 index 0000000..512142d --- /dev/null +++ b/global.json @@ -0,0 +1,6 @@ +{ + "sdk": { + "version": "10.0.100", + "rollForward": "latestFeature" + } +} diff --git a/src/Anubis.Desktop/Anubis.Desktop.csproj b/src/Anubis.Desktop/Anubis.Desktop.csproj new file mode 100644 index 0000000..70bc82a --- /dev/null +++ b/src/Anubis.Desktop/Anubis.Desktop.csproj @@ -0,0 +1,11 @@ + + + Exe + net10.0-windows + true + Anubis.Desktop + + + + + diff --git a/src/Anubis.Desktop/Program.cs b/src/Anubis.Desktop/Program.cs new file mode 100644 index 0000000..c3c9e96 --- /dev/null +++ b/src/Anubis.Desktop/Program.cs @@ -0,0 +1,3 @@ +// Placeholder: the desktop window and tray icon arrives in phase 10 (ADR 0003). +await Console.Error.WriteLineAsync("Anubis.Desktop non è ancora disponibile: arriva nella Fase 10.").ConfigureAwait(false); +return 2; diff --git a/src/Anubis.Desktop/packages.lock.json b/src/Anubis.Desktop/packages.lock.json new file mode 100644 index 0000000..8f93eae --- /dev/null +++ b/src/Anubis.Desktop/packages.lock.json @@ -0,0 +1,10 @@ +{ + "version": 2, + "dependencies": { + "net10.0-windows7.0": { + "anubis": { + "type": "Project" + } + } + } +} \ No newline at end of file diff --git a/src/Anubis.Guard/Anubis.Guard.csproj b/src/Anubis.Guard/Anubis.Guard.csproj new file mode 100644 index 0000000..c231f26 --- /dev/null +++ b/src/Anubis.Guard/Anubis.Guard.csproj @@ -0,0 +1,9 @@ + + + Exe + Anubis.Guard + + + + + diff --git a/src/Anubis.Guard/Program.cs b/src/Anubis.Guard/Program.cs new file mode 100644 index 0000000..4dfc043 --- /dev/null +++ b/src/Anubis.Guard/Program.cs @@ -0,0 +1,3 @@ +// Placeholder: the guard process (SPEC 9.3) arrives in phase 6 (ADR 0003). +await Console.Error.WriteLineAsync("Anubis.Guard non è ancora disponibile: arriva nella Fase 6.").ConfigureAwait(false); +return 2; diff --git a/src/Anubis.Guard/packages.lock.json b/src/Anubis.Guard/packages.lock.json new file mode 100644 index 0000000..c644c09 --- /dev/null +++ b/src/Anubis.Guard/packages.lock.json @@ -0,0 +1,10 @@ +{ + "version": 2, + "dependencies": { + "net10.0": { + "anubis": { + "type": "Project" + } + } + } +} \ No newline at end of file diff --git a/src/Anubis.Server/Anubis.Server.csproj b/src/Anubis.Server/Anubis.Server.csproj new file mode 100644 index 0000000..890fc6d --- /dev/null +++ b/src/Anubis.Server/Anubis.Server.csproj @@ -0,0 +1,12 @@ + + + Anubis.Server + false + + + + + + + + diff --git a/src/Anubis.Server/Program.cs b/src/Anubis.Server/Program.cs new file mode 100644 index 0000000..1f0ed79 --- /dev/null +++ b/src/Anubis.Server/Program.cs @@ -0,0 +1,4 @@ +using Anubis.Server; + +var app = ServerApp.Build(args); +await app.RunAsync().ConfigureAwait(false); diff --git a/src/Anubis.Server/ServerApp.cs b/src/Anubis.Server/ServerApp.cs new file mode 100644 index 0000000..5aca06a --- /dev/null +++ b/src/Anubis.Server/ServerApp.cs @@ -0,0 +1,18 @@ +namespace Anubis.Server; + +/// Builds the web application. Kept apart from Program so tests can host it. +internal static class ServerApp +{ + public static WebApplication Build(string[] args) + { + var builder = WebApplication.CreateBuilder(args); + var app = builder.Build(); + + app.MapGet("/health", () => Results.Ok(new HealthResponse("ok", AnubisInfo.Name, AnubisInfo.Version))); + + return app; + } +} + +/// Answer of GET /health. +internal sealed record HealthResponse(string Status, string Name, string Version); diff --git a/src/Anubis.Server/packages.lock.json b/src/Anubis.Server/packages.lock.json new file mode 100644 index 0000000..c644c09 --- /dev/null +++ b/src/Anubis.Server/packages.lock.json @@ -0,0 +1,10 @@ +{ + "version": 2, + "dependencies": { + "net10.0": { + "anubis": { + "type": "Project" + } + } + } +} \ No newline at end of file diff --git a/src/Anubis.Setup/Anubis.Setup.csproj b/src/Anubis.Setup/Anubis.Setup.csproj new file mode 100644 index 0000000..43b0069 --- /dev/null +++ b/src/Anubis.Setup/Anubis.Setup.csproj @@ -0,0 +1,11 @@ + + + Exe + net10.0-windows + true + Anubis.Setup + + + + + diff --git a/src/Anubis.Setup/Program.cs b/src/Anubis.Setup/Program.cs new file mode 100644 index 0000000..c616e2e --- /dev/null +++ b/src/Anubis.Setup/Program.cs @@ -0,0 +1,3 @@ +// Placeholder: the Windows installer arrives in phase 10 (ADR 0003). +await Console.Error.WriteLineAsync("Anubis.Setup non è ancora disponibile: arriva nella Fase 10.").ConfigureAwait(false); +return 2; diff --git a/src/Anubis.Setup/packages.lock.json b/src/Anubis.Setup/packages.lock.json new file mode 100644 index 0000000..8f93eae --- /dev/null +++ b/src/Anubis.Setup/packages.lock.json @@ -0,0 +1,10 @@ +{ + "version": 2, + "dependencies": { + "net10.0-windows7.0": { + "anubis": { + "type": "Project" + } + } + } +} \ No newline at end of file diff --git a/src/Anubis/Anubis.csproj b/src/Anubis/Anubis.csproj new file mode 100644 index 0000000..a65610b --- /dev/null +++ b/src/Anubis/Anubis.csproj @@ -0,0 +1,8 @@ + + + Anubis + + + + + diff --git a/src/Anubis/AnubisInfo.cs b/src/Anubis/AnubisInfo.cs new file mode 100644 index 0000000..e03e457 --- /dev/null +++ b/src/Anubis/AnubisInfo.cs @@ -0,0 +1,18 @@ +namespace Anubis; + +/// Names fixed by ADR 0001, shared by every part of the bot. +public static class AnubisInfo +{ + /// Name shown to the user. + public const string Name = "Anubis"; + + /// Three-letter prefix of every client order id (SPEC 7.2). + public const string OrderPrefix = "ANU"; + + /// Prefix of every environment variable read at start-up. + public const string EnvironmentPrefix = "ANUBIS_"; + + /// Version of the running build, for example "0.0.1". + public static string Version { get; } = + typeof(AnubisInfo).Assembly.GetName().Version?.ToString(3) ?? "0.0.0"; +} diff --git a/src/Anubis/README.md b/src/Anubis/README.md new file mode 100644 index 0000000..6b16a2a --- /dev/null +++ b/src/Anubis/README.md @@ -0,0 +1,23 @@ +# Anubis (libreria) + +Tutta la logica del bot, una cartella e un namespace per ogni modulo della SPEC 5.1 (ADR 0003). +Le cartelle nascono con il primo codice che le riempie: + +| Cartella | Namespace | Contenuto | Fase | +|---|---|---|---| +| `Core/` | `Anubis.Core` | orologio, bus degli eventi, pianificatore, impostazioni, segreti, registri, identificativi, guardia, formati | 1 | +| `Platform/` | `Anubis.Platform` | configurazione d'avvio Docker e desktop, cartella dei dati, custodia dei segreti | 1 | +| `Db/` | `Anubis.Db` | accesso ADO.NET, repository, migrazioni SQL | 1 | +| `Brokers/` | `Anubis.Brokers` | interfaccia, Alpaca, OKX, simulatore, batteria di conformità | 2–3 | +| `Data/` | `Anubis.Data` | strumenti, barre, raccolta, qualità, importatori, cambi, calendari | 2 | +| `News/` | `Anubis.News` | fonti, pipeline, classificatore, analista, impatto | 7 | +| `Strategies/` | `Anubis.Strategies` | strategie e candidate | 4–5 | +| `Portfolio/` | `Anubis.Portfolio` | allocazione, dimensionamento, ribilanciamento | 5 | +| `Risk/` | `Anubis.Risk` | regole, motore, interruttore, riconciliazione | 3–6 | +| `Execution/` | `Anubis.Execution` | OMS, algoritmi d'ordine, scostamento | 3 | +| `Accounting/` | `Anubis.Accounting` | registro, lotti, patrimonio, rendimenti, esportazioni | 3 | +| `Ml/` | `Anubis.Ml` | feature, etichette, addestramento, registro modelli, deriva | 8 | +| `Backtest/` | `Anubis.Backtest` | motore, costi, validazione, rapporti | 4 | +| `Journal/` | `Anubis.Journal` | codici motivo e frasi in italiano | 3 | +| `Notify/` | `Anubis.Notify` | Telegram | 6 | +| `Demo/` | `Anubis.Demo` | modalità dimostrativa (appendice F) | 1 | diff --git a/src/Anubis/packages.lock.json b/src/Anubis/packages.lock.json new file mode 100644 index 0000000..6afd678 --- /dev/null +++ b/src/Anubis/packages.lock.json @@ -0,0 +1,6 @@ +{ + "version": 2, + "dependencies": { + "net10.0": {} + } +} \ No newline at end of file diff --git a/tasks.ps1 b/tasks.ps1 new file mode 100644 index 0000000..00b665a --- /dev/null +++ b/tasks.ps1 @@ -0,0 +1,11 @@ +# Project commands (ADR 0003). Usage: ./tasks.ps1 check +# The tool is built into artifacts/tasks so the solution build never overwrites a running copy. +$ErrorActionPreference = 'Stop' +Push-Location $PSScriptRoot +try { + dotnet build tools/Anubis.Tasks -c Release -o artifacts/tasks --nologo -v quiet | Out-Null + if ($LASTEXITCODE -ne 0) { dotnet build tools/Anubis.Tasks -c Release -o artifacts/tasks --nologo; exit $LASTEXITCODE } + dotnet artifacts/tasks/Anubis.Tasks.dll @args + exit $LASTEXITCODE +} +finally { Pop-Location } diff --git a/tasks.sh b/tasks.sh new file mode 100755 index 0000000..17a5789 --- /dev/null +++ b/tasks.sh @@ -0,0 +1,8 @@ +#!/usr/bin/env sh +# Project commands (ADR 0003). Usage: ./tasks.sh check +# The tool is built into artifacts/tasks so the solution build never overwrites a running copy. +set -e +cd "$(dirname "$0")" +dotnet build tools/Anubis.Tasks -c Release -o artifacts/tasks --nologo -v quiet >/dev/null \ + || dotnet build tools/Anubis.Tasks -c Release -o artifacts/tasks --nologo +exec dotnet artifacts/tasks/Anubis.Tasks.dll "$@" diff --git a/tests/Anubis.Tests/Anubis.Tests.csproj b/tests/Anubis.Tests/Anubis.Tests.csproj new file mode 100644 index 0000000..891b2d4 --- /dev/null +++ b/tests/Anubis.Tests/Anubis.Tests.csproj @@ -0,0 +1,16 @@ + + + Anubis.Tests + false + true + + + + + + + + + + + diff --git a/tests/Anubis.Tests/DependencyPolicyTests.cs b/tests/Anubis.Tests/DependencyPolicyTests.cs new file mode 100644 index 0000000..d19a783 --- /dev/null +++ b/tests/Anubis.Tests/DependencyPolicyTests.cs @@ -0,0 +1,108 @@ +using System.Text.Json; +using System.Xml.Linq; + +namespace Anubis.Tests; + +/// ADR 0004: only the packages the user authorised, and nothing else sneaking in. +[TestClass] +public sealed class DependencyPolicyTests +{ + /// The list of ADR 0004. Changing it needs the user's permission and a new ADR. + private static readonly HashSet _authorised = new(StringComparer.OrdinalIgnoreCase) + { + "Microsoft.Data.Sqlite", + "System.Security.Cryptography.ProtectedData", + "Microsoft.Web.WebView2", + "MSTest.TestFramework", + "MSTest.TestAdapter", + "Microsoft.NET.Test.Sdk", + "Npgsql", + "Microsoft.ML", + "Microsoft.ML.LightGbm", + "Microsoft.ML.FastTree", + "Microsoft.ML.OnnxRuntime", + "Microsoft.ML.Tokenizers", + }; + + /// + /// Third-party packages pulled in by an authorised one, each listed in docs/API-NOTES.md and + /// reported to the user. Microsoft.* and System.* ids are reserved to Microsoft on nuget.org. + /// + private static readonly HashSet _knownThirdPartyTransitive = new(StringComparer.OrdinalIgnoreCase); + + [TestMethod] + [TestCategory(Category.Unit)] + public void CentralVersionsListOnlyAuthorisedPackages() + { + var props = XDocument.Load(Path.Combine(Repo.Root.FullName, "Directory.Packages.props")); + var listed = props.Descendants("PackageVersion").Select(e => (string)e.Attribute("Include")!).ToList(); + + var notAllowed = listed.Where(id => !_authorised.Contains(id)).ToList(); + Assert.IsEmpty(notAllowed, "Pacchetti non autorizzati (ADR 0004): " + string.Join(", ", notAllowed)); + } + + [TestMethod] + [TestCategory(Category.Unit)] + public void ProjectsDoNotPinVersionsOrBypassTheCentralList() + { + var problems = new List(); + foreach (var project in Repo.Files().Where(f => f.Extension.Equals(".csproj", StringComparison.OrdinalIgnoreCase))) + { + var doc = XDocument.Load(project.FullName); + foreach (var reference in doc.Descendants("PackageReference")) + { + var id = (string?)reference.Attribute("Include") ?? "?"; + if (reference.Attribute("Version") is not null || reference.Attribute("VersionOverride") is not null) + { + problems.Add($"{Repo.Relative(project)}: {id} ha una versione propria"); + } + + if (!_authorised.Contains(id)) + { + problems.Add($"{Repo.Relative(project)}: {id} non è autorizzato"); + } + } + } + + Assert.IsEmpty(problems, string.Join(Environment.NewLine, problems)); + } + + [TestMethod] + [TestCategory(Category.Unit)] + public void LockFilesContainNoUnknownThirdPartyPackage() + { + var lockFiles = Repo.Files().Where(f => f.Name.Equals("packages.lock.json", StringComparison.OrdinalIgnoreCase)).ToList(); + Assert.IsNotEmpty(lockFiles, "Nessun packages.lock.json: i file di blocco devono essere nel repository."); + + var unknown = new SortedSet(StringComparer.OrdinalIgnoreCase); + foreach (var file in lockFiles) + { + using var doc = JsonDocument.Parse(File.ReadAllText(file.FullName)); + foreach (var framework in doc.RootElement.GetProperty("dependencies").EnumerateObject()) + { + foreach (var package in framework.Value.EnumerateObject()) + { + var type = package.Value.TryGetProperty("type", out var t) ? t.GetString() : null; + if (type == "Project") + { + continue; + } + + var id = package.Name; + if (!_authorised.Contains(id) && !IsMicrosoftId(id) && !_knownThirdPartyTransitive.Contains(id)) + { + unknown.Add($"{id} (in {Repo.Relative(file)})"); + } + } + } + } + + Assert.IsEmpty(unknown, "Dipendenze di terze parti non dichiarate: " + string.Join(", ", unknown)); + } + + private static bool IsMicrosoftId(string id) => + id.StartsWith("Microsoft.", StringComparison.OrdinalIgnoreCase) + || id.StartsWith("System.", StringComparison.OrdinalIgnoreCase) + || id.StartsWith("MSTest.", StringComparison.OrdinalIgnoreCase) + || id.Equals("NETStandard.Library", StringComparison.OrdinalIgnoreCase); +} diff --git a/tests/Anubis.Tests/HealthEndpointTests.cs b/tests/Anubis.Tests/HealthEndpointTests.cs new file mode 100644 index 0000000..540d7f3 --- /dev/null +++ b/tests/Anubis.Tests/HealthEndpointTests.cs @@ -0,0 +1,37 @@ +using System.Net; +using System.Net.Http.Json; +using Anubis.Server; + +namespace Anubis.Tests; + +[TestClass] +public sealed class HealthEndpointTests +{ + [TestMethod] + [TestCategory(Category.Integration)] + public async Task HealthAnswersOkWithNameAndVersion() + { + // The real server on a free local port: no test host package needed (ADR 0004). + var app = ServerApp.Build(["--urls", "http://127.0.0.1:0"]); + await app.StartAsync().ConfigureAwait(false); + try + { + var address = app.Urls.Single(); + using var http = new HttpClient { BaseAddress = new Uri(address) }; + + using var response = await http.GetAsync(new Uri("/health", UriKind.Relative)).ConfigureAwait(false); + var body = await response.Content.ReadFromJsonAsync().ConfigureAwait(false); + + Assert.AreEqual(HttpStatusCode.OK, response.StatusCode); + Assert.IsNotNull(body); + Assert.AreEqual("ok", body.Status); + Assert.AreEqual(AnubisInfo.Name, body.Name); + Assert.AreEqual(AnubisInfo.Version, body.Version); + } + finally + { + await app.StopAsync().ConfigureAwait(false); + await app.DisposeAsync().ConfigureAwait(false); + } + } +} diff --git a/tests/Anubis.Tests/LiveSafetyTests.cs b/tests/Anubis.Tests/LiveSafetyTests.cs new file mode 100644 index 0000000..a2e30c1 --- /dev/null +++ b/tests/Anubis.Tests/LiveSafetyTests.cs @@ -0,0 +1,47 @@ +using System.Text.RegularExpressions; + +namespace Anubis.Tests; + +/// SPEC 2.2: real money must never be enabled during development. +[TestClass] +public sealed partial class LiveSafetyTests +{ + [TestMethod] + [TestCategory(Category.Unit)] + public void AllowLiveIsNotSetInTheEnvironment() + { + var value = Environment.GetEnvironmentVariable("ANUBIS_ALLOW_LIVE"); + Assert.IsFalse(value?.Trim() == "1", "ANUBIS_ALLOW_LIVE=1 è attivo: durante lo sviluppo non si attiva mai (SPEC 2.2)."); + } + + [TestMethod] + [TestCategory(Category.Unit)] + public void NoConfigurationFileEnablesRealMoney() + { + // Configuration-like files only: the documentation quotes the switches to forbid them. + string[] extensions = [".toml", ".env", ".yml", ".yaml", ".json", ".xml", ".ps1", ".sh", ".props"]; + var offenders = Repo.Files() + .Where(f => extensions.Contains(f.Extension, StringComparer.OrdinalIgnoreCase) + || f.Name.StartsWith(".env", StringComparison.OrdinalIgnoreCase) + || f.Name.Equals("Dockerfile", StringComparison.OrdinalIgnoreCase)) + .Where(f => LiveSwitch().IsMatch(File.ReadAllText(f.FullName))) + .Select(Repo.Relative) + .ToList(); + + Assert.IsEmpty(offenders, "Soldi veri attivi in: " + string.Join(", ", offenders)); + } + + [TestMethod] + [TestCategory(Category.Unit)] + public void PatternRecognisesBothSwitches() + { + Assert.IsTrue(LiveSwitch().IsMatch("ANUBIS_ALLOW_LIVE=1")); + Assert.IsTrue(LiveSwitch().IsMatch(" ANUBIS_ALLOW_LIVE: \"1\"")); + Assert.IsTrue(LiveSwitch().IsMatch("allow_live = true")); + Assert.IsFalse(LiveSwitch().IsMatch("ANUBIS_ALLOW_LIVE=0")); + Assert.IsFalse(LiveSwitch().IsMatch("allow_live = false")); + } + + [GeneratedRegex("""ANUBIS_ALLOW_LIVE\s*[:=]\s*["']?1\b|allow_live\s*=\s*true\b""", RegexOptions.IgnoreCase)] + private static partial Regex LiveSwitch(); +} diff --git a/tests/Anubis.Tests/SecretScanTests.cs b/tests/Anubis.Tests/SecretScanTests.cs new file mode 100644 index 0000000..4b00711 --- /dev/null +++ b/tests/Anubis.Tests/SecretScanTests.cs @@ -0,0 +1,64 @@ +using System.Text.RegularExpressions; + +namespace Anubis.Tests; + +/// SPEC 2.2: no secret in the repository. Only .env.example with fake values. +[TestClass] +public sealed partial class SecretScanTests +{ + private static readonly HashSet _binaryExtensions = new(StringComparer.OrdinalIgnoreCase) + { + ".png", ".jpg", ".jpeg", ".ico", ".gif", ".webp", ".ttf", ".woff", ".woff2", ".onnx", ".dll", ".exe", ".pdb", ".zip", ".gz", + }; + + [TestMethod] + [TestCategory(Category.Unit)] + public void RepositoryContainsNoSecrets() + { + var findings = new List(); + foreach (var file in Repo.Files().Where(f => !_binaryExtensions.Contains(f.Extension))) + { + var lineNumber = 0; + foreach (var line in File.ReadLines(file.FullName)) + { + lineNumber++; + if (LooksLikeSecret(line)) + { + findings.Add($"{Repo.Relative(file)}:{lineNumber}"); + } + } + } + + Assert.IsEmpty(findings, "Possibili segreti: " + string.Join(", ", findings)); + } + + [TestMethod] + [TestCategory(Category.Unit)] + public void DetectorFindsTypicalSecretsAndIgnoresPlaceholders() + { + Assert.IsTrue(LooksLikeSecret("-----BEGIN " + "PRIVATE KEY-----")); + Assert.IsTrue(LooksLikeSecret("APCA-API-SECRET-KEY: " + new string('a', 40))); + Assert.IsTrue(LooksLikeSecret("OK-ACCESS-PASSPHRASE=" + "Sup3rS3cretPass")); + Assert.IsTrue(LooksLikeSecret("TELEGRAM_BOT_TOKEN=123456789:" + new string('A', 35))); + Assert.IsTrue(LooksLikeSecret("api_key = \"" + "AKZXCVBNMASDFGHJKLQWERTY12" + "\"")); + + Assert.IsFalse(LooksLikeSecret("ANUBIS_SECRET_KEY=replace-with-random")); + Assert.IsFalse(LooksLikeSecret("APCA-API-SECRET-KEY: ")); + Assert.IsFalse(LooksLikeSecret("POSTGRES_PASSWORD: anubis-dev")); + } + + private static bool LooksLikeSecret(string line) => + PrivateKey().IsMatch(line) || BrokerHeader().IsMatch(line) || TelegramToken().IsMatch(line) || GenericSecret().IsMatch(line); + + [GeneratedRegex("-----BEGIN (RSA |EC |OPENSSH |DSA )?PRIVATE KEY-----")] + private static partial Regex PrivateKey(); + + [GeneratedRegex("""(APCA-API-(KEY-ID|SECRET-KEY)|OK-ACCESS-(KEY|SIGN|PASSPHRASE))\s*[:=]\s*["']?[A-Za-z0-9/+=_\-]{12,}""")] + private static partial Regex BrokerHeader(); + + [GeneratedRegex(@"\b\d{8,10}:[A-Za-z0-9_\-]{35}\b")] + private static partial Regex TelegramToken(); + + [GeneratedRegex("""(?i)(api[_-]?key|secret|token|passphrase|password)["']?\s*[:=]\s*["']?(?=[A-Za-z0-9/+=_\-]*\d)(?=[A-Za-z0-9/+=_\-]*[A-Za-z])[A-Za-z0-9/+=_\-]{24,}""")] + private static partial Regex GenericSecret(); +} diff --git a/tests/Anubis.Tests/TestDatabaseTests.cs b/tests/Anubis.Tests/TestDatabaseTests.cs new file mode 100644 index 0000000..c8b1a25 --- /dev/null +++ b/tests/Anubis.Tests/TestDatabaseTests.cs @@ -0,0 +1,28 @@ +namespace Anubis.Tests; + +/// The suite runs on SQLite and on PostgreSQL (SPEC 16): the engine comes from ANUBIS_TEST_DB. +[TestClass] +public sealed class TestDatabaseTests +{ + [TestMethod] + [TestCategory(Category.Unit)] + public void EngineIsSqliteOrPostgres() + { + Assert.IsTrue(TestDatabase.Engine is "sqlite" or "postgres", $"ANUBIS_TEST_DB non valido: {TestDatabase.Engine}"); + } + + [TestMethod] + [TestCategory(Category.Integration)] + public async Task PostgresIsReachableWhenSelected() + { + if (TestDatabase.Engine != "postgres") + { + Assert.Inconclusive("Giro su SQLite: PostgreSQL non richiesto."); + } + + var (host, port) = TestDatabase.Postgres; + Assert.IsTrue( + await TestDatabase.PostgresReachableAsync(TimeSpan.FromSeconds(5)).ConfigureAwait(false), + $"PostgreSQL non raggiungibile su {host}:{port}."); + } +} diff --git a/tests/Anubis.Tests/TestSupport.cs b/tests/Anubis.Tests/TestSupport.cs new file mode 100644 index 0000000..5934944 --- /dev/null +++ b/tests/Anubis.Tests/TestSupport.cs @@ -0,0 +1,89 @@ +using System.Net.Sockets; + +[assembly: Parallelize(Scope = ExecutionScope.MethodLevel)] + +namespace Anubis.Tests; + +/// Test categories (ADR 0003). never runs in the normal suite. +internal static class Category +{ + public const string Unit = "Unit"; + public const string Integration = "Integration"; + public const string Simulation = "Simulation"; + public const string LiveDemo = "LiveDemo"; + public const string Golden = "Golden"; +} + +/// Locates the repository so policy tests can read its files. +internal static class Repo +{ + public static DirectoryInfo Root { get; } = FindRoot(); + + private static DirectoryInfo FindRoot() + { + for (var dir = new DirectoryInfo(AppContext.BaseDirectory); dir is not null; dir = dir.Parent) + { + if (File.Exists(Path.Combine(dir.FullName, "Anubis.slnx"))) + { + return dir; + } + } + + throw new InvalidOperationException("Repository root (Anubis.slnx) not found above " + AppContext.BaseDirectory); + } + + private static readonly string[] _skippedDirectories = ["bin", "obj", ".git", ".vs", ".claude", "artifacts", "TestResults", "publish", "screenshots"]; + + /// All files of the working tree, without build output and tool folders. + public static IEnumerable Files() + { + var pending = new Stack(); + pending.Push(Root); + while (pending.Count > 0) + { + var dir = pending.Pop(); + foreach (var sub in dir.EnumerateDirectories()) + { + if (!_skippedDirectories.Contains(sub.Name, StringComparer.OrdinalIgnoreCase)) + { + pending.Push(sub); + } + } + + foreach (var file in dir.EnumerateFiles()) + { + yield return file; + } + } + } + + public static string Relative(FileInfo file) => + Path.GetRelativePath(Root.FullName, file.FullName).Replace('\\', '/'); +} + +/// Database engine the suite runs against: ANUBIS_TEST_DB = sqlite (default) or postgres. +internal static class TestDatabase +{ + public static string Engine { get; } = + (Environment.GetEnvironmentVariable("ANUBIS_TEST_DB") ?? "sqlite").Trim().ToLowerInvariant(); + + /// Host and port of the PostgreSQL used by the tests, from ANUBIS_TEST_PG_HOST and ANUBIS_TEST_PG_PORT. + public static (string Host, int Port) Postgres { get; } = ( + Environment.GetEnvironmentVariable("ANUBIS_TEST_PG_HOST") ?? "localhost", + int.TryParse(Environment.GetEnvironmentVariable("ANUBIS_TEST_PG_PORT"), out var port) ? port : 55432); + + public static async Task PostgresReachableAsync(TimeSpan timeout) + { + using var client = new TcpClient(); + using var cts = new CancellationTokenSource(timeout); + try + { + await client.ConnectAsync(Postgres.Host, Postgres.Port, cts.Token).ConfigureAwait(false); + return true; + } + catch (Exception ex) when (ex is SocketException or OperationCanceledException) + { + return false; + } + } +} diff --git a/tests/Anubis.Tests/packages.lock.json b/tests/Anubis.Tests/packages.lock.json new file mode 100644 index 0000000..cba2da5 --- /dev/null +++ b/tests/Anubis.Tests/packages.lock.json @@ -0,0 +1,106 @@ +{ + "version": 2, + "dependencies": { + "net10.0": { + "Microsoft.NET.Test.Sdk": { + "type": "Direct", + "requested": "[18.11.0, )", + "resolved": "18.11.0", + "contentHash": "xf/bR0LNkhK0SnadDRlZIQmC4sac5Wk0e1WAdiQjRN3MSo6gQ9M2c4c1XRNnVGjfOvckh704W5CJ19AL0/Xsdg==", + "dependencies": { + "Microsoft.CodeCoverage": "18.11.0", + "Microsoft.TestPlatform.TestHost": "18.11.0" + } + }, + "MSTest.TestAdapter": { + "type": "Direct", + "requested": "[4.5.2, )", + "resolved": "4.5.2", + "contentHash": "3ZM4AiMnHHI58VKcn4DUlz9HMtPk+ucN/WNYiB0k29gaihTPiK5vcXX49iisgbLd8aFlSoaEIRBPekKs/wDYfA==", + "dependencies": { + "MSTest.TestFramework": "4.5.2", + "Microsoft.TestPlatform.ObjectModel": "18.10.1", + "Microsoft.Testing.Extensions.Telemetry": "2.5.2", + "Microsoft.Testing.Extensions.TrxReport.Abstractions": "2.5.2", + "Microsoft.Testing.Platform.MSBuild": "2.5.2" + } + }, + "MSTest.TestFramework": { + "type": "Direct", + "requested": "[4.5.2, )", + "resolved": "4.5.2", + "contentHash": "9U+a6ZcsIEXnC2Q8D2RRBpvo3ro83RfGLfeCJC+NomPhiCD6gi9ehpk00A1TC0Za+nB7j5sn6V1VbDanqoohsA==", + "dependencies": { + "MSTest.Analyzers": "4.5.2" + } + }, + "Microsoft.ApplicationInsights": { + "type": "Transitive", + "resolved": "2.23.0", + "contentHash": "nWArUZTdU7iqZLycLKWe0TDms48KKGE6pONH2terYNa8REXiqixrMOkf1sk5DHGMaUTqONU2YkS4SAXBhLStgw==" + }, + "Microsoft.CodeCoverage": { + "type": "Transitive", + "resolved": "18.11.0", + "contentHash": "MhN9wpvL1Es4hfIYslrsVgIsUdDFxuOBTbAl9mGIMvFo8PP5CLf4DrGdNrfwWSyn0lqi6sssm+I/qkkLL3MU+g==" + }, + "Microsoft.Testing.Extensions.Telemetry": { + "type": "Transitive", + "resolved": "2.5.2", + "contentHash": "j1XGKCBrmfNm0tmotMa05GlqVtb2cW5UaMkKCFHPyyFHz5rdOy7TD0SVXnZJ+QMrjPAHjRoRqn5qcsUjICSWwg==", + "dependencies": { + "Microsoft.ApplicationInsights": "2.23.0", + "Microsoft.Testing.Platform": "[2.5.2, 3.0.0)" + } + }, + "Microsoft.Testing.Extensions.TrxReport.Abstractions": { + "type": "Transitive", + "resolved": "2.5.2", + "contentHash": "+xTIaIU9H44GxOyjrfieMSZnxltGvleA3jCRtdEAzlXKb85pMmVYMLUv2JS8KwD+U2wQHUgvy5YfQfWoPEfVdQ==", + "dependencies": { + "Microsoft.Testing.Platform": "[2.5.2, 3.0.0)" + } + }, + "Microsoft.Testing.Platform": { + "type": "Transitive", + "resolved": "2.5.2", + "contentHash": "ocX0rgGY78dKfmZlZe4hB0/dvlh7wJgUAWS+KfwrqxB9DpNsjshnne9dppCKnFNEOkX4QYsrdUU++NInFPiCBw==" + }, + "Microsoft.Testing.Platform.MSBuild": { + "type": "Transitive", + "resolved": "2.5.2", + "contentHash": "Jey2v0hd7WHHa7pr6MRNKtA07FvxcOMTCtIhTI7uBZ/qR5m1mgCVCo5L1rtVAtqgMhGA205bUwq9+is4LiCzpw==", + "dependencies": { + "Microsoft.Testing.Platform": "[2.5.2, 3.0.0)" + } + }, + "Microsoft.TestPlatform.ObjectModel": { + "type": "Transitive", + "resolved": "18.11.0", + "contentHash": "BXBHYnwSOljKute8UYCMXOLAdB7awxEMppPSpqOF1ZxLD/W/OH+vTBgFaXA7q0aditJTVXSMVenel+wOkEIyNg==" + }, + "Microsoft.TestPlatform.TestHost": { + "type": "Transitive", + "resolved": "18.11.0", + "contentHash": "AKjwKpyRBwoQFQmpcchtoYlfJEBlaY/40uxBRi+qXP4NR7xT8t+XTJtOyEyumfvfJcH5pASs75LwNdXYRr4XNA==", + "dependencies": { + "Microsoft.TestPlatform.ObjectModel": "18.11.0" + } + }, + "MSTest.Analyzers": { + "type": "Transitive", + "resolved": "4.5.2", + "contentHash": "t6Dj9AmWO9IfkMBi3yYTf7bfgSTAetsi4LFA3xGdKbJ+gBbSDqbo41U5vYiW9puD8UGl2elsizNeJVYtwNim0Q==" + }, + "anubis": { + "type": "Project" + }, + "anubis.server": { + "type": "Project", + "dependencies": { + "Anubis": "[0.0.1, )" + } + } + } + } +} \ No newline at end of file diff --git a/tools/Anubis.Tasks/Anubis.Tasks.csproj b/tools/Anubis.Tasks/Anubis.Tasks.csproj new file mode 100644 index 0000000..2c7115b --- /dev/null +++ b/tools/Anubis.Tasks/Anubis.Tasks.csproj @@ -0,0 +1,6 @@ + + + Exe + Anubis.Tasks + + diff --git a/tools/Anubis.Tasks/Program.cs b/tools/Anubis.Tasks/Program.cs new file mode 100644 index 0000000..a51be80 --- /dev/null +++ b/tools/Anubis.Tasks/Program.cs @@ -0,0 +1,151 @@ +using System.Diagnostics; +using System.Globalization; + +// Project commands (ADR 0003): the same steps on Windows and Linux, without make. +// Run through tasks.ps1 / tasks.sh, which build this tool apart from the solution. + +var root = FindRoot(); +var command = args.Length > 0 ? args[0].ToLowerInvariant() : "help"; +var rest = args.Skip(1).ToArray(); + +return command switch +{ + "check" => Check(), + "test" => Test(Environment.GetEnvironmentVariable("ANUBIS_TEST_DB") ?? "sqlite", rest), + "dev" => Run("dotnet", ["watch", "--project", "src/Anubis.Server", "run", .. rest]), + "build" => BuildImage("dev"), + "ci" => Ci(), + "seed-demo" => NotYet("seed-demo", 1), + "desktop-win" => NotYet("desktop-win", 10), + _ => Help(), +}; + +// Locked restore, formatting, build with analyzers as errors, tests on the engine in ANUBIS_TEST_DB. +int Check() +{ + var engine = Environment.GetEnvironmentVariable("ANUBIS_TEST_DB") ?? "sqlite"; + return Step("Ripristino dei pacchetti dai file di blocco", "dotnet", ["restore", "Anubis.slnx", "--locked-mode"]) + ?? Step("Controllo della formattazione", "dotnet", ["format", "Anubis.slnx", "--verify-no-changes", "--no-restore"]) + ?? Step("Compilazione con gli analizzatori", "dotnet", ["build", "Anubis.slnx", "--no-restore", "-c", "Release"]) + ?? Test(engine, ["--no-build", "-c", "Release"]); +} + +int Test(string engine, string[] extra) +{ + var env = new Dictionary { ["ANUBIS_TEST_DB"] = engine, ["TESTINGPLATFORM_TELEMETRY_OPTOUT"] = "1" }; + return Step($"Test su {engine}", "dotnet", + ["test", "Anubis.slnx", "--filter", "TestCategory!=LiveDemo", "--logger", "console;verbosity=normal", .. extra], env) ?? 0; +} + +// What the remote CI does, run locally: check on SQLite, tests on PostgreSQL, image build. +int Ci() +{ + var failed = Check(); + if (failed != 0) + { + return failed; + } + + var ownPostgres = Environment.GetEnvironmentVariable("ANUBIS_TEST_PG_HOST") is null; + if (ownPostgres) + { + failed = Step("Avvio di PostgreSQL per i test", "docker", ["compose", "up", "-d", "--wait", "postgres"]) ?? 0; + if (failed != 0) + { + return failed; + } + } + + try + { + failed = Test("postgres", ["--no-build", "-c", "Release"]); + } + finally + { + if (ownPostgres) + { + Step("Arresto di PostgreSQL", "docker", ["compose", "stop", "postgres"]); + } + } + + return failed != 0 ? failed : BuildImage("ci"); +} + +int BuildImage(string tag) => + Step("Costruzione dell'immagine Docker", "docker", + ["build", "-f", "deploy/docker/Dockerfile", "-t", $"gitea.encke-hake.ts.net/balbosoft/anubis:{tag}", "."]) ?? 0; + +int NotYet(string name, int phase) +{ + Console.Error.WriteLine($"'tasks {name}' arriva nella Fase {phase.ToString(CultureInfo.InvariantCulture)}."); + return 2; +} + +int Help() +{ + Console.WriteLine(""" + Comandi di Anubis (ADR 0003): + tasks check ripristino bloccato, formattazione, compilazione, test + tasks test solo i test (motore da ANUBIS_TEST_DB, predefinito sqlite) + tasks dev avvia il server e lo riavvia a ogni modifica + tasks build costruisce l'immagine Docker + tasks ci come la CI: check, test su PostgreSQL, immagine + tasks seed-demo dati dimostrativi (Fase 1) + tasks desktop-win installatore Windows (Fase 10) + """); + return command == "help" ? 0 : 1; +} + +// Runs one step and returns its exit code only when it failed, so steps chain with ??. +int? Step(string title, string file, string[] arguments, Dictionary? env = null) +{ + Console.WriteLine(); + Console.WriteLine($"== {title}"); + var code = Run(file, arguments, env); + if (code != 0) + { + Console.Error.WriteLine($"!! {title}: non riuscito (codice {code.ToString(CultureInfo.InvariantCulture)})"); + return code; + } + + return null; +} + +int Run(string file, string[] arguments, Dictionary? env = null) +{ + var info = new ProcessStartInfo(file) { WorkingDirectory = root, UseShellExecute = false }; + foreach (var argument in arguments) + { + info.ArgumentList.Add(argument); + } + + foreach (var (key, value) in env ?? []) + { + info.Environment[key] = value; + } + + try + { + using var process = Process.Start(info)!; + process.WaitForExit(); + return process.ExitCode; + } + catch (System.ComponentModel.Win32Exception ex) + { + Console.Error.WriteLine($"Impossibile avviare '{file}': {ex.Message}"); + return 127; + } +} + +static string FindRoot() +{ + for (var dir = new DirectoryInfo(Environment.CurrentDirectory); dir is not null; dir = dir.Parent) + { + if (File.Exists(Path.Combine(dir.FullName, "Anubis.slnx"))) + { + return dir.FullName; + } + } + + throw new InvalidOperationException("Anubis.slnx non trovato: lancia i comandi dalla cartella del repository."); +} diff --git a/tools/Anubis.Tasks/packages.lock.json b/tools/Anubis.Tasks/packages.lock.json new file mode 100644 index 0000000..6afd678 --- /dev/null +++ b/tools/Anubis.Tasks/packages.lock.json @@ -0,0 +1,6 @@ +{ + "version": 2, + "dependencies": { + "net10.0": {} + } +} \ No newline at end of file