# Revisione e bonifica della documentazione Data: 15 settembre 2026. Baseline: `6a4634dcf1b1df4ad29510a4da371245abd5c666`. Ambito: 121 Markdown e 23 altri file già presenti in `docs/`, navigazione, collegamenti locali, build e verificatori documentali. Il documento conserva la proposta iniziale e registra sotto l'esecuzione successivamente autorizzata dall'utente. È interno, non una pagina del manuale pubblico. ## Bonifica eseguita dopo approvazione Ritirati 35 file dal working tree: 23 Markdown e 12 artefatti visuali generati (otto PNG, due HTML e due JSON). Recuperabili integralmente dalla revisione `5f3a7f5975b96fae1e1cdd0da08b4d60d41064cc`, precedente a questo intervento, mediante `git show REVISIONE:percorso`. Non eliminata né riscritta la storia Git. - Dettagli Compose utili consolidati in [riferimento developer](../operations/compose-reference.md); README rinvia alle sole due procedure manuali IT/EN per installazioni nuove. - M1–M3, E1–E3, X1 e i piani Catalog/model già implementati consolidati nel [record di rilascio](../reports/knowledge-archives-release.md). Test storici non presentati come collaudi attuali; estensioni e accettazioni aperte conservate. - Prompt security assorbito nel PRD, senza approvare il progetto di hardening. - Snapshot di progetto riscritto; overview corretta su Catalog, Memory ed Evidence. - Verificatori auth/DWH e fixture riallineati ai documenti attuali: controlli su permessi, diagnostica, segreti, TLS, separazione dei servizi e link. Le simulazioni del vecchio journal scanner, non più presente nei documenti, non sono conservate come finto collaudo del runtime. Le suite applicative non vengono modificate. - Rimandi Markdown verificati; contratti, ADR (anche superati), progetti con decisioni ancora aperte e runbook/report con rollback o accettazione pendente restano nel repository, esclusi dal sito. Non spostati gate in nuove issue né dichiarati chiusi: lo snapshot corrente li rende espliciti. ADR 0019 conservato senza dedurre dal solo nome che tutte le sue estensioni siano implementate. - Pubblicazione effettiva distinta dal branch `pages`; procedura ripetibile nel [runbook del manuale](../operations/public-docs-publication.md). File ritirati (percorsi dalla radice): - `docs/architecture/thothii-core-sequence.visual-check.1440x900.dark.png` - `docs/architecture/thothii-core-sequence.visual-check.1440x900.light.png` - `docs/architecture/thothii-core-sequence.visual-check.2048x1320.dark.png` - `docs/architecture/thothii-core-sequence.visual-check.2048x1320.light.png` - `docs/architecture/thothii-core-sequence.visual-check.html` - `docs/architecture/thothii-core-sequence.visual-check.json` - `docs/architecture/thothii-runtime.visual-check.1440x900.dark.png` - `docs/architecture/thothii-runtime.visual-check.1440x900.light.png` - `docs/architecture/thothii-runtime.visual-check.2048x1320.dark.png` - `docs/architecture/thothii-runtime.visual-check.2048x1320.light.png` - `docs/architecture/thothii-runtime.visual-check.html` - `docs/architecture/thothii-runtime.visual-check.json` - `docs/installazione-docker-4-contesti.md` - `docs/plans/2026-08-26-metadata-catalog-from-thothai.md` - `docs/plans/2026-08-28-ai-catalog-description-generation-spec.md` - `docs/plans/2026-08-28-ai-catalog-description-generation.md` - `docs/plans/2026-09-02-installation-model-catalog.md` - `docs/plans/2026-09-08-memory-m1-validation.md` - `docs/plans/2026-09-08-security-hardening-resume-prompt.md` - `docs/plans/2026-09-09-archive-repair-x1-validation.md` - `docs/plans/2026-09-09-evidence-e1-validation.md` - `docs/plans/2026-09-09-evidence-e2-validation.md` - `docs/plans/2026-09-09-evidence-e3-validation.md` - `docs/plans/2026-09-09-memory-m2-validation.md` - `docs/plans/2026-09-09-memory-m3-validation.md` - `docs/research/2026-08-23-legacy-thothai-metadata-capabilities.md` - `docs/research/2026-08-23-postgresql-catalog-deployment-constraints.md` - `docs/research/2026-08-23-thothii-metadata-publication-qdrant-seams.md` - `docs/research/2026-09-07-antigravity-gemini-flash-value.md` - `docs/research/2026-09-07-deepseek-harness-terminal.md` - `docs/research/2026-09-07-omp-codex-zcode.md` - `docs/research/2026-09-07-pi-config-vs-oh-my-pi.md` - `docs/research/2026-09-07-zai-coding-plan-cli-quota.md` - `docs/research/2026-09-07-zed-acp-omp-pi.md` - `docs/research/text-to-sql-products.md` Le sezioni successive e l'inventario fotografano la revisione iniziale: la presente sezione prevale per le azioni eseguite. Gli altri ritiri sono rinviati finché non si chiudono i relativi gate; non si cancellano documenti solo perché datati. ## Esito e modifica applicata Il sito confondeva quattro funzioni: manuale del prodotto, riferimento del codice, progettazione e diario delle consegne. Il problema non era soltanto la lunghezza della nav: le pagine non elencate potevano comunque essere generate e indicizzate. La configurazione ora pubblica soltanto 20 pagine e cinque asset esplicitamente ammessi. Il resto è escluso da HTML, file copiati e indice di ricerca. Le nuove pagine pubbliche sono `product-overview.md`, `install/shell-and-language.md` e `usage/memory.md`; i documenti tecnici da cui sono state ricavate restano intatti nel repository. Home e `install/first-start.md` sono state riscritte per dare un ingresso univoco. Non è stato cancellato alcun documento della baseline. `exclude_docs` nega per default la pubblicazione: aggiungere un file a `docs/` non basta più a metterlo online. La build e la pipeline verificano corrispondenza tra nav ed eccezioni, pagine generate, asset e ricerca. I riferimenti tecnici ancora necessari al lettore rinviano esplicitamente ai sorgenti su Gitea, non a pagine interne del sito. **Fuori dal manuale non significa privato.** Il repository ThothII è pubblico: questi file e la cronologia restano leggibili su Gitea. Per riservatezza reale occorrerebbe una decisione separata su repository/accessi e sulla storia già pubblicata. Questa bonifica non modifica autorizzazioni, altri repository o l'installazione applicativa. ## Tre destinazioni, con regole diverse | Destinazione | Contenuto | Regola | | --- | --- | --- | | Manuale pubblico | Prodotto, uso, installazione, configurazione, amministrazione | Descrivere ciò che il lettore può fare oggi; distinguere prerequisiti e limiti verificati. | | Riferimento developer | Architettura, contratti, ADR, test ripetibili, integrazione | Conservare nel repository, fuori da MkDocs; un'autorità per ciascun contratto. | | Lavoro temporaneo o storico | Piani attuati, prompt di ripresa, survey, report di singola consegna | Estrarre decisioni, difetti aperti e rollback ancora necessari; poi ritirare dal working tree con Git come archivio. | Un file datato non è automaticamente obsoleto. Un contratto con `v3` nel nome non è automaticamente sostituito da un descriptor v4: sono versioni di oggetti diversi. Un ADR superato conserva il motivo della decisione e il collegamento al successore. ## Rilievi prioritari, con motivazione ### 1. Percorsi di installazione concorrenti — corretto per il pubblico `install/first-start.md` proponeva ancora setup senza `--configure-only` e avvio con `run-stack.sh`, mentre le guide manuali separano segreti, migrazione e avvio per lo stesso descriptor/progetto. Ora è un punto d'ingresso alle due procedure complete, non una terza ricetta. `installazione-docker-4-contesti.md` rimane interno: consolidarne i dettagli ancora esclusivi in una procedura developer di distribuzione, poi ritirarlo. Anche il percorso rapido nel README va riallineato prima di eliminare quei dettagli. ### 2. Ricerca architetturale presentata come stato corrente — ritirare dopo estrazione `research/2026-08-23-thothii-metadata-publication-qdrant-seams.md` dichiara ancora il passaggio catalog-to-core «deferred» e descrive `annotations.yaml` come input corrente. ADR 0016 e gli attuali contratti registrano invece PostgreSQL come autorità per i consumatori del core. Non usarlo per implementare nuovi comportamenti. `research/2026-08-23-postgresql-catalog-deployment-constraints.md` dichiara esplicitamente di essere parzialmente superato da ADR 0004. L'inventario legacy ThothAI del 23 agosto è esplicitamente storico. Estrarre soltanto vincoli non già presenti in ADR/contratti; poi eliminare i tre file dal working tree, conservandoli nella storia Git. ### 3. Decisioni correnti distribuite tra troppi piani — consolidare prima di eliminare Per Memory/Evidence convivono piani di famiglia, M1, amministrazione comune, revisione di semplificazione e sette resoconti M1–M3/E1–E3/X1. Conservare gli invarianti nei contratti e gli scenari ripetibili in `testing/`; trasferire i gate non chiusi in issue. Solo dopo si possono ritirare piani e validazioni di incremento. `adr/0019-author-evidence-in-app-with-automatic-activation.md` ha un nome che suggerisce editor in-app e attivazione automatica, ma il titolo descrive editor esterni e consolidamento manuale. Contiene anche «Implementation is pending»: non è un affidabile indicatore dello stato di tutte le parti della release. Conservare numero/decisione, correggere metadati e rimandi e distinguere eventuali estensioni ancora pendenti. ### 4. Report operativi e piani con stato non aggiornato — non cancellare in blocco Il report `2026-09-12-ui-visual-review-delivery.md` apre con «non integrata in main»; le integrazioni successive sono documentate altrove. I piani full-shell dicono ancora «deploy server non eseguito», mentre esistono report di rilascio server del 14 settembre. Ciò prova che lo stato è distribuito, non che tutti i collaudi siano conclusi. Consolidare report UI del 12–13 settembre in un record di rilascio per versione. Non ritirare i report del 14 settembre né i runbook di upgrade finché rollback, accettazione interattiva e finestra di osservazione non risultano chiusi dall'operatore. `server-handoff-260906-preprocessing-complete.md` va confrontato con il runbook corrente `server-codex-handoff.md`: estrarre eventuali passaggi di preprocessing esclusivi prima di ritirare la consegna datata. ### 5. Ricerca su strumenti personali estranea al manuale — candidata all'eliminazione I sei confronti CLI/editor/provider del 7 settembre (Antigravity, DeepSeek/CyberArk, OMP/Codex/ZCode, Pi/Oh My Pi, quota Z.ai e Zed/ACP) non spiegano un contratto di ThothII. Prezzi, quote e confronti non sono stati riverificati in questa revisione. Proposta: toglierli dal repository del prodotto, mantenendoli in Git o trasferendoli, su scelta del proprietario, a una raccolta personale. Stessa destinazione proposta per `research/text-to-sql-products.md`, che è una ricognizione di mercato. Non applicare automaticamente questa regola alla ricerca ERD, relationship e classificatore sensibile: prima verificare se documenta decisioni ancora aperte. ### 6. Controlli e snapshot già disallineati — debito da correggere Due verificatori falliscono su file già assenti nella baseline, non per l'esclusione da MkDocs introdotta qui: - `scripts/auth-docs-smoke.sh`: manca `docs/install/local.md`. - `scripts/verify-dwh-auth-docs.sh`: manca `docs/operations/psd-dwh-auth-rollout.md`. Le relative suite di fixture conservano la vecchia struttura. Non ricreare documenti obsoleti per far passare i test: aggiornare i controlli ai contratti attuali, mantenendo le verifiche su segreti, modalità di autenticazione e TLS. Questo riallineamento è proposto, non eseguito in questa bonifica editoriale. `PROJECT_STATE.md` cita nove percorsi `docs/*.md` non più esistenti, fra cui il programma server PSD del 20 agosto, l'accettazione Evidence del 25 agosto e il rollout dwh-auth. Inoltre accumula consegne anziché restare uno snapshot breve. Riscriverlo come stato attuale, gate aperti e rimandi esistenti. I normali link Markdown relativi dei documenti esistenti non presentano target mancanti nella verifica eseguita: i riferimenti rotti qui citati sono anche percorsi in backtick o imposti dagli script. ## Proposta operativa in ordine 0. **Collegare il sito servito al risultato della pipeline:** il controllo remoto descritto sotto ha rilevato una copia statica vecchia. Prima di dichiarare la bonifica online, aggiornare il percorso di pubblicazione sul server con accesso amministrativo verificato. 1. **Separazione pubblica:** applicata; niente cancellazioni di sorgenti. 2. **Riallineare le autorità:** snapshot, verificatori, ADR 0019, README e stato delle consegne; spostare gate aperti in issue senza marcarli completati. 3. **Ritiro a basso rischio, previa approvazione:** confronti personali, ricerca già esplicitamente superata, prompt di ripresa dopo assorbimento nel PRD, output visuali rigenerabili. Controllare prima i riferimenti in tutto il repository. 4. **Consolidamento:** piani completati e report incrementali; non perdere criteri di accettazione, problemi aperti, provenienza delle immagini e rollback ancora validi. 5. **Riorganizzazione eventuale:** `docs/` per il pubblico, `developer-docs/` per architettura/contratti/ADR/testing, `project-notes/` per lavoro in corso. È un secondo intervento: aggiornare insieme tutti i link in README, AGENTS, CONTEXT, script e codice. Per ogni ritiro usare un commit dedicato con motivazione e documento sostitutivo. Non creare una cartella `archive/` piena di copie obsolete: la cronologia Git è già l'archivio, salvo una necessità operativa o di conservazione esplicita. ## Inventario e destinazione proposta L'inventario seguente distingue l'azione proposta dalla sola esclusione già applicata al sito. «Consolidare» e «ritirare» non indicano cancellazioni eseguite. | File (relativo a `docs/`) | Destinazione | Azione proposta | | --- | --- | --- | | `adr/0001-postgres-metadata-catalog.md` | Developer | Conservare decisione architetturale. | | `adr/0002-workspace-database-secret-references.md` | Developer | Conservare decisione architetturale. | | `adr/0003-installation-local-database-bindings.md` | Developer | Conservare decisione architetturale. | | `adr/0004-fastify-kysely-metadata-catalog.md` | Developer | Conservare decisione architetturale. | | `adr/0005-hard-delete-catalog-tables-during-synchronization.md` | Developer | Conservare ADR superato e catena dei successori; non eliminarlo. | | `adr/0006-separate-physical-and-logical-relationships.md` | Developer | Conservare decisione architetturale. | | `adr/0007-durable-authoritative-schema-synchronization.md` | Developer | Conservare decisione architetturale. | | `adr/0008-allow-manual-catalog-metadata-cleanup.md` | Developer | Conservare decisione architetturale. | | `adr/0009-use-one-sequential-description-generation-run.md` | Developer | Conservare decisione architetturale. | | `adr/0010-allow-bounded-real-source-samples-for-description-generation.md` | Developer | Conservare decisione architetturale. | | `adr/0011-gate-source-samples-with-a-sensitive-data-flag.md` | Developer | Conservare decisione architetturale. | | `adr/0012-use-the-catalog-as-the-logical-relationship-authority.md` | Developer | Conservare decisione architetturale. | | `adr/0013-use-one-installation-model-catalog-with-runtime-projections.md` | Developer | Conservare decisione architetturale. | | `adr/0014-assess-sensitive-columns-locally-from-source-content.md` | Developer | Conservare ADR superato e catena dei successori; non eliminarlo. | | `adr/0015-use-progressive-sampling-for-sensitive-columns.md` | Developer | Conservare decisione architetturale. | | `adr/0016-use-postgres-metadata-for-all-core-consumers.md` | Developer | Conservare decisione architetturale. | | `adr/0017-separate-reference-vectors-from-runtime-memory.md` | Developer | Conservare decisione architetturale. | | `adr/0018-use-postgres-for-memory-and-qdrant-for-retrieval.md` | Developer | Conservare decisione architetturale. | | `adr/0019-author-evidence-in-app-with-automatic-activation.md` | Developer | Conservare; allineare nome/stato alla decisione manuale effettiva. | | `adr/0020-unify-administration-pages-and-use-namespaced-routes.md` | Developer | Conservare decisione architetturale. | | `adr/0021-separate-shell-modes-and-replaceable-portal-adapter.md` | Developer | Conservare decisione architetturale. | | `adr/0022-separate-ui-locale-from-session-interaction-language.md` | Developer | Conservare decisione architetturale. | | `agents/domain.md` | Developer | Conservare regole di contribuzione/agenti, fuori dal sito. | | `agents/issue-tracker.md` | Developer | Conservare regole di contribuzione/agenti, fuori dal sito. | | `agents/triage-labels.md` | Developer | Conservare regole di contribuzione/agenti, fuori dal sito. | | `architecture/application-shell.md` | Developer | Conservare riferimento corrente; distinguere il prodotto dalla struttura del codice. | | `architecture/authentication.md` | Developer | Conservare riferimento corrente; distinguere il prodotto dalla struttura del codice. | | `architecture/components.md` | Developer | Conservare riferimento corrente; distinguere il prodotto dalla struttura del codice. | | `architecture/overview.md` | Developer | Conservare riferimento corrente; distinguere il prodotto dalla struttura del codice. | | `architecture/thothii-core-sequence.html` | Developer/build | Conservare sorgente/diagramma tecnico; non pubblicare nel manuale. | | `architecture/thothii-core-sequence.visual-check.1440x900.dark.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core-sequence.visual-check.1440x900.light.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core-sequence.visual-check.2048x1320.dark.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core-sequence.visual-check.2048x1320.light.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core-sequence.visual-check.html` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core-sequence.visual-check.json` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-core.sequence.json` | Developer/build | Conservare sorgente/diagramma tecnico; non pubblicare nel manuale. | | `architecture/thothii-runtime.architecture.json` | Developer/build | Conservare sorgente/diagramma tecnico; non pubblicare nel manuale. | | `architecture/thothii-runtime.html` | Developer/build | Conservare sorgente/diagramma tecnico; non pubblicare nel manuale. | | `architecture/thothii-runtime.visual-check.1440x900.dark.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-runtime.visual-check.1440x900.light.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-runtime.visual-check.2048x1320.dark.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-runtime.visual-check.2048x1320.light.png` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-runtime.visual-check.html` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `architecture/thothii-runtime.visual-check.json` | Transitorio | Ritirare output QA rigenerabili dopo conferma che non siano baseline uniche. | | `contracts/archive-repair.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/catalog-schema-snapshot.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/curated-evidence-v4.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/portal-shell-adapter-v1.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/tht-dwh.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/workspace-evidence-v3.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `contracts/workspace-preprocessing-cli.md` | Developer | Conservare contratto e versioni semantiche; aggiornare insieme a codice/test. | | `disambiguazione-iniziale.md` | Developer | Conservare invarianti di gate/ledger; il percorso utente è in skills.md. | | `evidence.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `general/pi-configuration.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `gestione-memory.md` | Developer | Conservare contratto di Memory; istruzioni pubbliche in usage/memory.md. | | `guida-utente.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `index.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/authentication-local.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/authentication-oidc.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/authentication-upstream.md` | Developer/integratore | Conservare integrazione e confine di fiducia; guida pubblica separata. | | `install/authentik.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/dwh-auth-client-enrollment.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/dwh-auth-server.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/dwh-auth-tls.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/examples/thothii-installation.local.yaml` | Asset pubblico | Conservare asset o esempio operativo. | | `install/examples/thothii-installation.server.yaml` | Asset pubblico | Conservare asset o esempio operativo. | | `install/examples/workspace-bindings.env.example` | Asset pubblico | Conservare asset o esempio operativo. | | `install/first-start.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/standalone-manual-en.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `install/standalone-manual-it.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `installazione-docker-4-contesti.md` | Misto/transitorio | Estrarre dettagli server unici, poi ritirare la ricetta duplicata. | | `javascripts/layout-init.js` | Asset pubblico | Conservare asset o esempio operativo. | | `operations/database-management.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `operations/docker-refresh.md` | Operazioni interne | Conservare finché descrive il contesto locale attivo; poi consolidare il lifecycle. | | `operations/sensitivity-analysis.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `operations/server-codex-handoff.md` | Operazioni interne | Conservare runbook finché migrazione e rollback sono operativamente necessari. | | `operations/server-handoff-260906-preprocessing-complete.md` | Operazioni/transitorio | Confrontare con server-codex-handoff, assorbire passaggi unici, poi ritirare. | | `operations/server-upgrade-gitea-workspace-v2.md` | Operazioni interne | Conservare runbook finché migrazione e rollback sono operativamente necessari. | | `operations/shell-and-localization.md` | Developer/integratore | Conservare integrazione e confine di fiducia; guida pubblica separata. | | `operations/workspaces.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `plans/2026-08-26-metadata-catalog-from-thothai.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-08-28-ai-catalog-description-generation-spec.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-08-28-ai-catalog-description-generation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-02-installation-model-catalog.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-evidence-management.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-memory-evidence-administration.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-memory-evidence-simplification-review.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-memory-m1-spec.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-memory-m1-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-memory-management.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-08-security-hardening-prd.md` | Progetto attivo | Conservare PRD aperto; risolvere decisioni/issue prima del ritiro. | | `plans/2026-09-08-security-hardening-resume-prompt.md` | Transitorio | Ritirare dopo trasferimento di istruzioni e questioni aperte nel PRD/issue. | | `plans/2026-09-09-archive-repair-x1-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-09-evidence-e1-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-09-evidence-e2-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-09-evidence-e3-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-09-memory-m2-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-09-memory-m3-validation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-10-administration-pages-spec.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-13-full-shell-and-portal-integration.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-13-full-shell-spec.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/2026-09-14-manual-standalone-installation.md` | Progetto attivo | Conservare fino alla verifica su tre piattaforme; poi assorbire gate e ritirare. | | `plans/administration-pages/01-navigation.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/administration-pages/02-workspace-readiness.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/administration-pages/03-workbench-family.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `plans/administration-pages/04-embedded-acceptance.md` | Progetto/transitorio | Consolidare invarianti in contratti e gate in issue/test; poi ritirare piano o resoconto. | | `reports/2026-09-02-psd-sensitivity-shadow.md` | Developer/benchmark | Conservare risultati aggregati come evidenza versionata, non garanzia corrente. | | `reports/2026-09-02-sensitivity-ner-license-inventory.md` | Developer/release | Conservare provenienza licenze della release; rigenerare quando cambiano le dipendenze. | | `reports/2026-09-03-psd-progressive-sensitivity-shadow.md` | Developer/benchmark | Conservare risultati aggregati come evidenza versionata, non garanzia corrente. | | `reports/2026-09-12-admin-issues-28-31.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-12-context-shelf-a-implementation.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-12-ui-survey-and-graphic-revision-plan.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-12-ui-visual-review-delivery.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-12-unified-interaction-model.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-full-shell-implementation.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-header-layout-refinements.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-knowledge-reading.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-knowledge-typography.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-shell-simplification-review.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-13-visual-shell-integration.md` | Progetto/transitorio | Consolidare in record di release; ritirare solo dopo trasferimento gate/rollback utili. | | `reports/2026-09-14-session-dialogs-release.md` | Operazioni/release | Conservare finché accettazione, osservazione e rollback non sono chiusi. | | `reports/2026-09-14-session-layout-memory-fix.md` | Operazioni/release | Conservare finché accettazione, osservazione e rollback non sono chiusi. | | `requirements.lock` | Developer/build | Conservare dipendenze e lock; esclusi dal sito. | | `requirements.txt` | Developer/build | Conservare dipendenze e lock; esclusi dal sito. | | `research/2026-08-23-legacy-thothai-metadata-capabilities.md` | Storico/superato | Estrarre vincoli non assorbiti da ADR/contratti, poi ritirare. | | `research/2026-08-23-postgresql-catalog-deployment-constraints.md` | Storico/superato | Estrarre vincoli non assorbiti da ADR/contratti, poi ritirare. | | `research/2026-08-23-thothii-metadata-publication-qdrant-seams.md` | Storico/superato | Estrarre vincoli non assorbiti da ADR/contratti, poi ritirare. | | `research/2026-08-31-browser-erd-library-options.md` | Developer/ricerca | Verificare decisioni ancora aperte; assorbire conclusioni in issue/ADR, poi ritirare. | | `research/2026-08-31-relationship-management-thothai-to-thothii.md` | Developer/ricerca | Verificare decisioni ancora aperte; assorbire conclusioni in issue/ADR, poi ritirare. | | `research/2026-09-02-local-sensitive-column-classifier-libraries.md` | Developer/ricerca | Verificare decisioni ancora aperte; assorbire conclusioni in issue/ADR, poi ritirare. | | `research/2026-09-07-antigravity-gemini-flash-value.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/2026-09-07-deepseek-harness-terminal.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/2026-09-07-omp-codex-zcode.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/2026-09-07-pi-config-vs-oh-my-pi.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/2026-09-07-zai-coding-plan-cli-quota.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/2026-09-07-zed-acp-omp-pi.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `research/text-to-sql-products.md` | Fuori prodotto | Proposta di ritiro dal working tree; Git o raccolta personale su scelta del proprietario. | | `skills.md` | Pubblico | Conservare; istruzioni di prodotto/operatore. | | `stylesheets/extra.css` | Asset pubblico | Conservare asset o esempio operativo. | | `testing/2026-08-29-ai-catalog-description-generation-acceptance.md` | Developer/QA | Conservare criteri ripetibili e gate; separare risultati di singola release. | | `testing/2026-08-31-metadata-privacy-description-test-plan.md` | Developer/QA | Conservare scenari; ridurre duplicazioni e distinguere test proposti da eseguiti. | | `testing/authentication-manual-acceptance.md` | Developer/QA | Conservare criteri ripetibili e gate; separare risultati di singola release. | | `testing/evidence-lifecycle-test-plan.md` | Developer/QA | Conservare criteri ripetibili e gate; separare risultati di singola release. | ## Verifica iniziale, prima dell'esecuzione dei ritiri - Build MkDocs con `--strict` e dipendenze bloccate: superata. - Verifica confine pubblico: 20 pagine, nessun file interno generato o indicizzato. - Otto fixture positive/negative del confine pubblico: superate. - Suite corrente installazione/workspace: superata. - Due verificatori legacy: fallimenti preesistenti descritti sopra; non dichiarati verdi. - Nessuna certificazione di nuova installazione o nuovo collaudo applicativo. La pubblicazione remota va verificata separatamente dalla build locale: il ramo sorgente `main`, il ramo generato `pages` e il sito servito non sono la stessa prova. ### Primo esito remoto del 15 settembre 2026 — diagnosi storica Il commit `043ffdfa` è stato pubblicato su `main`. La [pipeline 122](https://git.tylconsulting.it/mptyl/ThothII/actions/runs/122) è terminata con successo e il ramo `pages` contiene 20 pagine pubbliche, senza pagine interne nell'indice di ricerca verificato anonimamente. L'URL `https://git.tylconsulting.it/thothii-docs/` serve però ancora la home precedente, con `Last-Modified: Wed, 26 Aug 2026 09:00:07 GMT`; il suo indice di ricerca include ancora architettura e contratti. La richiesta senza cache restituisce lo stesso risultato. Nel repository la pipeline aggiorna soltanto il ramo `pages`: non è documentato il collegamento alla directory effettivamente servita dal web server. Il tentativo SSH in sola lettura con la configurazione locale non è proseguito: manca una host key ED25519 conosciuta per `git.tylconsulting.it`. Non è stata disabilitata la verifica dell'identità del server. Servono host/alias amministrativo verificato e percorso o meccanismo di pubblicazione prima di intervenire sul sito effettivo. Al momento di quella verifica la copia servita restava da aggiornare. L'accesso è stato poi risolto usando l'alias SSH già configurato e fidato `contabo`; nessuna host key è stata aggirata. ## Verifica della bonifica eseguita - Build MkDocs strict e confine pubblico: superati, 20 pagine. - Otto fixture del confine pubblico: superate. - Contratti auth/DWH correnti e relative fixture di mutazione: superati. - Suite installazione/workspace, Compose canonico e contratto comandi deployment: superate. - Link Markdown locali di README, PROJECT_STATE e tutti i documenti: nessun target mancante. - `git diff --check`: superato. - `test-no-deployment-coupling.sh`: resta rosso su rilievi preesistenti relativi a contenuti locali PSD e route Omics. Eseguita anche la versione dello script precedente alla bonifica: stesso esito e identico insieme di rilievi, nessuno nuovo. Non è un collaudo del sito e non è stato indebolito per nascondere i risultati. - Nessuna nuova certificazione applicativa, modifica del runtime o chiusura di collaudi reali. I gate elencati nello snapshot restano espliciti. ## Pubblicazione effettiva completata — 15 settembre 2026 - Sorgente: `4ff91e8d6e771545bc3d8e7a0ac0b027ef66ba14`, pubblicata su `main`. - [Pipeline 124](https://git.tylconsulting.it/mptyl/ThothII/actions/runs/124): completata con successo, inclusi i nuovi controlli auth/DWH e pubblicazione `pages`. - Release servita: `/srv/thothii-docs/releases/20260915T123738Z-4ff91e8d`. Il symlink `current` punta a questa release; ricreato soltanto `thothii-docs`. - Configurazione nginx copiata identica; container healthy. Confronto degli ID dei container prima/dopo: nessun altro container ricreato o fermato. - Verifica anonima HTTP: home, ricerca e guide manuali IT/EN rispondono 200. SHA-256 di home e indice remoto identici alla build locale; ricerca: 20 pagine, nessuna interna. - Campioni interni `architecture/overview/`, `plans/2026-09-08-memory-management/` e `operations/compose-reference/`: HTTP 404. - Release precedente `releases/20260826T090022Z-e910c7d` conservata per rollback; nessuna vecchia release cancellata. Pubblicazioni future richiedono il passaggio esplicito del runbook, non il solo push di `main`. Il precedente blocco sulla copia statica obsoleta è quindi risolto.