# 🌲 Crumbforest Missions - CF_Zero_V1

Ein interaktives Bash-Lern-System mit 17 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte.

**"Was kostet die Frage eines Kindes?"** - Transparentes Token-Tracking nach dem Crumb Codex: Fragen stärken Krümel & Wurzel.

## 🚀 Quick Start

```bash
# Mission Selector starten
./crumb-mission-selector.sh

# Einzelne Mission ausführen
bash missions/basics/fridolin.sh

# Robots Mission (neu!)
bash missions/robots/mond_maschine.sh
```

## 🤖 Robots-Kategorie ⭐ NEU!

Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew:

### 🔋 LiPo Power Academy
"Power braucht Respekt, nicht Angst"
- 8 Phasen: Grundlagen → Sicherheit → Power-Verteilung
- Lerne alles über LiPo-Batterien für Roboter-Projekte
- 6 Waldwächter: CapaciTobi, CrabbyRust, Schnecki, Schraubbär, DumboSQL, Vektor
- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
- ⚠️ **Sicherheitshinweis:** Lern- und Simulationskonzept. Arbeiten mit echten LiPo-Akkus nur unter Aufsicht erfahrener Erwachsener.

### 🌈 Regenbogen-Zählmaschine
"Etwas bauen was noch keiner gebaut hat - sonst muss man es ja nur reparieren!"
- 7 Phasen: Vision → Hardware → Code → Art
- Baue einen Farb-Event-Counter mit Sensor, Code & Visualisierung
- 13 Waldwächter: Die komplette Crew!
- Hardware + Software + Creative Coding

### 🌙 Mond Maschine - Rainbow Predictor
"Vorhersagen heißt verstehen - Die Natur durch Code begreifen"
- 8 Phasen: Computer Vision → ML → Astronomie
- Predict when rainbows appear using moon phases & weather data
- 13 Waldwächter: Computer Vision, APIs, ML Light
- OpenCV + Weather APIs + Astronomical calculations
- Bonus: Learn about Lunar Rainbows! 🌙🌈

## 📚 Features

- **Interaktive Lernmissionen** - Von Basics bis Advanced & Robots
- **17 Waldwächter** - KI-Assistenten mit Persönlichkeit (siehe unten)
- **Das Dreieck** - DumboSQL, FunkFox, Taichi Taube (didaktisches Modell, nicht technisches Modul)
- **Metadata-driven** - Neue Missionen ohne Code-Änderungen hinzufügen
- **Token-Tracking** - Transparent: "Was kostet die Frage eines Kindes?"
- **Crew Memory** - Log-basiertes Gedächtnis (dateibasiert, nachvollziehbar, kein autonomes Agentensystem)
- **Logs im Repo** - Strukturiert in `logs/{character}/`

## 🌲 Die 17 Waldwächter

### 🔺 Das Dreieck (Foundation)
- **🐘 DumboSQL** - Der nie vergessende Elefant (SQL & Daten)
- **🦊 FunkFox** - Der Bash Rapper (Terminal-Flow mit Beat)
- **🕊️ Taichi Taube** - Die Balance-Bringerin (Spirale & Ordnung)

### 🔧 Hardware-Team
- **🐿️ CapaciTobi** - Kondensator-Experte (Elektronik & Power)
- **🐌 Schnecki** - Verkabelungs-Guru (langsam & präzise)
- **🐻 Schraubbär** - Mechanik-Meister (schweres Gerät)

### 💻 Code-Team
- **🐍 SnakePy** - Python-Guide (mehrere Wege zeigen)
- **🧓 PepperPHP** - Structure Mentor (MVC wie ein Rezept)
- **🦀 CrabbyRust** - Security Guardian (Memory-safe)
- **🕷️ Spider** - Network Feeler (APIs & Verbindungen)

### 🎨 UI-Team
- **✂️ Schnippsi** - CSS & Styling (alles schick machen)
- **📄 Templatus** - Template-Master (HTML-Struktur)
- **👾 ASCII-Monster** - Terminal Artist (ASCII-Art)

### 🧭 System-Team
- **🦉 Maya-Eule** - Weise Eule mit Gedächtnis (Meta-Wissen)
- **🔧 Deepbit** - Bash-Erklärer (deep diving)
- **🐛 Bugsy** - Debugging-Helfer (Fehler-Detektiv)
- **🧭 Vektor** - Point-to-Point Guide (Navigation)

## 🦊 Verfügbare Missionen

### 📚 Basics
- **Fridolin** - Navigation (`pwd`, `ls`, `cd`)
- **Balu** - Dateien erstellen (`mkdir`, `touch`, `echo`)
- **Noko** - Dateien lesen (`cat`, `head`, `tail`, `grep`)

### 🚀 Advanced
- **DNS Deep Dive** - DNS-Tools (`dig`, `nslookup`, `host`)
- **SSH Security** - SSH-Verbindungen und Keys

### 🏆 Challenges
- **Stage Builder** - Komplexe Bash-Herausforderungen

### 🤖 Robots ⭐ NEU!
- **🔋 LiPo Power Academy** - Batterie-Wissen für Roboter
- **🌈 Regenbogen-Zählmaschine** - Farb-Event-Counter
- **🌙 Mond Maschine** - Rainbow Predictor mit Computer Vision

## 🤖 Waldwächter nutzen

```bash
# Source die Library
source lib/waldwaechter.sh

# Frag einen Waldwächter
mayaeule "Was ist wichtiger - das Ziel oder der Weg?"
funkfox "Erkläre mir Pipes im Flow!"
dumbosql "Wie strukturiere ich eine Datenbank?"
snakepy "Zeig mir 3 Wege, um eine Liste zu sortieren"

# Alle verfügbar:
# mayaeule, deepbit, bugsy, schnippsi, templatus
# tobi, schraubaer, schnecki
# dumbosql, funkfox, taichitaube
# snakepy, pepperphp, crabbyrust
# spider, vektor, asciimonster
```

## 📊 Token-Tracking & Logs

**Philosophie:** "Was kostet die Frage eines Kindes?"

- Token-Verbrauch wird transparent angezeigt
- Logs landen in `logs/{character}/`
- Crew Memory: Waldwächter lesen andere Logs
- Mission Logs: `logs/missions/*.json`

```bash
# Logs checken
ls logs/
ls logs/mayaeule/
cat logs/missions/mond_maschine_*.json
```

Typische Kosten (Richtwerte, modellabhängig):
- Einzelne Frage: ~200-800 tokens (~$0.0002-0.0008)
- Komplette Mission: ~5,000-7,000 tokens (~$0.005-0.007)
- **Richtwert: Unter 1 Cent pro Mission** 💚
- Token-Anzeige dient der transparenten Nachvollziehbarkeit, nicht der Abrechnung

## 📖 Dokumentation

- **[CLAUDE.md](CLAUDE.md)** - Vollständige Architektur & Entwickler-Docs
- **[KEKSHANDBUCH_ZERO_v0.0.md](KEKSHANDBUCH_ZERO_v0.0.md)** - User Manual mit allen 17 Waldwächtern

## 🌍 Philosophien

**"Das Dreieck"** - DumboSQL, FunkFox, Taichi Taube
- Struktur, Flow & Balance
- Die Grundlage für komplexe Projekte

**"Power braucht Respekt, nicht Angst"** - LiPo Power Academy
- Sicherheit durch Wissen
- 7 goldene Regeln für LiPo-Batterien

**"Etwas bauen was noch keiner gebaut hat"** - Regenbogen-Zählmaschine
- Kreativität statt Reparatur
- Inspiriert durch Kinderfragen

**"Vorhersagen heißt verstehen"** - Mond Maschine
- Die Natur durch Code begreifen
- Computer Vision + Machine Learning + Astronomie

**"Was kostet die Frage eines Kindes?"**
- Token-Tracking für Transparenz
- Machen statt Lernen - Fragen stärken die Wurzel

**"Ein Elefant vergisst nie"** - DumboSQL
- Crew Memory über Projekt-Grenzen
- Persistente Konversations-Historie

**"wir ja nie fertig"** 🌱
- Der Wald wächst mit jeder Idee
- Community-driven Education

## 🏗️ Projekt-Struktur

```
CF_Zero_V1/
├── crumb-mission-selector.sh    # Hauptmenü
├── lib/
│   └── waldwaechter.sh          # 17 Waldwächter als Functions
├── crumbforest_roles/           # 17 Character Scripts
├── missions/
│   ├── basics/                  # Einsteiger
│   ├── advanced/                # Fortgeschrittene
│   ├── challenges/              # Herausforderungen
│   └── robots/                  # 🤖 NEU! 3 Robot-Missionen
├── logs/                        # 🌲 Projekt-basierte Logs
│   ├── {character}/             # Pro Waldwächter
│   └── missions/                # Mission Logs
├── CLAUDE.md                    # Projekt-Dokumentation
├── KEKSHANDBUCH_ZERO_v0.0.md    # User Manual
└── README.md                    # Diese Datei
```

## 🔧 Setup

```bash
# .env erstellen mit API Key
echo "OPENROUTER_API_KEY=your-key-here" > .env

# Mission Selector starten
./crumb-mission-selector.sh

# Oder direkt eine Mission
bash missions/robots/mond_maschine.sh
```

## 🎯 Use Cases

- **Terminal lernen** - Interaktive Bash-Basics
- **Roboter bauen** - Hardware + Software Projekte
- **Computer Vision** - OpenCV mit SnakePy lernen
- **Datenbanken** - SQL mit DumboSQL verstehen
- **APIs integrieren** - Spider zeigt den Weg
- **Kreativ coden** - Projekte die Spaß machen!

## 🌟 Besonderheiten

- **Alle Waldwächter haben Persönlichkeit** - FunkFox rappt, Maya-Eule philosophiert
- **Inter-Character Communication** - Waldwächter lesen andere Logs
- **Metadata-driven** - Missions als .sh + .meta.json
- **Token-Transparenz** - Kosten werden angezeigt
- **Community-driven** - Missionen entstehen aus User-Ideen
- **Raspberry Pi kompatibel** - Grundsystem auf Pi Zero, Robot- & Vision-Missionen benötigen Pi 4+ oder Desktop

## 📦 Requirements

- Bash 3.2+ (macOS default, Bash 4+ empfohlen für volle Features)
- curl, jq
- OpenRouter API Key
- Optional: Python 3 für Robot-Missionen (opencv-python, numpy, ephem)
  - Mond Maschine (Computer Vision): Pi 4+ oder Desktop empfohlen

## 🚀 Next Steps

1. Mission Selector starten: `./crumb-mission-selector.sh`
2. Eine Robot-Mission ausprobieren
3. Eigene Mission-Idee einreichen
4. Den Wald wachsen lassen! 🌱

## 🔗 Links

- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
- [Rainbow Counter Demo](https://194-164-194-191.sslip.io/crumbblocks/rainbow_counter.html)

---

## 🏷️ Version

**v0.1-robots-complete**
- 3 Robot-Missionen
- 17 Waldwächter komplett
- Logs im Repo
- Token-Tracking
- Crew Memory (log-basiert)

---

*Erstellt mit 💚 im Crumbforest*

**"Der Wald ist nie fertig - er wächst mit jeder Idee!"** 🌲🌱