p84

patch_history/RETRIEX_PATCH_84_MAIN_DEVICE_REFERENTIAL_PRICE_ANCHOR_README.md

@@ -0,0 +1,44 @@
+# RetrieX Patch p84 - Main Device Referential Price Anchor
+
+## Ziel
+
+Referenzielle Gerätepreis-Nachfragen nach einem Zubehör-/Indikator-Flow sollen den zuletzt belegten Hauptgeräteanker behalten.
+
+Beispiel:
+
+1. `zu welchem gerät gehört der indikator 300`
+2. `Preis anzeigen`
+3. `und was kostet das gerät selber`
+
+Die dritte Anfrage darf nicht mehr auf die generische Shopquery `gerät` reduziert werden, sondern soll den zuletzt belegten Gerätemodellanker verwenden, z. B. `testomat 808`.
+
+## Änderung
+
+- Ergänzt in `AgentRunner` einen engen Guard für referenzielle Hauptgeräte-Shopqueries.
+- Der Guard greift nur, wenn:
+  - die aktuelle Query noch keinen Modellanker enthält,
+  - die aktuelle Frage einen Hauptgerätebezug enthält,
+  - die aktuelle Frage keinen Zubehör-/Indikator-/Reagenzbezug enthält,
+  - die bereinigte Query nur generische Geräte-/Preis-/Referenz-/Stopword-Tokens enthält,
+  - im Verlauf ein Produktmodellanker vorhanden ist.
+- Bei Treffer wird die generische Query durch den neuesten Modellanker aus dem Verlauf ersetzt.
+
+## Regressionsschutz
+
+Die bestehende Zubehör-/Indikator-Ankerlogik bleibt unverändert und läuft weiterhin vor diesem neuen Guard. Der neue Guard blockiert sich selbst, wenn die aktuelle Frage Zubehör-/Indikator-/Reagenz-Tokens enthält. Dadurch sollen Flows wie `was kostet der indikator` weiterhin über die bestehende Zubehörlogik laufen.
+
+## Nicht geändert
+
+- Kein Retrieval-Scoring.
+- Kein Shop-Ranking.
+- Kein Shop-Matching.
+- Keine PromptBuilder-Änderung.
+- Keine neuen harten Produkt- oder Fachlisten im PHP-Core; die Entscheidung nutzt bestehende YAML-konfigurierbare Tokenlisten.
+
+## Lokale Checks
+
+- `php -l src/Agent/AgentRunner.php`
+- YAML-Parsing der RetrieX-Konfiguration
+- Logische Guard-Simulation:
+  - `gerät` + Verlauf mit `Testomat 808 Indikator 300` + Prompt `und was kostet das gerät selber` -> `testomat 808`
+  - `indikator`-/`zubehör`-Prompts bleiben vom neuen Hauptgeräte-Guard ausgeschlossen