# Phase-0-Erkenntnisse (Scan-Validierung am Creator) Testfall: `backend/kanban.py` (269 Zeilen) → Einheiten-Datei nach `docs/format.md`. Prompt: `prompt-einheiten.md`, Prüfung: `pruefe.py`, Ergebnisse: `beispiel-einheiten-*.md`. ## Läufe (2026-07-09) | Lauf | Modell | Mechanisches Ergebnis | |---|---|---| | v1 | M2.7-highspeed (kalt) | 9 Einheiten, volle Abdeckung, 0 falsche Anker/Kanten — aber 6 Zitat-Fehler (mehrzeilige Statements zusammengezogen) + 1 Kanten-Formatfehler | | v2 | M2.7-highspeed (kalt), geschärfter Prompt | schlechter: beleg-Format gedriftet (inline), 9 Zitat-Fehler, davon 1 echte Fabrikation (f-String zu %-Formatierung umgeschrieben), 1 Einheit vergessen; davor 1 Stall (7-min-Timeout, bekanntes kalt-Routen-Problem) | | v3 | M3 (nativ) | 0 Fehler: alle 26 Zitate wörtlich, Format exakt, Kanten-Richtungen korrekt, Innenfunktionen sauber als Zusatz-Anker; 1 Einheit vergessen (`_progress` — von der Abdeckungsprüfung gefangen) | ## Erkenntnisse 1. **Das Zitat-Treue-Gate funktioniert und ist nötig** — es hat in v2 eine echte Code-Fabrikation gefangen (paraphrasiertes Zitat). Kernannahme von Phase 0 bestätigt: mechanische Gates machen billige Modelle sicher benutzbar. 2. **Modellwahl fürs Schneiden/Fakten: M3, nicht M2.7-highspeed.** M2.7-HS ist bei wörtlichen Zitaten unzuverlässig (und Prompt-Schärfung hat es nicht behoben — v2 war schlechter als v1). M3 war fehlerfrei. Später per Telemetrie neu bewerten. 3. **Kein Lauf war vollständig UND fehlerfrei zugleich** → die Pipeline braucht den Nachfass-Schritt: Abdeckungsprüfung meldet fehlende Symbole, ein Folge-Call ergänzt nur diese (Karten-Retry der Kanban-Engine passt dafür). 4. **Formattreue schwankt zwischen Läufen** (v2: beleg inline statt eigene Zeile) → Grammatik-Parse-Fail = Retry (Engine kann das); Prüfskript parst tolerant, wo es den Prüfzweck nicht schwächt. 5. **kalt-Routen-Stalls bestätigt** (1 von 3 kalt-Calls hing) — Timeouts + Retry sind Pflicht, wie im Creator. 6. **Format-Anpassungen aus der Praxis**: Zusatz-Anker dürfen verschachtelte Symbole sein (Innenfunktionen); beleg muss Ausschnitt GENAU EINER Quellzeile sein (steht jetzt im Prompt und in `docs/format.md` nachzuziehen). ## Zweiter Block (gleicher Tag): Nachfass, weitere Dateien, Feature-Sicht 7. **Nachfass-Kreislauf funktioniert end-to-end.** kanban.py nach Nachfass: 9 Einheiten, 31 Belege, 0 Fehler, 0 Warnungen. pipeline.py nach geschärftem Nachfass: 17 Einheiten, 52 Belege, volle Abdeckung. 8. **Nachfass braucht eine harte Regel gegen Wegsortieren:** M3 nutzte `ergaenze-anker` zunächst als Fluchtweg (alle 16 fehlenden Symbole in bestehende Einheiten gefaltet, fachlich teils falsch). Fix im Prompt: ergaenze-anker NUR für unselbstständige Hilfssatelliten, im Zweifel eigene Einheit — danach korrekt. 9. **Neuer M3-Fehlermodus: Thinking-Overrun.** Bei pipeline.py dachte natives M3 bis ans 32k-Token-Limit und lieferte LEEREN Text (2× hintereinander, je >21k Tokens unsichtbar verbrannt). Erkennbar an: leere Ausgabe + Output-Tokens am Limit. Pipeline-Regel: leere Ausgabe = Fehler + Retry; Token-Zähler aus der OpenCode-Session-DB loggen. M3-kalt (ohne Thinking) als Ausweichroute lief, stallte aber 1× und deckte schwächer ab (6/22 Symbolen) → Erst-Scan nativ-M3, bei Overrun Retry, Lücken macht der Nachfass zu. 10. **Zitat-Gate fängt auch Minimal-Umformungen:** config.py-Zitat war fast richtig (Tupel-Teil weggelassen) — existiert so nicht im Code. Genau die gefährliche Klasse. 11. **Escaping-Rauschen normalisieren:** Modelle verdoppeln Backslashes in Zitaten (`\\n` statt `\n`) → Prüfskript entschärft `\"` und `\\` vor dem Vergleich. 12. **Feature-Sicht aus Einheiten allein funktioniert.** M3 aggregierte aus 42 Einheiten (kanban+pipeline+config, ohne Quellcode!) eine lesbare Sicht: 3 Bereiche, 13 Features, Fähigkeits-Sprache, plausible kern/rand-Flags, 0 kaputte Referenzen, unreferenziert nur echte interne Helfer. Kernannahme „Sichten = billige Aggregation über Einheiten" bestätigt. → `beispiel-features.md` 13a. **Parallele OpenCode-Kaltstarts hängen** (2× reproduziert: drei gleichzeitige `opencode run` → alle Exit 124, keine Session erzeugt; sequenziell läuft es). Der Creator serialisiert Starts deshalb mit einer Stagger-Sperre (`_opencode_start_lock`, `_OPENCODE_START_DELAY`) — die MUSS mit übernommen werden. 13. **Infra-Fehlerklassen gesehen und unterscheidbar:** (a) harter Stall (inventory: >1 h tot, kein Output, Session offen), (b) Thinking-Overrun (Output-Tokens am Limit, leerer Text), (c) Netzausfall (Exit 124/Timeout, KEINE Session in der DB, leeres Stderr). Alle drei enden in leerer Ausgabe — die Pipeline muss sie an den Signalen unterscheiden: (c) pausiert den Lauf (Provider nicht erreichbar, Leitprinzip 2), (a)+(b) sind Retry-Fälle. Erreichbarkeits-Check vor Lauf-Start ist Pflicht. ## Phase-1-Abnahme (Creator-Scan, 2026-07-09 nachmittags): Befunde der ~3h-Untersuchung 14. Sechs Läufe, 614 MiniMax-Calls, 2,16M Input-/1,29M Output-Tokens, ~35 min echte Rechenzeit — der Rest der Zeit ging an: (a) meine Prozess-Orchestrierung (pkill traf falsche PIDs → Lauf 2+3 parallel auf EINEM Board → Kartenchaos; tail-Pipe puffert → kein Live-Output), (b) einen ungeklärten Hänger, (c) Iterationszyklen. 15. Gefixt & belegt: blinde Retries (→ Befund-Feedback), halluzinierte Kanten/Anker (→ mechanische Streichung), fast-richtige Zitate wie `:=`→`=` (→ Fenster-Snap), Barriere-Loch (sammeln drainte vor Producer-Ende — Beweis: Sichten-Calls mit 868 vs. 36.688 Input-Tokens; → gate=research_done), Working-Tree-Check stolperte über eigene .planer-Dateien (→ Ausnahme), Kaskadentod beim Schreiben (→ degradierend). 16. OFFEN — Hänger: Prozess lebt nach Board-Ende weiter (47 min solo-idle belegt, 15s CPU, futex). Parallel-Läufe als Alleinursache durch Timeline widerlegt; alle LLM-/DB-Pfade haben Timeouts. Verdachtsklasse: ein nie endender Processor-Task hält den Flow über den Aktiv-Zähler wach. SIGUSR1-Stackdump ist jetzt eingebaut — der nächste Hänger liefert den Stack. 17. OFFEN — Zitate mit eingebetteten Anführungszeichen/Regex (z. B. re.sub-Muster) brechen Parse (greedy Quote-Regex) und Snap → 3 hartnäckig tote Chunks. 18. OFFEN — Skript-Dateien ohne def/class (creator/projects/ragsystem): Modell erfindet Pseudo-Symbole ('modul'); Datei-Einheiten (`## pfad` ohne ::) sind im Format vorgesehen, aber in Parser/Gates nicht implementiert. 19. OFFEN — Sichten referenzieren Einheiten mit FALSCHEM Datei-Prefix (Symbol existiert, Datei falsch: repair.py-Einheit als board_inventory.py referenziert). Mechanische Referenz-Streichung ist eingebaut; besser wäre ID-Korrektur (Symbol eindeutig → Prefix ersetzen). 20. OFFEN — creator/projects/ + uni/ sind Inhaltsdaten, keine Projektquellen → braucht projekt-eigene Ausschluss-Config. Und: Kern/Features-Qualität bei voller Übersicht noch unbewiesen (einziger kompletter Sichten-Lauf sah die Teil-Übersicht). 21. **Abschlusslauf erfolgreich** (nach Fixes 17–19): 96/98 Chunks, alle 3 Sichten, Kern beschreibt den ganzen Creator korrekt (Inventar→Artefakte→Guide, 14 Feature-Bereiche). Rest-Tote: 2 Chunks (database.py, textkit.py — Zitat-Klasse, Fehlertext durch Paket-Attribution verwischt). Der „Hänger" dieses Laufs war KEIN Hänger — nur die lange Sichten-Endphase; mein USR1 killte den Prozess vor dem Bericht (faulthandler- Registrierung wirkte nicht — prüfen). Artefakte liegen final in creator/.planer/. ## Offen in Phase 0 - [ ] board_inventory.py (2344 Zeilen) — Hintergrund-Lauf ausstehend; erwartete Erkenntnis: große Dateien brauchen Chunking (Symbol-Gruppen je Call) - [ ] config.py-Zitatfehler per Nachfass/Repair beheben (Muster ist validiert, niedrige Prio) - [ ] Bewertung mit dem Nutzer: taugt das Ergebnis zum Wiedereinlesen?