Clarify investigation source contracts and recover nested recall

docs/investigation-contract-v2.md

@@ -60,3 +60,49 @@ Cache-Aufteilung und frühe Diagnose-Routingentscheidung.
 
 Validierung am 20.10.2026: 307 lokale Tests bestanden (171,87 Sekunden),
 `git diff --check` ohne Befund. Keine kostenpflichtigen LLM-Tests ausgeführt.
+
+
+## Quellenraum und gezielte Korrekturen (20.10.2026)
+
+Neue v2-Kontexte speichern `research_guidance_version=1`. Ein kleiner, im stabilen
+Fallkontext cachebarer Quellenkatalog unterscheidet konfigurierte Git-Recherche
+(`project.query`) von den deklarierten Dateien im Paket (`source.*`). Höchstens
+drei Paketpfade mit zusammen höchstens 700 Zeichen werden aufgeführt; weitere
+Referenzen werden als ausgelassen gezählt. Historische Kontexte und ihre Requests
+bleiben unverändert rekonstruierbar. Die vollständige Eingabe unterliegt weiterhin
+der bestehenden 20.000-Zeichen-Grenze und dem 10.000-Zeichen-Richtwert.
+
+Fehlender Query-Kind, unvollständige `source.search`-Argumente und falscher
+Quellenraum erhalten kurze, feldbezogene Hinweise. Es werden weder fehlende
+Argumente erfunden noch Repository-Pfade automatisch in Paketquellen umgedeutet.
+Die Hinweise passen in das bestehende Limit von 160 Zeichen.
+
+Die Antwortreparatur entfernt bei einem bekannten, einzelnen `recall` lediglich
+die eindeutige `arguments`-Hülle. Beleg-ID, optionale Seitennummer, Beobachtung und
+Bewertung bleiben erhalten. Mehrdeutige Hüllen, unbekannte IDs, mehrere Belege,
+negative oder nicht ganzzahlige Seiten und unbekannte Aktionen werden nicht
+repariert. Anschließend gelten unverändert Schema-, Provenienz-, Seiten- und
+Budgetprüfungen; Originalantwort und Reparaturregel werden protokolliert.
+
+Die neue allgemeine Untersuchungsanweisung verlangt bei vermeintlich fehlenden
+Hooks auch Aufrufer, Overrides, indirekte Übergaben und Registrierung zu prüfen.
+Vorhandener Implementierungscode allein ist kein Beleg für einen Defekt. Das
+ändert keine gespeicherten Confidence-Werte und erzwingt keine Bug17-spezifische
+Schlussfolgerung. Ob diese Anleitung die fachliche Qualität verbessert, muss ein
+späterer LLM-Lauf zeigen.
+
+
+Der blockierte Bug17-Lauf wurde ohne API-Aufruf von Generation 204 über einen
+protokollierten manuellen technischen Retry auf Generation 206 vorbereitet.
+806 vorhandene Archiveinträge bleiben erhalten; Budget, Hypothesenstände und
+Versuchsnummer bleiben unverändert. Der neue Kontext ergänzt ausschließlich die
+versionierten Quellenhinweise und den fehlenden Korrekturhinweis. Die vollständige
+logische Anfrage misst 13.849 Zeichen einschließlich Cache-Kontext. Der portable
+Paketvalidator akzeptiert die Ausgabe. Details:
+`test-results/token-usage/bug17-source-contract-repair-20261020.json`.
+
+Validierung der Quellenkorrekturen: 269 lokale Regressionstests bestanden in
+192,85 Sekunden. Darunter 18 gezielte Tests für die kuratierten Suchfehler,
+eindeutige und verweigerte Recall-Reparaturen, vollständige Controller-Prüfung,
+Budgetneutralität, Cache-Aufteilung und die Zeichenobergrenze.
+`git diff --check` ohne Befund; keine kostenpflichtigen Aufrufe.