Segnalazione #8. Le prove dell'interfaccia non si affidano più a pause a tempo fisso: aspettano gli eventi. La prova che
falliva su un host lento ora è stabile, e lo sono anche le altre attese dello stesso tipo trovate controllando tutte le
prove d'interfaccia.
Causa (accertata)
APageLeftWhileLoadingLeavesNothingBehind apriva Attività e tornava alla Libreria dopo 200 ms fissi, poi aspettava
la risposta ritardata di /api/alerts. Su un host lento il modulo di Attività non aveva ancora chiesto /api/alerts entro
200 ms: la richiesta non partiva mai e l'attesa scadeva. Riprodotto su main con una latenza simulata di 150 ms (4 su 4)
e con Chrome rallentato 20 volte (2 su 4). Il prodotto non c'entra.
Che cosa cambia
UiBrowser: le risposte si possono trattenere (__hold) e rilasciare (__release). La prova aspetta che la richiesta
sia partita, lascia la pagina e solo allora la rilascia. C'è anche WaitForQuietAsync, «pagina quieta», con il
commento che dice esattamente che cosa garantisce.
La prova di Attività lasciata mentre carica controlla anche che la pagina lasciata non resti in ascolto della
libreria e non mostri avvisi sulla pagina successiva. Prima quel controllo non poteva fallire.
Le altre attese dello stesso tipo, nelle prove del collegamento, della vista remota (i tasti partono a socket aperto),
dei ridisegni rimandati e del trascinamento: ora tutte basate su eventi.
Nulla nel prodotto. Righe in docs/decisioni.md e in CHANGELOG.md (0.1.2 in preparazione).
Come è stato provato
dotnet test tests/Febe.Tests (Windows) → 781: 705 superate, 0 fallite, 76 saltate (Chromium)
InterfaceTests con Chrome 155, ripetute → 0 fallimenti: 1x 209 esiti, 4x 38, 20x 31, latenza 150 ms 31
copie dell'interfaccia rotte apposta → ognuna trovata dal controllo previsto, anche a 20x
La revisione avversaria ha riprodotto la causa in modo indipendente e ha trovato tre rilievi minori, corretti.
Da tenere d'occhio: un solo timeout di OpenAsync in migliaia di esecuzioni, all'apertura di /browser, senza causa
trovata. Se ricompare, va fatto dire a OpenAsync quale condizione mancava.
Rischi e ritorno indietro
Solo prove. Ritorno indietro: git revert -m 1 <commit di unione>.
Controlli prima di unire
1–13. Nessun cambiamento al prodotto né alle dipendenze; niente che abiliti UiBrowser su Windows è stato
committato
## Sintesi
Segnalazione #8. Le prove dell'interfaccia non si affidano più a pause a tempo fisso: aspettano gli eventi. La prova che
falliva su un host lento ora è stabile, e lo sono anche le altre attese dello stesso tipo trovate controllando tutte le
prove d'interfaccia.
## Causa (accertata)
`APageLeftWhileLoadingLeavesNothingBehind` apriva Attività e tornava alla Libreria **dopo 200 ms fissi**, poi aspettava
la risposta ritardata di `/api/alerts`. Su un host lento il modulo di Attività non aveva ancora chiesto `/api/alerts` entro
200 ms: la richiesta non partiva mai e l'attesa scadeva. Riprodotto su `main` con una latenza simulata di 150 ms (4 su 4)
e con Chrome rallentato 20 volte (2 su 4). Il prodotto non c'entra.
## Che cosa cambia
- `UiBrowser`: le risposte si possono trattenere (`__hold`) e rilasciare (`__release`). La prova aspetta che la richiesta
sia partita, lascia la pagina e solo allora la rilascia. C'è anche `WaitForQuietAsync`, «pagina quieta», con il
commento che dice esattamente che cosa garantisce.
- La prova di Attività lasciata mentre carica controlla anche che la pagina lasciata non resti in ascolto della
libreria e non mostri avvisi sulla pagina successiva. Prima quel controllo non poteva fallire.
- Le altre attese dello stesso tipo, nelle prove del collegamento, della vista remota (i tasti partono a socket aperto),
dei ridisegni rimandati e del trascinamento: ora tutte basate su eventi.
- Nulla nel prodotto. Righe in `docs/decisioni.md` e in `CHANGELOG.md` (0.1.2 in preparazione).
## Come è stato provato
```text
dotnet test tests/Febe.Tests (Windows) → 781: 705 superate, 0 fallite, 76 saltate (Chromium)
InterfaceTests con Chrome 155, ripetute → 0 fallimenti: 1x 209 esiti, 4x 38, 20x 31, latenza 150 ms 31
copie dell'interfaccia rotte apposta → ognuna trovata dal controllo previsto, anche a 20x
```
La revisione avversaria ha riprodotto la causa in modo indipendente e ha trovato tre rilievi minori, corretti.
Da tenere d'occhio: un solo timeout di `OpenAsync` in migliaia di esecuzioni, all'apertura di `/browser`, senza causa
trovata. Se ricompare, va fatto dire a `OpenAsync` quale condizione mancava.
## Rischi e ritorno indietro
- Solo prove. Ritorno indietro: `git revert -m 1 <commit di unione>`.
## Controlli prima di unire
- [x] 1–13. Nessun cambiamento al prodotto né alle dipendenze; niente che abiliti `UiBrowser` su Windows è stato
committato
- [x] 14. Ciò che non è stato provato è scritto sopra
- [ ] La verifica è verde sull'ultimo commit
Chiude #8.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
APageLeftWhileLoadingLeavesNothingBehind apriva Attività e tornava alla
Libreria con un setTimeout di 200 ms, poi aspettava la risposta in
ritardo di /api/alerts. Su una macchina lenta, a 200 ms Attività non
aveva ancora caricato activity.js e day-strip.js: la pagina veniva
lasciata prima di montarsi, /api/alerts non partiva mai e l'attesa
scadeva dopo 30 s, come nell'esecuzione 22 della CI. Con Chrome
rallentato 20 volte (Emulation.setCPUThrottlingRate, solo in locale)
fallisce 3 volte su 3 con lo stesso messaggio e la stessa riga, e in 4
giri su 5 i due moduli arrivano dopo il ritorno alla Libreria (fra 212 e
549 ms). ABrowserPageLeftWhileLoadingNeverTakesTheBrowser aveva la
stessa finestra, di 150 ms, e a 20x falliva anche lei. Il prodotto non
c'entra.
UiBrowser.Requests prende il posto di FetchDelays: trattiene le
richieste scelte finché la prova non le rilascia, conta quelle partite e
quelle finite (dopo la continuazione della pagina e, se lo legge, dopo
il corpo della risposta) e registra ogni richiesta della pagina. Le due
prove aspettano che la pagina abbia chiesto la risposta, la lasciano, la
rilasciano e controllano quando la pagina ne ha finito: nessun timer
rimasto, niente di Attività sulla Libreria, nessun browser preso né
vista aperta. Allo stesso modo la risposta vecchia della Libreria e le
tessere in ritardo di «In evidenza» arrivano sempre dopo il disegno
nuovo, invece che dopo 600 o 700 ms.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Quattro prove delle pagine Browser e Collegamento aspettavano 300 o
500 ms prima di controllare che il browser non fosse preso o restituito
un'altra volta: dopo «Ho finito», dopo «Riprendi», lasciando la pagina.
Su una macchina lenta il comando sbagliato poteva arrivare al server
dopo il controllo, e la prova passava lo stesso. Dopo «Riprendi» la
vista chiusa sul server si controllava dopo 300 ms: lì una macchina
lenta faceva fallire la prova.
Ora controllano quando la pagina è quieta (WaitForQuietAsync: ogni
richiesta partita ha avuto risposta e la pagina l'ha usata, anche se ne
ha fatta partire un'altra), sull'elenco delle richieste della pagina e
su quelle viste dal server; la vista chiusa si aspetta. Con copie
dell'interfaccia rotte apposta (un «cancel» dopo «Ho finito» nelle due
pagine, un «begin» dopo «Riprendi», un «begin» che parte solo dopo una
risposta del motore) le quattro prove falliscono in ogni giro provato,
anche con Chrome rallentato 20 volte.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AltGrCharactersReachTheRemotePageAsText mandava i tasti 300 ms dopo che
il server aveva aperto la vista. Il server la apre prima di rispondere
al WebSocket e la pagina scarta i messaggi finché il socket non è
aperto: su una macchina più lenta di così i tasti andavano persi e la
prova falliva dopo 30 s. Ora aspetta che il WebSocket della pagina sia
aperto.
ReleasingTheMouseOutsideTheViewReleasesTheRemoteButton aspettava 300 ms
prima di scrivere meta e fotogramma, senza bisogno: ciò che il server
scrive resta nella vista finché il socket non è aperto e la pagina
ascolta da subito. Il primo fotogramma sullo schermo dice già che il
mouse può partire.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AfterInEvidenzaTheOtherTabsStayTheirs aspettava 500 e 600 ms perché un
ridisegno rimasto di «In evidenza» (150 ms dopo un cambio di dimensione)
avesse il tempo di coprire i post. Ora aspetta i timer della pagina che
erano in sospeso al cambio di filtro (PageTimers) e, dopo il cambio di
dimensione, un ResizeObserver della prova, chiamato dopo quelli della
pagina, e i timer che quelli hanno lasciato.
TheWindowBarHandleFollowsTheWholeDrag lasciava 60 ms fra un passo e
l'altro del trascinamento: su una macchina lenta più passi possono
arrivare come un solo movimento, e la prova non provava più che la
maniglia segua tutto il trascinamento. Ora ogni passo aspetta il suo
orario nel campo prima del successivo.
TheAccountHeaderFollowsEveryMenuAction aveva 200 ms fra un'azione e
l'altra che non proteggevano nulla: ogni giro aspetta già l'intestazione
ridisegnata.
Con copie dell'interfaccia rotte apposta (ridisegno non annullato,
osservatore non staccato, tessere tardive disegnate, trascinamento che
finisce al primo passo) le prove falliscono in ogni giro provato, anche
con Chrome rallentato 20 volte.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il commento di WaitForQuietAsync e la riga del 21/10 in decisioni.md
promettevano che, a pagina quieta, tutto ciò che la pagina ha fatto con
le risposte fosse finito. Vale solo per il seguito di ogni risposta, con
le richieste che parte lì: non per quelle che la pagina rimanda a un
osservatore, a un fotogramma, a un timer, al flusso degli eventi o a un
modulo che si carica dopo. Sulla Libreria con 40 elementi, al primo
momento senza richieste in volo le 11 righe del mosaico, chieste da un
IntersectionObserver dopo il disegno dei giorni, non erano ancora
partite in 3 giri su 6 (rilievo R1 della revisione).
Le cinque prove che la usano restano corrette: il comando sbagliato che
cercano partirebbe lasciando la pagina o nel seguito di una risposta.
Il testo ora dice questo, e che per una richiesta partita più tardi si
aspetta quella richiesta. Il codice non cambia: una quiete «stabile»
(qualche fotogramma in più) sarebbe di nuovo una finestra di tempo.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
In UiBrowser.Requests la regola creata da __hold restava anche dopo
__release e valeva per prima: un secondo __hold dello stesso indirizzo
non tratteneva nulla, perché il fetch e __release trovavano sempre la
regola già rilasciata, e ogni richiesta successiva a quell'indirizzo
continuava a contare in __started e __done. Una prova che trattenesse due
volte la stessa risposta avrebbe lasciato la pagina a risposta già
arrivata, passando senza provare nulla (rilievo R2 della revisione;
nessuna prova di oggi lo fa).
Ora il rilascio toglie la regola: le richieste già trattenute tengono la
propria e contano come finite sotto il suo indirizzo, le successive
passano subito e non contano, e lo stesso indirizzo si può trattenere di
nuovo. Trattenerlo due volte insieme, o rilasciarlo due volte, è un
errore della prova e lo dice. Con una prova diagnostica solo locale:
prima «seconda trattenuta: passata», ora trattenuta, e started=2 done=2
invece di 3 e 3.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il controllo «nothing of Attività drawn over the Libreria», aggiunto con
la correzione dell'issue #8, guardava solo main: render() mette in main
la cornice della pagina nuova prima ancora di caricare il modulo, e
Attività disegna solo nei nodi della propria cornice, già staccata. Una
copia rotta apposta lo fa fallire solo scrivendo direttamente in main;
con l'ascolto della libreria rimasto, o con l'errore delle richieste
annullate mostrato come avviso sulla Libreria, la prova passava. Il
messaggio del commit 248e9f7 diceva quindi più di quanto la prova
provasse (rilievo R3 della revisione).
Ora, dopo la risposta in ritardo, la prova controlla ciò che una pagina
lasciata mentre carica può davvero lasciare: il timer di un minuto (come
prima), gli avvisi (registrati da un MutationObserver, anche quelli già
spariti) e l'ascolto della libreria. Per l'ascolto manda alla pagina un
evento «libreria» sul suo EventSource, come farebbe il flusso degli
eventi, aspetta che la Libreria richieda i suoi giorni e controlla che
Attività non abbia chiesto altro. Il controllo su main resta, con il
messaggio di ciò che prova. Una modifica pubblicata sul server non
darebbe lo stesso ordine: il flusso si iscrive in un Task.Run senza dire
quando, e raccoglie le modifiche per 300 ms.
Sulla pagina rimasta aperta la stessa modifica deve ricaricare Attività:
così la prova mostra anche che l'evento arriva davvero a chi ascolta.
Con copie rotte apposta, a velocità normale (2 giri) e con Chrome
rallentato 20 volte (1 giro): timer rimasto, ascolto rimasto, avviso
mostrato e nodo scritto in main trovati ogni volta, ciascuno dal suo
controllo; una copia senza ricarica alla modifica la trova il controllo
della pagina aperta; la copia intatta passa 2 volte su 2 e 3 su 3.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Un revisore indipendente ha letto tutto il ramo e ha rifatto compilazione e prove; l'autore ha poi verificato ogni rilievo prima di correggerlo o respingerlo.
Giudizio del revisore
Approvabile così com'è: non ho trovato nulla di bloccante né di importante, solo tre osservazioni minori sugli strumenti di prova, nessuna delle quali tocca le prove attuali.
Causa di #8. È provata, e l'ho riprodotta in modo indipendente. Su main, con latenza di rete emulata a 150 ms, le due prove di #8 sono fallite 4 volte su 4 con lo stesso messaggio della CI («timeout: risposta in ritardo arrivata»); con Chrome rallentato 20 volte, 2 su 4. Sul ramo, nelle stesse condizioni, 8 su 8 superate. Il prodotto non c'entra: con la finestra fissa di 200 ms la pagina veniva lasciata prima che il modulo di Attività finisse di caricarsi, e /api/alerts non partiva mai.
Correzione. Si basa su eventi, non su attese più lunghe: la risposta viene trattenuta, la prova aspetta che la richiesta sia partita, lascia la pagina e poi rilascia. Le prove dimostrano ancora ciò che dichiarano, e in un caso di più. Ho verificato con copie dell'interfaccia rotte apposta:
«browser-preso» lo trova solo il ramo; su main la prova passava lo stesso, come diceva l'autore.
«cancel dopo Ho finito», «timer di Attività rimasto», «osservatore non staccato», «tessere tardive» e «ridisegno non annullato» li trovano sia il ramo sia main. L'ultimo l'ho provato 8 volte su 8 a velocità normale e 3 su 3 a 20x.
Nelle prove dell'interfaccia non resta nessuna attesa a tempo fisso che una macchina lenta possa mancare. L'unica pausa rimasta, 700 ms in NewEntriesAppearAfterTheEmptyLibrary, è il ritmo dei tentativi entro 30 s, non una finestra: la motivazione dell'autore regge. Nessun difetto del prodotto nascosto. Nel ramo non c'è niente che faccia girare UiBrowser su Windows (il controllo !OperatingSystem.IsLinux() è intatto) e nessuna prova diagnostica: i file toccati sono solo InterfaceTests.cs, UiBrowser.cs e docs/decisioni.md. Commit piccoli, messaggi in italiano con la riga Co-Authored-By, file salvati con fine riga LF, git diff --check pulito.
Comandi e risultati, tutti in cloni sotto B:\Altro\Sviluppo.febe-lavoro\revisione-interfaccia (il worktree non l'ho toccato: è pulito, su 7513f41):
dotnet build Febe.slnx -warnaserror su un clone pulito a 7513f41, con TEMP e TMP nella cartella di lavoro: 0 avvisi, 0 errori.
dotnet test tests/Febe.Tests sullo stesso clone: 705 superate, 76 saltate, 0 fallite su 781. Fra le saltate ci sono le 19 prove dell'interfaccia, che su Windows non partono.
dotnet build tests/Febe.Tests -warnaserror su ognuno dei 4 commit: 0 avvisi, 0 errori.
Prove dell'interfaccia sul ramo, con ganci solo locali e Chrome 155:
a velocità normale, 3 giri: 57/57;
a 4x, 2 giri: 38/38;
a 20x, 1 giro: 19/19;
con 150 ms di latenza, 1 giro: 19/19;
un giro su ciascuno dei 3 commit intermedi: 19/19 ogni volta.
I ganci locali (abilitazione su Windows, rallentamento della CPU, latenza, cartella dell'interfaccia) stanno solo nei cloni e non vanno mai committati.
Osservazioni minori, dimostrate con prove diagnostiche lasciate solo nel clone:
R1: WaitForQuietAsync dichiara più di quanto garantisca. Sulla Libreria con elementi è tornata prima delle 11 richieste che il mosaico fa partire dagli osservatori, in 1 giro su 3.
R2: un secondo __hold sullo stesso indirizzo non trattiene nulla.
R3: l'asserzione «nothing of Attività drawn over the Libreria» non può fallire per nessuna modifica della pagina Attività.
Non verificato: l'esecuzione nel contenitore Debian della CI, con Chromium di Debian. Non c'è Docker qui, e la CI la lancia Alberto.
Rilievi ed esito
Rilievo
Gravità
Esito
R1 (tests/Febe.Tests/Web/Support/UiBrowser.cs:316): Il commento di WaitForQuietAsync e la seconda riga del 21/10 in docs/decisioni.md (riga 283) promettono più di quanto la funzione garantisca: «nessuna richiesta in volo, quindi ogni comando è arrivato al server e ogni risposta è stata usata, anche quando ne fa partire un'altra». In realtà __busy() === 0 copre solo le richieste fatte partire nella continuazione di una risposta. Restano fuori quelle avviate da IntersectionObserver/ResizeObserver, requestAnimationFrame, timer, eventi del flusso /api/eventi (EventSource non è contato) o dopo un import() dinamico.
Minore
Corretto: Il rilievo è vero. Con la quiete si aspetta solo il seguito di ogni risposta, non ciò che la pagina rimanda a dopo. L'ho riprodotto in modo certo con una prova solo locale che controlla __busy() nella pagina a ogni compito: sulla Libreria con 40 elementi, al primo momento senza richieste in volo, nessuna delle 11 righe del mosaico (le chiede un IntersectionObserver) era ancora partita in 3 giri su 6 (1 su 3 a velocità normale, 2 su 3 a 4x). Con il controllo ogni 50 ms di WaitAsync quel momento non l'ho mai preso (11 su 11 righe in 11 giri), mentre la revisione l'aveva preso 1 volta su 3. Ho corretto il testo e non il codice: il commento di WaitForQuietAsync e la riga del 21/10 in decisioni.md ora dicono che la quiete copre le richieste partite nel seguito di una risposta, ma non quelle di osservatori, fotogrammi, timer, flusso degli eventi o moduli che si caricano dopo; per queste si aspetta la richiesta stessa. Una quiete «stabile» (due fotogrammi e un setTimeout(0)) non l'ho fatta: sarebbe di nuovo una finestra di tempo e non coprirebbe comunque timer, flusso degli eventi e moduli. Le cinque prove che la usano restano corrette: il comando sbagliato partirebbe lasciando la pagina o nel seguito di una risposta. Commit fe4ef9f.
R2 (tests/Febe.Tests/Web/Support/UiBrowser.cs:54): Le regole create da __hold non vengono mai tolte. Dopo __release la regola resta in holds e continua a valere per prima. Un secondo __hold dello stesso indirizzo quindi non trattiene nulla, perché holds.find nel fetch (riga 62) e in __release (riga 54) trova sempre la regola già rilasciata. Inoltre ogni richiesta successiva a quell'indirizzo continua a contare in __started e __done.
Minore
Corretto: Il rilievo è vero, l'ho riprodotto con una prova diagnostica solo locale sul commit rivisto, 7513f41, in 3 giri su 3: «seconda trattenuta: passata», __hold doppio e __release doppio accettati, started=3 done=3. Contava anche la richiesta non trattenuta partita dopo il rilascio. Correzione in UiBrowser.Requests: il rilascio toglie la regola da holds. Le richieste già trattenute tengono la loro e contano __done sotto il suo indirizzo; le successive passano subito e non contano; lo stesso indirizzo si può trattenere di nuovo. Trattenerlo due volte insieme, o rilasciarlo due volte, lancia un errore con il suo messaggio. Dopo la correzione, in 3 giri più 2: seconda trattenuta trattenuta, «richieste già trattenute per /api/capabilities», «nessuna richiesta trattenuta per /api/capabilities», started=2 done=2. Ho aggiornato il commento della funzione e la prima riga del 21/10 in decisioni.md. Commit 4b35178. Nessuna prova di oggi trattiene due volte lo stesso indirizzo, e le quattro che usano __hold passano: 12 su 12 a 20x, 12 su 12 con 150 ms di latenza.
R3 (tests/Febe.Tests/Web/InterfaceTests.cs:587): Il controllo aggiunto «nothing of Attività drawn over the Libreria» non può fallire per nessuna modifica di activity.js. render() sostituisce il contenuto di main con la cornice nuova prima ancora di caricare il modulo (shell.js 350-365: destroy, poi fill(main, frame.root), poi await route.page()). Attività disegna solo nei nodi della propria cornice, che a quel punto è già staccata. La parte su .benvenuto è già attesa alla riga 583. Il messaggio del commit 248e9f7 e il rapporto dicono che la prova dimostra anche «niente di Attività sulla Libreria»: per il timer la prova resta valida, ma su questo punto non prova nulla.
Minore
Corretto: Il rilievo è vero nella sostanza. Ho fatto girare la prova del ramo su copie dell'interfaccia rotte apposta, 2 giri ciascuna. Passava con l'ascolto della libreria rimasto a una pagina lasciata mentre carica (attivita-ascolta) e con l'errore delle richieste annullate mostrato come avviso sulla Libreria (attivita-avviso). Il controllo su main falliva solo con un nodo scritto direttamente in main (attivita-disegna). Quindi a rigore può fallire per una modifica di activity.js, ma solo per una che scrive fuori dalla propria cornice. L'ho tenuto, con un messaggio che dice cosa prova (nothing of Attività in the page area). Ho aggiunto: (1) gli avvisi, registrati da un MutationObserver anche dopo che spariscono; (2) l'ascolto della libreria: un evento «libreria» mandato all'EventSource della pagina, la conferma quando la Libreria richiede i suoi giorni, e il controllo che Attività non abbia chiesto altro; (3) sulla pagina rimasta aperta, la stessa modifica deve ricaricare Attività: così la prova mostra che l'evento arriva davvero a chi ascolta. Non ho usato una modifica pubblicata sul server: il flusso si iscrive in un Task.Run senza dire quando, e raccoglie le modifiche per 300 ms. WaitForQuietAsync, proposta nel rilievo, non serve: le richieste di un ascolto rimasto partono in modo sincrono durante l'evento. Risultati: a velocità normale ogni copia è trovata dal suo controllo, 2 volte su 2; a 20x 1 volta su 1; la copia che non ricarica Attività la trova il controllo della pagina aperta; la copia intatta passa 2 su 2 e, a 20x, 3 su 3. Il messaggio di 248e9f7 lo corregge il commit 44f7f93, senza riscrivere la storia.
## Revisione avversaria
Un revisore indipendente ha letto tutto il ramo e ha rifatto compilazione e prove; l'autore ha poi verificato ogni rilievo prima di correggerlo o respingerlo.
**Giudizio del revisore**
Approvabile così com'è: non ho trovato nulla di bloccante né di importante, solo tre osservazioni minori sugli strumenti di prova, nessuna delle quali tocca le prove attuali.
**Causa di #8.** È provata, e l'ho riprodotta in modo indipendente. Su main, con latenza di rete emulata a 150 ms, le due prove di #8 sono fallite 4 volte su 4 con lo stesso messaggio della CI («timeout: risposta in ritardo arrivata»); con Chrome rallentato 20 volte, 2 su 4. Sul ramo, nelle stesse condizioni, 8 su 8 superate. Il prodotto non c'entra: con la finestra fissa di 200 ms la pagina veniva lasciata prima che il modulo di Attività finisse di caricarsi, e /api/alerts non partiva mai.
**Correzione.** Si basa su eventi, non su attese più lunghe: la risposta viene trattenuta, la prova aspetta che la richiesta sia partita, lascia la pagina e poi rilascia. Le prove dimostrano ancora ciò che dichiarano, e in un caso di più. Ho verificato con copie dell'interfaccia rotte apposta:
- «browser-preso» lo trova solo il ramo; su main la prova passava lo stesso, come diceva l'autore.
- «cancel dopo Ho finito», «timer di Attività rimasto», «osservatore non staccato», «tessere tardive» e «ridisegno non annullato» li trovano sia il ramo sia main. L'ultimo l'ho provato 8 volte su 8 a velocità normale e 3 su 3 a 20x.
Nelle prove dell'interfaccia non resta nessuna attesa a tempo fisso che una macchina lenta possa mancare. L'unica pausa rimasta, 700 ms in NewEntriesAppearAfterTheEmptyLibrary, è il ritmo dei tentativi entro 30 s, non una finestra: la motivazione dell'autore regge. Nessun difetto del prodotto nascosto. Nel ramo non c'è niente che faccia girare UiBrowser su Windows (il controllo `!OperatingSystem.IsLinux()` è intatto) e nessuna prova diagnostica: i file toccati sono solo InterfaceTests.cs, UiBrowser.cs e docs/decisioni.md. Commit piccoli, messaggi in italiano con la riga Co-Authored-By, file salvati con fine riga LF, `git diff --check` pulito.
**Comandi e risultati**, tutti in cloni sotto B:\Altro\Sviluppo\.febe-lavoro\revisione-interfaccia (il worktree non l'ho toccato: è pulito, su 7513f41):
- `dotnet build Febe.slnx -warnaserror` su un clone pulito a 7513f41, con TEMP e TMP nella cartella di lavoro: 0 avvisi, 0 errori.
- `dotnet test tests/Febe.Tests` sullo stesso clone: 705 superate, 76 saltate, 0 fallite su 781. Fra le saltate ci sono le 19 prove dell'interfaccia, che su Windows non partono.
- `dotnet build tests/Febe.Tests -warnaserror` su ognuno dei 4 commit: 0 avvisi, 0 errori.
- Prove dell'interfaccia sul ramo, con ganci solo locali e Chrome 155:
- a velocità normale, 3 giri: 57/57;
- a 4x, 2 giri: 38/38;
- a 20x, 1 giro: 19/19;
- con 150 ms di latenza, 1 giro: 19/19;
- un giro su ciascuno dei 3 commit intermedi: 19/19 ogni volta.
I ganci locali (abilitazione su Windows, rallentamento della CPU, latenza, cartella dell'interfaccia) stanno solo nei cloni e non vanno mai committati.
**Osservazioni minori**, dimostrate con prove diagnostiche lasciate solo nel clone:
- R1: WaitForQuietAsync dichiara più di quanto garantisca. Sulla Libreria con elementi è tornata prima delle 11 richieste che il mosaico fa partire dagli osservatori, in 1 giro su 3.
- R2: un secondo `__hold` sullo stesso indirizzo non trattiene nulla.
- R3: l'asserzione «nothing of Attività drawn over the Libreria» non può fallire per nessuna modifica della pagina Attività.
**Non verificato:** l'esecuzione nel contenitore Debian della CI, con Chromium di Debian. Non c'è Docker qui, e la CI la lancia Alberto.
**Rilievi ed esito**
| Rilievo | Gravità | Esito |
|---|---|---|
| **R1** (tests/Febe.Tests/Web/Support/UiBrowser.cs:316): Il commento di WaitForQuietAsync e la seconda riga del 21/10 in docs/decisioni.md (riga 283) promettono più di quanto la funzione garantisca: «nessuna richiesta in volo, quindi ogni comando è arrivato al server e ogni risposta è stata usata, anche quando ne fa partire un'altra». In realtà `__busy() === 0` copre solo le richieste fatte partire nella continuazione di una risposta. Restano fuori quelle avviate da IntersectionObserver/ResizeObserver, requestAnimationFrame, timer, eventi del flusso /api/eventi (EventSource non è contato) o dopo un import() dinamico. | Minore | Corretto: Il rilievo è vero. Con la quiete si aspetta solo il seguito di ogni risposta, non ciò che la pagina rimanda a dopo. L'ho riprodotto in modo certo con una prova solo locale che controlla __busy() nella pagina a ogni compito: sulla Libreria con 40 elementi, al primo momento senza richieste in volo, nessuna delle 11 righe del mosaico (le chiede un IntersectionObserver) era ancora partita in 3 giri su 6 (1 su 3 a velocità normale, 2 su 3 a 4x). Con il controllo ogni 50 ms di WaitAsync quel momento non l'ho mai preso (11 su 11 righe in 11 giri), mentre la revisione l'aveva preso 1 volta su 3. Ho corretto il testo e non il codice: il commento di WaitForQuietAsync e la riga del 21/10 in decisioni.md ora dicono che la quiete copre le richieste partite nel seguito di una risposta, ma non quelle di osservatori, fotogrammi, timer, flusso degli eventi o moduli che si caricano dopo; per queste si aspetta la richiesta stessa. Una quiete «stabile» (due fotogrammi e un setTimeout(0)) non l'ho fatta: sarebbe di nuovo una finestra di tempo e non coprirebbe comunque timer, flusso degli eventi e moduli. Le cinque prove che la usano restano corrette: il comando sbagliato partirebbe lasciando la pagina o nel seguito di una risposta. Commit fe4ef9f. |
| **R2** (tests/Febe.Tests/Web/Support/UiBrowser.cs:54): Le regole create da `__hold` non vengono mai tolte. Dopo `__release` la regola resta in `holds` e continua a valere per prima. Un secondo `__hold` dello stesso indirizzo quindi non trattiene nulla, perché `holds.find` nel fetch (riga 62) e in `__release` (riga 54) trova sempre la regola già rilasciata. Inoltre ogni richiesta successiva a quell'indirizzo continua a contare in `__started` e `__done`. | Minore | Corretto: Il rilievo è vero, l'ho riprodotto con una prova diagnostica solo locale sul commit rivisto, 7513f41, in 3 giri su 3: «seconda trattenuta: passata», __hold doppio e __release doppio accettati, started=3 done=3. Contava anche la richiesta non trattenuta partita dopo il rilascio. Correzione in UiBrowser.Requests: il rilascio toglie la regola da holds. Le richieste già trattenute tengono la loro e contano __done sotto il suo indirizzo; le successive passano subito e non contano; lo stesso indirizzo si può trattenere di nuovo. Trattenerlo due volte insieme, o rilasciarlo due volte, lancia un errore con il suo messaggio. Dopo la correzione, in 3 giri più 2: seconda trattenuta trattenuta, «richieste già trattenute per /api/capabilities», «nessuna richiesta trattenuta per /api/capabilities», started=2 done=2. Ho aggiornato il commento della funzione e la prima riga del 21/10 in decisioni.md. Commit 4b35178. Nessuna prova di oggi trattiene due volte lo stesso indirizzo, e le quattro che usano __hold passano: 12 su 12 a 20x, 12 su 12 con 150 ms di latenza. |
| **R3** (tests/Febe.Tests/Web/InterfaceTests.cs:587): Il controllo aggiunto «nothing of Attività drawn over the Libreria» non può fallire per nessuna modifica di activity.js. render() sostituisce il contenuto di main con la cornice nuova prima ancora di caricare il modulo (shell.js 350-365: destroy, poi fill(main, frame.root), poi await route.page()). Attività disegna solo nei nodi della propria cornice, che a quel punto è già staccata. La parte su .benvenuto è già attesa alla riga 583. Il messaggio del commit 248e9f7 e il rapporto dicono che la prova dimostra anche «niente di Attività sulla Libreria»: per il timer la prova resta valida, ma su questo punto non prova nulla. | Minore | Corretto: Il rilievo è vero nella sostanza. Ho fatto girare la prova del ramo su copie dell'interfaccia rotte apposta, 2 giri ciascuna. Passava con l'ascolto della libreria rimasto a una pagina lasciata mentre carica (attivita-ascolta) e con l'errore delle richieste annullate mostrato come avviso sulla Libreria (attivita-avviso). Il controllo su main falliva solo con un nodo scritto direttamente in main (attivita-disegna). Quindi a rigore può fallire per una modifica di activity.js, ma solo per una che scrive fuori dalla propria cornice. L'ho tenuto, con un messaggio che dice cosa prova (nothing of Attività in the page area). Ho aggiunto: (1) gli avvisi, registrati da un MutationObserver anche dopo che spariscono; (2) l'ascolto della libreria: un evento «libreria» mandato all'EventSource della pagina, la conferma quando la Libreria richiede i suoi giorni, e il controllo che Attività non abbia chiesto altro; (3) sulla pagina rimasta aperta, la stessa modifica deve ricaricare Attività: così la prova mostra che l'evento arriva davvero a chi ascolta. Non ho usato una modifica pubblicata sul server: il flusso si iscrive in un Task.Run senza dire quando, e raccoglie le modifiche per 300 ms. WaitForQuietAsync, proposta nel rilievo, non serve: le richieste di un ascolto rimasto partono in modo sincrono durante l'evento. Risultati: a velocità normale ogni copia è trovata dal suo controllo, 2 volte su 2; a 20x 1 volta su 1; la copia che non ricarica Attività la trova il controllo della pagina aperta; la copia intatta passa 2 su 2 e, a 20x, 3 su 3. Il messaggio di 248e9f7 lo corregge il commit 44f7f93, senza riscrivere la storia. |
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Il ramo si aggiorna con main (PR #9) prima dell'unione, come vuole la protezione di main. Conflitti solo dove i due rami
aggiungono righe allo stesso punto: la sezione 0.1.2 del CHANGELOG e il fondo di docs/decisioni.md, tenute tutte.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs/stato.md dice che cosa è uscito (release 0.1.1, immagine non pubblicata per la mancanza di REGISTRY_TOKEN), che
cosa fa ora la pulizia e che cosa resta ad Alberto: leggere la prova della pulizia prima di lunedì 26/10, il segreto,
le prove dal vivo C5.2–C5.5 e due decisioni (filtro della cache per esecuzione, commenti degli script in italiano).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96
merged commit b3a7c31e5a into main2026-10-21 16:02:59 +02:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Sintesi
Segnalazione #8. Le prove dell'interfaccia non si affidano più a pause a tempo fisso: aspettano gli eventi. La prova che
falliva su un host lento ora è stabile, e lo sono anche le altre attese dello stesso tipo trovate controllando tutte le
prove d'interfaccia.
Causa (accertata)
APageLeftWhileLoadingLeavesNothingBehindapriva Attività e tornava alla Libreria dopo 200 ms fissi, poi aspettavala risposta ritardata di
/api/alerts. Su un host lento il modulo di Attività non aveva ancora chiesto/api/alertsentro200 ms: la richiesta non partiva mai e l'attesa scadeva. Riprodotto su
maincon una latenza simulata di 150 ms (4 su 4)e con Chrome rallentato 20 volte (2 su 4). Il prodotto non c'entra.
Che cosa cambia
UiBrowser: le risposte si possono trattenere (__hold) e rilasciare (__release). La prova aspetta che la richiestasia partita, lascia la pagina e solo allora la rilascia. C'è anche
WaitForQuietAsync, «pagina quieta», con ilcommento che dice esattamente che cosa garantisce.
libreria e non mostri avvisi sulla pagina successiva. Prima quel controllo non poteva fallire.
dei ridisegni rimandati e del trascinamento: ora tutte basate su eventi.
docs/decisioni.mde inCHANGELOG.md(0.1.2 in preparazione).Come è stato provato
La revisione avversaria ha riprodotto la causa in modo indipendente e ha trovato tre rilievi minori, corretti.
Da tenere d'occhio: un solo timeout di
OpenAsyncin migliaia di esecuzioni, all'apertura di/browser, senza causatrovata. Se ricompare, va fatto dire a
OpenAsyncquale condizione mancava.Rischi e ritorno indietro
git revert -m 1 <commit di unione>.Controlli prima di unire
UiBrowsersu Windows è statocommittato
Chiude #8.
🤖 Generated with Claude Code
Revisione avversaria
Un revisore indipendente ha letto tutto il ramo e ha rifatto compilazione e prove; l'autore ha poi verificato ogni rilievo prima di correggerlo o respingerlo.
Giudizio del revisore
Approvabile così com'è: non ho trovato nulla di bloccante né di importante, solo tre osservazioni minori sugli strumenti di prova, nessuna delle quali tocca le prove attuali.
Causa di #8. È provata, e l'ho riprodotta in modo indipendente. Su main, con latenza di rete emulata a 150 ms, le due prove di #8 sono fallite 4 volte su 4 con lo stesso messaggio della CI («timeout: risposta in ritardo arrivata»); con Chrome rallentato 20 volte, 2 su 4. Sul ramo, nelle stesse condizioni, 8 su 8 superate. Il prodotto non c'entra: con la finestra fissa di 200 ms la pagina veniva lasciata prima che il modulo di Attività finisse di caricarsi, e /api/alerts non partiva mai.
Correzione. Si basa su eventi, non su attese più lunghe: la risposta viene trattenuta, la prova aspetta che la richiesta sia partita, lascia la pagina e poi rilascia. Le prove dimostrano ancora ciò che dichiarano, e in un caso di più. Ho verificato con copie dell'interfaccia rotte apposta:
Nelle prove dell'interfaccia non resta nessuna attesa a tempo fisso che una macchina lenta possa mancare. L'unica pausa rimasta, 700 ms in NewEntriesAppearAfterTheEmptyLibrary, è il ritmo dei tentativi entro 30 s, non una finestra: la motivazione dell'autore regge. Nessun difetto del prodotto nascosto. Nel ramo non c'è niente che faccia girare UiBrowser su Windows (il controllo
!OperatingSystem.IsLinux()è intatto) e nessuna prova diagnostica: i file toccati sono solo InterfaceTests.cs, UiBrowser.cs e docs/decisioni.md. Commit piccoli, messaggi in italiano con la riga Co-Authored-By, file salvati con fine riga LF,git diff --checkpulito.Comandi e risultati, tutti in cloni sotto B:\Altro\Sviluppo.febe-lavoro\revisione-interfaccia (il worktree non l'ho toccato: è pulito, su
7513f41):dotnet build Febe.slnx -warnaserrorsu un clone pulito a7513f41, con TEMP e TMP nella cartella di lavoro: 0 avvisi, 0 errori.dotnet test tests/Febe.Testssullo stesso clone: 705 superate, 76 saltate, 0 fallite su 781. Fra le saltate ci sono le 19 prove dell'interfaccia, che su Windows non partono.dotnet build tests/Febe.Tests -warnaserrorsu ognuno dei 4 commit: 0 avvisi, 0 errori.I ganci locali (abilitazione su Windows, rallentamento della CPU, latenza, cartella dell'interfaccia) stanno solo nei cloni e non vanno mai committati.
Osservazioni minori, dimostrate con prove diagnostiche lasciate solo nel clone:
__holdsullo stesso indirizzo non trattiene nulla.Non verificato: l'esecuzione nel contenitore Debian della CI, con Chromium di Debian. Non c'è Docker qui, e la CI la lancia Alberto.
Rilievi ed esito
__busy() === 0copre solo le richieste fatte partire nella continuazione di una risposta. Restano fuori quelle avviate da IntersectionObserver/ResizeObserver, requestAnimationFrame, timer, eventi del flusso /api/eventi (EventSource non è contato) o dopo un import() dinamico.fe4ef9f.__holdnon vengono mai tolte. Dopo__releasela regola resta inholdse continua a valere per prima. Un secondo__holddello stesso indirizzo quindi non trattiene nulla, perchéholds.findnel fetch (riga 62) e in__release(riga 54) trova sempre la regola già rilasciata. Inoltre ogni richiesta successiva a quell'indirizzo continua a contare in__startede__done.7513f41, in 3 giri su 3: «seconda trattenuta: passata», __hold doppio e __release doppio accettati, started=3 done=3. Contava anche la richiesta non trattenuta partita dopo il rilascio. Correzione in UiBrowser.Requests: il rilascio toglie la regola da holds. Le richieste già trattenute tengono la loro e contano __done sotto il suo indirizzo; le successive passano subito e non contano; lo stesso indirizzo si può trattenere di nuovo. Trattenerlo due volte insieme, o rilasciarlo due volte, lancia un errore con il suo messaggio. Dopo la correzione, in 3 giri più 2: seconda trattenuta trattenuta, «richieste già trattenute per /api/capabilities», «nessuna richiesta trattenuta per /api/capabilities», started=2 done=2. Ho aggiornato il commento della funzione e la prima riga del 21/10 in decisioni.md. Commit4b35178. Nessuna prova di oggi trattiene due volte lo stesso indirizzo, e le quattro che usano __hold passano: 12 su 12 a 20x, 12 su 12 con 150 ms di latenza.248e9f7e il rapporto dicono che la prova dimostra anche «niente di Attività sulla Libreria»: per il timer la prova resta valida, ma su questo punto non prova nulla.248e9f7lo corregge il commit44f7f93, senza riscrivere la storia.🤖 Generated with Claude Code