chore: commit remaining worktree changes

docs/prd/2026-08-09-workspace-preprocessing-prd.md

@@ -1,11 +1,11 @@
 # PRD — Preprocessing per-workspace su ThothII (Qdrant + Git workspace registry)
 
-**Status:** PRD in revisione — decisioni D1–D9 chiuse il 2026-08-09; i piani P1–P10 partiranno solo dopo
-revisione e conferma del proprietario
+**Status:** baseline storica dei requisiti — implementazione completata; per i contratti correnti vedere
+`docs/contracts/workspace-preprocessing-cli.md`, `docs/contracts/workspace-evidence-v3.md` e
+`docs/evidence.md`
 **Data:** 2026-08-09
 **Autore:** analisi dello stato attuale (branch `codex/git-workspace-registry`) + decisioni con il proprietario
-**Uso:** riferimento stabile di requisiti e decisioni; da ogni punto nascerà un piano separato in
-`docs/superpowers/plans/` (sez. 11) — questo documento non è un piano di lavoro
+**Uso:** riferimento stabile delle decisioni originarie; questo documento non è un piano operativo
 
 ---
 
@@ -14,8 +14,8 @@ revisione e conferma del proprietario
 > descriptor `<id>/workspace.yaml`, evidence embedded `<id>/evidence/`, annotazioni FK curate
 > `<id>/schema/annotations.yaml` (P5), docs generate `workspace-docs/<id>/`. I vecchi percorsi
 > piatti (`workspaces/<id>.yaml`, `workspace-content/<id>/evidence/`) sono superseded; le uniche
-> occorrenze rimaste sono storiche (changelog/revisioni). Vedi
-> `docs/superpowers/plans/2026-08-11-p2-p6-adaptation-to-p1-1-registry.md`.
+> occorrenze rimaste sono storiche (changelog/revisioni). Il contratto corrente è descritto in
+> `docs/contracts/workspace-evidence-v3.md`.
 
 ---
 
@@ -34,10 +34,9 @@ scrittura via REST dedicato o loading diretto) a un'architettura con:
   `resources.embeddings` + `roots` sotto `<dataRoot>/sessions/<wsId>/`).
 
 La **macchina di preprocessing** (comandi, job a generazioni con publish atomico, adapter Qdrant, corpus
-evidence, FK, memory) **esiste già ed è testata**: `tht preprocess evidence|dwh`, `tht vector init|index-schema`,
-`tht schema introspect|suggest-fks|check`, `tht evidence extract|index`, `tht lsh build`, memory/solved.
-Esistono job Compose fixture (`deploy/compose.preprocess.yaml` + `deploy/workspaces/preprocess-{dwh,evidence}.yaml`)
-e uno smoke (`scripts/preprocess-smoke.sh`).
+evidence, FK, memory) **esiste ed è testata**. La superficie operativa corrente è il comando host
+`tht --installation ... workspace preprocess ...`, che esegue il servizio profile-gated
+`workspace-maintenance`; le vecchie fixture Compose dedicate sono state ritirate.
 
 ### Il problema
 
@@ -210,8 +209,7 @@ documentato e verificato da smoke end-to-end.
   verifica → uso → backup/restore).
 - RF8.2 La documentazione di progetto spiega **cos'è `.tht-dwh`** (generazioni, `OWNER.json`, `ACTIVE`,
   vincolo di fingerprint) in modo comprensibile per l'operatore (D3).
-- RF8.3 Smoke end-to-end automatico (workspace nuovo → tutto il ciclo → sessione reale → cleanup) che
-  sostituisce/completa `preprocess-smoke.sh` (oggi solo fixture).
+- RF8.3 Smoke end-to-end automatico (workspace nuovo → tutto il ciclo → sessione reale → cleanup).
 - RF8.4 Backup/restore coprono Qdrant (già `vector-backup.sh`/`vector-restore.sh`), corpus, `.tht-dwh` e
   registry.
 - RF8.5 Ogni piano successivo traduce il proprio risultato operativo in un **process goal** verificabile da
@@ -332,7 +330,7 @@ Ogni piano tecnico riporta, adattandoli al proprio scope:
    keyword-index.
 8. Rerun del preprocessing: `unchanged` (nessun duplicato); modifica di un'evidence → nuova generazione,
    ACTIVE aggiornato, vecchie generazioni in GC.
-9. Smoke end-to-end automatico verde in CI con cleanup esatto (stile `preprocess-smoke.sh`).
+9. Smoke end-to-end automatico verde in CI con cleanup esatto.
 10. Migrazione PSD documentata e provata almeno in dry-run (re-introspection o riuso catalogo + re-embedding).
 11. Ogni piano tecnico successivo include un process goal automatico completo per il proprio scope e un
     walkthrough manuale quando utile, oppure documenta l'inevitabile eccezione umana secondo S4.
@@ -417,12 +415,11 @@ Ogni piano tecnico riporta, adattandoli al proprio scope:
 - Default invariati (`retain_published_generations: 3`, chunk 4000 char), configurabili per-workspace via
   la sezione `evidence`/policy del descriptor (D1).
 
-## 11. Mappa dei piani (uno per punto del PRD)
+## 11. Mappa storica dell'implementazione
 
-Questo PRD non diventa un unico piano: **ogni decisione/requisito produce un piano separato (P1–P10)** in
-`docs/superpowers/plans/`, eseguibile in sequenza o come workstream indipendenti. Il PRD resta il
-riferimento stabile (requisiti + decisioni); ogni piano cita il punto di origine e i criteri di
-accettazione applicabili (sez. 9) e adotta lo standard integration-first (sez. 8).
+L'implementazione è stata suddivisa nei workstream P1–P10 riportati sotto. I piani esecutivi
+superati sono disponibili nella storia Git; questa tabella conserva soltanto la relazione tra
+requisiti, dipendenze e risultati attesi.
 
 | Piano | Punto PRD | Contenuto sintetico | Dipende da |
 | --- | --- | --- | --- |
@@ -532,12 +529,11 @@ traccia separatamente implementazione, automated integration e manual acceptance
 - Stato attuale: `PROJECT_STATE.md` (sezioni "Internal Qdrant + Ollama semantic infrastructure", snapshot
   registry) e `AGENTS.md`.
 - Design architettura semantica: `docs/plans/2026-08-08-internal-qdrant-ollama-design.md` e relativo piano.
-- Registry: `docs/superpowers/specs/2026-08-03-git-workspace-registry-design.md`, manuali
+- Registry e Evidence: `docs/contracts/workspace-evidence-v3.md`, `docs/evidence.md`, manuali
   `docs/install/local-workspace-registry.md` / `server-workspace-registry.md`.
 - Motore preprocessing: `harness/tht/cli/preprocess_cmd.py`, `harness/tht/corpus/pipeline.py`,
   `harness/tht/jobs/dwh_pipeline.py`, `harness/tht/adapters/vector/qdrant.py`,
   `harness/tht/vectorstore/records.py`, `harness/tht/cli/{vector,schema,evidence,memory}_cmd.py`.
-- Fixture attuali: `deploy/compose.preprocess.yaml`, `deploy/workspaces/preprocess-{dwh,evidence}.yaml`,
-  `scripts/preprocess-smoke.sh`.
+- Superficie operativa: `tools/tht/` e `docs/contracts/workspace-preprocessing-cli.md`.
 - Ammissione runtime: `backend/src/tht/tht-runner.ts` (`qdrantEnsure`/`ollamaEnsure`),
   `backend/src/workspaces/runtime-renderer.ts`.