Files
ThothII/docs/reports/2026-09-13-knowledge-reading.md
T

4.0 KiB

Lettura di Evidence e Memory

Data: 13 settembre 2026. Richiesta: eliminare il muro di testo nelle regole, usare la larghezza disponibile, fornire Memory finte per la verifica grafica e sostituire i pulsanti Copia con l'icona a due fogli.

Intervento

Rimossi il limite di 75ch dal dettaglio Evidence e quello di 72ch dai campi Memory. La variante di lettura Knowledge elimina anche il limite interno dei paragrafi Markdown, mantenendo il comportamento responsive del contenitore. Gli altri visualizzatori non cambiano impaginazione. Codice e identificatori lunghi possono andare a capo quando necessario, senza allargare la pagina.

Per paragrafi di almeno 360 caratteri, la variante introduce separazioni visive dopo almeno 180 caratteri, cercando punti, punti e virgola, punti interrogativi o esclamativi nel testo ordinario. Non divide dentro codice inline, enfasi o link; elenchi, titoli, paragrafi brevi e blocchi SQL già strutturati rimangono intatti. La spaziatura tra paragrafi è 1,25em. Si tratta di un intervento sul rendering Markdown, non di una riscrittura o un salvataggio dei documenti. Nessuna conoscenza di dominio viene generata dal visualizzatore.

Ambito, Provenienza e Regola occupano l'intera larghezza del dettaglio. Gli estratti di provenienza interpretano Markdown, senza mostrare letteralmente asterischi e backtick. Copia usa l'icona Lucide Copy con nome accessibile e tooltip; il percorso completo viene copiato senza trasformazioni e gli errori restano annunciati.

Impeccable ha guidato la leggibilità, la separazione dei paragrafi e l'accessibilità; la larghezza piena segue la richiesta esplicita dell'utente anche oltre la misura di lettura ordinaria del design system.

Memory simulate

In Administration → Memory → Formatting examples, oppure Amministrazione → Memory → Esempi di formattazione, sono disponibili quattro schede FAKE:

  • chiarimento di dominio con una regola lunga;
  • regola SQL con titoli, elenchi e identificatori;
  • domanda risolta con SQL dimostrativo;
  • errore spiegato con paragrafi distinti.

La sezione si apre automaticamente se l'archivio reale è vuoto. Gli esempi sono fixture frontend in frontend/src/shell/memoryFormattingExamples.ts, separate dai risultati dell'archivio e dai suoi conteggi. Riutilizzano il lettore reale, ma non offrono Edit/Delete/Save, non hanno dipendenze o link a schede reali e non vengono inviati ad alcuna API Memory. Nessun inserimento PostgreSQL, indicizzazione Qdrant, consolidamento Evidence o invio al modello è avvenuto. I nomi demo e gli identificatori non sono riferimenti al DWH operativo.

Si possono richiudere senza cancellazioni. Una futura rimozione degli esempi è una modifica del frontend, non una pulizia dei dati. New card dopo un esempio apre una scheda vuota, senza copiarne il contenuto simulato.

Verifiche e consegna locale

  • 762 test frontend in 91 file, tutti superati.
  • 18 scenari Playwright, inclusi reader a 390, 1280 e 2400 px, tema scuro, assenza di overflow, larghezza dei paragrafi e separazione effettiva.
  • Test di conservazione di parole, codice e destinazioni dei link, struttura Markdown e comportamento invariato dei visualizzatori ordinari.
  • Clipboard: contenuto copiato esatto, nome accessibile e fallimento gestito.
  • Fixture Memory: nessuna richiesta di scrittura o caricamento di una falsa scheda dal server; nessuna azione di modifica disponibile.
  • Typecheck, controllo di 1686 traduzioni italiane/1707 riferimenti statici e build Docker superati. Screenshot desktop, desktop largo e mobile scuro controllati.

Il Mac serve la nuova variante CSS. Solo frontend è stato ricreato, container fc4286b5406d, immagine cbe0fe0dce55, healthy. Core 3c3c0739b9af, catalogo 89755e439dc7, Qdrant 52ebd5c47955 ed embedding 7f690e534eda restano invariati e healthy. Non è stato eseguito un deploy Omics o PSD.

Rollback locale, senza toccare altri servizi o volumi:

docker image tag thothii-frontend:before-knowledge-reading-20260913 thothii-frontend:local
bash /private/tmp/thothii-memory-preview.sh up -d --no-deps --no-build --wait frontend