Files
Febe/docs/decisioni.md
T
Alby96andClaude Opus 5.5 d1e29aa7a4 CI: verifica di ogni push con controlli, prove vere, installatore e immagine
La verifica girava solo su main e su un ramo che non esiste più, e saltava le
66 prove con browser, ffmpeg e makensis. Ora gira a ogni push su qualunque ramo
(e a mano), in quattro lavori: controlli veloci e gitleaks su tutta la storia;
compilazione di tutta la soluzione e tutte le prove di tests/Febe.Tests in un
contenitore Debian con Chromium, Xvfb, ffmpeg, NSIS e Node veri, senza prove
saltate, con il seme 13 e di nuovo con il seme dell'esecuzione per le prove del
sito di prova; installatore e zip con la versione -ci.<numero> come artefatti
per 14 giorni; immagine costruita con buildx, provata senza rete, scansionata
con Trivy e, solo dopo un push su main e con il segreto, pubblicata come :main e
:sha-<commit>. Senza il segreto un avviso e il lavoro resta verde; alla fine si
toglie sempre ciò che l'esecuzione ha creato. Niente pull_request, che rifarebbe
tutto sullo stesso commit. Le prove sui flussi tengono ferme queste regole.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 10:52:27 +02:00

54 KiB
Raw Blame History

Decisioni

Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15).

Data Decisione Motivo
2026-10-13 Repository su Gitea di casa (Alby96/Febe), CI con Gitea Actions in .gitea/workflows/ Risposta alla domanda 1 di §16: il repository esiste già lì; stesse convenzioni di Encelado e Mimante
2026-10-13 Alberto ha chiesto di realizzare tutte le tappe in una volta, con branch, PR, CI, wiki e rilascio Richiesta esplicita del 13 ottobre. I punti di arresto di M0 e M3 non si possono attendere: le ipotesi H e S che richiedono Instagram o Windows restano da provare e sono segnate così in docs/sonda/esito.md e docs/stato.md
2026-10-13 Inversione delle dipendenze: le interfacce (IClock, IGovernor, IBrowserHost, archivi) stanno in Febe.Core; Febe.Data e Febe.Browser le implementano Febe.Core resta senza riferimenti a piattaforma (§5) e si prova con implementazioni finte
2026-10-13 Soluzione Febe.slnx, versioni dei pacchetti centralizzate in Directory.Packages.props, versione del programma in Directory.Build.props Formato usato negli altri progetti di Alberto; un solo punto per le versioni
2026-10-13 Pacchetti: Microsoft.Data.Sqlite 10.0.12, SkiaSharp 4.153.1 (+ NativeAssets.Linux.NoDependencies), Microsoft.Web.WebView2 1.0.4258.31, MSTest 4.5.1 Ultime versioni stabili dell'elenco chiuso di §3
2026-10-13 Febe.Web usa ASP.NET Core (framework condiviso, non un pacchetto) con API minime; l'interfaccia in wwwroot è incorporata nell'assembly Un solo eseguibile anche su Windows; nessuna dipendenza in più
2026-10-13 Domande di §16 senza risposta: si adotta la proposta della terza colonna (Libreria e Dati; storie aperte con interruttore; programma di installazione; Telegram facoltativo; nome Febe; solo italiano; porta 8480) §16 chiede di proporre quella risposta; si cambia quando Alberto risponde
2026-10-13 Installatore Windows con NSIS, costruito anche da Linux (makensis), più uno zip portabile Domanda 6: proposta «programma di installazione»; NSIS gira sul runner Linux
2026-10-13 Mockup: forniti a piena risoluzione solo 00, 01, 03, 08, 10; gli altri sono ritagli della panoramica in docs/mockup/miniature/ Vedi docs/mockup/LEGGIMI.md
2026-10-13 account.id è una chiave locale; l'identità è instagram_id (TEXT, unico, facoltativo) Gli account creati dall'importazione possono non conoscerlo; IGovernor riceve la chiave locale
2026-10-13 Tutti gli identificativi Instagram salvati come TEXT Regola 10: nessuna ipotesi su formato e lunghezza
2026-10-13 Orari come millisecondi Unix UTC (INTEGER); enumerazioni come nomi inglesi (TEXT) Indici compatti; database leggibile
2026-10-13 Gli archivi sono proprietà di un unico FebeDatabase (IFebeStorage) Evita conflitti di nomi fra interfacce
2026-10-13 Scrittore unico: un thread, un canale, commit di gruppo con un savepoint per scrittura; un'operazione annullata in coda non parte nemmeno se il lotto è già iniziato §8.3; una scrittura fallita non annulla le altre
2026-10-13 Finestre della libreria con paginazione a chiave su (published_at, id) e indice coprente ix_entry_library 3–6 ms a 200.000 elementi, con o senza statistiche
2026-10-13 Ricerca testuale su una colonna normalizzata (minuscole, senza accenti) con LIKE, senza FTS5 Circa 0,1 s anche a 200.000 elementi, ricerca per sottostringa
2026-10-13 «Foto»/«Video» = post con almeno una foto/un video; «In evidenza» comprende le storie richiamate da una raccolta; «Tutto» esclude le foto del profilo Tabella di §4.3
2026-10-13 Lo schema dei nomi si applica dentro la cartella dell'account; percorsi nel database con /; segnaposto sconosciuti = errore Le cartelle degli account possono stare fuori dalla Libreria (§4.4)
2026-10-13 Percorsi lunghi: si accorcia prima il nome del file (estensione tenuta, ~ + 8 cifre esadecimali), poi le cartelle più lunghe; il limite di 240 vale su ogni sistema §4.7
2026-10-13 File temporanei .febe-<hex>.part; un nome occupato diventa nome (2).ext; mai sovrascrivere Scrittura sicura (§6.5 punto 4)
2026-10-13 Miniature per SHA-256 in miniature/ab/<sha>.jpg, JPEG 82, orientamento EXIF applicato, mai ingrandite Generate una volta sola (§8.4)
2026-10-13 Impronta visiva: pHash classico su DCT, soglia 6 Su 24 scene generate: ridimensionate/ricompresse ≤ 4, ritagliate ≥ 8, scene diverse ≥ 20
2026-10-13 _febe.jsonl versione 1: righe save/delete, tipo come nome italiano della cartella; una riga troncata da un arresto si chiude prima di aggiungere Leggibile senza Febe; regge gli arresti
2026-10-13 Eliminazione: prima la riga del giornale, poi il database, poi i file e le miniature Una ricostruzione rispetta l'eliminazione anche se Febe si ferma a metà
2026-10-13 La ricostruzione non tocca mai i file; gli account ricostruiti tornano «In pausa» con impostazioni predefinite Regola 12
2026-10-13 Controllo della cartella dei dati: UNC e DriveType.Network su Windows; /proc/self/mounts su Linux; fuse.shfs di Unraid conta come locale §8.2
2026-10-13 Gli indirizzi firmati restano in media solo finché il file non è salvato La coda degli scaricamenti sopravvive al riavvio; mai nei registri
2026-10-13 Chromium si ferma con SIGINT, non SIGTERM Con SIGTERM perdeva in 3 casi su 4 un cookie scritto da meno di 30 s (S3)
2026-10-13 Fattori del ritmo dei gesti: lento 1,35, naturale 1, svelto 0,75 La specifica non dà numeri
2026-10-13 Puntatore su curva di Bézier cubica (curvatura 2–12%), profilo di velocità a scatto minimo, circa 60 eventi al secondo, arrivo nel 60% centrale del bersaglio §7.7
2026-10-13 segnali.json e bersagli.*.json con chiavi inglesi e note in italiano; chiavi sconosciute rifiutate Coordinate o nomi di classi non possono entrarci (§6.3)
2026-10-13 ReadOnlyScriptGuard: elenco di divieti sulle espressioni di Runtime.evaluate (niente modifiche, fetch, cookie, archiviazione) Rete di sicurezza per la sola lettura di §6.1, non una prova
2026-10-13 Un segnale con lo stesso codice si inoltra all'interruttore al massimo una volta ogni 60 s; le regole sul testo guardano solo JSON brevi; le pagine vuote le segnalano le ricette (soglia 3) Una didascalia con la frase cercata non è un segnale
2026-10-13 Le navigazioni comprendono i cambi di percorso con history.pushState Instagram è un'applicazione a pagina singola
2026-10-13 BrowserFileFetcher: solo domini del CDN, senza credenziali (da rivedere con H7), blocchi da 1 MB §6.5
2026-10-13 --no-sandbox solo se richiesto esplicitamente; l'host rifiuta di partire se la porta di debug è occupata o ascolta fuori da 127.0.0.1; nel profilo nuovo salvataggio delle password e compilazione automatica spenti §6.1, §11
2026-10-13 Messaggi CDP letti senza il serializzatore JSON a riflessione Compatibile con pubblicazione ridotta e file singolo
2026-10-13 Il Governatore attende la distanza minima (4 s × ritmo) invece di rifiutare; EvaluateAsync la segnala come MinimumSpacing Le storie durano 1,8–5 s: un rifiuto fermerebbe le ricette di continuo
2026-10-13 Ordine dei controlli: interruttore, pausa/browser in uso, fascia, sessione, tetto giornaliero poi orario, distanza, limiti dell'account §7.4
2026-10-13 DataDownload controlla solo il tetto giornaliero in byte, anche durante un fermo; il dimezzamento vale anche per i dati, dal segnale §7.6
2026-10-13 Limite di storico = min(limite dell'account, valore del profilo), ridotto come i tetti; conta i post scoperti oggi «Vince il più stretto»
2026-10-13 Riduzioni: fattore = min(avvio graduale, dimezzamento), tetti arrotondati per difetto, mai sotto 1 §7.4
2026-10-13 Origine dell'avvio graduale: primo avvio del motore o NotifyFirstConnectionAsync, e ogni «Riprendi» dopo verifica §7.2
2026-10-13 L'escalation conta i rallentamenti nelle 24 ore; un segnale durante un fermo non lo allunga; «Riprendi» non accorcia un rallentamento Durate fisse
2026-10-13 Spostamento della fascia: normale con σ = metà dello scarto, tagliata a ± scarto, da un seme salvato (motore.fascia-seme) Mai uniforme; un riavvio non lo riestrae
2026-10-13 La durata estratta è il tetto della sessione: finito il lavoro, la sessione chiude prima Meno traffico, mai di più
2026-10-13 Prima sessione 2–10 min dopo avvio, fine rallentamento o «Riprendi»; prossima sessione salvata e mai anticipata da un riavvio; pausa minima dall'ultima sessione o azione §7.2
2026-10-13 «Controlla ora» in fascia anticipa la sessione solo fino alla pausa minima; fuori fascia gettone valido 10 min, poi una sola visita di quell'account §7.8
2026-10-13 Controllo manuale ammesso su account in pausa o non raggiungibili, mai su «Solo archivio» o privati non seguiti Regola 6
2026-10-13 Profili non seguiti: una visita (profilo + storie) al più corto dei due intervalli Le loro storie si vedono solo dal profilo
2026-10-13 Intervallo delle storie: scostamento sotto il massimo (mediana 0,75, σ 0,25, [0,45; 1]) e mai oltre un terzo della fascia Almeno 3 controlli al giorno
2026-10-13 Ipotesi H2 da confermare in M0 (SweepCoversFollowedStories): il giro dei seguiti vale come controllo delle storie dei seguiti Meno aperture
2026-10-13 Ipotesi H3 da confermare in M0 (PostsPerBackfillPage = 12), solo per stime Regola 10
2026-10-13 Su misura: riconciliazione dei seguiti = 4 × intervallo dei post, fra 6 e 24 ore La specifica non lo dice
2026-10-13 Composizione: giro all'inizio con probabilità 0,9; sessione leggera 1 su 3; 3–12 pagine di storico; 1–4 s fra ricette × umore × ritmo; ordine pesato con u^(1/peso) §7.2
2026-10-13 Tre «formato non riconosciuto» o «bersaglio non trovato» di fila sospendono la ricetta; un bersaglio non trovato chiude la sessione §6.4, §7.7
2026-10-13 Lo storico gira solo per account nello stato «Storico in corso»; con «Tieni aggiornato» spento, dopo lo storico l'account va in pausa §4.4
2026-10-13 A fine sessione pagina vuota, tranne dopo verifica/disconnessione o con Alberto al browser §6.1, §7.6
2026-10-13 Un segnale annulla la sessione da un thread del pool, mai sul thread di cattura Il motore non deve bloccare il client CDP
2026-10-13 Una riga di evento per ricetta («ricetta.», «Titolo: dettaglio»), una per sessione, più fermi, pause, tetti raggiunti e storico Attività e cronologia dell'account
2026-10-13 Orologio virtuale a eventi, ritardi arrotondati al millisecondo; il mondo simulato ha un seme proprio e rallentamenti con probabilità 0,0003 per azione Simulazione deterministica e veloce
2026-10-13 Impostazioni del motore nella tabella setting (chiavi motore.*); profilo Su misura scritto con JsonNode Nessun serializzatore a riflessione
2026-10-13 Ore senza zero iniziale («verso le 7:42», «verso l'1:05») Uso italiano
2026-10-13 bersagli.*.json e lettori.*.json in src/Febe.Core/Config, incorporati e copiati in config/, sovrascrivibili dalla cartella Dati Stessa via di segnali.json; si aggiornano senza ricompilare
2026-10-13 bersagli.*.json ha una sezione pages (indirizzi e forma dell'indirizzo dei visualizzatori); voci con role/name/href vuoti = da compilare; una ricetta con una voce necessaria vuota si rifiuta senza aprire pagine né chiedere permessi Scheletro Instagram (H11) senza inventare nulla
2026-10-13 Vocabolario dei lettori per concetti, con stato «confermato»/«ipotesi»; Instagram = ipotesi con i soli indizi di §6.4 Regola 10
2026-10-13 Lettore per forma: contenuto = id+data+(immagini|video|figli); profilo = id+nome; raccolta = id+titolo; «vuota» = nessun elenco con elementi; il resto «non riconosciuta» con la sola struttura delle chiavi §6.4
2026-10-13 Versione: immagine di area massima; video più grande fra quelli con audio (chi non lo dice conta come completo), altrimenti il più grande §6.5 punto 1
2026-10-13 StoryView chiesto prima dell'apertura e di ogni «avanti»; se il visualizzatore avanza da solo si chiede subito dopo e, se negato, si chiude. Chiudere non è un'azione contata Una vista, un permesso; chiudere evita viste in più
2026-10-13 Storico: ripresa dalla pagina profileFrom se la mappa la prevede, altrimenti scorrendo (ogni pagina contata); cursori di Taggati e Reel nelle impostazioni (raccolta.taggati.{id}.cursore, raccolta.reel.{id}.cursore); a tab completa solo controllo della prima pagina §6.3 «riprende dal punto»
2026-10-13 Elenco dei seguiti: avanzamento in seguiti.cursore/seguiti.inizio/seguiti.letti Più sessioni (§4.2)
2026-10-13 Foto del profilo: identità = hash del percorso dell'indirizzo, senza firma Nuova copia solo quando cambia
2026-10-13 §9.5 identico: se l'esistente è importato senza identificativo, stesso tipo e un solo file, l'importato prende i dati e il nuovo record si toglie; altrimenti il nuovo file diventa «saltato» con nota Nessuna sostituzione automatica (regola 12)
2026-10-13 Coda: file temporaneo .febe-*.part in Dati/temporanei; 403/410 = indirizzo scaduto (ipotesi H7); storia scaduta → «fallito»; errori di rete → di nuovo «da scaricare», fino a 5 tentativi §6.5
2026-10-13 Via HttpClient di §6.5 punto 3 non scritta, resta dietro IFileFetcher Dipende da H7
2026-10-13 Pagina «caricata» = readyState complete + almeno un evento paint; per riportare in vista un bersaglio fino a 24 raffiche L'input prima del primo disegno si perde; una persona risale
2026-10-13 Ripulitura: lettere finte solo consonanti; un valore finto non contiene mai un frammento dei grezzi; la verifica dice dove, mai che cosa; host dei collegamenti ridotto dalla sonda a sito/cdn/altro; interazioni lette da :hover e activeElement in sola lettura §14.5
2026-10-13 Prove con orologio compresso (fattore 10), governatore permissivo, un sito di prova per prova, un Chromium per classe Prove d'insieme sotto i 2 minuti
2026-10-13 Il Governatore espone anche la vista dei tetti per le ricette (IBudgetView); un solo ItalianText per i testi (in Febe.Core.Engine) Raccordo fra motore e ricette dopo l'unione dell'ondata 2
2026-10-13 Interfaccia incorporata come risorse wwwroot/… con un IFileProvider proprio nessun pacchetto in più, un solo file da distribuire
2026-10-13 Nomi JSON dell'API in inglese camelCase, testi per Alberto in italiano identificatori in inglese, interfaccia in italiano
2026-10-13 In modalità dimostrativa niente SSE, la pagina chiede il motore ogni 30 s le schermate senza finestra finiscono
2026-10-13 Gettone del desktop scambiato una volta con un cookie HttpOnly Strict e tolto dall'indirizzo non resta in cronologia né nei registri
2026-10-13 Blocco password per client e complessivo; il tentativo che raggiunge la soglia risponde già «bloccato» rallenta anche i tentativi da più indirizzi
2026-10-13 Esportazione CSV con ;, BOM e prefisso ' sui campi che iniziano con = + - @ Excel italiano, niente formule iniettate
2026-10-13 AccountPlanInput con GradualStartSince e Now il piano dell'account deve sapere se l'avvio graduale è ancora in corso
2026-10-13 Strumento per le schermate in tools/schermate (Node, nessun pacchetto) rifare le schermate di §10.7 anche nella parte 2
2026-10-13 Nessuna migrazione nuova: le scelte di un'importazione senza colonna (ipotesi Stogram, nuovi account) stanno in setting con chiavi importazione.{id}.*; le note dei file in import_file.last_error Evita conflitti di numerazione fra rami paralleli; lo schema 1 basta
2026-10-13 Nuovi valori ImportOutcome.IdenticalInSource e ImportDateSource.Journal Una copia identica nella sorgente non è «già in libreria»; la data del giornale di Febe è esatta
2026-10-13 Unità da associare: le cartelle di primo livello, oppure la cartella scelta se contiene solo cartelle di tipo/anni o solo file Una riga per account nella tabella del mockup 09 anche scegliendo direttamente un account
2026-10-13 Confronto: SHA in libreria (prima l'account di destinazione), SHA nella sorgente, identificativo/codice con posizione, impronta in libreria, poi identità e impronta nella sorgente; una coppia al massimo per file, verso il primo file del gruppo §9.3; niente catene di coppie
2026-10-13 «Stesso identificativo, file diverso» vale anche per i video; per i video si esclude solo l'impronta «Per i video vale solo lo SHA-256» riguarda le soglie dell'impronta
2026-10-13 Uno SHA o un identificativo di un elemento eliminato «ricordando la scelta» conta come «già in libreria», con nota Un'importazione non annulla un'eliminazione (§4.6)
2026-10-13 Associazione iniziale: account per identificativo poi per nome; altrimenti nuovo «Solo archivio» col nome della cartella se valido; altrimenti nessuno. Gli account nascono all'avvio della copia, con «Tieni aggiornato» spento Mockup 09; un'importazione abbandonata non lascia account vuoti
2026-10-13 File senza account o con doppione da decidere restano «analizzati» con la nota; la copia si rilancia sulla stessa importazione «Blocca solo i propri file» (§9.4)
2026-10-13 «Più grande» = più pixel, poi più byte; a parità vince la libreria. Sostituzione: nuovo file scritto e riletto (SHA-256), poi record e _febe.jsonl, poi eliminazione del vecchio file e della sua miniatura Regola 12
2026-10-13 Nella sorgente, fra file uniti da «tieni il più grande» si importa solo il più grande del gruppo Nessun effetto a catena
2026-10-13 «Sposta» elimina solo originali di file copiati in modalità Sposta, dopo aver riletto la copia dal disco; mai i file saltati §9.4
2026-10-13 Sola lettura riconosciuta senza scrivere nella sorgente: ro nei montaggi (Linux), dischi ottici (Windows), /importa in sola lettura per configurazione L'analisi non scrive nemmeno un file di prova
2026-10-13 Sorgenti rifiutate: dentro o sopra la cartella dei dati, sopra la libreria, dentro una cartella di account con _febe.jsonl Niente libreria importata in sé stessa
2026-10-13 Date: nome (o giornale di Febe), metadati (EXIF con fuso, mvhd, ffprobe solo in aggiunta), data di modifica; un nome con il solo giorno cede all'ora dei metadati dello stesso giorno; ore senza fuso = fuso di Alberto §9.2
2026-10-13 Il riconoscitore generico non estrae identificativi: i codici vengono solo dai nomi e dal giornale di Febe Regola 10
2026-10-13 Ipotesi 4K Stogram dietro un'opzione per importazione, spenta; ora del nome letta come locale; stogram.sqlite mai aperto (si guarda solo se esiste) §9.6: va riscritta sui dati veri
2026-10-13 MediaContent.FixedRelativePath ed ExpectedSha256; la copia usa un LibraryIngest senza indice e aggiorna da sé l'indice condiviso Stessa via degli scaricamenti; nessuna coppia «da scaricamento» per varianti già decise; un file cambiato dopo l'analisi non entra
2026-10-13 CSV con ;, UTF-8 con BOM, CRLF, date locali, durate con la virgola, apostrofo davanti a = + - @ Excel in italiano; nessuna formula da un nome di file
2026-10-13 Analisi a gruppi di 64 file, lettura in parallelo (fino a 4), confronto e salvataggio in ordine; foto fino a 64 MB lette una volta sola «Primo incontrato» stabile e un solo passaggio sul disco
2026-10-13 Un lavoro d'importazione alla volta; eventi «importazione-analizzata», «importazione-completata», «account-solo-archivio» Il disco è il collo di bottiglia; cronologia in Attività
2026-10-13 CapabilitiesDto riceve un nuovo campo posizionale finale Problems serve alla pagina di errore di configurazione; è un cambio di firma pubblica di un DTO: chi lo costruisce a mano deve passare il valore.
2026-10-13 POST /api/connection/begin non segna il browser come usato; lo segna finish «Riprendi» dopo una verifica deve accendersi solo quando Alberto ha finito nel browser, non appena lo apre.
2026-10-13 Ripieghi TryAdd per tutto ciò che non è di questo lavoro (collegamento, anteprima, invio Telegram, cambio cartella dati) interfaccia e prove funzionano già; la composizione sostituisce i pezzi senza toccare Febe.Web.
2026-10-13 ImportHub costruisce un ImportService sulla libreria se la composizione non ne registra uno; in Docker solo sotto FebeWebOptions.ImportRoot (/importa) Importa funziona subito in tutte e due le vesti, nei limiti di §9.1.
2026-10-13 In Limiti e comportamento gli orari sono campi di testo a 24 ore il selettore d'ora del browser mostra AM/PM secondo la lingua del sistema.
2026-10-13 Scartare un doppione dopo uno scaricamento avviene solo su scelta esplicita: il file scartato si ricorda e non si riscarica regola 11, la libreria non decide da sola.
2026-10-13 Cambiando la cartella della libreria (desktop), gli account con cartella già esistente restano fissati al vecchio percorso nessun file si sposta da solo; i nuovi account vanno nella cartella nuova.
2026-10-13 Il gettone Telegram non torna mai all'interfaccia (solo telegramTokenSet) e un campo vuoto lo lascia com'è §13.3 e regola 10.
2026-10-13 La ricostruzione del database chiede di scrivere «ricostruisci» ed è rifiutata durante un'importazione operazione pesante (§8.5).
2026-10-13 /salute non fatto qui appartiene al lavoro Server/Docker; evita due rotte uguali.
2026-10-13 Nella dimostrazione «In coda» è ordinata per orario come il mockup 06; il motore vero dà il suo ordine.
2026-10-13 ApiErrorMiddleware toglie « (Parameter 'x')» dai messaggi gli errori arrivano all'interfaccia in italiano pulito.
2026-10-13 «Fai una copia adesso» sostituisce la copia di oggi una copia al giorno, se ne tengono 7.
2026-10-13 Server reale come comando predefinito di febe; password solo da FEBE_PASSWORD, mai da riga di comando Le righe di comando sono leggibili da altri processi
2026-10-13 Problema di configurazione: solo interfaccia su un database temporaneo, gate API 503, nessun browser né motore, nulla scritto in /dati §8.2, §11: la vista remota mai raggiungibile senza password
2026-10-13 Senza password il middleware lascia passare solo pagina d'errore, file, capabilities, preferences, /salute Prima rispondeva 503 a tutto e la pagina d'errore non poteva comparire
2026-10-13 Profilo seccomp dedicato (predefinito di Docker + clone/unshare) in compose e nel modello Unraid; FEBE_SENZA_SANDBOX solo come compromesso esplicito S5 misurata: col profilo predefinito «No usable sandbox», col dedicato sandbox completa
2026-10-13 Il profilo seccomp si copia a ogni avvio in /dati/seccomp.json; Unraid lo chiede in ExtraParams, con il primo scaricamento indicato in Requires Docker legge il profilo alla creazione del contenitore
2026-10-13 Criteri di Chromium: oltre ai tre richiesti, anche PasswordLeakDetectionEnabled: false Nessun trattamento della password di Instagram dal browser
2026-10-13 HEALTHCHECK con febe --controllo-salute, niente curl Nessun pacchetto in più
2026-10-13 tini come processo 1; entrypoint minimo con setpriv; PUID=0 rifiutato §11: Febe.Server sorveglia Xvfb e Chromium, utente non root
2026-10-13 La porta di debug resta 9222 su 127.0.0.1; HOME di Chromium in /dati/home; variabili di proxy tolte all'ambiente del browser §6.1, regola 2
2026-10-13 Lock Singleton* del profilo e lock X orfani tolti prima di ogni avvio Dopo la ricreazione del contenitore il nome host cambia e Chromium rifiuterebbe il profilo con un dialogo invisibile
2026-10-13 «Scollega» riavvia sul posto lo stesso ChromiumProcessHost (RestartAsync) Sessione CDP, cattura e coda degli scaricamenti restano agganciate
2026-10-13 Vista remota: «indietro» con Page.navigate all'indirizzo precedente tenuto in memoria; una vista alla volta, la più recente vince Nessun comando di cronologia fra quelli ammessi
2026-10-13 FEBE_HOST facoltativa (più i nomi loopback); vuota significa qualunque nome; FEBE_PROXY_FIDATO per un proxy HTTPS Difesa in più contro il DNS rebinding senza rompere l'uso in LAN
2026-10-13 Registro: un file al giorno, 14 giorni, 20 MB al giorno, indirizzi tolti §8.2, §13.2
2026-10-13 Copia del database all'avvio e poi ogni giorno alle 3:20 locali Fuori dalla fascia di ogni profilo
2026-10-13 Modalità di sviluppo --sito-di-prova (solo indirizzi locali), --accesso-di-prova, --prima-sessione Composizione vera senza Instagram (regola 1)
2026-10-13 Prove d'insieme: orologio compresso 10× e fuso Etc/GMT±n dove è mezzogiorno Motore sempre in fascia, a qualunque ora giri la prova
2026-10-13 Il server reale registra EngineHostSettingsControl, un'anteprima vera del browser (Page.captureScreenshot al più ogni 4 s, niente sulla pagina vuota) e l'acquisizione della libreria, che riceve subito il nuovo schema dei nomi (LibraryIngest.Apply) Raccordo fra interfaccia parte 2 e composizione del server: i limiti arrivano al motore in esecuzione e lo schema vale per i prossimi file senza riavvio (§4.7)
2026-10-13 Composizione condivisa in src/Febe.App (FebeApp, IFebePlatform, IFebeBrowser); Febe.Server = DockerPlatform + FebeServer sottile con la stessa superficie; ServerLog→FebeLog, ServerConnectionService→BrowserConnectionService, BrowserSupervisor→ChromiumBrowser, ServerBrowserPreview→LiveBrowserPreview Un motore e una composizione per le due vesti (§5)
2026-10-13 Logica di Windows provabile su Linux in src/Febe.Desktop.Core (net10.0); in Febe.Desktop solo le chiamate a Windows Le prove girano su Linux
2026-10-13 Adattatore CDP di WebView2 (WebView2CdpSession) in Febe.Browser dietro IWebView2DevTools; eventi in ordine su un ciclo proprio, mai sul thread dell'interfaccia; degli errori del protocollo solo codice e messaggio Stesse regole del client Chromium; niente blocchi col thread di WPF
2026-10-13 WebView2Host ospita CoreWebView2Controller direttamente sull'HWND (pixel reali), non il controllo WPF IsVisible sempre vero; serve anche alla composizione
2026-10-13 S2: browser fuori dallo schermo, mai nascosto né ridotto a icona (ridurlo = fuori vista); --disable-features=CalculateNativeWinOcclusion --disable-backgrounding-occluded-windows §6.6; gli argomenti non cambiano ciò che il browser dichiara (UA, navigator, lingua, fuso, intestazioni)
2026-10-13 Modo di S2 con --browser finestra|composizione|edge, salvato in desktop.browser; Edge assente → finestra Prove di Alberto senza interfaccia apposita
2026-10-13 Edge: profilo Dati\browser\edge (Scollega cancella tutto Dati\browser), porta 9222 su 127.0.0.1, password e compilazione automatica spente dalle preferenze del profilo, nessun criterio nel registro Non toccare l'Edge di Alberto
2026-10-13 «Browser di Febe» senza pulsante nella barra delle applicazioni; un'attivazione mentre è fuori vista non conta come «Alberto guida» Windows attiva la finestra successiva quando un'altra si chiude: il motore si fermerebbe da solo
2026-10-13 Barra sotto la pagina con Indietro, Ricarica e indirizzo senza query (GoBack/Reload di WebView2, non CDP); nel browser di Febe nuove finestre aperte nella stessa, scaricamenti annullati, permessi negati Navigazione di Alberto, non del motore; la sessione resta nel profilo
2026-10-13 Interfaccia in un WebView2 con dati propri in Dati\interfaccia (in temp se la cartella dei dati ha un problema); ogni altro indirizzo va al browser predefinito; porta 0 con LoopbackHosts(0) §13.1
2026-10-13 Istanza unica per cartella dei dati: mutex Local\Febe-<16 hex SHA-256>, pipe CurrentUserOnly, messaggi FEBE1 mostra|nascosto Un secondo account con cartelle proprie resta possibile (§3)
2026-10-13 Cambio della cartella dei dati: registrato in HKCU\Software\Febe (CartellaDati, NuovaCartellaDati), applicato al prossimo avvio prima di aprire qualunque cosa; copia riletta con SHA-256, poi la vecchia si cancella; con un errore si resta sulla vecchia; nuova cartella vuota e locale; con --dati non disponibile La sessione non si copia né si lascia in giro (§13.2)
2026-10-13 Desktop: la libreria è l'impostazione libreria.cartella (predefinita Immagini\Febe); il cambio vale subito per i prossimi file (LibraryIngest.UseLayout); l'importazione la costruisce ImportHub «I nuovi file andranno in …»
2026-10-13 Avvisi: AlertDispatcher nella composizione condivisa, canali IAlertChannel dalle vesti (Windows: notifiche dell'icona; M8: Telegram); codice disco-quasi-pieno già mappato Un aggancio solo per le due vesti
2026-10-13 Notifiche di Windows con i balloon tip di NotifyIcon; avvio con il computer in HKCU…\Run «Febe» = "…\Febe.exe" --nascosto Nessun pacchetto in più
2026-10-13 Icona da BrandMark (SkiaSharp) e IcoWriter a mano: DIB a 32 bit fino a 128, PNG a 256; una prova la confronta col disegno Appendice C, elenco chiuso di §3
2026-10-13 Un solo Febe.exe: niente pdb, XML né config/ accanto (target FebeSingleFileOnly); WFO0003 soppresso (app WPF, DPI dal manifesto) §12
2026-10-13 Installatore NSIS per utente in %LOCALAPPDATA%\Programs\Febe senza scelta della cartella, collegamento sul desktop facoltativo (scelto di serie), HKCU Uninstall, WebView2 cercato con «pv» delle chiavi EdgeUpdate, rifiuto se Febe è aperto, /DVERSION obbligatorio, disinstallazione che non tocca dati né libreria e dice dove sono Domanda 6 di §16
2026-10-13 «Scollega» che non riesce a cancellare il profilo: browser e motore ripartono, la sessione si ricontrolla, 400 in italiano (entrambe le vesti) Il motore non deve restare fermo per un file bloccato
2026-10-13 M9 («collegati a un Febe già in funzione») non fatto Facoltativo, non banale
2026-10-13 AlertService ascolta la cronologia del motore (codici degli eventi), non lo stato dell'interruttore Una sola fonte per interfaccia e avvisi; i testi del motore portano già i fatti
2026-10-13 «Ricetta sospesa» è un avviso a sé, sotto l'interruttore «Formato non riconosciuto»; «avviso-non-inviato» è una riga, mai un avviso La sospensione è la conseguenza seria; niente catene di avvisi
2026-10-13 Intervalli minimi: verifica, disconnessione, fermo e ripresa 30 min; storico 24 h per account; formato e ricetta sospesa 6 h; disco 20 h per insieme di dischi. Orari salvati in avvisi.inviato.* Uno stato che va e viene non manda raffiche; un riavvio non ripete
2026-10-13 Disco quasi pieno: meno di 10 GB o meno del 5%, libreria e dati, controllo 1 min dopo l'avvio e poi ogni 15 min; riga in Attività quando cambia l'insieme e ogni 24 h; disco non misurabile = nessun avviso Soglie facili da spiegare; vale sia per un array grande sia per un SSD piccolo
2026-10-13 Telegram: JSON a mano, testo semplice fino a 3.500 caratteri, 15 s, forma del gettone controllata, nessun nuovo tentativo automatico §13.3, regola 10; l'avviso resta comunque nell'interfaccia
2026-10-13 Indirizzo di Telegram come stringa assoluta «bot123:ABC» relativo diventa uno schema
2026-10-13 NoTelegramSender (nuovo nome) come ripiego di Febe.Web; la composizione registra TelegramAlertChannel La dimostrazione e le prove non usano mai la rete
2026-10-13 Sezione «Avvisi» in Attività (GET /api/alerts, 14 giorni) Storico completato, disco e formato non avevano un posto visibile
2026-10-13 Ricette sospese in Attività con «Riattiva» Il motore diceva «si riattiva da Attività», ma non c'era modo
2026-10-13 «Esporta l'elenco» a sola icona; la riga degli strumenti va a capo sopra i 1000 px Nella riga del mockup non c'è spazio
2026-10-13 Guida in docs/guida, una pagina per file, collegamenti [Testo](Pagina), prova Febe.Tests.Docs Formato del wiki di Gitea
2026-10-13 Avvisi collegati una sola volta in FebeApp (composizione condivisa): AlertService di Febe.Core.Alerts con i canali notifica di sistema (INativeShell) e Telegram; tolto il gancio doppio AlertDispatcher del ramo desktop; AlertServiceOptions.FolderSource legge la cartella della libreria a ogni controllo del disco Un solo meccanismo per le due vesti; sul desktop la libreria può cambiare mentre Febe gira
2026-10-13 Flusso di rilascio .gitea/workflows/rilascio.yml a ogni tag: installatore e zip per Windows costruiti sul runner Linux, immagine Docker costruita e pubblicata sul registro di Gitea con il segreto REGISTRY_TOKEN (variabile facoltativa REGISTRY), release con allegati creata con il gettone automatico di Actions Stesso schema di Encelado e Mimante; senza segreto l'immagine si costruisce ma non si pubblica e il lavoro lo dice
2026-10-13 L'orologio virtuale decide se far scattare il prossimo timer o finire sotto lo stesso lock, ricontrollando quanti attori aspettano Un timer annullato da un thread del pool chiudeva la corsa in anticipo (simulazione troncata, prova del rallentamento instabile)
2026-10-13 Con la guida di Alberto e nessuna sessione, le regole di percorso (navigazione, documento) non sono segnali; stato HTTP, testo e controllo del cookie restano Regola 7: accesso e verifiche aperti da lui non sono «la pagina torna all'accesso» (§7.6)
2026-10-13 Cookie di sessione sparito fuori sessione e senza Alberto al browser = segnale di disconnessione all'interruttore; all'avvio solo se esiste collegamento.primo; mai dopo «Scollega» (impostazione collegamento.scollegato, tolta al collegamento successivo) §7.6 e §13.3: incidente, avviso e ripresa solo con «Riprendi»
2026-10-13 La lease di «Accedi a Instagram»/«Usa il browser» finisce da sola dopo 2 minuti in cui è l'unica del browser (vista remota chiusa, finestra fuori vista); «Ho finito»/«Annulla» tardivi non toccano la pagina se nessuno guida Il motore non resta fermo per sempre se Alberto se ne va senza i pulsanti
2026-10-13 Quando la guida finisce e nessuna sessione è in corso, il motore porta la pagina a riposo (non dopo verifica o disconnessione) §6.1; un visualizzatore lasciato aperto avanzerebbe da solo su altri account (§6.3)
2026-10-13 Vista remota: ping ogni 20 s, risposta entro 30 s Una pagina sparita teneva la lease fino al timeout TCP
2026-10-13 Vista remota: aperture serializzate; un avvio fallito chiude sempre la vista «La più recente vince» anche con due aperture nello stesso momento
2026-10-13 La sincronizzazione della coda attende l'avvio e la contabilità di una ricetta; il compito in corso conta come presente Evita un controllo duplicato con la vecchia scadenza
2026-10-13 Raccolte in evidenza: un compito per raccolta (identificativo Instagram), subito se mai vista, poi ogni 8 intervalli delle storie fra 1 e 7 giorni; una raccolta per account e sessione, mai su un profilo già aperto nella sessione §4.2/§6.3: «evidenza» è attiva di serie e non veniva mai raccolta
2026-10-13 La scheda Reel non si programma da sola nella versione 1 (la ricetta resta) §4.3: è solo una seconda fonte, i reel della griglia arrivano già con Controllo e Storico; H6 è da provare; ogni visita costerebbe un profilo aperto in più
2026-10-13 Un 429 (o altra regola di stato) del CDN durante uno scaricamento si segnala con SignalDetector.ObserveDownload; la coda si ferma 1 ora senza contare tentativi; nell'incidente solo schema e host loadNetworkResource non passa dagli eventi della pagina; il percorso del CDN identifica il file (§13.2)
2026-10-13 Attese crescenti fra i tentativi (5 min, 30 min, 2 h, 8 h) tenute in memoria; errori di connessione non contati, pausa di 5 min Nessuna migrazione (come decisione 94); un riavvio concede al più un tentativo anticipato
2026-10-13 attempts conta ogni fallimento, scadenze comprese, e non si azzera con un nuovo indirizzo; un file fallito si rianima da una nuova lettura fino a 10 fallimenti Il ciclo scaduto → «Post singolo» resta limitato; un file rotto non costa uno scaricamento a ogni controllo
2026-10-13 Senza pagina di ripresa lo storico e l'elenco dei seguiti tornano al punto salvato scorrendo (cursore o ultimo elemento in …segno); le pagine scorse si salvano e chiedono il permesso ma non contano nelle pagine della corsa Decisione 76; mai una ripartenza silenziosa
2026-10-13 Il controllo del profilo legge tutta la prima pagina; se finisce con un post nuovo, scende al massimo GapPagesPerCheck (3) pagine fino ai post noti, punto salvato in raccolta.lacuna.{id}.* Post mancanti dopo una lunga assenza (check-1)
2026-10-13 content.owner è un concetto necessario del vocabolario; senza la chiave pinned un post seguito da uno più recente sulla stessa pagina conta come fissato vocab-1
2026-10-13 La posizione di un file di una serie è il posto dichiarato; il confronto avviene per identificativo, poi per posizione reader-1
2026-10-13 Un lucchetto per cartella di account in LibraryIngest, dal controllo «identico» al registro del file dedup-1
2026-10-13 I file temporanei di questo processo sono prenotati e la pulizia d'avvio non li tocca tmp-1, senza modificare FebeApp
2026-10-13 «Tieni il più grande» verso un file della libreria: quel file e tutti i file della sorgente accoppiati a lui sono un gruppo; resta solo il più grande, gli altri si saltano con nota; al momento della copia si riconfronta con il file in libreria in quel momento Regola 12 e §9.3: due sostituzioni in fila cancellavano la prima copia (con «Sposta» l'originale più grande era perso)
2026-10-13 Un file della sorgente con lo stesso SHA-256 del file in libreria è una sostituzione interrotta: la copia la conclude Prima risultava «saltato, in libreria c'è il più grande»
2026-10-13 Righe di _febe.jsonl non scritte: il file resta registrato, l'elemento va in setting libreria.giornale-da-scrivere e la riga si scrive alla passata successiva della coda e all'inizio e alla fine di ogni copia; evento «giornale-in-sospeso» quando l'elenco si riempie §8.5; un errore del giornale dopo il salvataggio non vuol dire «niente scritto»; nessuna migrazione nuova
2026-10-13 La coda scrive la riga di un elemento dopo ogni esito finale di un suo file, quando nessun file aspetta più e almeno uno è in libreria §8.5 «una riga per ogni elemento salvato»
2026-10-13 Ricostruzione: chiave = id, poi codice, poi primo file; l'ultima riga save è l'elenco completo dei file e una posizione che non compare più torna «eliminata» Una sostituzione non divide l'elemento in due; le scelte di Alberto sono rispettate
2026-10-13 Sostituzione di un elemento senza id né codice: dopo la nuova riga save, una riga delete non ricordata col vecchio percorso La ricostruzione non fa rinascere l'elemento col file vecchio
2026-10-13 Ricostruzione: un elemento senza id né codice con tutti i file mancanti non si ripristina (contato fra i mancanti, con nota); un'eliminazione ricordata senza id si riconosce dallo SHA-256 Idempotenza; un record fantasma intercetterebbe uno scaricamento per data di pubblicazione (§9.5)
2026-10-13 Ricostruzione: un file presente ma illeggibile si ripristina come presente con i dati del giornale, senza verifica (contatore FilesUnreadable e nota); un _febe.jsonl illeggibile salta solo la sua cartella §8.5 «senza riscaricare nulla»: il verificatore proponeva «fallito», ma così il percorso si perde e «Post singolo» riscaricherebbe il file come «nome (2)»
2026-10-13 Copie del database: un turno per cartella fra copia giornaliera, «Fai una copia adesso» e conservazione; si eliminano solo i .part fermi da 6 ore; un file che non si elimina resta per la volta dopo Due copie insieme si cancellavano a vicenda il file temporaneo
2026-10-13 Mp4Reader: dimensioni dei box confrontate con lo spazio rimasto (mai offset + size), al più 10.000 box figli Un file danneggiato bloccava l'analisi fino all'esaurimento della memoria
2026-10-13 Uno spostamento della cartella dei dati prende la guardia d'istanza della cartella nuova prima di scriverci e di registrarla; se la tiene un altro Febe lo spostamento non avviene; mutex non posseduto Dopo lo spostamento ogni avvio legge la cartella nuova: deve trovare questo Febe (pkg-1, §12)
2026-10-13 febe.lock nella cartella dei dati, aperto senza condivisione per tutta la vita del processo (desktop) Due grafie della stessa cartella (nome corto, subst, giunzioni) darebbero due mutex
2026-10-13 Avvio con il computer per cartella dei dati: valore Febe per quello consueto, Febe-<identità> con --dati per gli altri; la disinstallazione toglie anche questi Il secondo account partiva come il primo e ne toglieva l'avvio (pkg-5)
2026-10-13 Edge avviato da Febe in un job object con chiusura alla fine del job (ChromiumLaunchOptions.ProcessStarted, IDesktopShell.EndWithFebe) Un Edge rimasto dopo un arresto teneva la porta 9222 per sempre (pkg-6)
2026-10-13 Il profilo seccomp non si copia più in /dati: sul server sta fuori dal volume dei dati (Unraid /mnt/user/appdata/febe-seccomp.json, estratto dall'immagine); da root nell'avvio solo chown -R senza seguire i collegamenti, /dati/home la crea l'utente Sostituisce la riga del 13/10 sulla copia a ogni avvio: in /dati l'utente del contenitore poteva allentare il filtro o far seguire collegamenti a root (pkg-2)
2026-10-13 Rilascio: lavoro prove prima di tutto; la release dipende da prove, installatore e immagine; senza REGISTRY_TOKEN esce lo stesso e le note dicono che l'immagine non è pubblicata; un errore di costruzione o di pubblicazione ferma la release Mai un installatore da codice non provato (pkg-3); la mancanza del segreto non deve bloccare Windows
2026-10-13 Registro dell'immagine 192.168.30.23:3000 (HTTP): pubblicazione con buildx (builder docker-container, http/insecure nella configurazione di buildkit), credenziali nella configurazione del client invece di docker login; Unraid deve averlo fra gli insecure-registries Convenzione delle altre immagini di casa; il demone del runner potrebbe non fidarsi del registro
2026-10-13 Compose rilasciato come febe-compose-X.Y.Z.tar.gz con chromium/seccomp.json Il percorso relativo del profilo resta valido (pkg-4)
2026-10-13 torna della pagina di accesso: solo un percorso che inizia con una sola /, senza backslash, spazi o caratteri di controllo, verificato sul server (LoginReturn) e nella pagina, che va all'indirizzo assoluto dello stesso sito Reindirizzamento aperto con /\host (websec-2, web-8)
2026-10-13 Cookie Secure anche quando il proxy fidato (FEBE_PROXY_FIDATO) dice X-Forwarded-Proto: https Dietro il proxy con HTTPS il cookie non era mai Secure (websec-3)
2026-10-13 Lasciare la pagina Browser, o Collegamento durante l'accesso, senza «Ho finito»/«Annulla» vale come «Annulla»: l'interfaccia manda POST /api/connection/cancel uscendo e su pagehide; il begin seguente aspetta quella richiesta Il permesso preso da begin non scade; cancel esiste già e rimette il browser sulla pagina vuota (§6.1); nessun endpoint nuovo né cambio di IConnectionService
2026-10-13 fetch con keepalive invece di navigator.sendBeacon Con Referrer-Policy: no-referrer un beacon (no-cors) parte con Origin: null e il controllo di §13.1 lo rifiuta
2026-10-13 Su Windows «Usa il browser» del pannello «collegato» non si restituisce uscendo dalla pagina La finestra del browser è a parte e Alberto può usarla mentre guarda altre pagine; va legata alla finestra dal lato server
2026-10-13 Dopo «Ho finito» riuscito durante una verifica: pannello «Hai finito con il browser» con «Riapri il browser», senza vista né nuovo begin; aggiornamento dopo «Riprendi» solo se la striscia rossa era stata vista La vista aperta tiene fermo il motore; mai riprendere il browser da soli
2026-10-13 Vista remota: AltGr (Option su Mac) con un carattere → messaggio char senza Ctrl/Alt; Alt da solo su Windows/Linux resta scorciatoia; cattura del puntatore e rilascio dei pulsanti alla perdita della cattura o del fuoco «@ # [ ] €» sulla tastiera italiana; un pulsante restava premuto sul server
2026-10-13 Orari futuri dei fermi per rallentamento sempre «verso le»; ItalianText.AtDay resta ma non è più usato §10.4 senza eccezioni; striscia e riquadro di stato davano lo stesso orario in due modi
2026-10-13 AccountSettingsMapper.ToDto(account, zone): «Da una data» come giorno locale Il giorno UTC dell'inizio del giorno locale era un giorno prima in Europe/Rome e ogni salvataggio lo spostava indietro
2026-10-13 PageFrame: dopo l'uscita onEngine/onLibrary non si iscrivono e onLeave esegue subito Nulla registrato in ritardo sopravvive alla pagina
2026-10-13 Riquadro di stato senza nome dell'account: avatar segnaposto, stato del collegamento e «Nome non ancora noto» Niente «@null» prima del primo giro
2026-10-13 Prove dell'interfaccia in un Chromium senza finestra guidato col protocollo DevTools diretto (UiBrowser, solo 127.0.0.1), inconcludenti senza Chromium Come tools/schermate; il client CDP di Febe accetta solo letture
2026-10-14 Revisione avversaria di tutto il codice (7 aree, ogni rilievo verificato da un secondo revisore indipendente): 54 rilievi confermati e corretti con prove di regressione, 2 smentiti, 3 incerti corretti dove il rimedio era sicuro §14, regola 14: resoconti onesti
2026-10-14 Restano noti e accettati: «Tieni il più grande» scrive con il proprio SafeFileWriter e non passa dal lucchetto per account di LibraryIngest (un'importazione e uno scaricamento con gli stessi byte nello stesso istante potrebbero entrare entrambi); le prove d'interfaccia con browser vero aspettano fino a 30 s Finestra rarissima, nessuna perdita di dati: al più un doppione esatto da togliere a mano
2026-10-20 Il seme del mondo sintetico del sito di prova si sceglie con la variabile FEBE_SEME_PROVA (13 se manca), letta da SyntheticSite (tests/Febe.Tests/Support), l'unico modo in cui le prove avviano il sito; le classi che lo avviano stanno nella categoria SitoDiProva, e una prova controlla che nessuna lo avvii per altre vie o resti fuori dalla categoria. SyntheticSiteSeedTests controlla senza browser, per 300 semi, la forma del mondo su cui contano le prove d'insieme e i lettori sulle pagine servite La CI rifà quelle prove con un seme diverso a ogni esecuzione, scritto nel registro, senza raddoppiare la durata di tutta la suite; senza la variabile non cambia nulla; un errore si rifà con lo stesso seme
2026-10-20 Dockerfile: i file che il restore legge (soluzione, Directory.*.props, progetti) si trovano da soli in uno stadio progetti invece che da un elenco scritto a mano; lo stadio finale applica gli aggiornamenti della distribuzione (apt-get upgrade) prima di installare i pacchetti Un progetto nuovo in Febe.slnx (come tests/Febe.Tests.Windows) non rompe più la costruzione dell'immagine e il restore resta in cache (BuildKit confronta il contenuto copiato); la scansione Trivy della CI non deve trovare correzioni di Debian già pubblicate ma non applicate perché l'immagine di base è più vecchia
2026-10-20 Codice comune della CI in script di .gitea/scripts/ (lanciati con bash), non in azioni composite locali Uno script si prova con bash -n nel lavoro «controlli» e si lancia anche a mano; le azioni composite di act hanno comportamenti propri (ambiente, if, passi finali) che qui non si possono provare prima della prima esecuzione vera
2026-10-20 Strumenti esterni della CI: solo gitleaks 8.30.1 e Trivy 0.75.0 (approvati da Alberto il 20 ottobre, solo nella CI), scaricati dalle release come binari e installati solo se l'impronta SHA-256 scritta in strumento.sh coincide (verificata sull'archivio, sul file *_checksums.txt e sull'impronta mostrata da GitHub); nessuna azione di terzi per eseguirli trivy-action e setup-trivy furono compromesse a marzo 2026 (CVE-2026-33634, Trivy 0.69.4–0.69.6): un'etichetta si sposta, un'impronta no. Trivy 0.75.0 e non 0.76.0: almeno due settimane di vita prima di entrare nella CI
2026-10-20 gitleaks su tutta la storia (fetch-depth: 0, tutti i rami e i tag) con --redact; nessun .gitleaks.toml né elenco di eccezioni per ora: un'approssimazione locale delle 221 regole predefinite (le espressioni regolari pubblicate, applicate da uno script nostro: gitleaks non gira fuori dalla CI) non ha trovato rilievi veri, e i gettoni finti delle prove non hanno la forma completa che le regole cercano Un falso allarme futuro si toglie con la sua impronta in .gitleaksignore e un commento accanto, mai disattivando una regola; un segreto vero si revoca prima di tutto (docs/processo.md)
2026-10-20 Trivy sull'archivio dell'immagine provata (non dal demone): una vulnerabilità CRITICAL con correzione disponibile ferma il lavoro, le HIGH (e le CRITICAL senza correzione) si riportano nel registro e in trivy.json (artefatto di 14 giorni); eccezioni solo in .trivyignore, con motivo scritto e scadenza exp: La regola chiesta da Alberto; scansionare l'archivio vuol dire scansionare proprio l'immagine provata, senza dipendere dal socket del demone
2026-10-20 La prova del contenitore (prova-immagine.sh) gira sempre con --network none: Chromium, criteri, lingua, poi l'avvio come da guida (profilo seccomp, password casuale passata solo nell'ambiente del client) fino a «healthy», febe --controllo-salute e l'arresto entro 30 secondi Regola 1: un'immagine appena costruita non deve poter raggiungere Instagram nemmeno per sbaglio; il controllo di salute passa dalla rete interna del contenitore
2026-10-20 Ciò che la CI crea sul demone porta i suoi segni: etichette febe.ci.workflow, febe.ci.run, febe.ci.ref, febe.ci.commit sull'immagine e sui contenitori di prova, nome locale febe-ci:<esecuzione>, builder febe-ci-<esecuzione>. pulizia-docker.sh toglie solo quello (più le immagini senza nome oltre 72 ore): alla fine di ogni lavoro, all'inizio del lavoro successivo per i resti più vecchi di 90 minuti, e ogni settimana. Mai system prune, builder prune, volume prune Il demone è lo stesso di Encelado, Mimante e degli altri progetti: la loro cache e le loro immagini non si toccano; un'esecuzione annullata non può pulire da sé, e un lavoro dura al massimo 60 minuti, quindi un resto di 90 minuti è certamente orfano
2026-10-20 verifica a ogni push su qualunque ramo (branches: ["**"], quindi mai sui tag) e a mano (workflow_dispatch, con un seme facoltativo); niente pull_request In Gitea i controlli di una richiesta di unione sono gli stati del suo ultimo commit, che il push del ramo ha già verificato; pull_request girerebbe sullo stesso commit (refs/pull/N/head, non un'unione di prova) e sull'unico runner raddoppierebbe tutto. Niente richieste da fork: un solo autore, rami nello stesso repository
2026-10-20 Concorrenza di verifica: su un ramo l'esecuzione nuova annulla quella in corso; su main ogni commit ha il suo gruppo e nessuna si annulla; :main si sposta solo se main è ancora a quel commit Il runner fa un lavoro alla volta; ogni unione in main deve arrivare a pubblicare la sua :sha-, e un'esecuzione in ritardo non deve riportare indietro :main. Gitea 28 valuta le espressioni di concurrency.group e cancel-in-progress (services/actions/concurrency.go)
2026-10-20 Lavoro «prove» nel contenitore node:24-trixie (Debian 13 con Node 24), con Chromium, Xvfb, ffmpeg, NSIS e la lingua italiana installati a ogni esecuzione; il riepilogo non ammette prove saltate; seconda passata della categoria SitoDiProva con il seme 1000 + numero dell'esecuzione, o quello chiesto a mano Su Ubuntu Chromium è uno snap; le azioni JavaScript girano dentro il contenitore del lavoro e vogliono Node; un'immagine di CI costruita da noi non può fare da contenitore del lavoro, perché act_runner la scaricherebbe da un registro e quello di casa è in HTTP; nella CI una prova saltata vuol dire un ambiente rotto, non una prova superata
2026-10-20 Installatore di ogni esecuzione con versione <Version>-ci.<numero> e immagine con etichetta org.opencontainers.image.version uguale; dopo ogni unione in main l'immagine va sul registro come :main e :sha-<7 caratteri>, mai :latest, che resta del rilascio Decisione di Alberto del 20 ottobre; la versione di prova non si confonde con una versione rilasciata e installer/costruisci.sh la accetta già
2026-10-20 Artefatti con actions/upload-artifact@v3 e retention-days: 14 (risultati delle prove, installatore e zip, rapporti di sicurezza) La v4 rifiuta di girare dove il server non è github.com (prende Gitea per GHES) e la sua copia per Gitea sarebbe un'azione nuova, non approvata; il backend v3 di Gitea 28 rispetta retentionDays (routers/api/actions/artifacts.go)
2026-10-20 permissions: contents: read in verifica e pulizia; i riepiloghi delle prove e di Trivy vanno nel registro e anche in GITHUB_STEP_SUMMARY Gitea 28 applica permissions al gettone del lavoro (docs.gitea.com, «Actions job token permissions»), che così non può scrivere nel repository; i riepiloghi dei lavori esistono da Gitea 1.27 ma compaiono solo se il runner li carica, quindi il registro resta la fonte
2026-10-20 Ciò che la CI usa di Gitea 28 e di act_runner: concurrency con espressioni, timeout-minutes dei lavori (lo applica il runner), workflow_dispatch con inputs, schedule, defaults.run.shell, container del lavoro, contesti gitea.*, vars e secrets; gli stati dei commit si chiamano «verifica / (push)» (modules/actions/workflows.go) e solo push, pull_request e release ne creano Controllato sul codice di Gitea release/v28 e su docs.gitea.com il 20 ottobre 2026; ciò che solo la prima esecuzione vera può provare è in docs/processo.md