docs: aggregate P2-P6 acceptance, full-suite results, and user guide

PROJECT_STATE.md

@@ -7,7 +7,7 @@
 > ThothII per il repository (app + CLI `thothctl`), (3) come usare l'applicazione ThothII di base
 > (sessioni, domande, gate). Il documento userà parole semplici ed esempi; i dettagli tecnici
 > resteranno nei contratti esistenti. Esempio pratico completo: Policlinico San Donato.
- Last updated: 2026-08-13 (P2–P6 all accepted).
+ Last updated: 2026-08-13 (P2–P6 accepted; aggregate PASS; user guide written).
 > Point a fresh session here ("read PROJECT_STATE.md") before substantial work.
 
 ### P3 effective configuration and `.tht-dwh` — implementation complete, automated PASS, manual PASS (2026-08-13)
@@ -134,6 +134,34 @@
 - **Manual acceptance:** PASS (owner approval 2026-08-13) — walkthrough section P6 in
   `docs/testing/p2-p6-manual-verification.md`.
 
+### Final aggregate P2–P6 verification — automated PASS, manual PENDING (2026-08-13)
+
+- **Aggregate process goal:** one clean-state run exercises the complete DWH → FK → schema →
+  filesystem Evidence chain through `thothctl`/the operator surface, proves idempotency and
+  revision isolation, proves a second installation consumes the same Git workspace with its own
+  state, exercises unsafe-tree and bound negatives, and cleans only owned resources.
+- **Automated acceptance:** PASS 12/12 (run `p2p6-ee542112c526ef0d4c25ddf6c8bc164b`, report
+  `.artifacts/p2p6-integration/p2p6-ee542112c526ef0d4c25ddf6c8bc164b/` retained via `--keep`, bound
+  to clean source commit `1dcf4051b0d9db8ae163e4d7c53871564ca3c564`): preflight, clean_state,
+  ownership, activation_materialization, dwh_chain, fk_schema_evidence_chain, revision_isolation,
+  second_installation, unsafe_tree_refused, bound_refused, secret_scan, cleanup_confinement. Runner:
+  `scripts/p2p6-acceptance.sh` / `backend/scripts/p2p6-acceptance.mjs` (+unit test).
+- **Full suites + builds (design §10):** harness **873 passed / 4 deselected** (with color disabled;
+  the forced-color environment splits `--help` flags and trips the gate-CLI consistency test only);
+  backend **698/698** + tsc + build; frontend **364/364** + `tsc -b` + build; `thothctl` Go
+  build+test **9/9**; `git diff --check` clean.
+- **Manual acceptance:** PENDING — "Final aggregate P2–P6 verification" in
+  `docs/testing/p2-p6-manual-verification.md`.
+
+### User-guide deliverable (owner requirement) — written, review PENDING (2026-08-13)
+
+- **`docs/guida-utente.md`** (Italian, simple words + examples) covers: (1) preparing the workspace
+  Git repository (catalog + schema-v3 descriptor + Evidence + curated annotations), (2) using the
+  ThothII tools for the repository (`thothctl` commands + read-only workspace management), and (3)
+  using the base ThothII application (sessions, questions, gates). It ends with a complete
+  Policlinico San Donato walkthrough and links to the technical contracts.
+- Registered in the MkDocs nav (`mkdocs.yml`). Owner review PENDING.
+
 ### P2 host preprocessing CLI — implementation complete, automated PASS, manual PENDING (2026-08-11)
 
 - **Scope:** P2 (PRD D2, based on the P1.1 registry contract): the installed native `thothctl`