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.

docs/test-results/token-usage/bug17-source-contract-repair-20261020.json

@@ -0,0 +1,20 @@
+{
+  "date": "2026-10-20",
+  "case_id": "BUG-000017",
+  "package_id": "trial-bounded-full-BUG-000017-20261020",
+  "from_generation": 204,
+  "to_generation": 206,
+  "state": "INVESTIGATING_HYPOTHESES",
+  "api_calls": 0,
+  "full_logical_input_characters": 13849,
+  "preserved_original_entries": 806,
+  "budget_unchanged": true,
+  "hypothesis_states_unchanged": true,
+  "active_attempt_unchanged": true,
+  "new_context_ref": "analysis/investigation/0001/contexts/H1-0019-attempt-0003-guidance-v1.json",
+  "changes": [
+    "manual technical retry",
+    "append versioned source guidance and precise rejection details"
+  ],
+  "package_valid": true
+}