harden information getter services and optimize user msg

RETRIEX_PRODUCTION_UI_V1_README.txt

@@ -0,0 +1,42 @@
+RetrieX Production UI v1 Patch
+================================
+
+Basis: aktualisierte rag-inprogess.zip aus dem Chat vom 28.04.2026.
+
+Ziel:
+- Produktions-UI abrunden, ohne Retrieval-, Scoring-, Prompt-, Job- oder SSE-Replay-Architektur umzubauen.
+- Vorhandene Badges, Think-Statusmeldungen und Shop-Meta-Cards bleiben erhalten.
+- Neue UI-Informationen werden als vorhandene HTML-Meta-Cards über den bestehenden Stream ausgegeben.
+
+Enthaltene Änderungen:
+- RetrieX-Statuskarte mit RAG-Treffern, Shop-Treffern, Beleglage und Datenbasis.
+- Laufende Statusstufen: Antwort wird vorbereitet, RAG-Wissen wurde durchsucht, Shop-Suche wird vorbereitet, Shop wird durchsucht, Shop-Suche abgeschlossen, Antwort wird generiert, abgeschlossen.
+- Deterministische Shopkarten aus ShopProductResult: Name, Artikelnummer, Preis, Verfügbarkeit, Hersteller, Link, Relevanz.
+- Folgeaktions-Chips: Im Shop suchen, Nur Zubehör anzeigen, Nur Geräte anzeigen, Preis anzeigen, Technische Details anzeigen.
+- Frontend-Deduplizierung aktualisiert bestehende Meta-Karten an ihrer ersten Position, statt die finale Karte ans Ende zu verschieben.
+- Context-Hint im Browser ignoriert Meta-/Produkt-/Statuskarten, damit Folgefragen nicht durch UI-Texte verschmutzt werden.
+- Loader-Text: Antwort wird vorbereitet...
+
+Geänderte Dateien:
+- src/Agent/AgentRunner.php
+- public/assets/js/base.js
+- public/assets/styles/base.css
+- config/retriex/agent.yaml
+
+Bewusst nicht geändert:
+- Retrieval-/Vector-Logik
+- Scoring
+- PromptBuilder-Fachlogik
+- Shop-Query-Repair-Logik
+- SSE-Job-Replay-Protokoll
+- Datenbank/Migrationen
+
+Durchgeführte Prüfungen:
+- php -l src/Agent/AgentRunner.php
+- php -l src/Config/AgentRunnerConfig.php
+- node --check public/assets/js/base.js
+- YAML-Parse für config/retriex/agent.yaml
+- Reflection-Smoke-Test für Statuskarte und Shopproduktkarten
+
+Hinweis:
+Der Patch enthält nur die geänderten Dateien. Zum Einspielen im Projektroot entpacken und bestehende Dateien überschreiben.