fix p58

RETRIEX_PATCH_58_SINGLE_GENRE_LEGACY_VALUE_REDUCTION_README.md

@@ -0,0 +1,81 @@
+# RetrieX Patch p58 - Single-Genre Legacy Value Reduction
+
+## Ziel
+
+Dieser Patch ist der erste kontrollierte Legacy-Cleanup nach p56/p57.
+
+Es bleibt strikt bei: eine Installation = ein Genre. Es gibt keine Multi-Genre-Umschaltung, keinen Tenant-Kontext und keinen Request-/Host-Resolver.
+
+## Warum dieser Schritt
+
+p55 hat die aktuellen fachlichen Wasseranalyse-/Messgeraete-Werte in `config/retriex/genre.yaml` gespiegelt. p56 hat eine erste sichere Auswahl dieser Werte als bevorzugte Runtime-Quelle verdrahtet. p57 hat die `source_paths` dieser zentralen Genre-Werte validierbar und auditierbar gemacht.
+
+p58 reduziert nun die erste Welle doppelter Legacy-Wertpflege: Werte, die p56 bereits bevorzugt aus `genre.yaml` liest, werden an ihren alten Pfaden zu leeren Platzhaltern reduziert. Die Pfade bleiben vorhanden, damit Validierung, Audit und Source-Path-Dokumentation weiterhin stabil bleiben.
+
+## Was geaendert wurde
+
+Reduziert wurden ausschliesslich bereits verdrahtete Legacy-Werte in:
+
+- `config/retriex/agent.yaml`
+  - Shopquery-Stopword-Cleanup-Terms
+  - direkte Attribut-/Vergleichs-Patterns
+  - referenzielle Kontextterme
+  - History-Anchor-Patterns und Template
+  - Meta-Query-Guard-Terms
+  - RAG-Anchor-Enrichment-Patterns/-Terms
+  - Result-Identity-Listen
+  - Laengenfilter-/Sortierpatterns
+  - Direct-Shop-Answer-Texte
+- `config/retriex/commerce.yaml`
+  - `commerce_query.known_brands`
+  - `commerce_query.search_token_canonical_map`
+- `config/retriex/intent.yaml`
+  - Commerce-Strong-Signals
+  - Advisory-Signals und Advisory-Patterns
+  - Size-/Color-Terms
+  - Explicit-Commerce-Intent-Patterns
+- `config/retriex/query_enrichment.yaml`
+  - Query-Enrichment-Regeln
+
+## Nicht geaendert
+
+- Keine Fachlogik-Aenderung.
+- Keine neuen fachlichen Listen.
+- Keine neuen Defaults.
+- Keine Shopware-Kriterien-, Ranking-, Retrieval- oder LLM-Verhaltensaenderung.
+- Keine Multi-Genre-/Tenant-Loesung.
+- Keine Entfernung von Legacy-Pfaden.
+- Keine Reduktion der noch nicht voll entkoppelten `vocabulary.yaml`-Include-Ketten.
+
+## Erwartetes Verhalten
+
+Das Antwortverhalten soll unveraendert bleiben. Die reduzierten Legacy-Werte sind identisch in `genre.configuration_values` vorhanden und werden durch p56 bevorzugt gelesen. Die alten Pfade bleiben als leere Fallback-/Audit-Platzhalter erhalten.
+
+Damit wird die zentrale Single-Genre-Pflegeflaeche staerker: Fuer eine spaetere Umwidmung auf ein anderes Genre sollen diese Werte in `genre.yaml` gepflegt werden, nicht mehr parallel in den alten Runtime-Dateien.
+
+## Lokale Pruefung
+
+Durchgefuehrt:
+
+```bash
+python3 - <<'PY'
+# YAML-Parsing fuer alle Dateien unter config/retriex/*.yaml und config/services.yaml
+PY
+```
+
+Zusaetzlich wurde statisch geprueft:
+
+- 32 reduzierte Legacy-Pfade hatten vor der Reduktion identische Werte in `genre.configuration_values`.
+- dieselben 32 Legacy-Pfade sind nach der Reduktion leer, aber weiterhin vorhanden.
+
+`bin/console` konnte lokal nicht ausgefuehrt werden, weil im ZIP kein `vendor/` enthalten ist.
+
+## Projektchecks nach dem Einspielen
+
+```bash
+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
+```