p83

patch_history/RETRIEX_PATCH_83_SHOP_QUERY_TOKEN_CORRECTION_PRESERVATION_README.md

@@ -0,0 +1,66 @@
+# RetrieX Patch p83 - Shop Query Token Correction Preservation
+
+## Ziel
+
+Direkte Shop-Suchanfragen sollen Tippfehler-Korrekturen aus `commerce.search_token_corrections` auch dann behalten, wenn die finale Agent-Shopquery vorher durch LLM-Optimierung oder positive Token-Filterung stark reduziert wurde.
+
+Konkreter Regression-Guard:
+
+```text
+ich würde gern chlor im schwinnbad messen
+```
+
+soll nicht mehr auf die zu breite Shopquery
+
+```text
+chlor
+```
+
+reduziert werden, sondern den korrigierten Anwendungskontext behalten:
+
+```text
+chlor schwimmbad
+```
+
+## Änderungen
+
+- `src/Agent/AgentRunner.php`
+  - injiziert `CommerceQueryParserConfig`, um die bestehende zentrale `search_token_corrections`-Liste wiederzuverwenden.
+  - wendet diese Korrekturen vor der finalen Shopquery-Stopword-/Positive-Token-Filterung an.
+  - korrigiert auch den Prompt-Kontext in `preserveCurrentInputShopQueryTerms()`, damit ein Tippfehler wie `schwinnbad` als konfigurierter Preservation-Term `schwimmbad` erkannt wird.
+
+- `config/retriex/genre.yaml`
+  - ergänzt `schwimmbad`, `schwimmbecken` und `pool` als erhaltenswerte Shop-Kontexttokens.
+  - ergänzt dieselben Begriffe in der kleinen positiven Shopquery-Allowlist, damit die finale Query nicht wieder auf `chlor` reduziert wird.
+
+## Nicht geändert
+
+- Kein Retrieval-/Scoring-/Ranking-Fix.
+- Keine Shop-Matching-Änderung.
+- Keine neue harte Tippfehlerliste im PHP-Core.
+- Die bestehende `commerce.search_token_corrections`-Liste bleibt Source of Truth für Korrekturen wie `schwinnbad -> schwimmbad`.
+
+## Erwartete Wirkung
+
+```text
+ich würde gern chlor im schwinnbad messen
+=> chlor schwimmbad
+```
+
+```text
+ich würde gern chlor im schwimmbad messen
+=> chlor schwimmbad
+```
+
+Breite Chlor-Suchen ohne Pool-/Schwimmbad-Kontext bleiben unverändert möglich.
+
+## Empfohlene Prüfungen
+
+```bash
+php -l src/Agent/AgentRunner.php
+bin/console cache:clear
+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
+```