harden history find tokens and shops earch

RETRIEX_SHOP_QUERY_LANGUAGE_FIX_README.md

@@ -0,0 +1,68 @@
+# RetrieX Shop Query Language Fix
+
+Patch-only fix for v1.5.0.
+
+## Problem
+
+The Shopware query optimizer could translate German user input into English, for example:
+
+```text
+welchen testomat kann ich nutzen zur freien chlor messung
+```
+
+became:
+
+```text
+testomat free chlorine measurement
+```
+
+This reduced Shopware hit quality because the shop catalog is primarily queried with German/domain terms.
+
+## Fix
+
+- Strengthens `config/retriex/agent.yaml` prompt rules so the optimized shop query must preserve the language of the current user input.
+- Adds configurable language-preservation settings under `shop_prompt.language_preservation`.
+- Adds a small post-optimizer repair step in `AgentRunner` that only applies configured replacements when the current user input matches configured language markers.
+- Keeps all translation/repair terms in YAML/fallback config, not as hard-coded product-specific logic in the Shop/Retrieval core.
+- Extends the effective config dump with the new language-preservation settings.
+
+## Example
+
+```text
+testomat free chlorine measurement
+```
+
+is repaired to:
+
+```text
+testomat freies chlor messung
+```
+
+for German input.
+
+## Safety
+
+- No Retrieval, Vector, Scoring, PromptBuilder, SearchRepair or Shopware API logic changed.
+- No Testomat-808-specific logic.
+- Product names, brands and model numbers remain preserved.
+- All new language repair rules are configurable in `agent.yaml`.
+
+## After installation
+
+```bash
+php bin/console cache:clear
+php bin/console mto:agent:config:validate
+php bin/console mto:agent:regression:test
+```
+
+Then retest:
+
+```text
+welchen testomat kann ich nutzen zur freien chlor messung
+```
+
+The displayed shop query should stay German, e.g.:
+
+```text
+testomat freies chlor messung
+```