fix p53

RETRIEX_PATCH_53_CONFIG_LAYOUT_CLEANUP_README.md

@@ -0,0 +1,81 @@
+# RetrieX Patch p53 - Config Layout Cleanup / Shop Runtime Grouping
+
+## Ziel
+
+Dieser Patch gruppiert bestehende Shop-Runtime-Konfiguration in `config/retriex/agent.yaml` unter `shop_runtime`, ohne fachliche Logik zu ändern.
+
+Der Patch ist rein mechanisch:
+
+- keine neue Profil-/Layer-Architektur
+- keine neuen Defaults
+- keine neuen Token-/Stringlisten
+- keine Ranking-, Retrieval- oder Shopware-Kriterienänderung
+- keine LLM-Verhaltensänderung
+
+## Geänderte Dateien
+
+- `config/retriex/agent.yaml`
+- `config/retriex/vocabulary.yaml`
+- `src/Config/AgentRunnerConfig.php`
+- `src/Config/RetriexEffectiveConfigProvider.php`
+
+## Neue Gruppierung
+
+Die bisherigen Runtime-Blöcke wurden wie folgt verschoben:
+
+| Alter Pfad | Neuer Pfad |
+| --- | --- |
+| `direct_shop_result_answer` | `shop_runtime.direct_answer` |
+| `shop_prompt.current_input_preservation` | `shop_runtime.query_cleanup.current_input_preservation` |
+| `shop_prompt.query_stopword_cleanup` | `shop_runtime.query_cleanup.stopword_cleanup` |
+| `shop_prompt.product_attribute_query_cleanup` | `shop_runtime.attribute_cleanup` |
+| `shop_prompt.context_usage` | `shop_runtime.context_resolution.context_usage` |
+| `shop_prompt.context_anchor_enrichment` | `shop_runtime.context_resolution.history_anchor_enrichment` |
+| `shop_prompt.meta_query_guard` | `shop_runtime.context_resolution.meta_query_guard` |
+| `shop_prompt.rag_anchor_enrichment` | `shop_runtime.context_resolution.rag_anchor_enrichment` |
+| `shop_prompt.direct_result_guard` | `shop_runtime.result_identity` |
+| `shop_prompt.length_sort` | `shop_runtime.answer_constraints.length_sort` |
+| `shop_prompt.length_filter` | `shop_runtime.answer_constraints.length_filter` |
+
+`final_answer_guard` bleibt bewusst außerhalb von `shop_runtime`, weil er allgemeiner Runtime-/LLM-Ausgabeschutz ist.
+
+`shop_prompt` enthält nach dem Cleanup nur noch den eigentlichen Shop-Query-Optimizer-Prompt und dessen Sprach-/Prompt-Regeln.
+
+## Vocabulary Views
+
+Die Vocabulary-View-Pfade wurden passend zur neuen Layout-Struktur umbenannt, ohne die zugrunde liegenden Listen zu verändern:
+
+- `agent.shop_prompt.current_input_preservation_terms` -> `agent.shop_runtime.query_cleanup.current_input_preservation_terms`
+- `agent.shop_prompt.context_anchor_enrichment.trigger_terms` -> `agent.shop_runtime.context_resolution.history_anchor_enrichment.trigger_terms`
+
+Die referenzierten Term-Gruppen bleiben unverändert.
+
+## Lokale Prüfungen
+
+Ausgeführt im entpackten Patch-Arbeitsstand:
+
+```bash
+php -l src/Config/AgentRunnerConfig.php
+php -l src/Config/RetriexEffectiveConfigProvider.php
+python3 - <<'PY'
+import yaml
+for f in ['config/retriex/agent.yaml', 'config/retriex/vocabulary.yaml']:
+    yaml.safe_load(open(f, encoding='utf-8'))
+PY
+```
+
+Zusätzlich wurde per YAML-Strukturvergleich geprüft, dass die verschobenen Runtime-Blöcke ihre bisherigen Werte behalten. Nur die zwei Vocabulary-View-Pfadnamen wurden mechanisch an das neue Layout angepasst.
+
+## Nicht lokal ausführbar
+
+Die Symfony-Console-Checks konnten in dieser Umgebung nicht vollständig ausgeführt werden, weil der ZIP-Stand kein `vendor/` enthält.
+
+## Empfohlene Projektchecks nach 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
+```