p59g

patch_history/RETRIEX_PATCH_59G_GENRE_NO_LLM_ROLE_FALLBACK_REWIRE_README.md

@@ -0,0 +1,49 @@
+# RetrieX Patch p59G - Genre no-LLM role fallback rewire
+
+## Ziel
+
+p59G ist der erste kleine echte Rewire-Schritt nach der p59A-p59F Metadatenbereinigung. Der no-LLM Produktrollen-Fallback liest die Rollenbegriffe jetzt direkt aus `genre.yaml`, statt über die alte Agent-`vocabulary_views`-Kompatibilitätsschicht zu gehen.
+
+## Änderungen
+
+- `AgentRunnerConfig::getNoLlmMainDeviceRequestRoleKeywords()` liest bevorzugt aus `genre.configuration_values.product_roles.no_llm_fallback_terms.main_device_request_keywords`.
+- `AgentRunnerConfig::getNoLlmAccessoryProductRoleKeywords()` liest bevorzugt aus `genre.configuration_values.product_roles.no_llm_fallback_terms.accessory_product_keywords`.
+- Die alten Agent-View-Pfade unter `agent.no_llm_fallback.product_roles.vocabulary_views.*` wurden aus `agent.yaml` entfernt.
+- Die Review-Gruppe `adaptation_surface.product_roles.review_path_groups.frozen_compatibility_views` wurde aus `genre.yaml` entfernt.
+- Die zugehörigen frozen Hashes wurden aus `governance.genre_source_of_truth.frozen_non_empty_legacy_source_hashes` entfernt.
+
+## Nicht geändert
+
+- Keine Prompt-, Retrieval-, Shop-, Query-, SearchRepair-, Intent- oder Scoring-Logik wurde geändert.
+- Die fachlichen no-LLM Rollenwerte bleiben unverändert in `genre.yaml`.
+- Die Fallback-Methoden behalten den technischen Legacy-Fallback im Code, falls in einem alten Setup keine GenreConfig verfügbar ist; im aktuellen Single-Genre-Setup greift aber der Genre-Wert.
+
+## Erwartete Audit-Auswirkung
+
+- `genre_review_path_groups_with_source_paths`: 14 -> 13
+- `genre_declared_source_paths`: 39 -> 37
+- `genre_source_of_truth_frozen_non_empty`: 37 -> 35
+- `genre_source_of_truth_violations`: bleibt 0
+
+## Lokale Prüfung ohne vendor/
+
+- YAML parsebar für `genre.yaml`, `agent.yaml`, `governance.yaml`, `vocabulary.yaml`
+- PHP-Lint grün für `src/Config/AgentRunnerConfig.php`
+- Lokale Source-of-Truth-Simulation:
+  - 13 Review-Gruppen
+  - 37 deklarierte Review-Source-Pfade
+  - 35 frozen non-empty Pfade
+  - 2 runtime-resolved Pfade
+  - 0 leere Legacy-Fallbacks
+  - 0 fehlende Pfade
+  - 0 undeclared frozen hashes
+  - 0 Hash-Mismatches
+
+## Projektchecks nach Einspielen
+
+```bash
+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
+```