# 🌲 Crumbforest Handbuch: Terminal-Aliase & Missionssystem

## 🧭 Ziel
Dieses Handbuch beschreibt, wie im Crumbforest-Terminal benutzerdefinierte **Aliases** und **Missionen** für kindgerechte Shell-Erfahrungen bereitgestellt werden. Es hilft, die Magie hinter den Kommandos zu verstehen und für zukünftige Krümelgenerationen zu bewahren.

---

## 🛠️ Aliase für Agenten & Missionen

Die `.bashrc`-Datei eines jeden Krümel-Users (z. B. `robot`, `kruemel`, `jupiter`, `heimkind`) wird um folgende Aliase erweitert:

```bash
# Shell-basierte Agentenrollen
alias eule='cd /var/www/html && ./bin/cake kruemeleule'
alias gpt='cd /var/www/html && ./bin/cake kruemelgtp'
alias hyper='cd /var/www/html && ./bin/cake hyperhamster'

# API-gesteuerte Agenten
alias fox='cd /var/www/html/bin/ && funkfox_hardened_with_api.sh'
alias dumbo='cd /var/www/html/bin/ && dumbo_hardened_with_api.sh'
alias pepper='cd /var/www/html/bin/ && pepper_hardened_with_api.sh'
alias schnippsi='cd /var/www/html/bin/ && schnippsi_hardened_with_api.sh'
alias templatus='cd /var/www/html/bin/ && templatus_hardened_with_api.sh'
alias bugsy='cd /var/www/html/bin/ && bugsy_hardened_with_api.sh'
alias ascii='cd /var/www/html/bin/ && ascii_hardened_with_api.sh'
alias snake='cd /var/www/html/bin/ && snake_hardened_with_api.sh'

# Missionsstartpunkte
alias intro='cd /usr/local/bin/ && intro.sh'
alias welcome='cd /usr/local/bin/ && welcome_kruemel.sh'
alias mission='cd /usr/local/bin/ && mission_selector.sh'
alias mission_one='cd /usr/local/bin/ && mission_selector_mission_1.sh'
```

---

## 🎮 Beispiel: Mission starten

```bash
mission_one
```

### Mögliche Missionen:
1. 🦊 **Fridolin (Pfadfinder)**  
   → Zeigt Verzeichnisse im Krümelwald

2. 🛠️ **Balu (Bau-Elf)**  
   → Erstellt ein `geheimversteck`

3. 🐈🦉 **Noko (Leser der Tiefe)**  
   → Liest `gruss.txt` aus dem geheimen Versteck

4. 📦 **Blockly-Code senden**  
   → Sendet Code an die CakePHP-Blockly-API auf Port 8080

5. ❌ **Beenden**  
   → Verabschiedet sich mit einem Gruß

---

## 🐞 Fehlerbehandlung

- Wenn ein Alias nicht funktioniert, überprüfe ob `.bashrc` korrekt geladen wurde:
  ```bash
  source ~/.bashrc
  ```

- Falls Missions-API (`curl`) nicht antwortet:
  Prüfe, ob der Container auf Port `8080` läuft:
  ```bash
  docker ps | grep 8080
  ```

---

## 📦 Wichtige Pfade

- Aliase: `~/.bashrc`
- Agenten: `/var/www/html/bin/`
- Missionen: `/usr/local/bin/crumbmissions/`
- Blockly API: `http://localhost:8080/crumbapi/blockly-terminal`
- Grußdatei: `/home/robot/geheimversteck/gruss.txt`

---

🚀 Bleib auf Kurs, kleiner Krümel.  
Denn im Terminal lebt der Zauber – und jedes `alias` ist ein Flüstern des Waldes.  
