p65

patch_history/RETRIEX_PATCH_65_AGENT_CHAT_MESSAGES_UNIFICATION_README.md

@@ -0,0 +1,63 @@
+# RetrieX Patch p65 - Agent Chat Messages Unification
+
+## Ziel
+
+p65 fuehrt die p63/p64 Chat-Messages-Linie weiter und verschiebt chat-sichtbare Agent-/Production-UI-Texte aus `config/retriex/agent.yaml` nach `config/retriex/chat-messages.yaml`.
+
+Der Patch aendert keine Retrieval-, Ranking-, Scoring-, Intent- oder Shopware-Logik. Er aendert nur die Konfigurationsquelle fuer nutzerlesbare Agent-/UI-Meldungen.
+
+## Geaenderte Dateien
+
+- `config/retriex/chat-messages.yaml`
+  - neuer Bereich `agent`
+  - uebernimmt Agent-Statusmeldungen, No-LLM-Fallback-Texte, Product-Field-Texte, Production-UI-Texte, Source-Labels, HTML-Templates und den Final-Answer-Guard-Hinweis
+- `config/retriex/agent.yaml`
+  - entfernt die verschobenen chat-sichtbaren Textbloecke
+  - behaelt technische Orchestration, Limits, Guards, Routing-, Prompt- und Runtime-Konfiguration
+- `src/Config/ChatMessagesConfig.php`
+  - bietet generische String-, Allow-Empty-String- und Action-List-Accessor fuer Agent-Chattexte
+  - validiert die neu verschobenen Agent-Chattexte
+- `src/Config/AgentRunnerConfig.php`
+  - liest chat-sichtbare Agent-Texte bevorzugt aus `ChatMessagesConfig`
+  - behaelt Legacy-Fallbacks auf die alten `agent.yaml`-Pfade fuer Rueckwaertskompatibilitaet
+- `config/services.yaml`
+  - injiziert `ChatMessagesConfig` in `AgentRunnerConfig`
+
+## Bewusst nicht geaendert
+
+- Keine Aenderung an `AgentRunner.php`
+- Keine Aenderung an Prompt-, Retrieval-, Scoring-, Ranking- oder Shop-Matching-Logik
+- Keine Aenderung an technischen Protokollwerten, Status-Enums, CSS-Klassen oder internen Keys
+- Genre-sensitive Direct-Answer-Konfiguration in `genre.yaml` bleibt unberuehrt; p65 verschiebt nur die Agent-Fallback-Texte aus `agent.yaml`
+
+## Lokale Checks
+
+Ausfuehrbar und gruen im Patch-Arbeitsverzeichnis:
+
+```bash
+php -l src/Config/AgentRunnerConfig.php
+php -l src/Config/ChatMessagesConfig.php
+php -l src/Config/RetriexEffectiveConfigProvider.php
+php -l src/Config/ConfigSourceAuditProvider.php
+php -l src/Config/GenreSourceOfTruthGuard.php
+python3 - <<'PY'
+import yaml
+for f in ['config/retriex/agent.yaml','config/retriex/chat-messages.yaml','config/services.yaml']:
+    yaml.safe_load(open(f))
+    print('yaml ok', f)
+PY
+```
+
+Zusatzcheck: Die verschobenen Werte aus `agent.yaml` wurden gegen `chat-messages.yaml` verglichen und semantisch identisch erhalten. `ChatMessagesConfig::validate()` sowie wichtige `AgentRunnerConfig`-Getter wurden per kleinem PHP-Smoke-Test erfolgreich geprueft.
+
+## Nicht lokal ausfuehrbar
+
+Die Console-Checks koennen im entpackten ZIP ohne `vendor/` nicht lokal laufen:
+
+```bash
+php bin/console mto:agent:config:validate
+php bin/console mto:agent:regression:test
+php bin/console mto:agent:config:audit-source --details
+```
+
+Bitte diese Checks nach dem Einspielen in der Zielumgebung mit installierten Dependencies ausfuehren.