docs: verify structured semantic contracts

2026-08-08 21:14:17 +02:00
parent b84d4db946
commit bed43c747e
6 changed files with 219 additions and 46 deletions
@@ -121,3 +121,30 @@ Observed RED during this round:
 PROJECT_STATE.md: historical section still contains active/live heading markers
 compact manual paraphrase lacks required pattern: (esterni solo|solo esterni|restano esterni)
 ```
+
+## Fix round 3/5 — 2026-08-08
+
+Addressed reviewer findings:
+
+- Added table-driven historical-heading fixtures for every Markdown heading level `#` through
+  `######`; all are rejected after the historical boundary when they contain `LIVE`/current-state
+  semantics.
+- Added small structured ownership tables to the active local/server manuals and to the compact
+  Italian operator note.
+- Added small structured semantic-index ownership tables to the active local/server manuals.
+- Replaced the remaining scattered-token relationship checks with explicit structured-section
+  parsing:
+  - architecture ownership rows map DWH → external, LLM → external, Qdrant → internal,
+    Ollama embedding → internal;
+  - semantic-index ownership rows localize the one-workspace/one-collection contract and the
+    schema/Evidence/Memory isolation rule.
+- Added adversarial fixtures that fail when the same tokens are merely scattered in free text.
+- Added structured paraphrase fixtures that pass and omission/inversion fixtures that fail.
+
+Evidence:
+
+```sh
+./scripts/test-verify-workspace-install-docs.sh
+./scripts/verify-workspace-install-docs.sh --fixtures-only
+git diff --check
+```