docs: relax semantic doc assertions

2026-08-08 21:08:07 +02:00
parent aa502dcf7d
commit b84d4db946
4 changed files with 179 additions and 25 deletions
@@ -91,3 +91,33 @@ Observed RED before the fix:
 ```text
 PROJECT_STATE.md: missing Historical snapshots boundary
 ```
+
+## Fix round 2/5 — 2026-08-08
+
+Addressed reviewer findings:
+
+- Renamed every historical `PROJECT_STATE.md` heading after the historical boundary so no heading
+  level uses `LIVE` or current-state semantics there.
+- Strengthened the historical-boundary regression to reject any Markdown heading level
+  (`#` through `######`) containing `LIVE` or current-state wording after the boundary.
+- Added a fixture with a `### ... — LIVE ...` historical heading to prove RED then GREEN.
+- Replaced remaining exact phrase checks with concept/semantic validation for:
+  - one-workspace/one-collection ownership;
+  - external boundary (DWH/LLM external; vector/embedding internal);
+  - the Italian compact install note.
+- Added 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
+```
+
+Observed RED during this round:
+
+```text
+PROJECT_STATE.md: historical section still contains active/live heading markers
+compact manual paraphrase lacks required pattern: (esterni solo|solo esterni|restano esterni)
+```