docs: document internal semantic infrastructure

.superpowers/sdd/2026-08-08-internal-qdrant-ollama/task-11-report.md

@@ -0,0 +1,61 @@
+# Task 11 report
+
+Status: completed on 2026-08-08.
+
+## Scope delivered
+
+- Updated operator-facing documentation for the internal Qdrant + Ollama architecture.
+- Tightened documentation contract tests to require the current four-service-plus-init topology,
+  CPU-first/GPU-override guidance, fixed internal model/dimensions, schema-v3 migration wording,
+  one-collection-per-workspace ownership, and Qdrant backup/restore safety.
+- Updated stable repo guidance in `AGENTS.md` and the current snapshot in `PROJECT_STATE.md`.
+- Rewrote the workspace diagnostic protocol to the schema-v3/internal-semantic-service contract.
+- Updated the memory guide to describe Qdrant as the derived persistent index.
+- Updated the runtime secret-bundle guide to remove active vector/embedding secret guidance.
+
+## Files changed
+
+- `README.md`
+- `AGENTS.md`
+- `PROJECT_STATE.md`
+- `docs/install/local-workspace-registry.md`
+- `docs/install/server-workspace-registry.md`
+- `docs/installazione-docker-4-contesti.md`
+- `docs/workspace-diagnostic-protocol.md`
+- `docs/gestione-memory.md`
+- `deploy/secrets/README.md`
+- `scripts/verify-workspace-install-docs.sh`
+- `scripts/test-verify-workspace-install-docs.sh`
+
+## Verification
+
+Fresh successful runs:
+
+```sh
+./scripts/test-verify-workspace-install-docs.sh
+./scripts/verify-workspace-install-docs.sh --fixtures-only
+git diff --check
+```
+
+Key outcomes:
+
+- internal semantic infrastructure documentation contract passed
+- all existing install/manual fixture contracts still passed
+- diff hygiene passed with no whitespace/errors
+
+## Self-review notes
+
+- The updated docs now match the code-backed Compose topology: `frontend`, `core`, `qdrant`,
+  `embedding`, and `embedding-model-init`.
+- Active manuals no longer instruct operators to configure external vector or embedding runtime
+  endpoints/secrets.
+- Qdrant backup/restore wording now matches the helper scripts' exact confirmation and rollback
+  behavior.
+- Legacy descriptor handling is documented as explicit schema-v3 migration only; no silent
+  semantic-data migration is claimed.
+
+## Residual concerns
+
+- The broader repository still contains historical design/spec material that references older
+  pgvector/external-embedding architecture; this task intentionally updated operator/current-state
+  documentation and the corresponding contract tests, not historical planning documents.