Files
Febe/docs/decisioni.md
T
Alby96andClaude Opus 5.5 010ba794be Rilascio: l'immagine si pubblica solo dopo l'installatore
Come nella verifica, il lavoro «immagine» del rilascio aspetta anche «windows»: con l'installatore rosso la release
non esce, e allora non devono uscire nemmeno :X.Y.Z e :latest. Sull'unico runner i lavori vanno comunque uno alla
volta, quindi la durata non cambia.

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

247 lines
56 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.<Tipo>», «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 del commit verificato (`fetch-depth: 0`, ogni commit da cui discende; ogni ramo si controlla al suo push, così il rilievo di un ramo non blocca gli altri) 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 | Le etichette `febe.ci.workflow`, `febe.ci.run`, `febe.ci.ref`, `febe.ci.commit` dell'immagine dicono solo da dove viene; `pulizia-docker.sh` sceglie che cosa togliere da segni che nessuna immagine porta: contenitori di prova con l'etichetta `febe.ci.prova=<esecuzione>` (messa solo da `docker run --label` in `prova-immagine.sh`) e il nome esatto `febe-prova-<esecuzione>`; immagini solo per il nome locale `febe-ci:<esecuzione>`, mai per identificativo né con `-f`; builder per nome esatto e immagine `moby/buildkit`. Alla fine di ogni lavoro tutto ciò dell'esecuzione; all'inizio del lavoro successivo e ogni settimana i resti più vecchi di 90 minuti, ma dei contenitori di prova solo quelli fermi (uno acceso si segnala); più le immagini senza nome oltre 72 ore. Mai `system prune`, `builder prune`, `volume prune`. `PipelineTests` fa girare la pulizia contro un client Docker finto con un Febe vero acceso e uno fermo | Docker copia le etichette dell'immagine in ogni contenitore: un Febe vero avviato da `:main`, `:X.Y.Z` o `:latest` sullo stesso demone porta `febe.ci.run`, e un rilascio rilanciato ha lo stesso numero di esecuzione dell'immagine pubblicata (rilievo bloccante della revisione). Il demone è lo stesso di Encelado, Mimante e degli altri progetti; un lavoro dura al massimo 60 minuti, quindi un resto di 90 minuti è orfano; i builder sono sempre accesi e la loro cache se ne va solo con il contenitore |
| 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`: il gruppo comprende l'evento e il ramo; su un ramo l'esecuzione nuova annulla quella in corso dello stesso evento; su main ogni commit ha il suo gruppo e nessuna si annulla; `:main` si sposta solo se main è ancora a quel commit, e se la cima di main non si legge si pubblica solo `:sha-` con un avviso | 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`. Con l'evento nel gruppo un'esecuzione a mano non annulla quella del push: in Gitea un lavoro annullato lascia lo stato «failure» e `workflow_dispatch` non scrive stati, quindi la richiesta di unione resterebbe bloccata. 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 / <lavoro> (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 |
| 2026-10-20 | Nella verifica il lavoro «immagine» viene dopo «prove» e «installatore» (`needs: [prove, installatore]`) | `:main` e `:sha-` devono uscire solo da un commit con tutta la verifica verde, come dice `docs/docker.md`; sull'unico runner i lavori vanno comunque uno alla volta, quindi la durata non cambia. Su un ramo, se l'installatore fallisce l'immagine si salta: la richiesta di unione è già bloccata dall'installatore |
| 2026-10-20 | Anche nel rilascio il lavoro «immagine» viene dopo «prove» e «windows» (`needs: [prove, windows]`) | Come nella verifica: `:X.Y.Z` e `:latest` si pubblicano solo se anche la release potrà uscire; prima, con l'installatore rosso, l'immagine usciva senza release |