Files
MtoRagSystem/RETRIEX_PATCH_58_SINGLE_GENRE_LEGACY_VALUE_REDUCTION_README.md
2026-05-06 18:25:56 +02:00

3.2 KiB

RetrieX Patch p58 - Single-Genre Legacy Value Reduction

Ziel

Dieser Patch ist der erste kontrollierte Legacy-Cleanup nach p56/p57.

Es bleibt strikt bei: eine Installation = ein Genre. Es gibt keine Multi-Genre-Umschaltung, keinen Tenant-Kontext und keinen Request-/Host-Resolver.

Warum dieser Schritt

p55 hat die aktuellen fachlichen Wasseranalyse-/Messgeraete-Werte in config/retriex/genre.yaml gespiegelt. p56 hat eine erste sichere Auswahl dieser Werte als bevorzugte Runtime-Quelle verdrahtet. p57 hat die source_paths dieser zentralen Genre-Werte validierbar und auditierbar gemacht.

p58 reduziert nun die erste Welle doppelter Legacy-Wertpflege: Werte, die p56 bereits bevorzugt aus genre.yaml liest, werden an ihren alten Pfaden zu leeren Platzhaltern reduziert. Die Pfade bleiben vorhanden, damit Validierung, Audit und Source-Path-Dokumentation weiterhin stabil bleiben.

Was geaendert wurde

Reduziert wurden ausschliesslich bereits verdrahtete Legacy-Werte in:

  • config/retriex/agent.yaml
    • Shopquery-Stopword-Cleanup-Terms
    • direkte Attribut-/Vergleichs-Patterns
    • referenzielle Kontextterme
    • History-Anchor-Patterns und Template
    • Meta-Query-Guard-Terms
    • RAG-Anchor-Enrichment-Patterns/-Terms
    • Result-Identity-Listen
    • Laengenfilter-/Sortierpatterns
    • Direct-Shop-Answer-Texte
  • config/retriex/commerce.yaml
    • commerce_query.known_brands
    • commerce_query.search_token_canonical_map
  • config/retriex/intent.yaml
    • Commerce-Strong-Signals
    • Advisory-Signals und Advisory-Patterns
    • Size-/Color-Terms
    • Explicit-Commerce-Intent-Patterns
  • config/retriex/query_enrichment.yaml
    • Query-Enrichment-Regeln

Nicht geaendert

  • Keine Fachlogik-Aenderung.
  • Keine neuen fachlichen Listen.
  • Keine neuen Defaults.
  • Keine Shopware-Kriterien-, Ranking-, Retrieval- oder LLM-Verhaltensaenderung.
  • Keine Multi-Genre-/Tenant-Loesung.
  • Keine Entfernung von Legacy-Pfaden.
  • Keine Reduktion der noch nicht voll entkoppelten vocabulary.yaml-Include-Ketten.

Erwartetes Verhalten

Das Antwortverhalten soll unveraendert bleiben. Die reduzierten Legacy-Werte sind identisch in genre.configuration_values vorhanden und werden durch p56 bevorzugt gelesen. Die alten Pfade bleiben als leere Fallback-/Audit-Platzhalter erhalten.

Damit wird die zentrale Single-Genre-Pflegeflaeche staerker: Fuer eine spaetere Umwidmung auf ein anderes Genre sollen diese Werte in genre.yaml gepflegt werden, nicht mehr parallel in den alten Runtime-Dateien.

Lokale Pruefung

Durchgefuehrt:

python3 - <<'PY'
# YAML-Parsing fuer alle Dateien unter config/retriex/*.yaml und config/services.yaml
PY

Zusaetzlich wurde statisch geprueft:

  • 32 reduzierte Legacy-Pfade hatten vor der Reduktion identische Werte in genre.configuration_values.
  • dieselben 32 Legacy-Pfade sind nach der Reduktion leer, aber weiterhin vorhanden.

bin/console konnte lokal nicht ausgefuehrt werden, weil im ZIP kein vendor/ enthalten ist.

Projektchecks nach dem Einspielen

bin/console cache:clear
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