From 19c646bb21f9b64b0d241b52d3f407816912d457 Mon Sep 17 00:00:00 2001 From: mptyl Date: Sat, 27 Jun 2026 09:51:01 +0200 Subject: [PATCH] docs(spec): indipendenza ChironeWp3 + registro memory locale + evidence in ThothII MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Tre decisioni su dipendenze implicite (domanda user review): 4. Indipendenza da ChironeWp3 (proprieta' architetturale): quando ThothII e' pronto, il server non deve avere ChironeWp3 — solo Supabase (RPC SECURITY DEFINER nel DB, indipendenti dal codice app) + cartella evidence (dentro ThothII). Verificato: codice ThothII non ha riferimenti ChironeWp3/psdwp3, .env non punta a path chirone. 5. Registro memory: locale per-workstation (registry.jsonl in harness/artifacts/memory/ su ciascuna). La F2 legge dal vectordb condiviso e, grazie all'arricchimento metadata (decisione 6), ricostruisce la decisione senza lookup registro. Il registro serve solo per la F5 (promozione: locale + indicizza condiviso). Multi-workstation OK. 7. Evidence: dentro ThothII. La cartella (229 markdown statici curati, 11M, nessun ETL) si sposta in harness/evidence/. ThothII self-contained. Nota: revisionare per PII prima di committare. Onda 0b aggiornata: cp evidence in harness/evidence/ invece di puntare path esterno. --- ...026-06-27-cli-port-completo-skill-riscritta-design.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/superpowers/specs/2026-06-27-cli-port-completo-skill-riscritta-design.md b/docs/superpowers/specs/2026-06-27-cli-port-completo-skill-riscritta-design.md index 610260ce..0f9762d6 100644 --- a/docs/superpowers/specs/2026-06-27-cli-port-completo-skill-riscritta-design.md +++ b/docs/superpowers/specs/2026-06-27-cli-port-completo-skill-riscritta-design.md @@ -9,6 +9,10 @@ 1. **Scope**: F1→F8 completo. Tutti gli 11 cmd CLI mancanti + i 3 cluster backend mancanti + skill riscritta. 2. **Drift phase.py**: riscrittura diretta sui 12 siti cmd che usano le vecchie costanti (`MAX_PHASE`/`PHASE_NAMES`/`SCHEMA_LINKING_PHASE`/`DECISION_MIN_PHASE`) → `load_workflow()` + metodi su `Workflow`. Niente strato wrapper. 3. **Skill**: riscrittura completa ex-novo che riflette l'architettura ThothII (widget-descriptor, D11 save-one, D13 free-text, D14 value-grounding/formula, D15 rollback), prendendo spunto dalla struttura ChironeWp3 ma non copiandola. +4. **Indipendenza da ChironeWp3** (proprietà architetturale): quando ThothII è pronto, il server non deve avere ChironeWp3 installato — solo Supabase (DWH + pgvector con le RPC SECURITY DEFINER, indipendenti dal codice app) e la cartella evidence (dentro ThothII). Nessuna dipendenza dal repo `chirone`. Verificato: il codice ThothII non ha riferimenti a ChironeWp3/psdwp3 (rename completo); le RPC vivono nel DB. +5. **Registro memory: locale per-workstation.** `registry.jsonl` vive in `harness/artifacts/memory/` su ciascuna workstation (NON condiviso). La F2 (applicazione) legge dal vectordb condiviso e, grazie all'arricchimento metadata (decisione 6), ricostruisce la decisione senza lookup nel registro. Il registro resta necessario solo per la F5 (promozione: scrive localmente + indicizza sul vectordb condiviso). Multi-workstation OK: le memorie si condividono via vectordb. +6. **Arricchimento metadata memory vectordb**: `subject`/`detail`/`rationale` nel jsonb (vedi Sezione 3 punto 2). Correzione del gap ereditato da ChironeWp3. Reso possibile dal fatto che la tabella memory è vuota al momento del porting. +7. **Evidence: dentro ThothII.** La cartella evidence (contenuto statico curato, 229 markdown) si sposta in `harness/evidence/`. ThothII diventa self-contained (vedi Onda 0b). ## Sezione 1 — Architettura e strategia di porting @@ -52,13 +56,14 @@ Dopo ogni onda: `pytest` verde (109, nessuna regressione) + import smoke (`nsp < Perché la sessione L2 validi davvero D14 (value-grounding) e F4 evidence-based (come claims la Sezione 4), servono due setup che oggi mancano: **Evidence:** -- La cartella esiste già sul Mac: `/Users/mp/Chirone/chirone/etl/docs/evidence/` (curata a mano, fonte unica delle evidence). -- Cablare: aggiungere `THOTH_DOCS_ROOT=/Users/mp/Chirone/chirone/etl/docs` al `.env` (oggi vuoto) + blocco `evidence` nel `chirone-test.yaml`: +- La cartella evidence è **contenuto statico curato a mano** (229 markdown, 11M, nessuno script generatore ETL). Verificato: è documentazione clinica/db, non output di un processo. Per il deploy multi-workstation self-contained, **si sposta dentro ThothII** in `harness/evidence/` (non più dipendenza dal path esterno `/Users/mp/Chirone/chirone/etl/docs`). +- Operazione: `cp -r /Users/mp/Chirone/chirone/etl/docs harness/evidence` + aggiornare il default di `THOTH_DOCS_ROOT` a `harness/evidence` + blocco `evidence` nel `chirone-test.yaml`: ```yaml evidence: source_root: ${THOTH_DOCS_ROOT} evidence_dir: evidence ``` +- **Nota sicurezza:** la cartella va revisionata per contenuto sensibile (dati paziente?) prima di committare nel repo. Se contiene PII, va nel `.gitignore` e distribuita fuori banda, non nel repo pubblico. Da verificare prima del commit. - Verifica: `nsp search --kind evidence ""` ritorna risultati non vuoti su un termine noto. **LSH index (value-grounding D14a):**