Files
Febe/docs/decisioni.md
T
Alby96andClaude Opus 5.5 6e95aef5cc Documenti: processo, CI ed etichette dell'immagine
docs/processo.md descrive il percorso di una modifica come in un'azienda: rami,
commit, richieste di unione, controlli richiesti e protezione di main da
configurare su Gitea, che cosa garantisce ciascun lavoro della CI, etichette del
registro (:main, :sha-, :X.Y.Z, :latest), pulizia, rilievi di sicurezza,
rilasci e correzioni urgenti, e che cosa solo la prima esecuzione vera può
provare. CLAUDE.md e la guida per lo sviluppo dicevano che la verifica girava a
ogni push, e non era vero: ora descrivono la CI com'è. docs/docker.md dice quali
etichette ha l'immagine e come risalire all'esecuzione che l'ha costruita.

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

55 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
2026-10-20 Processo in docs/processo.md: rami <tipo>/<argomento> da main, commit piccoli in italiano, una richiesta di unione per ramo con il modello di .gitea/ (comprese le 14 regole di §2), unione con commit di unione e ramo cancellato; main protetto con i quattro lavori di verifica come controlli richiesti e «blocca se indietro»; tag v* protetti; Alberto proprietario di tutto (CODEOWNERS) Decisione di Alberto del 20 ottobre (processo da grande azienda); con il ramo aggiornato il commit di unione ha lo stesso contenuto del commit verificato, quindi in main entra solo codice provato. Le approvazioni richieste dipendono da chi apre le richieste (Gitea non conta quella dell'autore): domanda aperta per Alberto