feat: complete catalog-driven preprocessing
Publish documentation / publish (push) Successful in 2m12s

This commit is contained in:
Codex
2026-09-06 17:49:35 +02:00
parent 8707ae1d46
commit cffa60772e
141 changed files with 5898 additions and 3015 deletions
+13 -21
View File
@@ -71,7 +71,7 @@ va creato un corpus Evidence indipendente scollegato dal catalogo dei workspace.
permette di sceglierlo.
- Workspace ID: `psd-evidence-lab`.
- Directory: `psd-evidence-lab/`.
- Qdrant collection: `psd-evidence-lab`.
- Qdrant collections: `psd-evidence-lab-reference` and `psd-evidence-lab-memory`.
- Evidence URI: `psd-evidence-lab/evidence`.
- Database target: lo stesso DWH read-only di PSD, configurato però come binding del nuovo
workspace.
@@ -84,7 +84,7 @@ va creato un corpus Evidence indipendente scollegato dal catalogo dei workspace.
Il repository di authoring usato dall'umano deve essere un clone diverso dal checkout read-only
gestito dall'installazione.
Collection e workspace distinti isolano i dati, ma non i fault ai servizi. REL-05/06/10-13 e le
Collections e workspace distinti isolano i dati, ma non i fault ai servizi. REL-05/06/10-13 e le
prove di outage richiedono un Compose project lab con `dataRoot`, endpoint Qdrant/Ollama, volumi e
porte propri, oppure proxy di fault scoped esclusivamente al lab. Non fermare né corrompere i servizi
condivisi con PSD. Se questo isolamento non è disponibile, la campagna fault va marcata `NOT RUN` e
@@ -332,20 +332,11 @@ Con `--json`, stdout deve contenere un solo JSON valido.
```bash
"$OPERATOR_THT" --installation "$INSTALLATION" workspace inspect \
--workspace "$WS" --json
"$OPERATOR_THT" --installation "$INSTALLATION" workspace vector inspect \
--workspace "$WS" --json
"$OPERATOR_THT" --installation "$INSTALLATION" workspace preprocess evidence \
--workspace "$WS" --dry-run --json
"$OPERATOR_THT" --installation "$INSTALLATION" workspace preprocess evidence \
"$OPERATOR_THT" --installation "$INSTALLATION" workspace preprocess run \
--workspace "$WS" --json
```
Per un resume controllato:
```bash
"$OPERATOR_THT" --installation "$INSTALLATION" workspace preprocess evidence \
--workspace "$WS" --resume <run-id-32hex> --json
```
Il comando è completo, sovrascrivibile e non supporta dry-run, resume o rollback.
### 9.3 Probe tipizzata tecnica, non superficie host
@@ -654,8 +645,9 @@ separate e non possono essere dichiarate coperte dal solo PASS dell'evaluation.
## 16. Inventario vettoriale corretto
`workspace vector inspect` verifica oggi collection, dimensioni e distanza; non è un inventario dei
record. Per il test esaustivo l'agente deve fornire un helper read-only con questa interfaccia minima:
`workspace inspect` espone lo stato operativo del preprocessing, ma non è un inventario dei record
vettoriali. Per il test esaustivo l'agente deve fornire un helper read-only con questa interfaccia
minima:
```bash
"$EVIDENCE_INVENTORY" capture --installation "$INSTALLATION" --workspace "$WS" \
@@ -824,16 +816,16 @@ nel collaudo manuale.
Prima di G1 e dopo G6 confrontare:
- punti e nearest-neighbour canary di `schema_table` e `schema_column`;
- punti e nearest-neighbour canary di `schema_table`, `schema_column` e `schema_relationship`;
- punti `memory` e `solved_question` eventualmente presenti;
- dimensioni, distanza e dense unnamed della collection;
- query di controllo in `psd-clinical`;
- accesso DWH rigorosamente read-only;
- settings globali ripristinati esattamente al baseline e sessioni PSD non modificate.
`delete_generation`/retention Evidence non deve cancellare altri record kind. `vector rebuild
--destroy` non fa parte del percorso nominale; se usato per provare restore/cleanup deve puntare
alla collection lab, ripetere esattamente il suo nome nei guard e avere autorizzazione esplicita.
`delete_generation`/retention Evidence non deve cancellare altri record kind. Il preprocessing
completo può sostituire soltanto le slice derivate di schema ed Evidence; non deve cancellare
`memory` o `solved_question`.
## 20. Adapter e kind estesi (P2)
@@ -906,8 +898,8 @@ verbale se falliscono:
invariato e causare un full re-embedding;
- se una document generation viene riusata ma i suoi punti esistono solo sotto la revisione vecchia,
il filtro Qdrant revision-pinned può renderla irrecuperabile: inventory e retrieval devono fallire;
- `workspace vector rebuild` può ricreare il dense senza ripristinare subito BM25: non usarlo come
recovery nominale e, se testato, verificare il contratto completo dopo il rebuild;
- non esiste un rebuild Qdrant pubblico separato: il ripristino nominale è sempre una nuova
esecuzione completa di `workspace preprocess run`;
- il writer lock/conflitto va provato live, perché la sola presenza delle primitive nei test non
dimostra che il percorso produttivo le acquisisca;
- non esiste un comando pubblico per inventory, elenco job o riattivazione di una generazione