docs(evidence): finalize ticketed restructuring specification

CONTEXT.md

@@ -95,28 +95,70 @@ terminale della sessione.
 
 **Evidence Module** — Il modulo autonomo che possiede la preparazione delle Evidence e
 la loro consultazione durante il workflow. La preparazione avviene fuori dalle singole
-sessioni; il workflow usa soltanto contenuti già pubblicati.
+sessioni; il workflow usa soltanto contenuti già pubblicati. A runtime contribuisce agli
+stage semantici esistenti, senza diventare uno stage visibile e senza modificare ledger,
+artifact o stato del workflow.
 
 **Source Evidence** — Un documento originale del workspace, conservato senza modifiche
 come riferimento umano e origine della successiva ristrutturazione.
 
 **Evidence Unit** — La più piccola unità semantica coerente, revisionabile e ricercabile
-derivata da una sola Source Evidence. Fonti diverse non vengono fuse automaticamente.
+derivata da una sola Source Evidence. Possiede un identificatore stabile indipendente
+dal kind, assegnato una volta nella forma `evidence:<slug>`; fonti diverse non vengono
+fuse automaticamente.
 
 **Evidence kind** — La categoria semantica di una Evidence Unit, che ne determina i
-campi specifici e ne orienta l'uso. I tipi iniziali sono `glossary`, `domain`, `enum`,
-`example`, `mapping`, `normalization`, `formula` e `reference`.
+campi specifici e ne orienta l'uso. Ogni unità ha un solo kind primario; i tipi iniziali
+sono `glossary`, `domain`, `enum`, `example`, `mapping`, `normalization`, `formula` e
+`reference`.
+
+**Glossary Evidence** — Una Evidence Unit che definisce il significato linguistico, i
+sinonimi o le varianti di un termine.
+
+**Domain Evidence** — Una Evidence Unit che esprime una regola o un vincolo del dominio
+non rappresentato da un kind più specifico.
+
+**Enum Evidence** — Una Evidence Unit che collega un insieme finito di valori
+memorizzati ai relativi significati.
+
+**Example Evidence** — Una Evidence Unit che associa un input o una domanda alla sua
+interpretazione o al risultato atteso.
+
+**Mapping Evidence** — Una Evidence Unit che collega un concetto logico agli elementi
+del relativo schema fisico.
+
+**Normalization Evidence** — Una Evidence Unit che descrive la trasformazione di una
+rappresentazione in una forma canonica.
+
+**Formula Evidence** — Una Evidence Unit che contiene una singola espressione PostgreSQL
+componibile e ne dichiara gli input. Una query SQL completa non è una Formula Evidence.
+
+**Reference Evidence** — Una Evidence Unit che rappresenta un collegamento esterno da
+restituire come contenuto autonomo, anziché come semplice provenienza.
 
 **Evidence purpose** — La destinazione dichiarata di una Evidence Unit nel workflow:
-disambiguation, rewriting, schema linking, SQL generation o memory. È distinta
-dall'Evidence kind: il tipo descrive cosa contiene, il purpose quando può essere utile.
+disambiguation, rewriting, schema linking o SQL generation. È distinta dall'Evidence
+kind: il tipo descrive cosa contiene, il purpose quando può essere utile; durante la
+ricerca il purpose richiesto è un filtro obbligatorio. Il recupero di esperienze e
+soluzioni precedenti appartiene al Memory Module e non è un Evidence purpose.
+
+**Evidence Search Outcome** — Il risultato tipizzato di una consultazione del modulo
+Evidence. Distingue una ricerca disponibile, che può legittimamente non trovare
+corrispondenze, da un'indisponibilità tecnica che impedisce allo stage chiamante di
+avanzare fino a un retry riuscito.
+
+**Evidence receipt** — La traccia minima di una consultazione disponibile conservata
+nella sessione: stage semantico, purpose, generazione interrogata e identificatori delle
+Evidence restituite. Non duplica il contenuto delle Evidence.
 
 **Curated Evidence** — Una o più Evidence Unit ristrutturate a partire da una Source
-Evidence e conservate nel repository del workspace per la revisione umana. Non sono
-ancora contenuto autorevole del runtime.
+Evidence e conservate nel repository del workspace come proposte per la revisione
+umana. Git conserva la versione precedente e rende visibile ogni modifica; una Curated
+Evidence non è ancora contenuto autorevole del runtime.
 
-**Published Evidence** — Le Curated Evidence appartenenti a una revisione Git approvata
-e attivata del workspace. Sono le sole Evidence utilizzabili dalle sessioni ThothII.
+**Published Evidence** — Le Curated Evidence valide appartenenti alla revisione attiva
+del workspace e alla generazione Evidence pubblicata. L'approvazione umana precede
+l'attivazione, ma non viene duplicata come stato nel manifest.
 
 **Evidence Index** — La proiezione ricercabile e ricostruibile delle Published Evidence.
 Accelera il recupero delle informazioni, ma non è una fonte di verità.
@@ -125,30 +167,74 @@ Accelera il recupero delle informazioni, ma non è una fonte di verità.
 Curated Evidence mediante estrazione e normalizzazione deterministiche, una singola
 ristrutturazione assistita dal modello e una validazione finale deterministica. Nella
 prima versione accetta Markdown o testo UTF-8 e non acquisisce automaticamente il
-contenuto di URL o documenti esterni.
+contenuto di URL o documenti esterni. Prepara l'intero insieme delle modifiche in
+un'area temporanea e lo applica atomicamente soltanto se tutti gli output sono validi;
+non ritenta automaticamente una chiamata al modello fallita.
 
-**Review item** — Un'ambiguità o un'informazione incompleta segnalata durante l'Evidence
-preparation. Finché un Review item non viene risolto, oppure trasformato dal revisore in
-una limitazione esplicita del contenuto, l'Evidence Unit non può essere indicizzata.
+**Supporting excerpt** — Un breve estratto presente nel Source Evidence che sostiene
+una Evidence Unit. Il sistema ne verifica deterministicamente la presenza dopo la
+normalizzazione meccanica; il curatore resta responsabile di verificarne la sufficienza
+semantica.
+
+**Evidence resolution** — L'operazione esplicita con cui un curatore ritira una
+Evidence Unit oppure la ricollega a un Source Evidence esistente. Aggiorna documento e
+manifest insieme, lascia un diff Git revisionabile e non pubblica né crea commit.
+
+**Review item** — Un blocco di revisione descritto da codice stabile, messaggio umano e
+campo opzionale. Finché viene mantenuto nell'Evidence Unit, ne impedisce la
+pubblicazione; la sua storia è conservata da Git, non da uno stato interno all'item.
+
+**Retirement candidate** — Una Curated Evidence che il Source Evidence esistente non
+sostiene più. Rimane visibile con un Review item e blocca la pubblicazione finché il
+curatore non la elimina oppure la rende nuovamente coerente con il sorgente.
 
 **Evidence evaluation set** — Un piccolo insieme versionato di domande rappresentative
-e relativi risultati attesi, usato per verificare in modo ripetibile la qualità della
-ricerca senza introdurre una piattaforma di valutazione separata.
+e relativi risultati attesi. La baseline è accettabile quando ogni domanda recupera
+almeno un risultato atteso nei primi dieci risultati della fusione RRF; il risultato
+nei primi cinque è informativo. Comprende almeno un caso lessicale, uno semantico e uno
+misto e conserva, a fini diagnostici, le posizioni dense, BM25 e fused.
+
+**Candidate Evidence Generation** — Una generazione completa dell'Evidence Index che
+può essere valutata ma non è ancora visibile alle sessioni. Diventa attiva soltanto se
+supera l'Evidence evaluation set.
 
 **Evidence manifest** — Il file versionato e gestito dal sistema che collega ogni
 Source Evidence al suo hash e alle Evidence Unit derivate. Conserva gli identificatori
 stabili, permette l'elaborazione incrementale e segnala le unità rimaste orfane senza
 cancellarle automaticamente.
 
+**Orphaned Evidence Unit** — Una Curated Evidence il cui Source Evidence non esiste più.
+Rimane disponibile per la revisione, ma blocca la pubblicazione finché non viene
+eliminata, ricollegata oppure ne viene ripristinato il sorgente.
+
 **Evidence Fragment** — Una proiezione ricercabile di una sezione semanticamente
-coerente di una Published Evidence. Qdrant indicizza i frammenti, mentre l'Evidence
-Module li raggruppa e restituisce al workflow l'Evidence Unit completa.
+coerente di una Published Evidence. La divisione segue intestazioni e confini di
+paragrafo; formule, coppie valore/significato, mapping, regole e URL non vengono mai
+tagliati. Il testo completo reso per il frammento usa il solo limite esistente
+`max_chunk_chars`, pari per default a 4.000 caratteri; un elemento atomico troppo grande
+produce un Review item bloccante. Qdrant indicizza i frammenti, mentre l'Evidence Module
+li raggruppa per Evidence Unit.
+
+**Evidence Result** — La rappresentazione di una singola Evidence Unit restituita dalla
+ricerca con metadati, migliori estratti, provenienza e riferimento al documento completo.
 
 **Hybrid Evidence retrieval** — La ricerca che combina in Qdrant una graduatoria
 semantica dense e una graduatoria lessicale BM25 sparse mediante Reciprocal Rank
 Fusion. I metadati tipizzati restringono o orientano i risultati senza creare una
 collezione separata per ogni Evidence kind.
 
+**Evidence query text** — La rappresentazione deterministica condivisa dalla ricerca
+dense e BM25: domanda originale, concetti, tabelle e colonne in ordine fisso. I campi
+vuoti sono omessi; domanda e contesto ricevono soltanto normalizzazione Unicode NFC,
+conversione degli a-capo e rimozione degli spazi esterni. Gli elementi contestuali sono
+poi deduplicati e ordinati senza conversione delle maiuscole, mentre punteggiatura e
+spazi interni della domanda non vengono riscritti.
+
+**Additive BM25 upgrade** — L'estensione non distruttiva della collezione semantica di
+un workspace che conserva il vettore dense predefinito e aggiunge il solo vettore
+sparse `bm25`. Soltanto gli Evidence Fragment ricevono valori BM25; Schema e Memory
+mantengono invariati dati e ricerca dense.
+
 **Formula proposal** — Una formula individuata durante una sessione e conservata come
 artefatto della sessione. Non diventa Published Evidence finché non viene importata,
 revisionata e approvata nel repository del workspace.