ThothII/docs/maintenance/2026-09-15-documentation-cleanup.md

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; 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. 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.

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 è 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: 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.