p62 new

patch_history/RETRIEX_PATCH_62_SHOP_QUERY_GUARDRAILS_DOCUMENTATION_README.md

@@ -0,0 +1,73 @@
+# RetrieX Patch p62 - Shopquery Guardrails Documentation
+
+## Ziel
+
+p62 dokumentiert die bestaetigten p60/p61C-Guardrails fuer referenzielle
+Shop-Follow-ups und positive Shopquery-Filterung.
+
+Der Patch aendert keine Runtime-Logik und keine YAML-Werte. Er fuegt nur eine
+Projekt-Checkliste hinzu, damit kuenftige Shopquery-Aenderungen den Flow
+`0,02 dH -> Indikatortyp 300 -> was kostet der indikator` nicht regressieren.
+
+## Neue Dokumentation
+
+- `docs/retriex/shop-query-guardrails.md`
+
+Die Dokumentation beschreibt:
+
+- Zielbild fuer finale Plain-Text-Shopqueries
+- relevante `genre.yaml`-Pflegepunkte
+- Unterschied zwischen History-Ankerung, Stopword-Cleanup und positivem Tokenfilter
+- Regeln fuer konkrete Verlauf-Geraeteanker
+- Verhalten bei unpassenden Shop-Treffern
+- manuelle Regressionstest-Checkliste
+- Do/Don't-Regeln fuer zukuenftige Patches
+
+## Wichtige geschuetzte Regression
+
+Promptfolge:
+
+```text
+Was ist der niedrigste Grenzwert fuer die Wasserhaerte, welcher mit einem Testomaten ueberwacht werden kann?
+mit welchem indikator wird der wert gemessen
+was kostet der indikator
+```
+
+Erwartung fuer die letzte Shopquery:
+
+```text
+testomat 808 300 indikator
+```
+
+Nicht akzeptabel:
+
+```text
+indikatortyp 300 indikator
+300 indikator
+testomat 808 gemessen 300 beim indikator
+```
+
+## Scope
+
+Keine Aenderungen an:
+
+- Runtime-Verhalten
+- Retrieval
+- Prompting
+- Shop-Query-Code
+- Shop-Scoring
+- SearchRepair
+- Intent-Routing
+- YAML-Konfigurationswerten
+
+## Validierung
+
+Da p62 nur Markdown-Dateien hinzufuegt, reichen lokale Datei-/Diff-Pruefungen.
+Im Projekt sollten dennoch die Standardchecks laufen:
+
+```bash
+bin/console mto:agent:config:validate
+bin/console mto:agent:regression:test
+bin/console mto:agent:config:audit-source --details
+bin/console mto:agent:config:audit-patterns --details
+```