# 🌲 Crumbforest Terminal Session Log – Snake, Dumbo & Friends (2025-06-04/05)

## 🎯 Ziel der Session

Wiederherstellung und Erweiterung der kindgerechten Terminal-Charaktere (SnakePy, DumboSQL, ASCIIMonster, Bugsy) innerhalb des Crumbforest-Terminals unter Nutzung von OpenRouter-APIs und Bash-Skripten. Fokus auf systematische Logging-Protokolle, Wiederherstellung nach Fehlern und eine konsistente kindgerechte Ausdrucksweise.

---

## 🐍 SnakePy (Python Interpreter für Kinder)

### ✅ Erreichte Ziele

* **Systemprompt** erfolgreich über `snake_history.json` gesetzt:

  ```json
  {
    "role": "system",
    "content": "Du bist SnakePy – eine Python-Schlange, die einfache Begriffe aus Python für Kinder erklärt. Du antwortest präzise, in einfachen Worten, mit einem Beispiel. Vermeide Gegenfragen oder abweichende Themen. Immer genau auf die gestellte Frage antworten."
  }
  ```
* Antworten beinhalten kindgerechte Metaphern + konkrete Codebeispiele:

  * **Variable:** Kleiderschrank
  * **INT:** ganze Zahlen
  * **Schleife:** sich wiederholende Handlung, Beispiel mit `range(5)`
* Reset-Skript `reset_history_snake.sh` löscht `snake_history.json` + `snake_response.json`
* Token-Log wird zuverlässig unter `token_log.json` gespeichert

### 🐛 Vorherige Bugs

* Modellantworten drifteten thematisch ab (Fokus auf „Was ist Python?“ statt auf Kernbegriff)
* Kein systematischer Reset der `.json` Files vor neuen Fragen → keine Modell-Kohärenz

### 📦 Status: **stabil & produktiv**

---

## 🐘 DumboSQL (SQL-Interpreter für Kinder)

### 📋 Aktueller Zustand

* Antworten noch im klassischen Format ohne Systemprompt-Zuweisung
* Beispielhafte Erklärung eines `JOIN`-Statements (gut verständlich):

```sql
SELECT Bestellungen.BestellNr, Produkte.Produktname, Bestellungen.Menge
FROM Bestellungen
JOIN Produkte ON Bestellungen.ProduktID = Produkte.ProduktID
```

### 🔧 ToDo

* Migration auf das neue Modellformat mit `dumbo_history.json` + Systemrolle:

  ```json
  {
    "role": "system",
    "content": "Du bist DumboSQL – ein freundlicher Elefant, der SQL kindgerecht erklärt. Verwende einfache Begriffe, klare Struktur und konkrete Datenbankbeispiele. Vermeide Gegenfragen, konzentriere dich auf die Anfrage."
  }
  ```
* Umbau von `dumbo_hardened.sh` → `dumbo_hardened_with_api.sh`
* Token-Log-Integration testen + Reset-Skript für `dumbo_history.json` + `dumbo_response.json`

---

## 🔤 ASCIIMonster (ASCII Generator)

### ✅ Setup & Funktionen

* ASCII-Ausgabe (Fallback mit `figlet`) funktioniert:

  ```bash
  ./ascii_fallback.sh branko
  ```
* Antwortverhalten wurde angepasst auf dekorative Erklärungen (freundlich, versponnen)
* Token-Logging aktiviert
* Reset-Skript `ascii_reset_history.sh` im Einsatz

### ⚠️ Bugphase

* Zwischenzeitlich viele Textantworten ohne ASCII → Modellwahl oder Prompt-Störung
* Lösung: Modell reset + systematischer Prompt

---

## 🧠 Bugsy (Fehlererklärer für Terminalausgaben)

### ⚠️ Zwischenstand

* Modell antwortet unregelmäßig
* Teilweise keine `response.json` Datei erzeugt → Ursache: leere Antwort oder Verbindungsproblem
* `bugsy_hardened_with_api.sh` vorhanden, aber Log-Parser meldete `usage`-Fehler

### 🛠️ Nächste Schritte

* Sicherstellung, dass `bugsy_response.json` immer geschrieben wird
* `log_tokens.sh` überarbeiten für Arrays statt Objekte

---

## 📊 Gemeinsame Logik & Bash-Erweiterungen

### 🔁 Reset-Skripte

Für alle Rollen angelegt:

* `reset_history_snake.sh`
* `ascii_reset_history.sh`
* (geplant) `reset_history_dumbo.sh`
* (optional) `reset_history_bugsy.sh`

### 📁 JSON-Dateien

* `snake_history.json`, `dumbo_history.json`, `ascii_history.json`, `bugsy_history.json`
* `*_response.json`
* Zentraler Token-Log: `token_log.json`

### 📡 OpenRouter-POST-Logik (Ausschnitt)

```bash
curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF > "$TMP_RESPONSE"
{
  "model": "$MODEL",
  "messages": $(cat "$HISTORY_FILE"),
  "temperature": 0.7
}
EOF
```

---

## 🧁 Fazit & Reflexion

> „Snake ist wieder sweet. Dumbo wartet auf sein Update. ASCII tanzt. Bugsy grummelt. Aber das Terminal lebt.“

Diese Session war ein Paradebeispiel für das Zusammenspiel von kindgerechter Didaktik, API-Integration und systematischem Debugging. Der Crumbforest Terminal lernt laufen – mit Tieren, Tokens und ganz viel 💚.

---

## 🧩 Ausblick

* [ ] DumboSQL in neues Format überführen
* [ ] Funktionsübersicht auf `/kruemel/rollen` visualisieren
* [ ] PDF-Export `lernmodul_snakepy.md`
* [ ] Bash-CLI: `kruemel_start.sh` mit Rollenauswahl-Menü

---

*Session: 2025-06-04 13:00 – 2025-06-05 00:15*

\#KruemelCrew #SnakePy #CrumbforestTerminal #OpenRouterKinderCoding
