docs(evidence): publish curated-only workspace contract
This commit is contained in:
@@ -46,6 +46,21 @@ Il modello propone; un revisore umano decide ai gate tramite widget:
|
||||
|
||||
Il frontend renderizza questi widget-descriptor (registro in `src/widgets/`); il transcript live viene ricostruito in memoria dallo stream SSE (`src/store/sessionStore.ts`) — **non è persistito**.
|
||||
|
||||
## Evidence curata e immutabile
|
||||
|
||||
Il repository del workspace è il confine di pubblicazione: il curatore prepara `evidence/source/`,
|
||||
revisa le unità in `evidence/curated/`, valida e fa merge. Per `evidence.schema_version: 2` il
|
||||
runtime materializza l'intero albero `evidence/` dal commit Git esatto, ma il renderer consegna al
|
||||
preprocessing soltanto `curated/**/*.md` dalla root immutabile della revisione. Sorgenti, manifest
|
||||
ed evaluation restano disponibili solo per tracciabilità. Il runtime non modifica, stagea, committa
|
||||
o pubblica il repository di authoring.
|
||||
|
||||
Prima dell'indicizzazione, il corpus curato della revisione pinnata viene validato. La collezione
|
||||
Qdrant condivisa conserva il vettore dense senza nome di Schema e Memory; il preprocessing Evidence
|
||||
può aggiungere soltanto in modo additivo il vettore sparse `bm25` con `idf`, senza eliminare,
|
||||
rinominare o ricreare la collezione. `workspace preprocess evidence` e la parte Evidence di
|
||||
`workspace preprocess run` sono le sole operazioni pubbliche che effettuano questo upgrade.
|
||||
|
||||
## Punti di attenzione ricorrenti
|
||||
|
||||
- `tht -c`/`--config` è un'opzione **per-comando**: deve seguire il subcommand, mai precederlo (`ThtRunner.buildArgv` lo impone).
|
||||
|
||||
Reference in New Issue
Block a user