init

phase0/erkenntnisse.md

@@ -0,0 +1,112 @@
+# 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?