36 KiB
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.pngdocs/architecture/thothii-core-sequence.visual-check.1440x900.light.pngdocs/architecture/thothii-core-sequence.visual-check.2048x1320.dark.pngdocs/architecture/thothii-core-sequence.visual-check.2048x1320.light.pngdocs/architecture/thothii-core-sequence.visual-check.htmldocs/architecture/thothii-core-sequence.visual-check.jsondocs/architecture/thothii-runtime.visual-check.1440x900.dark.pngdocs/architecture/thothii-runtime.visual-check.1440x900.light.pngdocs/architecture/thothii-runtime.visual-check.2048x1320.dark.pngdocs/architecture/thothii-runtime.visual-check.2048x1320.light.pngdocs/architecture/thothii-runtime.visual-check.htmldocs/architecture/thothii-runtime.visual-check.jsondocs/installazione-docker-4-contesti.mddocs/plans/2026-08-26-metadata-catalog-from-thothai.mddocs/plans/2026-08-28-ai-catalog-description-generation-spec.mddocs/plans/2026-08-28-ai-catalog-description-generation.mddocs/plans/2026-09-02-installation-model-catalog.mddocs/plans/2026-09-08-memory-m1-validation.mddocs/plans/2026-09-08-security-hardening-resume-prompt.mddocs/plans/2026-09-09-archive-repair-x1-validation.mddocs/plans/2026-09-09-evidence-e1-validation.mddocs/plans/2026-09-09-evidence-e2-validation.mddocs/plans/2026-09-09-evidence-e3-validation.mddocs/plans/2026-09-09-memory-m2-validation.mddocs/plans/2026-09-09-memory-m3-validation.mddocs/research/2026-08-23-legacy-thothai-metadata-capabilities.mddocs/research/2026-08-23-postgresql-catalog-deployment-constraints.mddocs/research/2026-08-23-thothii-metadata-publication-qdrant-seams.mddocs/research/2026-09-07-antigravity-gemini-flash-value.mddocs/research/2026-09-07-deepseek-harness-terminal.mddocs/research/2026-09-07-omp-codex-zcode.mddocs/research/2026-09-07-pi-config-vs-oh-my-pi.mddocs/research/2026-09-07-zai-coding-plan-cli-quota.mddocs/research/2026-09-07-zed-acp-omp-pi.mddocs/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: mancadocs/install/local.md.scripts/verify-dwh-auth-docs.sh: mancadocs/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
- 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.
- Separazione pubblica: applicata; niente cancellazioni di sorgenti.
- Riallineare le autorità: snapshot, verificatori, ADR 0019, README e stato delle consegne; spostare gate aperti in issue senza marcarli completati.
- 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.
- Consolidamento: piani completati e report incrementali; non perdere criteri di accettazione, problemi aperti, provenienza delle immagini e rollback ancora validi.
- 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
--stricte 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.