p84b

patch_history/RETRIEX_PATCH_84B_MAIN_DEVICE_QUERY_CONTEXT_HANDOFF_README.md

@@ -0,0 +1,52 @@
+# RETRIEX Patch p84b - Main Device Query Context Handoff
+
+## Ziel
+
+p84 erkannte referenzielle Gerätepreisfragen wie `was kostet das gerät` grundsätzlich, konnte aber in bestimmten Follow-up-Flows die sichtbare/gesendete Shopquery weiterhin auf generische Tokens wie `gerät` fallen lassen.
+
+Beispiel:
+
+1. `zu welchem gerät gehört der indikator 300` → Antwort enthält `Testomat 808`
+2. `was kostet das gerät` → Antwort findet den Gerätebezug, aber Shopquery bleibt `gerät`
+
+## Ursache
+
+Der neue p84-Geräteanker wurde mit dem bereits für die Shopquery aufgelösten/ggf. eingeschränkten `$shopQueryHistoryContext` aufgerufen. In manchen Follow-up-Pfaden ist dieser Kontext zu eng oder nicht identisch mit dem vollständigen Commerce-Kontext, obwohl der vollständige Verlauf den Hauptgeräteanker enthält.
+
+## Änderung
+
+`guardMainDeviceReferentialShopQueryWithHistoryModelAnchor()` bekommt nun den vollständigen `$commerceHistoryContext` statt `$shopQueryHistoryContext`.
+
+Dadurch kann die Gerätepreis-Referenzlogik den zuletzt genannten Hauptgeräteanker (`Testomat 808`) vor dem Shoplauf in die tatsächliche Shopquery übernehmen.
+
+Erwartung:
+
+```text
+was kostet das gerät
+→ testomat 808
+```
+
+statt:
+
+```text
+was kostet das gerät
+→ gerät
+```
+
+## Regressionsschutz
+
+Die Zubehör-/Indikatorlogik bleibt unverändert:
+
+- Die p84-Sperre gegen Zubehör-/Indikator-/Reagenz-Tokens in der aktuellen Nachfrage bleibt bestehen.
+- Fragen wie `was kostet der indikator`, `was kostet das zubehör` oder `suche den indikator` laufen weiterhin über die bestehende Zubehör-/Indikator-Ankerlogik.
+- Keine Änderung an Retrieval, Scoring, Ranking, Shop-Matching oder PromptBuilder.
+
+## Geänderte Dateien
+
+- `src/Agent/AgentRunner.php`
+- `patch_history/RETRIEX_PATCH_84B_MAIN_DEVICE_QUERY_CONTEXT_HANDOFF_README.md`
+
+## Lokale Checks
+
+- `php -l src/Agent/AgentRunner.php`
+- logische Kontext-Handoff-Prüfung des geänderten Call-Sites