p59c

patch_history/RETRIEX_PATCH_59C_GENRE_REVIEW_PATH_CLASSIFICATION_README.md

@@ -0,0 +1,72 @@
+# RetrieX Patch 59C - Genre Review Path Classification
+
+## Ziel
+
+p59C räumt die nach p59A/p59B verbliebene Genre-Migrationsoberfläche weiter auf, ohne Runtime-, Retrieval-, Prompt-, Shop- oder Scoring-Logik zu ändern.
+
+Der Patch ersetzt die flachen `adaptation_surface.*.review_paths` in `config/retriex/genre.yaml` durch klassifizierte `review_path_groups`.
+
+## Warum
+
+Nach p59B waren 32 alte technische/frozen Pfade als `review_paths` sichtbar. Zusätzlich existierten noch 7 deklarierte `configuration_values.*.source_paths`, die nicht in der `adaptation_surface` sichtbar klassifiziert waren.
+
+p59C macht alle verbliebenen 39 Legacy-/Runtime-Source-Pfade sichtbar und ordnet sie nach Cleanup-Bedeutung:
+
+- `frozen_compatibility_views`
+- `frozen_runtime_views`
+- `regex_templates`
+- `sales_signal_fallbacks`
+- `commercial_follow_up_fallbacks`
+- `technical_cleanup_profiles`
+- `technical_shop_mapping`
+- `runtime_resolved_connection`
+- `governance_guardrails`
+
+Damit ist klarer erkennbar, welche Pfade technische Runtime-Fallbacks, Regex-Templates, Runtime-resolved Werte oder spätere Rewire-Kandidaten sind.
+
+## Geänderte Dateien
+
+- `config/retriex/genre.yaml`
+- `src/Config/RetriexEffectiveConfigProvider.php`
+
+## Technische Änderung
+
+`validateGenre()` akzeptiert zusätzlich zu den alten flachen `review_paths` jetzt strukturierte `review_path_groups`:
+
+```yaml
+review_path_groups:
+  frozen_runtime_views:
+    description: ...
+    paths:
+      - agent.shop_runtime....
+```
+
+Das alte Feld `review_paths` bleibt validatorseitig rückwärtskompatibel, wird in `genre.yaml` aber nicht mehr verwendet.
+
+## Nicht geändert
+
+- keine Runtime-Logik
+- keine Query-Logik
+- keine Retrieval-Logik
+- keine Prompt-Logik
+- keine Shop-Logik
+- keine Scoring-Logik
+- keine Hash-/Governance-Werte
+
+## Lokale Checks
+
+In der entpackten ZIP ohne `vendor/` lokal geprüft:
+
+- YAML parsebar
+- PHP-Lint für `RetriexEffectiveConfigProvider.php` grün
+- alle 39 `configuration_values.*.source_paths` sind in `adaptation_surface.*.review_path_groups.*.paths` klassifiziert
+- keine zusätzlichen oder fehlenden klassifizierten Source-Pfade
+
+Die Symfony-Checks müssen im Projekt mit installiertem `vendor/` laufen:
+
+```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
+```