Preserve bootstrap schema error paths for targeted correction

docs/bootstrap-schema-diagnostics.md

@@ -0,0 +1,25 @@
+# Schemafehler bei Bootstrap v21
+
+Der Gateway validiert weiterhin gegen das vollständige lokale Ausgabeschema.
+Bootstrap v21 war jedoch nicht für die detaillierte, bereinigte
+Schemafehlerdiagnostik freigeschaltet. Deshalb enthielten fehlgeschlagene Aufrufe
+teilweise nur `validation_keyword: type`, ohne die betroffene Stelle.
+
+Jetzt werden auch für diesen Prompt `validation_path`, bekannte
+`validation_fields` und das konkrete Validierungskeyword erfasst. Bei verschachtelten
+Aktionsalternativen wird die zum vorhandenen Diskriminator passende Schemaalternative
+verwendet. Unbekannte Feldnamen werden maskiert; Antwortwerte und rohe
+Fehlermeldungen werden nicht in die Diagnose übernommen. Die bekannten Werkzeugfelder
+`profile` und `entity_refs` sind für sichere Feldpfade freigegeben.
+
+Der Controller speichert diese Diagnose append-only mit dem fehlgeschlagenen Aufruf.
+Für Bootstrap-Aufrufe bekommen Typ- und Enumfehler einen gezielten Korrekturhinweis
+am gemeldeten Pfad. Das Schema wird nicht gelockert und die Antwort nicht automatisch
+umgeschrieben. Ein technischer Fehlversuch löst keinen Rechercheauftrag aus.
+Die vorhandene Begrenzung ungültiger Antworten bleibt wirksam.
+
+Lokale Tests prüfen Typfehler, fehlende Pflichtfelder, zusätzliche Felder,
+Datenschutz und den Weg vom Gateway über das Paket bis zur Wiederaufnahme und
+erfolgreichen Korrektur mit einem simulierten Anbieter. Es werden keine
+kostenpflichtigen Anfragen ausgeführt. Historisch nicht gespeicherte Fehlerpfade
+lassen sich damit nicht nachträglich rekonstruieren.

docs/source-context-relevance-v2.md

@@ -114,5 +114,5 @@ primären Kandidaten und keine historische SQL-Sammlung; das Suchbudget wird dab
 ausdrücklich als begrenzt gemeldet. Dies ist ein lokaler Werkzeugtest, keine neue
 LLM-Bewertung des Bugs und kein Nachweis realer Token-/Kostenersparnis.
 
-Die zuvor bekannte fehlende Gateway-Schemafehlerdiagnostik für Bootstrap v21 ist
-ein separater Punkt und wird durch diese Source-Überarbeitung nicht behoben.
+Die fehlende Gateway-Schemafehlerdiagnostik für Bootstrap v21 wurde anschließend
+separat korrigiert; siehe `bootstrap-schema-diagnostics.md`.