refactor: remove portal deployment coupling

PROJECT_STATE.md

@@ -1,8 +1,24 @@
 # ThothII — Project State
 
-> Starting-point snapshot for new sessions. Last updated: 2026-07-23 (session summary redesign live).
+> Starting-point snapshot for new sessions. Last updated: 2026-08-05 (portable deployment decoupled).
 > Point a fresh session here ("read PROJECT_STATE.md") before substantial work.
 
+## Portable deployment decoupling — LIVE 2026-08-05
+
+- **Mandatory stack.** The supported Compose stack is exactly `frontend` plus `core`; use the
+  base file with `deploy/compose.local.yaml` or `deploy/compose.server.yaml`. `run-stack.sh`
+  invokes the base+local Compose command and the core image provides Pi, so no host Pi binary is
+  part of the launch contract.
+- **External boundaries.** DWH, vector DB, embedding, LLM, and reverse-proxy services are
+  external configurable endpoints even when deployed on the same infrastructure. The two
+  superseded PSD/portal deployment overlays were removed. Workspace descriptors and migration
+  utilities remain separate from deployment runtime configuration.
+- **Legacy PSD deployment ruling.** The PSD bootstrap was deleted because it generated the
+  retired overlay and was therefore deployment machinery, not a data migration utility. Its
+  remaining live contract checks were renamed for the generic local Compose profile. The coupling
+  gate rejects stale active deployment filenames and content while deliberately excluding
+  historical plans/specs, canonical workspace descriptors, and non-runtime migration helpers.
+
 ## Portable Git workspace registry — source integration (2026-08-04)
 
 - **Source of truth and scope.** The canonical workspace repository is a generic Git remote,
@@ -103,7 +119,7 @@
   release; never re-enable filesystem persistence, restore the archive into production, or
   dual-write during rollback.
 
-## Deployment — Docker locale (Profile A, co-located) — LIVE 2026-07-12
+## Historical deployment — Docker locale (Profile A, co-located) — superseded 2026-08-05
 
 ThothII gira in Docker sul server co-locato, **embedded nel portale omics_portal** a `https://aritmolab.policlinicosandonato.it/datamart-builder` (backend invisibile, tutto same-origin via nginx del portale).